Difference between revisions of "Material Models"
Jump to navigation
Jump to search
Scripted Input Commands
| Line 3: | Line 3: | ||
== Define a Material == | == Define a Material == | ||
<h3>Scripted Input Commands< | <h3>Scripted Input Commands<h3> | ||
To use a material in calculations, you first must define it in the input commands. This definition will create a material ID (any string or number) that can be used to assign that material to particles. When using [[NairnFEAMPM]] or [[NairnFEAMPMViz]], a material is created with the command block: | To use a material in calculations, you first must define it in the input commands. This definition will create a material ID (any string or number) that can be used to assign that material to particles. When using [[NairnFEAMPM]] or [[NairnFEAMPMViz]], a material is created with the command block: | ||
| Line 22: | Line 22: | ||
Each material property is specified on a line with a property name and its value. Refer to each [[#toc|material type]] to see the available properties and which ones are required properties. The property names are case sensitive (although [[NairnFEAMPM]] can usually handle any case). | Each material property is specified on a line with a property name and its value. Refer to each [[#toc|material type]] to see the available properties and which ones are required properties. The property names are case sensitive (although [[NairnFEAMPM]] can usually handle any case). | ||
<h3>XML Input Comands< | <h3>XML Input Comands<h3> | ||
A material definition in a <code>XML</code> input file has the form: | A material definition in a <code>XML</code> input file has the form: | ||
Revision as of 18:41, 22 March 2013
Numerous material models are available in NairnMPM and OSUParticulas.
Define a Material
Scripted Input Commands
To use a material in calculations, you first must define it in the input commands. This definition will create a material ID (any string or number) that can be used to assign that material to particles. When using NairnFEAMPM or NairnFEAMPMViz, a material is created with the command block:
Material ID,name,type
Property value
Property2 value
.
.
Done
where
ID is the material ID (any string or number) that is used to reference this material in other commands.name is a name that will appear in output files to describe the materialtype is the type of material, which can be set by material type name or number from the available material models.
Each material property is specified on a line with a property name and its value. Refer to each material type to see the available properties and which ones are required properties. The property names are case sensitive (although NairnFEAMPM can usually handle any case).
XML Input Comands
A material definition in a XML input file has the form:
<Material Type='1' Name='Polymer'>
<Property>value</Property>
<Property2>value</Property2>
.
.
</Material>
where
Type is the material type and must be entered by number corresponding to that material models.Name is any user-defined description of the material.
Each material property is specified in a single XML element matching the property name and the content of the element as the value. Refer to each material type to see the available properties and which ones are required properties.
Note that in XML files a material does not have an ID that is use in scripting files to refer to that material in other commands. Instead, other XML commands refer to defined materials by number or name as follows:
- By Numbers
- In this method, you use
mat='#' attributes to refer to materials where # is the material number. The materials are defined by numbers in the order they appear in the output file with the first material being number 1. You have to be careful to use the correct number. If you add new materials to a file, it is best to add them to the end of the materials list, otherwise previous commands that referenced materials after an inserted material, will point to the wrong material.
- By Name
- In this method, you use
matname='Mat_Name' attributes where 'Mat_Name' matches the Name attribute of any defined material in the file. You can use these names even before the materials are defined, but an error will occur if you reference materials that are never defined. When referring to materials by name, you must be certain that all material Name attributes have unique strings.
When referring to materials by name, the defined materials will appear in the output file in the ordered referenced rather than in the order defined in the input file. For this reason, you should not refer to some materials by name and others by number in the same file. The eventual ordering will likely mean the numbers will refer to the wrong material. The naming method is preferred in hand-edited XML files. If you use both mat and matname attributes in a single element, the matname attribute will be used and the mat will be ignored.
Linear Elastic Small Strain Materials
Hyperelastic Materials
Elastic-Plastic Small Strain Materials
Hyperelastic-Plastic Materials
Viscoelastic Materials
Rigid Materials
IDis the material ID (any string or number) that is used to reference this material in other commands.nameis a name that will appear in output files to describe the materialtypeis the type of material, which can be set by material type name or number from the available material models.
XML input file has the form:
<Material Type='1' Name='Polymer'>
<Property>value</Property>
<Property2>value</Property2>
.
.
</Material>
where
Typeis the material type and must be entered by number corresponding to that material models.Nameis any user-defined description of the material.
XML element matching the property name and the content of the element as the value. Refer to each material type to see the available properties and which ones are required properties.
Note that in XML files a material does not have an ID that is use in scripting files to refer to that material in other commands. Instead, other XML commands refer to defined materials by number or name as follows:
- By Numbers
- In this method, you use
mat='#'attributes to refer to materials where # is the material number. The materials are defined by numbers in the order they appear in the output file with the first material being number 1. You have to be careful to use the correct number. If you add new materials to a file, it is best to add them to the end of the materials list, otherwise previous commands that referenced materials after an inserted material, will point to the wrong material. - By Name
- In this method, you use
matname='Mat_Name'attributes where'Mat_Name'matches theNameattribute of any defined material in the file. You can use these names even before the materials are defined, but an error will occur if you reference materials that are never defined. When referring to materials by name, you must be certain that all materialNameattributes have unique strings.
XML files. If you use both mat and matname attributes in a single element, the matname attribute will be used and the mat will be ignored.