5.2. Device API
Functions
 QUALIFIERS_MTGP32 unsigned int curand ( curandStateMtgp32_t* state )
 Return 32bits of pseudorandomness from a mtgp32 generator.
 __device__ unsigned long long curand ( curandStateScrambledSobol64_t* state )
 Return 64bits of quasirandomness from a scrambled Sobol64 generator.
 __device__ unsigned long long curand ( curandStateSobol64_t* state )
 Return 64bits of quasirandomness from a Sobol64 generator.
 __device__ unsigned int curand ( curandStateScrambledSobol32_t* state )
 Return 32bits of quasirandomness from a scrambled Sobol32 generator.
 __device__ unsigned int curand ( curandStateSobol32_t* state )
 Return 32bits of quasirandomness from a Sobol32 generator.
 __device__ unsigned int curand ( curandStateMRG32k3a_t* state )
 Return 32bits of pseudorandomness from an MRG32k3a generator.
 __device__ unsigned int curand ( curandStatePhilox4_32_10_t* state )
 Return 32bits of pseudorandomness from an Philox4_32_10 generator.
 __device__ unsigned int curand ( curandStateXORWOW_t* state )
 Return 32bits of pseudorandomness from an XORWOW generator.
 __device__ uint4 curand4 ( curandStatePhilox4_32_10_t* state )
 Return tuple of 4 32bit pseudorandoms from a Philox4_32_10 generator.
 __host__ curandStatus_t curandMakeMTGP32Constants ( const mtgp32_params_fast_t params[], mtgp32_kernel_params_t* p )
 Set up constant parameters for the mtgp32 generator.
 __host__ curandStatus_t CURANDAPI curandMakeMTGP32KernelState ( curandStateMtgp32_t* s, mtgp32_params_fast_t params[], mtgp32_kernel_params_t* k, int n, unsigned long long seed )
 Set up initial states for the mtgp32 generator.
 __device__ void curand_init ( curandDirectionVectors64_t direction_vectors, unsigned long long scramble_c, unsigned long long offset, curandStateScrambledSobol64_t* state )
 Initialize Scrambled Sobol64 state.
 __device__ void curand_init ( curandDirectionVectors64_t direction_vectors, unsigned long long offset, curandStateSobol64_t* state )
 Initialize Sobol64 state.
 __device__ void curand_init ( curandDirectionVectors32_t direction_vectors, unsigned int scramble_c, unsigned int offset, curandStateScrambledSobol32_t* state )
 Initialize Scrambled Sobol32 state.
 __device__ void curand_init ( curandDirectionVectors32_t direction_vectors, unsigned int offset, curandStateSobol32_t* state )
 Initialize Sobol32 state.
 __device__ void curand_init ( unsigned long long seed, unsigned long long subsequence, unsigned long long offset, curandStateMRG32k3a_t* state )
 Initialize MRG32k3a state.
 __device__ void curand_init ( unsigned long long seed, unsigned long long subsequence, unsigned long long offset, curandStatePhilox4_32_10_t* state )
 Initialize Philox4_32_10 state.
 __device__ void curand_init ( unsigned long long seed, unsigned long long subsequence, unsigned long long offset, curandStateXORWOW_t* state )
 Initialize XORWOW state.
 __device__ float curand_log_normal ( curandStateScrambledSobol64_t* state, float mean, float stddev )
 Return a lognormally distributed float from a scrambled Sobol64 generator.
 __device__ float curand_log_normal ( curandStateSobol64_t* state, float mean, float stddev )
 Return a lognormally distributed float from a Sobol64 generator.
 __device__ float curand_log_normal ( curandStateScrambledSobol32_t* state, float mean, float stddev )
 Return a lognormally distributed float from a scrambled Sobol32 generator.
 __device__ float curand_log_normal ( curandStateSobol32_t* state, float mean, float stddev )
 Return a lognormally distributed float from a Sobol32 generator.
 __device__ float curand_log_normal ( curandStateMtgp32_t* state, float mean, float stddev )
 Return a lognormally distributed float from an MTGP32 generator.
 __device__ float curand_log_normal ( curandStateMRG32k3a_t* state, float mean, float stddev )
 Return a lognormally distributed float from an MRG32k3a generator.
 __device__ float curand_log_normal ( curandStatePhilox4_32_10_t* state, float mean, float stddev )
 Return a lognormally distributed float from an Philox4_32_10 generator.
 __device__ float curand_log_normal ( curandStateXORWOW_t* state, float mean, float stddev )
 Return a lognormally distributed float from an XORWOW generator.
 __device__ float2 curand_log_normal2 ( curandStateMRG32k3a_t* state, float mean, float stddev )
 Return two normally distributed floats from an MRG32k3a generator.
 __device__ float2 curand_log_normal2 ( curandStatePhilox4_32_10_t* state, float mean, float stddev )
 Return two normally distributed floats from an Philox4_32_10 generator.
 __device__ float2 curand_log_normal2 ( curandStateXORWOW_t* state, float mean, float stddev )
 Return two normally distributed floats from an XORWOW generator.
 __device__ double2 curand_log_normal2_double ( curandStateMRG32k3a_t* state, double mean, double stddev )
 Return two lognormally distributed doubles from an MRG32k3a generator.
 __device__ double2 curand_log_normal2_double ( curandStatePhilox4_32_10_t* state, double mean, double stddev )
 Return two lognormally distributed doubles from an Philox4_32_10 generator.
 __device__ double2 curand_log_normal2_double ( curandStateXORWOW_t* state, double mean, double stddev )
 Return two lognormally distributed doubles from an XORWOW generator.
 __device__ float4 curand_log_normal4 ( curandStatePhilox4_32_10_t* state, float mean, float stddev )
 Return four normally distributed floats from an Philox4_32_10 generator.
 __device__ double curand_log_normal_double ( curandStateScrambledSobol64_t* state, double mean, double stddev )
 Return a lognormally distributed double from a scrambled Sobol64 generator.
 __device__ double curand_log_normal_double ( curandStateSobol64_t* state, double mean, double stddev )
 Return a lognormally distributed double from a Sobol64 generator.
 __device__ double curand_log_normal_double ( curandStateScrambledSobol32_t* state, double mean, double stddev )
 Return a lognormally distributed double from a scrambled Sobol32 generator.
 __device__ double curand_log_normal_double ( curandStateSobol32_t* state, double mean, double stddev )
 Return a lognormally distributed double from a Sobol32 generator.
 __device__ double curand_log_normal_double ( curandStateMtgp32_t* state, double mean, double stddev )
 Return a lognormally distributed double from an MTGP32 generator.
 __device__ double curand_log_normal_double ( curandStateMRG32k3a_t* state, double mean, double stddev )
 Return a lognormally distributed double from an MRG32k3a generator.
 __device__ double curand_log_normal_double ( curandStatePhilox4_32_10_t* state, double mean, double stddev )
 Return a lognormally distributed double from an Philox4_32_10 generator.
 __device__ double curand_log_normal_double ( curandStateXORWOW_t* state, double mean, double stddev )
 Return a lognormally distributed double from an XORWOW generator.
 QUALIFIERS_MTGP32 float curand_mtgp32_single ( curandStateMtgp32_t* state )
 Return a uniformly distributed float from a mtgp32 generator.
 QUALIFIERS_MTGP32 float curand_mtgp32_single_specific ( curandStateMtgp32_t* state, unsigned char index, unsigned char n )
 Return a uniformly distributed float from a specific position in a mtgp32 generator.
 QUALIFIERS_MTGP32 unsigned int curand_mtgp32_specific ( curandStateMtgp32_t* state, unsigned char index, unsigned char n )
 Return 32bits of pseudorandomness from a specific position in a mtgp32 generator.
 __device__ float curand_normal ( curandStateScrambledSobol64_t* state )
 Return a normally distributed float from a scrambled Sobol64 generator.
 __device__ float curand_normal ( curandStateSobol64_t* state )
 Return a normally distributed float from a Sobol64 generator.
 __device__ float curand_normal ( curandStateScrambledSobol32_t* state )
 Return a normally distributed float from a scrambled Sobol32 generator.
 __device__ float curand_normal ( curandStateSobol32_t* state )
 Return a normally distributed float from a Sobol32 generator.
 __device__ float curand_normal ( curandStateMtgp32_t* state )
 Return a normally distributed float from a MTGP32 generator.
 __device__ float curand_normal ( curandStateMRG32k3a_t* state )
 Return a normally distributed float from an MRG32k3a generator.
 __device__ float curand_normal ( curandStatePhilox4_32_10_t* state )
 Return a normally distributed float from an Philox4_32_10 generator.
 __device__ float curand_normal ( curandStateXORWOW_t* state )
 Return a normally distributed float from an XORWOW generator.
 __device__ float2 curand_normal2 ( curandStateMRG32k3a_t* state )
 Return two normally distributed floats from an MRG32k3a generator.
 __device__ float2 curand_normal2 ( curandStatePhilox4_32_10_t* state )
 Return two normally distributed floats from an Philox4_32_10 generator.
 __device__ float2 curand_normal2 ( curandStateXORWOW_t* state )
 Return two normally distributed floats from an XORWOW generator.
 __device__ double2 curand_normal2_double ( curandStateMRG32k3a_t* state )
 Return two normally distributed doubles from an MRG32k3a generator.
 __device__ double2 curand_normal2_double ( curandStatePhilox4_32_10_t* state )
 Return two normally distributed doubles from an Philox4_32_10 generator.
 __device__ double2 curand_normal2_double ( curandStateXORWOW_t* state )
 Return two normally distributed doubles from an XORWOW generator.
 __device__ float4 curand_normal4 ( curandStatePhilox4_32_10_t* state )
 Return four normally distributed floats from an Philox4_32_10 generator.
 __device__ double curand_normal_double ( curandStateScrambledSobol64_t* state )
 Return a normally distributed double from a scrambled Sobol64 generator.
 __device__ double curand_normal_double ( curandStateSobol64_t* state )
 Return a normally distributed double from a Sobol64 generator.
 __device__ double curand_normal_double ( curandStateScrambledSobol32_t* state )
 Return a normally distributed double from a scrambled Sobol32 generator.
 __device__ double curand_normal_double ( curandStateSobol32_t* state )
 Return a normally distributed double from an Sobol32 generator.
 __device__ double curand_normal_double ( curandStateMtgp32_t* state )
 Return a normally distributed double from an MTGP32 generator.
 __device__ double curand_normal_double ( curandStateMRG32k3a_t* state )
 Return a normally distributed double from an MRG32k3a generator.
 __device__ double curand_normal_double ( curandStatePhilox4_32_10_t* state )
 Return a normally distributed double from an Philox4_32_10 generator.
 __device__ double curand_normal_double ( curandStateXORWOW_t* state )
 Return a normally distributed double from an XORWOW generator.
 __device__ unsigned int curand_poisson ( curandStateScrambledSobol64_t* state, double lambda )
 Return a Poissondistributed unsigned int from a scrambled Sobol64 generator.
 __device__ unsigned int curand_poisson ( curandStateSobol64_t* state, double lambda )
 Return a Poissondistributed unsigned int from a Sobol64 generator.
 __device__ unsigned int curand_poisson ( curandStateScrambledSobol32_t* state, double lambda )
 Return a Poissondistributed unsigned int from a scrambled Sobol32 generator.
 __device__ unsigned int curand_poisson ( curandStateSobol32_t* state, double lambda )
 Return a Poissondistributed unsigned int from a Sobol32 generator.
 __device__ unsigned int curand_poisson ( curandStateMtgp32_t* state, double lambda )
 Return a Poissondistributed unsigned int from a MTGP32 generator.
 __device__ unsigned int curand_poisson ( curandStateMRG32k3a_t* state, double lambda )
 Return a Poissondistributed unsigned int from a MRG32k3A generator.
 __device__ unsigned int curand_poisson ( curandStatePhilox4_32_10_t* state, double lambda )
 Return a Poissondistributed unsigned int from a Philox4_32_10 generator.
 __device__ unsigned int curand_poisson ( curandStateXORWOW_t* state, double lambda )
 Return a Poissondistributed unsigned int from a XORWOW generator.
 __device__ uint4 curand_poisson4 ( curandStatePhilox4_32_10_t* state, double lambda )
 Return four Poissondistributed unsigned ints from a Philox4_32_10 generator.
 __device__ float curand_uniform ( curandStateScrambledSobol64_t* state )
 Return a uniformly distributed float from a scrambled Sobol64 generator.
 __device__ float curand_uniform ( curandStateSobol64_t* state )
 Return a uniformly distributed float from a Sobol64 generator.
 __device__ float curand_uniform ( curandStateScrambledSobol32_t* state )
 Return a uniformly distributed float from a scrambled Sobol32 generator.
 __device__ float curand_uniform ( curandStateSobol32_t* state )
 Return a uniformly distributed float from a Sobol32 generator.
 __device__ float curand_uniform ( curandStateMtgp32_t* state )
 Return a uniformly distributed float from a MTGP32 generator.
 __device__ float curand_uniform ( curandStatePhilox4_32_10_t* state )
 Return a uniformly distributed float from a Philox4_32_10 generator.
 __device__ float curand_uniform ( curandStateMRG32k3a_t* state )
 Return a uniformly distributed float from an MRG32k3a generator.
 __device__ float curand_uniform ( curandStateXORWOW_t* state )
 Return a uniformly distributed float from an XORWOW generator.
 __device__ double2 curand_uniform2_double ( curandStatePhilox4_32_10_t* state )
 Return a uniformly distributed tuple of 2 doubles from an Philox4_32_10 generator.
 __device__ float4 curand_uniform4 ( curandStatePhilox4_32_10_t* state )
 Return a uniformly distributed tuple of 4 floats from a Philox4_32_10 generator.
 __device__ double curand_uniform_double ( curandStateScrambledSobol64_t* state )
 Return a uniformly distributed double from a scrambled Sobol64 generator.
 __device__ double curand_uniform_double ( curandStateSobol64_t* state )
 Return a uniformly distributed double from a Sobol64 generator.
 __device__ double curand_uniform_double ( curandStateScrambledSobol32_t* state )
 Return a uniformly distributed double from a scrambled Sobol32 generator.
 __device__ double curand_uniform_double ( curandStateSobol32_t* state )
 Return a uniformly distributed double from a Sobol32 generator.
 __device__ double curand_uniform_double ( curandStatePhilox4_32_10_t* state )
 Return a uniformly distributed double from a Philox4_32_10 generator.
 __device__ double curand_uniform_double ( curandStateMtgp32_t* state )
 Return a uniformly distributed double from a MTGP32 generator.
 __device__ double curand_uniform_double ( curandStateMRG32k3a_t* state )
 Return a uniformly distributed double from an MRG32k3a generator.
 __device__ double curand_uniform_double ( curandStateXORWOW_t* state )
 Return a uniformly distributed double from an XORWOW generator.
 template < typename T >__device__ void skipahead ( unsigned long long n, T state )
 Update Sobol64 state to skip n elements.
 template < typename T >__device__ void skipahead ( unsigned int n, T state )
 Update Sobol32 state to skip n elements.
 __device__ void skipahead ( unsigned long long n, curandStateMRG32k3a_t* state )
 Update MRG32k3a state to skip n elements.
 __device__ void skipahead ( unsigned long long n, curandStatePhilox4_32_10_t* state )
 Update Philox4_32_10 state to skip n elements.
 __device__ void skipahead ( unsigned long long n, curandStateXORWOW_t* state )
 Update XORWOW state to skip n elements.
 __device__ void skipahead_sequence ( unsigned long long n, curandStateMRG32k3a_t* state )
 Update MRG32k3a state to skip ahead n sequences.
 __device__ void skipahead_sequence ( unsigned long long n, curandStatePhilox4_32_10_t* state )
 Update Philox4_32_10 state to skip ahead n subsequences.
 __device__ void skipahead_sequence ( unsigned long long n, curandStateXORWOW_t* state )
 Update XORWOW state to skip ahead n subsequences.
 __device__ void skipahead_subsequence ( unsigned long long n, curandStateMRG32k3a_t* state )
 Update MRG32k3a state to skip ahead n subsequences.
