FORMAT - Output Control
Description
The FORMAT command can be used in the I/O Options section to indicate the format in which results are to be output.
Format
FORMAT = option
Argument Options Description
option <ASCII, OS, OPTI, HM, HYPER, BOTH, H3D, FLX, NASTRAN, PUNCH, PATRAN, APATRAN, O2, OUT2, OP2, PLOT, NONE>
Default = FLX
OPTI, OS, ASCII: OptiStruct ASCII results files are output.
HM, HYPER: The HyperMesh binary
results file (.res file) is output.
BOTH: Same as defining both HM
and OPTI.
H3D: Hyper3D binary results file
(.h3d file) and an HTML report (.html file) are output.
FLX: Same as defining both HM
and H3D.
NASTRAN, PUNCH: The Nastran punch file format (.pch file) is output.
PATRAN, PATRAN: A number of Patran ASCII results files are output. APATRAN outputs the same files using an alternative file naming convention.
O2, OUT2, OP2: Nastran binary output2 file format (.op2 file) is output
Argument Options Description
(see comment 4).
PLOT: Results are output in
Nastran output2 format (.op2 file) when PARAM, POST is defined in the bulk data section.
NONE: Analysis output is not
required. Cannot be used in combination with other FORMAT commands. Comments
1. Information provided on OUTPUT entries takes precedence over information provided on FORMAT entries. If neither of these entries are defined, the output formats defined in the OptiStruct Configuration File are used. If no format is defined by the OptiStruct
configuration file, then both the HM and H3D formats are active by default. 2. Multiple FORMAT commands are allowed.
3. It is recommended to use the OUTPUT command instead of the FORMAT command since it is more flexible and allows different frequencies of output for different formats during an optimization.
4. format=OUTPUT2 can also be used to request results to be output in the Nastran output2 format (.op2 file).
FOS
I/O Options and Subcase Information Entry FOS – Output Request
Description
The FOS command can be used in the I/O Options or Subcase Information sections to request fatigue factor of safety output for all fatigue subcases or individual fatigue subcases.
Format
FOS (format_list) = option
Argument Options Description
format <H3D,OPTI, blank> Default = blank
H3D: Results are output in Hyper3D format (.h3d file).
OPTI: Results are output in OptiStruct results format (.fat file).
blank: Results are output in all active formats for which the result is available.
option <YES,ALL,NO, NONE,SID,PSID> Default = ALL
YES,ALL, blank:
Results are output for all elements.
NO,NONE: Results are not output.
SID: If a set ID is provided, results are output only for elements listed in that set.
Comments
1. When a FOS command is not present, fatigue FOS results are not output.
2. Multiple formats are allowed on the same entry; these should separated by a comma. If no format is specified, then this output control applies to all formats defined by OUTPUT or FORMAT commands, for which the result is available. See Results Output by OptiStruct for information on which results are available, in which formats.
3. Multiple instances of this card are allowed; if instances are conflicting, the last instance dominates.
GPFORCE
I/O Options and Subcase Information Entry GPFORCE - Output Request
Description
The GPFORCE command can be used in the I/O Options or Subcase Information sections to request grid point force balance output for all subcases or individual subcases respectively. Format
GPFORCE (format_list, elem, form, peakoutput, modal) = option
Argument Options Description
format <H3D, OPTI, PUNCH, OP2, PLOT, blank> Default = blank
H3D: Results are output in Hyper3D format (.h3d file).
OPTI: Results are output in OptiStruct results format (.gpf file).
PUNCH: Results are output in Nastran punch results format (.pch file).
OP2: Results are output in Nastran output2 format (.op2 file) (see comment 9).
PLOT: Results are output in Nastran output2 format (.op2 file) when PARAM, POST is defined in the bulk data section.
elem (H3D only) <ELEM, NOELEM> Default = NOELEM
NOELEM: GPFORCE results in the H3D output file will not include element contributions. However, the TOTAL value for each GRID includes the element contributions.
ELEM: GPFORCE results in the H3D output file includes element contributions.
form <REAL, IMAG,
PHASE>
REAL, IMAG: Provides rectangular format (real and imaginary) of complex output.
Argument Options Description
Default = REAL PHASE: Provides polar format (phase and magnitude) of complex output.
peakoutput <PEAKOUT> Default = blank
PEAKOUT: 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, grid point forces of the structural modes and residual vectors are output to the PUNCH and OUTPUT2 files for modal frequency response and transient analysis.
option <YES, ALL, NO, NONE, SID> Default = ALL
YES, ALL, blank:
Grid point force balance is output for all elements.
NO, NONE: Grid point force balance is not output.
SID: If a set ID is given, grid point force balance is output only for nodes listed in that set. Comments
1. When a GPFORCE command is not present, grid point force balance is not output. 2. GPFORCE output is available for the following solution sequences:
Solution Sequences Output Formats
Static Analysis H3D, OP2, PCH, OPT
Normal Modes Analysis H3D, OP2, PCH
Direct Frequency Response Analysis H3D, OP2, PCH, OPT
3. The form argument is only applicable for frequency response analysis. It is ignored in other instances.
4. Multiple formats are allowed on the same entry; these should be comma separated. If no format is specified, then this output control applies to all formats defined by OUTPUT or FORMAT commands 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. In previous versions of OptiStruct, a combination of the I/O options FORMAT and RESULTS were used; this method is still supported, but not recommended as it does not allow different frequencies for different formats.
7. GPFORCE in .op2 output can only be post-processed with the Free Body Diagram (FBD) tools in HyperMesh.
8. GPFORCE in .h3d output is specifically added for the load transfer path analysis with NVDirector. It is only available for linear static, frequency response, and acoustic analyses.
9. format=OUTPUT2 can also be used to request results to be output in the Nastran output2 format (.op2 file).
GPKE
I/O Options and Subcase Information Entry GPKE - Output Request for Grid Point Kinetic Energy
Description
The GPKE command can be used in the I/O Options or Subcase Information sections to request grid point kinetic energy output for normal modes subcases.
Format
GPKE (format_list) = option
Argument Options Description
format <PUNCH, blank> Default = blank
PUNCH: Results are output in Nastran punch results format (.pch file).
option <YES, ALL, NO, NONE, SID> Default = ALL
YES, ALL, blank: GPKE results are output for all elements. NO, NONE: GPKEs results are not output.
SID: If a set ID is given, GPKE results are output only for grids listed in that set.
Comments
1. Grid point kinetic energy is written in % of the total kinetic energy of all grids in the structure. Therefore, GPKE results for each grid are the same regardless of the requested option (ALL, YES, or SID).
2. Note that if the coupled mass matrix is used (PARAM,COUPMASS,YES), then the results at each GRID are influenced by all GRID connected to that GRID. Using a diagonal mass matrix formulation (PARAM,COUPMASS,NO) provides more meaningful results.
3. For large problems solved using EIGRA, run times increase if GPKE=ALL or a coupled mass matrix (PARAM,COUPMASS,YES) is specified, as the entire eigenvector for each mode must be calculated and stored.