2.6. SOLUTION Commands

These commands load and solve the model. The commands are grouped by functionality.

Table 2.48: Analysis Options

These SOLUTION commands set general analysis options.
ABEXTRACTExtracts the alpha-beta damping multipliers for Rayleigh damping. 
ACCOPTIONSpecifies GPU accelerator capability options. 
ADAMSPerforms solutions and writes flexible body information to a modal neutral file. 
ADPCIDefines parameters associated with adaptive crack initiation. 
ANTYPESpecifies the analysis type and restart status. 
ASCRESSpecifies the output type for an acoustic scattering analysis. 
ASOLActivate a specified acoustic solution. 
BCSOPTIONSets memory option for the sparse solver. 
CECHECKCheck constraint equations and couplings for rigid body motions. 
CEFILTERBypasses the error message when constraint equations have excessive terms. 
CHECKChecks current database items for completeness. 
CINTDefines parameters associated with contour integral calculations. 
CJUMPInitiates a cycle-jump analysis. 
CLOADInitiates a cyclic-loading analysis. 
CMATRIXPerforms electrostatic field solutions and calculates the self and mutual capacitances between multiple conductors. 
CMSOPTSpecifies component mode synthesis (CMS) analysis options. 
CNCHECKProvides and/or adjusts the initial status of contact pairs.  
CNKMODModifies contact element key options. 
CNTRRedirects contact pair output quantities to a text file. 
CUTCONTROLControls time-step cutback during a nonlinear solution. 
CYCOPTSpecifies solution options for a cyclic symmetry analysis. 
DAMPOPTSets damped eigensolver options. 
DDOPTIONSets domain decomposer option for DMP solution. 
DMPEXTExtracts modal damping coefficients in a specified frequency range. 
DMPOPTIONSpecifies distributed-memory parallel (DMP) file combination options. 
DSPOPTIONSets the memory option for the distributed sparse solver. 
EXBOPTSpecifies .exb file output options in a CMS generation pass. 
EMATWRITEForces the writing of all the element matrices to File.emat. 
EQSLVSpecifies the type of equation solver. 
ERESXSpecifies extrapolation of integration point results. 
ESCHECKPerform element shape checking for a selected element set.  
EXPASSSpecifies an expansion pass of an analysis. 
GAUGEGauges the problem domain for an edge-element formulation. 
GMATRIXPerforms electric field solutions and calculates the self and mutual conductances between multiple conductors. 
INVOPTEnables or disables inverse solving for the current load step. 
KRYOPTSpecifies solution options for a Krylov method harmonic analysis. 
LANBOPTIONSpecifies Block Lanczos eigensolver options. 
LUMPMSpecifies a lumped mass matrix formulation. 
MODDIRActivates the remote read-only modal files usage. 
MONITORControls contents of variable fields in the nonlinear solution monitor file. 
MSAVESets the memory saving feature for the PCG solver. 
MSOLVEStarts multiple solutions for an acoustic analysis. 
OPNCONTROLSets decision parameter for automatically increasing the time step interval in a pure thermal analysis. 
OUTAEROOutputs the superelement matrices and load vectors to formatted files for aeroelastic analysis. 
PCGOPTControls PCG solver options.  
PERTURBSets linear perturbation analysis options. 
PRSCONTROLSpecifies whether to include pressure load stiffness in the element stiffness formation. 
PSCONTROLTurns off shared-memory parallel operations during solution. 
RATESpecifies whether the effect of creep strain rate will be used in the solution of a load step. 
RESVECCalculates residual vectors in a modal analysis, or includes residual vectors in a modal superposition transient/harmonic analysis. 
RSTOFFOffsets node or element IDs in the FE geometry record. 
SCOPTSpecifies System Coupling options. 
SEEXPSpecifies options for the substructure expansion pass. 
SEOPTSpecifies substructure analysis options. 
SNOPTIONSpecifies supernode (SNODE) eigensolver options. 
/SOLUEnters the solution processor. 
SOLVEStarts a solution. 
STABILIZEActivates stabilization for all elements that support nonlinear stabilization. 
THEXPANDEnables or disables thermal loading. 
THOPTNonlinear transient thermal solution option. 
TOFFSTSpecifies the temperature offset from absolute zero to zero. 