Functions
 QUALIFIERS_MTGP32 unsigned int curand ( curandStateMtgp32_t* state )

Return 32bits of pseudorandomness from a mtgp32 generator.
Parameters
 state
  Pointer to state to update
Returns
32bits of pseudorandomness as an unsigned int, all bits valid to use.
Description
Return 32bits of pseudorandomness from the mtgp32 generator in state, increment position of generator by the number of threads in the block. Note the number of threads in the block can not exceed 256.
 __device__ unsigned long long curand ( curandStateScrambledSobol64_t* state )

Return 64bits of quasirandomness from a scrambled Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
64bits of quasirandomness as an unsigned long long, all bits valid to use.
Description
Return 64bits of quasirandomness from the scrambled Sobol32 generator in state, increment position of generator by one.
 __device__ unsigned long long curand ( curandStateSobol64_t* state )

Return 64bits of quasirandomness from a Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
64bits of quasirandomness as an unsigned long long, all bits valid to use.
Description
Return 64bits of quasirandomness from the Sobol64 generator in state, increment position of generator by one.
 __device__ unsigned int curand ( curandStateScrambledSobol32_t* state )

Return 32bits of quasirandomness from a scrambled Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
32bits of quasirandomness as an unsigned int, all bits valid to use.
Description
Return 32bits of quasirandomness from the scrambled Sobol32 generator in state, increment position of generator by one.
 __device__ unsigned int curand ( curandStateSobol32_t* state )

