Class AhrensDieterExponentialSampler

java.lang.Object

org.apache.commons.rng.sampling.distribution.SamplerBase

org.apache.commons.rng.sampling.distribution.AhrensDieterExponentialSampler

All Implemented Interfaces:

ContinuousSampler, SharedStateContinuousSampler, SharedStateSampler<SharedStateContinuousSampler>

public class AhrensDieterExponentialSampler
extends SamplerBase
implements SharedStateContinuousSampler

Sampling from an exponential distribution.

Sampling uses:

• UniformRandomProvider.nextLong()
• UniformRandomProvider.nextDouble()

Since:

1.0

Constructor Summary

Constructors

Constructor	Description
AhrensDieterExponentialSampler(UniformRandomProvider rng, double mean)	Create an instance.

Method Summary

Modifier and Type	Method	Description
static SharedStateContinuousSampler	of(UniformRandomProvider rng, double mean)	Create a new exponential distribution sampler.
double	sample()	Creates a double sample.
String	toString()
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.

Methods inherited from class SamplerBase

nextDouble, nextInt, nextInt, nextLong

Methods inherited from class Object

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

Methods inherited from interface ContinuousSampler

samples, samples

Constructor Details

AhrensDieterExponentialSampler

public AhrensDieterExponentialSampler(UniformRandomProvider rng,
 double mean)

Create an instance.

Parameters:

rng - Generator of uniformly distributed random numbers.

mean - Mean of this distribution.

Throws:

IllegalArgumentException - if mean <= 0

Method Details

sample

public double sample()

Creates a double sample.

Specified by:

sample in interface ContinuousSampler

Returns:

a sample.

toString

public String toString()

Overrides:

toString in class SamplerBase

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.

Specified by:

withUniformRandomProvider in interface SharedStateSampler<SharedStateContinuousSampler>

Parameters:

rng - Generator of uniformly distributed random numbers.

Returns:

the sampler

Since:

1.3

of

public static SharedStateContinuousSampler of(UniformRandomProvider rng,
 double mean)

Create a new exponential distribution sampler.

Parameters:

rng - Generator of uniformly distributed random numbers.

mean - Mean of the distribution.

Returns:

the sampler

Throws:

IllegalArgumentException - if mean <= 0

Since:

1.3