pystats

pystats is a lightweight statistical package that performs normal distributions calculations. Inspired by the simplicity and functionality of statistical tools in base R, pystats provides a focused set of functions for generating random samples, calculating cumulative probabilities, determining quantiles, and evaluating probability density functions. This package hopes to serve statisticians, data scientists, and researchers looking to derive meaningful insights from their data.

It features the following core functions:

1. rnorm: Generate random samples from a normal distribution

2. pnorm: Compute probabilities for a given quantile (cumulative distribution function)

3. qnorm: Calculate the quantile (inverse of cumulative distribution function) for a given probability

4. dnorm: Evaluate the probability density function.

Contributors

The members of the pystats team are:

• Sarah Eshafi

• Jason Lee

• Abdul Safdar

• Rong Wan

Installation

To use pystats, please follow these instructions:

1. Clone the repository

Navigate to the green “Code” button at the top of this repository. Copy the SSH link (if you have SSH configured on your machine) or the HTTPS link. In terminal, navigate to the folder you would like to clone this repository and type:

$ git clone <LINK>

2. Create the virtual environment

Still in the terminal, navigate to the root of the newly cloned repository and type:

$ conda env create environment.yml

3. Install the package

Install pystats with the following command:

$ poetry install

4. Open a Python Interpreter and import the functions

In the terminal, input:

$ python

This opens a Python interpreter. Input the following commands to import the functions:

>>> from pystats.pnorm import pnorm
>>> from pystats.dnorm import dnorm
>>> from pystats.qnorm import qnorm
>>> from pystats.rnorm import rnorm

You can now use the functions in your terminal Python interpreter!

Functions

rnorm(n, mean=0, sd=1):

Generates a NumPy array of length n containing normally distributed random variables with mean equal to mean and sd equal to sd.

pnorm(q, mean=0, sd=1, lower_tail=True):

Computes the cumulative distribution function (CDF) for a given quantile.

qnorm(p, mean=0, sd=1, lower_tail=True):

Computes the quantile (inverse CDF) for a given probability.

dnorm(x, mean=0, sd=1):

Calculates the Probability Density of the normal distribution for a given value

Python Ecosystem Integration

pystats is designed as a lightweight and intuitive package for normal distribution calculations. While similar functionality exists in libraries such as SciPy and NumPy, pystats focuses exclusively on normal distributions, offering simplified functions with user-friendly syntax designed for statistical analysis. By providing well-documented and focused functionality, it serves as a niche yet essential tool in the Python ecosystem.

Related Packages:

• numpy.random.normal - Generates random samples from a normal distribution.

• scipy.stats.norm - PDF and CDF calculations for normal distributions.

Usage

Work in progress. To be updated in a future release.

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms. For more details refer to our Contributing.md file.

License

pystats was created by Sarah Eshafi, Jason Lee, Abdul Safdar, Rong Wan. It is licensed under the terms of the MIT license.

Credits

pystats was created with cookiecutter and the py-pkgs-cookiecutter template.