![Build Status](http://travis-ci.org/tmcw/simple-statistics) ![Coverage Status](https://coveralls.io/r/tmcw/simple-statistics)

A JavaScript implementation of descriptive, regression, and inference statistics.

Implemented in literate JavaScript with no dependencies, designed to work
in all modern browsers (including IE) as well as in node.js.

API Documentation

---

Basic contracts of functions:

* Functions do not modify their arguments e.g. change their order
* Invalid input, like empty lists to functions that need 1+ items to work, will cause functions to return null.

Basic Array Operations

$3

_Optionally_ mix in the following functions into the Array prototype. Otherwise
you can use them off of the simple-statistics object itself.

If given a particular array instance as an argument, this adds the functions
only to that array rather than the global Array.prototype. Without an argument,
it runs on the global Array.prototype.

$3

Mean of a single-dimensional Array of numbers. _Also available as .average(x)_

$3

Sum of a single-dimensional Array of numbers.

$3

Returns the number that appears most frequently in a single-dimensional Array
of numbers. If there are multiple modes, the one that appears last
is returned.

$3

Variance of a single-dimensional Array of numbers.

$3

Standard Deviation of a single-dimensional Array of numbers.

$3

The Median Absolute Deviation (MAD) is a robust measure of statistical
dispersion. It is more resilient to outliers than the standard deviation.
Accepts a single-dimensional array of numbers and returns a dispersion value.

Also aliased to .mad(x) for brevity.

$3

Median of a single-dimensional array of numbers.

$3

Geometric mean of a single-dimensional array of positive numbers.

$3

Harmonic mean of a single-dimensional array of positive numbers.

$3

Root mean square (RMS) of a single-dimensional array of numbers.

$3

Finds the minimum of a single-dimensional array of numbers. This runs in linear O(n) time.

$3

Finds the maximum of a single-dimensional array of numbers. This runs in linear O(n) time.

$3

Does a student's t-test of a dataset sample, represented by a single-dimensional array of numbers. x is the known value, and the result is a measure of statistical significance.

$3

The two-sample t-test is used to compare samples from two populations or groups,
confirming or denying the suspicion (null hypothesis) that the populations are
the same. It returns a t-value that you can then look up to give certain
judgements of confidence based on a t distribution table.

This implementation expects the samples sample_x and sample_y to be given
as one-dimensional arrays of more than one number each.

$3

Produces sample variance
of a single-dimensional array of numbers.

$3

Produces sample covariance
of two single-dimensional arrays of numbers.

$3

Produces sample correlation
of two single-dimensional arrays of numbers.

$3

Does a quantile of a dataset sample,
at p. For those familiary with the k/q syntax, p == k/q. sample must
be a single-dimensional array of numbers. p must be a number greater than or equal to zero and less than or equal to one, or an array of numbers following that rule.
If an array is given, an array of results will be returned instead of a single
number.

$3

Given a sample array, and a positive integer chunkSize, splits an array
into chunks of chunkSize size and returns an array of those chunks. This
does not change the input value. If the length of sample is not divisible
by chunkSize, the last array will be shorter than the rest.

$3

Does a quantile of a dataset sample,
at p. sample must be a one-dimensional _sorted_ array of numbers, and
p must be a single number greater than or equal to zero and less than or equal to one.

$3

Calculates the Interquartile range of
a sample - the difference between the upper and lower quartiles. Useful
as a measure of dispersion.

_Also available as .interquartile_range(x)_

$3

Calculates the skewness of
a sample, a measure of the extent to which a probability distribution of a
real-valued random variable "leans" to one side of the mean.
The skewness value can be positive or negative, or even undefined.

This implementation uses the Fisher-Pearson standardized moment coefficient,
which means that it behaves the same as Excel, Minitab, SAS, and SPSS.

Skewness is only valid for samples of over three values.

$3

Find the Jenks Natural Breaks for
a single-dimensional array of numbers as input and a desired number_of_classes.
The result is a single-dimensional with class breaks, including the minimum
and maximum of the input array.

$3

Find the r-squared value of a particular dataset, expressed as a two-dimensional Array of numbers, against a Function.

var r_squared = ss.r_squared([[1, 1]], function(x) { return x * 2; });

$3

Look up the given z value in a standard normal table
to calculate the probability of a random variable appearing with a given value.

$3

The standard score is the number of standard deviations an observation
or datum is above or below the mean.

$3

A standard normal table from
which to pull values of Φ (phi).

Regression

$3

Create a new linear regression solver.

#### .data([[1, 1], [2, 2]])

Set the data of a linear regression. The input is a two-dimensional array of numbers, which are treated as coordinates, like [[x, y], [x1, y1]].

#### .line()

Get the linear regression line: this returns a function that you can
give x values and it will return y values. Internally, this uses the m()
and b() values and the classic y = mx + b equation.

var linear_regression_line = ss.linear_regression()
.data([[0, 1], [2, 2], [3, 3]]).line();
linear_regression_line(5);

#### .m()

Just get the slope of the fitted regression line, the m component of the full
line equation. Returns a number.

#### .b()

Just get the y-intercept of the fitted regression line, the b component
of the line equation. Returns a number.

Classification

$3

Create a naïve bayesian classifier.

$3

Train the classifier to classify a certain item, given as an object with keys,
to be in a certain category, given as a string.

$3

Get the classifications of a certain item, given as an object of
category -> score mappings.

var bayes = ss.bayesian();
bayes.train({ species: 'Cat' }, 'animal');
bayes.score({ species: 'Cat' });
// { animal: 1 }

---

Literate Source

Usage

To use it in browsers, grab simple_statistics.js.
To use it in node, install it with npm or add it to your package.json.

npm install simple-statistics

To use it with component,

component install tmcw/simple-statistics

To use it with bower,

bower install simple-statistics

Basic Descriptive Statistics

``javascript // Require simple statistics var ss = require('simple-statistics');

// The input is a simple array var list = [1, 2, 3];

// Many different descriptive statistics are supported var sum = ss.sum(list), mean = ss.mean(list), min = ss.min(list), geometric_mean = ss.geometric_mean(list), max = ss.max(list), quantile = ss.quantile(0.25);`

`Linear Regression`

`javascript // For a linear regression, it's a two-dimensional array var data = [ [1, 2], [2, 3] ];

// simple-statistics can produce a linear regression and return // a friendly javascript function for the line. var line = ss.linear_regression() .data(data) .line();

// get a point along the line function line(0);

var line = ss.linear_regression()

// Get the r-squared value of the line estimation ss.r_squared(data, line);`

`$3`

`javascript var bayes = ss.bayesian(); bayes.train({ species: 'Cat' }, 'animal'); bayes.score({ species: 'Cat' }); // { animal: 1 }`

`$3`

_This is optional and not used by default. You can opt-in to mixins withss.mixin()._

This mixes simple-statisticsmethods into the Array prototype - note that extending native objects is a tricky move.

This will _only work_ if definePropertyis available, which means modern browsers and nodejs - on IE8 and below, callingss.mixin() will throw an exception.

`javascript // mixin to Array class ss.mixin();

// The input is a simple array var list = [1, 2, 3];

// The same descriptive techniques as above, but in a simpler style var sum = list.sum(), mean = list.mean(), min = list.min(), max = list.max(), quantile = list.quantile(0.25);``

Examples

* Linear regression with simple-statistics and d3js
* Jenks Natural Breaks with a choropleth map with d3js

Contributors

* Tom MacWright
* Matt Sacks
* Doron Linder
* Alexander Sicular

![Build Status](http://travis-ci.org/tmcw/simple-statistics) ![Coverage Status](https://coveralls.io/r/tmcw/simple-statistics)

A JavaScript implementation of descriptive, regression, and inference statistics.

Implemented in literate JavaScript with no dependencies, designed to work
in all modern browsers (including IE) as well as in node.js.

API Documentation

---

Basic contracts of functions:

* Functions do not modify their arguments e.g. change their order
* Invalid input, like empty lists to functions that need 1+ items to work, will cause functions to return null.

Basic Array Operations

$3

_Optionally_ mix in the following functions into the Array prototype. Otherwise
you can use them off of the simple-statistics object itself.

If given a particular array instance as an argument, this adds the functions
only to that array rather than the global Array.prototype. Without an argument,
it runs on the global Array.prototype.

$3

Mean of a single-dimensional Array of numbers. _Also available as .average(x)_

$3

Sum of a single-dimensional Array of numbers.

$3

Returns the number that appears most frequently in a single-dimensional Array
of numbers. If there are multiple modes, the one that appears last
is returned.

$3

Variance of a single-dimensional Array of numbers.

$3

Standard Deviation of a single-dimensional Array of numbers.

$3

Also aliased to .mad(x) for brevity.

$3

Median of a single-dimensional array of numbers.

$3

Geometric mean of a single-dimensional array of positive numbers.

$3

Harmonic mean of a single-dimensional array of positive numbers.

$3

Root mean square (RMS) of a single-dimensional array of numbers.

$3

Finds the minimum of a single-dimensional array of numbers. This runs in linear O(n) time.

$3

Finds the maximum of a single-dimensional array of numbers. This runs in linear O(n) time.

$3

Does a student's t-test of a dataset sample, represented by a single-dimensional array of numbers. x is the known value, and the result is a measure of statistical significance.

$3

This implementation expects the samples sample_x and sample_y to be given
as one-dimensional arrays of more than one number each.

$3

Produces sample variance
of a single-dimensional array of numbers.

$3

Produces sample covariance
of two single-dimensional arrays of numbers.

$3

Produces sample correlation
of two single-dimensional arrays of numbers.

$3

Does a quantile of a dataset sample,
at p. sample must be a one-dimensional _sorted_ array of numbers, and
p must be a single number greater than or equal to zero and less than or equal to one.

$3

Calculates the Interquartile range of
a sample - the difference between the upper and lower quartiles. Useful
as a measure of dispersion.

_Also available as .interquartile_range(x)_

$3

This implementation uses the Fisher-Pearson standardized moment coefficient,
which means that it behaves the same as Excel, Minitab, SAS, and SPSS.

Skewness is only valid for samples of over three values.

$3

Find the r-squared value of a particular dataset, expressed as a two-dimensional Array of numbers, against a Function.

var r_squared = ss.r_squared([[1, 1]], function(x) { return x * 2; });

$3

Look up the given z value in a standard normal table
to calculate the probability of a random variable appearing with a given value.

$3

The standard score is the number of standard deviations an observation
or datum is above or below the mean.

$3

A standard normal table from
which to pull values of Φ (phi).

Regression

$3

Create a new linear regression solver.

#### .data([[1, 1], [2, 2]])

Set the data of a linear regression. The input is a two-dimensional array of numbers, which are treated as coordinates, like [[x, y], [x1, y1]].

#### .line()

var linear_regression_line = ss.linear_regression()
.data([[0, 1], [2, 2], [3, 3]]).line();
linear_regression_line(5);

#### .m()

Just get the slope of the fitted regression line, the m component of the full
line equation. Returns a number.

#### .b()

Just get the y-intercept of the fitted regression line, the b component
of the line equation. Returns a number.

Classification

$3

Create a naïve bayesian classifier.

$3

Train the classifier to classify a certain item, given as an object with keys,
to be in a certain category, given as a string.

$3

Get the classifications of a certain item, given as an object of
category -> score mappings.

var bayes = ss.bayesian();
bayes.train({ species: 'Cat' }, 'animal');
bayes.score({ species: 'Cat' });
// { animal: 1 }

---

Literate Source

Usage

To use it in browsers, grab simple_statistics.js.
To use it in node, install it with npm or add it to your package.json.

npm install simple-statistics

To use it with component,

component install tmcw/simple-statistics

To use it with bower,

bower install simple-statistics

Basic Descriptive Statistics

``javascript // Require simple statistics var ss = require('simple-statistics');

// The input is a simple array var list = [1, 2, 3];

`Linear Regression`

`javascript // For a linear regression, it's a two-dimensional array var data = [ [1, 2], [2, 3] ];

// simple-statistics can produce a linear regression and return // a friendly javascript function for the line. var line = ss.linear_regression() .data(data) .line();

// get a point along the line function line(0);

var line = ss.linear_regression()

// Get the r-squared value of the line estimation ss.r_squared(data, line);`

`$3`

`javascript var bayes = ss.bayesian(); bayes.train({ species: 'Cat' }, 'animal'); bayes.score({ species: 'Cat' }); // { animal: 1 }`

`$3`

_This is optional and not used by default. You can opt-in to mixins withss.mixin()._

This mixes simple-statisticsmethods into the Array prototype - note that extending native objects is a tricky move.

This will _only work_ if definePropertyis available, which means modern browsers and nodejs - on IE8 and below, callingss.mixin() will throw an exception.

`javascript // mixin to Array class ss.mixin();

// The input is a simple array var list = [1, 2, 3];

// The same descriptive techniques as above, but in a simpler style var sum = list.sum(), mean = list.mean(), min = list.min(), max = list.max(), quantile = list.quantile(0.25);``

Examples

* Linear regression with simple-statistics and d3js
* Jenks Natural Breaks with a choropleth map with d3js

Contributors

* Tom MacWright
* Matt Sacks
* Doron Linder
* Alexander Sicular

spm-simple-statistics

API Documentation

Basic Array Operations

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

Regression

$3

Classification

$3

$3

$3

Literate Source

Usage

Basic Descriptive Statistics

Linear Regression

$3

$3

Examples

Contributors

spm-simple-statistics

API Documentation

Basic Array Operations

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

Regression

$3

Classification

$3

`Linear Regression`

`$3`

`$3`

`Linear Regression`

`$3`

`$3`