LFSR113
umontreal.iro.lecuyer.rng

Class LFSR113

  • All Implemented Interfaces:
    Serializable, Cloneable, CloneableRandomStream, RandomStream


    public class LFSR113extends RandomStreamBase
    Extends RandomStreamBase using a composite linear feedback shift register (LFSR) (or Tausworthe) RNG as defined in. This generator is the LFSR113 proposed by. It has four 32-bit components combined by a bitwise xor. Its period length is approximatively 2^113 . The values of V, W and Z are 235, 255 and 290 respectively (see RandomStream for their definition). The seed of the RNG, and the state of a stream at any given step, are four-dimensional vectors of 32-bit integers. The default initial seed of the RNG is (12345, 12345, 12345, 12345). The nextValue method returns numbers with 32 bits of precision.
    See Also:
    Serialized Form
    • Constructor Detail

      • LFSR113

        public LFSR113()
        Constructs a new stream.
      • LFSR113

        public LFSR113(String name)
        Constructs a new stream with the identifier name.
        Parameters:
        name - name of the stream
    • Method Detail

      • setPackageSeed

        public static void setPackageSeed(int[] seed)
        Sets the initial seed for the class LFSR113 to the four integers of the vector seed[0..3]. This will be the initial state (or seed) of the next created stream. The default seed for the first stream is (12345, 12345, 12345, 12345). The first, second, third and fourth integers of seed must be either negative, or greater than or equal to 2, 8, 16 and 128 respectively.
        Parameters:
        seed - array of 4 elements representing the seed
      • setSeed

        public void setSeed(int[] seed)
        This method is discouraged for normal use. Initializes the stream at the beginning of a stream with the initial seed seed[0..3]. The seed must satisfy the same conditions as in setPackageSeed. This method only affects the specified stream; the others are not modified, so the beginning of the streams will not be spaced Z values apart. For this reason, this method should only be used in very exceptional cases; proper use of the reset... methods and of the stream constructor is preferable.
        Parameters:
        seed - array of 4 elements representing the seed
      • getState

        public int[] getState()
        Returns the current state of the stream, represented as an array of four integers.
        Returns:
        the current state of the stream
      • nextInt

        public int nextInt(int i,          int j)
        Description copied from class: RandomStreamBase
        Calls nextDouble once to create one integer between i and j. This method always uses the highest order bits of the random number. It should be overridden if a faster implementation exists for the specific generator.
        Specified by:
        nextInt in interface RandomStream
        Overrides:
        nextInt in class RandomStreamBase
        Parameters:
        i - the smallest possible returned integer
        j - the largest possible returned integer
        Returns:
        a random integer between i and j

SCaVis 2.2 © jWork.ORG