DMIG – Direct Matrix Input at Points
Defines direct input matrices related to grid points. The matrix is defined by a single header entry and one or more column entries. A column entry is required for each column with non-zero elements.
|
(1) |
(2) |
(3) |
(4) |
(5) |
(6) |
(7) |
(8) |
(9) |
(10) |
|
DMIG |
NAME |
"0" |
IFO |
TIN |
TOUT |
|
|
NCOL |
|
|
(1) |
(2) |
(3) |
(4) |
(5) |
(6) |
(7) |
(8) |
(9) |
(10) |
|
DMIG |
NAME |
GJ |
CJ |
|
G1 |
C1 |
A1 |
|
|
|
|
G2 |
C2 |
A2 |
|
G3 |
|
|
|
|
|
(1) |
(2) |
(3) |
(4) |
(5) |
(6) |
(7) |
(8) |
(9) |
(10) |
|
DMIG |
STIF |
0 |
9 |
1 |
0 |
|
|
2 |
|
|
DMIG |
STIF |
27 |
1 |
|
120 |
3 |
3.+5 |
|
|
|
|
120 |
4 |
2.5+10 |
|
|
|
|
|
|
|
DMIG |
STIF |
28 |
1 |
|
123 |
3 |
6.+7 |
|
|
|
|
123 |
4 |
4.1+8 |
|
|
|
|
|
|
|
Field |
Contents |
|
NAME |
Name of the matrix -- see comment 1. No default (One to eight alphanumeric characters, the first of which is alphabetic) |
|
IFO |
Form of matrix input. No default (6 = Symmetric, 9 = rectangular) |
|
TIN |
Type of matrix being input. No default (1 = Real, single precision (one field is used per element; 2 = Real, double precision (one field is used per element)) |
|
TOUT |
Type of matrix that will be created. Default = 0 (0 = Set by precision system cell) |
|
NCOL |
Number of columns in a rectangular matrix. Must be used when IFO = 9. Not used when IFO = 6. Default = blank (Integer > 0, or blank) |
|
GJ |
Grid point identification number for column index. No default (integer > 0) |
|
CJ |
Component number for grid point GJ. No default (0 < integer < 6) |
|
Gi |
Grid point identification number for row index. No default (integer > 0) |
|
Ci |
Component number for Gi for a grid point. No default (0 < CJ < 6) |
|
Ai |
Real value of a matrix element. No default (Real) |
Matrices may be selected for all solution sequences by the structural matrices before constraints are applied.
The header entry containing IFO, TIN, and TOUT is required. Each no-null column is started with a GJ, CJ pair. The entries for each row of that column follow. Only non-zero terms need be entered. The terms may be input in arbitrary order. A GJ, CJ pair may be entered more than once, but input of an element of the matrix more than once will produce a fatal message.
Field 3 of the header entry must contain an integer 0.
A given off-diagonal element may be input either below or above the diagonal. While upper and lower triangle terms may be mixed, a fatal message will be issued if an element is input both below and above the diagonal.
The matrix names must be unique among all DMIGs.
The recommended format for rectangular matrices requires the use of NCOL and IFO = 9. The number of columns in the matrix is NCOL. (The number of rows in all DMIG matrices is always g-set size). The GJ term is used for the column index. The CJ term is ignored.
When the I/O option SPSYNTAX is set to CHECK (default) or STRICT, it is required for grid/component pairs (G#/C#) that the component be 0 or blank when the grid reference is a scalar point (SPOINT), and that the component be > 1 when the grid reference is a structural grid point (GRID). When SPSYNTAX is set to MIXED, it is allowed for grid/component pairs (G#/C#) that the grid reference be either a scalar point (SPOINT) or a structural grid point (GRID) when the component is 0, 1 or blank; interpreting all of these as 0 for scalar points and as 1 for structural grids. When the component is greater than 1, the grid reference must always be a structural grid (GRID).
Go To
Guidelines for Bulk Data Entries
Alphabetical List of Bulk Data Entries