# free-gaussian

A JavaScript model of a Gaussian distribution

# gaussian

A JavaScript model of the Normal
(or Gaussian) distribution. To install run `npm install free-gaussian`

## API

### Creating a Distribution

var gaussian = require'free-gaussian';var distribution = gaussianmean variance;

### Properties

`mean`

: the mean (μ) of the distribution`variance`

: the variance (σ^2) of the distribution`standardDeviation`

: the standard deviation (σ) of the distribution

### Probability Functions

`pdf(x)`

: the probability density function, which describes the probability of a random variable taking on the value*x*`cdf(x)`

: the cumulative distribution function, which describes the probability of a random variable falling in the interval (−∞,*x*]`ppf(x)`

: the percent point function, the inverse of*cdf*

### Combination Functions

`mul(d)`

: returns the product distribution of this and the given distribution. If a constant is passed in the distribution is scaled.`div(d)`

: returns the quotient distribution of this and the given distribution. If a constant is passed in the distribution is scaled by 1/d.`add(d)`

: returns the result of adding this and the given distribution`sub(d)`

: returns the result of subtracting this and the given distribution`scale(c)`

: returns the result of scaling this distribution by the given constant

## History

This is a modified version of errcw's library with some additional features and a cleaned up code base.