MatSetRandom#

Sets all components of a matrix to random numbers.

Synopsis#

#include "petscmat.h" 
PetscErrorCode MatSetRandom(Mat x, PetscRandom rctx)

Logically Collective

Input Parameters#

Example#

Notes#

For sparse matrices that have been preallocated but not been assembled, it randomly selects appropriate locations,

for sparse matrices that already have nonzero locations, it fills the locations with random numbers.

It generates an error if used on unassembled sparse matrices that have not been preallocated.

See Also#

Matrices, Mat, PetscRandom, PetscRandomCreate(), MatZeroEntries(), MatSetValues(), PetscRandomDestroy()

Level#

intermediate

Location#

src/mat/interface/matrix.c

Examples#

src/ksp/ksp/tutorials/ex79.c
src/ksp/ksp/tutorials/ex81.c
src/ksp/ksp/tutorials/ex76.c
src/ksp/ksp/tutorials/ex77.c
src/tao/tutorials/ex4.c
src/mat/tutorials/ex9.c

Implementations#

MatSetRandom_MPIAIJ() in src/mat/impls/aij/mpi/mpiaij.c
MatSetRandom_SeqAIJ() in src/mat/impls/aij/seq/aij.c
MatSetRandom_MPIDense() in src/mat/impls/dense/mpi/mpidense.c
MatSetRandom_SeqDense() in src/mat/impls/dense/seq/dense.c
MatSetRandom_Nest() in src/mat/impls/nest/matnest.c
MatSetRandom_MPISELL() in src/mat/impls/sell/mpi/mpisell.c


Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages