*DMAT

*DMAT, Matrix, Type, Method, Val1, Val2, Val3, Val4, Val5
Creates a dense matrix.

APDL: Matrix Operations

Argument Descriptions

Matrix

Name used to identify the matrix. Must be specified.

Type

Matrix type:

D --: Double precision real values (default).
Z --: Complex double precision values.
I --: Integer values.

Method

Method used to create the matrix:

ALLOC --: Allocate space for a matrix (default).
RESIZE --: Resize an existing matrix to new row and column dimensions. Values are kept from the original matrix. If the dimensions specified by Val1 (rows) and Val2 (columns) are greater than the original matrix size, the additional entries are assigned a value of zero.
COPY --: Copy an existing matrix.
LINK --: Link to an existing matrix. The memory will be shared between the original matrix and the new matrix. This is useful for manipulating a submatrix of a larger matrix. The Val1 through Val5 arguments will be used to specify the lower and upper bounds of row and column numbers from the original matrix.
IMPORT --: Import the matrix from a file.

Val1, Val2, Val3, Val4, Val5

Additional input. The meaning of Val1 through Val5 will vary depending on the specified Method. See details below.

The following Valx fields are used with Method = ALLOC or Method = RESIZE:

Val1

Number of rows in the matrix.

Val2

Number of columns in the matrix.

Val3

Memory allocation type (used only with Method = ALLOC):

INCORE --: In-core memory allocation (default).
OUTOFCORE --: Out-of-core memory allocation.

The following Valx fields are used with Method = COPY:

Val1

Name of the matrix to copy.

Val2

Method used for copying the matrix:

TRANS --: Transpose the original matrix. Val3 and Val4 are ignored.
REAL --: Copy the real part to the output matrix. This option only applies when copying a complex value matrix to a real value matrix. Val3 and Val4 are ignored.
IMAG --: Copy the imaginary part to the output matrix. This option only applies when copying a complex value matrix to a real value matrix. Val3 and Val4 are ignored.
EXTRACT --: Extract a submatrix based on row and column numbers specified by Val3 and Val4.

Val3

Name of integer vector (*VEC) containing row numbers. If no vector is specified, defaults to all rows.

Val4

Name of integer vector (*VEC) containing column numbers. If no vector is specified, defaults to all columns.

The following Valx fields are used with Method = LINK:

Val1: Name of the original matrix.
Val2: First column number (defaults to 1).
Val3: Last column number (defaults to the maximum column number of the original matrix).
Val4: First row number (defaults to 1).
Val5: Last row number (defaults to the maximum row number of the original matrix).

The following table describes the Valx fields used with Method = IMPORT:

Method = IMPORT

Val1 Val2 Val3 Val4 Val5 Description

FULL

File name

Matrix type:

STIFF - Stiffness matrix

MASS - Mass matrix

DAMP - Damping matrix

RHS - Load vector

K_RE - Real part of the stiffness matrix

K_IM - Imaginary part of the stiffness matrix

(not used)

Import a matrix or load vector from an existing FULL file.

For a complex stiffness matrix, you can use the K_RE or K_IM label to import only the real part or only the imaginary part. The K_RE and K_IM options both create real matrices.

MODE File name First mode number Last mode number (not used) Import a set of modes from an existing MODE file.

CMS

File name

Mode type:

NOR - Normal modes

IRF - Inertial relief modes

CST - Constraint modes

RSD - Residual modes

(not used)

Import a modal basis from an existing CMS file.

TCMS

File name

Mode type:

NOR - Normal modes

IRF - Inertial relief modes

CST - Constraint modes

(not used)

Import a modal basis from an existing TCMS file.

RST

File name

First data set number

Last data set number

Result Type:

NSL - Nodal Solution

VSL - Transient velocity solution

ASL - Transient acceleration solution

RF - Reaction Forces

Import degree of freedom results from an existing RST file.

SUB

File name

Matrix type:

STIFF - Stiffness (or conductivity) matrix

MASS - Mass (or specific heat) matrix

DAMP - Damping matrix

RHS - Load vector

(not used)

Import a matrix or load vector from an existing SUB file.

HBMAT

File name

File format:

ASCII

BINARY

(not used)

Import a matrix from an existing Harwell-Boeing format file.

EMAT

File name

Matrix type:

STIFF - Stiffness matrix

MASS - Mass matrix

DAMP - Damping matrix

STRESS - Stress-stiffness matrix

RHS - Load vector

Element number

(not used)

Import an element matrix or load vector from an existing EMAT file.

MAT File name (not used) (not used) (not used) Restore from a previous *EXPORT (FORMAT = MAT) command.

APDL Array parameter name (not used) (not used) (not used) Import an existing array parameter.

RFRQ

File name

STF - Reduced Stiffness matrix

MAS - Reduced Mass matrix

DMP - Reduced Damping matix

(not used)

Import reduced matrices from a .RFRQ ANSYS file.

MMF File name (not used) (not used) (not used) Import a dense matrix from an existing Matrix Market file.

DMIG

File name

- Separator character (default=blank)

- or ‘F’ means formatted file (see "Notes")

If Val3 == ‘F’, length of the fields

(not used)

Import a matrix from an existing Nastran DMIG file.

Notes

This command allows you to create a dense matrix. To create a sparse matrix, use the *SMAT command. *SMAT is recommended for large matrices obtained from the .FULL or .HBMAT file. Refer to the HBMAT command documentation for more information about .FULL file contents.

Use the *VEC command to create a vector.

For very large matrices, use the OUTOFCORE option (Method = ALLOC or COPY) to keep some of the matrix on disk if there is insufficient memory.

When importing a dense matrix from a DMIG file, you can define the formatting of the file using the Val3 and Val4 fields. Here are a few different example of formats:

A formatted file (using Val3=’F’, and Val4=8):

...
DMIG*   KAAX                          21               2
*                     21               1-2.261491337E+08
...

A non-formatted file with blank separators:

...
DMIG stiff 1 2 1 2 29988.
1 6 149940. 2 2 -29988.
2 6 149940.
...

A non-formatted file with a comma separator (using Val3=’,’):

...
DMIG,KF,22321,3,,22321,2,-5.00E+6
DMIG,KF,22320,3,,22320,2,-5.00E+6
...

Menu Paths

This command cannot be accessed from a menu.