13.1 vsip_randcreate - Create a Random Number Generator State

vsip_randstate *vsip_randcreate(vsip_index seed, vsip_index numprocs, 
                                vsip_index id, vsip_rng portable);

Description

This function creates and initializes a random number generator state. The function allows for parallel random number generation by specifying the number of processes (numprocs) and the process ID (id). The portable parameter specifies the type of random number generator to use.

Parameters

• vsip_index seed: The seed value for the random number generator.

• vsip_index numprocs: The number of parallel processes.

• vsip_index id: The ID of the current process (must be in the range [0, numprocs-1]).

• vsip_rng portable: The type of random number generator to use (e.g., VSIP_PRNG for portable random number generation).

Return Value

• On success, a pointer to the newly created random number generator state is returned.

• On error, NULL is returned.

Example

vsip_randstate *rand_state; 
vsip_index seed = 42; 
vsip_index numprocs = 1; 
vsip_index id = 0; 
 
// Create a random number generator state 
rand_state = vsip_randcreate(seed, numprocs, id, VSIP_PRNG); 
 
if (rand_state == NULL) { 
    // Handle error 
}