Mapdl.atan(ir='', ia='', name='', facta='', **kwargs)

Forms the arctangent of a complex variable.

APDL Command: ATAN

  • ir – Arbitrary reference number assigned to the resulting variable (2 to NV [NUMVAR]). If this number is the same as for a previously defined variable, the previously defined variable will be overwritten with this result.

  • ia – Reference number of the complex variable to be operated on.

  • name – Thirty-two character name for identifying the variable on the printout and displays. Embedded blanks are compressed upon output.

  • facta – Scaling factor (positive or negative) applied to variable IA (defaults to 1.0). Usually FACTA should be set to 1. FACTA may affect the position of the angle by a multiple of π, resulting in a quadrant change.


Forms the arctangent of a complex variable according to the operation:


where a and b are the real and imaginary parts, respectively, of the complex variable IA (which is of the form a + ib). The arctangent represents the phase angle (in radians), and is valid only for a harmonic analysis (ANTYPE,HARMIC).

Since the scaling factor is applied uniformly to b/a, applying any positive or negative scaling factor will not affect the size of the phase angle, with the exception that a negative scaling factor will change the results quadrant by : π. The magnitude of a complex number is still obtained through the ABS command. See POST26 - Data Operations in the Mechanical APDL Theory Reference for details.