Skip to content

doc(gh-2187): add math explanations for Normal, Cauchy, and Exponential distributions#2188

Merged
Qazalbash merged 4 commits into
pyro-ppl:masterfrom
kimjune01:docs-2187-distribution-math
May 11, 2026
Merged

doc(gh-2187): add math explanations for Normal, Cauchy, and Exponential distributions#2188
Qazalbash merged 4 commits into
pyro-ppl:masterfrom
kimjune01:docs-2187-distribution-math

Conversation

@kimjune01
Copy link
Copy Markdown
Contributor

@kimjune01 kimjune01 commented May 9, 2026

This PR adds mathematical explanations and implementation details to the docstrings for the Normal, Cauchy, and Exponential distributions, continuing the documentation effort from #2185.

…butions (pyro-ppl#2187)

Add LaTeX math explanations, parameter documentation, and method
docstrings following the format established in pyro-ppl#2185 (Beta/BetaProportion).

Covers PDF, log_prob, CDF, ICDF, mean, variance, entropy, and sample
for each distribution. Cauchy docstrings note the undefined mean/variance.
@Qazalbash Qazalbash self-assigned this May 9, 2026
@Qazalbash
Copy link
Copy Markdown
Collaborator

Thanks @kimjune01

@Qazalbash
Copy link
Copy Markdown
Collaborator

Qazalbash commented May 9, 2026

Please remove the "Fixes #" line from the description. #2187 is a tracking issue and will remain open after this PR merges.


No worries, I removed it myself.

Copy link
Copy Markdown
Collaborator

@Qazalbash Qazalbash left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall looks good. Some changes are requested.

Comment thread numpyro/distributions/continuous.py Outdated
Comment thread numpyro/distributions/continuous.py
Comment thread numpyro/distributions/continuous.py Outdated
kimjune01 added 2 commits May 9, 2026 08:38
- Add equation for Normal.log_cdf with note about jax.scipy.stats.norm.logcdf implementation
- Replace \tfrac with \frac in Cauchy.icdf equation

Addresses review comments from @Qazalbash in PR pyro-ppl#2188
@Qazalbash Qazalbash self-requested a review May 11, 2026 05:33
Copy link
Copy Markdown
Collaborator

@Qazalbash Qazalbash left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have improved the documentation of some methods of Normal distribution. This PR is ready for merging.

@Qazalbash Qazalbash merged commit 8dbe44a into pyro-ppl:master May 11, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants