Sample UMAT XML file

The following sample XML, which you can modify, adds user-defined material properties to a new page named User Models - Simcenter Nastran that contains the following model types:

• None, which indicates that no user-defined material will be exported.

• User Defined Material, which indicates that a Simcenter Nastran MUMAT bulk entry will be exported.

For this example, the User Defined Material model type contains two models named Example Plasticity and Time Hardening (Norton-Bailey) Power Law that make up the entire material model. You can set Model 1 to Example Plasticity and Model 2 to Time Hardening (Norton-Bailey) Power Law, or only Model 1 or Model 2 to Example Plasticity or Time Hardening (Norton-Bailey) Power Law. Model 1 or Model 2 contains one or more groups for presentation and organization.

When the software loads the following XML example from the startup location, and you create a new material and select the User Models - Simcenter Nastran model type, the User Models - Simcenter Nastran page appears as follows:

The following lists some of the XML attributes and how they match options on the User Models - Simcenter Nastran page:

• The attribute appears as the Isotropic Properties group.

• The displayName attributes appear as labels, such as Yield Function Criterion, Hardening Rule, and so on.

• The valueChoices attributes appear as values in a list, such as von Mises in the Yield Function Criterion list.

The UMAT XML file also contains the mapping of the properties to the Simcenter Nastran MUMAT bulk entry.

The software exports labels or choices as floats, integers, or values assigned to the cardSpec attribute to the MUMAT bulk entry.

For each model, the numStateVariables attribute requests a number of State Variable Output Requests. The software and solver do not impose a limit on the maximum number of state variables. The numStateVariables value appears in the NUMSTAT field in the MUMAT bulk entry.

