PetscRandomGetValue#

Generates a random number. Call this after first calling PetscRandomCreate().

Synopsis#

#include "petscsys.h" 
PetscErrorCode PetscRandomGetValue(PetscRandom r, PetscScalar *val)

Not Collective

Input Parameter#

r - the random number generator context

Output Parameter#

val - the value

Notes#

Use VecSetRandom() to set the elements of a vector to random numbers.

When PETSc is compiled for complex numbers this returns a complex number with random real and complex parts. Use PetscRandomGetValueReal() to get a random real number.

To get a complex number with only a random real part, first call PetscRandomSetInterval() with a equal low and high imaginary part. Similarly to get a complex number with only a random imaginary part call PetscRandomSetInterval() with a equal low and high real part.

Example of Usage#

      PetscRandomCreate(PETSC_COMM_WORLD,&r);
      PetscRandomGetValue(r,&value1);
      PetscRandomGetValue(r,&value2);
      PetscRandomGetValue(r,&value3);
      PetscRandomDestroy(&r);