Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 6/24/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

?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

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. n0

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. ldan.

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) 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.