jsat.distributions.multivariate

Interface MultivariateDistribution

All Superinterfaces:

Cloneable, Serializable

All Known Implementing Classes:

Dirichlet, EMGaussianMixture, MetricKDE, MultivariateDistributionSkeleton, MultivariateKDE, NormalM, ProductKDE, SymmetricDirichlet

public interface MultivariateDistribution
extends Cloneable, Serializable

This interface represents the contract that any continuous multivariate distribution must implement

Author:

Edward Raff

Method Summary

Modifier and Type	Method and Description
MultivariateDistribution	clone()
double	logPdf(double... x) Computes the log of the probability density function.
double	logPdf(Vec x) Computes the log of the probability density function.
double	pdf(double... x) Returns the probability of a given vector from this distribution.
double	pdf(Vec x) Returns the probability of a given vector from this distribution.
List<Vec>	sample(int count, Random rand) Performs sampling on the current distribution.
boolean	setUsingData(DataSet dataSet) Sets the parameters of the distribution to attempt to fit the given list of data points.
boolean	setUsingData(DataSet dataSet, ExecutorService threadpool) Sets the parameters of the distribution to attempt to fit the given list of data points.
<V extends Vec> boolean	setUsingData(List<V> dataSet) Sets the parameters of the distribution to attempt to fit the given list of vectors.
<V extends Vec> boolean	setUsingData(List<V> dataSet, ExecutorService threadpool) Sets the parameters of the distribution to attempt to fit the given list of vectors.
boolean	setUsingDataList(List<DataPoint> dataPoints) Sets the parameters of the distribution to attempt to fit the given list of data points.
boolean	setUsingDataList(List<DataPoint> dataPoints, ExecutorService threadpool) Sets the parameters of the distribution to attempt to fit the given list of data points.

Method Detail

logPdf

double logPdf(double... x)

Computes the log of the probability density function. If the probability of the input is zero, the log of zero would be Double.NEGATIVE_INFINITY. Instead, -Double.MAX_VALUE is returned.

Parameters:

x - the array for the vector the get the log probability of

Returns:

the log of the probability.

Throws:

ArithmeticException - if the vector is not the correct length, or the distribution has not yet been set

logPdf

double logPdf(Vec x)

Computes the log of the probability density function. If the probability of the input is zero, the log of zero would be Double.NEGATIVE_INFINITY. Instead, -Double.MAX_VALUE is returned.

Parameters:

x - the vector the get the log probability of

Returns:

the log of the probability.

Throws:

ArithmeticException - if the vector is not the correct length, or the distribution has not yet been set

pdf

double pdf(double... x)

Returns the probability of a given vector from this distribution. By definition, the probability will always be in the range [0, 1].

Parameters:

x - the array of the vector the get the log probability of

Returns:

the probability

Throws:

ArithmeticException - if the vector is not the correct length, or the distribution has not yet been set

pdf

double pdf(Vec x)

Returns the probability of a given vector from this distribution. By definition, the probability will always be in the range [0, 1].

Parameters:

x - the vector the get the log probability of

Returns:

the probability

Throws:

ArithmeticException - if the vector is not the correct length, or the distribution has not yet been set

setUsingData

<V extends Vec> boolean setUsingData(List<V> dataSet)

Sets the parameters of the distribution to attempt to fit the given list of vectors. All vectors are assumed to have the same weight.

Type Parameters:

V - the vector type

Parameters:

dataSet - the list of data points

Returns:

true if the distribution was fit to the data, or false if the distribution could not be fit to the data set.

setUsingData

<V extends Vec> boolean setUsingData(List<V> dataSet,
                                     ExecutorService threadpool)

Sets the parameters of the distribution to attempt to fit the given list of vectors. All vectors are assumed to have the same weight.

Type Parameters:

V - the vector type

Parameters:

dataSet - the list of data points

threadpool - the source of threads for computation

Returns:

true if the distribution was fit to the data, or false if the distribution could not be fit to the data set.

setUsingDataList

boolean setUsingDataList(List<DataPoint> dataPoints)

Sets the parameters of the distribution to attempt to fit the given list of data points. The weights of the data points will be used.

Parameters:

dataPoints - the list of data points to use

Returns:

true if the distribution was fit to the data, or false if the distribution could not be fit to the data set.

setUsingDataList

boolean setUsingDataList(List<DataPoint> dataPoints,
                         ExecutorService threadpool)

Sets the parameters of the distribution to attempt to fit the given list of data points. The weights of the data points will be used.

Parameters:

dataPoints - the list of data points to use

threadpool - the source of threads for computation

Returns:

true if the distribution was fit to the data, or false if the distribution could not be fit to the data set.

setUsingData

boolean setUsingData(DataSet dataSet)

Sets the parameters of the distribution to attempt to fit the given list of data points. The weights of the data points will be used.

Parameters:

dataSet - the data set to use

Returns:

true if the distribution was fit to the data, or false if the distribution could not be fit to the data set.

setUsingData

boolean setUsingData(DataSet dataSet,
                     ExecutorService threadpool)

Sets the parameters of the distribution to attempt to fit the given list of data points. The weights of the data points will be used.

Parameters:

dataSet - the data set to use

threadpool - the source of threads for computation

Returns:

true if the distribution was fit to the data, or false if the distribution could not be fit to the data set.

clone

MultivariateDistribution clone()

sample

List<Vec> sample(int count,
                 Random rand)

Performs sampling on the current distribution.

Parameters:

count - the number of iid samples to draw

rand - the source of randomness

Returns:

a list of sample vectors from this distribution