Return 32bits of quasirandomness from a Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
32bits of quasirandomness as an unsigned int, all bits valid to use.
Description
Return 32bits of quasirandomness from the Sobol32 generator in state, increment position of generator by one.
 __device__ unsigned int curand ( curandStateMRG32k3a_t* state )

Return 32bits of pseudorandomness from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
Returns
32bits of pseudorandomness as an unsigned int, all bits valid to use.
Description
Return 32bits of pseudorandomness from the MRG32k3a generator in state, increment position of generator by one.
 __device__ unsigned int curand ( curandStatePhilox4_32_10_t* state )

Return 32bits of pseudorandomness from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
32bits of pseudorandomness as an unsigned int, all bits valid to use.
Description
Return 32bits of pseudorandomness from the Philox4_32_10 generator in state, increment position of generator by one.
 __device__ unsigned int curand ( curandStateXORWOW_t* state )

Return 32bits of pseudorandomness from an XORWOW generator.
Parameters
 state
  Pointer to state to update
Returns
32bits of pseudorandomness as an unsigned int, all bits valid to use.
Description
Return 32bits of pseudorandomness from the XORWOW generator in state, increment position of generator by one.
 __device__ uint4 curand4 ( curandStatePhilox4_32_10_t* state )

Return tuple of 4 32bit pseudorandoms from a Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
128bits of pseudorandomness as a uint4, all bits valid to use.
Description
Return 128 bits of pseudorandomness from the Philox4_32_10 generator in state, increment position of generator by four.
 __host__ curandStatus_t curandMakeMTGP32Constants ( const mtgp32_params_fast_t params[], mtgp32_kernel_params_t* p )

Set up constant parameters for the mtgp32 generator.
Parameters
 params
  Pointer to an array of type mtgp32_params_fast_t in host memory
 p
  pointer to a structure of type mtgp32_kernel_params_t in device memory.
Returns
 CURAND_STATUS_ALLOCATION_FAILED if host memory could not be allocated
 CURAND_STATUS_INITIALIZATION_FAILED if the copy to device memory failed
 CURAND_STATUS_SUCCESS otherwise
Description
This hostside helper function reorganizes CURAND_NUM_MTGP32_PARAMS sets of generator parameters for use by kernel functions and copies the result to the specified location in device memory.
 __host__ curandStatus_t CURANDAPI curandMakeMTGP32KernelState ( curandStateMtgp32_t* s, mtgp32_params_fast_t params[], mtgp32_kernel_params_t* k, int n, unsigned long long seed )

Set up initial states for the mtgp32 generator.
Parameters
 s
  pointer to an array of states in device memory
 params
  Pointer to an array of type mtgp32_params_fast_t in host memory
 k
  pointer to a structure of type mtgp32_kernel_params_t in device memory
 n
  number of parameter sets/states to initialize
 seed
  seed value
Returns
 CURAND_STATUS_ALLOCATION_FAILED if host memory state could not be allocated
 CURAND_STATUS_INITIALIZATION_FAILED if the copy to device memory failed
 CURAND_STATUS_SUCCESS otherwise
Description
This hostside helper function initializes a number of states (one parameter set per state) for an mtgp32 generator. To accomplish this it allocates a state array in host memory, initializes that array, and copies the result to device memory.
 __device__ void curand_init ( curandDirectionVectors64_t direction_vectors, unsigned long long scramble_c, unsigned long long offset, curandStateScrambledSobol64_t* state )

Initialize Scrambled Sobol64 state.
Parameters
 direction_vectors
  Pointer to array of 64 unsigned long longs representing the direction vectors for the desired dimension
 scramble_c
 Scramble constant
 offset
  Absolute offset into sequence
 state
  Pointer to state to initialize
Description
Initialize Sobol64 state in state with the given directionvectors and offset.
The direction vector is a device pointer to an array of 64 unsigned long longs. All input values of offset are legal.
 __device__ void curand_init ( curandDirectionVectors64_t direction_vectors, unsigned long long offset, curandStateSobol64_t* state )

