XYPEAK / XYPLOT / XYPUNCH

I/O Options EntryThe 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

Examples

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)

Definitions

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. 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.
Integer number could be used alternatively. 6
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.

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.
  5. Multiple RANDOM subcase information entries with non-unique IDs 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.
  6. Item codes for GRID response.
    Number Code ASCII Code Number Code ASCII Code
    1 T1/T1RM 11 T1IP
    2 T2/T2RM 12 T2IP
    3 T3/T3RM 13 T3IP
    4 R1/R1RM 14 R1IP
    5 R2/R2RM 15 R2IP
    6 R3/R3RM 16 R3IP