Class AbstractL64

java.lang.Object

org.apache.commons.rng.core.BaseProvider

org.apache.commons.rng.core.source64.LongProvider

org.apache.commons.rng.core.source64.AbstractL64

All Implemented Interfaces:

RandomLongSource, JumpableUniformRandomProvider, LongJumpableUniformRandomProvider, RestorableUniformRandomProvider, UniformRandomProvider

Direct Known Subclasses:

AbstractL64X128, L64X1024Mix, L64X256Mix

abstract class AbstractL64
extends LongProvider
implements LongJumpableUniformRandomProvider

This abstract class is a base for algorithms from the LXM family of generators with a 64-bit LCG sub-generator. The class implements the jump functions.

Since:

1.5

Field Summary

Fields

Modifier and Type	Field	Description
protected long	la	Per-instance LCG additive parameter (must be odd).
protected long	ls	State of the LCG generator.
private static final int	SEED_SIZE	Size of the seed vector.

Constructor Summary

Constructors

Constructor	Description
AbstractL64(long[] seed)	Creates a new instance.
AbstractL64(long seed0, long seed1)	Creates a new instance using a 2 element seed.
AbstractL64(AbstractL64 source)	Creates a copy instance.

Method Summary

Modifier and Type	Method	Description
(package private) abstract AbstractL64	copy()	Create a copy.
protected byte[]	getStateInternal()	Creates a snapshot of the RNG state.
UniformRandomProvider	jump()	Creates a copy of the UniformRandomProvider and then retreats the state of the current instance.
JumpableUniformRandomProvider	longJump()	Creates a copy of the UniformRandomProvider and then retreats the state of the current instance.
private void	setState(long[] state)	Copies the state into the generator state.
protected void	setStateInternal(byte[] s)	Resets the RNG to the given state.

Methods inherited from class LongProvider

nextBoolean, nextInt, nextLong, resetCachedState

Methods inherited from class BaseProvider

checkIndex, checkStateSize, composeStateInternal, extendSeed, extendSeed, fillState, fillState, restoreState, saveState, splitStateInternal, toString

Methods inherited from class Object

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

Methods inherited from interface JumpableUniformRandomProvider

jumps, jumps

Methods inherited from interface LongJumpableUniformRandomProvider

longJumps, longJumps

Methods inherited from interface RandomLongSource

next

Methods inherited from interface UniformRandomProvider

doubles, doubles, doubles, doubles, ints, ints, ints, ints, longs, longs, longs, longs, nextBoolean, nextBytes, nextBytes, nextDouble, nextDouble, nextDouble, nextFloat, nextFloat, nextFloat, nextInt, nextInt, nextInt, nextLong, nextLong, nextLong

Field Details

SEED_SIZE

private static final int SEED_SIZE

Size of the seed vector.

See Also:

• Constant Field Values

la

protected long la

Per-instance LCG additive parameter (must be odd). Cannot be final to support RestorableUniformRandomProvider.

ls

protected long ls

State of the LCG generator.

Constructor Details

AbstractL64

AbstractL64(long[] seed)

Creates a new instance.

Parameters:

seed - Initial seed. If the length is larger than 2, only the first 2 elements will be used; if smaller, the remaining elements will be automatically set.

The 1st element is used to set the LCG increment; the least significant bit is set to odd to ensure a full period LCG. The 2nd element is used to set the LCG state.

AbstractL64

AbstractL64(long seed0,
 long seed1)

Creates a new instance using a 2 element seed.

The 1st element is used to set the LCG increment; the least significant bit is set to odd to ensure a full period LCG. The 2nd element is used to set the LCG state.

Parameters:

seed0 - Initial seed element 0.

seed1 - Initial seed element 1.

AbstractL64

AbstractL64(AbstractL64 source)

Creates a copy instance.

Parameters:

source - Source to copy.

Method Details

setState

private void setState(long[] state)

Copies the state into the generator state.

Parameters:

state - the new state

getStateInternal

protected byte[] getStateInternal()

Creates a snapshot of the RNG state.

Overrides:

getStateInternal in class LongProvider

Returns:

the internal state.

setStateInternal

protected void setStateInternal(byte[] s)

Resets the RNG to the given state.

Overrides:

setStateInternal in class LongProvider

Parameters:

s - State (previously obtained by a call to BaseProvider.getStateInternal()).

See Also:

• BaseProvider.checkStateSize(byte[],int)

jump

public UniformRandomProvider jump()

Creates a copy of the UniformRandomProvider and then retreats the state of the current instance. The copy is returned.

The jump is performed by advancing the state of the LCG sub-generator by 1 cycle. The XBG state is unchanged.

Specified by:

jump in interface JumpableUniformRandomProvider

Returns:

A copy of the current state.

longJump

public JumpableUniformRandomProvider longJump()

Creates a copy of the UniformRandomProvider and then retreats the state of the current instance. The copy is returned.

The jump is performed by advancing the state of the LCG sub-generator by 2³² cycles. The XBG state is unchanged.

Specified by:

longJump in interface LongJumpableUniformRandomProvider

Returns:

A copy of the current state.

copy

abstract AbstractL64 copy()

Create a copy.

Returns:

the copy