*MaterialProperty()

Creates a material entity that can be used to assign a material for an NLFE body or certain type of graphics.

Syntax

*MaterialProperty(varname,"label",elastic_type)

Arguments

var_name
The variable name of the material property.
Data type: varname
label
The descriptive label of the material property.
Data type: label
elastic_type
The material elasticity model of the material type. Available options are: LINEAR for linear elastic material and HYPER for hyper elastic material.
Data type: Keyword

Example

In the example below a material property is created and is referenced by an NLFE body:
*BeginMDL( the_model, "Model", )
 *StandardInclude(FILE)
 *SetCurrentSolverMode(MotionSolve)
 *Point( p_0, "Point 0" )
 *Point( p_1, "Point 1" )
 *Point( p_2, "Point 2" )
 *Point( p_3, "Point 3" )
 *Point( p_4, "Point 4" )
 *LDBody( ldb_0, "LDBody 0", p_0, p_1, p_2, p_3, p_4 )
*MaterialProperty( propmat_Steel1, "Steel 1", LINEAR )
 *SetPoint( p_1, 10 )
 *SetPoint( p_2, 20 )
 *SetPoint( p_3, 30 )
 *SetPoint( p_4, 40 )
 *SetOrientation( ldb_0.orient_end, TWOAXES, XY, DXDYDZ, ldb_0.pt4.x - ldb_0.pt3.x, ldb_0.pt4.y - ldb_0.pt3.y, ldb_0.pt4.z - ldb_0.pt3.z, DXDYDZ, 0.0, 1.0, 0.0 )
 *SetOrientation( ldb_0.orient_start, TWOAXES, XY, POINT, ldb_0.pt1, DXDYDZ, 0.0, 1.0, 0.0 )
 *SetMaterialProperty( propmat_Steel1, ISO, 210500.0, 0.29, 7.82e-6 )
 *SetLDBody( ldb_0, CIRCULAR, 20, 10, 30, 25, 0.03, propmat_Steel1 )
*EndMDL()

Context

*BeginMdl()

Properties

Table 1.
Property Returns Data Type Description
label string The label of the material property.
elastic_type keyword LINEAR - for a linear elastic material

HYPER - for a hyper elastic material

Properties applicable for Linear-elastic material (LINEAR)
Table 2.
Property Returns Data Type Description
isotropic_type keyword ISO - for isotropic material

ANISO - for anisotropic material

ORTHO - for orthotropic material

Properties applicable for Linear-elastic Isotropic material (ISO)
Table 3.
Property Returns Data Type Description
elasticity real Young's modulus.
poisson_ratio real Poisson's ratio.
density_rho real The material density.
Properties applicable for Linear-elastic Anisotropic material (ANISO)
Table 4.
Property Returns Data Type Description
g11, g12, g13, g14, g15, g16

g22, g23, g24, g25, g26

g33, g34, g35, g36

g44, g45, g46

g55, g56

g66

real gij where i, j = 1, 2,...,6; i ≤ j.

Elements of the stiffness matrix of the anisotropic material.

density_rho real The material density.
Properties applicable for Linear-elastic Orthotropic material (ORTHO)
Table 5.
Property Returns Data Type Description
elasticity_rx real Young's modulus in the rx direction.
elasticity_ry real Young's modulus in the ry direction.
elasticity_rz real Young's modulus in the rz direction.
shear_rx_ry real Shear modulus in the plane rx - ry.
shear_rx_rz real Shear modulus in the plane rx - rz.
shear_ry_rz real Shear modulus in the plane ry - rz.
poisson_ratio_rx real Poisson's ratio for uniaxial loading in the rx direction.
poisson_ratio_ry real Poisson's ratio for uniaxial loading in the ry direction.
poisson_ratio_rz real Poisson's ratio for uniaxial loading in the rz direction.
density_rho real The material density.
Properties applicable for Hyper-elastic material (HYPER)
Table 6.
Property Returns Data Type Description
hyperelastic_type keyword NHI - Incompressible Neo-Hookean material model

NHC - Compressible Neo-Hookean material model

MR - Mooney-Rivlin material model

YEOH - Yeoh material model

Properties applicable for Incompressible Neo-Hookean Material Model (NHI)
Table 7.
Property Returns Data Type Description
shear real Shear modulus.
poisson_ratio real Poisson's ratio.
density_rho real The material density.
Properties applicable for Compressible Neo-Hookean Material Model (NHC)
Table 8.
Property Returns Data Type Description
shear real Shear modulus.
poisson_ratio real Poisson's ratio.
density_rho real The material density.
Properties applicable for Mooney-Rivlin Material Model (MR)
Table 9.
Property Returns Data Type Description
mu01 real Material constant μ01 of the Mooney-Rivlin model.
mu10 real Material constant μ10 of the Mooney-Rivlin model.
poisson_ratio real Poisson's ratio.
density_rho real The material density.
Properties applicable for Yeoh Material Model (YEOH)
Table 10.
Property Returns Data Type Description
c10 real Material constant c10 of Yeoh model.
c20 real Material constant c20 of Yeoh model.
c30 real Material constant c30 of Yeoh model.
poisson_ratio real Poisson's ratio.
density_rho real The material density.

Comments

A material property can be used in a Cylinder, Box, Sphere, and CADGraphic type of graphic entity.

When any graphic of the above mentioned types has a material property assigned to it, their parent bodies properties can be automatically calculated using the data member.

The properties of the material can be set using the *SetMaterialProperty() statement.

MotionView provides commonly used material properties by default.

When used on an NLFE body, MotionView will export the material properties to the NLFE XML as relevant material cards, such as MAT2 and MAT6. Refer to MotionSolve NLFE reference manual for additional information.

Currently, defining a material under a system or assembly is not allowed.