SuanShu, a Java numerical and statistical library

com.numericalmethod.suanshu.stats.distribution.univariate
Class NormalDistribution

java.lang.Object
  extended by com.numericalmethod.suanshu.stats.distribution.univariate.NormalDistribution
All Implemented Interfaces:
UnivariateDistribution

public class NormalDistribution
extends java.lang.Object
implements UnivariateDistribution

The NormalDistribution distribution has its density of a Gaussian function.

The NormalDistribution distribution is probably the most important single distribution. By the central limit theorem, under certain conditions, the sum of a number of random variables with finite means and variances approaches a normal distribution as the number of variables increases.

Laplace proved that the normal distribution occurs as a limiting distribution of arithmetic means of independent, identically distributed random variables with finite second moment.

The R equivalent functions are dnorm, pnorm, qnorm, rnorm.

See Also:

Field Summary
 double mu
          the mean
 double sigma
          the standard deviation
 
Constructor Summary
NormalDistribution()
          Construct a standard NormalDistribution distribution instance with mean 0 and standard deviation 1.
NormalDistribution(double mu, double sigma)
          Construct a NormalDistribution distribution instance with mean mu and standard deviation sigma.
 
Method Summary
 double cdf(double x)
          The cumulative distribution function.
 double density(double x)
          The density function, which, if exists, is the derivative of F.
 double entropy()
          Get the entropy of this distribution.
 double kurtosis()
          Get the excess kurtosis of this distribution.
 double mean()
          Get the mean of this distribution.
 double median()
          Get the median of this distribution.
 double moment(double t)
          The moment generating function, which is the expected value of etX This may not always exist.
 double quantile(double u)
          The inverse of the cumulative distribution function.
 double skew()
          Get the skewness of this distribution.
 double variance()
          Get the variance of this distribution.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

mu

public final double mu
the mean


sigma

public final double sigma
the standard deviation

Constructor Detail

NormalDistribution

public NormalDistribution()
Construct a standard NormalDistribution distribution instance with mean 0 and standard deviation 1.


NormalDistribution

public NormalDistribution(double mu,
                          double sigma)
Construct a NormalDistribution distribution instance with mean mu and standard deviation sigma.

Parameters:
mu - mean
sigma - standard deviation
Method Detail

mean

public double mean()
Description copied from interface: UnivariateDistribution
Get the mean of this distribution.

Specified by:
mean in interface UnivariateDistribution
Returns:
the mean
See Also:
Wikipedia: Expected value

median

public double median()
Description copied from interface: UnivariateDistribution
Get the median of this distribution.

Specified by:
median in interface UnivariateDistribution
Returns:
the median
See Also:
Wikipedia: Median

variance

public double variance()
Description copied from interface: UnivariateDistribution
Get the variance of this distribution.

Specified by:
variance in interface UnivariateDistribution
Returns:
the variance
See Also:
Wikipedia: Variance

skew

public double skew()
Description copied from interface: UnivariateDistribution
Get the skewness of this distribution.

Specified by:
skew in interface UnivariateDistribution
Returns:
the skewness
See Also:
Wikipedia: Skewness

kurtosis

public double kurtosis()
Description copied from interface: UnivariateDistribution
Get the excess kurtosis of this distribution.

Specified by:
kurtosis in interface UnivariateDistribution
Returns:
the excess kurtosis
See Also:
Wikipedia: Kurtosis

entropy

public double entropy()
Description copied from interface: UnivariateDistribution
Get the entropy of this distribution.

Specified by:
entropy in interface UnivariateDistribution
Returns:
the entropy
See Also:
Wikipedia: Entropy (information theory)

cdf

public double cdf(double x)
Description copied from interface: UnivariateDistribution
The cumulative distribution function.
F(x) = Pr(X <= x)

Specified by:
cdf in interface UnivariateDistribution
Parameters:
x - x
Returns:
F(x) = Pr(X <= x)
See Also:
Wikipedia: Cumulative distribution function

quantile

public double quantile(double u)
Description copied from interface: UnivariateDistribution
The inverse of the cumulative distribution function. It returns the value below which random draws from the given distribution would fall, u×100 percent of the time.
F-1(u) = x, such that Pr(X <= x) = u

This may not always exist.

Specified by:
quantile in interface UnivariateDistribution
Parameters:
u - u
Returns:
F-1(u)
See Also:
Wikipedia: Quantile function

density

public double density(double x)
Description copied from interface: UnivariateDistribution
The density function, which, if exists, is the derivative of F. It describes the density of probability at each point in the sample space.
f(x) = dF(X) / dx

This may not always exist. For the discrete cases, this is the probability mass function. It gives the probability that a discrete random variable is exactly equal to some value.

Specified by:
density in interface UnivariateDistribution
Parameters:
x - x
Returns:
F(x) = Pr(X <= x)
See Also:

moment

public double moment(double t)
Description copied from interface: UnivariateDistribution
The moment generating function, which is the expected value of
etX

This may not always exist.

Specified by:
moment in interface UnivariateDistribution
Parameters:
t - x
Returns:
E(exp(tX))
See Also:
Wikipedia: Moment-generating function

SuanShu, a Java numerical and statistical library

Copyright © 2011 Numerical Method Inc. Ltd. All Rights Reserved.