I/O Options and Subcase Information Entry The DISPLACEMENT command can be used in the I/O Options or Subcase Information sections to request displacement vector output for all subcases or individual subcases, respectively.


DISPLACEMENT (sorting, format, form, rotations, random, peakoutput, modal, nodal, fourier, complex eigenvalue analysis, type, TM=f, T1=f, T2=f, T3=f, RM=f, R1=f, R2=f, R3=f, kpi,statistics) = option


Argument Options Description
sorting <SORT1, SORT2> This argument only applies to the PUNCH format (.pch file) or the OUTPUT2 format (.op2 file) output for Frequency Response and Transient Analysis subcases. It will be ignored without warning if used elsewhere.
Results for each frequency/ timestep are grouped together.
Results for each grid/element are grouped together. 9
blank (Default)
For Frequency Response Analysis, if grid SET is not specified, SORT1 is used, otherwise, SORT2 is used; for Transient Analysis, SORT2 is used.
format <HM, H3D, OPTI, PUNCH, OP2, PATRAN, HG, APATRAN, PLOT, HDF5, blank>
Results are output in HyperMesh results format (.res file).
Results are output in Hyper3D format (.h3d file).
Results are output in OptiStruct results format (.disp file).
Results are output in Nastran punch results format (.pch file).
Results are output in Nastran output2 format (.op2 file). 12
Results are output in Patran format (multiple files).
Results are output in HyperGraph presentation format (_freq.mvw file and _tran.mvw file) - see OUTPUT keywords HGFREQ and HGTRANS.
Results are output in Alternative Patran format (multiple files).
Results are output in Nastran output2 format (.op2 file) when PARAM,POST is defined in the Bulk Data section. 15
If PARAM,POST is not defined in the Bulk Data section, this format allows the form for complex results to be defined for XYPUNCH output without having other output.
Results are output in the Hierarchical Data format, Version 5 (.h5 file). 16
blank (Default)
Results are output in all active formats for which the result is available.

Default (HM only) = COMPLEX

Default (all other formats) = REAL

COMPLEX (HM only), blank
Provides a combined magnitude/phase form of complex output to the .res file for the HyperMesh output format.
Provides rectangular format (real and imaginary) of complex output. 10
Provides polar format (magnitude and phase) of complex output. Phase output is in degrees. 10
BOTH (HM only)
Provides both polar and rectangular formats of complex output.
rotations <ROTA, NOROTA>
Rotational displacement results are output. Only works with H3D and HM output streams. Rotations are always output with translations for other output streams.
NOROTA (Default)
Rotational displacement results are not output. Only works with H3D and HM output streams. Rotations are always output with translations for other output streams.
random <PSDF, RMS, PSDFC>

No default

Output is available in the .h3d and .h5 formats. 4
Requests PSD and RMS results from Random Response Analysis to be output.
Requests only the RMS result from random response analysis to be output.
Requests PSD, RMS and RMS (cumulative) results from random response analysis to be output.
peakoutput <PEAKOUT>

Default = blank

If peakoutput is present, only the filtered frequencies from the PEAKOUT card will be considered for this output.
modal <MODAL>

Default = blank

Displacements of the structural modes and residual vectors are output to the H3D, PUNCH and OUTPUT2 files for Modal Frequency Response and Transient Analysis.
If only MODAL is present, then the results of the corresponding Frequency Response and Transient Analysis runs are not output. If both Modal results and corresponding FRF and Transient results are required, then NODAL option can be defined along with MODAL. 21
nodal <NODAL>

Default = blank

Displacements of the Frequency Response and Transient Analysis are output to the H3D, PUNCH, and OUTPUT2 files even if the MODAL option is present. If MODAL option is present in addition to NODAL option, then displacements of the Frequency Response and Transient Analysis are output along with the structural modes and residual vectors. 21
fourier <FREQ, TIME>

Default = blank

Displacements output for Modal/Direct Transient Response Analysis with Fourier Transformation.
Frequency domain. 13
Time domain. 13
complex eigenvalue analysis 20 <UNSTABLE> Displacement results
From the unstable modes (only) of a Complex Eigenvalue Analysis are output.
blank (Default)
Are output for all modes by default. 1
type <NORMAL>
If present, the normal displacement results for grids on the surface of shell and solid elements are output. 14
This is only available for Frequency Response Analysis.
blank (Default)
Normal displacement results are not output.



Real > 0.0

Default = blank

Displacement is output for the grids with translation magnitude greater than TM, then T1, T2 and T3 are ignored. 17
Displacement is output for the grids with absolute value of translation components greater than T1, T2 or T3, respectively. 17
Displacement is output for the grids with rotational magnitude greater than RM, then R1, R2 and R3 are ignored. 17
Displacement is output for the grids with absolute value of rotational components greater than R1, R2 or R3, respectively. 17
kpi <KPI>

