Mapdl.numexp(num='', begrng='', endrng='', elcalc='', **kwargs)

Specifies solutions to be expanded from mode-superposition analyses or

APDL Command: NUMEXP substructure analyses.


The number of solutions to expand. This value is required.

Num - Number of solutions to expand.

ALL - Expand all substeps between BEGRNG and ENDRNG (provided that ENDRNG > 0). If

BEGRNG and ENDRNG have no specified values, this option expands all substeps of all load steps.

begrng, endrng

Beginning and ending time (or frequency) range for expanded solutions. The default is 0 for both values.


The element-calculation key:

YES - Calculate element results, nodal loads, and reaction loads. This value is the


NO - Do not calculate these items.


Specifies a range of solutions to be expanded from analyses that use mode-superposition methods (ANTYPE,HARMIC or TRANS) or substructuring (ANTYPE,SUBSTR).

For ANTYPE,TRANS, NUM, evenly spaced solutions are expanded between time BEGRNG and time ENDRNG.

For ANTYPE,HARMIC, NUM, evenly spaced solutions are expanded between frequency BEGRNG and frequency ENDRNG.

The first expansion in all cases is done at the first point beyond BEGRNG (that is, at BEGRNG + (ENDRNG - BEGRNG) / NUM)).

The resulting results file will maintain the same load step, substep, and time (or frequency) values as the use pass.

For a single expansion of a solution, or for multiple expansions when the solutions are not evenly spaced (such as in a mode-superposition harmonic analysis with the cluster option), ANSYS, Inc. recommends issuing one or more EXPSOL commands.

The NUMEXP command is invalid in these cases:

In a substructing analysis (ANTYPE,SUBST) when a factorized matrix file (the .LN22 file generated by the sparse solver) does not exist, causing ANSYS to employ the full-resolve method.

If the full-resolve option is selected using the SEOPT command.

In both situations, use the EXPSOL command to perform a single expansion for each solution desired.

This command is also valid in PREP7.