Initialize Sobol64 state.
Parameters
 direction_vectors
  Pointer to array of 64 unsigned long longs representing the direction vectors for the desired dimension
 offset
  Absolute offset into sequence
 state
  Pointer to state to initialize
Description
Initialize Sobol64 state in state with the given directionvectors and offset.
The direction vector is a device pointer to an array of 64 unsigned long longs. All input values of offset are legal.
 __device__ void curand_init ( curandDirectionVectors32_t direction_vectors, unsigned int scramble_c, unsigned int offset, curandStateScrambledSobol32_t* state )

Initialize Scrambled Sobol32 state.
Parameters
 direction_vectors
  Pointer to array of 32 unsigned ints representing the direction vectors for the desired dimension
 scramble_c
 Scramble constant
 offset
  Absolute offset into sequence
 state
  Pointer to state to initialize
Description
Initialize Sobol32 state in state with the given directionvectors and offset.
The direction vector is a device pointer to an array of 32 unsigned ints. All input values of offset are legal.
 __device__ void curand_init ( curandDirectionVectors32_t direction_vectors, unsigned int offset, curandStateSobol32_t* state )

Initialize Sobol32 state.
Parameters
 direction_vectors
  Pointer to array of 32 unsigned ints representing the direction vectors for the desired dimension
 offset
  Absolute offset into sequence
 state
  Pointer to state to initialize
Description
Initialize Sobol32 state in state with the given directionvectors and offset.
The direction vector is a device pointer to an array of 32 unsigned ints. All input values of offset are legal.
 __device__ void curand_init ( unsigned long long seed, unsigned long long subsequence, unsigned long long offset, curandStateMRG32k3a_t* state )

Initialize MRG32k3a state.
Parameters
 seed
  Arbitrary bits to use as a seed
 subsequence
  Subsequence to start at
 offset
  Absolute offset into sequence
 state
  Pointer to state to initialize
Description
Initialize MRG32k3a state in state with the given seed, subsequence, and offset.
All input values of seed, subsequence, and offset are legal. subsequence will be truncated to 51 bits to avoid running into the next sequence
A value of 0 for seed sets the state to the values of the original published version of the MRG32k3a algorithm.
 __device__ void curand_init ( unsigned long long seed, unsigned long long subsequence, unsigned long long offset, curandStatePhilox4_32_10_t* state )

Initialize Philox4_32_10 state.
Parameters
 seed
  Arbitrary bits to use as a seed
 subsequence
  Subsequence to start at
 offset
  Absolute offset into subsequence
 state
  Pointer to state to initialize
Description
Initialize Philox4_32_10 state in state with the given seed, p\ subsequence, and offset.
All input values for seed, subseqence and offset are legal. Each of the 2^{64} possible values of seed selects an independent sequence of length 2^{130}. The first 2^{66} * subsequence + offset. values of the sequence are skipped. I.e., subsequences are of length 2^{66}.
 __device__ void curand_init ( unsigned long long seed, unsigned long long subsequence, unsigned long long offset, curandStateXORWOW_t* state )

Initialize XORWOW state.
Parameters
 seed
  Arbitrary bits to use as a seed
 subsequence
  Subsequence to start at
 offset
  Absolute offset into sequence
 state
  Pointer to state to initialize
Description
Initialize XORWOW state in state with the given seed, subsequence, and offset.
All input values of seed, subsequence, and offset are legal. Large values for subsequence and offset require more computation and so will take more time to complete.
A value of 0 for seed sets the state to the values of the original published version of the xorwow algorithm.
 __device__ float curand_log_normal ( curandStateScrambledSobol64_t* state, float mean, float stddev )

Return a lognormally distributed float from a scrambled Sobol64 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float with mean mean and standard deviation stddev
Description
Return a single lognormally distributed float derived from a normal distribution with mean mean and standard deviation stddev from the scrambled Sobol64 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results, then converts to lognormal distribution.
 __device__ float curand_log_normal ( curandStateSobol64_t* state, float mean, float stddev )

Return a lognormally distributed float from a Sobol64 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float with mean mean and standard deviation stddev
Description
Return a single lognormally distributed float derived from a normal distribution with mean mean and standard deviation stddev from the Sobol64 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results, then converts to lognormal distribution.
 __device__ float curand_log_normal ( curandStateScrambledSobol32_t* state, float mean, float stddev )

Return a lognormally distributed float from a scrambled Sobol32 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float with mean mean and standard deviation stddev
Description
Return a single lognormally distributed float derived from a normal distribution with mean mean and standard deviation stddev from the scrambled Sobol32 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate a normally distributed result, then transforms the result to lognormal.
 __device__ float curand_log_normal ( curandStateSobol32_t* state, float mean, float stddev )

Return a lognormally distributed float from a Sobol32 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float with mean mean and standard deviation stddev
Description
Return a single lognormally distributed float derived from a normal distribution with mean mean and standard deviation stddev from the Sobol32 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate a normally distributed result, then transforms the result to lognormal.
 __device__ float curand_log_normal ( curandStateMtgp32_t* state, float mean, float stddev )

Return a lognormally distributed float from an MTGP32 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float with mean mean and standard deviation stddev
Description
Return a single lognormally distributed float derived from a normal distribution with mean mean and standard deviation stddev from the MTGP32 generator in state, increment position of generator.
The implementation uses the inverse cumulative distribution function to generate a normally distributed result, then transforms the result to lognormal.
 __device__ float curand_log_normal ( curandStateMRG32k3a_t* state, float mean, float stddev )

Return a lognormally distributed float from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float with mean mean and standard deviation stddev
Description
Return a single lognormally distributed float derived from a normal distribution with mean mean and standard deviation stddev from the MRG32k3a generator in state, increment position of generator by one.
The implementation uses a BoxMuller transform to generate two normally distributed results, transforms them to lognormal distribution, then returns them one at a time. See curand_log_normal2() for a more efficient version that returns both results at once.
 __device__ float curand_log_normal ( curandStatePhilox4_32_10_t* state, float mean, float stddev )

Return a lognormally distributed float from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float with mean mean and standard deviation stddev
Description
Return a single lognormally distributed float derived from a normal distribution with mean mean and standard deviation stddev from the Philox4_32_10 generator in state, increment position of generator by one.
The implementation uses a BoxMuller transform to generate two normally distributed results, transforms them to lognormal distribution, then returns them one at a time. See curand_log_normal2() for a more efficient version that returns both results at once.
 __device__ float curand_log_normal ( curandStateXORWOW_t* state, float mean, float stddev )

Return a lognormally distributed float from an XORWOW generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float with mean mean and standard deviation stddev
Description
Return a single lognormally distributed float derived from a normal distribution with mean mean and standard deviation stddev from the XORWOW generator in state, increment position of generator by one.
The implementation uses a BoxMuller transform to generate two normally distributed results, transforms them to lognormal distribution, then returns them one at a time. See curand_log_normal2() for a more efficient version that returns both results at once.
 __device__ float2 curand_log_normal2 ( curandStateMRG32k3a_t* state, float mean, float stddev )

Return two normally distributed floats from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float2 where each element is from a distribution with mean mean and standard deviation stddev
Description
Return two lognormally distributed floats derived from a normal distribution with mean mean and standard deviation stddev from the MRG32k3a generator in state, increment position of generator by two.
The implementation uses a BoxMuller transform to generate two normally distributed results, then transforms them to lognormal.
 __device__ float2 curand_log_normal2 ( curandStatePhilox4_32_10_t* state, float mean, float stddev )

