5. Commands

This section describes changes to commands at Release 2024 R2:

Some commands are inaccessible from menus and are available via the command-input field or batch-file input only. The documentation for each command indicates menu path information, if available.

5.1. New Commands

The following new commands are available:

  • EENS – Evaluates element solutions based on assumed element deformation.

  • MSHOPTIM – Optimizes a selected mesh based on predefined finite element specifications.

  • RBGEN – Creates rigid bodies from pre-meshed element components.

  • SCCONNECT – Specifies system coupling connection parameters.

5.2. Modified Commands

The following commands have been enhanced or otherwise modified:

  • ADPCI – Defines parameters associated with adaptive crack initiation. A new option (Action = FCRI) enables you to define an inline material criterion for initializing a crack (instead of creating a new material data table via TB,CRKI).

  • AWAVE – Specifies input data for an acoustic incident wave. Use the new option, KCN, to designate a coordinate system for the direction of normal velocity for a back enclosed loud speaker (Wavetype = BACK).

  • EBLOCK – Defines a block of elements. A new COMPACT keyword makes the elements part of a compact format where the first field is the element number and the remaining fields are the node numbers.

  • CDWRITE – Writes geometry and load database items to a file. A new option (CDWRITE,,,,,,,BINARY) is available to write .cdb files in binary format when applicable. The blocked format is used in the other cases.

  • CINT – Defines parameters associated with fracture-parameter calculations. A new SMOOTH option is available for fracture-parameter data smoothing.

  • CLOAD – Initiates a cyclic-loading analysis. The command now enables you to modify default time-stepping and predictor behaviors when appropriate for a given analysis.

  • CMACEL – Specifies the translational acceleration of an element component. A new option (CMACEL,,DELETE) is available to delete the translational acceleration from all components.

  • CMOMEGA – Specifies the rotational velocity of an element component. A new option (CMOMEGA,,DELETE) is available to delete the rotational velocity from all components.

  • CMDOMEGA – Specifies the rotational acceleration of an element component. A new option (CMDOMEGA,,DELETE) is available to delete the rotational acceleration from all components.

  • CNCHECK – Quickly apply the same pinball value to all the selected contact pairs during the trim process, and perform additional contact trim before the contact split operation.

  • /CONFIG – Assigns values to Mechanical APDL configuration parameters. A new option (/CONFIG,RESUPREC) is available to control the precision when the program writes the results file.

  • *DIM – Defines an array parameter and its dimensions. The argument PAR now supports up to 240 characters for table parameter names. The Mechanical APDL GUI cannot fully display parameter names that are longer than 32 characters.

  • HBMOPT – Specifies solution options for a harmonic balance method (HBM) analysis. A new option (HBMOPT,CYCLIC) is available to activate an HBM cyclic symmetry analysis.

  • HROPT – Specifies harmonic analysis options. The command now supports a new harmonic nonlinear acoustic method, Method = HNLA.

  • INISTATE – Defines initial-state data and parameters. The command can now apply an initial-deformation gradient for hyperelasticity-based material models.

  • MP – Defines a linear material property as a constant or a function of temperature. Two new material property labels (BETW and SDIF) are available to define terms used in the Westervelt Equation for harmonic nonlinear acoustic analyses.

  • OSRESULT – Controls the selected result data written to the database. New Item and Component labels have been added for more robust result-data control.

  • PCGOPT – Controls PCG solver options. The PCG solver now supports certain PLANE/SOLID/MPC element types that use the mixed u-P (Lagrange multipliers) formulation when LM_Key = OFF (new default).

  • RSURF – Generates the radiosity surface elements and stores them in the database. Use the new DKEY argument to enable or disable displacement degrees of freedom (DOFs) on the radiosity surface elements (SURF251 / SURF252) when they are generated (equivalent to setting KEYOPT(1) after they are generated). Displacement DOFs are required to recalculate view factors at the substep level (VFUP,DEFINE,ON).

  • RSYMM – Defines symmetry, rotation, or extrusion parameters for the radiosity method. Use the new TOLER field to increase the tolerance and compensate for a slightly offset local coordinate system when generating radiosity surface elements for planar or cyclic reflection.

  • TBFT – Performs material curve-fitting operations. The command now supports anisotropic hyperelastic material models and AI-based parameter initialization.

  • NLADAPTIVE – Defines the criteria under which the mesh is refined or modified during a nonlinear solution. A new REMELM criterion is available for element removal with three options, ESTN, PSTN, and MANUAL.

  • NLMESH – Controls remeshing in nonlinear adaptivity. A new DCON control is available for automatic contact and target element generation in gaps created in the element removal process using the NLADAPTIVE command.

5.3. Undocumented Commands

No commands have been undocumented at this release.

For information about commands that have been undocumented in prior releases, see the archived release notes for Mechanical APDL.