DLATMR/ZLATMR Description:
(from LAPACK documentation)
DLATMR/ZLATMR generates random matrices of various types
for testing LAPACK programs by applying the following sequence of
operations:
Alternately, you may generate a sample Fortran driver based on your input by pressing the Generate Sample Driver button.
![]() | SUBROUTINE xLATMR | ( M, N, DIST, ISEED, SYM, D, MODE, COND, DMAX, |
RSIGN, GRADE, DL, MODEL, CONDL, DR, MODER, | ||
CONDR, PIVTNG, IPIVOT, KL, KU, SPARSE, ANORM, | ||
PACK, A, LDA, IWORK, INFO ) |
FIELD![]() | 'D' = double precision 'Z' = double precision complex | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Parameters: | |||||||||||||||||
M![]() | The number of rows of A: ( 1 <= M <= 250 ) | ||||||||||||||||
N![]() | The number of columns of A: ( 1 <= N <= 250 ) | ||||||||||||||||
DIST![]() |
Type of distribution to be used to generate a random matrix:
'S' = Uniform (-1, 1) 'U' = Uniform ( 0, 1) 'N' = Normal ( 0, 1) | ||||||||||||||||
ISEED![]() |
Calculate random seed values User specified seed values: (If specifying, choose integers between 0 and 4095 inclusive with ISEED(4) odd.) | ||||||||||||||||
SYM![]() |
Symmetry of generated matrix:
'S' = Symmetric 'H' = Hermitian 'N' = Nonsymmetric If SYM is 'S' or 'H', storage may be reduced by half by only storing lower triangular entries. See parameter 'PACK'. | ||||||||||||||||
D![]() | Diagonal entries. (Disabled) | ||||||||||||||||
MODE![]() |
Diagonal selection: (MODE = 0 (diagonal input) is disabled)
| ||||||||||||||||
COND![]() |
Parameter for diagonal selection (above):
(if used, must be >= 1) | ||||||||||||||||
DMAX![]() |
Scaling factor for diagonal selection:
(for COMPLEX matrices, enter two values: real and imaginary parts) If MODE is neither -6, 0 nor 6, the diagonal is scaled by DMAX / max(abs(D(I))), so that maximum absolute entry of diagonal is abs(DMAX). If DMAX is negative (or zero), diagonal will be scaled by a negative number (or zero). | ||||||||||||||||
RSIGN![]() | Multiply, or do NOT multiply diagonal by random sign | ||||||||||||||||
GRADE![]() |
'N' = No grading 'L' = diag(DL) · A (for nonsymmetric matrices) 'R' = A · diag(DR) (for nonsymmetric matrices) 'B' = diag(DL) · A · diag(DR) (for nonsymmetric matrices) 'S' = diag(DL) · A · diag(DL) (for symmetric matrices) 'H' = diag(DL) · A · diag(DL) (for Hermitian matrices) 'E' = diag(DL) · A · inv(diag(DL)) (eigenvalue invariance, for nonsymmetric matrices, and M must equal N) | ||||||||||||||||
DL![]() | Left (row) scaling entries. (Disabled) | ||||||||||||||||
MODEL![]() |
Left grading matrix selection: (MODE = 0 (grading input) is disabled)
| ||||||||||||||||
CONDL![]() |
Parameter for left grading selection (above):
(if used, must be >= 1) | ||||||||||||||||
DR![]() | Right (column) scaling entries. (Disabled) | ||||||||||||||||
MODER![]() |
Right grading matrix selection: (MODE = 0 (grading input) is disabled)
| ||||||||||||||||
CONDR![]() |
Parameter for right grading selection (above):
(if used, must be >= 1) | ||||||||||||||||
PIVTNG![]() |
Specify the pivoting permutations. (Disabled) | ||||||||||||||||
IPIVOT![]() |
Pivot vector entries. (Disabled) | ||||||||||||||||
KL![]() |
Lower bandwidth:
For example, KL=0 implies upper triangular, KL=1 implies upper Hessenberg, and KL at least M-1 implies the matrix is not banded. Must equal KU if matrix is symmetric. If left blank, M-1 will be assumed (unless overridden by specified KL with symmetry). | ||||||||||||||||
KU![]() |
Upper bandwidth:
For example, KU=0 implies lower triangular, KU=1 implies lower Hessenberg, and KU at least N-1 implies the matrix is not banded. Must equal KL if matrix is symmetric. If left blank, N-1 will be assumed (unless overridden by specified KU with symmetry). | ||||||||||||||||
SPARSE![]() |
The degree of sparsity of the matrix (from 0.0 to 1.0, where 0.0 implies dense): (0.0 will be assumed if left blank). This interface allows for data to be returned in Matrix Market coordinate format. Check here to select coordinate storage (recommended when SPARSE > .6). ANORM | ![]()
Scale output matrix so that the maximum entry is:
| Do not scale output matrix PACK | ![]()
Matrix packing: (several packing options disabled) | 'R' = Symmetric storage (lower triangle) 'N' = No packing A | ![]()
Returned matrix data. (Disabled)
| LDA | ![]()
Leading dimension of A. (Disabled)
| IWORK | ![]()
Integer workspace of dimension M or N. (Disabled)
| INFO | ![]()
Return code. (Disabled)
| |
[ Home ] [ Search ] [ Browse ] [ Resources ] [ XLATMR ]
Last change in this page: Mon Apr 14 18:24:02 US/Eastern 1997 [ ]