Package `GeoSciML/EarthMaterial`

The GeoSciML EarthMaterial package contains classes representing a description of a naturally occurring substance in the Earth.

Earth Material represents material composition or substance, and is thus independent of quantity or location. Ideally, Earth Materials are defined strictly based on physical properties, but because of standard geological usage, genetic interpretations may enter into the description as well.

Class Summary
`<<`Type`>>` Classes
CompoundMaterial `<<Type>>`	An EarthMaterial composed of particles composed of EarthMaterials, possibly including other CompoundMaterials. This class is provided primarily as an extensibility point for related domain models that wish to import and build on GeoSciML, and wish to define material types that are compound but are not rock or rock-like material. For most users of GeoSciML "RockMaterial" should be used.
ConstituentPart `<<Type>>`	The Constituent Part class describes how Earth Materials may be made up of other Earth Materials, including the proportion of the constituent part in the whole (eg: 20%, minor, dominant); the role that the constituent plays in the whole (eg: matrix, groundmass, framework, phenocryst, xenolith, vein). The particleType property that specifies type of particle (eg: grain, clast, crystal, fossil, oolite) has been moved to the ParticleGeometryDescription data type, associated with both ConstituentPart and CompoundMaterial (GeoSciMLv2, RC3, Uppsala, Sweden). The distinction between "role" and "particleType" is subtle. An operational test is that constituentType may be determined independent of relationship between particles in the aggregation, whereas role requires consideration of the relationship to other particles. A particle may be identified as clast, independent of its material composition, and independent of its relationship to other grains in a rock. The term 'floating clast' is a role, because it is dependent on the relationship 'not in contact with other clasts'. Consider Dunham's textural classification of carbonate rocks (wackestone, packstone, grainstone...) in the description of carbonate rocks. The description is predicated on identification of two kinds of intraclasts (grains) and matrix (carbonate mud), and then uses this distinction to establish relationships--mud supported vs. grain supported -- that define roles for the two types of constituents (framework, matrix...). examples of type vs. role: Particle type: clast. Role: framework, floating particle particle type: crystal. Role: matrix, pseudomatrix (in case that matrix is interpreted as recrystallized material) particle type: clast. Role: matrix (in case that matrix is interpreted as very-fine grained detrital fraction) particle type: crystal. Role: cement (in case that material insterstitial to particles is crystalline material introduced during diagenesis) particle type: crystal. Role: phenocryst (in igneous rock) particle type: microlite Role: groundmass (in porphyrytic igneous rock) particle type: crystal. Role: framework (in igneous rock) particle type: pyroclast. role: framework (in tuff) particle type: crystal Role: oikocryst particle type: crystal Role: overgrowth particle type: biogenic particle Role: floating particle particle type: ooid Role: framework
EarthMaterial `<<Type>>`	The Earth Material class holds a description of a naturally occurring substance in the Earth. Earth Material represents material composition or substance, and is thus independent of quantity or location. Ideally, Earth Materials are defined strictly based on physical properties, but because of standard geological usage, genetic interpretations may enter into the description as well.
InorganicFluid `<<Type>>`	An inorganic, non-crystalline EarthMaterial (solid, liquid, or gas) that tends to flow or conform to the shape of its container. Includes glass. By convention liquid mercury is considered a mineral (examples: water, brine, glass) This class is an empty placeholder for extension at a later date, or by other domain models.
MaterialRelation `<<Type>>`	The MaterialRelation class describes the relationships between constituent parts in an Earth Material (eg: A mineral overgrowth on a phenocryst within a granite). Relationships are always binary and directional. There is always a single source and a single target. The relationship is always defined from the perspective of the Source and is generally an active verb. Example: Consider an overgrowth of albite on plagioclase in a granite. The Source would originate with the albite constituentPart description. In this case, the Target would point to the plagioclase constituentPart description and the relationship attribute would be 'overgrowth' and the sourceRole is 'overgrows'. Other appropriate role attributes might include: crosscuts, replaces, etc. for crosscutting and replacement relationships. Inverse relationships must be explicitly recorded as well or else they are invisible.
Mineral `<<Type>>`	A naturally occurring inorganic element or compound having a periodically repeating arrangement of atoms and a characteristic chemical composition or range of compositions, resulting in distinctive physical properties. Includes mercury as a general exception to the requirement of crystallinity. Also includes crypto-crystalline materials such as chalcedony and amorphous silica.
OrganicMaterial `<<Type>>`	An EarthMaterial that belongs to the class of chemical compounds having a reduced carbon basis (as distinct from carbonates), and derived from living organisms. Includes high-carbon EarthMaterials such as bitumen, peat, and coal. This class is an empty placeholder for extension at a later date, or by other domain models
RockMaterial `<<Type>>`	A specialized CompoundMaterial that includes consolidated and unconsolidated materials as well as mixtures of consolidated and unconsolidated materials.
`<<`DataType`>>` Classes
AlterationDescription `<<DataType>>`	AlterationDescription decribes aspects of a geologic unit or earth material that are the result of bulk chemical, mineralogical or physical changes related to change in the physical or chemical environment. Includes weathering, supergene alteration, hydrothermal alteration and metasomatic effects not considered metamorphic. A soil profile description would have to be constructed as a GeologicUnit with unit parts representing the various horizons in the profile. Thickness of a weathering profile can be delivered as unitThickness of an AlterationUnit.
ChemicalComposition `<<DataType>>`
FabricDescription `<<DataType>>`	The FabricDescription class describes all types of fabrics associated with a CompoundMaterial (ie, tectonic, metamorphic, sedimentary, igneous fabrics or textures). It denotes a pattern, defined by one or more CompoundMaterial constituents, that is present throughout a rock body when considered at some scale. FabricDescription is defined based on the average configuration of many constituents. Penetrative fabric denotes that these constituents are distributed throughout the rock volume at the scale of observation [Passchier and Trouw, 1998], and are repeated at distances that are small relative to the scale of the whole, such that they can be considered to pervade the whole uniformly (Turner and Weiss [1963] p. 21-24; Hobbs and others [1976], p. 73; Jackson [1997]; Passchier and Trouw [1998]). FabricDescription is distinguished from Particle Geometry based on the criteria that Particle Geometry is preserved if a CompoundMaterial is disaggregated, while FabricDescription is not defined if the material is disaggregated. Use gml:description to capture any free text to indicate any specific or peculiar features of the described fabric in the CompoundMaterial.
MetamorphicDescription `<<DataType>>`	MetamorphicDescription describes the character of metamorphism applied to a CompoundMaterial or GeologicUnit using one or more properties including estimated intensity (grade; eg high grade, low grade), characteristic metamorphic mineral assemblages (facies; eg, greenschist, amphibolite), peak P-T estimates, and protolith material if known.
ParticleGeometryDescription `<<DataType>>`	ParticleGeometryDescription describes particles in a CompoundMaterial independent of their relationship to each other or orientation. It is distinguished from Fabric in that the ParticleGeometryDescription remains constant if the material is disaggregated into its constituent particles, whereas Fabric is lost if the material is disaggregated. Properties include the particle size (grainsize), particle sorting (size distribution, eg: well sorted, poorly sorted, bimodal sorting), particle shape (surface rounding or crystal face development, eg: well rounded, euhedral, anhedral), and particle aspectRatio (eg: elongated, platy, bladed, compact, acicular).
`<<`CodeList`>>` Classes
AlterationTypeTerm `<<CodeList>>`	Refers to a vocabulary of terms describing the dominant alteration mineralogy or alteration type, in common usage. Examples include: argillic, phyllic, potassic, propylitic, calc-silicate, skarn, deuteric, greisen, serpenitisation, weathering, etc.
ConstituentPartRoleTerm `<<CodeList>>`	Refers to a vocabulary of terms describing the role played by a constituent part of a compound material (eg, matrix, phenocryst)
FabricTypeTerm `<<CodeList>>`	Refers to a vocabulary of terms describing the type of fabric present
LithologyTerm `<<CodeList>>`	Refers to a vocabulary of terms describing the lithology of the compound earth material (eg, granite, sandstone, schist)
MineralNameTerm `<<CodeList>>`	Refers to a vocabulary of mineral names
ParticleTypeTerm `<<CodeList>>`	Refers to a vocabulary of terms describing the type of particle in the compound earth material (eg, bioclast, phenocryst, pyroclast)

Tagged Values
Tag	Value	Notes
classMap	https://www.seegrid.csiro.au/subversion/GeoSciML/earthMaterial/trunk/classmap/ClassMap_EarthMaterial_GeoSciML_v3.xml
gmlProfileSchema	#NOTES#Description: URL of the schema location of a GML profile (optional)	Description: URL of the schema location of a GML profile (optional)
owner	IUGS Commission for the Management and Application of Geoscience Information
schemaLocation	http://schemas.geosciml.org/earthmaterial/3.0/earthMaterial.xsd
targetNamespace	http://xmlns.geosciml.org/EarthMaterial/3.0	Default: FIXME Description: Target XML namespace of the application schema
version	3.0.0	Default: FIXME Description: Current version of the application schema
xmlns	gsmlem	Default: FIXME Description: Namespace prefix to be used as short form of the target namespace
xsdDocument	earthMaterial.xsd	Default: FIXME Description: Name of an XML Schema document to create representing the content of this package
xsdEncodingRule	iso19136_2007_INSPIRE_Extensions	Values: iso19136_2007 \| iso19139_2007 \| iso19136_2007_INSPIRE_Extensions Default: iso19136_2007 Description: XML Schema encoding rule to apply