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 [ ]