Table 2.49: Nonlinear Options

These SOLUTION commands define options for nonlinear analyses.
ARCLENActivates the arc-length method. 
ARCTRMControls termination of the solution when the arc-length method (ARCLEN,ON) is used. 
BUCOPTSpecifies buckling analysis options. 
CNVTOLSets convergence values for nonlinear analyses. 
/GSTTurns Graphical Solution Tracking (GST) on or off. 
LNSRCHActivates a line search to be used with Newton-Raphson. 
MXPANDSpecifies modal or buckling analysis expansion options. 
NCNVSets the key to terminate an analysis. 
NEQITSpecifies the maximum number of equilibrium iterations for nonlinear analyses. 
NLADAPTIVEDefines the criteria under which the mesh is refined or modified during a nonlinear solution. 
NLDIAGSets nonlinear diagnostics functionality. 
NLGEOMIncludes large deformation effects in a static or full transient analysis. 
NLHISTSpecify results items to track during solution. 
NLMESHControls remeshing in nonlinear adaptivity. 
NROPTSpecifies the Newton-Raphson options in a static or full transient analysis. 
PREDActivates a predictor in a nonlinear analysis. 
PSTRESSpecifies whether prestress effects are calculated or included. 
SEMIIMPLICITSpecifies parameters for a semi-implicit solution. 
SOLOPTIONSpecifies solution transition options. 

Table 2.50: Dynamic Options

These SOLUTION commands define options for dynamic analyses.
AEROCOEFFComputes the aero-damping and stiffness coefficients and writes them to an APDL array 
ALPHADDefines the mass matrix multiplier for damping. 
BETADDefines the stiffness matrix multiplier for damping. 
CECYCMSGenerates the constraint equations for a multistage cyclic symmetry analysis. 
CYCFREQSpecifies solution options for a cyclic symmetry mode-superposition harmonic analysis. 
CEIMSGenerates constraint equations at the interface between stages in a multistage cyclic symmetry analysis. 
DMPRATSets a constant modal damping ratio. 
DMPSTRSets a constant structural damping coefficient. 
FRQSCLTurns on automatic scaling of the entire mass matrix and frequency range for modal analyses. 
HARFRQDefines the frequency range in the harmonic analysis. 
HREXPSpecifies the phase angle for the harmonic analysis expansion pass. 
HROCEANIncludes ocean wave effects in a harmonic analysis. 
HROPTSpecifies harmonic analysis options. 
HROUTSpecifies the harmonic analysis output options. 
LVSCALEScales the load vector for mode-superposition analyses. 
MASCALETurns on the scaling of the entire system matrix. 
MCFOPTSpecifies options for the Modal Coordinates File (Jobname.mcf). 
MDAMPDefines the damping ratios as a function of mode. 
MDPLOTPlots frequency-dependent modal damping coefficients. 
MIDTOLSets middle step residual criterion values for structural transient analysis. 
MODCONTCreates multiple load vectors in a modal analysis. 
MODOPTSpecifies modal analysis options. 
MSOPTSpecifies solution options for a multistage cyclic symmetry analysis. 
MXPANDSpecifies modal or buckling analysis expansion options. 
QRDOPTSpecifies additional QRDAMP modal analysis option. 
RIGIDSpecifies known rigid body modes (if any) of the model. 
SUBOPTSpecifies SUBSPACE eigensolver options 
TIMINTTurns on transient effects. 
TINTPDefines transient integration parameters. 
TRNOPTSpecifies transient analysis options. 

Table 2.51: Spectrum Options

