simplestatistics

simple-statistics for Python.

simplestatistics is compatible with Python 3.

Version 0.4.0 was the last version to not use Python 3 specific features. Going forward, simplestatistics will adopt Python 3 features (e.g., type hints).

Installation

Install the current PyPI release:

pip install simplestatistics

Or install the development version from GitHub:

pip install git+https://github.com/sheriferson/simplestatistics

Usage

>>> import simplestatistics as ss
>>> ss.mean([1, 2, 3])
2.0
>>> ss.t_test([1, 2, 2.4, 3, 0.9], 2)
-0.3461277235039042

Documentation

You can read the documentation online.

Or you can generate it yourself:

Inside simplestatistics/.

make html

Documentation will be generated in _build/html/.

Tests

If you want coverage reports, you need to have coverage installed:

pip install coverage
nosetests --with-coverage --cover-package=simplestatistics --with-doctest

Otherwise, to just run the tests:

nosetests --with-doctest

The code adheres to PEP8 guidelines except for the following checkers:

• invalid-name
• len-as-condition
• superfluous-parens
• unidiomatic-typecheck

To lint the code, make sure you have [pylint] installed (pip install pylint), cd into the simplestatistics/statistics directory, then run:

pylint -d 'invalid-name, len-as-condition, superfluous-parens, unidiomatic-typecheck' *.py

Functions and examples

Descriptive statistics

Measures of central tendency

Measures of dispersion

Linear regression

Similarity

Distributions

Classifiers

Errors

Hyperbolic functions

Spirit and rules

• Everything should be implemented in raw, organic, locally sourced Python.
• Use libraries only if you have to and only when unrelated to the math/statistics. For example, from functools import reduce to make reduce available for those using python3. That's okay, because it's about making Python work and not about making the stats easier.
• It's okay to use operators and functions if they correspond to regular calculator buttons. For example, all calculators have a built-in square root function, so there is no need to implement that ourselves, we can use math.sqrt(). Anything beyond that, like mean, median, we have to write ourselves.

Pull requests are welcome!

Contributors

• Jim Anderson (jhowardanderson)
• Lidiane Taquehara (lidimayra)
• Pierre-Selim (PierreSelim)
• Tom MacWright (tmcw)