?lagge
?lagge
Generates a general
m
-by-n
matrix
.Syntax
lapack_int
LAPACKE_slagge
(
int
matrix_layout
,
lapack_int
m
,
lapack_int
n
,
lapack_int
kl
,
lapack_int
ku
,
const
float
*
d
,
float
*
a
,
lapack_int
lda
,
lapack_int
*
iseed
);
lapack_int
LAPACKE_dlagge
(
int
matrix_layout
,
lapack_int
m
,
lapack_int
n
,
lapack_int
kl
,
lapack_int
ku
,
const
double
*
d
,
double
*
a
,
lapack_int
lda
,
lapack_int
*
iseed
);
lapack_int
LAPACKE_clagge
(
int
matrix_layout
,
lapack_int
m
,
lapack_int
n
,
lapack_int
kl
,
lapack_int
ku
,
const
float
*
d
,
lapack_complex_float
*
a
,
lapack_int
lda
,
lapack_int
*
iseed
);
lapack_int
LAPACKE_zlagge
(
int
matrix_layout
,
lapack_int
m
,
lapack_int
n
,
lapack_int
kl
,
lapack_int
ku
,
const
double
*
d
,
lapack_complex_double
*
a
,
lapack_int
lda
,
lapack_int
*
iseed
);
Include Files
- mkl.h
Description
The routine generates a general
m
-by-n
matrix A
, by pre- and post-
multiplying a real diagonal matrix D
with random
matrices U
and V
:A
:= U
*D
*V
where
U
and V
are orthogonal for real flavors and unitary for complex flavors. The lower and upper bandwidths may then be
reduced to kl
and ku
by additional orthogonal transformations.
Input Parameters
A
<datatype>
placeholder, if present, is used for the C interface data types in the C interface section above. See
C Interface Conventions
for the C interface principal conventions and type definitions.
- m
- The number of rows of the matrixA().m≥0
- n
- The number of columns of the matrixA().n≥0
- kl
- The number of nonzero subdiagonals within the band ofA(0.≤kl≤m-1)
- ku
- The number of nonzero superdiagonals within the band ofA(0.≤ku≤n-1)
- d
- The arraydwith the dimension of (min() contains the diagonal elements of the diagonal matrixm,n)D.
- lda
- The leading dimension of the arraya()lda≥mfor column major layout and (.) for row major layoutlda≥n
- iseed
- The arrayiseedwith the dimension of 4 contains the seed of the random number generator. The elements must be between 0 and 4095 andiseedmust be odd.
Output Parameters
- a
- The arrayawith sizeat least max(1,contains the generatedlda*n) for column major layout and max(1,lda*m) for row major layoutm-by-nmatrixA.
- iseed
- The arrayiseedcontains the updated seed on exit.
Return Values
This function returns a value
info
.If , the execution is successful.
info
= 0If , the
info
< 0i
-th parameter had an illegal value.If , memory allocation error occurred.
info
= -1011