Mapdl.inistate(action='', val1='', val2='', val3='', val4='', val5='', val6='', val7='', val8='', val9='', **kwargs)

Defines initial state data and parameters.



Specifies action for defining or manipulating initial state data:

SET - Use Action = SET to designate initial state coordinate system, data type, and

material type parameters. See “Command Specification for Action = SET”.

DEFINE - Use Action = DEFINE to specify the actual state values, and the corresponding

element, integration point, or layer information. See “Command Specifications for Action = DEFINE”.

WRITE - Use Action = WRITE to write the initial state values to a file when the SOLVE

command is issued. See “Command Specifications for Action = WRITE”.

READ - Use Action = READ to read the initial state values from a file. See “Command

Specifications for Action = READ”.

LIST - Use Action = LIST to read out the initial state data. See “Command

Specifications for Action = LIST”.

DELETE - Use Action = DELE to delete initial state data from a selected set of elements.

See “Command Specifications for Action = DELETE”

val1, val2, …, val9

Input values based on the Action type.


The INISTATE command is available for current-technology elements. Initial state supported for a given element is indicated in the documentation for the element under “Special Features.”

The command is not for use with kinematic hardening material properties (TB,BKIN, TB,KINH, TB,PLAS,,,,KINH) or the shape memory alloy material model (TB,SMA).

INISTATE with elastic strain alone is not supported for gasket materials (TB,GASK) and hyperelastic materials (TB,HYPER, TB,BB, TB,AHYPER, TB,CDM, TB,EXPE).

INISTATE with initial stress alone is not supported for gasket materials (TB,GASK).

INISTATE with plastic strain (which must include initial strain or stress, plastic strain, and accumulated plastic strain) does not support gasket materials (TB,GASK), porous media (TB,PM), rate- dependent plasticity (TB,RATE), and viscoplasticity (TB,PRONY, TB,SHIFT).

For detailed information about using the initial state capability, see Initial State in the Basic Analysis Guide.