@basementuniverse/stats

Stats

Basic stats functions

Installation

npm install @basementuniverse/stats

Usage

Node:

const {
  mean,
  median,
  mode,
  range,
  variance,
  standardDeviation,
  iqr,
} = require('@basementuniverse/stats');

Typescript:

import {
  mean,
  median,
  mode,
  range,
  variance,
  standardDeviation,
  iqr,
} from '@basementuniverse/stats';

Docs

Functions

minArray(a) ⇒ number

Safe version of Math.min

Native Math.min throws:

`Uncaught RangeError: Maximum call stack size exceeded`

when passing in a huge number of arguments (>~100k).

maxArray(a) ⇒ number

Safe version of Math.max

Native Math.max throws:

`Uncaught RangeError: Maximum call stack size exceeded`

when passing in a huge number of arguments (>~100k).

mean(data) ⇒ number

Find the mean of a list of numbers

median(data) ⇒ number

Find the median of a list of numbers

mode(data) ⇒ number

Find the mode of a list of numbers

range(data) ⇒ object

Find the range of a list of numbers

variance(data, sample) ⇒ number

Calculate the variance of a list of numbers

standardDeviation(data, sample) ⇒ number

Calculate the standard deviation of a list of numbers

iqr(data) ⇒ object

Calculate the (exclusive) interquartile range of a list of numbers

minArray(a) ⇒ number

Safe version of Math.min

Native Math.min throws:

`Uncaught RangeError: Maximum call stack size exceeded`

when passing in a huge number of arguments (>~100k).

Kind: global function
Returns: number - The minimum number from the array

Param	Type	Description
a	Array.<number>	An array of numbers

maxArray(a) ⇒ number

Safe version of Math.max

Native Math.max throws:

`Uncaught RangeError: Maximum call stack size exceeded`

when passing in a huge number of arguments (>~100k).

Kind: global function
Returns: number - The maximum number from the array

Param	Type	Description
a	Array.<number>	An array of numbers

mean(data) ⇒ number

Find the mean of a list of numbers

Kind: global function
Returns: number - The mean of a list of numbers

Param	Type	Description
data	Array.<number>	An array of numbers

median(data) ⇒ number

Find the median of a list of numbers

Kind: global function
Returns: number - The median of a list of numbers

Param	Type	Description
data	Array.<number>	An array of numbers

mode(data) ⇒ number

Find the mode of a list of numbers

Kind: global function
Returns: number - The mode of a list of numbers

Param	Type	Description
data	Array.<number>	An array of numbers

range(data) ⇒ object

Find the range of a list of numbers

Kind: global function
Returns: object - An object containing the min, max and range

Param	Type	Description
data	Array.<number>	An array of numbers

Example
Returned format:

{
  min: 1,
  max: 5,
  range: 4
}

variance(data, sample) ⇒ number

Calculate the variance of a list of numbers

Kind: global function
Returns: number - The variance of a list of numbers

Param	Type	Default	Description
data	Array.<number>		An array of numbers
sample	boolean	false	True if the dataset is a sample

standardDeviation(data, sample) ⇒ number

Calculate the standard deviation of a list of numbers

Kind: global function
Returns: number - The standard deviation of a list of numbers

Param	Type	Default	Description
data	Array.<number>		An array of numbers
sample	boolean	false	True if the dataset is a sample

iqr(data) ⇒ object

Calculate the (exclusive) interquartile range of a list of numbers

Kind: global function
Returns: object - An object containing the Q1, Q2 and Q3 medians and interquartile range

Param	Type	Description
data	Array.<number>	An array of numbers

Example
Returned format:

{
  q1: 1,
  q2: 3,
  q3: 5,
  range: 4
}