Mapdl.annot(lab='', val1='', val2='', **kwargs)#

Activates graphics for annotating displays (GUI).

APDL Command: /ANNOT


Annotation control key:

OFF - Turns off annotation for each subsequent display (default).

ON - Turns on annotation for each subsequent display.

DELE - Deletes all annotation.

SAVE - Saves annotation on a file. Use VAL1 for file name (defaults to Jobname) and

VAL2 for the extension (defaults to ANO).

SCALE - Sets annotation scale factor (direct input only). Use VAL1 for value (0.1 to

10.0) (defaults to 1.0).

XORIG - Sets the annotation x origin (direct input only). Use VAL1 for value (-3.0 to


YORIG - Sets annotation y origin (direct input only). Use VAL1 for value (-3.0 to


SNAP - Sets annotation snap (menu button input only). Use VAL1 for value (0.002 to

0.2) (defaults to 0.002).

STAT - Displays current annotation status.

DEFA - Sets annotation specifications to the default values.

REFR - Redisplays annotation graphics.

TMOD - Sets the annotation text mode. If VAL1 = 1, annotation text will be drawn in

scalable bitmap fonts (default). If VAL1 = 0, annotation text will be drawn with stroke text.


Value (or file name) as noted with label above.


Value (or file name extension) as noted with label above.


This is a command generated by the GUI and will appear in the log file (Jobname.LOG) if annotation is used. This command is not intended to be typed in directly in an ANSYS session (although it can be included in an input file for batch input or for use with the /INPUT command).

You cannot use the “!” and “$” characters in ANSYS text annotation.

/ANNOT activates annotation graphics for adding annotation to displays. Commands representing the annotation instructions are automatically created by the annotation functions in the GUI and written to Jobname.LOG. The annotation commands are /ANNOT, /ANUM, /TLABEL, /LINE, /LARC, /LSYMBOL, /POLYGON, /PMORE, /PCIRCLE, /PWEDGE, /TSPEC, /LSPEC, and /PSPEC. Annotation graphics are relative to the full Graphics Window and are not affected by ANSYS window-specific commands (/WINDOW, /VIEW, etc.).

This command is valid in any processor.