These SOLUTION commands define options for spectrum analyses.
ADDAMSpecifies the acceleration spectrum computation constants for the analysis of shock resistance of shipboard structures. 
COVALDefines PSD cospectral values. 
CQCSpecifies the complete quadratic mode combination method. 
DSUMSpecifies the double sum mode combination method. 
FREQDefines the frequency points for the SV vs. FREQ tables. 
GRPSpecifies the grouping mode combination method. 
MMASSSpecifies the missing mass response calculation. 
NRLSUMSpecifies the Naval Research Laboratory (NRL) sum mode combination method. 
PFACTCalculates participation factors for the PSD or multi-point response spectrum table. 
PSDCOMSpecifies the power spectral density mode combination method. 
PSDFRQDefines the frequency points for the input spectrum vs. FREQ tables of PSD and multi-point spectrum analyses. 
PSDGRAPHDisplays input PSD curves 
PSDRESControls solution output written to the results file from a PSD analysis. 
PSDSPLDefines a partially correlated excitation in a PSD analysis. 
PSDUNITDefines the type of PSD or multi-point response spectrum. 
PSDVALDefines PSD or multi-point response spectrum values. 
PSDWAVDefines a wave propagation excitation in a PSD analysis. 
QDVALDefines PSD quadspectral values. 
ROCKSpecifies a rocking response spectrum. 
ROSESpecifies the Rosenblueth mode combination method. 
RIGRESPSelects the spectrum type and other spectrum options. 
SEDDefines the excitation direction for a single-point response spectrum. 
SPDAMPDefines input spectrum damping in a multi-point response spectrum analysis. 
SPFREQDefines the frequency points for the input spectrum tables SPVAL vs. SPFREQ for multi-point spectrum analyses.  
SPGRAPHDisplays input spectrum curves for MPRS analysis. 
SPOPTSelects the spectrum type and other spectrum options. 
SPUNITDefines the type of multi-point response spectrum.  
SPVALDefines multi-point response spectrum values.  
SRSSSpecifies the square root of sum of squares mode combination method. 
SVDefines spectrum values to be associated with frequency points. 
SVPLOTDisplays input spectrum curves. 
SVTYPDefines the type of single-point response spectrum. 
VDDAMSpecifies the velocity spectrum computation constants for the analysis of shock resistance of shipboard structures. 

Table 2.52: Load Step Options

These SOLUTION commands define options for individual load steps.
AUTOTSSpecifies whether to use automatic time stepping or load stepping. 
CAMPBELLPrepares the result file for a subsequent Campbell diagram of a prestressed structure.  
CECMODModifies the constant term of a constraint equation during solution. 
DELTIMSpecifies the time step sizes to be used for this load step. 
EXPSOLSpecifies the solution to be expanded for reduced analyses. 
KBCSpecifies stepped or ramped loading within a load step. 
KUSESpecifies whether or not to reuse the factorized matrix. 
MAGOPTSpecifies options for a 3D magnetostatic field analysis. 
MAGSOLVSpecifies magnetic solution options and initiates the solution. 
MODESpecifies the harmonic loading term for this load step. 
NSUBSTSpecifies the number of substeps to be taken this load step. 
NUMEXPSpecifies solutions to be expanded from reduced analyses. 
TIMESets the time for a load step. 
TREFDefines the reference temperature for the thermal strain calculations. 
TSRESDefines an array of key times at which the time-stepping strategy changes. 
UPCOORDModifies the coordinates of the active set of nodes, based on the current displacements. 
USRCALEnables user-solution subroutines to be activated or deactivated. 
WRFULLStops solution after assembling global matrices. 

Table 2.53: Solid Constraints

These SOLUTION commands define constraints on the solid model.
DADefines symmetry or antisymmetry degree-of-freedom constraints on areas. 
DADELEDeletes degree-of-freedom constraints on an area. 
DALISTLists the degree-of-freedom constraints on an area. 
DKDefines degree-of-freedom constraints at keypoints. 
DKDELEDeletes degree-of-freedom constraints at a keypoint. 
DKLISTLists the degree-of-freedom constraints at keypoints. 
DLDefines symmetry or antisymmetry degree-of-freedom constraints on lines. 
DLDELEDeletes degree-of-freedom constraints on a line. 
DLLISTLists degree-of-freedom constraints on a line. 
DTRANTransfers solid model degree-of-freedom constraints to the finite element model. 

Table 2.54: Solid Forces

These SOLUTION commands define forces on the solid model.
FKDefines force loads at keypoints. 
FKDELEDeletes force loads at a keypoint. 
FKLISTLists the forces at keypoints. 
FTRANTransfers solid model forces to the finite element model. 

Table 2.55: Solid Surface Loads