Default = blank

Key Performance Indicators for Displacement results are output in the *.kpi ASCII file. 18
statistics <STATIS, OSTATIS, or blank> Results of Displacement Statistics over time in a Transient Analysis are controlled by this option. 19
Displacement Statistics are output in addition to regular displacement output at each timestep.
Only the Displacement Statistics are output.
blank (Default)
option <YES, ALL, NO, NONE, SID>

Default = ALL

YES, ALL, blank
Displacement is output for all grids.
Displacement is not output.
If a set ID is given, displacement is output only for grids listed in that set.


  1. When DISPLACEMENT command is not present, displacement is output for all grids for all subcases, except for frequency response subcases.
  2. The form argument is only applicable for Frequency Response Analysis. It is ignored for other analysis types.
  3. The forms BOTH and COMPLEX do not apply to the .frf output files.
  4. Multiple formats are allowed on the same entry; these should be comma separated. If a format is not specified, this output control applies to all formats defined by the OUTPUT command, for which the result is available. See Results Output by OptiStruct for information on the results available and their respective formats.
  5. Multiple instances of this card are allowed. If instances are conflicting, the last instance dominates.
  6. For optimization, the frequency of output to a given format is controlled by the I/O option OUTPUT.
  7. Rotation results are output in radians.
  8. For normal modes output, if there is USET U6 data the static residual displacement vectors associated with the USET U6, DOF are also output to the PUNCH, H3D, and OUTPUT2 files.
  9. In general, HyperView does not recognize the SORT2 format for results from the .op2 file. When results are output only in SORT2 format (<Result Keyword> (SORT2, OUTPUT2, ...)), the results are written by OptiStruct into the .op2 file in SORT2 format, but when the .op2 file is imported into HyperView, the results in SORT2 format are not recognized. Therefore, the SORT1 option is recommended for results output in OUTPUT2 format and SORT2 option is recommended for results output in PUNCH format.
  10. Results in binary format (.h3d or .op2) are always output in PHASE/MAG form, regardless of the options specified in the FORM field. The corresponding post-processors (HyperView/HyperGraph) can easily convert the PHASE/MAG format to the required formats. Results in ASCII formats are output in the specified/requested FORM.
  11. The four-letter abbreviation DISP is interchangeable with DISPLACEMENT.
  12. format=OUTPUT2 can also be used to request results to be output in the Nastran output2 format (.op2 file).
  13. The FREQ and TIME options are only valid for Modal/Direct Transient Analysis with Fourier transformation. When FREQ is present, the displacements in frequency domain would be output in a dummy frequency subcase, which shares the same ID with the transient subcase.
  14. For NORMAL displacement output, the surface grids are automatically selected from within the specified GRID SET. Alternately, if option=ALL is input, the normal displacement is output for all surface grids in the model. Normal results are only available for Frequency Response Analysis and in the H3D format.
  15. If DISP(PLOT) is specified in conjunction with PARAM,POST,-1, then the typical default output requests are disabled. Required output can be requested explicitly for such runs (for example, using OUTPUT,H3D).
  16. The HDF5 output is printed to a .h5 binary results file. For details of the supported analysis types and elements when the .h5 output format is requested, refer to the .h5 file.

    For details about the old HDF5 format (.hdf5), refer to PARAM, HDF5 and .hdf5 file.

  17. Displacement output filters are supported for static and buckling analysis in H3D and PUNCH formats.
  18. KPI output includes maximum value for Displacement with respect to the corresponding property. It is supported for linear and nonlinear static analysis only. KPI output can also be output for a particular SET using the SID option.
  19. Displacement Statistics are supported for Direct and Modal Linear Transient Analysis types.

    Only H3D output is supported for Displacement Statistics.

    The following statistics over time are output for Transient Analysis when STATIS or OSTATIS is specified.
    Supported Displacement Result Types
    Minimum and Time of Minimum
    X-component, Y-component, Z-component
    Maximum and Time of Maximum
    Magnitude, X-component, Y-component, Z-component
    Absolute Maximum and Time of Absolute Maximum
    X-component, Y-component, Z-component
    Arithmetic Mean, Root Mean Square (RMS), Variance, and Standard Deviation
    Magnitude, X-component, Y-component, Z-component
    The displacement statistics can be viewed in HyperView after loading the H3D file, under Statistics over time option at the end of the timestep list in the Results Browser. Then, various statistics can be chosen from the sub-menu under Displacement (Statistics) (s).

    Figure 1.
  20. In aeroelastic divergence analysis with multiple Mach numbers, only H3D output is available.
  21. If both MODAL and NODAL options are present, then both eigenvector and frequency/transient response results are output to the H3D, PCH, and OP2 files. The output set IDs should match for both MODAL and NODAL output.

    Figure 2.