In the Manage Materials, Assign Materials, or Physical Properties dialog boxes, when you select one of the UMAT models, you specify the state variables in the Model 1 State Variable Output Requests and Model 2 State Variable Output Requests groups.

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE UserMaterialModels SYSTEM "nxnastran_umat.dtd"> <UserMaterialModels>      <UserMaterialModel modelType="&umatModel1;"                       lookupKey="ExamplePlasticityModel"                       KeyPosIntID="1"                       displayName="Example Plasticity"                       cardSpec="NLISO"                        numStateVariables="12">        <ValidMaterial type="&MaterialTypeISOTROPICLookUp;"/>         <ValidMaterial type="&MaterialTypeORTHOTROPICLookUp;"/>         <ValidMaterial type="&MaterialTypeDAMAGEINTERFACELookUp;"/>         <CardPropertyMapping type="&integer;"                             lookupKey="YieldFunctionCriterion"/>                                                 <CardPropertyMapping type="&integer;"                             lookupKey="HardeningRule"/>                                                 <CardPropertyMapping type="&integer;"                             lookupKey="TypeOfNonlinearity"/>                                                 <CardPropertyMapping type="&integer;"                             lookupKey="SSMethod"/>                                                 <CardPropertyMapping type="&real;"                             lookupKey="WorkHardeningSlope"/>                                                 <CardPropertyMapping type="&real;"                             lookupKey="InitialYieldLimit"/>                                                 <CardPropertyMapping type="&tableOfTables;"                             lookupKey="StressStrainTempTable"/>                                                 <CardPropertyMapping type="TABLES1"                             lookupKey="StressStrainTable"/>                                                 <Properties>            <Group label="Isotropic Properties">                <Property displayName="Yield Function Criterion"                          lookupKey="YieldFunctionCriterion"                          valueType="enum"                          valueChoices="&Choice;von Mises=1"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="1"/>                    <LowerBound value="1"                                inclusive="true" />                    <UpperBound value="1"                                inclusive="true" />                </Property>                <Property displayName="Hardening Rule"                          lookupKey="HardeningRule"                          valueType="enum"                          valueChoices="&Choice;Isotropic =1&Choice;Kinematic =2&Choice;Combined isotropic and kinematic hardening =3"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="1"/>                    <LowerBound value="1"                                inclusive="true" />                    <UpperBound value="3"                                inclusive="true" />                </Property>                <Property displayName="Type of Nonlinearity"                          lookupKey="TypeOfNonlinearity"                          valueType="enum"                          valueChoices="&Choice;Engineering Stress-Strain=1&Choice;Engineering Stress-Plastic Strain=2"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="1"/>                    <LowerBound value="1"                                inclusive="true" />                    <UpperBound value="2"                                inclusive="true" />                </Property>                                                     <Property displayName="Stress versus Strain input method"                          lookupKey="SSMethod"                          valueType="enum"                          valueChoices="&Choice;Work Hardening Slope=1&Choice;Stress Strain=2&Choice;Temperture Dependent Stress Strain=3"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="1"/>                    <LowerBound value="1"                                inclusive="true" />                    <UpperBound value="3"                                inclusive="true" />                 </Property>                 <Property displayName="Work Hardening Slope"                          lookupKey="WorkHardeningSlope"                          valueType="float"                          parentProperty="SSMethod"                          parentPropertyValToBeSensitive="1"                          Dimensions="&MeasureStress;">                    <DefaultValue value="&valueEmpty;"/>                    <LowerBound value="&minFloat;"                                inclusive="true" />                    <UpperBound value="&maxFloat;"                                inclusive="true" />                             </Property>                <Property displayName="Stress Strain"                          lookupKey="StressStrainTable"                          valueType="scalarField"                          parentProperty="SSMethod"                          parentPropertyValToBeSensitive="2"                          Dimensions="&MeasureStress;">                    <DefaultValue value="&valueEmpty;"/>                    <LowerBound value="&minFloat;"                                inclusive="true" />                    <UpperBound value="&maxFloat;"                                inclusive="true" />                    <FieldDefn>                        <Domain type="&DomainStrain;"/>                    </FieldDefn>                </Property>                <Property displayName="Temperture Dependent Stress Strain"                          lookupKey="StressStrainTempTable"                          valueType="scalarField"                          parentProperty="SSMethod"                          parentPropertyValToBeSensitive="3"                          Dimensions="&MeasureStress;">                    <DefaultValue value="&valueEmpty;"/>                    <LowerBound value="&minFloat;"                                inclusive="true" />                    <UpperBound value="&maxFloat;"                                inclusive="true" />                    <FieldDefn>                        <Domain type="&DomainTemperature;"                                hasSecondary="true">                                <SecondaryDomain type="&DomainStrain;"/>                        </Domain>                    </FieldDefn>                </Property>                <Property displayName="Initial yield limit"                          lookupKey="InitialYieldLimit"                          valueType="float"                          parentProperty="SSMethod"                          parentPropertyValToBeSensitive="1"                          Dimensions="&MeasureStress;">                    <DefaultValue value="&valueEmpty;"/>                    <LowerBound value="&minFloat;"                                inclusive="true" />                    <UpperBound value="&maxFloat;"                                inclusive="true" />                             </Property>                            </Group>        </Properties>    </UserMaterialModel>    <UserMaterialModel modelType="&umatModel2;"                       lookupKey="ExampleCreepModel"                       KeyPosIntID="2"                       displayName="Time Hardening (Norton-Bailey) Power Law"                       cardSpec="CREEP_NB"                        numStateVariables="10">        <ValidMaterial type="&MaterialTypeISOTROPICLookUp;"/>         <ValidMaterial type="&MaterialTypeORTHOTROPICLookUp;"/>         <ValidMaterial type="&MaterialTypeDAMAGEINTERFACELookUp;"/>         <Properties>            <Group label="A * ( SIGMA^n ) * ( time^m )">                         <Property displayName="Reference Temperature"                          lookupKey="ReferenceTemperature"                          valueType="float"                          Dimensions="&MeasureTemperature;">                    <DefaultValue value="0.0"/>                    <LowerBound value="&MinTemperature;"                                inclusive="true" />                    <UpperBound value="&maxFloat;"                                inclusive="true" />                             </Property>                <Property displayName="Temperature Dependent Term Formulation"                          lookupKey="TempDependTermType"                          valueType="enum"                          valueChoices="&Choice;exp( -DeltaH / ( R * T0 ))=0&Choice;DeltaH=1"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="1"/>                    <LowerBound value="1"                                inclusive="true" />                    <UpperBound value="3"                                inclusive="true" />                </Property>                <Property displayName="exp( -DeltaH / ( R * T0 ))"                          lookupKey="CreepTemperatureDependence"                          valueType="float"                          parentProperty="TempDependTermType"                          parentPropertyValToBeSensitive="0">                    <DefaultValue value="1.0E-9"/>                    <LowerBound value="0.0"                                inclusive="false"/>                    <UpperBound value="1.0"                                inclusive="true"/>                </Property>                <Property displayName="Delta H (per Mole)"                          lookupKey="CreepTemperatureDependenceDeltaH"                          valueType="float"                          Dimensions="&MeasureEnergy;"                          parentProperty="TempDependTermType"                          parentPropertyValToBeSensitive="1">                    <DefaultValue value="&valueEmpty;"/>                    <LowerBound value="&minFloat;"                                inclusive="false"/>                    <UpperBound value="&maxFloat;"                                inclusive="true"/>                </Property>                <Property displayName="Threshold Strain"                          lookupKey="CreepThreshold"                          valueType="float"                          Dimensions="&MeasureStrain;">                    <DefaultValue value="1.0E-5"/>                    <LowerBound value="0.0"                                inclusive="false"/>                    <UpperBound value="1.0E-3"                                inclusive="false"/>                </Property>            </Group>               <Group label="Power Law Creep Coefficients">                <Property displayName="Check Unit System"                          lookupKey="CheckUnitSystem"                          valueType="enum"                          valueChoices="&Choice;No=0;&Choice;Yes=1;"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="0"/>                    <LowerBound value="0"                                inclusive="true" />                    <UpperBound value="1"                                inclusive="true" />                </Property>                <Property displayName="Units(Force)(Length)(Mass)"                          lookupKey="ForceLengthMassUnits"                          valueType="enum"                          valueChoices="&Choice;(N)(m)(kg)=0&Choice;(lbf)(ft)(slug)=1&Choice;(kgf)(m)(kgf-s^2/m)=2&Choice;(poundal)(ft)(lbm)=3&Choice;(mN)(mm)(kg)=4&Choice;(cN)(cm)(kg)=5&Choice;(lbf)(in)(lbf-s^2/in)=6&Choice;(kgf)(mm)(kgf-s^2/mm)=7&Choice;(N)(mm)(tonne)=8"                          parentProperty="CheckUnitSystem"                          parentPropertyValToBeSensitive="1"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="1"/>                    <LowerBound value="0"                                inclusive="true" />                    <UpperBound value="1"                                inclusive="true" />                </Property>                 <Property displayName="Constant Multiplier (A)"                          lookupKey="PowerLawCreepParameter_A"                          valueType="float"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="&valueEmpty;"/>                    <LowerBound value="&valueZero;"                                inclusive="true" />                    <UpperBound value="&maxFloat;"                                inclusive="true" />                             </Property>                 <Property displayName="SIGMA Exponent (n)"                          lookupKey="PowerLawCreepParameter_n"                          valueType="float"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="&valueEmpty;"/>                    <LowerBound value="&valueZero;"                                inclusive="true" />                    <UpperBound value="&maxFloat;"                                inclusive="true" />                             </Property>                 <Property displayName="Hardening Exponent (m)"                          lookupKey="PowerLawCreepParameter_m"                          valueType="float"                          Dimensions="&MeasureUnitLess;">                    <DefaultValue value="&valueEmpty;"/>                    <LowerBound value="&valueZero;"                                inclusive="true" />                    <UpperBound value="&maxFloat;"                                inclusive="true" />                             </Property>             </Group>        </Properties>    </UserMaterialModel>    </UserMaterialModels>

Quick links

Command reference

Pre/Post video examples

Bulk Entry Descriptions

Simcenter 3D tutorials

Browse Simcenter 3D help by product area

Sample UMAT XML file, Simcenter 3D 2021.1 Series

© 2020 Siemens

window.mainLanguage="en_US"

window.delivId=""

window.projectId=""

MathJax.Hub.Config({ TeX: { extensions: ["autoload-all.js"] }, tex2jax: { displayMath: [ ] }, "SVG": { scale: 125 } });