These SOLUTION commands define surface loads on the solid model.
SFASpecifies surface loads on the selected areas. 
SFADELEDeletes surface loads from areas. 
SFALISTLists the surface loads for the specified area. 
SFLSpecifies surface loads on lines of an area. 
SFLDELEDeletes surface loads from lines. 
SFLLISTLists the surface loads for lines. 
SFTRANTransfer the solid model surface loads to the finite element model. 

Table 2.56: Solid Body Loads

These SOLUTION commands define body loads on the solid model.
BFADefines a body-force load on an area. 
BFADELEDeletes body-force loads on an area. 
BFALISTLists the body-force loads on an area. 
BFKDefines a body-force load at a keypoint. 
BFKDELEDeletes body-force loads at a keypoint. 
BFKLISTLists the body-force loads at keypoints. 
BFLDefines a body-force load on a line.  
BFLDELEDeletes body-force loads on a line. 
BFLLISTLists the body-force loads on a line. 
BFTRANTransfers solid model body-force loads to the finite element model. 
BFVDefines a body-force load on a volume.  
BFVDELEDeletes body-force loads on a volume. 
BFVLISTLists the body-force loads on a volume. 

Table 2.57: Inertia

These SOLUTION commands define inertial loads on the model.
ACELSpecifies the linear acceleration of the structure. 
AIRLSpecifies that automatic inertia relief calculations are to be performed. 
CGLOCSpecifies the origin location of the acceleration coordinate system. 
CGOMGASpecifies the rotational velocity of the global origin. 
CMACELSpecifies the translational acceleration of an element component. 
CMDOMEGASpecifies the rotational acceleration of an element component about a user-defined rotational axis. 
CMOMEGASpecifies the rotational velocity of an element component about a user-defined rotational axis. 
CMROTATESpecifies the rotational velocity of an element component about a user-defined rotational axis 
CORIOLISApplies the Coriolis effect to a rotating structure. 
DCGOMGSpecifies the rotational acceleration of the global origin. 
DOMEGASpecifies the rotational acceleration of the structure. 
IRLFSpecifies that inertia relief calculations are to be performed. 
OMEGASpecifies the rotational velocity of the structure. 
SPOINTDefines a point for moment summations. 
SYNCHROSpecifies whether the excitation frequency is synchronous or asynchronous with the rotational velocity of the structure. 

Table 2.58: Miscellaneous Loads

These SOLUTION commands are for miscellaneous load definition and control.
ANPRESProduces an animated sequence of the time-harmonic pressure variation of an engine-order excitation in a cyclic harmonic analysis.
APORTSpecifies input data for plane wave and acoustic duct ports.
ASIFILEWrites or reads one-way acoustic-structural coupling data.
AWAVESpecifies input data for an acoustic incident wave.
BIOTCalculates the Biot-Savart source magnetic field intensity.
DFSWAVESpecifies the incident planar waves with random phases for the diffuse sound field.
FLUREADReads one-way Fluent-to-Mechanical APDL coupling data via a .cgns file with one-side fast Fourier transformation complex pressure peak value.
ICSpecifies initial conditions at nodes.
ICDELEDeletes initial conditions at nodes.
ICLISTLists the initial conditions.
ICROTATESpecifies initial velocity at nodes as a sum of rotation about an axis and translation.
INISTATEApplies initial state data to an element or a selection of elements.
MPCHGChanges the material number attribute of an element.
MRPMDefines the revolutions per minute (RPM) for a machine rotation.
NSMASSApplies nonstructural mass to selected elements.
OSRESULTControls the selected result data written to the database.
OUTGEOMControls geometry-related data written to the results file.
OUTPRControls the solution printout.
OUTRESControls the solution data written to the database.
RESCONTROLControls file writing for multiframe restarts.
RSTCONTROLControls whether element single value results are written to the results file.
SBCLISTLists solid model boundary conditions.
SBCTRANTransfers solid model loads and boundary conditions to the FE model.
SCCONNECTSpecifies system coupling connection parameters.
WSPRINGSCreates weak springs on corner nodes of a bounding box of the currently selected elements.
XFLISTLists enrichment details and associated crack information.

Table 2.59: Load Step Operations