Return two normally distributed floats from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float2 where each element is from a distribution with mean mean and standard deviation stddev
Description
Return two lognormally distributed floats derived from a normal distribution with mean mean and standard deviation stddev from the Philox4_32_10 generator in state, increment position of generator by two.
The implementation uses a BoxMuller transform to generate two normally distributed results, then transforms them to lognormal.
 __device__ float2 curand_log_normal2 ( curandStateXORWOW_t* state, float mean, float stddev )

Return two normally distributed floats from an XORWOW generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float2 where each element is from a distribution with mean mean and standard deviation stddev
Description
Return two lognormally distributed floats derived from a normal distribution with mean mean and standard deviation stddev from the XORWOW generator in state, increment position of generator by two.
The implementation uses a BoxMuller transform to generate two normally distributed results, then transforms them to lognormal.
 __device__ double2 curand_log_normal2_double ( curandStateMRG32k3a_t* state, double mean, double stddev )

Return two lognormally distributed doubles from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double2 where each element is from a distribution with mean mean and standard deviation stddev
Description
Return two lognormally distributed doubles derived from a normal distribution with mean mean and standard deviation stddev from the MRG32k3a generator in state, increment position of generator by two.
The implementation uses a BoxMuller transform to generate two normally distributed results, and transforms them to lognormal distribution,.
 __device__ double2 curand_log_normal2_double ( curandStatePhilox4_32_10_t* state, double mean, double stddev )

Return two lognormally distributed doubles from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double4 where each element is from a distribution with mean mean and standard deviation stddev
Description
Return two lognormally distributed doubles derived from a normal distribution with mean mean and standard deviation stddev from the Philox4_32_10 generator in state, increment position of generator by four.
The implementation uses a BoxMuller transform to generate two normally distributed results, and transforms them to lognormal distribution,.
 __device__ double2 curand_log_normal2_double ( curandStateXORWOW_t* state, double mean, double stddev )

Return two lognormally distributed doubles from an XORWOW generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double2 where each element is from a distribution with mean mean and standard deviation stddev
Description
Return two lognormally distributed doubles derived from a normal distribution with mean mean and standard deviation stddev from the XORWOW generator in state, increment position of generator by two.
The implementation uses a BoxMuller transform to generate two normally distributed results, and transforms them to lognormal distribution,.
 __device__ float4 curand_log_normal4 ( curandStatePhilox4_32_10_t* state, float mean, float stddev )

Return four normally distributed floats from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed float4 where each element is from a distribution with mean mean and standard deviation stddev
Description
Return four lognormally distributed floats derived from a normal distribution with mean mean and standard deviation stddev from the Philox4_32_10 generator in state, increment position of generator by four.
The implementation uses a BoxMuller transform to generate two normally distributed results, then transforms them to lognormal.
 __device__ double curand_log_normal_double ( curandStateScrambledSobol64_t* state, double mean, double stddev )

Return a lognormally distributed double from a scrambled Sobol64 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double with mean mean and standard deviation stddev
Description
Return a single normally distributed double derived from a normal distribution with mean mean and standard deviation stddev from the scrambled Sobol64 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ double curand_log_normal_double ( curandStateSobol64_t* state, double mean, double stddev )

Return a lognormally distributed double from a Sobol64 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double with mean mean and standard deviation stddev
Description
Return a single normally distributed double derived from a normal distribution with mean mean and standard deviation stddev from the Sobol64 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ double curand_log_normal_double ( curandStateScrambledSobol32_t* state, double mean, double stddev )

Return a lognormally distributed double from a scrambled Sobol32 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double with mean mean and standard deviation stddev
Description
Return a single lognormally distributed double derived from a normal distribution with mean mean and standard deviation stddev from the scrambled Sobol32 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results, and transforms them into lognormal distribution.
 __device__ double curand_log_normal_double ( curandStateSobol32_t* state, double mean, double stddev )

Return a lognormally distributed double from a Sobol32 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double with mean mean and standard deviation stddev
Description
Return a single lognormally distributed double derived from a normal distribution with mean mean and standard deviation stddev from the Sobol32 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results, and transforms them into lognormal distribution.
 __device__ double curand_log_normal_double ( curandStateMtgp32_t* state, double mean, double stddev )

Return a lognormally distributed double from an MTGP32 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double with mean mean and standard deviation stddev
Description
Return a single lognormally distributed double derived from a normal distribution with mean mean and standard deviation stddev from the MTGP32 generator in state, increment position of generator.
The implementation uses the inverse cumulative distribution function to generate normally distributed results, and transforms them into lognormal distribution.
 __device__ double curand_log_normal_double ( curandStateMRG32k3a_t* state, double mean, double stddev )

Return a lognormally distributed double from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double with mean mean and standard deviation stddev
Description
Return a single normally distributed double derived from a normal distribution with mean mean and standard deviation stddev from the MRG32k3a generator in state, increment position of generator.
The implementation uses a BoxMuller transform to generate two normally distributed results, transforms them to lognormal distribution, then returns them one at a time. See curand_log_normal2_double() for a more efficient version that returns both results at once.
 __device__ double curand_log_normal_double ( curandStatePhilox4_32_10_t* state, double mean, double stddev )

Return a lognormally distributed double from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double with mean mean and standard deviation stddev
Description
Return a single normally distributed double derived from a normal distribution with mean mean and standard deviation stddev from the Philox4_32_10 generator in state, increment position of generator.
The implementation uses a BoxMuller transform to generate two normally distributed results, transforms them to lognormal distribution, then returns them one at a time. See curand_log_normal2_double() for a more efficient version that returns both results at once.
 __device__ double curand_log_normal_double ( curandStateXORWOW_t* state, double mean, double stddev )

Return a lognormally distributed double from an XORWOW generator.
Parameters
 state
  Pointer to state to update
 mean
  Mean of the related normal distribution
 stddev
  Standard deviation of the related normal distribution
Returns
Lognormally distributed double with mean mean and standard deviation stddev
Description
Return a single normally distributed double derived from a normal distribution with mean mean and standard deviation stddev from the XORWOW generator in state, increment position of generator.
The implementation uses a BoxMuller transform to generate two normally distributed results, transforms them to lognormal distribution, then returns them one at a time. See curand_log_normal2_double() for a more efficient version that returns both results at once.
 QUALIFIERS_MTGP32 float curand_mtgp32_single ( curandStateMtgp32_t* state )

Return a uniformly distributed float from a mtgp32 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from the mtgp32 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
Note: This alternate derivation of a uniform float is provided for completeness with the original source
 QUALIFIERS_MTGP32 float curand_mtgp32_single_specific ( curandStateMtgp32_t* state, unsigned char index, unsigned char n )

