Mapdl.monitor(var='', node='', lab='', **kwargs)#

Controls contents of three variable fields in nonlinear solution

APDL Command: MONITOR monitor file.


One of three variable field numbers in the monitor file whose contents can be specified by the Lab field. Valid arguments are integers 1, 2, or 3. See Notes section for default values.


The node number for which information is monitored in the specified VAR field. In the GUI, if Node = P, graphical picking is enabled. If blank, the monitor file lists the maximum value of the specified quantity (Lab field) for the entire structure.


The solution quantity to be monitored in the specified VAR field. Valid labels for solution quantities are UX, UY, and UZ (displacements); ROTX, ROTY, and ROTZ (rotations); and TEMP (temperature). Valid labels for reaction force are FX, FY, and FZ (structural force) and MX, MY, and MZ (structural moment). Valid label for heat flow rate is HEAT. For defaults see the Notes section.


The monitor file always has an extension of .mntr, and takes its file name from the specified Jobname. If no Jobname is specified, the file name defaults to file.

You must issue this command once for each solution quantity you want to monitor at a specified node at each load step. You cannot monitor a reaction force during a linear analysis. The variable field contents can be redefined at each load step by reissuing the command. The monitored quantities are appended to the file for each load step.

Reaction forces reported in the monitor file may be incorrect if the degree of freedom of the specified node is involved in externally defined coupling (CP command) or constraint equations (CE command), or if the program has applied constraint equations internally to the node.

The following example shows the format of a monitor file. Note that the file only records the solution substep history when a substep is convergent.

The following details the contents of the various fields in the monitor file:

The current load step number.

The current substep (time step) number.

The number of attempts made in solving the current substep. This number is equal to the number of failed attempts (bisections) plus one (the successful attempt).

The number of iterations used by the last successful attempt.

Total cumulative number of iterations (including each iteration used by a bisection).


Time or load factor increments for the current substep.

Total time (or load factor) for the last successful attempt in the current substep.

Variable field 1. In this example, the field is reporting the UZ value. By default, this field lists the CPU time used up to (but not including) the current substep.

Variable field 2. In this example, the field is reporting the MZ value. By default, this field lists the maximum displacement in the entire structure.

Variable field 3. By default (and in the example), this field reports the maximum equivalent plastic strain increment in the entire structure.