RNGTest control file keywords

This page documents the control file keywords of RNGTest.

List of all control file keywords

                bigcrush            Select RNG battery BigCrush
                     cja            Select the Cheng, Johnk, Atkinson algorithm for sampling a beta
            cja_accurate            Select the accurate Cheng, Johnk, Atkinson algorithm for sampling a beta
                   crush            Select RNG battery Crush
                     end            End of an input block
            gamma_method     string Select an Intel MKL gamma RNG method
                   gnorm            Select the GNORM (see MKL doc) algorithm for sampling a gamma
          gnorm_accurate            Select the accurate GNORM (see MKL doc) algorithm for sampling a gamma
             r123_philox            Select Random123 Philox RNG
           r123_threefry            Select Random123 ThreeFry RNG
             rngsse_gm19            Select RNGSSE GM19 RNG
             rngsse_gm29            Select RNGSSE GM29 RNG
             rngsse_gm31            Select RNGSSE GM31 RNG
             rngsse_gm55            Select RNGSSE GM55 RNG
             rngsse_gm61            Select RNGSSE GM61 RNG
           rngsse_gq58.1            Select RNGSSE GQ58.1 RNG
           rngsse_gq58.3            Select RNGSSE GQ58.3 RNG
           rngsse_gq58.4            Select RNGSSE GQ58.4 RNG
          rngsse_lfsr113            Select RNGSSE LFSR113 RNG
         rngsse_mrg32k3a            Select RNGSSE MRG32K3A RNG
          rngsse_mt19937            Select RNGSSE MT19937 RNG
                    seed       uint Set random number generator seed
                  seqlen     string Specify the RNGSSE RNG sequence length
              smallcrush            Select RNG battery SmallCrush
                   title     string Set analysis title

Detailed description of control file keywords

Keyword 'bigcrush'

Select RNG battery BigCrush

This keyword is used to introduce the description of the random number generator test suite, i.e., battery, 'BigCrush'. BigCrush is a suite of very stringent statistical tests, O(100), defined in TestU01, a library for the empirical testing of random number generators. For more info, see http://www.iro.umontreal.ca/~simardr/testu01/tu01.html.

Keyword 'cja'

Select the Cheng, Johnk, Atkinson algorithm for sampling a beta

This keyword is used to select the Cheng-Johnk-Atkinson method used to generate beta random numbers using the Intel Math Kernel Library (MKL) random number generators.

Keyword 'cja_accurate'

Select the accurate Cheng, Johnk, Atkinson algorithm for sampling a beta

This keyword is used to select the accurate version of the Cheng-Johnk-Atkinson method used to generate beta random numbers using the Intel Math Kernel Library (MKL) random number generators.

Keyword 'crush'

Select RNG battery Crush

This keyword is used to introduce the description of the random number generator test suite, i.e., battery, 'Crush'. Crush is a suite of stringent statistical tests, O(100), defined in TestU01, a library for the empirical testing of random number generators. For more info, see http://www.iro.umontreal.ca/~simardr/testu01/tu01.html.

Keyword 'end'

End of an input block

The end of a block is given by the 'end' keyword in the input file. Example: "rngs ... end".

Keyword 'gamma_method'

Select an Intel MKL gamma RNG method

This keyword is used to specify the method used to generate gamma random numbers using the Intel Math Kernel Library (MKL) random number generators. Valid options are 'gnorm' and 'gnorm_accurate'.

Expected type: string

Expected valid choices: 'gnorm' | 'gnorm_accurate'

Keyword 'gnorm'

Select the GNORM (see MKL doc) algorithm for sampling a gamma

This keyword is used to select the GNORM method used to generate gamma random numbers using the Intel Math Kernel Library (MKL) random number generators.

Keyword 'gnorm_accurate'

Select the accurate GNORM (see MKL doc) algorithm for sampling a gamma

