ansys.mapdl.core.Mapdl.cmap#

Mapdl.cmap(fname='', ext='', kywrd='', ncntr='', **kwargs)#

Changes an existing or creates a new color mapping table.

Mechanical APDL Command: /CMAP

Command default:

Use predefined Mechanical APDL color map table.

Parameters:

fnamestr

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. If blank, restore color map.

extstr

Filename extension (eight-character maximum).

kywrdstr

Keyword indicating the disposition of the color map file.

• (blank) - Loads existing color map file.

• CREATE - Starts the CMAP utility and modifies or creates the specified file.

• SAVE - Writes the active color map to the specified file, which can be imported into future sessions.

ncntrstr

Number of contours to be defined. Default = 9 (even if an existing file is being modified). Maximum = 128.

Notes

Reads the color map file (RGB index specifications) to change from current specifications. Only one color map may be active at a time.

For 2D drivers (especially Win32c), modifying the color map can produce anomalies, including legend/contour disagreement.

When Kywrd equals CREATE, the 2D drivers (X11c and Win32c) display the CMAP utility with an additional contour color picker called CONTOURS. Colors selected via the CONTOURS picker affect result contour displays (such as stresses). No other drivers offer the CONTOURS picker in the CMAP utility.

Changing the color map using the cmap command changes the meaning of the color labels on the color command. See color for other color controls.

This command is valid anywhere.