File Output Controls

Keyword Description Default Frequency Affected Files Options Details
TCL Controls output of .tcl files. - *.HM.comp.tcl, *.HM.ent.tcl, *.HM.conn.tcl <YES, NO>

Default = YES

 
OSS Controls output of .oss file. - *.oss <YES, NO>

Default = YES

 
HTML Controls output of .html file. - *.html <YES, NO>

Default = YES

 
SPCD Controls output of the .spcd file. - *_spcd <YES, NO>

Default = see Comment 25

 
STAT Controls output of .stat file. - *.stat <YES, NO>

Default = YES

See Comment 9
MVW Controls output of .mvw file. - *.mvw <YES, NO>

Default = YES

 

Comments

  1. Frequency does not apply for any of the keywords where a dash (-) is given as the default frequency in the keywords table above.
  2. HGTRANS and HGMBD are currently available for analysis only.
  3. HGFREQ, HGTRANS, and HGMBD will only use output requests where a Set ID is specified. For example, if DISPLACEMENT=ALL or DISPLACEMENT(HG)=ALL is given, displacement information will not be present in the presentation, whereas if DISPLACEMENT=1 or DISPLACEMENT(HG)=1 is given, displacement information will be present in the presentation for the constituent nodes of Set 1.
  4. For HGSENS, H3DTOPOL, H3DGAUGE, ASCSENS, or MSSENS options:
    • If NOSTRESS or blank: results are printed, but stress, strain, and force responses are ignored.
    • If ALL or STRESS: results are printed, including stress, strain, and force responses.
    • If MASS: Mass-normalized sensitivities are output to the corresponding H3D file. This is labeled as “Sensitivity (Mass)” in HyperView.
  5. For HGHIST options:
    The integer value given is equal to the sum of the desired options:
    1
    Design variable.
    2
    Objective function and maximum % constraint violation.
    4
    All non-stress responses.
    8
    All DRESP2 responses.
    16
    All DRESP3 responses
    32
    Normalized constraint violation plots. Value 32 outputs the plot for responses divided by their corresponding constraint bounds to the *_hist.mvw file. The response over constraint bound (Y-Axis) vs Response ID (X-Axis) plots are only output for the final optimization iteration. The responses ID’s are not equivalent to the user-defined Response IDs in the model. To identify any response, hover the mouse pointer over red vertical curve in HyperGraph, this will display the user-defined Response Label. The Y-Axis value of 1.0 is displayed as a red horizontal line.
    blank
    All of the above, except 32 are output. So, the default value is 31.

    For example: If design variables and all DRESP2 responses are wanted, you would enter 9.

  6. The DVGRID option creates shape variable definitions for displacement or eigenvector results of Linear Static, Normal Modes, or Linear Buckling Analyses. These shape variable definitions can then be used in subsequent optimizations. This process facilitates the use of "natural" shape functions.
  7. For the keywords HM, H3D, HV, ASCII, OPTI, OS, NASTRAN, PUNCH, OP2, OUT2, OUTPUT2, PATRAN and APATRAN, the information provided by the OUTPUT I/O Option Entry takes precedence over information provided on the older FORMAT and RESULTS I/O Option Entries.
  8. OUTPUT entries are read sequentially; therefore, where multiple OUTPUT entries exist with the same keyword, the last instance is used.
  9. If OUTPUT,STAT,NO is defined, the *.stat file is deleted at the end of the run (as long as the run was successful), but the file always exists during the run.
  10. OUTPUT,DESIGN takes precedence over the information provided on the older DENSRES I/O Options Entry. OUTPUT,DESIGN will write design results, at the frequency defined, to all active output formats (HM, H3D, or OPTI), regardless of the frequency chosen for that output format. By default, HM is the only active output format.
  11. When CMSMETH is used, or when a full multibody dynamics run is performed, the CMS stress modes can be written to OP2 format. This only happens when OUTPUT,OP2 is defined. One file for each is generated. Stresses are written for shells and solids, while forces are written for bars/beams and welds. Each mode is written as a static load case with ID equal to the mode index. This output is compatible with FEMFAT by MAGNA.
  12. The MODEL/NOMODEL option for OUTPUT,OP2 may be overridden by the PARAM, OGEOM Bulk Data Entry.
  13. The FSTHICK keyword generates a file with the .fsthick extension. The file contains Bulk Data Entries for elements (CQUAD4, CQUAD8, CTRIA3, and CTRIA6) contained in free-size design spaces. The element definitions have the optimized thickness defined as nodal thicknesses (Ti) for each element.
  14. The HGMODFAC keyword generates a HyperGraph 3D presentation providing 3D plots of modal participation factors. The plots display the mode number on the x-axis, the frequency (for Frequency Response Analysis) or time (for Transient Analysis) on the y-axis and the modal participation factor on the z-axis.

    The NORM option normalizes the participation factors with respect to 1.

    In HyperGraph 3D, it is possible to define cross-sections to generate 2D plots of either:
    1. Modal participation factor vs. frequency or time for a given number.
    2. Modal participation factor vs. mode number at a given frequency or time.

    For Frequency Response Analysis, plots are generated for the real part, the imaginary part and the magnitude of the participation factors. Magnitude plot is visible by default, while real and imaginary plots are hidden by default.

  15. The H3D output from optimization runs consists of numerous files. The BYSUB/BYITER option allows switching between two modes of H3D output. There is a no default option (BYSUB/BYITER) for analysis runs.
    • BYSUB (This is the default option for optimization runs) outputs one _des.h3d file for the animation of the optimization history. The frequency of the optimization results in this file is defined by OUTPUT, DESIGN (Default = ALL). In addition, an _si.h3d file for each subcase i is written that contains the history of the analysis results for each subcase. Frequency determines the analysis result output frequency. Optimization results can be written to the subcase files using DENSITY, SHAPE, or THICKNESS output requests.

      (Using OUTPUT, H3D, or BYSUB for analysis runs (without optimization) will output the same files as above (except for the _des.h3d file), however no design results or analysis history will be available within the files).

    • BYITER outputs one .#.h3d file per iteration that contains the optimization and analysis results for all subcases per iteration. Frequency determines at which iteration these files are created. It overwrites the default of OUTPUT, DESIGN unless an actual OUTPUT, DESIGN statement is present. In the case of a shape optimization, the GRID coordinates of the model in the respective iteration are updated to the new shape.

      (Using OUTPUT, H3D, or BYITER for analysis runs (without optimization) will output only one .h3d file since there are no multiple iterations). An additional frequency option CURRENT is available for the BYITER option. Therefore, OUTPUT,H3D,CURRENT,BYITER will output a separate H3D file named <filename>_cur.h3d file which contains analysis run output for the current optimization iteration. This file is overwritten for each subsequent optimization iteration.

  16. Results for interior points of external superelements will be output by default to HM, H3D, PUNCH, and OP2 files.
  17. To output stresses to the .mnf file, the GPSTRESS I/O Options Entry should be specified in addition to OUTPUT, ADAMSMNF. PARAM,GPSLOC can be used to control the output location of stresses for shells (top/bottom/middle).
  18. For FSTOSZ options:
    For Composite Optimization:
    Bundles
    Specifies the number of ply bundles to be generated per fiber orientation.
    Method
    Ply bundle thicknesses are determined based on the method defined.
    ADVFREE
    Advanced algorithm with free thicknesses.
    ADVMAN
    Advanced algorithm with manufacturable thicknesses.
    SIMFREE
    Simple algorithm with free thicknesses.
    SIMMAN
    Simple algorithm with manufacturable thicknesses.

    The advanced algorithm is available for 2, 4 and 8 ply bundles. The thickness distribution is considered when generating the ply bundles, which results in a more accurate representation of the original free-sized thickness profile.

    Ply bundle thickness can also be multiples of the manufacturable ply thickness.

    Ignore: Elements may be ignored in a given ply orientation when their thickness is less than 5% of the maximum thickness. This option is inactive by default.

    For Non-Composite (PSHELL) optimization:
    Bundles
    Specifies the number of PSHELL groups to be generated per PSHELL definition depending on the thickness.
    Method
    Bundle thicknesses are determined based on the method defined.
    ADVFREE
    Advanced algorithm with free thicknesses.
    ADVMAN
    Advanced algorithm with manufacturable thicknesses.
    SIMFREE
    Simple algorithm with free thicknesses.
    SIMMAN
    Simple algorithm with manufacturable thicknesses.
    The advanced algorithm is available for 2, 4 and 8 PSHELL groups (bundles). The thickness distribution is considered when generating the bundles, which results in a more accurate representation of the original free-sized thickness profile.
    Ignore
    Elements may be ignored in a given bundle when their thickness is less than 5% of the maximum thickness.
    This option is inactive by default.
  19. H3DSENS, USER indicates that the user-defined responses should be included in the DSA output. NOUSER indicates that user-defined responses should not be included. In both cases, responses defined through the DSA output request are included in the DSA output. Table 1 lists the sensitivities that are output for each option.
    H3DSENS only matters when DSA is used. DSA is supported only for Frequency Response Analysis currently.
    Table 1.
    Output Sensitivities Requested via the DSA Output Request

    (responses are automatically defined)

    Sensitivities Output from a Complete Optimization Setup

    (User-defined/specified responses via DRESP1, DRESP2, DRESP3)

    OUTPUT, H3DSENS, USER Yes Yes
    OUTPUT, H3DSENS, NOUSER Yes No

    H3DSENS, BYITER (default) indicates that multiple *_dsa.#.h3d files are output for multiple iterations (#). H3DSENS, COMB indicates that a single combined *_dsa.h3d file is output for all iterations.

  20. The values of PARAM,GRDPNT and PARAM,UCORD do not affect the output of Center of Gravity and Mass Moment of Inertia output via OUTPUT,MASSPROP. This output is also supported for a check run, which allows checking the center of gravity and mass moment of inertia output before launching a full run.
  21. Multiple Objective runs, Stress/Strain norm, and BIGOPT optimizer are not currently supported in conjunction with MSLAGM.
  22. The HDF5 output is printed to a .h5 binary results file. The current support of HDF5 output format is:
    1. In case of Linear Static and Normal Modes analysis,
      • The supported element types for element-based results (in .h5 format) are:
        Result Elements Supported
        FORCE/ELFORCE CBAR, CBEAM, CONROD, CTRIA3, CTRIA6, CQUAD4, CQUAD8
        STRESS CROD, CBAR, CBEAM, CONROD, CELAS1, CELAS2, CBUSH, CTRIA3, CTRIA6, CQUAD4, CQUAD8, CTETRA, CHEXA, CPENTA
        STRAIN
      • Corner results are also available for the above results with CQUAD4 and CQUAD8 elements.
    2. In case of Nonlinear Static analysis,
      • The supported element types for STRESS and STRAIN results (in .h5 format) are:
        Result Elements Supported
        STRESS,

        STRAIN

        CROD, CELAS1, CBAR, CBEAM, CTRIA3, CTRIA6, CQUAD4, CQUAD8, CHEXA, CPENTA, CTETRA
      • Corner results are also available for CQUAD4 and CQUAD8.
      • DISPLACEMENT, STRESS and STRAIN results are also available on-the-fly during the analysis, if the NLOUT entry is defined in the subcase.
    3. In case of Linear Buckling analysis, only DISPLACEMENT result is available in .h5 format.
  23. The FREQUENCY options (except CURRENT) are supported for TCL file output. FAST option is the default.
  24. KPI output includes maximum value for Displacement, Stress, Strain, and Plastic Strain with respect to the corresponding property. It is supported for linear and nonlinear static analysis only. Stresses and Strains are supported only for shells and solids. This output can also be activated from the corresponding I/O Options Entry ( DISPLACEMENT, etc).
  25. If OUTPUT,SPCD is present in the input file, it is equivalent to OUTPUT,SPCD,YES and the corresponding *.spcd file(s) are output.

    If OUTPUT,SPCD is not in the input file, or if OUTPUT,SPCD,NO is explicitly specified, then the corresponding *.spcd file(s) are not output.

  26. The output of bore distortion results can be turned off using OUTPUT, MVW, NO.
  27. OUTPUT, BORED is not supported with the CURRENT option.
  28. The HGTRANS output request is supported for linear (direct and modal) transient analysis only, in general. Only in case of section force/moment results, it is supported with both linear and nonlinear transient analysis types. The plots are available for magnitude, as well as X, Y and Z components.