Material Setup

The material setup section is defined within:

<MaterialSetup type="EN">
    ….
    ….
</MaterialSetup>

Table 1. <MaterialSetup> Attributes
Attribute	Value Values	Command
type	"EN"	Mandatory

The <MaterialSetup> tag is defined by:

Table 2.
Element Tag	Valid Values	Comment
<UserMaterialFile>	Valid Material file path	Optional
<EntityList>	NA	Mandatory Compound Element

User-Defined Material File

The user-defined materials are optional.

The user-defined materials can be added by providing a valid .csv filepath.

<UserMaterialFile>C:/Documents/Materials.csv</UserMaterialFile>

Entity List

The entity list is defined as:

<EntityList evaltype="Parts">
    ….
    ….
</EntityList>

The entity list section has the following attributes:


Attribute	Valid Values	Comment
evaltype	"Parts"	Mandatory

For Selecting Parts

<EntityList evaltype="Parts">
    ….
    ….
</EntityList>

Entity

The entity element tag is defined as:

<entity id="1" matname="Mat_SN(1)" name="part_1” poolname="Global" FL="0"         
    Findley="0.3" Kf="1" Offset="0" SE="0.3" Scale="1" TF="0">
    ….
    ….
    ….
</entity>

A valid name must be keyed in to the matname. The material name can be specified from the user-defined materials (.csv/.xml) file or from the HyperLife Material database.

Note: HyperLife evaluation will error out with a warning to log file when a user-defined material is not found in the assigned User Defined material file (.xml).

Table 3.

name	Valid Part name in model file	Either name or id is Mandatory. If both are given, id will be used
id	Valid Part id in model file
poolname	Valid poolname for the entity type	Optional Note: If no poolname is given, default poolname of the entity will be assumed.
Scale	Valid value	NA

Table 4. SN Material Attributes (Valid Only for SN Analysis)
Attribute	Valid Values
FL	0 < Value
SE	0 =< Value
Findley	0 =< Value
TF	0 =< Value
Kf	1.0 =< Value

Table 5. EN Material Attributes (Valid Only for EN Analysis)
Attribute	Valid Values
SEe	0 =< Value
SEp	0 =< Value
Kf	1.0 =< Value

Note: The following are optional child elements of the Entity element.

Surface Finish

The Surface Finish element tag is defined as:

<SurfaceFinish Option="NONE">0.1</SurfaceFinish>


Element Tag	Valid Values
<SurfaceFinish> Option	"NONE "POLISH" "GROUND" "MACHINE" "HOTROLL" "FORGE" "USER"
Value	0 < Value <1.0

Surface Treatment

The Surface Treatment element tag is defined as:

<SurfaceTreatment Option="NONE">0.1</SurfaceTreatment>


Element Tag	Valid Values
<SurfaceTreatment> Option	"NONE" "NITRIDED" "SHOTPEEN" "COLDROLL" "USER"
Value	0 < Value < 2.0

Temperature Factor

The Temperature Factor element tag is defined as:

<TemperatureFactor Option="NONE"></TemperatureFactor>

There are three options available for temperature factor:

NONE
User Defined
FKM

Temperature factor: NONE

<TemperatureFactor Option="NONE"></TemperatureFactor>


Element Tag	Valid Values
<TemperatureFactor> Option	"NONE"
Value	0.1 (Default)

Temperature factor: USER DEFINED

<TemperatureFactor Option="USER DEFINED" Value="1"></TemperatureFactor>


Element Tag	Valid Values
<TemperatureFactor> Option	"USER DEFINED"
Value	0 < Value < 1.0

Temperature factor: FKM

<TemperatureFactor Option="FKM">
    <Temperature Option="ISOTHERMAL">150</Temperature>
    <Type>FINEGRAIN STRUCTURAL STEEL</Type>
</TemperatureFactor>


Element Tag	Valid Values	Valid Temperature Values
<TemperatureFactor> Option	"FKM"	NA
<Temperature> Option	"ISOTHERMAL"	NA
<Type>	"OTHER STEELS" "GJL" "GJS" "GJ" "GJM"	150 (default) 100 < Value < 500
	"FINEGRAIN STRUCTURAL STEEL"	150 (default) 60 < Value < 500
	"ALUMINIUM MATERIALS"	150 (default) 50 < Value < 200