SOBOL_OLD
The Sobol Quasirandom Sequence

SOBOL_OLD is a C++ library which computes elements of the Sobol quasirandom sequence.

SOBOL_OLD is the "old" version of the Sobol package. It is restricted to dimensions of no more than 40. A newer version is available, as SOBOL, which can go to spatial dimension 1111.

A quasirandom or low discrepancy sequence, such as the Faure, Halton, Hammersley, Niederreiter or Sobol sequences, is "less random" than a pseudorandom number sequence, but more useful for such tasks as approximation of integrals in higher dimensions, and in global optimization. This is because low discrepancy sequences tend to sample space "more uniformly" than random numbers. Algorithms that use such sequences may have superior convergence.

SOBOL_OLD is an adapation of the INSOBL and GOSOBL routines in ACM TOMS Algorithm 647 and ACM TOMS Algorithm 659. The original code can only compute the "next" element of the sequence. The revised code allows the user to specify the index of any desired element.

The routines with a prefix of I8_ use 64 bit integers, and use the long int to get this. On some systems, a long int is simply 32 bits. In that case, try using the long long int datatype instead.

The original, true, correct versions of ACM TOMS Algorithm 647 and ACM TOMS Algorithm 659 are available in the TOMS subdirectory of the NETLIB web site. The version displayed here has been converted to FORTRAN90, and other internal changes have been made to suit me.

Licensing:

The computer code and data files described and made available on this web page are distributed under the GNU LGPL license.

Related Data and Programs:

CVT is a C++ library of routines for computing points in a Centroidal Voronoi Tessellation.

FAURE is a C++ library of routines for computing Faure sequences.

GRID is a C++ library of routines for computing points on a grid.

GSL is the Gnu Scientific Library which includes routines to compute elements of the Sobol sequence.

HALTON is a C++ library of routines for computing Halton sequences.

HAMMERSLEY is a C++ library of routines for computing Hammersley sequences.

HEX_GRID is a C++ library of routines for computing sets of points in a 2D hexagonal grid.

IHS is a C++ library of routines for computing improved Latin Hypercube datasets.

LATIN_CENTER is a C++ library of routines for computing Latin square data choosing the center value.

LATIN_EDGE is a C++ library of routines for computing Latin square data choosing the edge value.

LATIN_RANDOM is a C++ library of routines for computing Latin square data choosing a random value in the square.

NIEDERREITER2 is a C++ library of routines for computing Niederreiter sequences with base 2.

NORMAL is a C++ library which computes elements of a sequence of pseudorandom normally distributed values.

SOBOL is a C++ library which implements the Sobol quasirandom sequence, for spatial dimensions up to 1111.

TOMS647 is a FORTRAN90 version of ACM TOMS algorithm 647, for evaluating Faure, Halton and Sobol sequences.

TOMS659 is the FORTRAN77 source of ACM TOMS algorithm 659 for evaluating Sobol sequences.

UNIFORM is a C++ library of routines for computing uniform random values.

VAN_DER_CORPUT is a C++ library of routines for computing van der Corput sequences.

Reference:

1. IA Antonov, VM Saleev,
   An Economic Method of Computing LP Tau-Sequences,
   USSR Computational Mathematics and Mathematical Physics,
   Volume 19, pages 252-256, 1980.
2. Paul Bratley, Bennett Fox,
   Algorithm 659: Implementing Sobol's Quasirandom Sequence Generator,
   ACM Transactions on Mathematical Software,
   Volume 14, Number 1, pages 88-100, 1988.
3. Paul Bratley, Bennett Fox, Linus Schrage,
   A Guide to Simulation,
   Springer, pages 201-202, 1983.
4. Paul Bratley, Bennett Fox, Harald Niederreiter,
   Implementation and Tests of Low Discrepancy Sequences,
   ACM Transactions on Modeling and Computer Simulation,
   Volume 2, Number 3, pages 195-213, 1992.
5. Bennett Fox,
   Algorithm 647: Implementation and Relative Efficiency of Quasirandom Sequence Generators,
   ACM Transactions on Mathematical Software,
   Volume 12, Number 4, pages 362-376, 1986.
6. Stephen Joe, Frances Kuo
   Remark on Algorithm 659: Implementing Sobol's Quasirandom Sequence Generator,
   ACM Transactions on Mathematical Software,
   Volume 29, Number 1, pages 49-57, March 2003.
7. Harald Niederreiter,
   Random Number Generation and quasi-Monte Carlo Methods,
   SIAM, 1992,
   ISBN13: 978-0-898712-95-7.
8. William Press, Brian Flannery, Saul Teukolsky, William Vetterling,
   Numerical Recipes in FORTRAN: The Art of Scientific Computing,
   Second Edition,
   Cambridge University Press, 1992,
   LC: QA297.N866,
   ISBN: 0-521-43064-X.
9. Ilya Sobol,
   USSR Computational Mathematics and Mathematical Physics,
   Volume 16, pages 236-242, 1977.
10. Ilya Sobol, YL Levitan,
    The Production of Points Uniformly Distributed in a Multidimensional Cube (in Russian),
    Preprint IPM Akad. Nauk SSSR,
    Number 40, Moscow 1976.

Source Code:

• sobol_old.C, the source code;
• sobol_old.H, the include file;
• sobol_old.csh, commands to compile the source code;

Examples and Tests:

• sobol_old_prb.C, the sample test code;
• sobol_old_prb.csh, commands to compile the test code;
• sobol_old_prb_output.txt, the output file.

List of Routines:

• I4_BIT_HI1 returns the position of the high 1 bit base 2 in an integer.
• I4_BIT_LO0 returns the position of the low 0 bit base 2 in an integer.
• I4_MAX returns the maximum of two integers.
• I4_MIN returns the smaller of two integers.
• I4_SOBOL generates a new quasirandom Sobol vector with each call.
• I4_UNIFORM returns a scaled pseudorandom I4.
• I4_XOR calculates the exclusive OR of two integers.
• I8_BIT_HI1 returns the position of the high 1 bit base 2 in an integer.
• I8_BIT_LO0 returns the position of the low 0 bit base 2 in an integer.
• I8_SOBOL generates a new quasirandom Sobol vector with each call.
• I8_MAX returns the maximum of two I8's.
• I8_MIN returns the smaller of two I8's.
• I8_UNIFORM returns a scaled pseudorandom I8.
• I8_XOR calculates the exclusive OR of two integers.
• R4_ABS returns the absolute value of an R4.
• R4_NINT returns the nearest integer to an R4.
• R4_UNIFORM_01 returns a unit pseudorandom R4.
• R8_ABS returns the absolute value of an R8.
• R8_NINT returns the nearest integer to an R4.
• R8_UNIFORM_01 returns a unit pseudorandom R8.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

You can go up one level to the C++ source codes.