DISPLACEMENT

I/O Options and Subcase Information Entry

DISPLACEMENT - Output Request

Description

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.

Format

DISPLACEMENT (sorting,format,form,rotations,random,peakoutput,modal,fourier,complex eigenvalue analysis,type) = option

Argument	Options		Description
sorting	<SORT1, SORT2> Default = blank		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 (Comment 9).
			blank:	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, blank> Default = 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).
			PUNCH:	Results are output in Nastran punch results format (.pch file).
			OP2:	Results are output in Nastran output2 format (.op2 file) (Comment 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. 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.
			blank:	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 (Comment 10).
		PHASE:			Provides polar format (magnitude and phase) of complex output. Phase output is in degrees (Comment 10).
		BOTH (HM only):			Provides both polar and rectangular formats of complex output.

rotations	<ROTA, NOROTA> Default = 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.
rotations	<ROTA, NOROTA> Default = NOROTA	NOROTA:			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> No default	PSDF:			Requests PSD and RMS results from random response analysis to be output. Only valid for the H3D format. The "RMS over Frequencies" output is at the end of the Random results.
random	<PSDF, RMS> No default	RMS:			Requests only the “RMS over Frequencies” result from random response analysis to be output. Valid only for the H3D format.

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

modal	<MODAL> Default = Blank	MODAL:			If MODAL is present, displacements of the structural modes and residual vectors are output to the H3D, PUNCH and OUTPUT2 files for modal frequency response and transient analysis.

fourier	<FOURIER> Default = Blank	FREQ:			If FREQ is present, displacements in the frequency domain are output for modal transient response analysis with Fourier transformation (Comment 13).
fourier	<FOURIER> Default = Blank	TIME:			If TIME is present, displacements in the time domain are output for modal transient response analysis with Fourier transformation (Comment 13).

complex eigenvalue analysis	<UNSTABLE> Default = blank	UNSTABLE:			If present, the displacement results from the unstable modes (only) of a complex eigenvalue analysis are output.
complex eigenvalue analysis	<UNSTABLE> Default = blank	blank:			Displacement results are output for all modes by default (Comment 1).

type	<NORMAL> Default = blank	NORMAL:			If present, the normal displacement results for grids on the surface of shell and solid elements are output (Comment 14). This is only available for Frequency Response Analysis.
type	<NORMAL> Default = blank	Blank:			Normal displacement results are not output.

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

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.

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 for information on which results are available in which 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.

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 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.