Return a uniformly distributed float from a specific position in a mtgp32 generator.
Parameters
 state
  Pointer to state to update
 index
  Index (0..255) of the position within the state to draw from and update
 n
  The total number of postions in this state that are being updated by this invocation
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from position index of the mtgp32 generator in state, and increment position of generator by n positions, which must be the total number of positions upddated in the state by the thread block, for this invocation. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
Note 1: Thread indices must range from 0...n  1. The number of positions updated may not exceed 256. A thread block may update more than one state, but a given state may not be updated by more than one thread block.
Note 2: This alternate derivation of a uniform float is provided for completeness with the original source
 QUALIFIERS_MTGP32 unsigned int curand_mtgp32_specific ( curandStateMtgp32_t* state, unsigned char index, unsigned char n )

Return 32bits of pseudorandomness from a specific position in a mtgp32 generator.
Parameters
 state
  Pointer to state to update
 index
  Index (0..255) of the position within the state to draw from and update
 n
  The total number of postions in this state that are being updated by this invocation
Returns
32bits of pseudorandomness as an unsigned int, all bits valid to use.
Description
Return 32bits of pseudorandomness from position index of the mtgp32 generator in state, increment position of generator by n positions, which must be the total number of positions upddated in the state by the thread block, for this invocation.
Note : Thread indices must range from 0... n  1. The number of positions updated may not exceed 256. A thread block may update more than one state, but a given state may not be updated by more than one thread block.
 __device__ float curand_normal ( curandStateScrambledSobol64_t* state )

Return a normally distributed float from a scrambled Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float with mean 0.0f and standard deviation 1.0f
Description
Return a single normally distributed float with mean 0.0f and standard deviation 1.0f from the scrambled Sobol64 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ float curand_normal ( curandStateSobol64_t* state )

Return a normally distributed float from a Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float with mean 0.0f and standard deviation 1.0f
Description
Return a single normally distributed float with mean 0.0f and standard deviation 1.0f from the Sobol64 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ float curand_normal ( curandStateScrambledSobol32_t* state )

Return a normally distributed float from a scrambled Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float with mean 0.0f and standard deviation 1.0f
Description
Return a single normally distributed float with mean 0.0f and standard deviation 1.0f from the scrambled Sobol32 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ float curand_normal ( curandStateSobol32_t* state )

Return a normally distributed float from a Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float with mean 0.0f and standard deviation 1.0f
Description
Return a single normally distributed float with mean 0.0f and standard deviation 1.0f from the Sobol32 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ float curand_normal ( curandStateMtgp32_t* state )

Return a normally distributed float from a MTGP32 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float with mean 0.0f and standard deviation 1.0f
Description
Return a single normally distributed float with mean 0.0f and standard deviation 1.0f from the MTGP32 generator in state, increment position of generator.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ float curand_normal ( curandStateMRG32k3a_t* state )

Return a normally distributed float from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float with mean 0.0f and standard deviation 1.0f
Description
Return a single normally distributed float with mean 0.0f and standard deviation 1.0f from the MRG32k3a generator in state, increment position of generator by one.
The implementation uses a BoxMuller transform to generate two normally distributed results, then returns them one at a time. See curand_normal2() for a more efficient version that returns both results at once.
 __device__ float curand_normal ( curandStatePhilox4_32_10_t* state )

Return a normally distributed float from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float with mean 0.0f and standard deviation 1.0f
Description
Return a single normally distributed float with mean 0.0f and standard deviation 1.0f from the Philox4_32_10 generator in state, increment position of generator by one.
The implementation uses a BoxMuller transform to generate two normally distributed results, then returns them one at a time. See curand_normal2() for a more efficient version that returns both results at once.
 __device__ float curand_normal ( curandStateXORWOW_t* state )

Return a normally distributed float from an XORWOW generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float with mean 0.0f and standard deviation 1.0f
Description
Return a single normally distributed float with mean 0.0f and standard deviation 1.0f from the XORWOW generator in state, increment position of generator by one.
The implementation uses a BoxMuller transform to generate two normally distributed results, then returns them one at a time. See curand_normal2() for a more efficient version that returns both results at once.
 __device__ float2 curand_normal2 ( curandStateMRG32k3a_t* state )

Return two normally distributed floats from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float2 where each element is from a distribution with mean 0.0f and standard deviation 1.0f
Description
Return two normally distributed floats with mean 0.0f and standard deviation 1.0f from the MRG32k3a generator in state, increment position of generator by two.
The implementation uses a BoxMuller transform to generate two normally distributed results.
 __device__ float2 curand_normal2 ( curandStatePhilox4_32_10_t* state )

Return two normally distributed floats from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float2 where each element is from a distribution with mean 0.0f and standard deviation 1.0f
Description
Return two normally distributed floats with mean 0.0f and standard deviation 1.0f from the Philox4_32_10 generator in state, increment position of generator by two.
The implementation uses a BoxMuller transform to generate two normally distributed results.
 __device__ float2 curand_normal2 ( curandStateXORWOW_t* state )

Return two normally distributed floats from an XORWOW generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float2 where each element is from a distribution with mean 0.0f and standard deviation 1.0f
Description
Return two normally distributed floats with mean 0.0f and standard deviation 1.0f from the XORWOW generator in state, increment position of generator by two.
The implementation uses a BoxMuller transform to generate two normally distributed results.
 __device__ double2 curand_normal2_double ( curandStateMRG32k3a_t* state )

Return two normally distributed doubles from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double2 where each element is from a distribution with mean 0.0 and standard deviation 1.0
Description
Return two normally distributed doubles with mean 0.0 and standard deviation 1.0 from the MRG32k3a generator in state, increment position of generator.
The implementation uses a BoxMuller transform to generate two normally distributed results.
 __device__ double2 curand_normal2_double ( curandStatePhilox4_32_10_t* state )

Return two normally distributed doubles from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double2 where each element is from a distribution with mean 0.0 and standard deviation 1.0
Description
Return two normally distributed doubles with mean 0.0 and standard deviation 1.0 from the Philox4_32_10 generator in state, increment position of generator by 2.
The implementation uses a BoxMuller transform to generate two normally distributed results.
 __device__ double2 curand_normal2_double ( curandStateXORWOW_t* state )

Return two normally distributed doubles from an XORWOW generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double2 where each element is from a distribution with mean 0.0 and standard deviation 1.0
Description
Return two normally distributed doubles with mean 0.0 and standard deviation 1.0 from the XORWOW generator in state, increment position of generator by 2.
The implementation uses a BoxMuller transform to generate two normally distributed results.
 __device__ float4 curand_normal4 ( curandStatePhilox4_32_10_t* state )

Return four normally distributed floats from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed float2 where each element is from a distribution with mean 0.0f and standard deviation 1.0f
Description
Return four normally distributed floats with mean 0.0f and standard deviation 1.0f from the Philox4_32_10 generator in state, increment position of generator by four.
The implementation uses a BoxMuller transform to generate two normally distributed results.
 __device__ double curand_normal_double ( curandStateScrambledSobol64_t* state )

Return a normally distributed double from a scrambled Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double with mean 0.0 and standard deviation 1.0
Description
Return a single normally distributed double with mean 0.0 and standard deviation 1.0 from the scrambled Sobol64 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ double curand_normal_double ( curandStateSobol64_t* state )

Return a normally distributed double from a Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double with mean 0.0 and standard deviation 1.0
Description
Return a single normally distributed double with mean 0.0 and standard deviation 1.0 from the Sobol64 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ double curand_normal_double ( curandStateScrambledSobol32_t* state )

