*EXPORT

*EXPORT, Matrix, Format, Fname, Val1, Val2, Val3
Exports a matrix to a file in the specified format.

APDL: Matrix Operations

Argument Descriptions

Matrix

Name of the matrix to export (must be a matrix previously created with *DMAT or *SMAT, or a vector previously created with *VEC).

Format

Format of the output file:

MMF --: Export the matrix in the Matrix Market Format.
SUB --: Export the matrix in the SUB file format.
HBMAT --: Export the matrix in the Harwell-Boeing file format.
MAT --: Export the matrix in a native format, to be re-imported using the *DMAT or *SMAT command.
EMAT --: Export the matrix to an existing EMAT file.
APDL --: Export the matrix to an APDL array parameter.
PS --: Export the matrix profile to a Postscript file.
DMIG --: Export the matrix in the DMIG file format.

Fname

Name of the file, or name of the array parameter if Format = APDL.

Val1, Val2, Val3

Additional input. The meaning of Val1 through Val3 will vary depending on the specified Format. See table below for details.

Additional input for Format = SUB, HBMAT, EMAT, APDL, PS, and DMIG

Format Val1 Val2 Val3 Description

SUB

Matrix type:

STIFF - Stiffness (or conductivity) matrix

MASS - Mass (or specific heat) matrix

DAMP - Damping matrix

RHS - Load vector

Matrix containing the row information (see Notes). Not needed if the matrix was imported from an existing SUB or DMIG file.

WAIT

DONE

Identify matrix type to write and specify when to perform the export (see Notes).

HBMAT

File format:

ASCII

BINARY

(not used)

Identify the output format.

EMAT

Matrix type:

STIFF - Stiffness (or conductivity) matrix

MASS - Mass (or specific heat) matrix

DAMP - Damping matrix

STRESS - Stress-stiffness matrix

Element number

(not used)

Identify the matrix type and the element number.

APDL First column Last Column (not used) Block of columns to export.

Color key:

BW - black and white (default)

COLOR - color

(not used)

Identify the output format.

DMIG Matrix containing the row information (see Notes). Not needed if the matrix was imported from an existing SUB or DMIG file. (not used) (not used) Specify the mapping between row number, node, and DOF number.

Notes

Only sparse matrices can be exported to Postscript files. This option plots the matrix profile as a series of dots.

If you want to create a .SUB file from several matrices, you need to set Val3 = WAIT for all matrices but the last, and Val3 = DONE for the last one. The export will be effective at the last *EXPORT command.

To create a .SUB file or .DMIG file from scratch, you must supply the row information array. (Specify this array in the Val2 field for .SUB or in the Val1 field for .DMIG.) This must be an m x 2 array, where m is the size of the matrix. The first column is the node number and the second column is the DOF number corresponding to each row of the matrix.

The *EXPORT command is not applicable to sparse matrices initialized from .FULL files by means of the NOD2BCS option on the *SMAT command (i.e., *SMAT,,,IMPORT,FULL,,NOD2BCS).

Menu Paths

This command cannot be accessed from a menu.