ansys.mapdl.core.Mapdl.mapvar

Mapdl.mapvar(option='', matid='', istrtstress='', ntenstress='', istrtstrain='', ntenstrain='', istrtvect='', nvect='', **kwargs)

Defines tensors and vectors in user-defined state variables for rezoning and in 2D to 3D analyses.

Mechanical APDL Command: MAPVAR

Parameters:

optionstr

• DEFINE - Define variables for the specified MatId material ID (default).

• LIST - List the defined variables for the specified MatId material ID.

matidstr

The material ID for the state variables which you are defining ( Option = DEFINE) or listing ( Option = LIST).

When Option = LIST, the default value for this argument is ALL (which lists all defined variables). When Option = DEFINE, you must explicitly specify a material ID.

istrtstressstr

The start position of stress-like tensors in the state variables. This value must be either a positive integer or 0 (meaning no stress-like tensors).

ntenstressstr

The number of stress-like tensors in the state variables. This value must be either a positive integer (or 0), and all stress-like tensors must be contiguous.

istrtstrainstr

The start position of strain-like tensors in the state variables. This value must be either a positive integer or 0 (meaning no strain-like tensors).

ntenstrainstr

The number of strain-like tensors in the state variables. This value must be either a positive integer (or 0), and all strain-like tensors must be contiguous.

istrtvectstr

The start position of vectors in the state variables. This value must be either a positive integer or 0 (meaning no vectors).

nvectstr

The number of vectors in the state variables. This value must be either a positive integer (or 0), and all vectors must be contiguous.

Notes

The mapvar command identifies the tensors and vectors in user-defined state variables ( tb,STATE) for user-defined materials ( tb,USER and UserMat or UserMatTh ) or user- defined creep laws ( tb,CREEP,,,,100 and UserCreep ).

To handle large-rotation effects and to correctly differentiate between tensor- and vector-mapping, specify the start position of specific state variables. For stress-like tensors, the shear components saved as state variables are the tensor component. For strain-like tensors, the shear components saved as state variables are twice the tensor components. Therefore, issue the mapvar command to define the stress-like and strain-like tensors individually. The command ensures that user-defined state variables are mapped correctly during rezoning and in 2D to 3D analyses.

In a rezoning operation, mapvar must be issued after remeshing ( remesh,FINISH) but before mapping ( mapsolve ).