Return a normally distributed double from a scrambled Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double with mean 0.0 and standard deviation 1.0
Description
Return a single normally distributed double with mean 0.0 and standard deviation 1.0 from the scrambled Sobol32 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ double curand_normal_double ( curandStateSobol32_t* state )

Return a normally distributed double from an Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double with mean 0.0 and standard deviation 1.0
Description
Return a single normally distributed double with mean 0.0 and standard deviation 1.0 from the Sobol32 generator in state, increment position of generator by one.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ double curand_normal_double ( curandStateMtgp32_t* state )

Return a normally distributed double from an MTGP32 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double with mean 0.0 and standard deviation 1.0
Description
Return a single normally distributed double with mean 0.0 and standard deviation 1.0 from the MTGP32 generator in state, increment position of generator.
The implementation uses the inverse cumulative distribution function to generate normally distributed results.
 __device__ double curand_normal_double ( curandStateMRG32k3a_t* state )

Return a normally distributed double from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double with mean 0.0 and standard deviation 1.0
Description
Return a single normally distributed double with mean 0.0 and standard deviation 1.0 from the XORWOW generator in state, increment position of generator.
The implementation uses a BoxMuller transform to generate two normally distributed results, then returns them one at a time. See curand_normal2_double() for a more efficient version that returns both results at once.
 __device__ double curand_normal_double ( curandStatePhilox4_32_10_t* state )

Return a normally distributed double from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double with mean 0.0 and standard deviation 1.0
Description
Return a single normally distributed double with mean 0.0 and standard deviation 1.0 from the Philox4_32_10 generator in state, increment position of generator.
The implementation uses a BoxMuller transform to generate two normally distributed results, then returns them one at a time. See curand_normal2_double() for a more efficient version that returns both results at once.
 __device__ double curand_normal_double ( curandStateXORWOW_t* state )

Return a normally distributed double from an XORWOW generator.
Parameters
 state
  Pointer to state to update
Returns
Normally distributed double with mean 0.0 and standard deviation 1.0
Description
Return a single normally distributed double with mean 0.0 and standard deviation 1.0 from the XORWOW generator in state, increment position of generator.
The implementation uses a BoxMuller transform to generate two normally distributed results, then returns them one at a time. See curand_normal2_double() for a more efficient version that returns both results at once.
 __device__ unsigned int curand_poisson ( curandStateScrambledSobol64_t* state, double lambda )

Return a Poissondistributed unsigned int from a scrambled Sobol64 generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a single unsigned int from a Poisson distribution with lambda lambda from the scrambled Sobol64 generator in state, increment position of generator by one.
 __device__ unsigned int curand_poisson ( curandStateSobol64_t* state, double lambda )

Return a Poissondistributed unsigned int from a Sobol64 generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a single unsigned int from a Poisson distribution with lambda lambda from the Sobol64 generator in state, increment position of generator by one.
 __device__ unsigned int curand_poisson ( curandStateScrambledSobol32_t* state, double lambda )

Return a Poissondistributed unsigned int from a scrambled Sobol32 generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a single unsigned int from a Poisson distribution with lambda lambda from the scrambled Sobol32 generator in state, increment the position of the generator by one.
 __device__ unsigned int curand_poisson ( curandStateSobol32_t* state, double lambda )

Return a Poissondistributed unsigned int from a Sobol32 generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a single unsigned int from a Poisson distribution with lambda lambda from the Sobol32 generator in state, increment the position of the generator by one.
 __device__ unsigned int curand_poisson ( curandStateMtgp32_t* state, double lambda )

Return a Poissondistributed unsigned int from a MTGP32 generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a single int from a Poisson distribution with lambda lambda from the MTGP32 generator in state, increment the position of the generator by one.
 __device__ unsigned int curand_poisson ( curandStateMRG32k3a_t* state, double lambda )

Return a Poissondistributed unsigned int from a MRG32k3A generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a single unsigned int from a Poisson distribution with lambda lambda from the MRG32k3a generator in state, increment the position of the generator by a variable amount, depending on the algorithm used.
 __device__ unsigned int curand_poisson ( curandStatePhilox4_32_10_t* state, double lambda )

Return a Poissondistributed unsigned int from a Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a single unsigned int from a Poisson distribution with lambda lambda from the Philox4_32_10 generator in state, increment the position of the generator by a variable amount, depending on the algorithm used.
 __device__ unsigned int curand_poisson ( curandStateXORWOW_t* state, double lambda )

Return a Poissondistributed unsigned int from a XORWOW generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a single unsigned int from a Poisson distribution with lambda lambda from the XORWOW generator in state, increment the position of the generator by a variable amount, depending on the algorithm used.
 __device__ uint4 curand_poisson4 ( curandStatePhilox4_32_10_t* state, double lambda )

Return four Poissondistributed unsigned ints from a Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
 lambda
  Lambda of the Poisson distribution
Returns
Poissondistributed unsigned int with lambda lambda
Description
Return a four unsigned ints from a Poisson distribution with lambda lambda from the Philox4_32_10 generator in state, increment the position of the generator by a variable amount, depending on the algorithm used.
 __device__ float curand_uniform ( curandStateScrambledSobol64_t* state )

Return a uniformly distributed float from a scrambled Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from the scrambled Sobol64 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
The implementation is guaranteed to use a single call to curand().
 __device__ float curand_uniform ( curandStateSobol64_t* state )

Return a uniformly distributed float from a Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from the Sobol64 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
The implementation is guaranteed to use a single call to curand().
 __device__ float curand_uniform ( curandStateScrambledSobol32_t* state )

Return a uniformly distributed float from a scrambled Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from the scrambled Sobol32 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
The implementation is guaranteed to use a single call to curand().
 __device__ float curand_uniform ( curandStateSobol32_t* state )

Return a uniformly distributed float from a Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from the Sobol32 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
The implementation is guaranteed to use a single call to curand().
 __device__ float curand_uniform ( curandStateMtgp32_t* state )

Return a uniformly distributed float from a MTGP32 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from the MTGP32 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
 __device__ float curand_uniform ( curandStatePhilox4_32_10_t* state )

Return a uniformly distributed float from a Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0 and 1.0
Description
Return a uniformly distributed float between 0.0f and 1.0f from the Philox4_32_10 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
 __device__ float curand_uniform ( curandStateMRG32k3a_t* state )

Return a uniformly distributed float from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from the MRG32k3a generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
The implementation returns up to 23 bits of mantissa, with the minimum return value \( 2^{32} \)
 __device__ float curand_uniform ( curandStateXORWOW_t* state )

Return a uniformly distributed float from an XORWOW generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0f and 1.0f
Description
Return a uniformly distributed float between 0.0f and 1.0f from the XORWOW generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
The implementation may use any number of calls to curand() to get enough random bits to create the return value. The current implementation uses one call.
 __device__ double2 curand_uniform2_double ( curandStatePhilox4_32_10_t* state )

Return a uniformly distributed tuple of 2 doubles from an Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
2 uniformly distributed doubles between 0.0 and 1.0
Description
Return a uniformly distributed 2 doubles (double4) between 0.0 and 1.0 from the Philox4_32_10 generator in state, increment position of generator by 4. Output range excludes 0.0 but includes 1.0. Denormalized floating point outputs are never returned.
 __device__ float4 curand_uniform4 ( curandStatePhilox4_32_10_t* state )

