https://github.com/vaibhavkarve/distribution-algebra

A python package that implements an easy-to-use interface for random variables, statistical distributions, and their algebra.
https://github.com/vaibhavkarve/distribution-algebra

plot python statistics

Last synced: 5 months ago
JSON representation

A python package that implements an easy-to-use interface for random variables, statistical distributions, and their algebra.

• Host: GitHub
• URL: https://github.com/vaibhavkarve/distribution-algebra
• Owner: vaibhavkarve
• License: gpl-3.0
• Created: 2023-01-02T23:45:07.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-03-06T03:49:33.000Z (over 1 year ago)
• Last Synced: 2025-08-28T11:53:43.901Z (10 months ago)
• Topics: plot, python, statistics
• Language: Python
• Homepage: https://vaibhavkarve.github.io/distribution-algebra/
• Size: 2.99 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# distribution-algebra

A python package that implements an easy-to-use interface for random

variables, statistical distributions, and their algebra.

This Python package is brought to you by [Vaibhav Karve](https://vaibhavkarve.github.io).

`distribution-algebra` recognizes Normal, Lognormal, Beta and Poisson

distributions. The package implements an interface to easily construct

user-defined Univariate distributions as well Vectorized distributions.

Additional features include:

- A `plot` function for probability density/mass function plotting.

- A `draw` function for drawing random samples of specified size from a given distribution.

- Addition and multiplication operations defined directly on distributions:

  - For example, the sum of two Normal (Poisson) distributions is Normal (Poisson).

  - The product of two Lognormal distributions is Lognormal.

  - The sum of two arbitrary univariate distributions is expressed as a Vectorized distribution.

![Example plot](https://github.com/vaibhavkarve/distribution-algebra/raw/main/docs/example_plot_univariate.png)

This package is written in Python v3.10, and is publicly available

under the [GNU-GPL-v3.0

license](https://github.com/vaibhavkarve/normal-form/blob/main/LICENSE).

# Installation and usage

To get started on using this package,

1.  Install Python 3.10 or higher.

2.  `python3.10 -m pip install distribution-algebra`

3.  Use it in a python script (or interactive REPL)

    ```python

    from distribution_algebra import Beta, Lognormal, Normal, Poisson

    x: Normal = Normal(mean=1.0, var=9.0)

	y: Normal = Normal(mean=1.0, var=16.0)

	assert x + y == Normal(mean=2.0, var=25.0)

    ```