Metadata-Version: 2.1
Name: ProbStatipy
Version: 0.0.4
Summary: A Python package to compute probabilities and statistics
Author-email: GREGORY OCHIENG OPONDI <ds4gregory@gmail.com>
Project-URL: Homepage, https://github.com/0gregory0/ProbStatipy
Project-URL: Issues, https://github.com/0gregory0/ProbStatipy/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENCE.txt

# ProbStatipy
---

## Intro
ProbStatipy is a package of Python modules equipped with functions that are used in Statistics.

While the functions are extensively documented, you can check out my Jupyter Notebooks in the [Numerical Summary repo](https://github.com/0gregory0/Numerical-Summary) to fully understand my thought process while coming up with these functions.

---

## Modules
As of now, this package contains two modules in the `src` folder (`src > ProbStatipy`):
1. [central.py](https://github.com/0gregory0/ProbStatipy/blob/main/src/ProbStatipy/central.py): Contains functions to measure central tendency such as Mean, Median and Mode.
2. [spread.py](https://github.com/0gregory0/ProbStatipy/blob/main/src/ProbStatipy/spread.py): Contains functions to measure dispersion/spread such as Variance (Mean Squared Deviation), Standard Deviation and Mean Absolute Deviation (MAD).

---

## How to install and use this package
To install the package, run:

```bash
pip install ProbStatipy
```

To upgrade it, run:

```bash
pip install --upgrade ProbStatipy
```

To use the modules in your Python Code, ensure to include the following import statements:

```python
from ProbStatipy import central
from ProbStatipy import spread
```

Now you can access the functions to conduct your statistical analysis:

```python
print(central.mean([3,4,5]))
print(spread.variance([3,4,5]))
```
```powershell
>>> 4.0
>>> 0.6666666666666
```
---

## Functions
Below is a catalog of functions available in each module
> **`central.py`**
>  > `mean()`
>  > Calculates the population arithmetic mean
>
>  > `median()`
>  > Calculates the median value of the population
>
>  > `mode()`
>  > Calculates the mode


> **`spread.py`**
>  > `variance()`
>  > calculates the population variance
>
>  > `stdeviation()`
>  > computes the population standard deviation
> 
>  > `mad()`
>  > Computes the population mean absolute deviation
> 
>  > `get_range`
>  > gets the range of the dataset
> 
>  > `iqr()`
>  > gets the interquartile range of the dataset

---
## Dependencies

| Module | Statistics Topic | Dependencies |
| --- | --- | --- | 
| pystats_central | Central Tendancy | - |     
| pystats_spread | Spread / Dispersion | [math](https://docs.python.org/3/library/math.html) |     