Return a uniformly distributed tuple of 4 floats from a Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed float between 0.0 and 1.0
Description
Return a uniformly distributed 4 floats between 0.0f and 1.0f from the Philox4_32_10 generator in state, increment position of generator by 4. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
 __device__ double curand_uniform_double ( curandStateScrambledSobol64_t* state )

Return a uniformly distributed double from a scrambled Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed double between 0.0 and 1.0
Description
Return a uniformly distributed double between 0.0 and 1.0 from the scrambled Sobol64 generator in state, increment position of generator. Output range excludes 0.0 but includes 1.0. Denormalized floating point outputs are never returned.
The implementation is guaranteed to use a single call to curand() to preserve the quasirandom properties of the sequence.
 __device__ double curand_uniform_double ( curandStateSobol64_t* state )

Return a uniformly distributed double from a Sobol64 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed double between 0.0 and 1.0
Description
Return a uniformly distributed double between 0.0 and 1.0 from the Sobol64 generator in state, increment position of generator. Output range excludes 0.0 but includes 1.0. Denormalized floating point outputs are never returned.
The implementation is guaranteed to use a single call to curand() to preserve the quasirandom properties of the sequence.
 __device__ double curand_uniform_double ( curandStateScrambledSobol32_t* state )

Return a uniformly distributed double from a scrambled Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed double between 0.0 and 1.0
Description
Return a uniformly distributed double between 0.0 and 1.0 from the scrambled Sobol32 generator in state, increment position of generator. Output range excludes 0.0 but includes 1.0. Denormalized floating point outputs are never returned.
The implementation is guaranteed to use a single call to curand() to preserve the quasirandom properties of the sequence.
 __device__ double curand_uniform_double ( curandStateSobol32_t* state )

Return a uniformly distributed double from a Sobol32 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed double between 0.0 and 1.0
Description
Return a uniformly distributed double between 0.0 and 1.0 from the Sobol32 generator in state, increment position of generator. Output range excludes 0.0 but includes 1.0. Denormalized floating point outputs are never returned.
The implementation is guaranteed to use a single call to curand() to preserve the quasirandom properties of the sequence.
 __device__ double curand_uniform_double ( curandStatePhilox4_32_10_t* state )

Return a uniformly distributed double from a Philox4_32_10 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed double between 0.0f and 1.0f
Description
Return a uniformly distributed double between 0.0f and 1.0f from the Philox4_32_10 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
 __device__ double curand_uniform_double ( curandStateMtgp32_t* state )

Return a uniformly distributed double from a MTGP32 generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed double between 0.0f and 1.0f
Description
Return a uniformly distributed double between 0.0f and 1.0f from the MTGP32 generator in state, increment position of generator. Output range excludes 0.0f but includes 1.0f. Denormalized floating point outputs are never returned.
 __device__ double curand_uniform_double ( curandStateMRG32k3a_t* state )

Return a uniformly distributed double from an MRG32k3a generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed double between 0.0 and 1.0
Description
Return a uniformly distributed double between 0.0 and 1.0 from the MRG32k3a generator in state, increment position of generator. Output range excludes 0.0 but includes 1.0. Denormalized floating point outputs are never returned.
Note the implementation returns at most 32 random bits of mantissa as outlined in the seminal paper by L'Ecuyer.
 __device__ double curand_uniform_double ( curandStateXORWOW_t* state )

Return a uniformly distributed double from an XORWOW generator.
Parameters
 state
  Pointer to state to update
Returns
uniformly distributed double between 0.0 and 1.0
Description
Return a uniformly distributed double between 0.0 and 1.0 from the XORWOW generator in state, increment position of generator. Output range excludes 0.0 but includes 1.0. Denormalized floating point outputs are never returned.
The implementation may use any number of calls to curand() to get enough random bits to create the return value. The current implementation uses exactly two calls.

template < typename T >
__device__ void skipahead ( unsigned long long n, T state ) [inline] 
Update Sobol64 state to skip n elements.
Parameters
 n
  Number of elements to skip
 state
  Pointer to state to update
Description
Update the Sobol64 state in state to skip ahead n elements.
All values of n are valid.

template < typename T >
__device__ void skipahead ( unsigned int n, T state ) [inline] 
Update Sobol32 state to skip n elements.
Parameters
 n
  Number of elements to skip
 state
  Pointer to state to update
Description
Update the Sobol32 state in state to skip ahead n elements.
All values of n are valid.
 __device__ void skipahead ( unsigned long long n, curandStateMRG32k3a_t* state )

Update MRG32k3a state to skip n elements.
Parameters
 n
  Number of elements to skip
 state
  Pointer to state to update
Description
Update the MRG32k3a state in state to skip ahead n elements.
All values of n are valid. Large values require more computation and so will take more time to complete.
 __device__ void skipahead ( unsigned long long n, curandStatePhilox4_32_10_t* state )

Update Philox4_32_10 state to skip n elements.
Parameters
 n
  Number of elements to skip
 state
  Pointer to state to update
Description
Update the Philox4_32_10 state in state to skip ahead n elements.
All values of n are valid.
 __device__ void skipahead ( unsigned long long n, curandStateXORWOW_t* state )

Update XORWOW state to skip n elements.
Parameters
 n
  Number of elements to skip
 state
  Pointer to state to update
Description
Update the XORWOW state in state to skip ahead n elements.
All values of n are valid. Large values require more computation and so will take more time to complete.
 __device__ void skipahead_sequence ( unsigned long long n, curandStateMRG32k3a_t* state )

Update MRG32k3a state to skip ahead n sequences.
Parameters
 n
  Number of sequences to skip
 state
  Pointer to state to update
Description
Update the MRG32k3a state in state to skip ahead n sequences. Each sequence is 2^{127} elements long, so this means the function will skip ahead 2^{127} * n elements.
All values of n are valid. Large values require more computation and so will take more time to complete.
 __device__ void skipahead_sequence ( unsigned long long n, curandStatePhilox4_32_10_t* state )

Update Philox4_32_10 state to skip ahead n subsequences.
Parameters
 n
  Number of subsequences to skip
 state
  Pointer to state to update
Description
Update the Philox4_32_10 state in state to skip ahead n subsequences. Each subsequence is 2^{66} elements long, so this means the function will skip ahead 2^{66} * n elements.
All values of n are valid.
 __device__ void skipahead_sequence ( unsigned long long n, curandStateXORWOW_t* state )

Update XORWOW state to skip ahead n subsequences.
Parameters
 n
  Number of subsequences to skip
 state
  Pointer to state to update
Description
Update the XORWOW state in state to skip ahead n subsequences. Each subsequence is 2^{67} elements long, so this means the function will skip ahead 2^{67} * n elements.
All values of n are valid. Large values require more computation and so will take more time to complete.
 __device__ void skipahead_subsequence ( unsigned long long n, curandStateMRG32k3a_t* state )

Update MRG32k3a state to skip ahead n subsequences.
Parameters
 n
  Number of subsequences to skip
 state
  Pointer to state to update
Description
Update the MRG32k3a state in state to skip ahead n subsequences. Each subsequence is 2^{127}
2^{76} elements long, so this means the function will skip ahead 2^{67} * n elements.
Valid values of n are 0 to 2^{51}. Note n will be masked to 51 bits