Mapdl.upgeom(factor='', lstep='', sbstep='', fname='', ext='', **kwargs)

Adds displacements from a previous analysis and updates the geometry of

APDL Command: UPGEOM the finite element model to the deformed configuration.

  • factor – Multiplier for displacements being added to coordinates. The value 1.0 will add the full value of the displacements to the geometry of the finite element model. Defaults to 1.0.

  • lstep – Load step number of data to be imported. Defaults to the last load step.

  • sbstep – Substep number of data to be imported. Defaults to the last substep.

  • fname – File name and directory path (248 characters maximum, including the characters needed for the directory path). An unspecified directory path defaults to the working directory; in this case, you can use all 248 characters for the file name.

  • ext – Filename extension (eight-character maximum).


This command updates the geometry of the finite element model according to the displacement results of the previous analysis and creates a revised geometry at the deformed configuration. This command works on all nodes (default) or on a selected set of nodes. If this command is issued repeatedly, it creates a revised geometry of the finite element model in a cumulative fashion, i.e., it adds displacement results on the previously generated deformed geometry. The solid model geometry is not updated by this command.

When UPGEOM is issued, the current finite element model is overwritten by finite element information from the results file. For this reason, it is important that the finite element information in the results file matches the finite element model in which the nodal coordinates are being updated. No changes should be made to the model before the UPGEOM command is issued.