DISPLACEMENT

I/O Options and Subcase Information Entry Used to request displacement vector output for all subcases or individual subcases, respectively.

Attention: Valid for Implicit and Explicit Analysis

It can also be used to request electric potential output for Structural Analysis with piezoelectric materials. For more information, refer to Piezoelectric Analysis in the User Guide.

Format

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, SUBSYS, NLOUT) = option

Definitions

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. SORT1 Results for each frequency/ timestep are grouped together. SORT2 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>	HM Results are output in HyperMesh results format (.res file). H3D Results are output in Hyper3D format (.h3d file). OPTI Results are output in OptiStruct results format (.disp file). The results can be printed in the old or new OPTI format depending on the analysis type. For more information, refer to PARAM, OPTI. PUNCH Results are output in Nastran punch results format (.pch file). OP2 Results are output in Nastran output2 format (.op2 file). 12 PATRAN Results are output in Patran format (multiple files). HG Results are output in HyperGraph presentation format (_freq.mvw file and _tran.mvw file) - see OUTPUT keywords HGFREQ and HGTRANS. APATRAN Results are output in Alternative Patran format (multiple files). PLOT 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. HDF5 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.
`form`	<COMPLEX, REAL, IMAG, PHASE, BOTH> 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. REAL or IMAG Provides rectangular format (real and imaginary) of complex output. 10 PHASE 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>	ROTA 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 PSDF Requests PSD and RMS results from Random Response Analysis to be output. RMS Requests only the RMS result from random response analysis to be output. PSDFC 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	MODAL 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	NODAL 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. FREQ Frequency domain. 13 TIME Time domain. 13
`complex eigenvalue analysis` 20	<UNSTABLE>	Displacement results UNSTABLE From the unstable modes (only) of a Complex Eigenvalue Analysis are output. blank (Default) Are output for all modes by default. 1
`type`	<NORMAL>	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.
`TM`,`T1`,`T2`,`T3` `RM`,`R1`,`R2`,`R3`	<f> Real > 0.0 Default = blank	`TM` Displacement is output for the grids with translation magnitude greater than `TM`, then `T1`, `T2` and `T3` are ignored. 17 `T1`,`T2`,`T3` Displacement is output for the grids with absolute value of translation components greater than `T1`, `T2` or `T3`, respectively. 17 `RM` Displacement is output for the grids with rotational magnitude greater than `RM`, then `R1`, `R2` and `R3` are ignored. 17 `R1`,`R2`,`R3` Displacement is output for the grids with absolute value of rotational components greater than `R1`, `R2` or `R3`, respectively. 17
`kpi`	<KPI> Default = blank	KPI 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 STATIS Displacement Statistics are output in addition to regular displacement output at each timestep. OSTATIS Only the Displacement Statistics are output. blank (Default)
`SUBSYS`	<`SUBSYS_ID`> No default	ID of the subsystem. When used along a subsystem definition, this option generates an individual result file for each subsystem with results for that subsystem only. For more information, refer to the SET Bulk Data Entry.
`NLOUT`	<NLOUT ID> No default	ID of the NLOUT Bulk Data Entry. For more information, refer to Comment 3 in the NLOUT Bulk Data Entry.
`option`	<YES, ALL, NO, NONE, SID> Default = ALL	YES, ALL, blank Displacement is output for all grids. NO, NONE Displacement is not output. SID If a set ID is given, displacement is output only for grids listed in that set.

Comments

When DISPLACEMENT command is not present, displacement is output for all grids for all subcases, except for frequency response subcases.
The form argument is only applicable for Frequency Response Analysis. It is ignored for other analysis types.
The forms BOTH and COMPLEX do not apply to the .frf output files.
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.
Multiple instances of this card are allowed. If instances are conflicting, the last instance dominates.
For optimization, the frequency of output to a given format is controlled by the I/O option OUTPUT.
Rotation results are output in radians.
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.
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.
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.
The four-letter abbreviation DISP is interchangeable with DISPLACEMENT.
format=OUTPUT2 can also be used to request results to be output in the Nastran output2 format (.op2 file).
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.
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.
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).
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.
Displacement output filters are supported for static and buckling analysis in H3D and PUNCH formats.
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.
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.

Statistics

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.
In aeroelastic divergence analysis with multiple Mach numbers, only H3D output is available.
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.