Class L32X64Mix

    • Field Detail

      • SEED_SIZE

        private static final int SEED_SIZE
        Size of the state vector.
        See Also:
        Constant Field Values
      • la

        private int la
        Per-instance LCG additive parameter (must be odd). Cannot be final to support RestorableUniformRandomProvider.
      • ls

        private int ls
        State of the LCG generator.
      • x0

        private int x0
        State 0 of the XBG generator.
      • x1

        private int x1
        State 1 of the XBG generator.
    • Constructor Detail

      • L32X64Mix

        public L32X64Mix​(int[] seed)
        Creates a new instance.
        Parameters:
        seed - Initial seed. If the length is larger than 4, only the first 4 elements will be used; if smaller, the remaining elements will be automatically set. A seed containing all zeros in the last two elements will create a non-functional XBG sub-generator and a low quality output with a period of 232.

        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.

      • L32X64Mix

        public L32X64Mix​(int seed0,
                         int seed1,
                         int seed2,
                         int seed3)
        Creates a new instance using a 4 element seed. A seed containing all zeros in the last two elements will create a non-functional XBG sub-generator and a low quality output with a period of 232.

        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.
        seed2 - Initial seed element 2.
        seed3 - Initial seed element 3.
      • L32X64Mix

        private L32X64Mix​(L32X64Mix source)
        Creates a copy instance.
        Parameters:
        source - Source to copy.
    • Method Detail

      • setState

        private void setState​(int[] 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 IntProvider
        Returns:
        the internal state.
      • next

        public int next()
        Specified by:
        next in interface RandomIntSource
        Returns:
        the next random value.
      • 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. The jump size is the equivalent of moving the state backwards by (264 - 1) positions. It can provide up to 232 non-overlapping subsequences.

        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 216 cycles. The XBG state is unchanged. The jump size is the equivalent of moving the state backwards by 216 (264 - 1) positions. It can provide up to 216 non-overlapping subsequences of length 216 (264 - 1); each subsequence can provide up to 216 non-overlapping subsequences of length (264 - 1) using the jump() method.

        Specified by:
        longJump in interface LongJumpableUniformRandomProvider
        Returns:
        A copy of the current state.
      • splits

        public java.util.stream.Stream<SplittableUniformRandomProvider> splits​(long streamSize,
                                                                               SplittableUniformRandomProvider source)
        Returns a stream producing the given streamSize number of new random generators, each of which implements the SplittableUniformRandomProvider interface.
        Specified by:
        splits in interface SplittableUniformRandomProvider
        Parameters:
        streamSize - Number of objects to generate.
        source - A source of randomness used to initialise the new instances; this may be split to provide a source of randomness across a parallel stream.
        Returns:
        a stream of random generators; the stream is limited to the given streamSize.
      • create

        private static SplittableUniformRandomProvider create​(long seed,
                                                              UniformRandomProvider source)
        Create a new instance using the given seed and source of randomness to initialise the instance.
        Parameters:
        seed - Seed used to initialise the instance.
        source - Source of randomness used to initialise the instance.
        Returns:
        A new instance.