These SOLUTION commands write and solve multiple load steps.
LSCLEARClears loads and load step options from the database. 
LSDELEDeletes load step files. 
LSREADReads load and load step option data into the database. 
LSSOLVEReads and solves multiple load steps. 
LSWRITEWrites load and load step option data to a file. 

Table 2.60: Master Degrees of Freedom

These SOLUTION commands define master degrees of freedom.
MDefines master degrees of freedom for reduced and superelement generation analyses. 
MDELEDeletes master degrees of freedom. 
MGENGenerates additional master degrees of freedom from a previously defined set. 
MLISTLists the master degrees of freedom. 

Table 2.61: Rezoning

These SOLUTION commands apply to analyses that use rezoning.
REZONEInitiates a rezoning operation, sets rezoning options, and rebuilds the database. 
MAPSOLVEMaps the solved node and element solutions from an original mesh to a new mesh.  
MAPVARDefines tensors and vectors in user-defined state variables (for user-defined materials or user-defined creep laws). 
REMESHSpecifies the starting and ending remeshing points. 
AREMESHGenerates an area for creating a new mesh. 

Table 2.62: 2D to 3D Analysis

These SOLUTION commands apply to 2D to 3D analyses.
MAP2DTO3D

Initiates the 2D to 3D analysis process.

 

Table 2.63: Birth and Death

These SOLUTION commands are used for the birth and death option for elements.
EALIVEReactivates an element (for the birth and death capability). 
EKILLDeactivates an element (for the birth and death capability). 
ESTIFSpecifies the matrix multiplier for deactivated elements. 

Table 2.64: FE Constraints

These SOLUTION commands define constraints on the finite element model.
DDefines degree-of-freedom constraints at nodes. 
DCUMSpecifies that degree-of-freedom constraint values are to be accumulated. 
DDELEDeletes degree-of-freedom constraints. 
DFLXImposes a uniform magnetic flux B on an edge-element electromagnetic model. 
DJSpecify boundary conditions on the components of relative motion of a joint element. 
DJDELEDeletes boundary conditions on the components of relative motion of a joint element. 
DJLISTLists boundary conditions applied to joint elements. 
DLISTLists degree-of-freedom constraints. 
DSCALEScales degree-of-freedom constraint values. 
DSYMSpecifies symmetry or antisymmetry degree-of-freedom constraints on nodes. 
DVALDefines values at enforced group. 
GSBDATASpecifies the constraints or applies the load at the ending point for the generalized plane strain element option. 
GSLISTWhen using generalized plane strain, lists the input data or solutions. 
LDREADReads results from the results file and applies them as loads. 

Table 2.65: FE Forces

These SOLUTION commands define nodal loads on the finite element model.
FSpecifies force loads at nodes. 
FCUMSpecifies that force loads are to be accumulated. 
FDELEDeletes force loads on nodes. 
FJSpecify forces or moments on the components of the relative motion of a joint element. 
FJDELEDeletes forces (or moments) on the components of the relative motion of a joint element. 
FJLISTLists forces and moments applied on joint elements. 
FLISTLists force loads on the nodes. 
FSCALEScales force load values in the database. 

Table 2.66: FE Surface Loads

These SOLUTION commands define surface loads on the finite element model.
SFDefines surface loads on nodes. 
SFBEAMSpecifies surface loads on beam elements. 
SFCONTROLDefines surface load properties on selected elements and nodes for subsequent SF or SFE loading commands. 
SFCUMSpecifies that surface loads are to be accumulated. 
SFDELEDeletes surface loads. 
SFEDefines surface loads on elements.  
SFEDELEDeletes surface loads from elements. 
SFELISTLists the surface loads for elements. 
SFFUNSpecifies a varying surface load. 
SFGRADSpecifies a gradient (slope) for surface loads. 
SFLISTLists surface loads. 
SFSCALEScales surface loads on elements. 

Table 2.67: FE Body Loads

