Statistics¶

This section showcases the utility functions found in the datachart.utils.stats module.

Let us start by importing the supporting libraries:

In [1]:

import random

import random

Statistics Submodule¶

The dataset.utils.stats submodule contains functions for calculating statistics. To showcase its use, let us create a list of random numbers:

In [2]:

random_values = random.sample(range(1, 100), 10)
random_values

random_values = random.sample(range(1, 100), 10) random_values

Out[2]:

[69, 35, 56, 99, 85, 50, 68, 37, 65, 29]

Let us now showcase the functions in the stats module.

Count¶

The count function returns the number of elements in the list.

In [3]:

from datachart.utils.stats import count

from datachart.utils.stats import count

In [4]:

count(random_values)

count(random_values)

Out[4]:

10

Sum¶

The sum_values function returns the sum of all values in the list.

In [5]:

from datachart.utils.stats import sum_values

from datachart.utils.stats import sum_values

In [6]:

sum_values(random_values)

sum_values(random_values)

Out[6]:

593.0

Mean¶

The mean function returns the mean of the values.

In [7]:

from datachart.utils.stats import mean

from datachart.utils.stats import mean

In [8]:

mean(random_values)

mean(random_values)

Out[8]:

59.3

Median¶

The median function returns the median of the values.

In [9]:

from datachart.utils.stats import median

from datachart.utils.stats import median

In [10]:

median(random_values)

median(random_values)

Out[10]:

60.5

Standard Deviation¶

The stdev function returns the standard deviation of the values.

In [11]:

from datachart.utils.stats import stdev

from datachart.utils.stats import stdev

In [12]:

stdev(random_values)

stdev(random_values)

Out[12]:

21.312203077110542

Variance¶

The variance function returns the variance of the values. Variance is the square of the standard deviation.

In [13]:

from datachart.utils.stats import variance

from datachart.utils.stats import variance

In [14]:

variance(random_values)

variance(random_values)

Out[14]:

454.21000000000004

Quantile¶

The quantile function returns the quantile of the values.

In [15]:

from datachart.utils.stats import quantile

from datachart.utils.stats import quantile

Show the 25th quantile:

In [16]:

quantile(random_values, 25)

quantile(random_values, 25)

Out[16]:

40.25

Show the 75th quantile:

In [17]:

quantile(random_values, 75)

quantile(random_values, 75)

Out[17]:

68.75

Interquartile Range (IQR)¶

The iqr function returns the interquartile range, which is the difference between the 75th percentile (Q3) and 25th percentile (Q1). It is useful for identifying outliers and understanding the spread of the middle 50% of the data.

In [18]:

from datachart.utils.stats import iqr

from datachart.utils.stats import iqr

In [19]:

iqr(random_values)

iqr(random_values)

Out[19]:

28.5

Minimum¶

The minimum function returns the minimum of the values.

In [20]:

from datachart.utils.stats import minimum

from datachart.utils.stats import minimum

In [21]:

minimum(random_values)

minimum(random_values)

Out[21]:

29.0

Maximum¶

The maximum function returns the maximum of the values.

In [22]:

from datachart.utils.stats import maximum

from datachart.utils.stats import maximum

In [23]:

maximum(random_values)

maximum(random_values)

Out[23]:

99.0

Correlation¶

The correlation function calculates the Pearson correlation coefficient between two lists of values. It measures the linear relationship between the datasets, ranging from -1 (perfect negative correlation) to 1 (perfect positive correlation).

In [24]:

from datachart.utils.stats import correlation

from datachart.utils.stats import correlation

Create a second list of random values to compare:

In [25]:

random_values_2 = random.sample(range(1, 100), 10)
random_values_2

random_values_2 = random.sample(range(1, 100), 10) random_values_2

Out[25]:

[39, 32, 93, 19, 35, 77, 72, 69, 34, 55]

In [26]:

correlation(random_values, random_values_2)

correlation(random_values, random_values_2)

Out[26]:

-0.440056293156963

Under development

This theme is still under development. If you are interested in improving it, please let us know.