-
Notifications
You must be signed in to change notification settings - Fork 44
Better documentation #417
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Better documentation #417
Conversation
Thanks @ErikQQY. I suggest that we
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good. I know this is mostly moving stuff around, but I took the opportunity to read through the docs as well, so I had a few small requests.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Some nitpicking.
Also, the reference list at https://turinglang.org/AdvancedHMC.jl/previews/PR417/#References and https://turinglang.org/AdvancedHMC.jl/previews/PR417/references/ are not identical. Not sure if we want to unify them.
extra line at AdvancedHMC.jl/docs/src/index.md Line 58 in e23c7a0
|
Thanks @ErikQQY! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks @ErikQQY! I know this has been merged, but flagging a minor inconsistency for maybe fixing in the future. Good stuff overall though.
@@ -1,5 +1,5 @@ | |||
# Gradient in AdvancedHMC.jl | |||
|
|||
AdvancedHMC.jl supports automatic differentiation using [`LogDensityProblemsAD`](https://github.com/tpapp/LogDensityProblemsAD.jl) and user-specified gradients. While the default AD backend for AdvancedHMC.jl is ForwardDiff.jl, we can seamlessly change to other backend like Zygote.jl using various syntax like `Hamiltonian(metric, ℓπ, Zygote)`, `Hamiltonian(metric, ℓπ, Val(:Zygote))` or via ADTypes.jl `Hamiltonian(metric, ℓπ, AutoZygote())`. | |||
AdvancedHMC.jl supports automatic differentiation using [`LogDensityProblemsAD`](https://github.com/tpapp/LogDensityProblemsAD.jl) across various AD backends and allows user-specified gradients. While the default AD backend for AdvancedHMC.jl is ForwardDiff.jl, we can seamlessly change to other backend like Mooncake.jl using various syntax like `Hamiltonian(metric, ℓπ, AutoZygote())`. Different AD backend can also be pluged in using `Hamiltonian(metric, ℓπ, Zygote)`, `Hamiltonian(metric, ℓπ, Val(:Zygote))` but we recommend using ADTypes since that would allow you to have more freedom for specifying the AD backend. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is the mixture of Mooncake and Zygote here intentional? Would it be clearer to have the whole example use Mooncake?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I probably merge this too soon. Please open another follow-up PR.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Follow-up in #423
Fix: #330
Fix: #413
Fix: #402
Replace #414
Preview can be checked in https://turinglang.org/AdvancedHMC.jl/previews/PR417