Appendix A: Results Neutral File Format

The result neutral file system is the primary interface for graphical processing of model results data. The file system is also used for:
  • Source of expanded model results output.
  • Input file for results limits search via the RESULTLIMITS Case Control command.
  • Input file for automated SET entry generation via the SETGENERATE Case Control command.

The results neutral file system consists of eight types of files, each generated by the Results Processor. A specific Model Initialization directive as shown below controls output of each type:

File Type Model Initialization Directive Default Neutral Filename
Grid Point Displacement Vector DISPFILE = [d:] [path] filename[.ext]

model output filename.DIS

Grid Point Force Vector FORCFILE = [d:] [path] filename[.ext]

model output filename.GPF

Element Internal Load Vector LOADFILE = [d:] [path] filename[.ext]

model output filename.ELF

Element Results ELEMFILE = [d:] [path] filename[.ext]

model output filename.ELS

Grid Point Results GRIDFILE = [d:] [path] filename[.ext]

model output filename.GPS

Femap Results Defined by DISPFILE

model output filename.NEU

model output filename.FNO

NASTRAN Binary Results Defined by DISPFILE

model output filename.OP2

NASTRAN ASCII Results Defined by MODLOUTFILE

model output filename.PCH

The DISPFILE, FORCFILE, LOADFILE, ELEMFILE, and GRIDFILE directives control the filenames and whether a file is to be generated. Setting a specific directive equal to the character variable NONE will disable output of that neutral file type.

Another useful Model Initialization directive is RSLTFILETYPE which controls file type and format. When RSLTFILETYPE is set to FEMAPASCII or FEMAPBINARY, a single Femap® compatible results neutral file of the entire results database is generated. When RSLTFILETYPE is set to PATRANASCII or PATRANBINARY, multiple PATRAN 2.5 compatible results neutral files are generated. PATRAN results neutral files have a two digit subcase number added to the base of the filename to facilitate multiple subcases. When RSLTFILETYPE is set to NASTRANBINARY, a single NASTRAN Output 2 compatible results file of the entire results database is generated.

When RSLTFILETYPE is set to FEMAPBINARY and the INRCRSLTOUT directive is set to ON, a separate Femap binary results neutral file will be generated for each load increment or time step. At the end of the analysis a single neutral file with all steps will be generated.

For a detailed description of each directive see Section 2, Initialization.

Results Neutral File Descriptions

Grid Point Displacement Vector

The Grid Point Displacement Vector Neutral File contains the calculated displacement vector at each grid point in the basic coordinate system. There are six columns where the first three are the x, y, and z components of translation and the last 3 are the x, y, and z components of rotation.

The ASCII formatted version has the following structure:

Record 1: TITLE (A80)
Record 2: NGRID, MAXGID, MAXDISP, MAXDISPGID, NDISPVECTCOL (2I8, E15.6, 2I8)
Record 3: SUBTITLE (A80)
Record 4: LABEL (A80)
Record 5 to NGRID+4: GRIDID, (DISPVECT(COL), COL=1, NDISPVECTCOL) (I8, (5E13.7))

The binary unformatted version has the following structure:

Record 1: TITLE, NGRID, MAXGID, MAXDISP, MAXDISPGID, NDISPVECTCOL
Record 2: SUBTITLE
Record 3: LABEL
Record 4 to NGRID+3: GRIDID, (DISPVECT(COL), COL=1, NDISPVECTCOL)

Where,

TITLE The set title CHAR80
SUBTITLE The set subtitle CHAR80
LABEL The set label CHAR80
NGRID Number of grid points INT4
MAXGID Largest grid point ID INT4
MAXDISP Maximum absolute displacement REAL4
MAXDISPGID Grid point ID where the maximum displacement occurs INT4
NDISPVECTCOL The number of displacement vector components or columns (6) INT4
GRIDID Grid point ID number INT4
DISPVECT Displacement vector component values at GRIDID REAL4

Grid Point Force Vector

The Grid Point Force Vector Neutral File contains the calculated internal, applied and reacted force vector at each grid point in the basic coordinate system. The internal force vector is the resultant of all internal forces at the grid point. For transient response solutions, acceleration and velocity is also included in this file.

The ASCII formatted version has the following structure:

Record 1: TITLE (A80)
Record 2: NGRID, MAXGID, MAXVECT, MAXVECTGID, NFORCVECTCOL (2I8, E15.6, 2I8)
Record 3: SUBTITLE (A80)
Record 4: LABEL (A80)
Record 5 to NGRID+4: GRIDID, (FORCVECT(COL), COL=1, NFORCVECTCOL) (I8, (5E13.7))

The binary unformatted version has the following structure:

Record 1: TITLE, NGRID, MAXGID, MAXVECT, MAXVECTGID, NFORCVECTCOL
Record 2: SUBTITLE
Record 3: LABEL
Record 4 to NGRID+3: GRIDID, (FORCVECT(COL), COL=1, NFORCVECTCOL)

Where,

TITLE Set title CHAR80
SUBTITLE Set subtitle CHAR80
LABEL Set label CHAR80
NGRID Number of grid points INT4
MAXGID Largest grid point ID INT4
MAXVECT Maximum absolute vector value REAL4
MAXVECTGID Grid point ID where the maximum value occurs INT4
NFORCVECTCOL The number of force vector components or columns INT4
GRIDID Grid point ID number INT4
FORCVECT Force vector component values at GRIDID (internal force, applied force, SPC force, MPC force, velocity, and acceleration) REAL4

Element Internal Load Vector

The Element Internal Load Vector Neutral File contains the calculated element internal forces at each node in the basic coordinate system.

The binary unformatted version has the following structure:

Record 1: TITLE, NLOADVECTCOL
Record 2: SUBTITLE
Record 3: LABEL
Record 4 to NELEM+3: ELEMID, ELEMTYPE, (LOADVECT(COL), COL=1, NLOADVECTCOL)

Where,

TITLE Set title CHAR80
SUBTITLE Set subtitle CHAR80
LABEL Set label CHAR80
NLOADVECTCOL The number of load vector components or columns INT4
ELEMID Element ID number INT4
ELEMTYPE Element type code INT4
LOADVECT Load vector component values at ELEMID REAL4

Element Results

The Element Results Neutral File contains various result types calculated at requested points on the element in a user-specified coordinate system. The coordinate system for shell element results is specified using the Case Control command SURFACE and solid element results using the Case Control command VOLUME (see SURFACE and VOLUME in Section 3, Case Control). Shell and solid elements that do not have a coordinate system defined via a SURFACE or VOLUME command will not be included. The default SURFACE is all shell elements in the element coordinate system. The default VOLUME is all solid elements in the element coordinate system. The default SURFACE/VOLUME coordinate system can be changed using the ELEMRSLTCORD parameter (see ELEMRSLTCORD in Section 5, Parameters). Composite shell element ply results will not be included in PARAM, NOCOMPS, -1 is included in the Model Input File (see NOCOMPS in Section 5, Parameters).

The ASCII formatted version has the following structure:

Record 1: TITLE (A80)
Record 2: NELEMVECTCOL (I8)
Record 3: SUBTITLE (A80)
Record 4: LABEL (A80)
Record 5 to NELEM+4: ELEMID, ELEMTYPE, (ELEMVECT(COL), COL=1, NELEMVECTCOL) (2I8, /, (6E13.7))

The uncompressed binary unformatted version (RSLTFILECOMP directive set to OFF) has the following structure:

Record 1: TITLE, NELEMVECTCOL
Record 2: SUBTITLE
Record 3: LABEL
Record 4 to NELEM+3: ELEMID, ELEMTYPE, (ELEMVECT(COL), COL=1, NELEMVECTCOL)

The compressed binary unformatted version (RSLTFILECOMP directive set to ON) has the following structure:

Record 1: TITLE, NELEMVECTCOL
Record 2: SUBTITLE
Record 3: LABEL
Record 4 to NELEM+3: ELEMID, ELEMTYPE, NCOL, (ELEMVECTP(COL), COL=1, NCOL), (ELEMVECTC(COL), COL=1, NCOL)

Where,

TITLE Set title CHAR80
SUBTITLE Set subtitle CHAR80
LABEL Set label CHAR80
NELEMVECTCOL The number of load vector components or columns INT4
ELEMID Element ID number INT4
ELEMTYPE Element type code INT4
ELEMVECT Element vector component values at ELEMID REAL4
NCOL The number of non-zero element vector component values at ELEMID INT4
ELEMVECTP Non-zero element vector component value locations at ELEMID INT4
ELEMVECTC Non-zero element vector component values at ELEMID REAL4

Grid Point Results

The Grid Point Results Neutral File contains various result types calculated at the grid points in a user-specified coordinate system. The coordinate system for shell element results is specified using the Case Control command SURFACE and solid element results using the Case Control command VOLUME (see SURFACE and VOLUME in Section 3, Case Control). Grid points connected to shell and solid elements that do not have a coordinate system defined via a SURFACE or VOLUME command will not be included.

The ASCII formatted version has the following structure:

Record 1: TITLE (A80)
Record 2: NGRID, MAXGID, MAXVECT, MAXVECTGID, NGRIDVECTCOL (2I8, E15.6, 2I8)
Record 3: SUBTITLE (A80)
Record 4: LABEL (A80)
Record 5 to NGRID+4: GRIDID, (GRIDVECT(COL), COL=1, NGRIDVECTCOL) (I8, (5E13.7))

The binary unformatted version has the following structure:

Record 1: TITLE, NGRID, MAXGID, MAXVECT, MAXVECTGID, NGRIDVECTCOL
Record 2: SUBTITLE
Record 3: LABEL
Record 4 to NGRID+3: GRIDID, (GRIDVECT(COL), COL=1, NGRIDVECTCOL)

Where,

TITLE Set title CHAR80
SUBTITLE Set subtitle CHAR80
LABEL Set label CHAR80
NGRID Number of grid points INT4
MAXGID Largest grid point ID INT4
MAXVECT Maximum absolute vector value REAL4
MAXVECTGID Grid point ID where the maximum value occurs INT4
NGRIDVECTCOL The number of force vector components or columns INT4
GRIDID Grid point ID number INT4
GRIDVECT Grid point vector component values at GRIDID REAL4