************************* MatML_Doc *************************
This element declares the content model for MatML_Doc, topmost in the
hierarchy of elements that comprise a document marked up using MatML.
Content models describe the relationships of the element and its child
elements. MatML_Doc must contain one or more Material elements.
************************* Material *************************
This element declares the content model for Material, which contains
materials data. Material has three optional attributes.
The first attribute, id, may be used as an identification specifier for the
material, which is especially useful for complex systems such as
composite laminates.
The second attribute, layers, may be used to indicate the number of
layers in complex systems such as composite laminates.
The third attribute, local_frame_of_reference, may be used as an
identification specifier for the local material orientation relative to the
global frame of reference, which is especially useful for complex
systems such as anisotropic materials.
Material is composed of the following elements.
BulkDetails contains a description of the bulk material and must occur
once and only once within the Material element. For additional
information, see the documentation for the BulkDetails element.
ComponentDetails contains a description of a component within the
bulk material and may occur zero or more times within the Material
element. ComponentDetails may be used to describe complex materials
systems such as welds (e.g. the base metal, the heat affected zone,
and the weld metal) or composites (e.g. the whiskers, fibers, and
matrix of a fiber-reinforced composite material). For additional
information, see the documentation for the ComponentDetails
element.
Metadata contains descriptions of the data sources, properties,
measurement techniques, specimens, and parameters which are
referenced when materials property data are encoded using the
PropertyData element. Metadata may occur once or not at all within the
Material element. For more information, see the documentation for the
Metadata element.
Graphs contains descriptions of two dimensional graphics and may
occur once or not at all within the Material element. For additional
information, see the documentation for the Graphs element.
Glossary contains descriptions of the material and property terms
used in the document and may occur once or not at all within the
Material element. For additional information, see the documentation
for the Glossary element.
************************* BulkDetails *************************
This element declares the content model for BulkDetails, which
contains a description of the bulk material and is composed of the
following elements.
Name contains the material's name and has one optional attribute,
authority, for identifying an authoritative source of material
names. Name must occur once and only once within the BulkDetails
element.
Class contains the material's class and may occur once or not at all
within the BulkDetails element.
Subclass contains the material's subclass(es) and may occur zero
or more times within the BulkDetails element.
Specification contains the material's specification(s) and has one
optional attribute, authority, for identifying an authoritative
source of material specifications. Specification may occur zero or
more times within the BulkDetails element.
Source contains the name of the source of the material and may
occur once or not at all within the BulkDetails element.
Form contains the form of the material and may occur once or not at
all within the BulkDetails element.
ProcessingDetails contains a description of a processing step for
the material and may occur zero or more times within the BulkDetails
element. For additional information, see the documentation for the
ProcessingDetails element.
Geometry contains a description of the geometry of the material and
may occur once or not at all within the BulkDetails element. For
additional information, see the documentation for the Geometry
element.
Characterization contains the characterization of the material,
including the formula, chemical composition, phase composition, and
dimensional details. Characterization may occur once or not at all
within the BulkDetails element. For additional information, see the
documentation for the Characterization element.
PropertyData contains the property data for the material and may occur
zero or more times within the BulkDetails element. For additional
information, see the documentation for the PropertyData element.
Notes contains any additional information concerning the bulk material
and may occur once or not at all within the BulkDetails element.
************************* Metadata *************************
This element declares the content model for Metadata, which contains
descriptions of data sources, properties, measurement techniques,
specimens, and parameters, and is composed of the following elements
DataSourceDetails contains a description of a data source referenced
using the PropertyData element and may occur zero or more times within
the Metadata element. For additional information, see the documentation
for the DataSourceDetails element.
PropertyDetails contains a description of a property for which materials
data are encoded using the PropertyData element and may occur zero or
more times within the Metadata element. For additional information, see the
documentation for the PropertyDetails element.
MeasurementTechniqueDetails contains a description of a measurement
technique referenced using the PropertyData element and may occur zero
or more times within the Metadata element. For additional information, see
the documentation for the MeasurementTechniqueDetails element.
SpecimenDetails contains a description of a specimen referenced using
the PropertyData element and may occur zero or more times within the
Metadata element. For additional information, see the documentation for
the SpecimenDetails element.
ParameterDetails contains a description of a parameter referenced using
the PropertyData element and may occur zero or more times within the
Metadata element. For additional information, see the documentation for
the ParameterDetails element.
************************* DataSourceDetails *************************
This element declares the content model for DataSourceDetails, which
contains a description of a data source referenced by the PropertyData
element. DataSourceDetails has one required attribute, id, which may be
arbitrarily assigned but must be unique among id attributes assigned
elsewhere in a MatML document. DataSourceDetails also has one
optional attribute, type, for specifying the type of the data source
(examples include "unpublished report," "journal," "handbook," etc.)
DataSourceDetails is composed of the following elements.
Name contains the name of the data source and has one optional
attribute, authority, for identifying an authoritative source of data
source names. Name must occur once and only once within the
DataSourceDetails element.
Notes contains any additional information concerning the data source
and may occur once or not at all within the DataSourceDetails element.
************************* PropertyDetails *************************
This element declares the content model for PropertyDetails, which
contains a description of a property referenced by the PropertyData
element. PropertyDetails has one required attribute, id, which may be
arbitrarily assigned but must be unique among id attributes assigned
elsewhere in a MatML document. PropertyDetails also has one optional
attribute, type, for specifying the type of the property (examples include
"thermal," "mechanical," "electrical," etc.) PropertyDetails is composed of
the following elements.
Name contains the name of the property and has one optional attribute,
authority, for identifying an authoritative source of property names.
Name must occur once and only once within the PropertyDetails
element.
Units and Unitless are mutually exclusive elements for describing the
property's units. Units or Unitless must occur once and only once within
the PropertyDetails element. For additional information, see the
documentation for the Units and Unitless elements.
Notes contains any additional information concerning the property and
may occur once or not at all within the PropertyDetails element.
************************* MeasurementTechniqueDetails *************************
This element declares the content model for MeasurementTechniqueDetails,
which contains a description of a measurement technique referenced by
the PropertyData element. MeasurementTechniqueDetails has one required
attribute, id, which may be arbitrarily assigned but must be unique among
id attributes assigned elsewhere in a MatML document.
MeasurementTechniqueDetails is composed of the following elements.
Name contains the name of the measurement technique and has one
optional attribute, authority, for identifying an authoritative source of
measurement techniques. Name must occur once and only once within the
MeasurementTechniqueDetails element.
Notes contains any additional information concerning the measurement
technique, such as a description of the technique, and may occur once or
not at all within the MeasurementTechniqueDetails element.
************************* SpecimenDetails *************************
This element declares the content model for SpecimenDetails, which
contains a description of a specimen referenced by the PropertyData
element. SpecimenDetails has one required attribute, id, which may be
arbitrarily assigned but must be unique among id attributes assigned
elsewhere in a MatML document. SpecimenDetails also has one optional
attribute, type, for specifying the type of the specimen (examples include
"cylindrical," "rectangular," "full cross-section," "pressed," etc.)
SpecimenDetails is composed of the following elements.
Name contains the name of the specimen and has one optional
attribute, authority, for identifying an authoritative source of specimen
names. Name must occur once and only once within the SpecimenDetails
element.
Notes contains any additional information concerning the specimen and
may occur once or not at all within the SpecimenDetails element.
************************* ParameterDetails *************************
This element declares the content model for ParameterDetails, which
contains a description of a parameter referenced by the ParameterValue
element. ParameterDetails has one required attribute, id, which may be
arbitrarily assigned but must be unique among id attributes assigned
elsewhere in a MatML document. ParameterDetails is composed of
the following elements.
Name contains the name of the parameter and has one optional attribute,
authority, for identifying an authoritative source of parameter names.
Name must occur once and only once within the ParameterDetails
element.
Units and Unitless are mutually exclusive elements for describing the
parameter's units. Units or Unitless must occur once and only once
within the ParameterDetails element. For additional information, see the
documentation for the Units and Unitless elements.
Notes contains any additional information concerning the parameter and
may occur once or not at all within the ParameterDetails element.
************************* Graphs *************************
This element declares the content model for Graphs, which must contain
one or more Graph elements.
Graph uses the W3C's Scalable Vector Graphics markup language (SVG)
for describing two dimensional graphics and allows for three types of
graphical objects: vector graphics shapes, images, and text. Graph must
occur one or more times within the Graphs element. For more information
concerning SVG, see the documentation at http://www.w3.org/TR/SVG/.
************************* Glossary *************************
This element declares the content model for Glossary, which contains
descriptions of material and property terms used in the document.
Glossary must contain one or more Term elements each of which is
composed of the following elements.
Name contains the term's name and has one optional attribute,
authority, for identifying an authoritative source of terms. Name must
occur once and only once within the Term element.
Definition contains the term's definition and must occur once and only
once within the Term element.
Abbreviation contains the term's abbreviations and may occur zero
or more times within the Term element.
Synonym contains the term's synonyms and may occur zero or more
times within the Term element.
Notes contains any additional information concerning the term and may
occur once or not at all within the Term element.
************************* Characterization *************************
This element declares the content model for Characterization, which
contains a description of the chemical composition of the bulk material
or component and is composed of the following elements.
Formula contains a string representation of the chemical formula for
the bulk material or component and must occur once and only once
within the Characterization element.
ChemicalComposition contains a description of the compounds and
elements that comprise the bulk material or component and may
occur once or not at all within the Characterization element. For
additional information, see the documentation for the ChemicalComposition
element.
PhaseComposition contains a description of the phases that comprise
the bulk material or component and may occur zero or more times
within the Characterization element. For additional information, see the
documentation for the PhaseComposition element.
DimensionalDetails contains information relating to component or bulk
material dimensional characteristics such as grain size, porosity,
precipitate size and distribution, etc., and may occur zero or more times
within the Characterization element. For additional information, see the
documentation for the DimensionalDetails element.
Notes contains any additional information concerning the Characterization
and may occur once or not at all within the Characterization element.
************************* Formula *************************
This element declares the content model for Formula, which contains a
string representation of the chemical formula for the bulk material or
component.
************************* ChemicalComposition *************************
This element declares the content model for ChemicalComposition, which
contains a detailed description of the compounds and elements that
comprise the bulk material or component. ChemicalComposition must
contain at least one Compound element or Element element but may
contain as many of each element as needed.
Compound contains a description of a compound. For additional
information, see the documentation for the Compound element.
Element contains a description of an element. For additional information,
see the documentation for the Element element.
************************* Compound *************************
This element declares the content model for Compound, which contains
the elemental description of a chemical compound and is composed the
following elements.
Element contains the description of a chemical element and must occur
one or more times within the Compound element. For additional
information, see the documentation for the Element element.
Concentration contains the concentration of the compound and may
occur once or not at all within the Compound element. For additional
information, see the documentation for the Concentration element.
Notes contains any additional information concerning the compound
and may occur once or not at all within the Compound element.
************************* PhaseComposition *************************
This element declares the content model for PhaseComposition, which
contains a description of a phase that comprises the bulk material or
component and is composed of the following elements.
Name contains the name of the phase and has one optional attribute,
authority, for identifying an authoritative source of phase names. Name
must occur once and only once within the PhaseComposition element.
Concentration contains the concentration of the phase and may occur
once or not at all within the PhaseComposition element. For additional
information, see the documentation for the Concentration element.
PropertyData contains property data for the phase and may occur zero
or more times within the PhaseComposition element. For additional
information, see the documentation for the PropertyData element.
Notes contains any additional information concerning the phase and may
occur once or not at all within the PhaseComposition element.
************************* DimensionalDetails *************************
This element declares the content model for DimensionalDetails, which
contains a description of a dimensional characteristic (e.g. grain size,
porosity, precipitate size and distribution, etc.) of the bulk material or
component and is composed of the following elements.
Name contains the name of the characteristic and has one optional
attribute, authority, for identifying an authoritative source of
dimensional characteristic names. Name must occur once and only once
within the DimensionalDetails element.
Value contains the value of the dimensional characteristic and has one
required attribute, format, for indicating the format of the value ("float,"
"integer," "string," or "exponential") found in Value. Value must occur
once and only once within the DimensionalDetails element.
Units contains the units for the value of the dimensional characteristic
and must occur once and only once within the DimensionalDetails
element. For additional information, see the documentation for the Units
element.
Qualifier contains any qualifier pertinent to the value of the dimensional
characteristic (e.g. "min," "max," etc.) and may occur once or not at all
within the DimensionalDetails element.
Notes contains any additional information concerning the dimensional
characteristic and may occur once or not at all within the
DimensionalDetails element.
************************* Class *************************
This element declares the content model for Class, which contains a string
representing the class of the bulk material or component.
************************* ComponentDetails *************************
This element declares the content model for ComponentDetails, which
contains a description of a component within the bulk material and has
one optional attribute, id, which may be used as an identification
specifier for the component and is especially useful for complex
systems such as composite laminates.
ComponentDetails is composed of the following elements.
Name contains the component's name and has one optional attribute,
authority, for identifying an authoritative source of component names.
Name must occur once and only once within the ComponentDetails
element.
Class contains the component's class and may occur once or not at
all within the ComponentDetails element.
Subclass contains the component's subclass(es) and may occur zero
or more times within the ComponentDetails element.
Specification contains the component's specification(s) and has one
optional attribute, authority, for identifying an authoritative
source of component specifications. Specification may occur zero or
more times within the ComponentDetails element.
Source contains the name of the source of the component and may
occur once or not at all within the ComponentDetails element.
Form contains the form of the component and may occur once or not
at all within the ComponentDetails element.
ProcessingDetails contains a description of a processing step for
the component and may occur zero or more times within the
ComponentDetails element. For additional information, see the
documentation for the ProcessingDetails element.
Geometry contains a description of the geometry of the component
and may occur once or not at all within the ComponentDetails element
For additional information, see the documentation for the Geometry
element.
Characterization contains the characterization of the component,
including the formula, chemical composition, phase composition, and
dimensional details. Characterization may occur once or not at all
within the ComponentDetails element. For additional information, see
the documentation for the Characterization element.
PropertyData contains the property data for the component and may
occur zero or more times within the ComponentDetails element. For
additional information, see the documentation for the PropertyData
element.
AssociationDetails contains a description of a relationship of the
component to another component and may occur zero or more times
within the ComponentDetails element. For additional information, see
the documentation for the AssociationDetails element.
Notes contains any additional information concerning the component
and may occur once or not at all within the ComponentDetails element.
ComponentDetails contains a description of a component within the
component and is used to support encoding of information for
complex materials systems such as composites. ComponentDetails
may occur zero or more times within the ComponentDetails element.
************************* AssociationDetails *************************
This element declares the content model for AssociationDetails, which
contains a description of a relationship of the component to another
component in a complex material system such as a composite, weld, or
multilayer material. AssociationDetails is composed of the following
elements.
Associate contains the name of a component's associate. For example,
a TiC coating has been placed on AISI 1018 steel coupons. The
Associate of the steel, then, is the "titanium carbide coating." Associate
must occur once and only once within the AssociationDetails element.
Relationship contains a description of the relationship between a
component and the associate. For example, the associate of the "steel"
component is the "titanium carbide coating." The relationship of the "steel"
to the "titanium carbide coating" is that the steel is the "substrate" for
the coating. Relationship must occur once and only once within the
AssociationDetails element.
Notes contains any additional information concerning the association and
may occur once or not at all within the AssociationDetails element.
************************* Associate *************************
This element declares the content model for Associate, which contains
a string representing a component's associate.
************************* Relationship *************************
This element declares the content model for Relationship, which
contains a string representing the relationship between a component
and the associate.
************************* Concentration *************************
This element declares the content model for Concentration and is
composed of the following elements.
Value contains the value of the concentration and has one required
attribute, format, for indicating the format of the value ("float," "integer,"
"string," or "exponential") found in Value. Value must occur once and
only once within the Concentration element.
Units contains the units for the value of the concentration and must
occur once and only once within the Concentration element. For additional
information, see the documentation for the Units element.
Qualifier contains any qualifier pertinent to the value of the concentration
(e.g. "min," "max," etc.) and may occur once or not at all within the
Concentration element.
Notes contains any additional information concerning the concentration
and may occur once or not at all within the Concentration element.
************************* Element *************************
This element declares the content model for Element and is composed
of the following elements.
Symbol contains the symbol for the chemical element, which is one
among those enumerated by the ChemicalElementSymbol datatype.
Symbol has one optional attribute, subscript, for indicating the
subscript (formula units) of the chemical element. Symbol must occur
once and only once within the Element element. For additional
information, see the documentation for the ChemicalElementSymbol
datatype.
Concentration contains the concentration of the element and may occur
once or not at all within the Element element. For additional information,
see the documentation for the Concentration element.
Notes contains any additional information concerning the element and
may occur once or not at all within the Element element.
************************* Symbol *************************
This element declares the content model for Symbol, which contains
the symbol for the chemical element. The entry for Symbol is selected
from among the strings enumerated by the ChemicalElementSymbol
datatype. Symbol has one optional attribute, subscript, for indicating
the subscript (formula units) of the chemical element.
************************* Form *************************
This element declares the content model for Form, which contains a
string representing the form of the bulk material or component.
************************* Geometry *************************
This element declares the content model for Geometry, which contains
a description of the geometry of the bulk material or component and is
composed of the following elements.
Shape contains a description of the shape of the bulk material or
component and must occur once and only once within the Geometry
element.
Dimensions contains the dimensions of the bulk material or component
and may occur once or not at all within the Geometry element.
Orientation contains the orientation of the bulk material or component
and may occur once or not at all within the Geometry element.
Notes contains any additional information concerning the geometry and
may occur once or not at all within the Geometry element.
************************* Shape *************************
This element declares the content model for Shape, which contains a
string representing the shape of the bulk material or component.
************************* Dimensions *************************
This element declares the content model for Dimensions, which
contains a string representing the dimensions of the bulk material or
component.
************************* Orientation *************************
This element declares the content model for Orientation, which
contains a string representing the orientation of the bulk material or
component.
************************* Name *************************
This element declares the content model for Name, which contains a
string representing a name and has one optional attribute, authority,
for identifying an authoritative source of names in the context in which
the Name element is used.
************************* Notes *************************
This element declares the content model for Notes, which contains a
string representing descriptive notes.
************************* ParameterValue *************************
This element declares the content model for ParameterValue, which
contains the value of a parameter. ParameterValue has two required
attributes.
The first attribute, parameter, references an id attribute specified in a
ParameterDetails element so that the descriptive details of the parameter
are tied to the value.
The second attribute, format, indicates the format of the value ("float,"
"integer," "string," or "exponential") found in ParameterValue.
************************* ProcessingDetails *************************
This element declares the content model for ProcessingDetails, which
contains a description of a processing step for the bulk material or
component. ProcessingDetails is composed of the following elements.
Name contains the name of the processing step and has one optional
attribute, authority, for identifying an authoritative source of processing
step names. Name must occur once and only once within the
ProcessingDetails element.
ParameterValue contains the value of a parameter under which the
processing step occurred and may occur zero or more times within the
ProcessingDetails element. For additional information, see the
documentation for the ParameterValue element.
Result contains a description of the outcome or result of the
processing step and may occur once or not at all within the
ProcessingDetails element.
Notes contains any additional information concerning the processing
step and may occur once or not at all within the ProcessingDetails
element.
************************* Result *************************
This element declares the content model for Result, which contains a
string representing the result of a processing step.
************************* PropertyData *************************
This element declares the content model for PropertyData, which
contains property data. PropertyData has four attributes.
The first attribute, property, is required and references an id attribute
specified in a PropertyDetails element so that the descriptive details for
the property are tied to the data found in the Data element.
The second attribute, technique, is optional and references an id attribute
Specified in a MeasurementTechniqueDetails element so that the
Descriptive details for the measurement technique are tied to the data found
In the Data element.
The third attribute, source, is optional and references an id attribute
specified in a DataSourceDetails element so that the descriptive details for
the data source are tied to the data found in the Data element.
The fourth attribute, specimen, is optional and references an id attribute
specified in a SpecimenDetails element so that the descriptive details for
the specimen are tied to the data found in the Data element.
PropertyData is composed of the following elements.
Data contains the property data and has one required attribute,
format, for indicating the format of the data ("float," "integer," "string,"
or "exponential") found in Data. Data must occur once and only
once within the PropertyData element.
Qualifier contains any qualifier(s) pertinent to the data in Data (e.g.
"min," "max," etc.) and may occur once or not at all within the
PropertyData element.
Uncertainty contains the measurement uncertainty(ies) of the data in
Data and may occur once or not at all within the PropertyData
element. For additional information, see the documentation for the
Uncertainty element.
ParameterValue contains the value(s) of a parameter under which
the data were determined and may occur zero or more times within
the PropertyData element. For additional information, see the
documentation for the ParameterValue element.
Notes contains any additional information concerning the property
data and may occur once or not at all within the PropertyData element.
Note - Multiple entries in the Data, Qualifier, Uncertainty Value, and
ParameterValue elements must be comma delimited and
synchronized across elements, i.e., the number of entries
in each of these four elements must be equal.
************************* Data *************************
This element declares the content model for Data, which contains
property data and has one required attribute, format, for indicating the
format of the data ("float," "integer," "string," or "exponential") found in
Data.
************************* Uncertainty *************************
This element declares the content model for Uncertainty, which
contains a description of the measurement uncertainty of the data.
Uncertainty is composed of the following elements.
Value contains the value of the uncertainty and has one required
attribute, format, for indicating the format of the value ("float," "integer,"
"string," or "exponential") found in Value. Value must occur once and
only once within the Uncertainty element.
Units contains the units for the value of the uncertainty and must occur
once and only once within the Uncertainty element. For additional
information, see the documentation for the Units element.
Notes contains any additional information concerning the uncertainty,
such as a description of the evaluation of the uncertainty, and may
occur once or not at all within the Uncertainty element.
************************* Qualifier *************************
This element declares the content model for Qualifier, which contains
a string representing a qualifier.
************************* Source *************************
This element declares the content model for Source, which contains
a string representing the source of the bulk material or component.
************************* Specification *************************
This element declares the content model for Specification, which
contains a string representing the specification for the bulk material or
component and has one optional attribute, authority, for identifying an
authoritative source of specifications.
************************* Subclass *************************
This element declares the content model for Subclass, which contains
a string representing the subclass of the bulk material or component.
************************* Unit *************************
This element declares the content model for Unit, which contains a
unit and has two optional attributes.
The first attribute, power, is used to indicate the exponent for Unit.
The second attribute, description, is used to describe Unit.
Note - Multiple Unit elements are multiplied together to form units.
Division is specified by setting the power attribute of Unit
equal to "-1." For additional information, see the
documentation for the Units element.
************************* Unitless *************************
This element declares the content model for Unitless, which is an empty
element used whenever a property, parameter, or uncertainty value has
no units.
************************* Units *************************
This element declares the content model for Units, which contains units
and has four optional attributes.
The first attribute, system, is used to indicate the units system, such as
"SI."
The second attribute, factor, is used to indicate a constant multiplier in
floating point format.
The third attribute, name, is used to indicate the name of the units
The fourth attribute, description, is used to describe the units.
Units is composed of the following elements.
Unit contains a unit and must occur one or more times within the Units
element. For additional information, see the documentation for the Unit
element.
Note - Multiple Unit elements are multiplied together to form the
units. Division is specified by using setting the power
attribute of Unit equal to "-1."
************************* Value *************************
This element declares the content model for value, which contains a string
representing a value. Value has one required attribute, format, for indicating
the format of the value ("float," "integer," "string," or "exponential") found in
Value.
************************* ChemicalElementSymbol *************************
This datatype enumerates the valid strings representing chemical
elements, which may be used in the Symbol element.