fr.cnes.sirius.patrius.math.distribution

Class MixtureMultivariateNormalDistribution

java.lang.Object

fr.cnes.sirius.patrius.math.distribution.AbstractMultivariateRealDistribution

fr.cnes.sirius.patrius.math.distribution.MixtureMultivariateRealDistribution<MultivariateNormalDistribution>

fr.cnes.sirius.patrius.math.distribution.MixtureMultivariateNormalDistribution

All Implemented Interfaces:

MultivariateRealDistribution

public class MixtureMultivariateNormalDistribution
extends MixtureMultivariateRealDistribution<MultivariateNormalDistribution>

Class that implements a mixture of Gaussian ditributions.

Field Summary

Fields inherited from class fr.cnes.sirius.patrius.math.distribution.AbstractMultivariateRealDistribution

random

Constructor Summary

Constructors

Constructor and Description
MixtureMultivariateNormalDistribution(double[] weights, double[][] means, double[][][] covariances) Creates a multivariate normal mixture distribution.
MixtureMultivariateNormalDistribution(List<Pair<Double,MultivariateNormalDistribution>> components) Creates a mixture model from a list of distributions and their associated weights.
MixtureMultivariateNormalDistribution(RandomGenerator rng, List<Pair<Double,MultivariateNormalDistribution>> components) Creates a mixture model from a list of distributions and their associated weights.

Method Summary

Modifier and Type	Method and Description
static List<Pair<Double,MultivariateNormalDistribution>>	createComponents(double[] weights, double[][] means, double[][][] covariances) Creates a mixture of Gaussian distributions.

Methods inherited from class fr.cnes.sirius.patrius.math.distribution.MixtureMultivariateRealDistribution

density, getComponents, reseedRandomGenerator, sample

Methods inherited from class fr.cnes.sirius.patrius.math.distribution.AbstractMultivariateRealDistribution

getDimension, sample

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MixtureMultivariateNormalDistribution

public MixtureMultivariateNormalDistribution(double[] weights,
                                             double[][] means,
                                             double[][][] covariances)

Creates a multivariate normal mixture distribution.

Note: this constructor will implicitly create an instance of Well19937c as random generator to be used for sampling only (see MixtureMultivariateRealDistribution.sample() and AbstractMultivariateRealDistribution.sample(int)). In case no sampling is needed for the created distribution, it is advised to pass null as random generator via the appropriate constructors to avoid the additional initialisation overhead.

Parameters:

weights - Weights of each component.

means - Mean vector for each component.

covariances - Covariance matrix for each component.

MixtureMultivariateNormalDistribution

public MixtureMultivariateNormalDistribution(List<Pair<Double,MultivariateNormalDistribution>> components)

Creates a mixture model from a list of distributions and their associated weights.

Note: this constructor will implicitly create an instance of Well19937c as random generator to be used for sampling only (see MixtureMultivariateRealDistribution.sample() and AbstractMultivariateRealDistribution.sample(int)). In case no sampling is needed for the created distribution, it is advised to pass null as random generator via the appropriate constructors to avoid the additional initialisation overhead.

Parameters:

components - List of (weight, distribution) pairs from which to sample.

MixtureMultivariateNormalDistribution

public MixtureMultivariateNormalDistribution(RandomGenerator rng,
                                             List<Pair<Double,MultivariateNormalDistribution>> components)
                                      throws NotPositiveException,
                                             DimensionMismatchException

Creates a mixture model from a list of distributions and their associated weights.

Parameters:

rng - Random number generator.

components - Distributions from which to sample.

Throws:

NotPositiveException - if any of the weights is negative.

DimensionMismatchException - if not all components have the same number of variables.

Method Detail

createComponents

public static List<Pair<Double,MultivariateNormalDistribution>> createComponents(double[] weights,
                                                                                 double[][] means,
                                                                                 double[][][] covariances)

Creates a mixture of Gaussian distributions.

Parameters:

weights - Weights of each component.

means - Mean vector for each component.

covariances - Covariance matrix for each component.

Returns:

the mixture distribution.