These SOLUTION commands define body loads on the finite element model.
BFDefines a nodal body-force load. 
BFCUMSpecifies that nodal body-force loads are to be accumulated. 
BFDELEDeletes nodal body-force loads. 
BFEDefines an element body-force load. 
BFECUMSpecifies whether to ignore subsequent element body-force loads. 
BFEDELEDeletes element body-force loads. 
BFELISTLists the element body-force loads. 
BFESCALScales element body-force loads. 
BFLISTLists the body-force loads on nodes. 
BFPORTTransfers a thermal body-force load (HGEN) load from selected MESH200 elements to reinforcing elements. 
BFSCALEScales body-force loads at nodes. 
BFUNIFAssigns a uniform body-force load to all nodes. 
LDREADReads results from the results file and applies them as loads. 
TUNIFAssigns a uniform temperature to all nodes. 

Table 2.68: Ocean

These SOLUTION commands define ocean load data.

OCDATADefines an ocean load using non-table data. 
OCDELETEDeletes a previously defined ocean load.  
OCLISTSummarizes all currently defined ocean loads. 
OCREADReads externally defined ocean data. 
OCTABLEDefines an ocean load using table data. 
OCTYPESpecifies the type of ocean load data to follow (basic, current, or wave). 
OCZONESpecifies the type of ocean zone data to follow (component, Z-level, or pipe) 

Table 2.69: Status

These SOLUTION commands are for use with the STAT command.
ATYPESpecifies "Analysis types" as the subsequent status topic. 
BIOOPTSpecifies "Biot-Savart options" as the subsequent status topic. 
DEACTSpecifies "Element birth and death" as the subsequent status topic. 
DYNOPTSpecifies "Dynamic analysis options" as the subsequent status topic. 
GENOPTSpecifies "General options" as the subsequent status topic. 
INRTIASpecifies "Inertial loads" as the subsequent status topic. 
LSOPERSpecifies "Load step operations" as the subsequent status topic. 
MASTERSpecifies "Master DOF" as the subsequent status topic. 
NLOPTSpecifies "Nonlinear analysis options" as the subsequent status topic. 
OUTOPTSpecifies "Output options" as the subsequent status topic. 
SMBODYSpecifies "Body loads on the solid model" as the subsequent status topic. 
SMCONSSpecifies "Constraints on the solid model" as the subsequent status topic. 
SMFORSpecifies "Forces on the solid model" as the subsequent status topic. 
SMSURFSpecifies "Surface loads on the solid model" as the subsequent status topic. 
SOLUOPTSpecifies "Solution options" as the subsequent status topic. 
SPTOPTSpecifies "Spectrum analysis options" as the subsequent status topic. 

Table 2.70: Radiosity

These SOLUTION commands calculate the radiation view factors and to specify the solution parameters for the Radiosity solver method.
HEMIOPTSpecifies options for Hemicube view factor calculation. 
RADOPTSpecifies Radiosity Solver options. 
RDECDefines the decimation parameters used by the radiosity solver method. 
RSOPTCreates or loads the radiosity mapping data file for SURF251 or SURF252 element types.  
RSURFGenerates the radiosity surface elements and stores them in the database. 
RSYMMDefines symmetry, rotation, or extrusion parameters for the radiosity method. 
SPCNODDefines a space node for radiation using the Radiosity method. 
SPCTEMPDefines a free-space ambient temperature for radiation using the Radiosity method. 
STEFSpecifies Stefan-Boltzmann radiation constant. 
V2DOPTSpecifies 2D/axisymmetric view factor calculation options. 
VFDISpecifies diagnostic options to check that the row sum relationship is satisfied. 
VFOPTSpecifies options for view factor file. 
QSOPTSpecifies quasi static radiation options. 
VFUPControls view factor updating at the substep level for a coupled-field radiation analysis that includes large-deflection effects. 

Table 2.71: Additive Manufacturing

These SOLUTION commands define options for additive manufacturing analysis.
AMBEAMFor multiple-beam printers, specifies the number of beams. 
AMBUILDSpecifies printer parameters for the build and other options. 
AMENVSpecifies the build-environment thermal boundary conditions. 
AMMATSpecifies the melting and relaxation temperatures of the build material in an additive manufacturing analysis. 
AMPOWDERSpecifies the powder thermal conditions. 
AMRESULTSpecifies result data written to an AMResults.txt file. 
AMSTEPSpecifies the process-sequence steps. 
AMSUPPORTSSpecifies the support information. 
AMTYPESpecifies the printing process.