XYPEAK / XYPLOT / XYPUNCH

I/O Options Entry

XYPEAK - XYPLOT - XYPUNCH - Output Request

Description

The XYPEAK, XYPLOT, and XYPUNCH commands can be used in the I/O Options section to request output from a random response analysis. The XYPUNCH command can also be used with the RESPONSE plot-type to request .pch file output from a frequency response analysis.

Format

operation, curve-type, plot-type / entity ID(item code) list

Argument	Options	Description
operation	<XYPEAK, XYPLOT, XYPUNCH> No default	XYPEAK:	Generates a .peak file containing a summary of the requested output for random response analysis.
		XYPLOT:	Generates a HyperGraph session file and related data files for the requested output for random response analysis.
		XYPUNCH:	Generates a .pch file for the requested output for random response analysis. With the plot-type RESPONSE, this command can also be used to generate .pch file output for frequency response analysis.

curve-type	<DISP, VELO, ACCE, FORCE, STRESS, STRAIN> No default	DISP:	Requests output for displacement.
		VELO:	Requests output for velocity.
		ACCE:	Requests output for acceleration.
		FORCE:	Requests output for force. For plot-type RESPONSE: CBUSH and CELAS elements only. For plot-type PSDF: CBUSH, CVISC, CDAMP, and CELAS elements only.
		STRESS:	Requests output for element stress. For plot-types PSDF and AUTO.
		STRAIN:	Requests output for element strain. For plot-types PSDF and AUTO.

plot-type	<PSDF, AUTO, RESPONSE> No default	PSDF:		Requests power spectral density function for random response analysis (Comment 5).
		AUTO:		Requests autocorrelation for random response analysis.
		RESPONSE:		Requests time or frequency in SORT2 format or grid identification numbers in SORT1 format. RESPONSE is only supported for the XYPUNCH operation for frequency response analysis.

entity ID (item code) list	List of grid or element, component pairs. The list must come after a slash "/". Each entry in the list is comma separated. No default	GRID:		Each entry consists of a GRID or SPOINT ID followed by a component of motion (T1, T2, T3, R1, R2, or R3) in parentheses. In the components of motion, T signifies translation and R signifies rotation while the numbers indicate the translational direction or rotational axis. For frequency response analyses, the components of motion are T1RM, T2RM, T3RM, T1IP, T2IP, T3IP, R1RM, R2RM, R3RM, R1IP, R2IP, and R3IP, where RM signifies Real or Magnitude and IP signifies Imaginary or Phase. The type of the response depends on a preceding output request. For SPOINTs, the component must be T1, T1RM, or T1IP.
		ELEMENT:		For elements, the item code (number code only) represents a component of the element stress/ strain, which is described in DRESP1 – Frequency Response Stress/Strain Item Codes and DRESP1 –_Frequency Response Force Item Codes.

XYPLOT, XYPEAK, VELO, PSDF / 3(T2), 6(T2)

XYPEAK, DISP, AUTO / 223(T3)

XYPEAK, XYPLOT, XYPUNCH, ACCE, PSDF / 8(T1), 9(T1), 8(T2), 9(T2)

Comments

1.	Unlike other output requests, XYPEAK, XYPLOT, and XYPUNCH may be combined on a single line (as shown in the example above).

2.	If the XYPEAK, XYPLOT, or XYPUNCH commands are not supplied, no random response results will be output.

3.	If the XYPEAK, XYPLOT, or XYPUNCH commands are supplied, but with an incomplete definition, an error termination will occur.

4.	For complex results, the format of XYPUNCH output (Real/Imaginary or Phase/Magnitude) is determined by the relevant result output request (ACCELERATION, DISPLACEMENT, STRESS, STRAIN, FORCE or VELOCITY). Real/Imaginary is the default if not otherwise indicated.

Multiple RANDOM subcase information entries with non-unique ID’s are allowed in a single model. Therefore, if the plot-type field is set to PSDF, the RANDOM ID will be added to the XYPUNCH headers in the corresponding result sections of the .pch file when multiple RANDOM entries are present in the same deck. If only one RANDOM entry is present, the RANDOM ID is not printed.