2022
This manual provides a detailed list and usage information regarding input entries, output entries, and parameters available in OptiStruct.
Alphabetical listing of the I/O Options Entries.
View new features for OptiStruct 2022.
OptiStruct is a proven, modern structural solver with comprehensive, accurate and scalable solutions for linear and nonlinear analyses across statics and dynamics, vibrations, acoustics, fatigue, heat transfer, and multiphysics disciplines.
Discover OptiStruct functionality with interactive tutorials.
This manual provides detailed information regarding the features, functionality, and simulation methods available in OptiStruct.
The input file in OptiStruct is composed of three distinct sections.
The following guidelines apply to all entries in the I/O Options and Subcase Information sections.
The following guidelines apply to all entries in the Bulk Data Entry section.
The Data Selectors table is available in an Excel spreadsheet.
Supported types of optimization for various analysis sequences are outlined.
Descriptions for individual I/O Option Entries can be accessed by selecting from the links for each entry, listed below in groups according to their purpose and alphabetically on the I/O Options section page.
Descriptions for individual Subcase Information Entries can be accessed by selecting from the links for each entry, listed below in groups according to their purpose and alphabetically on the Subcase Information Section page.
Guidelines for using Bulk Data Entries are listed in Bulk Data Guidelines.
I/O Options and Subcase Information Entry The @HyperForm statement indicates an input file for one-step stamping simulation written from HyperForm.
I/O Options and Subcase Information Entry The ACCELERATION command can be used in the I/O Options or Subcase Information sections to request acceleration vector output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used in the I/O Options section or in Acoustic Complex Eigenvalue Analysis Subcases to request displacement for acoustic grids. This output request is only supported for acoustic interface grids.
I/O Options and Subcase Information Entry Used in the I/O Options section or in frequency response (direct and modal) subcases to request acoustic intensity at the fluid grids.
I/O Options and Subcase Information Entry Used in the I/O Options section or in frequency response (direct and modal) subcases to request acoustic power radiated across a panel.
I/O Options and Subcase Information Entry Used in the I/O Options section or in frequency response (direct and modal) subcases to request particle velocity at the fluid grids.
I/O Options and Subcase Information Entry Used to request aerodynamic loads on aerodynamic control points.
I/O Options and Subcase Information Entry Used to request aerodynamic pressures in static aeroelastic response.
I/O Options EntryDefines an assembly of parts which are included in the global model.
I/O Options and Subcase Information Entry Identifies external files and their contents.
I/O Options and Subcase Information Entry The AUTOSPC command can be used to automatically constrain stiffness singularities and near singularities with single point constraints.
I/O Options and Subcase Information Entry The CDSMETH command can be used in component dynamic synthesis method for generating component dynamic matrices at each loading frequency.
I/O Options and Subcase Information Entry The CFAILURE command can be used in the I/O Options or Subcase Information sections to request failure index output for shell elements referencing PCOMP, PCOMPP or PCOMPG properties for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The CHECK command can be used in the I/O Options section to request that only a model check be performed.
I/O Options and Subcase Information Entry The CMDE command can be used above the first SUBCASE or within a SUBCASE definition to request component modal synthesis damping energy output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The CMKE command can be used above the first SUBCASE or within a SUBCASE definition to request component modal synthesis kinetic energy output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The CMSE command can be used above the first SUBCASE or within a SUBCASE definition to request component modal synthesis strain energy output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The CONTF entry can be used to request contact results output for all subcases or individual linear static, nonlinear analysis, linear inertia relief and explicit dynamic analysis subcases.
I/O Options and Subcase Information Entry Used in the I/O Options or Subcase Information sections to request ply strain output for shell elements referencing PCOMP, PCOMPP or PCOMPG properties for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used in the I/O Options or Subcase Information sections to request ply stress output for shell elements referencing PCOMP, PCOMPP or PCOMPG properties for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to output current density results in electrical analysis.
I/O Options and Subcase Information Entry Used to request fatigue damage results output for all fatigue subcases or individual fatigue subcases, respectively. Also supported in Damage initiation output for OSTTS analysis.
I/O Options and Subcase Information Entry The DEBUG entry is used by Altair Simulation Support for internal issue debugging purposes.
I/O Options and Subcase Information Entry The DENSITY command can be used in the I/O Options section to request density output for a topology optimization.
I/O Options and Subcase Information Entry The DESGLB command can be used in the I/O Options section, before the first subcase statement, to select a constraint set that is not subcase dependent.
I/O Options and Subcase Information Entry The DESHIS command can be used in the I/O Options section to control the creation of the optimization history file .hgdata.
I/O Options and Subcase Information Entry The DGLOBAL command can be used in the I/O Options section to activate the Global Search Option (GSO).
I/O Options and Subcase Information Entry 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.
I/O Options and Subcase Information Entry The DMIGNAME command can be used in the I/O Options section to define the name given to the reduced matrices written to an external data file.
I/O Options and Subcase Information Entry The DRESPONSE command can be used in the I/O Options section to request Design Response Output for optimization runs. The DRESP1, DRESP2, and DRESP3 responses in the model are output as contours in the H3D file.
I/O Options and Subcase Information Entry The DSA command can be used in the I/O Options section to request Design Sensitivity Analysis results in a Frequency Response Analysis.
I/O Options and Subcase Information Entry The ECHO command can be used in the I/O Options section causing the output of the interpreted forms of Subcase Information and Bulk Data Entries to the .out file. The ECHOON command can be used in the I/O Options, Subcase Information, or Bulk Data sections causing the (verbatim) output of any subsequent I/O Options, Subcase Information, or Bulk Data Entries to the .out file until an ECHOOFF command is encountered. The ECHOOFF command can be used in the I/O Options, Subcase Information, or Bulk Data sections suppressing the output of any subsequent I/O Options, Subcase Information, or Bulk Data Entries to the .out file until and ECHOON command is encountered.
I/O Options and Subcase Information Entry Used to request element energy loss per cycle and element energy loss per cycle density output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to define the prefix to be used for external eigenvalue data files (.eigv).
I/O Options and Subcase Information Entry The EKE command can be used in the I/O Options or Subcase Information sections to request kinetic energy and kinetic energy density output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to output electric field results in electrical analysis.
I/O Options and Subcase Information Entry Used to output conductivity and resistivity results in electrical analysis.
I/O Options and Subcase Information Entry The ENDLOAD command can be used in the I/O Options or Subcase Information sections to request End Load output for all edges for relevant subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to request energy output for all geometric nonlinear analysis subcases or individual geometric nonlinear analysis subcases, respectively.
I/O Options and Subcase Information Entry Used to request Equivalent Stress results for all fatigue subcases or individual fatigue subcases, respectively.
I/O Options and Subcase Information Entry Used to request equivalent radiated power output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to request strain energy and strain energy density output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to request failure output for elements referencing PSOLID or PSHELL properties for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to request temperature gradient and flux output for all steady-state heat transfer analysis subcases, transient heat transfer analysis subcases or individual heat transfer analysis subcases, respectively.
I/O Options and Subcase Information Entry Used to request structural element force output and elemental fluid particle velocity output for all subcases or individual subcases, respectively.
I/O Options EntryThe FORMAT command can be used in the I/O Options section to indicate the format in which results are to be output.
I/O Options and Subcase Information Entry The FOS command can be used in the I/O Options or Subcase Information sections to request fatigue factor of safety, hydrostatic pressure, and shear stress output for all fatigue subcases or individual fatigue subcases.
I/O Options and Subcase Information Entry Used to output grid point current results in electrical analysis.
I/O Options and Subcase Information Entry 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.
I/O Options and Subcase Information Entry 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.
I/O Options and Subcase Information Entry Can be used to request grid point strain output for all or individual subcases, respectively.
I/O Options and Subcase Information Entry The GPSTRESS command can be used in the I/O Options or Subcase Information sections to request grid point stresses output for all subcases or individual subcases, respectively.
I/O Options EntryUsed to specify the solution harmonics to be used in cyclic symmetry analysis.
I/O Options and Subcase Information Entry Used to output Joule loss density results in electrical analysis.
I/O Options and Subcase Information Entry The HISOUT command can be used in the I/O Options section to control the amount of data printed to the .hgdata file.
I/O Options and Subcase Information Entry The HYBDAMP command can be used in the I/O Options section to request modal damping as a function of the natural frequency of the model in Dynamic Analysis.
I/O Options and Subcase Information Entry Identifies H3D files.
I/O Options and Bulk Data Entry and Subcase Information Entry The INCLUDE command can be used in the I/O Options, Bulk Data or Subcase Information sections to indicate that the contents of another file are to be inserted into the input file at the exact location of the include command.
I/O Options EntryDefines instances of local parts to be included in the global model.
I/O Options and Subcase Information Entry Used in the I/O Options or Subcase Information sections to request output of fatigue life results for all fatigue subcases or individual fatigue subcases, respectively.
I/O Options EntryUsed to define the external libraries and external files to be loaded into OptiStruct.
I/O Options and Subcase Information Entry The MBFORCE command can be used in the I/O Options section to request force output for a set of joints and/or force elements from multibody dynamics subcases.
I/O Options EntryUsed to choose the location of the Altair Multiscale Designer™ installation.
I/O Options and Subcase Information Entry The MECHCHECK command can be used in the I/O Options section to perform a massless mechanism check on the model.
I/O Options EntryUsed to request output of modal effective mass, modal participation factors, and modal effective mass fractions in Normal Modes Analysis.
I/O Options and Subcase Information Entry The MODALDE command can be used above the first SUBCASE or within a SUBCASE definition to request modal damping energy (the energy loss per cycle) output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The MODALKE command can be used above the first SUBCASE or within a SUBCASE definition to request modal kinetic energy output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The MODALSE command can be used above the first SUBCASE or within a SUBCASE definition to request modal strain energy output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The MODEL command can be used in the I/O Options section to request output of only a subset of the model and related results for H3D and OUTPUT results files as well as for CMS superelements.
I/O Options and Subcase Information Entry Controls the printing of monitor point data to the .monpnt file, whenever monitor points (MONPT1/MONPNT2/MONPNT3) are defined in the model.
I/O Options and Subcase Information Entry The MPCFORCE command can be used in the I/O Options or Subcase Information sections to request multi-point force of constraint vector is output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The MSGLMT command can be used in the I/O Options section to limit the number of ERROR, WARNING and INFORMATION messages output, or to elevate a WARNING or INFORMATION message to an ERROR.
I/O Options and Subcase Information Entry The NLLOAD entry can be used to request nonlinear load output for Transient Response Analysis for each time step for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The NLRESTART command can be used in the I/O Options section to indicate the current nonlinear solution sequence is to be restarted from a specified nonlinear subcase.
I/O Options and Subcase Information Entry Defines perturbation parameters for all X1, X2, and X3 grid point coordinate values which define the location of the grid points in the model. This entry applies to the X1, X2, and X3 fields of all GRID entries in the model.
I/O Options EntryUsed to specify the segments for which results must be recovered and output, in cyclic symmetry analysis.
I/O Options and Subcase Information Entry The OFREQUENCY command can be used in the I/O Options or Subcase Information sections to request a set of frequencies for output requests for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used in the I/O Options or Subcase Information sections to request applied load vector output temperature load output, and applied power output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used in the I/O Options or Subcase Information sections to request a set of modes for output requests for all subcases or for individual subcases, respectively. This command is applicable for normal modes and linear buckling solution sequences only.
I/O Options and Subcase Information Entry Used in the I/O Options or Subcase Information sections to request a set of times for output requests for Transient Analysis for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used in the I/O Options section to define the prefix for the results files output.
I/O Options EntryThe OUTPUT command can be used to control the format of results output and the creation of certain results files.
I/O Options EntryThe PFGRID command can be used in the I/O Options section to request output of acoustic grid participation factors for all Modal Frequency Response subcases. The output will be in the .h3d file.
I/O Options EntryUsed to request output of modal participation factors for all modal frequency response subcases.
I/O Options and Subcase Information Entry The PFPANEL command can be used in the I/O Options section to request output of acoustic panel participation factors for all Modal Frequency Response subcases.
I/O Options and Subcase Information Entry The PFPATH command can be used in the I/O Options section for Transfer Path Analysis for a response at the connection points.
I/O Options EntryUsed to request output of the power flow field.
I/O Options and Subcase Information Entry Used request displacement and pressure output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The PRETBOLT command can be used in the I/O Options or Subcase Information sections to request output of pretension force/adjustment values in the pretension bolts for all pretensioning and pretensioned subcases.
I/O Options and Subcase Information Entry The PROPERTY command can be used in the I/O Options section to request the output of the property definitions used in the final iteration of an optimization.
I/O Options and Subcase Information Entry The RBODY command can be used in the I/O Options section to select a rigid body or a combination of rigid bodies.
I/O Options and Subcase Information Entry Used in the I/O Options section to request computation and output of cross-power spectral density functions for Random Response Analysis.
I/O Options and Subcase Information Entry The REQUEST command can be used in the I/O Options or Subcase Information sections to select a multibody request definition to be used in a multibody problem.
I/O Options and Subcase Information Entry The RESPRINT command can be used in the I/O Options section to force all unretained responses of a certain type to be printed to the output file, provided they are referenced either as an objective or a constraint. This also applies to manufacturing constraints for composites.
I/O Options and Subcase Information Entry The RESTART command can be used in the I/O Options section to indicate that the current optimization is to be restarted from the final iteration of a previous optimization.
I/O Options EntryDefines the reading requests for nonlinear restart.
I/O Options and Subcase Information Entry The RESTARTW entry can be used in the I/O Options section to define the control parameters for nonlinear restart.
I/O Options and Subcase Information Entry Enables the output of resultant forces and moments for internally generated sections.
I/O Options and Subcase Information Entry The RIGID command can be used in the I/O Options section to select the constraint processing method for RBAR, RROD, RBE1, RBE2, RBE3, RSPLINE, RSSCON, RBODY and MPC entries.
I/O Options and Subcase Information Entry Used to request fatigue damage results output for all fatigue subcases or individual fatigue subcases, respectively.
I/O Options and Subcase Information Entry The SACCELERATION command can be used in the I/O Options or Subcase Information sections to request the form and type of modal participation accelerations output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The SCREEN command can be used in the I/O Options section to control the output of model, analysis, and optimization information to the Unix or DOS shell.
I/O Options and Subcase Information Entry The SDISPLACEMENT command can be used in the I/O Options or Subcase Information sections to request the form and type of modal participation displacements output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The SENSITIVITY command can be used in the I/O Options section to request the output of the responses and sensitivities for size and shape design variables to a Microsoft Excel spreadsheet.
I/O Options and Subcase Information Entry The SENSOUT command can be used in the I/O Options section to control the frequency of output of responses and sensitivities for size and shape design variables to a Microsoft Excel spreadsheet.
I/O Options and Subcase Information Entry The SHAPE command can be used in the I/O Options section to request altered shape output for a shape optimization.
I/O Options and Subcase Information Entry The SINTENS command can be used in the I/O Options section to request Sound Intensity output for all frequency response subcases. The SINTENS command can be used in the I/O Options or Subcase Information sections to request Sound Intensity output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Requests skipping certain lines from the analysis.
I/O Options and Subcase Information Entry Used to request single-point force of constraint vector output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The SPL command can be used in the I/O Options or Subcase Information sections to request Sound Pressure output for all subcases or individual subcases, respectively. SPL can only be requested for frequency response subcases.
I/O Options and Subcase Information Entry The SPOWER command can be used in the I/O Options or Subcase Information sections to request Sound Power output for all subcases or individual subcases, respectively. SPOWER can only be requested for frequency response subcases.
I/O Options and Subcase Information Entry Used to request strain output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to request stress output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry The SUBTITLE command can be used in the I/O Options or Subcase Information sections to define the subtitle for all subcases or for individual subcases, respectively.
I/O Options and Subcase Information Entry The SVELOCITY command can be used in the I/O Options or Subcase Information sections to request the form and type of modal participation velocities output for all subcases or individual subcases, respectively.
I/O Options EntryUsed to alter system settings. Any setting defined here may be over-ridden by command line arguments (Run Options). Most of these options can also be specified in one of the config files (Configuration File).
I/O Options and Subcase Information Entry The TCURVE command can be used in the I/O Options section to define the plot title for XYPLOT output from a Random Response Analysis.
I/O Options and Subcase Information Entry The THERMAL command can be used in the I/O Options or Subcase Information sections to request temperature output for all heat transfer analysis subcases or individual heat transfer analysis subcases, respectively.
I/O Options and Subcase Information Entry The THICKNESS command can be used in the I/O Options section to request thickness output for elements referencing a PSHELL, PCOMP or PCOMPP properties in size (parameter)/free-size optimization and analysis runs.
I/O Options and Subcase Information Entry The THIN command can be used in the I/O Options or Subcase Information sections to request thinning and thickness output for all geometric nonlinear analysis subcases or individual geometric nonlinear analysis subcases, respectively.
I/O Options and Subcase Information Entry The TITLE command can be used in the I/O Options section to define the title for the OptiStruct job.
I/O Options and Subcase Information Entry The TMPDIR command is used in the I/O Options section to choose the directory in which the scratch files are to be written.
I/O Options and Subcase Information Entry Used to request the total force (summation of single-point force of constraint and applied load) output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to specify options for the output of trim loads from a static aeroelastic analysis as FORCE/MOMENT Bulk Data Entries.
I/O Options and Subcase Information Entry The TTERM command can be used to define the termination time.
I/O Options and Subcase Information Entry The UNITS command can be used in the I/O Options section to define a system of units for the model.
I/O Options and Subcase Information Entry The VELOCITY command can be used in the I/O Options or Subcase Information sections to request velocity vector output for all subcases or individual subcases, respectively.
I/O Options and Subcase Information Entry Used to output electric potential results in electrical analysis.
I/O Options and Subcase Information Entry The XTITLE command can be used in the I/O Options section to define the x-axis label for XYPUNCH or XYPLOT output from a Random Response Analysis.
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.
I/O Options and Subcase Information Entry The YTITLE command can be used in the I/O Options section to define the y-axis label for XYPUNCH or XYPLOT output from a Random Response Analysis.
Alphabetical listing of the Subcase Information Entries.
Alphabetical listing of the Bulk Data Entries.
In order to prevent analyses from being carried out on badly discretized models, an element quality check is incorporated into the pre-processing phase.
In order to prevent analyses from being carried out on models with poor material definitions, a material property check is incorporated into the pre-processing phase. The material property check is controlled by the CHECKMAT parameter (see the PARAM input format).
The OptiStruct Example Guide is a collection of solved examples for various solution sequences and optimization types and provides you with examples of the real-world applications and capabilities of OptiStruct.
This manual presents solved verification models including NAFEMS problems.
This section provides quick responses to typical and frequently asked questions regarding OptiStruct.
View All Altair Simulation Help