This keyword is used to select the accurate version of the GNORM method used to generate gamma random numbers using the Intel Math Kernel Library (MKL) random number generator.

Keyword 'r123_philox'

Select Random123 Philox RNG

This keyword is used to select the Philox generator, based on Feistel network and integer multiplication, provided by the Random123 random number generator library. For more info on Random123 see http://dl.acm.org/citation.cfm?doid=2063405.

Keyword 'r123_threefry'

Select Random123 ThreeFry RNG

This keyword is used to select the ThreeFry generator, related to the Threefish block cipher from Skein Hash Function, provided by the Random123 random number generator library. For more info on Random123 see http://dl.acm.org/citation.cfm?doid=2063405.

Keyword 'rngsse_gm19'

Select RNGSSE GM19 RNG

This keyword is used to select the GM19 random number generator, using a method based on parallel evolution of an ensemble of transformations of a two-dimensional torus, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_gm29'

Select RNGSSE GM29 RNG

This keyword is used to select the GM29 generator, using a method based on parallel evolution of an ensemble of transformations of a two-dimensional torus, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_gm31'

Select RNGSSE GM31 RNG

This keyword is used to select the GM31 generator, using a method based on parallel evolution of an ensemble of transformations of a two-dimensional torus, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_gm55'

Select RNGSSE GM55 RNG

This keyword is used to select the GM55 generator, using a method based on parallel evolution of an ensemble of transformations of a two-dimensional torus, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_gm61'

Select RNGSSE GM61 RNG

This keyword is used to select the GM61 generator, using a method based on parallel evolution of an ensemble of transformations of a two-dimensional torus, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_gq58.1'

Select RNGSSE GQ58.1 RNG

This keyword is used to select the GQ58.1 generator, using a method based on parallel evolution of an ensemble of transformations of a two-dimensional torus, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_gq58.3'

Select RNGSSE GQ58.3 RNG

This keyword is used to select the GQ58.3 generator, using a method based on parallel evolution of an ensemble of transformations of a two-dimensional torus, provided by the RNGSS2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_gq58.4'

Select RNGSSE GQ58.4 RNG

This keyword is used to select the GQ58.4 generator, using a method based on parallel evolution of an ensemble of transformations of a two-dimensional torus, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_lfsr113'

Select RNGSSE LFSR113 RNG

This keyword is used to select the LFSR113 generator, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_mrg32k3a'

Select RNGSSE MRG32K3A RNG

This keyword is used to select the MRG32K3A generator, a combined multiple recursive random number generator with two components of order 3, provided by the RNGSS2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'rngsse_mt19937'

Select RNGSSE MT19937 RNG

This keyword is used to select the MT19937 generator, a Mersenne Twister generator, provided by the RNGSSE2 random number generator library. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Keyword 'seed'

Set random number generator seed

This keyword is used to specify a seed for a random number generator Example: rngmkl_mcg31 seed 1234 end

Expected type: uint

Keyword 'seqlen'

Specify the RNGSSE RNG sequence length

This keyword is used to select a random number generator sequence length, used by the RNGSSE2 random number generator library. Valid options are 'short', 'medium', and 'long'. For more info on RNGSSE see https://doi.org/10.1016/j.cpc.2011.03.022.

Expected type: string

Expected valid choices: 'short' | 'medium' | 'long'

Keyword 'smallcrush'

Select RNG battery SmallCrush

This keyword is used to introduce the description of the random number generator test suite, i.e., battery, 'SmallCrush'. SmallCrush is a battery of relatively small number, O(10), of tests, defined in TestU01, a library for the empirical testing of random number generators. For more " info, see http://www.iro.umontreal.ca/~simardr/testu01/tu01.html.

Keyword 'title'

Set analysis title

The analysis title may be specified in the input file using the 'title' keyword. The 'title' keyword must be followed by a double-quoted string specifying the analysis title. Example: title "Example problem". Specifying a title is optional.

Expected type: string