Metadata-Version: 2.1
Name: probs
Version: 0.0.6
Summary: Probability library for Python
Home-page: https://github.com/tyleryep/probs
Author: Tyler Yep
Author-email: tyep@cs.stanford.edu
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# probs

[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/release/python-370/)
[![Build Status](https://github.com/TylerYep/probs/actions/workflows/test.yml/badge.svg)](https://github.com/TylerYep/probs/actions/workflows/test.yml)
[![GitHub license](https://img.shields.io/github/license/TylerYep/probs)](https://github.com/TylerYep/probs/blob/main/LICENSE)
[![codecov](https://codecov.io/gh/TylerYep/probs/branch/main/graph/badge.svg)](https://codecov.io/gh/TylerYep/probs)
[![Downloads](https://pepy.tech/badge/probs)](https://pepy.tech/project/probs)

Probability is a concept that many introductory Computer Science courses teach because of its frequent application in algorithms, data structures, and other mathematical fields. While numerous libraries for expressing probabilities exist (e.g. scipy, statistics, etc), the majority of them focus primarily on the application of these concepts rather than showcasing the mechanics of the mathematical theory.

The goal of this project is to leverage Python's built-in language features to expose an intuitive and expandable API for simple probabilitic expressions.

# Usage

`pip install probs`

# Examples

```python
from probs import *

# define a normally-distributed random variable with
# mean = 0, variance = 1
X = Normal()

assert E(X) == 0
assert Var(X) == 1 / 12
assert X.pdf(0.5) == 2
```

```python
# combine multiple random variables
u, v = Uniform(), Uniform()

assert E(u) == 1 / 2
assert Var(u) == 1 / 12

assert (u * v).pdf(0.5) == 39.0169
assert (1 * v).pdf(0.5) == 1

assert E(u + 1) == 1.5
assert E(u + v) == 1
assert E(u - v) == 0

assert Var(u + v) == 1 / 6
```

# Documentation

# Contributing

All issues and pull requests are much appreciated! To build the project:

- probs is actively developed using the lastest version of Python.
  - First, be sure to run `pre-commit install`.
  - To run all tests and use auto-formatting tools, use `pre-commit run`.
  - To only run unit tests, run `pytest`.

## TODO List

- Use ApproxFloat across all operations.
- Dataclasses are iffy, because:

  - Need to set super().**init**() in order to get the parent class's fields.
  - Need to set eq=False on all RandomVariables.
  - Need to set repr=False in order to get the parent's **repr** method.

  - However, clearer **init** function provided, other operators potentially builtin.
  - repr can be inherited without a rewrite
  - inheritance works so long as every parent is also a dataclass.
  - super short init syntax

- Figure out how to merge pmf and custom pmf functions.


