Class GaussianSampler
- java.lang.Object
-
- org.apache.commons.rng.sampling.distribution.GaussianSampler
-
- All Implemented Interfaces:
ContinuousSampler,SharedStateContinuousSampler,SharedStateSampler<SharedStateContinuousSampler>
public class GaussianSampler extends Object implements SharedStateContinuousSampler
Sampling from a Gaussian distribution with given mean and standard deviation.Note
The mean and standard deviation are validated to ensure they are finite. This prevents generation of NaN samples by avoiding invalid arithmetic (inf * 0 or inf - inf). However use of an extremely large standard deviation and/or mean may result in samples that are infinite; that is the parameters are not validated to prevent truncation of the output distribution.
- Since:
- 1.1
-
-
Constructor Summary
Constructors Constructor Description GaussianSampler(NormalizedGaussianSampler normalized, double mean, double standardDeviation)Create an instance.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static SharedStateContinuousSamplerof(NormalizedGaussianSampler normalized, double mean, double standardDeviation)Create a new normalised Gaussian sampler.doublesample()Creates adoublesample.StringtoString()SharedStateContinuousSamplerwithUniformRandomProvider(UniformRandomProvider rng)Create a new instance of the sampler with the same underlying state using the given uniform random provider as the source of randomness.-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.apache.commons.rng.sampling.distribution.ContinuousSampler
samples, samples
-
-
-
-
Constructor Detail
-
GaussianSampler
public GaussianSampler(NormalizedGaussianSampler normalized, double mean, double standardDeviation)
Create an instance.- Parameters:
normalized- Generator of N(0,1) Gaussian distributed random numbers.mean- Mean of the Gaussian distribution.standardDeviation- Standard deviation of the Gaussian distribution.- Throws:
IllegalArgumentException- ifstandardDeviation <= 0or is infinite; ormeanis infinite
-
-
Method Detail
-
sample
public double sample()
Creates adoublesample.- Specified by:
samplein interfaceContinuousSampler- Returns:
- a sample.
-
withUniformRandomProvider
public SharedStateContinuousSampler withUniformRandomProvider(UniformRandomProvider rng)
Create a new instance of the sampler with the same underlying state using the given uniform random provider as the source of randomness.Note: This function is available if the underlying
NormalizedGaussianSampleris aSharedStateSampler. Otherwise a run-time exception is thrown.- Specified by:
withUniformRandomProviderin interfaceSharedStateSampler<SharedStateContinuousSampler>- Parameters:
rng- Generator of uniformly distributed random numbers.- Returns:
- the sampler
- Throws:
UnsupportedOperationException- if the underlying sampler is not aSharedStateSampleror does not return aNormalizedGaussianSamplerwhen sharing state.- Since:
- 1.3
-
of
public static SharedStateContinuousSampler of(NormalizedGaussianSampler normalized, double mean, double standardDeviation)
Create a new normalised Gaussian sampler.Note: The shared-state functionality is available if the
NormalizedGaussianSampleris aSharedStateSampler. Otherwise a run-time exception will be thrown when the sampler is used to share state.- Parameters:
normalized- Generator of N(0,1) Gaussian distributed random numbers.mean- Mean of the Gaussian distribution.standardDeviation- Standard deviation of the Gaussian distribution.- Returns:
- the sampler
- Throws:
IllegalArgumentException- ifstandardDeviation <= 0or is infinite; ormeanis infinite- Since:
- 1.3
- See Also:
withUniformRandomProvider(UniformRandomProvider)
-
-