https://github.com/juliastats/distributions.jl

A Julia package for probability distributions and associated functions.
https://github.com/juliastats/distributions.jl

data-science julia probability-distributions statistics

Last synced: 21 days ago
JSON representation

A Julia package for probability distributions and associated functions.

• Host: GitHub
• URL: https://github.com/juliastats/distributions.jl
• Owner: JuliaStats
• License: other
• Created: 2012-11-09T20:01:33.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2024-10-10T22:43:45.000Z (25 days ago)
• Last Synced: 2024-10-15T13:03:57.953Z (21 days ago)
• Topics: data-science, julia, probability-distributions, statistics
• Language: Julia
• Homepage:
• Size: 12 MB
• Stars: 1,106
• Watchers: 38
• Forks: 414
• Open Issues: 427
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md
  • Citation: CITATION.bib

Awesome Lists containing this project

README

        
Distributions.jl

================

[![Build Status](https://github.com/JuliaStats/Distributions.jl/workflows/CI/badge.svg)](https://github.com/JuliaStats/Distributions.jl/actions)

[![](https://zenodo.org/badge/DOI/10.5281/zenodo.2647458.svg)](https://zenodo.org/record/2647458)

[![Coverage Status](https://coveralls.io/repos/JuliaStats/Distributions.jl/badge.svg?branch=master)](https://coveralls.io/r/JuliaStats/Distributions.jl?branch=master)

[![Aqua QA](https://raw.githubusercontent.com/JuliaTesting/Aqua.jl/master/badge.svg)](https://github.com/JuliaTesting/Aqua.jl)

[![](https://img.shields.io/badge/docs-latest-blue.svg)](https://JuliaStats.github.io/Distributions.jl/latest/)

[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://JuliaStats.github.io/Distributions.jl/stable/)

A Julia package for probability distributions and associated functions. Particularly, *Distributions* implements:

* Moments (e.g mean, variance, skewness, and kurtosis), entropy, and other properties

* Probability density/mass functions (pdf) and their logarithm (logpdf)

* Moment generating functions and characteristic functions

* Sampling from a population or from a distribution

* Maximum likelihood estimation

**Note:** The functionalities related to conjugate priors have been moved to the [ConjugatePriors package](https://github.com/JuliaStats/ConjugatePriors.jl).

## Resources

* **Documentation**: 

* **Support**: We use GitHub for the development of the Julia package *Distributions* itself. 

For support and questions, please use the [Julia Discourse forum](https://discourse.julialang.org).

Also, for casual conversation and quick questions, there are the channels `#helpdesk` and `#statistics` in the official Julia chat (https://julialang.slack.com). To get an invitation, please visit [https://julialang.org/slack/](https://julialang.org/slack/).

## Contributing

### Reporting issues

* If you need help or an explanation of how to use *Distributions* ask in the forum (https://discourse.julialang.org) or, for informal questions, visit the chat (https://julialang.slack.com).

If you have a bug linked with *Distributions*, check that it has

not been reported yet on the issues of the repository.

If not, you can file a new issue, add your version of the package

which you can get with this command in the Julia REPL:

```julia

julia> ]status Distributions

```

Be exhaustive in your report, summarize the bug, and provide:

a Minimal Working Example (MWE), what happens, and what you

expected to happen.

### Workflow with Git and GitHub

To contribute to the package, fork the repository on GitHub,

clone it and make modifications on a new branch,

**do not commit modifications on master**.

Once your changes are made, push them on your fork and create the

Pull Request on the main repository.

### Requirements

Distributions is a central package which many rely on,

the following are required for contributions to be accepted:

1. Docstrings must be added to all interface and non-trivial functions.

2. Tests validating the modified behavior in the `test` folder. If new test files are added, do not forget to add them in `test/runtests.jl`. Cover possible edge cases. Run the tests locally before submitting the PR.

3. At the end of the tests, `Test.detect_ambiguities(Distributions)` is run to check method ambiguities. Verify that your modified code did not yield method ambiguities.

4. Make corresponding modifications to the `docs` folder, build the documentation locally and verify that your modifications display correctly and did not yield warnings. To build the documentation locally, you first need to instantiate the `docs/` project:

       julia --project=docs/

       pkg> instantiate

       pkg> dev .

   Then use `julia --project=docs/ docs/make.jl` to build the documentation.

## Citing

See `CITATION.bib`, or use the DOI badge above.