Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
?large
Pre- and post-multiplies a real general matrix with a random orthogonal matrix.
Syntax
call slarge ( n , a , lda , iseed , work , info )
call dlarge ( n , a , lda , iseed , work , info )
call clarge ( n , a , lda , iseed , work , info )
call zlarge ( n , a , lda , iseed , work , info )
Include Files
mkl.fi
Description
slarge dlarge clarge zlarge
The routine ?large pre- and post-multiplies a general n -by- n matrix A with a random orthogonal or unitary matrix: A = U * D * UT .
Input Parameters
n
INTEGER . The order of the matrix A . n ≥ 0
- a
-
REAL for slarge , DOUBLE PRECISION for dlarge , COMPLEX for clarge , DOUBLE COMPLEX for zlarge , Array, size lda by n . On entry, the original n -by- n matrix A .
lda
INTEGER . The leading dimension of the array a . lda ≥ n .
iseed
INTEGER . Array, size 4.
On entry, the seed of the random number generator. The array elements must be between 0 and 4095, and iseed(4)[3] must be odd.
- work
-
REAL for slarge , DOUBLE PRECISION for dlarge , COMPLEX for clarge , DOUBLE COMPLEX for zlarge , Workspace array, size 2* n .
Output Parameters
- a
-
INTEGER . On exit, A is overwritten by U * A * U' for some random orthogonal matrix U .
- iseed
-
INTEGER . On exit, the seed is updated.
info
INTEGER .
If info = 0 , the execution is successful.
If info < 0 , the i -th parameter had an illegal value.