Simple statistics module

stats.py

# Simple stats module. For large sets of data, check Numpy instead

from statistics import mean, median_low, stdev, mode


def stat(lst):
    if not lst:
        return None

    _min = min(lst)
    _max = max(lst)

    return {
        'mean': mean(lst),
        'median': median_low(lst),
        'mode': mode(lst),
        'min': _min,
        'max': _max,
        'stdev': stdev(lst),
        'n': len(lst),
        'range': _max - _min
    }

def fmt_stat(lst):
    values = stat(lst)

    if not values:
        return 'N/A, empty data set'

    return 'n: {n}, mean/stdev: {mean:.3f}/{stdev:.2f}, median/mode: {median}/{mode}, min/max: {min}/{max}, range: {range}'.format(**values)


# Example usage:
# lst = [1, 2, 6, 2, 5, 2, 6, 7, 23, 5, 31, 11, 3]
# print(fmt_stat(lst)) # => n: 13, mean/stdev: 8.000/9.00, median/mode: 5/2, min/max: 1/31, range: 30
# print(fmt_stat([]))  # => N/A, empty data set