Draft

OGC Standard

Draft OGC Geoscience Markup Language (GeoSciML) - Part 1: Core
Editor One Editor Editor Two Editor
Version: 5.0-draft
Additional Formats: XML PDF DOC
OGC Standard

Draft

Document number:YY-999
Document type:OGC Standard
Document subtype:Implementation
Document stage:Draft
Document language:English

License Agreement

Use of this document is subject to the license agreement at https://www.ogc.org/license

Suggested additions, changes and comments on this document are welcome and encouraged. Such suggestions may be submitted using the online change request form on OGC web site: http://ogc.standardstracker.org/




I.  Abstract

GeoSciML is a model of geological features commonly described and portrayed in geological maps, cross sections, geological reports and databases.  The model was developed by the IUGS CGI (Commission for the Management and Application of Geoscience Information) and version 4.1 is the first version officially submitted as an OGC standard.  This specification describes a logical model and GML/XML encoding rules for the exchange of geological map data, geological time scales, boreholes, and metadata for laboratory analyses.  It includes a Lite model, used for simple map-based applications; a basic model, aligned on INSPIRE, for basic data exchange; and an extended model to address more complex scenarios.  

The specification also provides patterns, profiles (most notably of Observations and Measurements — ISO19156), and best practices to deal with common geoscience use cases. 

II.  Keywords

The following are keywords to be used by search engines and document catalogues.

ogcdoc, OGC document, API, openapi, html


III.  Preface

The primary goal of this specification is to capture the semantics, schema, and encoding syntax of key elements described and portrayed in geological maps and databases, in order to enable information systems to interoperate with such data.

IV.  Security considerations

No security considerations have been made for this Standard.

V.  Submitting Organizations

The following organizations submitted this Document to the Open Geospatial Consortium (OGC):

  • Arizona Geological Survey (AzGS), Arizona, USA
  • British Geological Survey (NERC-BGS), UK
  • Bureau de Recherches Géologiques et Minières (BRGM), France
  • Commonwealth Scientific and Industrial Research Organisation (CSIRO), Australia
  • Geological Survey of Victoria (GSV), Australia
  • Geological Survey of Finland (GTK), Finland
  • Geological Survey of Italy (ISPRA), Italy
  • Geological Survey of Sweden (SGU), Sweden
  • Geoscience Australia (GA), Australia
  • Institute of Geological and Nuclear Sciences (GNS), New Zealand
  • Landcare Research, New Zealand
  • Natural Resources Canada (NRCan), Canada
  • U.S. Geological Survey (USGS), United States of America

VI.  Submitters

All questions regarding this submission should be directed to the editor or the submitters:

NameAffiliation
Eric BoisvertGeological Survey of Canada (Natural Resources Canada)
Ollie RaymondGeoscience Australia
Marcus SenBritish Geological Survey
Edd LewisBritish Geological Survey
Mark RattenburyEarth Sciences New Zealand

VII.  Contributors

Additional contributors to this Standard include the following:

Individual name(s), Organization

1.  Scope

GeoSciML (Geoscience Markup Language) covers the domain of geology (earth materials, geological units and stratigraphy, geological time, geological structures, geomorphology, geochemistry) and sampling features common to the practice of geoscience, such as boreholes and geological specimens.  The specification also proposes a simplified version of GeoSciML suitable for portrayal of geological features on digital maps.  This specification does not address (or very partially addresses) more specialised geoscience domains such as hydrogeology, seismology, geophysics or economic geology.  Some of these domains are covered by other specifications (e.g. GroundwaterML for hydrogeology; OGC 16-032, and EarthResourceML for economic geology – both developed in concert with GeoSciML).

2.  Conformance

This standard defines a logical model.

Requirements for two standardization target types are considered:

  • Logical Model

  • Encoding

Conformance with this standard shall be checked using all the relevant tests specified in Annex A (normative) of this document. The framework, concepts, and methodology for testing, and the criteria to be achieved to claim conformance are specified in the OGC Compliance Testing Policies and Procedures and the OGC Compliance Testing web sitehttps://docs.ogc.org/is/16-008/16-008.html#_ftnref1[[1]].

All requirements-classes and conformance-classes described in this document are owned by the standard(s) identified.

3.  Normative references

The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.

Arliss Whiteside, Jim Greenwood: OGC 06-121r9, OGC Web Service Common Implementation Specification. Open Geospatial Consortium (2010). https://docs.ogc.org/is/06-121r9/06-121r9/pdf.

ISO: ISO/TS 19103:2005, Geographic information — Conceptual schema language. International Organization for Standardization, Geneva (2005). https://www.iso.org/standard/37800.html.

ISO: ISO 19107:2003, Geographic information — Spatial schema. International Organization for Standardization, Geneva (2003). https://www.iso.org/standard/26012.html.

ISO: ISO 19108:2002/Cor 1:2006, Geographic information — Temporal schema — Technical Corrigendum 1. International Organization for Standardization, Geneva (2002). https://www.iso.org/standard/44883.html.

ISO: ISO 8601, Data elements and interchange formats — Information interchange — Representation of dates and times. International Organization for Standardization, Geneva https://www.iso.org/standard/40874.html.

ISO: ISO 19136:2007, Geographic information — Geography Markup Language (GML). International Organization for Standardization, Geneva (2007). https://www.iso.org/standard/32554.html.

ISO: ISO 19156:2011, Geographic information — Observations and measurements. International Organization for Standardization, Geneva (2011). https://www.iso.org/standard/32574.html.

ISO: ISO 19111:2007, Geographic information — Spatial referencing by coordinates. International Organization for Standardization, Geneva (2007). https://www.iso.org/standard/41126.html.

ISO: ISO 19115:2003, Geographic information — Metadata. International Organization for Standardization, Geneva (2003). https://www.iso.org/standard/26020.html.

ISO: ISO 19101:2002, Geographic information — Reference model. International Organization for Standardization, Geneva (2002). https://www.iso.org/standard/26002.html.

Clemens Portele: OGC 07-036, OpenGIS Geography Markup Language (GML) Encoding Standard. Open Geospatial Consortium (2007). https://docs.ogc.org/is/07-036/07-036/pdf.

Simon Cox: OGC 10-025r1, Observations and Measurements — XML Implementation. Open Geospatial Consortium (2011). https://docs.ogc.org/is/10-025r1/10-025r1/pdf.

Alexandre Robin: OGC 08-094r1, OGC® SWE Common Data Model Encoding Standard. Open Geospatial Consortium (2011). https://docs.ogc.org/is/08-094r1/08-094r1/pdf.

T. Berners-Lee, R. Fielding, L. Masinter: IETF RFC 3986, Uniform Resource Identifier (URI): Generic Syntax. RFC Publisher (2005). https://www.rfc-editor.org/info/rfc3986.

ISO/IEC: ISO/IEC 19757-3, Information technology — Document Schema Definition Languages (DSDL) — Part 3: Rule-based validation using Schematron. International Organization for Standardization, International Electrotechnical Commission, Geneva https://www.iso.org/standard/74515.html.

Policy SWG: OGC 08-131r3, The Specification Model — Standard for Modular specifications. Open Geospatial Consortium (2009). https://docs.ogc.org/pol/08-131r3/08-131r3/pdf.

OMG: Unified Modeling Language (UML). Version 2.3

Schadow, G. and McDonald, C. J.: Unified Code for Units of Measure (UCUM) — Version 2.0.1

Murphy, M. A. and Salvador, A.: International Stratigraphic Guide – an abridged version accessed online at URL (http://www.stratigraphy.org/index.php/ics-stratigraphicguide (1994)

W3C: Extensible Markup Language (XML) — Version 1.0 (Fourth Edition) (2006)

W3C: XML Schema — Version 1.0 (Second Edition) (2004)

INSPIRE Thematic Woring Group Geology: INSPIRE Data Specification for the spatial data theme Geology Version 3.0. European Commission Joint Research Centre (2013)

North American Geologic Map Data Model Steering Committee: NADM Conceptual Model 1.0—A conceptual model for geologic map information. U.S. Geological Survey Open-File Report 2004-1334, 58 p., accessed online at URL link:http://pubs.usgs.gov/of/2004/1334http://pubs.usgs.gov/of/2004/1334] (2004)

North American Geologic Map Data Model science language products _(http://ngmdb.usgs.gov/www-nadm/sltt/products.html)_

4.  Terms and definitions

This document uses the terms defined in OGC Policy Directive 49, which is based on the ISO/IEC Directives, Part 2, Rules for the structure and drafting of International Standards. In particular, the word “shall” (not “must”) is the verb form used to indicate a requirement to be strictly followed to conform to this document and OGC documents do not use the equivalent phrases in the ISO/IEC Directives, Part 2.

This document also uses terms defined in the OGC Standard for Modular specifications (OGC 08-131r3), also known as the ‘ModSpec’. The definitions of terms such as standard, specification, requirement, and conformance test are provided in the ModSpec.

For the purposes of this document, the following additional terms and definitions apply.

A classifier is an abstract UML metaclass which describes (classifies) a set of instances having common features (not to be confused with the “Feature” stereotype from the OGC Feature Model). A feature declares a structural or behavioral characteristic of instances of classifiers. (http://www.uml-diagrams.org/classifier.html). Classes, Interfaces, Association, and Types are kinds of classifiers.

Feature of a type defined within a particular application domain.

Note 1 to entry: This may be contrasted with observations and sampling features, which are features of types defined for cross-domain purposes.

[SOURCE: ISO 19156:2011]

Basic information item of an XML document containing child elements, attributes and character data.

[SOURCE: OGC 07-036]

Abstraction of a real-world phenomenon.

[SOURCE: ISO 19101:2002]

Application schema written in XML Schema in accordance with the rules specified in OGC GML 3.3

[SOURCE: OGC 07-036]

XML document with a root element that is one of the elements AbstractFeature, Dictionary or TopoComplex, specified in the GML schema or any element of a substitution group of any of these elements.

[SOURCE: OGC 07-036]

Schema components in the XML namespace ― as specified in OGC GML 3.3

[SOURCE: OGC 07-036]

Set of operations having the objective of determining the value of a quantity.

[SOURCE: ]

Act of observing a property.

Note 1 to entry: The goal of an observation may be to measure or otherwise determine the value of a property.

[SOURCE: ]

Method, algorithm or instrument, or system which may be used in making an observation.

[SOURCE: ISO 19156:2011]

Estimate of the value of a property determined through a known procedure.

[SOURCE: ISO 19156:2011]

Facet or attribute of an object referenced by a name.

Example

Abby’s car has the color red, where “color red” is a property of the car instance.

The real-world domain feature of interest, such as a geological unit or structure which is observed.

[SOURCE: ISO 19156:2011]

Feature, such as a station, outcrop, borehole, section or specimen, which is involved in making observations of a domain feature.

Note 1 to entry: A sampling feature is purely an artefact of the observational strategy, and has no significance independent of the observational campaign.

[SOURCE: ISO 19156:2011]

XML document containing a collection of schema component definitions and declarations within the same target namespace.

Example Schema components of W3C XML Schema are types, elements, attributes, groups, etc.

Note 1 to entry: The W3C XML Schema provides an XML interchange format for schema information. A single schema document provides descriptions of components associated with a single XML namespace, but several documents may describe components in the same schema, i.e. the same target namespace.

[SOURCE: OGC 07-036]

5.  Conventions

This section provides details and examples for any conventions used in the document. Examples of conventions are symbols, abbreviations, use of XML schema, or special notes regarding how to read the document.

5.1.  Requirement class

Each normative statement (requirement or recommendation) in this specification is a member of a requirements class. Each requirements class is described in a discrete clause or sub-clause, and summarized using the following template:

Requirements class/req/{classM}
Target type[artefact or technology type]
Dependency[identifier for another requirements class]
Requirement/req/{classM}/{reqN}
Recommendation/req/{classM}/{recO}
Requirement/req/{classM}/{reqP}
Requirement /Recommendation[repeat as necessary]

All requirements in a requirements class must be satisfied. Hence, the requirements class is the unit of re-use and dependency, and the value of a dependency requirement is another requirements class. All requirements in a dependency must also be satisfied by a conforming implementation. A requirements class may consist only of dependencies and introduce no new requirements.

5.2.  Requirement and Recommendation

All requirements and recommendations are normative, and each is presented using the following template:

Requirement /req/[classM]/[reqN]
[Normative statement]

 

where /req/[classM]/[reqN] identifies the requirement or recommendation. The use of this layout convention allows the normative provisions of this specification to be easily located by implementers.

5.3.  Conformance class

Conformance to this specification is possible at a number of levels, specified by conformance classes (Annex A). Each conformance class is summarized using the following template:

Conformance class
/conf/{classM}
Dependency[identifier for another conformance class]
Requirements/req/{classA}
Tests[reference to clause(s) containing tests]

All tests in a class must be passed. Each conformance class tests conformance to a set of requirements packaged in a requirements class.

W3C Schema (XSD) and ISO Schematron (SCH) files are considered as part of this specification, although available online only, due to concerns about document size. Many requirements are expressed in a single XSD or SCH file, although tests are listed individually in the conformance annex (one test for XSD and one test for SCH). 

Schematron files explicitly specify which requirements are being tested in the title of the schematron pattern.

 

<pattern id="unit-of-measure">
    <title>Test requirement: /req/gsml4xsd/unit-of-measure</title>
    <rule context="SWE::Quantity">
        <assert test="SWE::Quantity">Quantity must have a UOM</assert>
    </rule>
</pattern>

5.4.  Identifiers

The normative provisions in this specification are denoted by a URI constructed using this pattern:

http://www.opengis.net/spec/{standard}/{m.n}

All requirements and conformance tests that appear in this document are denoted by a partial URI which is relative to this base. The identifier supports cross-referencing of class membership, dependencies, and links from each conformance test to the requirements tested. In this specification identifiers are expressed as partial URIs or paths, which can be appended to a base URI that identifies the specification as a whole in order to construct a complete URI for identification in an external context.

The URI for each requirements class has the form:

http://www.opengis.net/spec/geosciml-part1/5.0/req/[classM]

The URI for each requirement or recommendation has the form:

http://www.opengis.net/spec/geosciml-part1/5.0/req/[classM]/[reqN]

The URI for each conformance class has the form:

http://www.opengis.net/spec/geosciml-part1/5.0/conf/[classM]

The URI for each conformance test has the form:

http://www.opengis.net/spec/geosciml-part1/5.0/req/[classM]/[testN]

5.5.  Classifiers

This document contains a large number of references to classifiers that might sometimes be ambiguous.  Classes and packages are simply referred by their name formed using “CamelCase” name in mono space type.  Duplicate names do exist and the scope (the package of a class or the class a property belongs to) must be made explicit. 

OCL syntax will be used to identify a logical model classifier from the UML model.

Package::{…}Package::Classifier::Property:Type

Package names are not formal in UML and can change from one implementation to another.  The reference model used by GeoSciML, and several other domain models, is HollowWorld.  For example, a complete path for a SF_SamplingPoint in HollowWorld (from HollowWorld root) is

ISO TC211::ISO 19156 All::ISO 19156:2011 Observations and Measurements::Sampling Features::samplingPoint::SF_SamplingPoint

For the sake of readability, and also because some HollowWorld package names do not have OCL friendly names (e.g. some package names contain ‘:’, as shown in the previous example), this document will use shortcuts to identify packages.  For example, for OM::SF_SamplingPoint, OM acts as a shortcut for (ISO TC211::ISO 19156 All::ISO 19156:2011 Observations and Measurements::*) that includes all classifiers in all sub packages and avoids creating a shortcut for all sub packages.  The list of shortcuts is provided in Section link:https://docs.ogc.org/is/16-008/16-008.html#198.1.2].  GeoSciML also uses the recently published ISO19115-3 model which has numerous classifier name overlaps with ISO19115 from HollowWorld.

W3C XPath will be used in XML instances.  XML entities will be identified using their full qualified name (namespace, identified by its prefix, and entity name).

  • gsmlb:GeologicUnit refers to an instance of GeologicUnit, from namespace xmlns:gsmlb=”http://www.opengis.net/gsml/5.0/GeoSciML-Basic”

  • gsmlb:GeologicUnit/gml:name refers to the name property of GeologicUnit

  • gsmlb:GeologicUnit/gml:name/@codeName refers to the codeName attribute of the name property of GeologicUnit

6.  GeoSciML Models

6.1.  GeoSciML Models

The GeoSciML 4.1 is an ISO General Feature Model (ISO19101, ISO19109) implementation of portions of the North American Data Model [12] and CSIRO’s XMML model.  GeoSciML also provides models for concepts at the immediate periphery of geological mapping, such as boreholes, geologic specimens and laboratory analysis, modelled as SF_SamplingFeatures and OM_Observations (OGC 10-004r3). 

 

Figure 1 — Model lineage. Geological entities are logical implementations of NADM while sampling and observations entities are implementations of O&M (ISO19156).

GeoSciML has been through 4 major releases and a few minor releases since 2005.  Each version brought a different interpretation of what is essentially the same conceptual model.  The reader looking at all iterations will see, with few exceptions, the same concepts, the same associations and the same properties, but packaged differently.  GeoSciML increasingly adopted other domain models as it evolved; it replaced XMML (eXploration and Mining Markup Languages, developed by CSIRO) by Observations and Measurements (ISO19156), custom data types for ranges and categories by SWE Common, and removed custom vocabularies to use web resources.

This fourth iteration is essentially a repackaging of the previous version 3.2 from 13 packages organised by themes into 6 packages organised by use cases (Figure 2):

  • GeoSciML Basic: a set of core geologic features, aligned to the INSPIRE Data Specification on Geology.

  • GeoSciML Extension: an extension providing detailed description of basic features which adds additional properties and associations.

  • GeoSciML Geologic Age: a model for the representation of geologic time using procedures adopted by the International Stratigraphic Commission.

  • GeoSciML Borehole: a model for boreholes, including geologic logs and drilling details and other engineering information.

  • GeoSciML Laboratory and Analysis: a model for laboratory analytical metadata, geological sampling and specimens, and isotopic age observation results.

  • GeoSciML Lite: previously known as “GeoSciML Portrayal” in version 3.2; a simplified alternate implementation of the conceptual model for layer based applications.

 

Figure 2 — GeoSciML 4.1 packages

 Each application package is the subject of at least one requirements class (to conform to the modular specification) per target implementation (this specification has three targets; logical model, encoding and data instance).  More target implementations might be published as separate documents.

6.2.  GeoSciML Basic and Extension

GeoSciML describes geological features from the mapping perspective, articulated around the concept of a MappedFeature – the cartographic element shown on a map, and the GeologicFeature it represents.  All geologic concepts that can be represented on a map are subtypes of GeologicFeature.

 

Figure 3 — High-level model

GeologicFeature is an abstract class materialised into four concrete classes (Figure 4) — GeologicEvent, GeologicStructure, GeologicUnit and GeomorphologicFeature.   The other main features of the GeoSciML model are not geologic features themselves, but features related to the activity of sampling and observing geology (such as Borehole or GeologicSpecimen) and are therefore modelled as SF_SamplingFeature (O&M) subtypes.

 

Figure 4 — Core feature model for GeoSciML

GeologicFeature can share arbitrary relationships through a relation class (AbstractRelation), subtyped into different kind of relationships, providing distinct properties and constraints.

In order to provide a simple entry level model for data providers, but also to align to INSPIRE, only a minimal set of properties are supported by the basic package.  When more properties are required, the data provider can use the extension package.  To split properties between basic and extension, a modelling pattern has been adopted to overcome the limitations of classical object oriented subtyping imposed by UML and XSD.

6.2.1.  AbstractDescription classes

The technique to add extended properties to an existing class is normally to create a subtype to carry the new properties (Figure 5).

 

Figure 5 — Adding properties by extension

But this only works when properties need to be added to a leaf class.  Properties added by subtyping a class higher up in the chain of inheritance will create a new branch, and new properties won’t propagate to existing subtypes in the main branch. GeoSciML 4 adopts an extension pattern using abstract property blocks or ‘AbstractDescription’ classes (Figure 6).  Blocks of extended properties are organized in their own Datatype, subtyping AbstractDescription.

 

Figure 6 — Extension pattern using a property block (AbstractDescription class)

This pattern has two main advantages:

  • It does not require the creation of a new feature type to add properties to core features.

  • Extra properties can be defined and used by other user communities (e.g., properties added by a geophysical application could be reused by groundwater applications).

GeoSciML Basic contains nine stub AbstractDescription classes ultimately materialised in GeoSciML Extension (Table 1).

Table 1 — GeoSciML Basic stub AbstractDescription classes.

ClassDescription
AbstractFeatureRelationAssociation class placeholder to describe relations between geologic features.
EarthMaterialAbstractDescriptionDetailed earth material description placeholder for GeologicUnit and EarthMaterial.
GeologicUnitAbstractDescriptionDetailed description placeholder for GeologicUnit.
GeologicEventAbstractDescriptionDetailed description placeholder for GeologicEvent.
ContactAbstractDescriptionDetailed description placeholder for Contact.
FoliationAbstractDescriptionDetailed description placeholder for Foliation.
FoldAbstractDescriptionDetailed description placeholder for Fold.
ShearDisplacementStructureAbstractDescriptionDetailed description placeholder for ShearDisplacementStructure.
GeomorphologicUnitAbstractDescriptionDetailed description placeholder for GeomorphologicUnit.

Since those classes are abstract in GeoSciML Basic, data providers need to implement GeoSciML Extension, or any third party extension to get concrete classes.

This modelling pattern is also used by other standards communities (e.g., ISO 19115-3).

6.3.  GeoSciML Lite

GeoSciML Lite is a denormalised view, or a transformation, of key geological and sampling features, designed as a simple entry-level model to publish datasets, particularly adapted to geographic visualization with key reporting properties.  The use case for GeoSciML Lite is a simple layer-based application; such as web map application or GIS where the key functionality is to display a map layer and perform simple identify or query operations.  The classes are modelled to be easily implementable in any GIS or web mapping application.  One feature type maps to one table composed of optional, single-occurrence properties – consistent with the structure of denormalised RDBMS tables.  The XML implementation (clause 9.8) is conformant with GML Simple Feature (OGC 10-100r3).

Each property of GeoSciML Lite classes is derived from a subset of the properties available in the full GeoSciML model, with the exception of “genericSymbolizer”, which is a convenience property providing a cartographic symbol or code. The property is a shortcut to symbolisation that would otherwise be provided by an SLD (Styled Layer Descriptor).

Some fields are external references, in the form of HTTP URI, to provide hyperlinks for applications to access linked data definitions to externally governed vocabulary terms and/or complex representations of the features when required.

 

Figure 7 — Example of linkage between a GeoSciML Lite feature and other GeoSciML packages and vocabulary term URI’s.  An instance of GeologicUnitView matches an instance of MappedFeature

7.  Conceptual Model

The strictly geological portion of GeoSciML, as opposed to the parts dealing with sampling (e.g., boreholes) and laboratory metadata, is largely an implementation of the North American Data Model [12].  NADM is a technologically neutral conceptual model that addresses geoscience concepts and the relationships between them.  GeoSciML 4 does not implement NADM Geologic Portrayal (a model of cartographic elements composing a geological map, such as legends, symbols, insets, etc.) nor Geologic Vocabulary (although older versions of GeoSciML did).

GeoSciML is an ISO Feature Model implementation of NADM and this created subtle differences between NADM and GeoSciML as the logical model deals with ISO Feature Model idiosyncrasies.  For instance, NADM multiple inheritances used in Fossil could not be implemented in the ISO world that forbids such constructs.  There were also conceptual changes, especially regarding EarthMaterial that is not considered as a GeologicFeature (hence an ISO FeatureType) in GeoSciML, but as a Type.

Sampling and analytical metadata features (Borehole and GeologicSpecimen in particular) are extensions of Observations and Measurements (10-004r3) and as such implement the underlying Observations and Measurements conceptual model.  Borehole introduces engineering concepts known to the industry without a formal conceptual model.  It has been recognised that Boreholes are features that are common outside the geological mapping realms (like the energy and mineral resources industries, hydrogeology, civil engineering, etc) and more formal work could be carried by those interested parties.  Therefore, Borehole in GeoSciML is a essentially placeholder waiting to be replaced by a more formal Borehole model that is applicable across more domains than geology. It is expected that the Laboratory Analysis model could also be formalised by parties interested in (geo)chemical analysis. 

Requirements class 1: Requirements Class ‘GeoSciML conceptual model’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-conceptual
Target typeLogical Model
PrerequisitesISO19101:2002 Reference Model Clause 7
ISO19103 2015 Conceptual Model Language
ISO19104:2008
Unified Modeling Language (UML). Version 2.3. May 2010
Normative statementRequirement 1: /req/gsml-conceptual/similarity

Target logical models that are compliant with the conceptual model shall implement components of the conceptual model respecting their semantics, i.e. their definition and intent. In other words, the logical model must be highly semantically similar to components of the conceptual model. Semantic similarity can be tested in multiple ways, including but not limited to: (i) direct comparison of UML components, (ii) comparison after mapping components to a common expressive knowledge representation language, such as first order logic or common logic, or (iii) comparison after mapping components to a reference ontology. The target can reuse and adapt existing logical models.

Requirement 1

Identifier/req/gsml-conceptual/similarity
Included inRequirements class 1: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-conceptual
A

A target logical model, when claiming compliance with this conceptual model, SHALL implement its components (classes, attributes, relationships) respecting the conceptual model definitions and intent, such that high semantic similarity is obtained between the logical and conceptual model components.

8.  Logical Model

This section describes requirements that must be met by all target implementations that claim conformance to this specification.  The target implementation of the logical model is generally an encoding specification or a schema (which could use technologies like XSD, for example) and not a data instance.  The logical model, expressed using UML, provides naming, structure and cardinality for any physical implementation.  The UML model is a normative artefact as the official representation of GeoSciML.  Rules that can be unambiguously inferred from the UML model will not be documented as explicit requirements.  Specific encoding idiosyncrasies shall be addressed in the requirement clauses pertaining to that encoding.

The logical model contains almost no semantic requirements (i.e., vocabularies, enumerations).  It is expected that users will employ controlled vocabularies of terms which are developed by user communities.  The model provides mechanisms for delivering concepts from controlled vocabularies via URI’s and linked data principles.

8.1.  UML Model

The UML model provides name, structure and cardinality for data elements composing various potential physical implementations of GeoSciML.  There are formal mappings between UML and GML (ISO-19136), UML and RDF (ISO-19150) and best practices exist for mapping UML to RDBMS.  Although it is assumed that UML is technologically neutral, in reality UML models always end up addressing some of the encoding specification details.  The current GeoSciML UML model has been designed as a GML application according to ISO 19109 and borrows some of artefacts of GML. Several design decisions were guided by limitations of UML (e.g. single inheritance) and XSD (package dependencies artefacts) and some constraints of GML delivery using ISO19142 WFS (for instance, some XSD encodings are not queryable easily with ISO19143 FES).  However, the UML model is detailed enough to constrain the main elements of any encoding; the names of entities and the cardinality of properties, the associations between entities and to some extent property types.  On the other hand, some UML features do not have equivalences in certain encoding (for instance, JSON does not have a native support for namespaces or even schema).

Figure 8 shows requirements class dependencies:

 

Figure 8 — Logical Model Requirements classes dependencies (external dependencies not shown)

This section defines the minimum UML mapping requirements that shall be met by any target claiming compliance to this specification.

8.1.1.  Property cardinality

All properties that could feasibly be made optional are optional in GeoSciML 4.1.  This is a reversal of the pattern used in GeoSciML version 3.2 where all properties were made mandatory, forcing the data provider to document why the property was missing using nillable properties.  This design attracted a lot of criticism (not only for GeoSciML but for other communities confronted with the same pattern) from application developers and data providers that consider filling the instance with nil properties is “unnecessarily verbose” and a waste of bandwidth.  It has been argued that nillable properties are just verbose absent values.  This issue is a real concern for mobile applications where payload has an impact on user experience.

Nillable properties actually carry useful or even required information in certain use cases, such as legally bounded data exchange scenarios.  Some communities using GeoSciML may still want to force usage of nillable properties and the SWG recognised that different communities might want to enforce the use of some properties for their particular needs.  To meet this requirement and to offer flexibility to various communities wanting to use (or extend) GeoSciML, properties are optional, but can still be nilled.  A data provider is offered two options when a value is missing:

  • Omit the property

  • Deliver a nilled property with relevant justification.

Which option is most useful for a community is left to that community to decide.  Their decision can be enforced using Schematron.  The editors foresee the use of a) the GeoSciML data model as defined by this specification providing naming and structure and b) a series of community-defined rules to enforce the presence of certain properties relevant to their use cases.  For an XML implementation, this translates into a set of common XSD and SCH to govern conformance to GeoSciML, and community-specific SCH to enforce specific use cases, such as the INSPIRE geology specification [8].

8.1.1.1.  Package shortcuts

The following shortcuts are used to refer to external (non GeoSciML) classifiers.

ShortcutFull path (HollowWorld)
OMISO TC211/ISO 19156 All/ISO 19156:2011 Observations and Measurements
SWEOGC/Sensor Web Enablement 2.0/SWE Common Data Model 2.0
GEOISO TC211/ISO 19107 All/ISO 19107:2003 Spatial Schema
PrimitiveISO TC211/ISO 19103 All/ISO 19103:2005 Conceptual schema language
TemporalISO TC211/ISO 19108 All/ISO 19108:2006 Temporal Schema
GMLISO TC211/ISO 19136:2007 GML

8.2.  GeoSciML Core Abstract Requirements Class (Normative)

Requirements class 2: Requirements Class ‘GeoSciML Core’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-core
Target typeEncoding
Normative statementsRequirement 2: /req/gsml-core/uml-entity-name
Requirement 3: /req/gsml-core/uml-cardinality
Requirement 4: /req/gsml-core/uml-abstract
Requirement 5: /req/gsml-core/uml-polymorphism
Requirement 6: /req/gsml-core/quantities-uom
Requirement 7: /req/gsml-core/quantities-single-range
Requirement 8: /req/gsml-core/codelist

This section presents requirements to which all target encodings must conform in to order to claim compliance to GeoSciML 4.1.

8.2.1.  Naming of entities

Requirement 2

Identifier/req/gsml-core/uml-entity-name
Included inRequirements class 2: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-core
A

When the target implementation allows it, the exact name of the classifier SHALL be used.

If a target implementation is capable of encoding all the artefacts (classes and properties) using the same names used in UML, it shall do so.  Some target implementations might prevent it; for example, dBase (DBF files) column names are restricted to 10 characters or some RDBMS limits the use of camel case names.  But if the target allows it, the exact names shall be used.

8.2.2.  Cardinality

Requirement 3

Identifier/req/gsml-core/uml-cardinality
Included inRequirements class 2: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-core
A

If the target implementation allows it, it SHALL implement the same cardinality of properties and associations as defined in the UML.

Cardinality shall be the same as defined in UML model.  Since essentially all properties are optional, this clause addresses the upper bounds of cardinality: “1” or “many” in almost all cases.  Therefore, if the UML model limits a property’s maximum cardinality to “1”, then the target implementation cardinality cannot be “many”.

8.2.3.  Abstract classes

Requirement 4

Identifier/req/gsml-core/uml-abstract
Included inRequirements class 2: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-core
A

Abstract classes SHALL NOT be materialised.

Not all physical implementations support the concept of an abstract class, or even inheritance and polymorphism.  XSD does support that concept and all its implications, but JSON does not – although JavaScript can somewhat.  This requirement specifies that the encoding specification shall not allow materialisation of an instance of a class stereotyped as abstract.

8.2.4.  Polymorphism

Requirement 5

Identifier/req/gsml-core/uml-polymorphism
Included inRequirements class 2: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-core
A

A target implementation SHALL implement type substitutions inferred from the UML model.

The type hierarchy of the UML model implies type substitutions for property values.  For instance, a property value of type GeologicEvent can be substituted by a value of type DisplacementEvent because DisplacementEvent is a subtype of GeologicEvent.  Many property types are abstract types and only a concrete subtype may be materialised (as per /req/gsml4-core/uml-abstract).  A target implementation shall consider type substitutions using mechanisms available for this implementation.

8.2.5.  Quantities

Requirement 6

Identifier/req/gsml-core/quantities-uom
Included inRequirements class 2: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-core
A

Quantities and measurements SHALL have explicit units of measure from a governed ontology.

The quantities and measurements units of measure shall be taken from a standard vocabulary governed by an appropriate community, for example the Unified Code for Units of Measure (UCUM).

8.2.6.  QuantityRange

A QuantityRange is a quantity formed of a lower and upper value forming a range of values.  If a single value needs to be represented as a QuantityRange, where the single value is assigned to both lower and upper properties.

Requirement 7

Identifier/req/gsml-core/quantities-single-range
Included inRequirements class 2: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-core
A

QuantityRange properties that must report a single value SHALL assign both lower and upper value as equal to that single value.

8.2.7.  Code lists

Requirement 8

Identifier/req/gsml-core/codelist
Included inRequirements class 2: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-core
A

Empty classes with stereotype <<CodeList>> SHALL be implemented as externally governed vocabularies which terms are encoded as URI (RFC 3986).

All properties that require formal vocabularies are modelled in the UML as classes having the stereotype <<CodeList>>.  The list of valid terms is either prescribed by this specification, with a list of possible entries (Figure 9) or open (i.e., without any terms).

 

Figure 9 — Example CodeLists, with a) a prescribed list of terms (DescriptionPurpose) and b) 'open' with no prescribed terms (GeologicUnitHierarchyRoleTerm)

When the list is open, the vocabulary is managed externally over the web where each vocabulary term should be encoded as a resource.  Vocabulary term identifiers are URIs representing concepts from a standard vocabulary governed by an appropriate community — for example, the IUGS CGI Geoscience Terminology Working Group (http://www.cgi-iugs.org/tech_collaboration/geoscience_terminology_working_group.html and http://resource.geosciml.org/) or INSPIRE [8].

This requirement does not require that URIs be actually dereferenceable, but just that a vocabulary term is associated with a syntactically correct URI.

8.3.  Linked Open Data Requirements Class (Normative)

Requirements class 3: Requirements Class ‘Linked Open Data’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lod
Target typeEncoding
PrerequisitesURI
HTTP
Normative statementsRequirement 9: /req/gsml-lod/codelistURI
Requirement 10: /req/gsml-lod/identifier
Requirement 11: /req/gsml-lod/gsml-representation
Requirement 12: /req/gsml-lod/byref

Although OGC standards are not restricted to a web environment, they are strongly influenced by this environment.  GeoSciML was originally developed specifically for XML, but many other encodings are suitable hypermedia formats (RDF/XML, JSON-LD, HTML).  This requirements class describes extra rules that shall be implemented to turn GeoSciML data instances into hypermedia compatible with Linked Open Data principles.

Linked Open Data is a method to publish structured data on the web.  It leverages existing web technologies such as HTTP (transfer protocol) and URI (addressing over the web) to connect structured resources.  The principle is similar to interconnected web pages through hyperlinks, except that pages are replace with structured information that can be processed by machines.

The following requirements essentially impose that URI used as vocabulary, identifiers and references can be “dereferenced”, which is “The act of retrieving a representation of a resource identified by a URI”https://docs.ogc.org/is/16-008/16-008.html#_ftnref2[[2]] from the web.  A resource can have multiple representations (GML, XML, RDF, etc.) and this specification does not impose a particular one, although it is common sense in this context to provide a GeoSciML representation for geological features.

It is important to note that a HTTP URI in this context is both an identifier and a location.  The same identifier is used to refer to any number of representations.  Therefore, different representations are selected through content negotiation with the server.

8.3.1.  Code lists URI

Requirement 9

Identifier/req/gsml-lod/codelistURI
Included inRequirements class 3: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lod
A

URI used for vocabulary terms SHALL be dereferenceable to one or more representations of the vocabulary term.

The requirement described at 8.2.7  in Abstract Requirements Class demand that a vocabulary reference be encoded as a URI, but does not require that the URI actually resolve to anything (it could, but it is not required).  In this class, the target must ensure that the URI used to identify vocabulary terms SHALL dereference to one or more representations of a definition of the term (eg, RDF/SKOS, HTML, GML Definition, etc.)

8.3.2.  Identifier

Requirement 10

Identifier/req/gsml-lod/identifier
Included inRequirements class 3: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lod
A

HTTP URI used as entity identifiers SHALL be to one or more representations of that entity.

This requirement demands that the target ensures that a data instance exposes a URI as a unique identifier for this feature and this identifier SHALL be dereferenceable to one or more representations of that feature.

Requirement 11

Identifier/req/gsml-lod/gsml-representation
Included inRequirements class 3: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lod
A

Dereferenceable HTTP URI used as identifiers SHOULD provide GeoSciML 5.0 as one of its representations.

It is expected that one of the representations should be a XML (GML) or any GeoSciML compliant representations, including any profiles derived from this specification.

8.3.3.  ByReference associations

Requirement 12

Identifier/req/gsml-lod/byref
Included inRequirements class 3: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lod
A

External references to an entity conforming to [/req/gsml-lod/identifier] shall be expressed using this entity identifier.

Serialization of a dataset will often omit the full description of a feature and replace the property value with an external reference.  A reference to this feature is formed by the dereferenceable identifier described in clause 8.3.2. A client ingesting the dataset can use this reference to extract a feature representation if need be.  Over the web, this reference shall be a HTTP URI that can be dereferenced to one or more representations of that feature.

8.4.  GeoSciML Basic Requirements Class (Normative)

Requirements class 4: Requirements Class ‘GeoSciML Basic’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-basic
Target typeEncoding
PrerequisitesSpatial Schema ISO19107
Conceptual schema language ISO19103
Normative statementsRequirement 13: /req/gsml-basic/geologicfeature-purpose
Requirement 14: /req/gsml-basic/geologicevent-single
Requirement 15: /req/gsml-basic/geologicevent-non-null
Requirement 16: /req/gsml-basic/plane-pol-dip-az-not-null
Requirement 17: /req/gsml-basic/linear-trend-plunge-not-null
Requirement 18: /req/gsml-basic/quantity-range-order
Requirement 19: /req/gsml-basic/quantity-range-repeat

 

Basic package provides a collection of classes representing fundamental geological and geomorphological features (units, structures, and events), earth materials, geologic time, and the relations between them.  It limits the number of descriptive properties to match important common use cases, including the INSPIRE geological theme specification [8].

 

GeoSciML Basic dependencies.

Figure 10 — GeoSciML Basic dependencies

8.4.1.  Geology Basic

GeologyBasic is a package of classes representing fundamental geological map features and the relations between them.  GeoSciML describes a geologic dataset as a series of GeologicFeature occurrences, spatially represented as MappedFeature.  A map is a collection of MappedFeatures.  The term “map”, typically understood as a map sheet (a given area on the surface of the earth), is only one of the possible collection of MappedFeatures.  Other examples are cross-sections, block diagrams, and even borehole logs (a linear map).  MappedFeature can represent any features and GeologicFeatures are one of the kinds of features it can represent.  A MappedFeature identifies what it represents using its “specification” association. 

Figure 11 shows the fundamental relationships between a MappedFeature and the GeologicFeature.  GeologicFeature is further subtyped into GeologicUnit, GeologicStructure, GeomorphologicFeature and GeologicEvent.

 

Geologic Feature and MappedFeature.

Figure 11 — Geologic Feature and MappedFeature

8.4.1.1.  GeologicFeature

The abstract GeologicFeature class represents a conceptual feature that is hypothesized to exist coherently in the world.  It corresponds with a “legend item” from a traditional geologic map and its instance acts as the “description package”.  The description package is classified according to its intended purpose as a typicalNormdefiningNorm or instance.  GeologicFeature can be used outside the context of a map (it can lack a MappedFeature), for example when describing typical norms (describing expected property from a feature) or defining norms (describing properties required from a feature to be classifying in a group, such as given geologic unit).  A GeologicFeature appearing on a map is considered as an “instance”.

 

Figure 12 — Geologic Feature context diagram

8.4.1.1.1.  observationMethod

The GeologicFeature observationMethod (SWE::Category) specifies the approach to acquiring the collection of attribute values that constitute an individual feature instance (e.g. point count, brunton compass on site, air photo interpretation, field observation, hand specimen, laboratory, aerial photography, creative imagination).

ObservationMethod is a convenience property that provides a simple approach to observation metadata when data are reported using a feature view (as opposed to observation view).  This property corresponds (loosely) to ISO19115 Lineage.

8.4.1.1.2.  purpose

Requirement 13

Identifier/req/gsml-basic/geologicfeature-purpose
Included inRequirements class 4: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-basic
A

Purpose SHALL be a value from Table 2 of clause 8.4.1.1.2.

 

The property purpose:DescriptionPurpose specifies the intended purpose/level of abstraction for a given feature or object instance.  The possible values are: instancetypicalNorm, and definingNorm.

Table 2 — Valid “purpose” values

PurposeDescription
instanceAnd instance is a description that is specific to a particular observed occurrence. This is ‘raw data’, and its classification may start out as very general. There are kinds of narrowly defined ControlledConcepts that might not allow ‘instances’ that are different from the DefiningNorm. It might be worth considering a different relationship between MappedFeature and an Instance GeologicEntity, with the GeologicEntity role being ‘description’.
typicalNormA typicalNorm is a description that specifies properties to be expected of some occurrence associated with the GeologicEntity. This description may include many properties that are not part of the DefiningNorm. For example, the fact that granite is typically light-colored is not a defining property, but is certainly a useful typical property. These kinds of descriptions would be used to address queries like ‘This area is within a polygon classified as Podunk Formation; what sort of lithology am I most likely to encounter when I start digging?’ The Podunk Formation may be defined by the presence of a certain ammonite…​ TypicalNorm description would be constructed as a summary over many Instance descriptions.
definingNormA defining norm is a description that specifies properties sufficient to identify a new occurrence as belonging to the class represented by the description. Basically these are the ‘sufficient conditions’ for class membership. Used when presented with a query ‘I have an outcrop with these properties; which geologic unit should I assign to the outcrop?’ DefiningNorm has to do with the intension of a ControlledConcept.
8.4.1.1.3.  classifier

The classifier (SWE::Category) contains a standard description or definition of the feature type (e.g., the definition of a particular geologic unit in a stratigraphic lexicon).

8.4.1.1.4.  occurrence

The occurrence property is an association that links a notional geologic feature with any number of mapped features (MappedFeature).  A geologic feature, such as a geologic unit may be linked to mapped features from a number of different maps.

8.4.1.1.5.  geologicHistory

The geologicHistory is an association that relates one or more GeologicEvents to a GeologicFeature to describe their age or geologic history.  Normally, GeoSciML uses the generic relatedFeature::GeologicRelation to associate GeologicFeature with other GeologicFeatures, including GeologicEvent.  However, this design was deemed too complex for GeoSciML Basic and is therefore only available from the GeoSciML Extension package. 

To avoid extra complexity, GeoSciML Basic provides an explicit geologicHistory property to associate GeologicFeature with a GeologicEvent without using a GeologicRelation.  The consequence for someone using GeoSciML Extension is that she/he is now offered two ways to link a GeologicFeature and GeologicEvent: through geologicHistory and through a generic GeologicRelation.  User communities should define a pattern that suit their needs.

8.4.1.1.6.  relatedFeature (stub property)

A relatedFeature is a general structure used to define relationships between any features or objects within GeoSciML. Relationships are always binary and directional.  There is always a single source and a single target for a given FeatureRelation (which is abstract in GeoSciML Basic).  The relationship is always defined from the perspective of the Source and is generally an active verb. 

In GeoSciML Basic, relatedFeature is a stub association (see clause 5.1.1).   However some encodings (such as XML) will allow a “by reference” value (for example xlink:href) to an external instance.

8.4.1.2.  MappedFeature

A MappedFeature is part of a geological interpretation. It provides a link between a notional feature (description package) and one spatial representation of it, or part of it (exposures, surface traces and intercepts, etc.).  The mapped features are the elements that compose a map, a cross-section, a borehole log, or any other representation.  The mappingFrame identifies the domain being mapped by the geometries.  For typical geological maps, the mapping frame is the surface of the earth (the 2.5D interface between the surface of the bedrock and whatever sits on it; atmosphere or overburden material for bedrock maps).  It can also be abstract frames, such as the arbitrary plane that forms a mine level or a cross-section, the 3D volume enclosing an ore body or the line that approximate the path of a borehole.

The specification association identifies what notional feature is being mapped.  It can be any features and is not restricted to GeoSciML feature, although it is expected to be for geological maps.

The observationMethod property (SWE::Category) contains an element in a list of categories (a controlled vocabulary) describing how the spatial extent of the mapped feature was determined.

8.4.1.2.1.  positionalAccuracy

The positionalAccuracy property (SWE::Quantity) provides a quantitative value defining the radius of an uncertainty buffer around a MappedFeature (e.g., a positionalAccuracy of 100 m for a line feature defines a buffer polygon of total width 200 m centred on the line).  The property is equivalent to ISO19115 DQ_PositionalAccuracy.

8.4.1.2.2.  resolutionRepresentativeFraction

The property resolutionRepresentativeFraction:Integer is an integer value representing the denominator of the representative scale of the spatial feature.  (i.e., 10000 = the spatial feature is intended to be represented at 1:10,000 scale).

8.4.1.2.3.  mappingFrame

The mappingFrame:MappingFrameTerm provides a term from a vocabulary indicating the geometric frame on which the MappedFeature is projected.  In most situations, mapped features are projected on the earth surface, but there are other contexts, such as a bedrock surface beneath surficial cover materials, a mine level, or a cross section.

8.4.1.2.4.  exposure

The exposure:ExposureTerm property provides a term for the nature of the expression of the mapped feature at the earth’s surface (e.g., exposed, concealed).

8.4.1.2.5.  shape

The shape:GM_Object property contains the geometry delimiting the mapped feature.  Note that while in most cases, the geometry will be a 2D polygon, it is not restricted to any dimension.  For instance, a lithological log can be represented using of 1D geometries (expressed linearly from the borehole origin), or a geologic unit can be represented using a 3D volume.

8.4.1.2.6.  specification

The specification association links an instance of MappedFeature to the GFI_Feature being mapped. In a geological map, MappedFeatures are used to represent GeologicFeatures, but other features from other domains could be represented.

8.4.1.3.  GeologicUnit

Conceptually, a GeologicUnit may represent a body of material in the Earth whose complete and precise extent is inferred to exist (e.g., North American Data Model GeologicUnit [12], Stratigraphic unit in the sense of NACSN [14], or International Stratigraphic Code [9]), or a classifier used to characterize parts of the Earth (e.g. lithologic map unit like ‘granitic rock’ or ‘alluvial deposit’, surficial units like ‘till’ or ‘old alluvium’). It includes both formal units (i.e. formally adopted and named in an official lexicon) and informal units (i.e. named but not promoted to a lexicon) and unnamed units (i.e., recognizable, described and delineable in the field but not otherwise formalised).  In simpler terms, a geologic unit is a package of earth material (generally rock).

 

GeologicUnit context diagram.

Figure 13 — GeologicUnit context diagram

Operationally, a GeologicUnit is a container used to associate geologic properties with some mapped occurrence (through the GeologicFeature::occurrence::MappedFeature link), or with a geologic unit via a vocabulary (through the GeologicUnit::classifier).

Spatial properties are only available through association with a MappedFeature (although GeologicUnit do have a boundedBy property inherited from GFI_Feature).

8.4.1.3.1.  geologicUnitType

The property geologicUnitType:GeologicUnitTypeTerm provides a term from a controlled vocabulary defining the type of geologic unit. Logical constraints of definition of unit and valid property cardinalities should be contained in the definition. Use of the CGI Geologic Unit Type vocabulary (e.g., http://resource.geosciml.org/classifierscheme/cgi/201211/geologicunittype) is recommended.

8.4.1.3.2.  rank

The property rank:RankTerm contains a term that classifies the geologic unit in a generalization hierarchy from most local/smallest volume to most regional/largest.

Examples: group, subgroup, formation, member, bed, intrusion, complex, batholith

8.4.1.3.3.  hierarchyLink

The property hierarchyLink is an association that links a GeologicUnit with a GeologicUnitHierarchy (8.4.1.4) to represent containment of a part GeologicUnit within another GeologicUnit. It indicates a subsidiary unit with its role and proportion with respect to the container unit.  For example, members are described as part of formations, or different facies can be described as parts of a GeologicUnit.

8.4.1.3.4.  composition

The property composition is an association that links a GeologicUnit with CompositionParts to describe the material composition of the GeologicUnit (e.g., a detailed, instance specific, lithologic description)

8.4.1.3.5.  gbMaterialDescription (stub property)

The property gbMaterialDescription:EarthMaterialAbstractDescription is a placeholder that provides detailed material description.  This is a stub property (See 5.1.1) in GeoSciML Basic as EarthMaterialAbstractDescription is abstract with subtypes defined in GeoSciML Extension. 

8.4.1.3.6.  gbUnitDescription (stub property)

The property gbUnitDescription:GeologicUnitAbstractDescriptio is a placeholder that provides detailed material description.  This is a stub property (See 5.1.1) in GeoSciML Basic as GeologicUnitAbstractDescription is abstract with subtypes defined in GeoSciML Extension. 

8.4.1.4.  GeologicUnitHierarchy

GeologicUnitHierarchy associates a GeologicUnit with another GeologicUnit that is a proper part of that unit. Parts may be formal or notional. Formal parts refer to a specific body of rock, as in formal stratigraphic members. Notional parts refer to assemblages of particular EarthMaterials with particular internal structure, which may be repeated in various places within a unit (e.g. ‘turbidite sequence’, ‘point bar assemblage’, ‘leucosome veins’). 

8.4.1.4.1.  role

The role:GeologicUnitHierarchyRoleTerm property provides a term describing the nature of the parts, e.g. facies, stratigraphic, interbeds, geographic, eastern facies.

8.4.1.4.2.  proportion

The proportion property (SWE::QuantityRange) provides a quantity that represents the fraction of the geologic unit formed by the part.

8.4.1.4.3.  targetUnit

The property targetUnit is an association that specifies exactly one GeologicUnit that is a proper part of another GeologicUnit.

8.4.1.5.  CompositionPart

CompositionPart represents the composition of a geologic unit in terms of earth material constituents (CompoundMaterial).  It decomposes the material making of the unit into parts having distinct roles and proportions.

8.4.1.5.1.  role

The property role:CompositionPartRoleTerm defines the relationship of the CompoundMaterial constituent in the geologic unit, e.g. vein, interbedded constituent, layers, dominant constituent.

8.4.1.5.2.  proportion

The proportion property (SWE::QuantityRange) specifies the fraction of the geologic unit composed of the compound material. 

8.4.1.5.3.  Material

The material:EarthMaterial property contains the material description (8.4.1.6) of the composing part.

8.4.1.6.  EarthMaterial

The EarthMaterial class holds a description of a naturally occurring substance in the Earth.  EarthMaterial represents material composition or substance, and is thus independent of quantity or location. Ideally, EarthMaterials are defined strictly based on physical properties, but because of standard geological usage, genetic interpretations enter into the description as well.  

 

Figure 14 — EarthMaterial and related classes

8.4.1.6.1.  color

The color property (SWE::Category) is a term from a controlled vocabulary that specifies the colour of the earth material. Color schemes such as the Munsell rock and soil color schemes [11] may be used.

8.4.1.6.2.  purpose

The purpose:DescriptionPurpose property provides a specification of the intended purpose or level of abstraction for the given EarthMaterial. The intent is the same a GeologicFeature’s purpose (see 8.4.1.1.2) and it shares the same vocabulary (instance, typicalNorm, definingNorm).

8.4.1.6.3.  gbEarthMaterialDescription (stub property)

The property gbEarthMaterialDescription:EarthMaterialAbstractDescription provides a detailed earth material description of the part.  This property is a stub in GeoSciML Basic as EarthMaterialAbstractDescription is abstract with subtypes defined in GeoSciML Extension.

8.4.1.7.  CompoundMaterial

A CompoundMaterial is an EarthMaterial composed of particles made 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. In the context of GeoSciML “RockMaterial” should be used to describe units made of rock. 

 

Context diagram for CompoundMaterial

Figure 15 — Context diagram for CompoundMaterial

8.4.1.8.  RockMaterial

RockMaterial is a specialized CompoundMaterial that includes consolidated and unconsolidated materials (such as surficial sediments) as well as mixtures of consolidated and unconsolidated materials.  In GeoSciML Basic, Rock Material is essentially a link to a controlled vocabulary (lithology property) and a color (inherited from EarthMaterial).  Specific material properties (and CompoundMaterial nesting) are available in GeoSciML Extension.

8.4.1.8.1.  lithology

The lithology:LithologyTerm property provides a term identifying the lithology class from a controlled vocabulary.

8.4.1.8.2.  Geologic Event

Geologic Event is a package of classes to describe identifiable events during which one or more geological processes act to modify geological entities. A GeologicEvent has a specified geologic age and may have specified environments and processes.  Traditionally, geologists have described the age of a feature without explicitly specifying the event or processes the age relates to (age of a pluton is implicitly the age of the crystallization event). The GeologicEvent class allows explicit documentation of the process and environment.

GeologicalHistory is an ordered aggregation of GeologicalEvent objects, each of which may have an associated geological age, geological environment, and one or more geological process.

The age attributes are representations of a particular geological event or feature expressed as absolute age in terms of years (numericAge) before present or named time periods in the geological time scale (youngerNamedAge and olderNamedAge), or by comparison with other geological events or features (relative age).  An event age can represent an instant in time, an interval of time, or any combination of multiple instants or intervals.

Specifications of age in years before present are based on determination of time durations based on interpretation of isotopic analyses of EarthMaterial (some other methods are used for geologically young materials). Ages specified by geological time scales are essentially based on correlation of a geological unit with a standard chronostratigraphic unit that serves as a reference. Relative ages are based on relationships between geological units such as superposition, intruded by, cross-cuts, or “contains inclusions of” (a.k.a, Steno laws [17]).

 

 Geologic Event summary diagram.

Figure 16 — Geologic Event summary diagram

8.4.1.9.  GeologicEvent

A GeologicEvent is an identifiable event during which one or more geological processes act to modify geological entities.  It may have a specified geologic age (numeric age or GeochologicEraTerm) and may have specified environments and processes. An example might be a cratonic uplift event during which erosion, sedimentation, and volcanism all take place.

Because associated processes are incompatible, a single event cannot be shared between DisplacementEvent, AlterationDescription of MetamorphicDescription (a process associated to DisplacementEvent does not apply to AlterationDescription). 

 

Requirement 14

Identifier/req/gsml-basic/geologicevent-single
Included inRequirements class 4: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-basic
A

An individual GeologicEvent SHALL only apply to one of DisplacementEvent, AlterationDescription or MetamorphicDescription.

A geologic event must at least have one age representation, either numerical or named. 

Requirement 15

Identifier/req/gsml-basic/geologicevent-non-null
Included inRequirements class 4: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-basic
A

Either (olderNamedAge + youngerNamedAge) or numericAge SHALL not be null.

8.4.1.9.1.  eventProcess

The eventProcess:EventProcessTerm property provides a term from a controlled vocabulary specifying the process or processes that occurred during the event. Examples include deposition, extrusion, intrusion, cooling.

8.4.1.9.2.  numericAge

The numericAge:NumericAgeRange property provides an age in absolute year before present (BP).  Present is defined by convention to be January 1st 1950 (although van der Plitch & Hogg [20], suggests this convention to be restricted to radiocarbon estimations).

8.4.1.9.3.  olderNamedAge

The property olderNamedAge:GeochronologicalEraTerm defines the older boundary of age of an event expressed using a geochronologic era defined according to a geologic time scale as per the GeologicTime schema (eg, the International Commission on Stratigraphy Chronostratigraphic Chart — http://www.stratigraphy.org/index.php/ics-chart-timescale).

8.4.1.9.4.  youngerNamedAge

The property youngerNamedAge:GeochronologicalEraTerm defines the younger boundary of age of event expressed using a geochronologic era defined according to a geologic time scale per the GeologicTime schema. (eg, the International Commission on Stratigraphy Chronostratigraphic Chart — http://www.stratigraphy.org/index.php/ics-chart-timescale).

8.4.1.9.5.  eventEnvironment

The eventEnvironment property (SWE::Category) is a category from a controlled vocabulary identifying the physical setting within which a GeologicEvent takes place. Event environment is construed broadly to include physical settings on the Earth surface specified by climate, tectonics, physiography or geography, and settings in the Earth’s interior specified by pressure, temperature, chemical environment, or tectonics.

8.4.1.9.6.  geEventDescription (stub property)

The property geEventDescription:GeologicEventAbstractDescription contains a detailed event description.  This is a stub property in GeoSciML Basic since GeologicEventAbstractDescription is abstract and with subtypes defined in GeoSciML Extension.

8.4.1.10.  NumericAgeRange

The NumericAgeRange class represents an absolute age assignment using numeric measurement results.

8.4.1.10.1.  reportingDate

The reportingDate (SWE::Quantity) property reports a single time coordinate value to report as representative for this NumericAge assignment.

8.4.1.10.2.  olderBoundDate

The olderBoundDate (SWE::Quantity) property reports the older bounding time coordinate in an age range.

8.4.1.10.3.  youngerBoundDate

The youngerBoundDate (SWE::Quantity) property reports the younger bounding time coordinate in an age range.

8.4.2.  Geologic Structure

Geologic Structure is a package of classes to describe GeologicStructures which are a configuration of matter in the Earth based on describable inhomogeneity, pattern, or fracture in an EarthMaterial.  The scale of geological structures ranges from microscopic (micron-scale) to megascopic (km-scale). Examples of such inhomogeneities include fractures, mineral grain boundaries, and boundaries between parts of the rock with different particle geometry (texture) or composition.

GeologicStructure is grounded in relationships between parts of a rock or rock body. As used here, it includes sedimentary structures. The identity of a GeologicStructure is independent of the material that is the substrate for the structure although there are almost always strong dependencies between the nature of the earth material substrate and the kinds of geological structure that may be present.

A disaggregated heap of particles does not have structure, and can only be described in terms of the mineralogy and geometrical character of the constituent particles.  Geologic structures are more likely to be found in, and are more persistent in, consolidated materials than in unconsolidated materials. Properties like “clast-supported”, “matrix-supported”, and “graded bed” that do not involve orientation are considered kinds of GeologicStructure because they depend on the configuration of parts of a rock body.

 

Summary diagram of Geologic structures.

Figure 17 — Summary diagram of Geologic structures

8.4.2.1.  GeologicStructure

A geologic structure is a configuration of matter in the Earth based on describable inhomogeneity, pattern, or fracture in an earth material.  The identity of a GeologicStructure is independent of the material that is the substrate for the structure.  The general GeologicFeatureRelation (available in the Extension package – see 8.5) is used to associate penetrative GeologicStructures with GeologicUnits.  GeoSciML Basic only provides a limited set of core structures (Contact, Fold, ShearDisplacementStructure and Foliation) with a single property to categorise them.  Supplemental properties (through the pattern described in 5.1.1) and geologic structure types are available from the Extension package.

8.4.2.2.  Contact

A contact is a general concept representing any kind of surface separating two geologic units, including primary boundaries such as depositional contacts, all kinds of unconformities, intrusive contacts, and gradational contacts, as well as faults that separate geologic units.

 

Contact context diagram

Figure 18 — Contact context diagram

8.4.2.2.1.  contactType

The property contactType:ContactTypeTerm classifies the contact (e.g. intrusive, unconformity, bedding surface, lithologic boundary, phase boundary) and is a term from a controlled vocabulary.

8.4.2.2.2.  stContactDescription (stub property)

The property stContactDescription:ContactAbstractDescription provides a detailed contact description.  This is a stub property in GeoSciML Basic since ContactAbstractDescription is an abstract class with subtypes defined in GeoSciML Extension.

8.4.2.3.  Fold

A fold is formed by one or more systematically curved layers, surfaces, or lines in a rock body. A fold denotes a structure formed by the deformation of a geologic structure, such as a contact which the original undeformed geometry is presumed, to form a structure that may be described by the translation of an abstract line (the fold axis) parallel to itself along some curvilinear path (the fold profile). Folds have a hinge zone (zone of maximum curvature along the surface) and limbs (parts of the deformed surface not in the hinge zone).  Folds are described by an axial surface, hinge line, profile geometry, the solid angle between the limbs, and the relationships between adjacent folded surfaces if the folded structure is a Layering fabric. 

 

Fold context diagram.

Figure 19 — Fold context diagram

8.4.2.3.1.  profileType

The property profileType:FoldProfileTypeTerm contains a term from a controlled vocabulary specifying the concave/convex geometry of fold relative to earth surface, and relationship to younging direction in folded strata if known. (e.g., antiform, synform, neutral, anticline, syncline, monocline, ptygmatic).

8.4.2.3.2.  stFoldDescription (stub property)

The property stFoldDescription:FoldAbstractDescription provides a detailed fold description.  This is a stub property in GeoSciML Basic since FoldAbstractDescription is an abstract class with subtypes defined in GeoSciML Extension.

8.4.2.4.  Foliation

A foliation is a planar arrangement of textural or structural features in any type of rock.  It includes any of a wide variety of penetrative planar geological structures that may be present in a rock.  Examples include schistosity, mylonitic foliation, penetrative bedding structure (lamination), and cleavage.  Following the proposed definition of gneiss by the NADM Science Language Technical Team [12], penetrative planar foliation defined by layers > 5 mm thick is considered Layering.

Bedding is a fabric representing the average orientation of paleodepositional surface and should be encoded through the foliationType property.  It might apply to bedding that is layering or a foliation without layering (e.g. clast alignment in amalgamated beds).

 

Foliation context diagram

Figure 20 — Foliation context diagram

8.4.2.4.1.  foliationType

The foliationType:FoliationTypeTerm property specifies the type of foliation from a controlled vocabulary.  Examples include crenulation cleavage, slaty cleavage and schistosity.

8.4.2.4.2.  stFoliationDescription (stub property)

The property stFoliationDescription:FoliationAbstractDescription provides a detailed foliation description.  This is a stub property in GeoSciML Basic since FoliationAbstractDescription is an abstract class with subtypes defined in GeoSciML Extension.

8.4.2.5.  ShearDisplacementStructure

A shear displacement structure includes all brittle to ductile style structures along which displacement has occurred, from a simple, single ‘planar’ brittle or ductile surface to a fault system comprised of tens of strands of both brittle and ductile nature. This structure may have some significant thickness (a deformation zone) and have an associated body of deformed rock that may be considered a deformation unit (which geologicUnitType is ‘DeformationUnit’) which can be associated to the ShearDisplacementStructure using GeologicFeatureRelation from the GeoSciML Extension package (8.5.1.2).

 

ShearDisplacementStructure context diagram

Figure 21 — ShearDisplacementStructure context diagram

8.4.2.5.1.  faultType

The faultType:FaultTypeTerm property contains a term from a controlled vocabulary describing the type of shear displacement structure (e.g., thrust fault, normal fault or wrench fault).

8.4.2.5.2.  stStructureDescription

The property stStructureDescription:ShearDisplacementStructureAbstractDescription provides a detailed geologic structure description.  This is a stub property in GeoSciML Basic since ShearDisplacementStructureAbstractDescription is an abstract class with subtypes defined in GeoSciML Extension.

8.4.3.  Geomorphology

The Geomorphology sub-package describes features that comprise the shape and nature of the Earth’s land surface (i.e., landforms).  These landforms may be created by natural or anthropogenic processes.

 

Geomorphologic feature summary diagram

Figure 22 — Geomorphologic feature summary diagram

8.4.3.1.  GeomorphologicFeature

A geomorphologic feature is a kind of GeologicFeature describing the shape and nature of the Earth’s land surface.  These landforms may be created by natural Earth processes (e.g., river channel, beach, moraine or mountain) or through human (anthropogenic) activity (e.g., dredged channel, reclaimed land, mine waste dumps).  In GeoSciML, the geomorphologic feature is modelled as a feature related (through unitDescription property) to a GeologicUnit that composes the form.

 

Figure 23 — Partial encoding of landform located in Elba Island as part of a geomorphological unit (encoded from a map from D’Orefice et al, 2009)

Figure 23 shows an example of GeoSciML encoding of a landform lava cone geomorphologic unit (from [2]) located in Elba Island showing how the geomorphologic feature is related to the geologic unit and materials that it is made of.

8.4.3.1.1.  unitDescription

The unitDescription property is an association that links the geomorphologic feature to a geologic description (e.g., related stratigraphic units and earth materials).

8.4.3.1.2.  gmFeatureDescription (stub property)

The property gmFeatureDescription:GeomorphologicUnitAbstractDescription provides a detailed morphologic description.  This is a stub property in GeoSciML Basic since GeomorphologicUnitAbstractDescription is an abstract class with no concrete subtype in GeoSciML Basic.

8.4.3.2.  NaturalGeomorphologicFeature

A natural geomorphologic feature is a geomorphologic feature (i.e., landform) that has been created by natural Earth processes. For example, river channel, beach ridge, caldera, canyon, moraine or mud flat.

8.4.3.2.1.  naturalGeomorphologicFeatureType

The property naturalGeomorphologicFeatureType: NaturalGeomorphologicFeatureTypeTerm is a reference from a controlled vocabulary describing the type of geomorphologic feature.

8.4.3.2.2.  activity

The activity property (SWE::Category) contains a category term from a controlled vocabulary describing the current activity status of the geomorphologic feature (e.g., currently active, dormant, inactive, reactivated, etc.).

8.4.3.3.  AnthropogenicGeomorphologicFeature

An anthropogenic geomorphologic feature is a geomorphologic feature (i.e., landform) which has been created by human activity.  For example, a dredged channel, midden, open pit or reclaimed land.

8.4.3.3.1.  anthropogenicGeomorphologicFeatureType

The anthropogenicGeomorphologicFeatureType: AnthropogenicGeomorphologicFeatureTypeTerm is a reference from a controlled vocabulary describing the type of geomorphologic feature.

8.4.4.  Collection

A GeoSciML collection is a convenience class to manage sets of features or type instances.  A collection contains classes that facilitate the structuring of WFS response documents and other application uses.  

 

GSML collection summary diagram.

Figure 24 — GSML collection summary diagram

8.4.4.1.  GSML

GSML is a collection class grouping a set of features or types which are members of this collection.  A collectionType property provides context or purpose.

8.4.4.1.1.  member

The member property is an association that links a GSML instance to features and objects to be included as members of the collection.  A collection can be made of heterogeneous items.

8.4.4.1.2.  collectionType

The collectionType:CollectionTypeTerm property contains a term from a controlled vocabulary describing the type of collection, such as Geologic Map, Boreholes, 3D models.

8.4.4.2.  GSMLItem

GSMLItem (Figure 24) constrains the collection members to instances of EarthMaterial, GeologicFeature, GM_Object, MappedFeature, AbstractFeatureRelation and OM::SF_SamplingFeature.  GSMLItem has the stereotype <<Union>> and according to ISO19103 (Clause 6.8.2), only one of the properties can be materialized at the time. It is important to note that the <<Union>> stereotype can be encoded in two distinct ways.

a)     by materializing the GSMLItem  (as prescribed by ISO 19136)

 

b)    using GSMLItem as a validation constraint

 

This requirements class does not impose any encoding style for Union stereotype, although in the XML encoding requirements class (see 9.3) we chose the second option.

Table 3 — Types of GSMLItem members

PropertyDescription
earthMaterialItemThe earthMaterialItem attribute is a placeholder for the EarthMaterial class that is included as a member of a GSML Collection.
featureItemThe featureItem attribute is a placeholder for the GeologicFeature class that is included as a member of a GSML Collection.
geometryItemThe geometryItem attribute is a placeholder for the AbstractGeometry class that is included as a member of a GSML Collection.
mappedItemThe mappedItem attribute is a placeholder for the MappedFeature class that is included as a member of a GSML Collection.
relationItemThe relationItem attribute is a placeholder for the GeologicRelation class that is included as a member of a GSML Collection.
samplingFeatureItemThe samplingFeatureItem attribute is a placeholder for the SamplingFeature class that is included as a member of a GSML Collection.

8.4.5.  GeoSciML data types

GeoSciML Data is a package of data types that describes the planar or linear orientation of a geologic feature using conventions used in geology. They allow specifying direction by a numerical direction vector (e.g., dip/dip direction), or as a description (e.g., compass point (NE), or other text — “toward fold hinge”, “below”).  An additional GSML_QuantityRange class extends SWE::QuantityRange to allow upper and lower values in a numerical range to be delivered as two separate attributes. This is to facilitate query operations on upper and lower values by providing explicit names for these values (which are otherwise encoded as anonymous members of an array in SWE common).

 

Summary diagram of specialised GeoSciML data types

Figure 25 — Summary diagram of specialised GeoSciML data types

8.4.5.1.  GSML_GeometricDescriptionValue

GSML_GeometricDescriptionValue is a special abstract data type for descriptions of planar or linear orientations of a geologic feature.   Different subtypes allow specifying direction by direction vector (e.g. dip/dip direction), compass point (e.g.  NE), or description (e.g. “toward fold hinge”, “below’).

8.4.5.1.1.  determinationMethod

The determinationMethod:DeterminationMethodTerm  property describes the way the orientation value was determined (e.g. measured, inferred from dip slope, etc.) using a reference to a controlled vocabulary.

8.4.5.1.2.  descriptiveOrientation

The descriptionOrientation:Primitive::CharacterString contains a textual specification of orientation, possibly referencing some local geography (e.g. “toward fold hinge”, “below”).

8.4.5.2.  GSML_PlanarOrientation

A planar orientation is composed of two values; the azimuth (a compass point) and a dip (the angle from the horizontal).  Polarity of the plane indicates whether the planar orientation is associated with a directed feature that is overturned, upright, vertical, etc.  There are several conventions to encode a planar orientation and this specification does not impose one but provides a convention property to report it. It must be noted that allowance for different conventions makes manipulation of the data more difficult. Therefore it is recommended that user communities adopt a single measurement convention.

Requirement 16

Identifier/req/gsml-basic/plane-pol-dip-az-not-null
Included inRequirements class 4: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-basic
A

At least one of polarity, azimuth or dip SHALL not be null.

To have any meaningful value, the planar orientation shall have at least a value for polarity, azimuth or dip.

8.4.5.2.1.  convention

The property convention:ConventionCode contains the convention used for the measurement from a controlled vocabulary.

8.4.5.2.2.  azimuth

The azimuth (SWE::QuantityRange) property (compass point, bearing etc.) contains the value of the orientation. The convention property (8.4.6.2.1) reports how azimuth is interpreted (if it is relative to a quadrant).

8.4.5.2.3.  dip

The dip (SWE::QuantityRange) reports the angle that the structural surface (e.g. bedding, fault plane) makes with the horizontal measured perpendicular to the strike of the structure and in the vertical plane as a numeric value or term.

8.4.5.2.4.  polarity

The polarity:PolarityCode indicates whether the planar orientation is associated with a directed feature that is overturned, upright, vertical etc., using a controlled vocabulary.

 

8.4.5.3.  GSML_LinearOrientation

A linear orientation is composed of a trend (the compass orientation of the line) and a plunge (the angle from the horizontal).  This vector may be oriented (pointing in a specific direction) or not.

Requirement 17

Identifier/req/gsml-basic/linear-trend-plunge-not-null
Included inRequirements class 4: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-basic
A

At least one of plunge or trend SHALL not be null.

To have any meaningful value, an instance of GSML_LinearOrientation shall at least have a trend or a plunge value.

8.4.5.3.1.  directed

The directed:LinearDirectedCode property indicates if the orientation represents a linear feature that is directed, e.g. clast imbrication, mylonitic lineation with sense of shear, slickenlines with displacement direction, rather than undirected (like a fold hinge line or intersection lineations).  A code list will indicate which is the directed end of the linear orientation.  The value of the property comes from a controlled vocabulary.

8.4.5.3.2.  plunge

The property plunge (SWE::QuantityRange) reports the magnitude of the plunge as an angle from horizontal.

8.4.5.3.3.  trend

The property trend (SWE::QuantityRange) reports the azimuth (compass bearing) value of the linear orientation. 

8.4.5.4.  GSML_Vector

A GSML_Vector is a data type representing a linear orientation with a magnitude (a quantity assigned to this vector).   If the magnitude is unknown, a GSML_LinearOrientation (8.4.6.3) shall be used.

8.4.5.4.1.  magnitude

The magnitude property (SWE::QuantityRange) reports the magnitude of the vector.

8.4.5.5.  GSML_QuantityRange

GSML_QuantityRange is a specialization of SWE Common QuantiytyRange (OGC 08-094r1, Clause 7.2.13)  where lower and upper values are made explicit.  SWE::QuantityRange uses an array of values (RealPair, see Clause OGC 08-094r1,7.2.1) where the lowest value is the first element and the highest the second.  This convenience data type has been created as an alternative encoding for implementations that do no support encoding of arrays in a single field (e.g. DBF) or reference to elements in string encoded arrayshttps://docs.ogc.org/is/16-008/16-008.html#_ftnref3[[3]] (eg. Filter Encoding Specification 2.0 – OGC 09-029r2).

 

Context diagram for QuantityRange making lower and upper values explicit

Figure 26 — Context diagram for QuantityRange making lower and upper values explicit

The lowerValue shall be less than or equal to the upperValue.

Requirement 18

Identifier/req/gsml-basic/quantity-range-order
Included inRequirements class 4: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-basic
A

The QuantityRange lowerValue SHALL be less than or equal to the upperValue.

The values reported in lowerValue and upperValue shall be the same as the pair of values in inherited values property.

Requirement 19

Identifier/req/gsml-basic/quantity-range-repeat
Included inRequirements class 4: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-basic
A

The QuantityRange’s value[0] SHALL provide the same value as lowerValue and value[1] SHALL provide the same value as upperValue.

8.4.5.5.1.  lowerValue

The property lowerValue:Real contains the lower bound of the range. It shall be a copy of inherited SWE::QuantityRange::value[0].

8.4.5.5.2.  upperValue

The property upperValue:Real contains the upper bound of the range. It shall be a copy of inherited SWE::QuantityRange::value[1].

Example:

 

Figure 27 — Encoding of a quantity range of [15.6,26.7].  Note that the value is encoded in both lowerValue, upperValue and in value as an array.

8.4.6.  GeoSciML Basic vocabularies

Geology is a descriptive science and uses vocabularies extensively.  Table 4 lists the vocabularies used in GeoSciML Basic.  Each of those vocabularies shall be implemented using externally managed vocabularies as specified in clause 8.2.7

Table 4 — Vocabularies used in GeoSciML Basic

VocabularyDescription
CompositionPartRoleTermThis class is a blank placeholder for a vocabulary of terms to describe the role that a compositional part plays in a geologic unit.
DescriptionPurpose

Codes used for the specification of the intended purpose/level of abstraction for a given feature or object instance, i.e. the reason for the existence of the GeologicFeature.

Values shall be either: instance, typicalNorm or definingNorm.

ExposureTermThis class is a blank placeholder for a vocabulary of terms describing the nature of the expression of the mapped feature at the earth’s surface (e.g., exposed, concealed).
GeologicUnitHierarchyRoleTermRole of the unit in the hierarchy.
GeologicUnitTypeTerm

This class is an indicative placeholder only for a vocabulary of terms describing the type of geologic unit.  Users are encouraged to use the vocabulary of unit types provided by the CGI vocabularies working group.

 

Example of values: GeologicUnit, AllostratigraphicUnit,

AlterationUnit, ArtificialGround, BiostratigraphicUnit, ChronostratigraphicUnit, DeformationUnit, ExcavationUnit, GeophysicalUnit, LithodemicUnit, LithogeneticUnit, LithologicUnit, LithostratigraphicUnit, LithotectonicUnit, MagnetostratigraphicUnit, MassMovementUnit, Pedoderm, PedostratigraphicUnit, PolarityChronostratigraphicUnit.

GeologicUnitPartRoleTermThis class is a blank placeholder for a vocabulary of terms describing the nature of the parts of a geologic unit, e.g. facies, stratigraphic, interbeds, geographic, eastern facies.
LithologyTermRefers to a vocabulary of terms describing the lithology of the compound earth material (e.g., granite, sandstone, schist)
MappingFrameTermA mapping surface, a section, a Borehole.
RankTerm

This class is a blank placeholder for a vocabulary of terms describing the rank of a geologic unit (e.g., Group, Formation, Member, etc.).

 

CollectionTypeTermTypes of collections of geological and geophysical objects.
EventProcessTermRefers to a vocabulary of terms specifying the process or processes that occurred during an event. Examples include deposition, extrusion, intrusion, cooling.
GeochronologicEraTermTerm from a Geochronological vocabulary
ContactTypeTermRefers to a vocabulary of terms describing types of geological contacts
FaultTypeTermA vocabulary of terms describing the type of shear displacement structure (e.g., thrust fault, normal fault, wrench fault)
FoldProfileTypeTermRefers to a vocabulary of terms specifying concave/convex geometry of fold relative to earth surface, and relationship to younging direction in folded strata if known. antiform, synform, neutral, anticline, syncline, monocline, ptygmatic
FoliationTypeTerm

Refers to a vocabulary of terms defining the type of foliation (e.g., crenulation cleavage, gneissic layering, slaty cleavage, schistosity, etc.)

 

AnthropogenicGeomorphologic
FeatureTypeTerm

Refers to a vocabulary of terms describing the type of anthropogenic geomorphologic feature

 

NaturalGeomorphologic
FeatureTypeTerm

Refers to a vocabulary of terms describing the type of natural geomorphologic feature

 

ConventionCode

Suggested values: “dip dip direction”, “strike dip right hand rule” (The strike and dip of planar data is listed according to the ‘right-hand rule’ or, as one looks along the strike direction, the surface dips to the right.)  This list is an indicative list only of terms used to describe the convention used for the orientation measurement.  Users are encouraged to use a vocabulary of terms managed by the CGI vocabularies working group outside of this model.

 

DeterminationMethodTerm

This class is an empty placeholder for a vocabulary of terms describing the method used to determine the measured orientation. Users are encouraged to use a vocabulary of terms managed by the CGI vocabularies working group outside of this model. 

 

LinearDirectedCode

Examples

  • “directed” (indicates that the orientation is directed)

  • “directed down” (indicates that the linear orientation is directed below the horizon)

  • “directed up” (indicates that the linear orientation is directed above the horizon)

 

This list is an indicative example list only of terms used to describe the values to use for terms related to directedness of linear orientations.  Users are encouraged to use a vocabulary of terms managed by the CGI vocabularies working group outside of this model.

 

PlanarPolarityCode

This list is an indicative list only of terms used to describe the values to use for expressing overturned or upright facing of planar orientation measurements. Users are encouraged to use a vocabulary of terms managed by the CGI vocabularies working group outside of this model.

 

e.g., “upright”, “overturned”, “vertical”

 

8.4.7.  Instance examples

The following figure shows a partial encoding of an existing map from Drewes [3].  This example has been chosen because it was selected for a similar exercise for the North American Data Model (http://ngmdb.usgs.gov/www-nadm/dmdt/).  Figure 28 shows a small section of a map showing unit Ttv (Dacitic vent breccia) from a quadrangle in Arizona, USA.  The original legend description is shown in Figure 29.

 

Figure 28 — Excerpt from Drewes map [3] with a Dacitic vent breccia unit highlighted (Ttv)

 

Figure 29 — Original description from Drewes map [3] legend.  This legend item is represented as a GeologicFeature (specifically, a GeologicUnit)

The map also has a cross section through the same Ttv unit (Figure 30) showing an example of a non-map mapping frame.

 

The same Dacitic vent breccia unit

Figure 30 — The same Dacitic vent breccia unit, shown in a cross section (a different MappingFrame)

 

Figure 31 — Partial encoding of the Dacitic vent breccia unit from Drewes’ map [3] partitioned into GeoSciML instances

8.5.  GeoSciML Extension Requirements Class (Normative)

Requirements class 5: Requirements Class ‘GeoSciML Extension’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-extension
Target typeEncoding
Prerequisites/req/gsml-basic
/req/gsml-geologictime
Normative statementsRequirement 20: /req/gsml-extension/geologicfeature-history
Requirement 21: /req/gsml-extension/contact-chronoboundary
Requirement 22: /req/gsml-extension/slipComponents-slip

The extension package provides classes to further the descriptions of basic classes by adding more properties and supplemental relations.  It extends abstract description stubs declared in basic package and introduces new GeologicStructure features.

 

GeoSciML extension package dependencies.

Figure 32 — GeoSciML extension package dependencies

8.5.1.  GeologicRelation

 

Figure 33 — Summary diagram of GeologicFeatureRelation as a concrete subtype of AbstractFeatureRelation stub class

8.5.1.1.  GeologicHistory

GeoSciML uses the generic relatedFeature:GeologicFeatureRelation to associate GeologicFeature with other GeologicFeatures, which includes GeologicEvents.  However, this functionality is only available from the Extension package because it adds extra complexity that Basic hopes to avoid. 

To allow geologic age description in GeoSciML Basic without GeologicFeatureRelation, GeologicFeature has an explicit geologicHistory property to associate GeologicFeature with a GeologicEvent.  The consequence for someone using GeoSciML Extension is the presence of two different ways to link a GeologicFeature and GeologicEvent:

  1. A direct association through geologicHistory

  2. A generic GeologicFeatureRelation.

To prevent confusion and promote consistency, especially in query scenarios, association between GeologicFeature and GeologicEvent, for the purpose of describing geologic history, and therefore geologic age, shall use the geologicHistory property.  A GeologicFeatureRelation can be used in any other circumstances.

Requirement 20

Identifier/req/gsml-extension/geologicfeature-history
Included inRequirements class 5: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-extension
A

A GeologicFeatureRelation SHALL not be used to associate a GeologicFeature to a GeologicEvent if GeologicFeature::geologicHistory can provide the same information.

8.5.1.2.  GeologicFeatureRelation

The GeologicFeatureRelation class defines the general structure used to define relationships between any GeoSciML feature types.  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:  a Source may point to an intrusive igneous rock unit.  In this case, the Target would point to the appropriate host rock body and the relationship attribute would be ‘intrudes’.  Other appropriate relationship attributes might include: overlies, offsets, crosscuts, folds, etc.

Many other types of relationships can also be accommodated via GeologicRelation, for example, topological relations could be described where they are geologically significant.

 

Generic geologic feature relation

Figure 34 — Generic geologic feature relation

8.5.1.2.1.  relationship

The relationship:GeologicRelationshipTerm property contains a term from a controlled vocabulary to describe the geologic relationship (e.g., stratigraphic relation, structural relation, intrusive relation).

8.5.1.2.2.  sourceRole

The property sourceRole:RelationRoleProperty contains a term from a controlled vocabulary describing the role played by the source geologic feature or object (e.g., overlying unit, underlying unit).

8.5.1.2.3.  targetRole

The property targetRole:RelationRoleTerm contains a term from a controlled vocabulary describing the role played by the target geologic feature or object. (e.g., overlying unit, underlying unit)

8.5.1.3.  MaterialRelation

The MaterialRelation class describes the relationships between constituent parts in an EarthMaterial (e.g. A mineral overgrowth on a phenocryst within a granite). 

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.

 

Material relation context diagram.

Figure 35 — Material relation context diagram

8.5.1.3.1.  relationship

The property relationship:GeologicRelationshipTerm contains a term from a controlled vocabulary to describe the geologic relationship (e.g., sedimentary relation, igneous relation).

8.5.1.3.2.  sourceRole

The property sourceRole:RelationRoleTerm contains a term that describes the role played by the source earth material part (e.g., matrix, clast, overgrowth).

8.5.1.3.3.  targetRole

The property targetRole:RelationRoleTerm contains a term describing the role played by the target earth material part (e.g., matrix, clast, overgrowth).

8.5.2.  EarthMaterialDetails

EarthMaterialDescription abstract class is materialised into a series of concrete classes to address various aspects of EarthMaterial descriptions:

  • CompositionDescription

  • FabricDescription

  • RockMaterialDescription

  • AlterationDescription

  • PhysicalDescription

  • MetamorphicDescription

  • CompoundMaterialDescription

 

Overview of earth material description.

Figure 36 — Overview of earth material description

8.5.2.1.  AlterationDescription

 

Alteration description context diagram.

Figure 37 — Alteration description context diagram

AlterationDescription describes 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. It includes weathering, supergene alteration, hydrothermal alteration and metasomatic effects not considered metamorphic. For example, a soil profile description would have to be constructed as a GeologicUnit (geologicUnitType = PedologicUnit) with unit parts representing the various horizons in the profile.  Thickness of a weathering profile can be delivered as unitThickness of a GeologicUnit of geologicUnitType equal to “AlterationUnit” (Figure 38).

 

 

Example of a weathering profile.

Figure 38 — Example of a weathering profile

An example encoding of an altered geologic unit from Drewes [3] is shown in Figure 39.

 

Figure 39 — Example of describing alteration halo from Drewes [3].

8.5.2.1.1.  alterationType

The property alterationType:AlterationTypeTerm contains a term from a controlled vocabulary of alteration types (e.g., potassic, argillic, advanced argillic).

8.5.2.1.2.  alterationProduct

The property alterationProduct is an association between the AlterationDescripton and EarthMaterial describing the material resulting from the alteration processes, e.g. alteration minerals, saprolite, ferricrete, clay, calcrete, skarn, etc. Materials observed in a soil profile could be identified using this property.

8.5.2.1.3.  alterationDistribution

The alterationDistribution (SWE::Category) property describes the spatial distribution or geometry of alteration zones using a term from a controlled vocabulary. e.g., patchy, spotted, banded, veins, vein breccia, pervasive, disseminated, etc.

8.5.2.1.4.  alterationDegree

The property alterationDegree (SWE::Category) contains a term from a controlled vocabulary to indicate the magnitude of observed alteration.

8.5.2.1.5.  alterationEvent

The property alterationEvent is an association between an AlterationDescription and a GeologicEvent describing the GeologicEvent associated with the alteration.

8.5.2.2.  ChemicalComposition

ChemicalComposition is a kind of EarthMaterialDescription that delivers the chemical composition of a geological unit or earth material, as a list of element or oxide concentrations.

 

Chemical composition context diagram.

Figure 40 — Chemical composition context diagram

8.5.2.2.1.  chemicalAnalysis

The chemicalAnalysis property (SWE:DataRecord) contains a collection of geochemical results in a form of a DataRecord (a collection of fields composed of description and values).

8.5.2.3.  CompoundMaterialDescription

The CompoundMaterialDescription class is a kind of EarthMaterialDescription that provides an extended description of a compound earth material (i.e., rocks and unconsolidated solid earth materials).

 

Compound material description context diagram.

Figure 41 — Compound material description context diagram

8.5.2.3.1.  compositionCategory

The compositionCategory property (SWE::Category) provides a term from a controlled vocabulary to specify the gross compositional character of a compound material. Composition as used here is loosely construed to include both chemical composition and petrographic composition, thus multiple values may be applied to a single rock, e.g. metaluminous and alkalic, undersaturated and basic, etc. Terms would typically include broad chemical classifications such as silicate, carbonate, ferromagnesian, oxide.  However, this attribute may have different terminology for different kinds of rocks — for example sandstone petrographic classification terms (e.g. feldspathic) might be placed here.

8.5.2.3.2.  geneticCategory

The property geneticCategory (SWE::Category) provides a term from a controlled vocabulary that represents a summary geologic history of the material. (i.e., a genetic process classifier term). Examples include igneous, sedimentary, metamorphic, shock metamorphic, volcanic, pyroclastic.

8.5.2.3.3.  particleGeometry

The particleGeometry:ParticleGeometryDescription contains an instance of ParticleGeometryDescription.

8.5.2.3.4.  constituent

The property constituent is an association between a CompoundMaterialDescription and a ConstituentPart that makes up part of the CompoundMaterial.

8.5.2.4.  ParticleGeometryDescription

ParticleGeometryDescription describes particles in a CompoundMaterial independent of their relationship to each other or their 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, e.g., well sorted, poorly sorted, bimodal sorting), particle shape (surface rounding or crystal face development, e.g., well rounded, euhedral, anhedral), and particle aspect ratio (e.g., elongated, platy, bladed, compact, acicular).

 

Figure 42 — ParticleGeometry context diagram

8.5.2.4.1.  particleType

The particleType:ParticleTypeTerm provides a term from a controlled vocabulary to specify the nature of individual particles of each constituent in an EarthMaterial aggregation, based mostly on their genesis.  When applied on ParticleDescription for CompoundMaterial, it would characterise all particles in aggregate. Use this property on CompoundMaterial to distinguish rocks composed of crystals (crystalline rocks) from rocks composed of granular particles (clasts, fragments). Examples include ooliths, crystals, pore space. Constituent type is determined based on the nature of the particles, and ideally is independent of the relationship between particles in a compound material aggregation.

8.5.2.4.2.  aspectRatio

The aspectRatio property (SWE::Category) contains a term from a controlled vocabulary describing the geometry of particles based on the ratios of lengths of long, intermediate and short axes of grains. It equates to sphericity in sedimentary rocks (i.e., the degree to which the shape of a particle approximates a sphere).  The formal definition is “A quantitative specification based on the ratio of lengths of long, intermediate and short axes of grain shape” [16] [24]. (e.g., prolate, slightly flattened, very bladed, equant, acicular, tabular).

8.5.2.4.3.  shape

The shape property (SWE::Category) describes,

  1.  the development of crystal faces bounding particles in crystalline compound materials, and

  2.  the surface rounding of grains in sedimentary rocks. Roundness is a measure of the sharpness of the edges between surfaces bounding a particle [10] [22].

The terms shall be a term from a controlled vocabulary and be appropriate for the kind of compound material (e.g., for crystalline rocks- euhedral, ideoblastic, subhedral, anhedral, xenoblastic; for sedimentary rocks — angular, rounded).

8.5.2.4.4.  size

The property size (SWE::QuantityRange) reports the size that specifies particle grainsize.  Values may be reported using absolute measurements (e.g., range, mean, median, mode, maximum).

8.5.2.4.5.  sorting

The sorting property (SWE::Category) contains a term from a vocabulary that specifies the size distribution of particles in a CompoundMaterial. Terminology for sorting in sedimentary rocks is based on the quantitative Graphic Standard Deviation (IGSD) scheme proposed by Folk [5] [6].  Example for this attribute may include sedimentary terms such as well sorted and poorly sorted, or igneous terms such as porphyritic, equigranular, seriate.

8.5.2.4.6.  sourceOrganism

The sourceOrganism property is an association between a ParticleGeometryDescription and an Organism that is the source of the fossil particles (sponge spicules, bivalve shells, etc.).

8.5.2.5.  ConstituentPart

 

ConstituentPart context diagram.

Figure 43 — ConstituentPart context diagram

The ConstituentPart class describes how Earth materials may be made up of other Earth materials, including the proportion of the constituent part in the whole (e.g., 20%, minor, dominant); and the role that the constituent plays in the whole (e.g., matrix, groundmass, framework, phenocryst, xenolith, vein).

The distinction between “role” and “particleType” is subtle.  An operational test is that particleType 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 a 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’. Readers should consider Dunham’s textural classification of carbonate rocks (wackestone, packstone, grainstone, etc.) in the description of carbonate rocks [4]. 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…).

8.5.2.5.1.  role

The role:ConstituentPartRoleTerm property contains a term from a controlled vocabulary that describes the role a ConstituentPart plays in a CompoundMaterial aggregation. The same EarthMaterial may occur as different ConstituentParts playing different roles within one CompoundMaterial.  For example, feldspar may be present as groundmass (“groundmass” is a ConstituentPart::role) and as phenocrysts (“phenocryst” is another ConstituentPart::role) within a single igneous rock.

8.5.2.5.2.  proportion

The proportion property (SWE::QuantityRange) reports the fraction of the whole that is formed by a ConstituentPart in a part/whole relationship.  It is used for the ConstituentPart portion in a CompoundMaterial.  It specifies the fraction of the EarthMaterial formed by the part (e.g., 20%, minor, dominant).

8.5.2.5.3.  constituentMaterial

The constituentMaterial property is an association between a ConstituentPart and an EarthMaterial that specifies the EarthMaterial that is forming the ConstituentPart.

8.5.2.6.  FabricDescription

The FabricDescription data type describes all types of fabrics associated with a CompoundMaterial (i.e., 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 [15], 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 ([19] p. 21-24; [7] p. 73; [10],[15]).

FabricDescription is distinguished from ParticleGeometry based on the criteria that particle geometry is preserved if a CompoundMaterial is disaggregated, while FabricDescription is not defined if the material is disaggregated.

 

Fabric description context diagram.

Figure 44 — Fabric description context diagram

8.5.2.6.1.  fabricType

The fabricType:FabricTypeTerm property contains a term from a controlled vocabulary to denote the type of fabric in the CompoundMaterial (e.g., rapikivi texture, autobrecciation, spaced cleavage, porphyroblastic, cross-bedding).  The fabricType describes a pattern, defined by one or more CompoundMaterial constituents, that is present throughout a rock body when considered at some scale. It 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 [15], 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.

8.5.2.7.  InorganicFluid

An inorganic fluid is a non-crystalline EarthMaterial (solid, liquid, or gas) that tends to flow or conform to the shape of its container (examples: water, brine, glass)..  By convention liquid mercury is considered a mineral.   This class is an empty placeholder for extension at a later date, or by other domain models.

 

Inorganic fluid context diagram.

Figure 45 — Inorganic fluid context diagram

8.5.2.8.  MetamorphicDescription

The data type MetamorphicDescription describes the character of metamorphism applied to a CompoundMaterial or GeologicUnit using one or more properties including estimated intensity (grade; e.g. high grade, low grade), characteristic metamorphic mineral assemblages (facies; e.g., greenschist, amphibolite), peak P-T estimates, and protolith material if known.  A MetamorphicDescription provides a link to the GeologicEvent associated to the metamorphic event.

 

Metamorphic description context diagram.

Figure 46 — Metamorphic description context diagram

8.5.2.8.1.  metamorphicFacies

The metamorphicFacies property (SWE::Category) contains a term from a controlled vocabulary that describes a characteristic mineral assemblage indicative of certain metamorphic pressure and temperature conditions. Examples include Barrovian metasedimentary zones (e.g., biotite facies, kyanite facies) or assemblages developed in rocks of more mafic composition (e.g., greenschist facies, amphibolite facies).

8.5.2.8.2.  metamorphicGrade

The metamorphicGrade property (SWE::Category) contains a term from a controlled vocabulary that indicates the intensity or rank of metamorphism applied to an EarthMaterial (e.g., high metamorphic grade, low metamorphic grade).

It indicates in a general way the pressure-temperature (PT) environment in which the metamorphism took place. The determination of metamorphic grade is based on mineral assemblages (i.e., facies) present in a rock that are interpreted to have crystallized in equilibrium during a particular metamorphic event.

8.5.2.8.3.  peakPressureValue

The peakPressureValue property (SWE::Quantity) reports a numerical value to indicate the estimated pressure at peak metamorphic conditions.

8.5.2.8.4.  peakTemperatureValue

The peakTemperatureValue property (SWE::Quantity) reports a numerical value to indicate the estimated temperature at peak metamorphic conditions.

8.5.2.8.5.  protolithLithology

The protolithLithology is an association between a MetamorphicDescription and an EarthMaterial that describes the pre-metamorphic lithology for a metamorphosed CompoundMaterial.

8.5.2.8.6.  metamorphicEvent

The metamorphicEvent property is an association between a MetamorphicDescription and a GeologicEvent that denotes the age, environment and process associated with a particular metamorphic assemblage in a GeologicUnit.

8.5.2.9.  OrganicMaterial

OrganicMaterial is an EarthMaterial that belongs to the class of chemical compounds having a reduced carbon basis (as distinct from carbonates), and derived from living organisms. It 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.

 

Organic material context diagram.

Figure 47 — Organic material context diagram

8.5.2.10.  Organism

Organism is a broad class to represent any living or once living things. This is the connection to taxonomy/biology for fossils.  This class is an empty placeholder for extension at a later date, or by other domain models.

 

Organism context diagram.

Figure 48 — Organism context diagram

8.5.2.11.  PhysicalDescription

PhysicalDescription is a class that describes the numeric physical properties of a geologic unit (GeologicUnit 8.4.1.3), earth material (EarthMaterial 8.4.1.6), or geologic structure (GeologicStructure 8.4.3.1). (e.g., density, porosity, magnetic susceptibility, remanent magnetism).  These properties are modelled here as scalar numeric values (SWE::Quantity).

Vector and tensor physical properties are considered to be more applicable to located observations and should be delivered as OM_Observations with associated geologic unit or geologic structure features.  Since PhysicalProperty can be an arbitrary property, it satisfies the requirements of clause 7.2.2.8 or OGC 10-004r3 that states that “The observed property shall be a phenomenon associated with the feature-of-interest.”, and hence any GeologicUnit, GeologicStructure are valid features of interest for any OM_Observation.

 

Physical description context diagram.

Figure 49 — Physical description context diagram

8.5.2.11.1.  propertyName

The property propertyName:PhysicalPropertyTerm contains a term from a controlled vocabulary of physical properties of rock materials (e.g., density, porosity, magnetic susceptibility, remnant magnetism, permeability, seismic velocity).

8.5.2.11.2.  propertyMeasure

The propertyMeasure property (SWE::Quantity) is a scalar measurement of the physical property of a rock material, unit or structure.

8.5.2.12.  RockMaterialDescription

RockMaterialDescription provides extended description of RockMaterial.

 

Rock material description context diagram.

Figure 50 — Rock material description context diagram

8.5.2.12.1.  consolidationDegree

The consolidationDegree property (SWE::Category) contains a term from a controlled vocabulary that specifies the degree to which an aggregation of EarthMaterial particles is a distinct solid material. Consolidation and induration are related concepts specified by this property. They define a continuum from unconsolidated material to very hard rock. Induration is the degree to which a consolidated material is made hard, operationally determined by how difficult it is to break a piece of the material. Consolidated materials may have varying degrees of induration [13].

8.5.3.  GeologicAgeDetails

GeologicEventDescription provides extended description of geologic events through links to GeochronologicEras in the GeologicTimescale model.  GeoSciML Basic provides terms whereas GeoSciML Extension provides a fuller ontology to describe geochronology (see 8.6).

 

GeologicAgeDetails summary diagram.

Figure 51 — GeologicAgeDetails summary diagram

8.5.3.1.  olderGeochronologicEra

The olderGeochronologicalEra property is an association between a GeologicEventDescription and a GeochronologicEra that corresponds to the older estimated age of a geologic feature.

8.5.3.2.  youngerGeochronologicEra

The youngerGeochronologicEra property is an association between a GeologicEventDescription and a GeochronologicEra that corresponds to the younger estimated age of a geologic feature.

8.5.4.  GeologicStructureDetails

The Geologic Structure Details package provides for extended descriptions of geologic structures. 

 

Summary diagram for GeologicStructureDetails.

Figure 52 — Summary diagram for GeologicStructureDetails

8.5.4.1.  ContactDescription

The ContactDescription provides extended descriptive properties of a geologic contact.  If the contact type is ChronostratigraphicBoundary, it can be associated with a geochronologic (i.e., time zone) boundary that may correlate with it.

 

ContactDescription context diagram.

Figure 53 — ContactDescription context diagram

8.5.4.1.1.  contactCharacter

The contactCharacter (SWE::Category) contains a term from a controlled vocabulary that describes the character of the boundary (e.g. abrupt, gradational), as opposed to its type.

8.5.4.1.2.  orientation

The orientation:GSML_PlanarOrientation property reports the general orientation of the contact surface.

8.5.4.1.3.  correlatesWith

The correlatesWith property is an association between ContactDescription and a GeochronologicBoundary describing a geochronologic (i.e., time zone) boundary that may correlate with it.  Therefore, a contact correlation with a GeochronologicBoundary SHALL ONLY be allowed when the contactType is a ChronostratigraphicBoundary.

Requirement 21

Identifier/req/gsml-extension/contact-chronoboundary
Included inRequirements class 5: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-extension
A

correlatesWith association to a GeochronologicBondary SHALL be allowed only when contactType = ChronostratigraphicBoundary.

8.5.4.2.  DisplacementEvent

A displacement event is a description of the age, environment and process of a shear displacement event.

 

DisplacementEvent context diagram

Figure 54 — DisplacementEvent context diagram

8.5.4.2.1.  incrementalDisplacement

The incrementalDisplacement:DisplacementValue property contains a DisplacementValue (8.5.4.4) reporting the parameters of the displacement.

8.5.4.3.  Layering

A planar foliation is defined by a tabular succession of layers > 5 mm thick. This definition is based on the proposed definition of gneiss by the NADM Science Language Technical Team [13].  The GeologicStructure characteristic of gneiss is layering.

 

Layering context diagram

Figure 55 — Layering context diagram

8.5.4.3.1.  layerComposition

The layerComposition property is an association between a Layering and a RockMaterial that describes the rock material that may define compositional layering.

8.5.4.3.2.  DisplacementValue

A displacement value expresses the displacement on a fault with respect to a planar approximation of its shape.

 

Displacement value subtypes context diagram.

Figure 56 — Displacement value subtypes context diagram

8.5.4.3.3.  hangingWallDirection

The property hangingWallDirection:GSML_LinearOrientation describes the direction of the hanging-wall side of the fault or fault-system where they are steep enough to define a hanging-wall on the map trace. 

8.5.4.3.4.  movementSense

The property movementSense:MovementSenseTerm contains a term from a controlled vocabulary that describes the movement sense of displacement along a geologic structure (e.g., dextral, sinistral).

8.5.4.3.5.  movementType

The property movementType:MovementTypeTerm contains a term from a controlled vocabulary that defines the type of movement on a shear displacement structure (e.g. dip-slip, strike-slip).

8.5.4.3.6.  displacementEvent

The property displacementEvent is an association between a Displacement and a GeologicEvent that contains a description of the age, environment and process of a shear displacement event.

8.5.4.4.  SeparationValue

SeparationValue is a kind of DisplacementValue that describes the amount of separation displacement across a structure.

8.5.4.4.1.  separation

The property separation:GSML_Vector reports the apparent offset across a planar feature, reported as a vector.

8.5.4.5.  NetSlipValue

NetSlipValue is a kind of DisplacementValue that describes the total amount of slip displacement along a structure.

8.5.4.5.1.  netSlip

The property netSlip:GSML_Vector reports the value of the net slip, expressed as a vector.

8.5.4.5.2.  slipComponent

The slipComponent:SlipComponents property associates the individual slip components with the net slip values.

8.5.4.6.  SlipComponents

SlipComponents is a kind of DisplacementValue that is a representation of slip as a vector resolved into components within a reference frame in which horizontal axes are parallel and perpendicular to the strike of the fault.  At least one of heave, horizontalSlip, or throw must not be null.

Requirement 22

Identifier/req/gsml-extension/slipComponents-slip
Included inRequirements class 5: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-extension
A

SlipComponents SHALL have at least one of heave, horizontalSlip or throw as a non-null value.

8.5.4.6.1.  heave

The property heave:GSML_Vector contains a component of slip in the horizontal, and perpendicular to the strike of the fault.

8.5.4.6.2.  horizontalSlip

The property horizontalSlip:GSML_Vector contains a slip component that is horizontal and parallel to strike of the fault.

8.5.4.6.3.  throw

The property throw:GSML_Vector contains the vertical component of slip.

8.5.4.7.  FoldDescription

FoldDescription is an extended descriptive property of a fold structure.

 

FoldDescription context diagram.

Figure 57 — FoldDescription context diagram.

8.5.4.7.1.  amplitude

The amplitude property (SWE::QuantityRange) reports the length from line segment connecting inflection points on adjacent fold limbs to the intervening fold hinge.

8.5.4.7.2.  axialSurfaceOrientation

The property axialSurfaceOrientation:GSML_PlanarOrientation is used to characterize the geometry of a fold. The axial surface of a particular fold may be located based on observations of the folded geologic structure, but in general it has no direct physical manifestations. As a geologic surface, it has geometric properties, including orientation, which may be specified by observations at one or more locations, or generalized using terminology (upright, inclined, reclined, recumbent, overturned). Dip and Dip Direction are one approach to specifying the value.

8.5.4.7.3.  geneticModel

The property geneticModel (SWE::Category) contains a term from a controlled vocabulary describing the specification of genetic model for fold, e.g. flexural slip, parallel.

8.5.4.7.4.  hingeLineCurvature

The hingeLineCurvature property (SWE::Category) contains a term from a controlled vocabulary that describes the variation in orientation of fold hinge along trend of fold, distinguishing sheath from cylindrical folds (e.g. sheath, dome, basin, cylindrical.).

8.5.4.7.5.  hingeLineOrientation

The property hingeLineOrientation:GSML_LinearOrientation reports the specification of the hinge line orientation for fold.  GSML_LinearOrientation allows for a term value specification or a numeric specification of either or both the trend and plunge of hinge line.  Hinge plunge term examples: sub-vertical, steeply plunging, sub-horizontal, reclined and vertical for special cases in which hinge plunge is close to axial surface dip. 0..* cardinality allows for both a numeric specification and a term specification.

8.5.4.7.6.  hingeShape

The property hingeShape (SWE::Category) reports a term from a controlled vocabulary describing the hinge shape, e.g. Rounded vs. angular hinge zones.  This property has to do with the proportion of the wavelength that is considered part of hinge.

8.5.4.7.7.  interLimbAngle

The property interLimbAngle (SWE::Category) contains a term from a controlled vocabulary describing the interlimb angle using a tightness term (e.g. gentle (120-180°), open (70-120°), close (30-70°), tight (10-30°), isoclinal (0-10°)).

8.5.4.7.8.  limbShape

The limbShape property (SWE::Category) contains a term from a controlled vocabulary describing the shape of the limb (e.g. straight vs curved limbs, kink, chevron, sinusoidal, box).

8.5.4.7.9.  span

The span property (SWE::QuantityRange) reports a value describing the linear distance between inflection points in a single fold.

8.5.4.7.10.  symmetry

The symmetry property (SWE::Category) contains a term from a controlled vocabulary describing the concordance or discordance of bisecting surface and axial surface, or the ratio of length of limbs. The folded surface may have asymmetry defined by limb length ratio if inflection points are defined. The definition based on bisecting surface/axial surface angle depends on having multiple surfaces defined such that the axial surface may be identified (symmetric, asymmetric).

8.5.4.7.11.  system

The system property is an association between a FoldDescription and a FoldSystem that aggregates folds into a system.

8.5.4.8.  FoldSystem

A FoldSystem is a collection of congruent folds (axis and axial surface are parallel) produced by the same tectonic event. It is sometimes referred to as a “fold train”.

 

FoldSystem context diagram.

Figure 58 — FoldSystem context diagram

8.5.4.8.1.  periodic

The property periodic:Primitive::Boolean reports TRUE if the hinges in a train are regularly spaced, and FALSE otherwise.

8.5.4.8.2.  wavelength

The property wavelength (SWE::QuantityRange) contains a quantitative description of the length between adjacent antiforms (or synforms) in a fold train.

8.5.4.8.3.  foldSystemMember

The foldSystemMember is an association between a FoldSystem and the Folds that are members of that system.

8.5.4.9.  FoliationDescription

FoliationDescription provides extended descriptive properties for a foliation structure.

 

FoliationDescription context diagram.

Figure 59 — FoliationDescription context diagram

8.5.4.9.1.  definingElement

The property definingElement (SWE::Category) contains a term from a controlled vocabulary describing the kinds of inhomogeneity in a rock body that may define a GeologicStructure.   Examples include discontinuity, shaped surface, oriented particle, material boundary, and layer.

8.5.4.9.2.  continuity

The continuity property (SWE::Category) reports a term from a controlled vocabulary to distinguish continuous vs. disjunct cleavages.

8.5.4.9.3.  intensity

The intensity property (SWE::Category) contains a term from a controlled vocabulary to describe how well the foliation is developed (e.g., weak, moderate, strong).

8.5.4.9.4.  mineralElement

The mineralElement property is an association between FoliationDescription and a Mineral that defines that foliation.

8.5.4.9.5.  orientation

The orientation:GSML_PlanarOrientation contains an estimate of the planar orientation of the foliation structure.

8.5.4.9.6.  spacing

The spacing property (SWE::QuantityRange) contains a linear dimension representing the thickness of foliation domains. It is also used for thickness of layers of a given composition.

8.5.4.10.  ShearDisplacementStructureDescription

ShearDisplacementStructureDescription provides extended descriptive properties of a shear displacement structure (i.e., fault or shear) defined in 8.4.3.5 by extending the abstract property block ShearDisplacementStructureAbstractDescription.

 

ShearDisplacementStructureDescription context diagram.

Figure 60 — ShearDisplacementStructureDescription context diagram

8.5.4.10.1.  deformationStyle

The deformationStyle:DeformationStyleTerm contains a term from a vocabulary to describe the style of deformation, i.e. brittle (fault, breccia), ductile (shear), brittle-ductile, unknown.

8.5.4.10.2.  planeOrientation

The property planeOrientation:GSML_PlanarOrientation contains a description of the orientation of a structure’s planar surface.

8.5.4.10.3.  stPhysicalProperty

The property stPhysicalProperty:PhysicalDescription contains a value of generic physical properties (8.5.2.11) not addressed in this specification.

8.5.5.  GeologicUnitDetails

The GeologicUnitDetails package provides for extended description of geologic unit features (8.4.1.3).

 

GeologicUnitDetails

Figure 61 — GeologicUnitDetails

8.5.5.1.  GeologicUnitDescription

GeologicUnitDescription provides for extended description of the characteristics of a geologic unit (8.4.1.3).

8.5.5.1.1.  bodyMorphology

The bodyMorphology property (SWE::Category) provides a term from a controlled vocabulary describing the geometry or form of a GeologicUnit.  Examples include: dike (dyke), cone, fan, sheet, etc. The morphology is independent of the substance (EarthMaterial) that composes the GeologicUnit or process that formed it.

8.5.5.1.2.  unitComposition

The unitComposition property (SWE::Category) provides a term from a composition-based classification that requires summarising the overall character of the unit.  It is not applicable at the rock material or specimen level. Examples are: alkalic, subaluminous, peraluminous, I-Type, carbonate, phosphate.

8.5.5.1.3.  outcropCharacter

The property outcropCharacter (SWE::Category) provides a term that describes the nature of outcrops formed by a geologic unit. Examples are: bouldery, cliff-forming, ledge-forming, slope-forming, poorly exposed.

8.5.5.1.4.  unitThickness

The property unitThickness (SWE::QuantityRange) provides a value that represents the typical thickness of the geologic unit. It is always reported as a range.

8.5.5.1.5.  bedding

The bedding:BeddingDescription property reports a description of the bedding (see 8.5.5.2).

8.5.5.2.  BeddingDescription

BeddingDescription provides a detailed description of the bedding characteristics of a geologic unit.

8.5.5.2.1.  beddingPattern

The property beddingPattern (SWE::Category) provides a term from a controlled vocabulary specifying patterns of bedding thickness or relationships between bedding packages. (e.g., thinning upward, thickening upward).

8.5.5.2.2.  beddingStyle

The property beddingStyle (SWE::Category) provides a term from a controlled vocabulary specifying the style of bedding in a stratified geologic unit (e.g. lenticular, irregular, planar, vague, and massive).

8.5.5.2.3.  beddingThickness

The property beddingThickness (SWE::Category) provides a term from a controlled vocabulary characterizing the thickness of bedding in the unit.

8.5.6.  GeoSciML Extension vocabularies

Vocabularies used in GeoSciML Extension are listed in Table 5  — GeoSciML Extension vocabularies.

Table 5 — GeoSciML Extension vocabularies

VocabularyDescription
GeologicRelationshipTermRefers to a vocabulary of terms describing a relationship between geologic features or objects.
RelationRoleTermRefers to a vocabulary of terms describing roles played by geologic features or objects in a geologic relationship.
AlterationTypeTermRefers 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, serpentinisation, weathering, etc.
ConstituentPartRoleTermRefers to a vocabulary of terms describing the role played by a constituent part of a compound material (e.g., matrix, phenocryst).
FabricTypeTermRefers to a vocabulary of terms describing the type of fabric present.
MineralNameTermRefers to a vocabulary of mineral names.
ParticleTypeTermRefers to a vocabulary of terms describing the type of particle in the compound earth material (e.g., bioclast, phenocryst, pyroclast).
PhysicalPropertyTermRefers to a vocabulary of physical property types (e.g., density, porosity, magnetic susceptibility, magnetic remanence, conductivity, etc.).
DeformationStyleTermA controlled vocabulary of terms describing the style of deformation (e.g., brittle, ductile).
LineationTypeTermRefers to a vocabulary of terms describing the type of lineation.  Examples include: flow lines, scratches, striae, slickenlines, linear arrangements of elongate components in sediments, elongate minerals, crinkles, and lines of intersection between penetrative planar structures.
MovementSenseTermRefers to a vocabulary of terms describing the sense of movement on a shear displacement structure.
MovementTypeTermRefers to a vocabulary of terms describing the type of movement (e.g., dip-slip, strike-slip).
NonDirectionalStructureTypeTermRefers to a vocabulary of terms describing types of non-directional structures (e.g., miarolitic cavity, flame structure, load cast, shatter cone, trace fossil, fossil mold, etc.).

8.6.  GeoSciML GeologicTime Requirements Class (Normative)

Requirements class 6: Requirements Class ‘GeoSciML GeologicTime’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-geologictime
Target typeEncoding
PrerequisitesISO 19108 Temporal Schema
SWE Common 2.0 08-094r1 Clause 7
ISO-19156 Observations and Measurements (Topic 20)
Normative statementRequirement 23: /req/gsml-timescale/start

The Geologic Time package, developed by Simon Cox (CSIRO) and Steve Richard (Arizona Geological Survey) [1], contains elements used to describe the classification of geologic time: time periods, time boundaries, and the relationships between them as defined by the IUGS International Commission on Stratigraphy (ICS — http://www.stratigraphy.org/).

 

GeologicTime dependencies.

Figure 62 — GeologicTime dependencies

 

Geologic Time summary diagram.

Figure 63 — Geologic Time summary diagram

8.6.1.  Global Boundary Stratotype Sections and Points (GSSP)

The GSSP model describes “Global Boundary Stratotype Sections and Points” as defined by the IUGS International Commission on Stratigraphy.

 

Global Boundary Stratotype Sections and Points.

Figure 64 — Global Boundary Stratotype Sections and Points

8.6.1.1.  StratigraphicPoint

A point in the stratigraphic record used to define a geochronologic boundary or point in geologic time.

 

Stratigraphic points context diagram

Figure 65 — Stratigraphic points context diagram

8.6.1.1.1.  primaryGuidingCriterion

The property primaryGuidingCriterion:Primitive::CharacterString contains a description of the primary criterion used to establish the stratigraphic point.

8.6.1.1.2.  additionalCorrelationProperty

The property additionnalCorrelationProperty:Primitive::CharacterString contains any additional criteria used to establish the stratigraphic point.

8.6.1.1.3.  status

The property status:Primitive::CharacterString contains a description of the status of stratigraphic point (e.g., formally accepted, etc.).

8.6.1.2.  GlobalStratotypePoint

A type of stratigraphic point used to define a globally agreed point in geologic time.  This class does not have any properties beyond those inherited from StratigraphicPoint.

8.6.1.3.  StratigraphicSection

A sampled section of the stratigraphic record used to define a period in geologic time.

 

Stratigraphic sections context diagram.

Figure 66 — Stratigraphic sections context diagram

8.6.1.3.1.  geologicSetting

The property geologicSetting:Primitive::CharacterString contains a description of the geologic setting of the stratigraphic section.

8.6.1.3.2.  geologicDescription

The geologicDescription:Primitive::CharacterString contains a description of the geology of the stratigraphic section (e.g., lithology, paleontology, paleogeography, etc.).

8.6.1.3.3.  accessibility

The property accessibility:Primitive::CharacterString contains a description of the ability to access the stratigraphic section.

8.6.1.3.4.  conservation

The property conservation:Primitive::CharacterString contains a description of measures to conserve the stratigraphic section.

8.6.2.  TemporalReferenceSystem

This package is an extension of ISO19108 Temporal Schema and describes geologic eras and the relationships between them.

 

Temporal Reference System summary diagram.

Figure 67 — Temporal Reference System summary diagram

8.6.2.1.  TimeOrdinalReferenceSystem

TimeOrdinalReferenceSystem is a time reference system comprised of an ordered set of time periods (time ordinal eras).

8.6.2.1.1.  referencePoint

The property referencePoint is an association between a TimeOrdinalReferenceSystem and a TimeOrdinalEraBoundary.  A TimeOrdinalReferenceSystem refers to two reference points defining the extent of the system.

8.6.2.1.2.  component

The property component is an association to a TimeOrdinalEra that is part of the TimeOrdinalReferenceSystem.  A TimeOrdinalReferenceSystem is composed of a collection of TimeOrdinalEras.

8.6.2.2.  TimeOrdinalEra

TimeOrdinalEra is a period of time between two time boundaries.  The association of an era with a stratotype is optional.  In the GSSP approach recommended by ICS for the Global Geologic Timescale, Unit Stratotypes are not used.  Rather, the association of an era with geologic units and sections is indirect, via the association of an era with boundaries, which are in turn tied to stratotype points, which occur within host stratotype sections.  TimeOrdinalEra can be composed of other eras and organized into an arbitrarily nested tree.

8.6.2.2.1.  member

The property member is an association between a TimeOrdinalEra and another TimeOrdinalEra which is hierarchically below.  The referred TimeOrdinalEras are subdivision the current TimeOrdinalEra. Note that nesting shall not be cyclic.  A TimeOrdinalEra can’t be a member of itself or any intermediate member (we can consider that member is a transitive property). This is not a model issue but a data coherence issue.

8.6.2.2.2.  group

The group property is an association to a (single) parent TimeOrdinalEra. The group associations shall not produce a cyclic graph.  A TimeOrdinalEra group shall point to its immediate parent TimeOrdinalEra.   

By convention, the “start” of the TimeOrdinalEra is the oldest boundary because it is when the era “started” to exist in time.  The “end” is therefore the youngest boundary.

8.6.2.2.3.  start

The start property is an association to a TimeOrdinalEraBoundary that defines the start (the oldest) boundary of the era.

Requirement 23

Identifier/req/gsml-timescale/start
Included inRequirements class 6: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-geologictime
A

The start TimeOrdinalEraBoundary SHALL refer to the oldest boundary

8.6.2.2.4.  end

The end property is an association to a TimeOrdinalEraBoundary that defines the end (the youngest) boundary of the era.

8.6.2.3.  TimeOrdinalEraBoundary

A TimeOrdinalEraBoundary is a point in Earth’s history which bounds a TimeOrdinalEra.

8.6.2.3.1.  position

The position:TM_Instant property describes a point in time corresponding to the era boundary.

8.6.2.3.2.  positionalUncertainty

The property positionalUncertainty (SWE::Quantity) contains a measure of the uncertainty in the estimate of the point in time of the era boundary.

8.6.2.3.3.  previousEra

The property previousEra is an association between a TimeOrdinalEraBoundary and a TimeOrdinalEra to reference the preceding (oldest) era.

8.6.2.3.4.  nextEra

The property nextEra is an association between a TimeOrdinalEraBoundary and a TimeOrdinalEra to reference the succeeding era.

8.6.2.3.5.  observationalBasis

The property observationalBasis is be an association between a TimeOrdinalEraBoundary and an OM::OM_Observation in support of the existence of the boundary defined by geochronology, paleontology, or other evidence.

8.6.3.  Timescale

The Timescale package describes geologic time periods (geochronologic eras) and the boundaries between them.

 

Time scale summary diagram.

Figure 68 — Time scale summary diagram

8.6.3.1.  GeologicTimeScale

The classic “Geologic Timescale” (link:http://www.stratigraphy.org/index.php/ics-chart-timescalehttp://www.stratigraphy.org/index.php/ics-chart-timescale]) comprising an ordered, hierarchical set of named “eras” is an example of an Ordinal Temporal Reference System. It may be calibrated with reference to a numeric Temporal Coordinate System, but is, in principle, defined independently.

8.6.3.2.  GeochronologicEra

A GeochronologicEra is a period of time between two GeochronologicBoundaries. The association of a GeochronologicEra with a stratotype is optional.  In the GSSP approach recommended by ICS for the Global Geologic Timescale, Unit Stratotypes are not used.  Rather, the association of an era with geologic units and sections is indirect, via the association of an era with boundaries, which are in turn tied to stratotype points, which occur within host stratotype sections.

 

GeochronologicEra context diagram.

Figure 69 — GeochronologicEra context diagram

8.6.3.2.1.  rank

The property rank:GeochronologicEraRank contains a term from a vocabulary describing the rank of the time period (e.g., eon, era, period, stage).

8.6.3.2.2.  stratotype

The property stratotype is an association between a GeochronologicEra and StratigraphicSection that describes a type section that names the physical location or outcrop of a particular reference exposure of a stratigraphic sequence or stratigraphic boundary. A unit stratotype is the agreed reference point for a particular stratigraphic unit and a boundary stratotype is the reference for a particular boundary between strata (Wikipedia).

8.6.3.3.  GeochronologicBoundary

A GeochronologicBoundary is a boundary between two geochronologic time periods.

 

GeochronologicBoundary context diagram.

Figure 70 — GeochronologicBoundary context diagram

8.6.3.3.1.  stratotype

The property stratotype is an association between a GeochronologicBoundary and a StratigraphicPoint that are associated with the boundary. A GeochronologicBoundary can be associated with more than one StratigraphicPoints, but only one may have GSSP ratified status. The others are proposed equivalents.

Example:

 

Partial encoding of Miocene instance diagram.

Figure 71 — Partial encoding of Miocene instance diagram

8.6.3.4.  NumericEraBoundary

NumericEraBoundary is used for pre-Ediacaran and Pleistocene / Holocene boundaries in the standard timescale where boundaries are not defined by a material reference but as numerical values.

 

NumericEraBoundary context diagram.

Figure 72 — NumericEraBoundary context diagram

8.6.3.5.  StandardGlobalNumericalAge

A standard numeric age point (a numeric analogue to a ‘golden spike’) is applicable to the formal subdivision of the Precambrian, and perhaps the Pleistocene/Holocene boundary ([23]; link:http://www.stratigraphy.org/index.php/ics-chart-timescalehttp://www.stratigraphy.org/index.php/ics-chart-timescale]).  The boundary is not defined from a physical stratotype, although it can be influence by some, but placed at a convenient numerical value.

8.6.4.  GeoSciML GeologicTime vocabularies

The GeologicTime package has only one vocabulary (Table 6).

Table 6 — Geologic time vocabulary

VocabularyDescription
GeochronologicEraRank

This list is an indicative list only of terms used to describe the rank of time periods defined by the International Commission on Stratigraphy.  Users are encouraged to use vocabulary of terms owned by the ICS or CGI vocabularies working group and managed outside of this model.

For example:

  • eon

  • era

  • period

  • epoch

  • age

8.7.  GeoSciML Borehole Requirements Class (Normative)

Requirements class 7: Requirements Class ‘GeoSciML Borehole’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
Target typeEncoding
Prerequisites/req/gsml-core
ISO 19103 Conceptual Model Language
ISO 19107 Spatial Schema
ISO-19156 Observations and Measurements (OGC Topic 20)
SWE Common 2.0 08-094r1 Clause 7
ISO 19108 Temporal Schema
ISO 19115-3 Citation
Normative statementsRequirement 24: /req/gsml-borehole/value-intervalBegin
Requirement 25: /req/gsml-borehole/drill-interval-1D
Requirement 26: /req/gsml-borehole/drill-interval-1D-CRS
Requirement 27: /req/gsml-borehole/value-mappedIntervalBegin
Requirement 28: /req/gsml-borehole/interval-1D
Requirement 29: /req/gsml-borehole/interval-1D-CRS
Requirement 31: /req/gsml-borehole/borehole-3d
Requirement 32: /req/gsml-borehole/borehole-elevation-dim
Requirement 33: /req/gsml-borehole/borehole-elevation-CRS

The GeoSciML Borehole package contains an information model for boreholes and related artefacts. This is primarily through re-use of standard components from the Observations and Measurements (ISO19156).

 

Borehole dependency diagram.

Figure 73 — Borehole dependency diagram

 

Borehole summary diagram.

Figure 74 — Borehole summary diagram

8.7.1.  Borehole

This requirements class describes Borehole and BoreholeInterval and related data types.  This package describes a borehole as a means to sample geologic units underground and thus provide a linear map of the geology.

 

Borehole context diagram.

Figure 75 — Borehole context diagram

8.7.1.1.  Borehole

A Borehole is the generalized term for any narrow shaft drilled in the ground, either vertically, horizontally, or inclined.

8.7.1.1.1.  indexData

The property indexData:BoreholeDetails describes metadata about a borehole, such as the operator, the custodian, dates of drilling, etc.

8.7.1.1.2.  downholeDrillingDetails

The property downholeDrillingDetails:DrillingDetails specifies the drilling method and borehole diameter for intervals down the borehole.

8.7.1.1.3.  logElement

The property logElement is an association between a Borehole and a BoreholeInterval instance to describe measured downhole intervals and their observed features.

8.7.1.1.4.  referenceLocation

The property referenceLocation is an association between a Borehole and an OriginPosition corresponding to the start point of a borehole log.  This may correspond to the borehole collar location (e.g., kelly bush).

8.7.1.1.5.  OM:sampledFeature

Borehole inherits sampledFeature from OM::SF_SamplingFeature, which links the sampling feature to the real world feature it is designed to sample (19156:2011, clause 9.2.2.4). In the context of GeoSciML, this will typically be a GeologicFeature, such as a geologic unit. Where a SamplingFeature samples multiple features (e.g. borehole, traverse)

  • if it is a sequence of units, then the part:GeologicUnitPart mechanisms may be used,

  • else if it is an informal collection that exists only because of the sampling, then multiple sampledFeature roles should be used

8.7.1.2.  DrillingDetails

DrillingDetails is a class that captures the description of drilling methods and hole diameters down the drilling path.  Properties that apply to the Borehole as a whole are managed in BoreholeDetails (8.7.1.4).

 

Drilling details

Figure 76 — Drilling details

8.7.1.2.1.  drillingMethod

The drillingMethod:BoreholeDrillingMethodCode property contains a term from a controlled vocabulary indicating the drilling method used. Appropriate terms would include rotary air blast, auger, diamond core, air core, etc.

8.7.1.2.2.  boreholeDiameter

The boreholeDiameter property (SWE::Quantity) contains a measurement (a value and a unit of measure) corresponding to the diameter of the drilled hole.

8.7.1.2.3.  intervalBegin

The intervalBegin property (SWE::Quantity) contains a measurement (a value and a unit of measurement) that corresponds to the measured distance of the start of the interval along the path of the borehole. The measured value must be less than or equal to the intervalEnd value.

Requirement 24

Identifier/req/gsml-borehole/value-intervalBegin
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

The value of intervalBegin SHALL be less or equal to the value of intervalEnd.

8.7.1.2.4.  intervalEnd

The property intervalEnd (SWE::Quantity) contains a measurement (a value and a unit of measurement) of the measured distance of the end of the interval along the path of the borehole. The measured value must be greater than or equal to the intervalBegin value.

8.7.1.2.5.  interval

The property interval:GM_Object is a shape that is a 1-D interval (e.g., a “from” and “to”, or “top” and “base” measurements) that is equivalent (represents the same distance) as the one represented by intervalBegin and intervalEnd.  The geometry shall use a reference to the borehole geometry as its CRS.

Requirement 25

Identifier/req/gsml-borehole/drill-interval-1D
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

Interval SHALL be encoded with GM_LineString with two 1D points.

 

Requirement 26

Identifier/req/gsml-borehole/drill-interval-1D-CRS
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

Coordinate Reference System shall be a reference to the borehole geometry.

Encoding of the drilled interval using GEO::GM_LineString shall consist of two 1D points only (the start and end point of the interval, measured as distance from the borehole collar), with a 1-D CRS referencing the borehole shape.

8.7.1.3.  BoreholeInterval

A BoreholeInterval is similar to a MappedFeature (8.4.1.2) whose shape is 1-D interval and uses the SRS of the containing borehole.  The “mappedIntervalBegin” and “mappedIntervalEnd” properties are alternative to the 1D geometry to overcome problems with the delivery and ease of queryability of 1D GML shapes.

 

Borehole interval context diagram.

Figure 77 — Borehole interval context diagram

8.7.1.3.1.  observationMethod

The observationMethod property (SWE::Category) contains a term from a controlled vocabulary that describes the method used to observe the properties of the borehole.

8.7.1.3.2.  specification

The specification property is an association between a BoreholeInterval and a GFI_Feature, a domain feature that is sampled by the interval (e.g., a GeologicUnit). It is semantically equivalent to O&M ISO19156 “sampledFeature”.

8.7.1.3.3.  mappedIntervalBegin

The property mappedIntervalBegin (SWE::Quantity) is a measurement (a value and a unit of measurement) corresponding to the measured distance of the start of the mapped interval along the path of the borehole. The measured value must be less than or equal to the mappedIntervalEnd value.

Requirement 27

Identifier/req/gsml-borehole/value-mappedIntervalBegin
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

The value of mappedIntervalBegin SHALL be less or equal to the value of mappedIntervalEnd.

8.7.1.3.4.  mappedIntervalEnd

The mappedIntervalEnd property (SWE::Quantity) is a measurement (a value and a unit of measure) corresponding to the measured distance of the end of the mapped interval along the path of the borehole. The measured value must be greater than or equal to the mappedIntervalBegin value.

8.7.1.3.5.  collectionIdentifier

The collectionIdentifier:ScopedName is a string unique within a scope that identifies a collection which forms a set BoreholeIntervals. This allows description of multiple downhole logs for a single borehole. The name should identify a particular log observation event.

8.7.1.3.6.  parentBorehole

The property parentBorehole is an association between a BoreholeInterval and a Borehole to which the interval belongs.

8.7.1.3.7.  shape

The property shape:GM_Object is a 1-D interval (e.g., a “from” and “to”, or “top” and “base” measurement) covering the same distance as mappedIntervalBegin and mappedIntervalEnd.  The geometry shall use a reference to the borehole as the CRS of the containing borehole.

Encoding of an interval within the borehole using GEO::GM_LineString shall consist of two 1D points only (the start and end point of the interval, measured as distance from the borehole collar), with CRS corresponding to the borehole shape.

Requirement 28

Identifier/req/gsml-borehole/interval-1D
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

Interval SHALL be encoded with GM_LineString with two 1D points.

Requirement 29

Identifier/req/gsml-borehole/interval-1D-CRS
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

Coordinate Reference System of interval geometries SHALL use the borehole geometry.

Instance example for Klčovo and Lastomir Formation adapted from Túnyi [18]:

 

Figure 78 — Top part of Figure 2 from Túnyi [18]

Figure 79 shows an encoding of the first lithostratigraphic and magnetostratigraphic units from Figure 78 showing how the collection identifiers group BoreholeIntervals into two groups.

 

Figure 79 — Encoding of a borehole with two distinct logs (collectionIdentifier).

8.7.1.4.  BoreholeDetails

BoreholeDetails describes borehole-specific index data, often termed “header information”. It contains metadata about the parties involved in the drilling, the storage of drilled material and other information relevant to the borehole as a whole.  Properties that may vary along the borehole path are managed in DrillingDetails (8.7.1.2).

 

Borehole details context diagram.

Figure 80 — Borehole details context diagram

8.7.1.4.1.  operator

The operator property is an association between a BoreholeDetails and a CIT:CI_ResponsibleParty describing the organisation responsible for commissioning the borehole (as opposed to actually drilling the borehole).

8.7.1.4.2.  driller

The driller property is an association between a BoreholeDetails and a CIT:CI_ResponsibleParty describing of the organisation responsible for drilling the borehole (as opposed to commissioning the borehole).

8.7.1.4.3.  dateOfDrilling

The property dateOfDrilling:TM_Period describes the time period during which drilling of the borehole occurred.

8.7.1.4.4.  startPoint

The property startPoint:BoreholeStartPointCode provides a term from a controlled vocabulary indicating the named position relative to ground surface where the borehole commenced. (e.g., natural ground surface, open pit floor, underground, offshore)

8.7.1.4.5.  inclinationType

The property inclinationType:BoreholeInclinationCode contains a term from a controlled vocabulary indicating the inclination type of the borehole. Appropriate terms would include vertical; inclined up; inclined down, horizontal.

8.7.1.4.6.  boreholeMaterialCustodian

The property boreholeMaterialCustodian is an association between BoreholeDetails and a CIT:CI_ResponsibleParty describing the organisation that is custodian of the drilled material recovered from the borehole.

8.7.1.4.7.  purpose

The property purpose:BoreholePurposeCode contains a term from a controlled vocabulary describing the purpose for which the borehole was drilled. e.g., site investigation, mineral exploration, hydrocarbon exploration, water resources.

8.7.1.4.8.  dataCustodian

The dataCustodian is an association between a BoreholeDetails and a CIT:CI_ResponsibleParty describing the custodian (person or organisation) that is the custodian of data pertaining to this borehole.

8.7.1.4.9.  boreholeLength

The property boreholeLength (SWE::Quantity) contains a measurement (a value and a unit of measurement) corresponding to the “length” of a borehole determined by the data provider (i.e., “length” can have different sources, like drillers measurement, loggers measurement, survey measurement, etc.).

8.7.1.5.  OriginPosition

A borehole OriginPosition is a feature corresponding to the start point of a borehole log.  This may correspond to the borehole collar location (e.g., kelly bush).

 

Origin position context diagram.

Figure 81 — Origin position context diagram

If a text description of the location is available, it should be reported in the description property, inherited from GM:GFI_Feature. 

8.7.1.5.1.  location

The property location contains a geometry corresponding to the location of the borehole collar.

If no GEO::GM_Point is available, an OGC nil value shall be used.

Requirement 30

Identifier/req/gsml-borehole/borehole-position-null
A

If no GM_Point is available, an OGC nil value SHALL be used.

In situations where the origin position changes over the life of the borehole (e.g., due to subsidence or destruction of the original collar), the origin position should be updated to the new location.

8.7.1.5.2.  elevation

Implementers delivering 3-D origin locations should provide an elevation to improve interoperability.

Requirement 31

Identifier/req/gsml-borehole/borehole-3d
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

Implementers delivering 3-D origin locations SHOULD provide an elevation.

The elevation:DirectPosition property is a compromise approach to supply elevation explicitly for location; this is to allow for software that cannot process 3-D GM_Point. Null shall be used if elevation is unknown. A DirectPosition shall have a dimension of 1, and CRS will be a “vertical” CRS (e.g. EPSG CRSs in the range 5600-5799).

Requirement 32

Identifier/req/gsml-borehole/borehole-elevation-dim
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

Origin elevation SHALL be a geometry with a dimension of 1.

Requirement 33

Identifier/req/gsml-borehole/borehole-elevation-CRS
Included inRequirements class 7: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-borehole
A

Origin elevation srsName identifier SHALL be a vertical CRS having a EPSG in the range 5600-5799

8.7.2.  GeoSciML Borehole vocabularies

Vocabularies used in Borehole package are listed in Table 7.

Table 7 — GeoSciML Borehole vocabularies

VocabularyDescription
BoreholeDrillingMethodCodeThis class is an indicative placeholder only for a vocabulary of terms describing the borehole drilling method.  Users are encouraged to use a vocabulary of terms managed by the CGI vocabularies working group. (e.g., auger, hand auger, air core, cable tool, diamond core, rotary air blast, etc.).
BoreholeInclinationCode

This class is an indicative placeholder only for a vocabulary of terms describing the general orientation of a borehole.  Users are encouraged to use a vocabulary of terms managed by the CGI vocabularies working group.

For example:

  • vertical

  • horizontal

  • inclined up

  • inclined down

BoreholePurposeCodePlace holder for a vocabulary containing terms describing the purpose for which the borehole was drilled.  e.g., mineral exploration, water pumping, site evaluation, stratigraphic research, etc.
BoreholeStartPointCode

This class is an indicative placeholder only for a vocabulary of terms describing the location of the start of a borehole.  Users are encouraged to use a vocabulary of terms managed by the CGI vocabularies working group.

Examples may include:

  • natural ground surface — drilling started from a natural topographic surface

  • open pit floor or wall — drilling started from the wall of an open pit or quarry

  • underground — drilling started from an underground location, such as a driveway, chamber or open-stope

  • from pre-existing hole — new drill hole spudded off the wall of an existing hole

8.8.  GeoSciML LaboratoryAnalysis-Specimen Requirements Class (Normative)

Requirements class 8: Requirements Class ‘GeoSciML LaboratoryAnalysis-Specimen’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lab-analysis
Target typeEncoding
PrerequisitesISO 19103 Conceptual Model Language
ISO 19107 Spatial Schema
ISO-19156 Observations and Measurements (OGC Topic 20)
SWE Common 2.0 08-094r1 Clause 7
ISO 19108 Temporal Schema
ISO 19115-3 Citation
Normative statementsRecommendation 1: /rec/gsml-lab-analysis/image-url
Recommendation 2: /rec/gsml-lab-analysis/image-process
Recommendation 3: /rec/gsml-lab-analysis/outcrop-pattern
Requirement 34: /req/gsml-lab-analysis/sampledFeature
Requirement 35: /req/gsml-lab-analysis/accuracy-measure
Requirement 36: /req/gsml-lab-analysis/accuracy-vocabulary

The LaboratoryAnalysis-Specimen application model extends the ISO19156 model for Observations, Measurements and Sampling.  It specifically describes processes and results related to the analysis of (geological) samples using instruments, commonly in a laboratory environment. The design of this package is also informed by the MOLES v3 data model [21]. 

 

LaboratoryAnalysis and Specimen dependencies.

Figure 82 — LaboratoryAnalysis and Specimen dependencies

8.8.1.  LaboratoryAnalysis

The LaboratoryAnalysis leaf package describes processes, instruments and result quality associated with quantitative analysis of samples.  It is an application of ISO19156 Observations and Measurements with supplemental requirements over some of O&M classes.

8.8.1.1.  SF_SamplingFeature::sampledFeature

The “sampledFeature” association links the OM::SF_SamplingFeature to the feature which the sampling feature was designed to sample. The target of this association shall not be a sampling feature. It is shall a real-world feature from an application domain.

Requirement 34

Identifier/req/gsml-lab-analysis/sampledFeature
Included inRequirements class 8: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lab-analysis
A

OM::SF_SamplingFeature::sampledFeature SHALL not be an instance of OM::SF_SamplingFeature.

8.8.1.2.  OM_Observation::resultQuality

OM::OM_Observation::resultQuality::DQ_QuantitativeAttributeAccuracy attribute shall be used to represent analytical errors and detection limits for each analytical measurement.

At least “nameOfMeasure” and “result” shall be used when delivering om:resultQuality. 

 

DQ++_++Element from ISO19115:2003.

Figure 83 — DQ_Element from ISO19115:2003

Requirement 35

Identifier/req/gsml-lab-analysis/accuracy-measure
Included inRequirements class 8: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lab-analysis
A

For analytical error and detection limits, both DQ_QuantitativeAttributeAccuracy::nameOfMeasure and DQ_QuantitativeAttributeAccuracy::result SHALL NOT be null.

The CharacterString in “nameOfMeasure” should be a term from a controlled vocabulary.

Requirement 36

Identifier/req/gsml-lab-analysis/accuracy-vocabulary
Included inRequirements class 8: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lab-analysis
A

The value of DQ_Element:nameOfMeasure SHOULD be a term from a controlled vocabulary.

8.8.1.3.  OM_Observation::parameter

Analytical methods are very varied and a single model cannot capture all the intricacies of all methods used in geoscience.  Communities that need to report specific parameters that are not covered by this specification can use NamedParameter.

 

Laboratory analysis summary diagram.

Figure 84 — Laboratory analysis summary diagram

8.8.1.4.  AnalyticalInstrument

The analytical instrument is the category of instrument used to perform an analytical measurement or observation.

 

Analytical instrument context diagram.

Figure 85 — Analytical instrument context diagram

8.8.1.4.1.  type

The property type:InstrumentTypeTerm reports a term from a controlled vocabulary that describes the category of instrument used in an analytical session (e.g., XRF, ICPMS, SHRIMP, etc.).

8.8.1.4.2.  model

The property mode:Primitive::CharacterString contains a string identifying the model of instrument used. (e.g., instrument type = XRD, model = Siemens Diffraktometer D500).

8.8.1.4.3.  serialNumber

The property serialNumber:Primitive::CharacterString contains a string that contains the serial number of the machine used in an analytical session.

8.8.1.4.4.  commissionDate

The property commissionDate is an association between an AnalyticalInstrument and a TM_Instant corresponding to the date of the commissioning of an instrument.

8.8.1.4.5.  location

The property location is an association between an AnalyticalInstrument and a CIT:Responsibility describing the owner and the location of an instrument.

8.8.1.4.6.  usedIn

The property usedIn is an association between an AnalyticalInstrument and an AnalyticalSession identifying an analytical sessions which used this instrument.

8.8.1.5.  AnalyticalSession

This feature type describes the time and operator of a particular laboratory analytical session. AnalyticalSession also has associated links to the type of instrument and analytical method used, processing steps applied to data collected during a session, and instrument parameters unique to that session.

 

Analytical session context diagram.

Figure 86 — Analytical session context diagram

8.8.1.5.1.  time

The property time is an association between an AnalyticalSession and a TM_Period describing the time period during which the analysis was performed.

8.8.1.5.2.  operator

The property operator is an association between an AnalyticalSession and a CIT:CI_Responsability describing the operator or organisation responsible for the analytical session.

8.8.1.5.3.  parameter

The property parameter (OM::NamedValue) contains a name/value pair to describe arbitrary environmental or instrument setting parameters that apply to an entire analytical session (e.g., voltage, current, temperature, vacuum). The “name” attribute of NamedValue is a term from a controlled vocabulary.

8.8.1.5.4.  instrument

The property instrument is an association between an AnalyticalSession and an AnalyticalInstrument that describes the instrument used in the analytical session.

8.8.1.5.5.  referenceAnalysis

The property referenceAnalysis is an association between an AnalyticalSession and a ReferenceSpecimen that describes a reference specimen (i.e., standards, blanks) used in the analytical session.

8.8.1.6.  AnalyticalProcess

An analytical process is a concrete implementation of OM::OM_Process and describes the steps and methods used in an analytical session.  It links to an analytical session (data acquisition) or a computational process which produce analytical results.

 

Analytical process

Figure 87 — Analytical process

8.8.1.6.1.  method

The property method is an association that links an AnalyticalProcess to an AnalyticalMethod that describes the type of analytical method used to make an observation.

8.8.1.6.2.  acquisition

The property acquisition is an association that links an AnalyticalProcess to an AnalyticalSession that describes the analytical session (e.g., laboratory session) in which an observation was made and data acquired.

8.8.1.6.3.  computation

The computation property is an association between an AnalyticalProcess and a CIT:ProcessStep that describes the computational process associated with the process.

8.8.1.7.  AnalyticalMethod

The AnalyticalMethod provides the name, and published citation, of the analytical method used in an analytical session.

 

Analytical method

Figure 88 — Analytical method

8.8.1.7.1.  methodName

The property methodName:AnalyticalMethodTerm contains a term from a controlled vocabulary that describes an analytical method used in a session (e.g., XRF mass spectrometry, ICPMS, SHRIMP geochronology).

8.8.1.7.2.  citation

The citation property is an association between an AnalyticalMethod and a CIT:CI_Citation describing a published description of a particular analytical method (e.g., a standard operating procedure document).

8.8.1.8.  Image

The Image feature type is used to describe images of sampling features, for example, photographs of ion microprobe grain mounts.

 

Image

Figure 89 — Image

When the image is available online, the identifier of the image, a HTTP URI, should point to one or more representation of that image.

Recommendation 1

Identifier/rec/gsml-lab-analysis/image-url
Included inRequirements class 8: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lab-analysis
A

The identifier of the image should be a HTTP URI referring to a representation of the image.

The samplingMethod (inherited from OM::SF_SamplingFeature) value for an image should be an identifier for a camera.

Recommendation 2

Identifier/rec/gsml-lab-analysis/image-process
Included inRequirements class 8: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lab-analysis
A

The image om:procedure SHOULD make reference to a camera.

8.8.2.  Geochronology

The Geochronology model allows the delivery of geochronological interpretations by describing:

  1. a OM::SF_Specimen (e.g., a rock sample)

  2. a related collection of sampling features within that specimen (e.g., ion probe burn spots, mineral separates),

  3. and a GeochronologicInterpretation related to that sampling collection.

Each member of the sampling collection has a related OM_Observation/result(s).

 

Summary diagram of geochronology.

Figure 90 — Summary diagram of geochronology

8.8.2.1.  GeochronologicInterpretation

A GeochronologicInterpretation is an interpretation made by a geologist of the age of a specimen made by statistical analysis of a collection of observations.  A geologic specimen may have multiple geochronological interpretations made on it, each related to a different observation/result collection.

 

Geochronologic interpretation context diagram.

Figure 91 — Geochronologic interpretation context diagram

8.8.2.1.1.  interpretedAge

The interpretedAge property is an association between a GeochronologicInterpretation and a GeologicEvent that describes the dated event, process and environment.

For example:

  • Event age = 350 Ma +/- 3 Ma.

  • Event process = intrusion, extrusion, metamorphism, etc.

  • Event environment = plutonic, subaerial, marine, etc.

8.8.2.1.2.  isotopicEvent

The isotopicEvent:IsotopicEventType contains a term from a controlled vocabulary that describes any isotopic events that are relevant to the interpretation. e.g., closure, isotopic mixing, Pb loss, etc.

8.8.2.1.3.  isotopicSystem

The property isotopicSystem:IsotopicSystemName contains a term from a controlled vocabulary that describes the isotopic system used to calculate geochronological age. A vocabulary would contain values such as: Ar-Ar, K-Ar, Nd-Sm, Pb-Pb, Rb-Sr, Re-Os, U-Pb, etc.

8.8.2.1.4.  statisticalMethod

The property statisticalMethod:StatisticalMethodTerm contains a term from a controlled vocabulary that describes the statistical method used to interpret the results.  (e.g., weighted mean, median, concordia, discordia, etc)

8.8.2.1.5.  interpretedBy

The property interpretedBy is an association between a GeochronologicInterpretation and a CIT:CI_Responsability describing the party responsible for this interpretation.

8.8.2.1.6.  citation

The citation property is an association between a GeochronologicInterpretation and a CIT:CI_Citation that describes authors and other reference information for an interpreted age.

8.8.2.1.7.  preferredInterpretation

The property preferredInterpretation:Primitive::Boolean indicates whether this interpretation is the preferred interpretation (i.e., the analytical data may be reinterpreted).

8.8.2.1.8.  sourceCollection

The property sourceCollection is an association between a GeochronologicInterpretation and an OM::SF_SamplingFeatureCollection that lists a collection of OM::SF_SamplingFeature (e.g., a collection of burn spots or craters from a SHRIMP analytical session).  When legacy published data for which the SamplingFeatureCollection is unknown, it may be delivered with SamplingFeatureCollection = ‘unknown’.

8.8.3.  GeologicSpecimen

The GeologicSpecimen package extends the ISO19156 O&M model, and describes processes relevant to the sampling, preparation, and analysis of geologic specimens.

 

Geologic specimen summary diagram.

Figure 92 — Geologic specimen summary diagram

8.8.3.1.  ReferenceSpecimen

A reference specimen is a specimen with known or accepted values of some property.  The citation property describes the location of a published description of these values.  Reference specimens include analytical blanks.  ReferenceSpecimens are used in quality control procedures to assess method reproducibility.

Analytical results from a reference specimen analysed during an AnalyticalSession are delivered in the same way as the results of other specimens analysed in that session.

 

Reference specimen context diagram.

Figure 93 — Reference specimen context diagram

8.8.3.1.1.  referenceDescription

The property referenceDescription is an association between a ReferenceSpecimen and a CIT:CI_Citation that references a citation of published analytical results for this standard reference specimen.

8.8.3.1.2.  usedIn

The property usedIn is an association between a ReferenceSpecimen and an AnalyticalSession in which the reference specimen was used.

8.8.3.2.  GeologicSpecimenPreparation

GeologicSpecimenPreparation is an extension of ISO Specimen::preparationStep to allow details of preparation steps to be delivered (e.g., filtration and mesh size, chemical additives, crushing methods, drying parameters, etc.).

 

Geologic specimen preparation context diagram.

Figure 94 — Geologic specimen preparation context diagram

8.8.3.2.1.  preparationMethod

The preparationMethod:GeologicSpecimenPreparationTerm contains a term from a controlled vocabulary that describes the method employed for the preparation of a geologic specimen for further analysis.

8.8.3.2.2.  parameter

The property parameter (OM::NamedValue) contains name/value pair to describe arbitrary parameters used in this preparation step (e.g., mesh size in a sieving process, type of chemical additives, parameters in a mineral separation process). The “name” attribute of NamedValue shall be a term from a controlled vocabulary.

8.8.3.3.  GeologicSamplingMethod

GeologicSamplingMethod is an implementation of OM::SF_Process to describe the method used to obtain a geologic specimen.

Examples include:

  • diamond drilling

  • percussion drilling

  • piston core drilling

  • vibro core drilling

  • channel sampling

  • sea floor dredging

  • outcrop sampling

 

Geologic sampling method

Figure 95 — Geologic sampling method

8.8.3.3.1.  method

The property method:GeologicSamplingMethodTerm is a term from a controlled vocabulary that describes the process used to obtain or create a geologic specimen. e.g., diamond drilling, percussion drilling, piston core drilling, vibro core drilling, channel sampling, sea floor dredging, crushing, mineral separation, melting, outcrop sampling.

8.8.3.3.2.  parameter

The property parameter (OM::NamedValue) contains a name/value pair to describe arbitrary parameters used in the sampling process.  The “name” attribute of NamedValue shall be a term from a controlled vocabulary.

8.8.4.  GeoSciML LaboratoryAnalysis-Specimen vocabularies

Vocabularies used in the LaboratoryAnalysis-Specimen package are listed Table 8:

Table 8 — Laboratory analysis and specimen vocabularies

VocabularyDescription
AnalyticalMethodTermRefers to a vocabulary of terms describing the analytical method used in an analytical session (e.g., XRF mass spectrometry, ICPMS, SHRIMP geochronology).
InstrumentTypeTermRefers to a vocabulary of Instrument types (e.g., XRF, ICPMS, SHRIMP, etc.).
IsotopicEventTypeRefers to a vocabulary of terms to describe any isotopic processes relevant to the geochronologic interpretation. E.g. closure, isotopic mixing, Pb loss, etc.
IsotopicSystemNameRefers to a vocabulary of isotopic systems such as Ar-Ar, K-Ar, Nd-Sm, U-Pb, Pb-Pb, Re-Os, etc.
StatisticalMethodTermRefers to a vocabulary describing statistical methods used in interpret geochronologic data.
GeologicSamplingMethodTermRefers to a vocabulary of terms describing the samplingProcess used to obtain or create the Specimen. e.g., diamond drilling, percussion drilling, piston core drilling, vibro core drilling, channel sampling, sea floor dredging, crushing mineral separation, melting, outcrop sampling.
GeologicSpecimenPreparationTermRefers to a vocabulary of terms to describe sample preparation applied to geologic specimens, typically in preparation for analytical processes like geochemistry or microscopy.  e.g., crush, mineral separation, thin section, cut, polish, mount, acid digestion.

8.8.5.  Outcrop encoding pattern (Informative)

It is suggested to use SamplingFeatureCollection for representing geological field data collected at an outcrop, (i.e., an outcrop is modelled as a collection of sampling points).  At each point at an outcrop, observations may be made on a single geologic feature (sampledFeature), such as a geologic unit description, a fault description, a contact description, or structural measurements on a foliation.  If more than one geologic feature is observed at an outcrop, it is delivered as a separate sampling point.

 

Outcrop encoding pattern using ISO19156.

Figure 96 — Outcrop encoding pattern using ISO19156

SamplingFeatureCollection might also be used to represent dredge hauls, measured sections, and other sorts of sampling features with multiple kinds of associated observations.

Recommendation 3

Identifier/rec/gsml-lab-analysis/outcrop-pattern
Included inRequirements class 8: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lab-analysis
A

Observations at outcrop SHOULD be encoded using the pattern described at clause 8.8.5

8.9.  GeoSciML Lite Requirements Class (Normative)

Requirements class 9: Requirements Class ‘GeoSciML Lite’

Identifierhttps://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
Target typeEncoding
Prerequisites/req/gsml-conceptual
GML Simple Feature SF-0 OGC 10-100r3
ISO 8601 (Date and Time format)
Linked Open Data
RFC 3986 (HTTP URI)
Normative statementsRecommendation 4: /rec/gsml-lite/formal-syntax
Recommendation 5: /rec/gsml-lite/resolvable-uri
Recommendation 6: /rec/gsml-lite/geologicunitview-identifier
Recommendation 7: /rec/gsml-lite/geologicunitview-specification
Recommendation 8: /rec/gsml-lite/boreholeview-identifier
Recommendation 9: /rec/gsml-lite/boreholeview-parentBorehole-uri
Recommendation 10: /rec/gsml-lite/contactview-identifier
Recommendation 11: /rec/gsml-lite/geologicspecimenview-identifier
Recommendation 12: /rec/gsml-lite/geomorphologicunitview-identifier
Recommendation 13: /rec/gsml-lite/sheardisplacemenstructureview-identifier
Recommendation 14: /rec/gsml-lite/siteobservationview-identifier
Requirement 37: /req/gsml-lite/geomtype
Requirement 38: /req/gsml-lite/string
Requirement 39: /req/gsml-lite/datetime
Requirement 40: /req/gsml-lite/uri
Requirement 41: /req/gsml-lite/user-defined
Requirement 42: /req/gsml-lite/identifier-unique
Requirement 43: /req/gsml-lite/identifier-uri
Requirement 44: /req/gsml-lite/geologicunitview-representativeLithology
Requirement 45: /req/gsml-lite/geologicunitview-representativeAge
Requirement 46: /req/gsml-lite/geologicunitview-representativeOlderAge
Requirement 47: /req/gsml-lite/geologicunitview-representativeYoungerAge
Requirement 48: /req/gsml-lite/boreholeview-elevation-crs
Requirement 49: /req/gsml-lite/siteobservationview-symbolRotation

GeoSciML Lite is a simplification of parts of GeoSciML and Observations and Measurements (ISO 19156) for map-based applications.  It was developed to provide a simple schema to deliver geologic map unit, contact, borehole, located sample, geomorphologic unit and shear displacement structure (fault and ductile shear zone) descriptions in web map services. The intention is to support interoperable map services, for which interoperability is based on a shared data schema and the use of standard vocabulary terms for basic type classification of contacts and faults, age of geologic units and faults, and lithology of geologic units.

Use of standard vocabularies enables map display using a shared legend (symbolization scheme) to achieve visual harmonization of maps provided by different services. In addition, the GeoSciML Lite data structure includes text fields with information for human users browsing a geologic map, a link to a full GeoSciML feature element if available, and a symbol identifier field to enable a user-defined symbolization scheme in each map service.

By linking the simple feature WMS with a GeoSciML WFS, clients can acquire geologic feature descriptions that can be used in web-mapping applications to construct custom legends. Linking to full GeoSciML features allows the Lite schema to be used in a map browsing and query interface to identify and select features for further processing that can be acquired as highly structured, information-rich GML features.

 

Package dependency for GeoSciML Lite.

Figure 97 — Package dependency for GeoSciML Lite

GeoSciML Lite conforms to the Level 0 of the Simple Features Profile for GML (OGC 10-100r, OGC 06-049). The simple features profile supports only a limited subset of possible GML geometry types that may be used to describe feature geographic location and shape. For the purposes of GeoSciML simple features, these include GEO::Point, GEO::LineString, GEO::Curve, GEO::Polygon, GEO::Surface, GEO::MultiPoint, GEO::MultiCurve, GEO::MultiSurface and multi-geometry types consisting of collections of these base types.

GeoSciML Lite features are analogous to GeoSciML MappedFeatures and O&M sampling features, with additional text attributes for human consumption, a flatted-relation view of the age, and assignment to a single lithology. The Lite schema consists of ‘free-text’ fields and identifier fields.  Best practice is that free text fields will, where possible, contain well-structured summaries of data in a format suitable for reading by the intended users.  For instance, an agreed common format like comma-delimited values should be adopted by user communities. Identifier fields should contain identifiers for concepts from a controlled vocabulary (for example link:http://resource.geosciml.org/classifier/cgi/lithology/CGI Simple Lithology] (http://resource.geosciml.org/classifier/cgi/lithology/)) that specify representative thematic properties for a feature. Inclusion of these standardized identifiers enables interoperability across services. Ideally the identifiers should be URIs that can be resolved to obtain machine-processable or human-readable representations of the identified concepts.

In addition, some features include an (optional) identifier for a specification (specification_uri), which is a resource containing a description of that particular feature. In many cases, these descriptions will be the same for all geometries assigned to the same map unit or classified as the same kind of contact or structure. If more complete information is available, different specification descriptions may be associated within subsets of mapped features of the same type that are portrayed with the same symbol. In the most extreme case, each mapped feature occurrence might have a unique description that captures the full spatial variability of a geologic unit or structure. Following the standard patterns of web architecture, the specification_uri should be resolvable to obtain one or more representations of that description. For maximum interoperability, one of these representations should be a GeoSciML encoded description of the feature, but other encodings might also be available, for example HTML web pages, other XML schema, or JSON. For those familiar with the GeoSciML Basic package, the specification_uri property is equivalent to the specification association from MappedFeature to GeologicFeature.

8.9.1.  Property mapping

Lite properties are mapped to existing GeoSciML or O&M properties.  Values from GeoSciML and O&M complex properties are converted into GML SF-0 valid basic types (OGC 10-100r2, Clause 8.4.4.1). Different transformations scenarios are possible:

  • The GeoSciML property is already a basic type and the value is used as-is

  • A representative element of the complex type is used. For example; only SWE::Category::value.

  • The value is constructed from several fields merged into a single string.

Lite properties cardinalities are limited to 0..1, while GeoSciML properties are often multiple.  The data provider must then either a) choose one representative value or b) aggregate from the collection of values a new value.  Strings will generally be concatenated while numerical values might be averaged or processed in some way to produce a significant value.  Some Lite properties are designed to represent explicitly one particular occurrence, such as GeologicUnitView::representativeOlderAge_uri, which is the oldest age.  Others are more suggestive and require the judgement of the data provider, such as GeologicUnitView::representativeLithology_uri.  When values are concatenated, they shall be human readable and using simple separators (e.g., commas).

Properties ending with “_uri” shall not have concatenated values.  Those properties are designed to fulfill specific query and rendering use cases.

For each GeoSciML Lite view, a table provides the mapping between Lite and GeoSciML properties.  The mapping is expressed in OCL syntax as a path from the base type of the view to the property where the value resides in GeoSciML.

For example:

 

Mapping of key GeologicUnitView properties to GeoSciML

Figure 98 — Mapping of key GeologicUnitView properties to GeoSciML

Figure 98 shows mapping for some GeologicUnitView properties.  Number 3 on this figure maps GeologicUnitView::lithology to RockMaterial, which requires a traverse from the base type (MappedFeature) to GeologicUnit, CompositionPart and then RockMaterial.

In OCL,

specification:GeomorphologicUnit::unitDescription[1]:GeologicUnit::composition[1]:CompositionPart::material:RockMaterial::lithology

The base type (MappedFeature) is not included as it is the context type.  Package names are not shown to keep the path readable.

A W3C XPath equivalent (using prefixes proposed in 9.1)

gsmlb:Specification/gsmlb:GeomorphologicUnit/gsmlb:unitDescription[1]/gsmlb:GeologicUnit/gsmlb:composition[1]/gsmlb:CompositionPart/gsmlb:material

/gsmlb:RockMaterial/gsmlb:lithology

An exact path is provided when possible (e.g., see 8.9.3.1), for instance to a property of compatible types.  But there are cases where the type cannot be expressed directly in OCL.

  • Part of the model, such as classifiers with <<CodeList>> don’t have specific model.  XML implement them as external references (xlink:href), other encoding might implement them otherwise. 

  • Any property modelled as part as metadata (MD_Metadata) as there are no explicit requirements on how GML metaDataProperty should be implemented.

  • Some values will either come from one “representative” instance, or be an aggregation.

  • Some values are not present in GeoSciML

In such cases, guidance will be provided.

8.9.2.  GeoSciML Lite views

8.9.2.1.  Geometry type

Requirement 37

Identifier/req/gsml-lite/geomtype
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

A dataset SHALL use a single geometry type (Point, Line, Polygon, etc.).

A dataset (for example, a GML document or a GeoJSON instance or an ESRI shapefile) SHALL use a single geometry type. Most GIS applications and software which render a dataset containing geometry do not expect mixed geometries.

8.9.2.2.  String properties

Requirement 38

Identifier/req/gsml-lite/string
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Properties of type “CharacterString” SHALL contain human readable text.

String properties SHALL provide information easily readable by human.  The intent of string field is to display, not to query. The string properties can be translated according to the language of the user as needed while URI properties should not.

8.9.2.3.  Formal Syntax

Recommendation 4

Identifier/rec/gsml-lite/formal-syntax
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Syntax of text in character string properties SHOULD be formalised.

Some string properties can be constructed using formal syntax, such as comma delimited list or any other text based structure (JSON for example).  Where possible, this syntax SHOULD be formalised in a profile of this specification.

8.9.2.4.  Date and Time formatting

Requirement 39

Identifier/req/gsml-lite/datetime
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Calendar date and time SHALL be formatted according to ISO 8601.

All dates and times, excluding geological ages, shall be formatted using ISO 8601 format (YYYY-MM-DD).  When a time must be specified, time zone shall be provided.

Examples:

  • 2016-01-05 (simple date)

  • 2016-01-05T08:40:15-05 (time expressed for time zone GMT -5)

  • 2016-01-05T13:40:15Z (same as above, but expressed in UTC a.k.a Zulu)

8.9.2.5.  URI

Properties which names end with “_uri” shall contain a single absolute URI conformant to RFC 3986.

Requirement 40

Identifier/req/gsml-lite/uri
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Properties which name end with “_uri” SHALL contain a string conformant to URI format as specified in RFC 3986.

Properties containing a URI should, unless stated otherwise, resolve following Linked Open Data principles.

Recommendation 5

Identifier/rec/gsml-lite/resolvable-uri
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Properties containing a valid URI SHOULD be dereferenceable.

Although many vocabulary terms are defined as URI, not all URIs are actually supported by a formal Linked Open Data infrastructure.   URIs are just a convenient mechanism to build unique vocabulary identifiers.  Note that in some situations, some “_uri” properties might require that the URI SHALL resolve to some valid content.  Those cases will be explicitly stated. Some community might create a profile of this requirements class and add more constraints, such as mandatory resolution of the URI to one or more resources and impose mandatory mime-types (GeoSciML/XML or GeoSciML/GeoJSON).

 

GeoSciML Lite feature types.

Figure 99 — GeoSciML Lite feature types

Figure 99 shows the seven Lite feature types specified by GeoSciML 4.1.  Each feature type is equivalent to a layer in a GIS or a Web Map Service. 

8.9.2.6.  User defined properties

Requirement 41

Identifier/req/gsml-lite/user-defined
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Features delivered with user defined properties SHALL be conformant to GML Simple Feature Level 0.

New properties added by the data provider shall keep the feature conformant to GML Simple Feature Level 0.  For example, no duplicate property names, nor extra geometry properties.

8.9.2.7.  identifier

Globally unique identifier:Primitive::CharacterString shall uniquely identifies a tuple within the dataset.

Requirement 42

Identifier/req/gsml-lite/identifier-unique
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Identifiers SHALL be unique to a dataset.

Identifiers shall be formatted as URI according to RFC 3986.  This URI could be used to access more detailed, such as a GeoSciML Basic, representation of the feature.

Requirement 43

Identifier/req/gsml-lite/identifier-uri
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Identifiers SHALL be formatted as URI according to RFC 3986.

8.9.3.  GeologicUnitView

 

GeologicUnitView feature type.

Figure 100 — GeologicUnitView feature type

GeologicUnitView is a simplified view of a GeoSciML MappedFeature feature with key property values from an associated GeologicUnit.   The GeologicUnitView property values are summarised as labels (unconstrained character strings) or arbitrarily selected classifiers to be used for thematic mapping purposes. The latter are the properties suffixed with “_uri” and will contain URIs referring to controlled concepts in published vocabularies.

8.9.3.1.  Mapping

Table 9 — Mapping of GeologicUnitView properties to the GeoSciML data model

PropertyMapping from MappedFeature
identifieridentifier
namespecification:GeologicUnit::name 1
descriptionspecification:GeologicUnit::description
geologicUnitTypespecification:GeologicUnit::geologicUnitType 2
rankspecification:GeologicUnit::rank 2
lithology

specification:GeologicUnit::composition:

CompositionPart::material:RockMaterial::lithology 1,2

geologicHistory

specification:GeologicUnit::geologicHistory:

GeologicEvent/description 1

numericOlderAge

specification:GeologicUnit::geologicHistory:

GeologicEvent:NumericAge::olderBoundAge:Quantity::value 1

numericYoungerAge

specification:GeologicUnit::geologicHistory:

GeologicEvent:NumericAge::youngerBoundAge:Quantity::value 1

observationMethodspecification:GeologicUnit::observationMethod:Category::value 1,2
positionalAccuracypositionalAccuracy:Quantity::value
sourcespecification:GeologicUnit::metaDataProperty(…):CI_Citation 1
geologicUnitType_urispecification:GeologicUnit::geologicUnitType 3
representativeLithology_uri

specification:GeologicUnit::composition:

CompositionPart::material:RockMaterial::lithology 3

representativeAge_uri

specification:GeologicUnit::geologicHistory:

GeologicEvent 3

representativeOlderAge_uri

specification:GeologicUnit::geologicHistory:

GeologicEvent::youngerNamedAge 3

representativeYoungerAge_uri

specification:GeologicUnit::geologicHistory:

GeologicEvent::olderNamedAge 3

specification_urispecification 3
metadata_urispecification:GeologicUnit::metaDataProperty 3
genericSymbolizer
shapeshape

1 In cases where multiple values are delivered for these elements in GeoSciML, data providers should choose one, or merge, or concatenate values into a representative single value for use in GeoSciML Lite

2 Use an appropriate human readable label for the vocabulary

3 Use a reference or an identifier that can be used to reach a representation.

8.9.3.2.  identifier

The identifier should have the same value as the corresponding GeoSciML MappedFeature identifier, if available.

Recommendation 6

Identifier/rec/gsml-lite/geologicunitview-identifier
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

Where possible, GeologicUnitView identifier SHOULD correspond to an instance of GeoSciML MappedFeature.

8.9.3.3.  name

If present, the property name:Primitive::CharacterString is a display name for the GeologicUnit.

8.9.3.4.  description

If present, the property description:Primitive::CharacterString is a description of the GeologicUnit, typically taken from an entry on a geological map legend.

8.9.3.5.  geologicUnitType

If present, the property geologicUnitType (Primitive::CharacterString) contains the type of GeologicUnit (as defined in GeoSciML). To report an identifier from a controlled vocabulary, geologicUnitType_uri shall be used.

8.9.3.6.  rank

If present, the property rank:Primitive::CharacterString contain the rank of GeologicUnit (as defined by ISC. e.g., group, formation, member). 

8.9.3.7.  lithology

If present, lithology contains a human readable description as Primitive::CharacterString of the GeologicUnit’s lithology, possibly formatted with formal syntax (see 8.9.2.3).  The description can be language-dependent.  To report an identifier from a controlled vocabulary, representativeLithology_uri shall be used.

8.9.3.8.  geologicHistory

If present, contains a human readable description in Primitive::CharacterString, possibly formatted with formal syntax (see 8.9.2.3), of the age of the GeologicUnit (where age is a sequence of events and may include process and environment information). To report an identifier from a controlled vocabulary, representativeAge_uri, representativeOlderAge_uri, representativeYoungerAge_uri shall be used.

8.9.3.9.  numericOlderAge

If present, the property numericOlderAge age is a numerical representation (Primitive::Number) of the unit’s older age in million years (Ma).

8.9.3.10.  numericYoungerAge

If present, the property numericYoungerAge is a numerical representation (Primitive::Number) of the unit’s younger age in million years (Ma).

8.9.3.11.  observationMethod

If present, the property observationMethod:Primitive::CharacterString is a metadata snippet indicating how the spatial extent of the feature was determined. ObservationMethod is a convenience property that provides a simple approach to observation metadata when data are reported using a feature view (as opposed to observation view).

8.9.3.12.  positionalAccuracy

If present, the property positionalAccuracy:Primitive::CharacterString is a quantitative value (a numerical value and a unit of length) defining the radius of an uncertainty buffer around a MappedFeature (e.g., a positionalAccuracy of 100 m for a line feature defines a buffer polygon of total width 200 m centred on the line).

8.9.3.13.  source

If present, the property source:Primitive::CharacterString is human readable text describing feature-specific details and citations to source materials, and if available provides URLs to reference material and publications describing the geologic feature. This could be a short text synopsis of key information that would also be in the metadata record referenced by metadata_uri.

8.9.3.14.  geologicUnitType_uri

The property geologicUnitType_uri:Primitive::CharacterString contains a URI referring to a controlled concept from a vocabulary defining the GeologicUnit types.

8.9.3.15.  representativeLithology_uri

The property representativeLithology_uri:Primitive::CharacterString shall contain a URI referring to a controlled concept specifying the characteristic or representative lithology of the unit. This may be a concept that defines the super-type of all lithology values present within a GeologicUnit or a concept defining the lithology of the dominant CompositionPart (as defined in GeoSciML) of the unit.

Requirement 44

Identifier/req/gsml-lite/geologicunitview-representativeLithology
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

representativeLithology_uri value SHALL refer to a controlled concept specifying the characteristic or representative lithology of the unit. This may be a concept that defines the super-type of all lithology values present within a GeologicUnit or a concept defining the lithology of the dominant CompositionPart (as defined in GeoSciML) of the unit.

8.9.3.16.  representativeAge_uri

The property representativeAge_uri:Primitive::CharacterString shall  contain a URI referring to a controlled concept specifying the most representative stratigraphic age interval for the GeologicUnit. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising the all or part of the feature’s history.

Requirement 45

Identifier/req/gsml-lite/geologicunitview-representativeAge
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

representativeAge_uri value SHALL refer to a controlled concept specifying the most representative stratigraphic age interval for the GeologicUnit. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising the all or part of the feature’s history.

8.9.3.17.  representativeOlderAge_uri

The property representativeOlderAge_uri:Primitive::CharacterString shall contain a URI referring to a controlled concept specifying the most representative older value in a range of stratigraphic age intervals for the GeologicUnit. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising the all or part of the feature’s history.

Requirement 46

Identifier/req/gsml-lite/geologicunitview-representativeOlderAge
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

representativeOlderAge_uri value SHALL refer to a controlled concept specifying the most representative older value in a range of stratigraphic age intervals for the GeologicUnit. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising the all or part of the feature’s history.

8.9.3.18.  representativeYoungerAge_uri

The property representativeYoungerAge_uri:Primitive::CharacterString shall contain a URI referring to a controlled concept specifying the most representative younger value in a range of stratigraphic age intervals for the GeologicUnit. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising the all or part of the feature’s history.

Requirement 47

Identifier/req/gsml-lite/geologicunitview-representativeYoungerAge
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

representativeYoungerAge_uri value SHALL refer to a controlled concept specifying the most representative younger value in a range of stratigraphic age intervals for the GeologicUnit. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising the all or part of the feature’s history.

8.9.3.19.  specification_uri

If present, the property specification_uri:Primitive::CharacterString shall contain a URI referring the GeoSciML GeologicUnit feature that describes the instance in detail.

Recommendation 7

Identifier/rec/gsml-lite/geologicunitview-specification
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

specification_uri value SHOULD refer the GeoSciML GeologicUnit feature that describes the instance in detail.

8.9.3.20.  metadata_uri

If present, the property metadata_uri:Primitive::CharacterString contains a URI referring to a metadata record describing the provenance of data.

8.9.3.21.  genericSymbolizer

If present, the property genericSymbolizer:CharacterString contains an identifier for a symbol from standard (locally or community defined) symbolization scheme for portrayal.

8.9.3.22.  shape

The property shape:GEO::GM_Object contains a geometry defining the extent of the feature of interest. 

8.9.3.23.  any

A data provider may add an arbitrary number of extra properties, as long as the instance is conformant to GML Simple Feature Level 0.

8.9.4.  BoreholeView

BoreholeView is a simplified view of a GeoSciML Borehole. In GeoSciML terms, this will be an instance of a Borehole feature with key property values summarised as labels (unconstrained character strings) or arbitrarily selected classifiers to be used for thematic mapping purposes. The latter are the properties suffixed with “_uri” and will contain URIs referring to controlled concepts in published vocabularies.

 

Figure 101 — BoreholeView feature type

8.9.4.1.  Mapping

Table 10 — Mapping of BoreholeView properties to the GeoSciML Borehole data model

PropertyMapping from Borehole
identifieridentifier
Namename 1
descriptiondescription
purposeindexData:BoreholeDetails::purpose 1,2
status
drillingMethoddownholeDrillingDetails:DrillingDetails::drillingMethod ^1 2^
operatorindexData:BoreholeDetails::operator:CI_Responsibility::party:CI_Party::name
drillerindexData:BoreholeDetails::driller:CI_Responsibility::party:CI_Party::name
drillStartDateindexData:BoreholeDetails::dateOfDrilling:TM_Period::begin:TM_Instant::position 1
drillEndDateindexData:BoreholeDetails::dateOfDrilling:TM_Period::end:TM_Instant::position 1
startPointindexData:BoreholeDetails::startPoint
inclinationTypeindexData:BoreholeDetails::inclinationType 2
boreholeMaterialCustodianindexData:BoreholeDetails::boreholeMaterialCustodian:CI_Responsibility::party:CI_Party::name 1
boreholeLength_mindexData:BoreholeDetails::boreholeLength:Quantity::value
elevation_mreferenceLocation:OriginPosition::elevationDirectPosition:::coordinate
elevation_srsreferenceLocation:OriginPosition::elevation:srsName
positionalAccuracymetaDataProperty(…):DQ_PositionalAccuracy 1
sourcemetaDataProperty:(…):CI_Citation 1
parentBorehole_urirelatedSamplingFeature:SamplingFeatureComplex::relatedSamplingFeature:Borehole::identifier 3
metadata_urimetaDataProperty:MD_Metadata 3
genericSymbolizer
shapeshape

1 In cases where multiple values are delivered for these elements in GeoSciML,  data providers should choose one, or merge, or concatenate values into a representative single value for use in GeoSciML Lite

2 Use an appropriate human readable label for the vocabulary

3 Use a reference or an identifier that can be used to reach a representation.

8.9.4.2.  identifier

The identifier:Primitive::CharacterString property shall contain a unique identifier for this borehole and be should formatted as an absolute URI conformant to RFC 3986.

Recommendation 8

Identifier/rec/gsml-lite/boreholeview-identifier
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

identifier SHOULD resolve to a representation of a GeoSciML Borehole.

8.9.4.3.  name

If present, the property name:Primitive::CharacterString contains a human-readable display name for the borehole.

8.9.4.4.  description

If present, the property description:Primitive::CharacterString contains a human-readable description for the borehole. 

8.9.4.5.  purpose

If present, the purpose:Primitive::CharacterString property reports the purpose or purposes for which the borehole was drilled. (e.g., mineral exploration, hydrocarbon exploration, hydrocarbon production, groundwater monitoring, geothermal), possibly formatted with formal syntax (see 8.9.2.3).

8.9.4.6.  status

If present, the property status:Primitive::CharacterString reports the current status of the borehole (e.g., abandoned, completed, proposed, suspended).

8.9.4.7.  drillingMethod

If present, the property drillingMethod:Primitive::CharacterString indicates the drilling method, or methods, used for this borehole (e.g., RAB, auger, diamond core drilling, air core drilling, piston), possibly formatted with formal syntax (see 8.9.2.3).

8.9.4.8.  operator

If present, the property operator:Primitive::CharacterString reports the organisation or agency responsible for commissioning of the borehole (as opposed to the agency which drilled the borehole).

8.9.4.9.  driller

If present, the property driller:Primitive::CharacterString reports the organisation responsible for drilling the borehole (as opposed to commissioning the borehole).

8.9.4.10.  drillStartDate

If present, the property drillStartDate:Primitive::CharacterString reports the date of the start of drilling formatted according to ISO8601 (e.g., 2012-03-17).

8.9.4.11.  drillEndDate

If present, the property drillEndData:Primitive::CharacterString reports the date of the end of drilling formatted according to ISO8601 (e.g., 2012-03-28).

8.9.4.12.  startPoint

If present, the property startPoint:Primitive::CharacterString indicates the position relative to the ground surface where the borehole commenced (e.g., open pit floor or wall, underground, natural land surface, sea floor).

8.9.4.13.  inclinationType

If present, the property inclinationType:Primitive::CharacterString indicates the type of inclination of the borehole (e.g., vertical, inclined up, inclined down, horizontal).

8.9.4.14.  boreholeMaterialCustodian

If present, the property boreholeMaterialCustodian:Primitive::CharacterString reports the organisation that is the custodian of the material recovered from the borehole.

8.9.4.15.  boreholeLength_m

If present, the property boreholeLength_m:Primitive::Number reports the length of a borehole, in metres, as determined by the data provider. Length may have different sources (e.g., driller’s measurement, logger’s measurement, survey measurement).

8.9.4.16.  elevation_m

If present, the property elevation_m:Primitive::Number reports the elevation data, in metres, for the borehole (i.e., wellbore) start point. This is a compromise approach to allow for delivery of legacy 2D data without elevation data, and for software that cannot process a 3D GM_Point.

8.9.4.17.  elevation_srs

If present, the property elevation_srs:Primitive::CharacterString is a URI of a spatial reference system of the elevation value. (e.g., mean sea level). Mandatory if elevation_m is populated. The SRS shall be a one dimensional vertical SRS (i.e., EPSG code in the range 5600-5799).

Requirement 48

Identifier/req/gsml-lite/boreholeview-elevation-crs
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

If present, elevation_srs SHALL resolve to a valid EPSG vertical datum in the range EPSG:5600 to EPSG:5799

Example: https://epsg.org/crs/gml/id/5711

8.9.4.18.  positionalAccuracy

If present, the property positionalAccuracy:Primitive::CharacterString reports an estimate of the accuracy of the location of the borehole collar location.  Ideally, this would be a quantitative estimate of accuracy (e.g., 20 metres).

8.9.4.19.  source

If present, the source:Primitive::CharacterString property describes details and citations to source materials for the borehole and, if available, providing URLs to reference material and publications describing the borehole. This could be a short text synopsis of key information that would also be in the metadata record referenced by metadata_uri.

 

8.9.4.20.  parentBorehole_uri

When present, the parentBorehole_uri:Primitive::CharacterString contains a URI referring to one or more representations of a parent borehole (e.g., a parent well of a sidetrack wellbore).

Recommendation 9

Identifier/rec/gsml-lite/boreholeview-parentBorehole-uri
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

If present, parentBorehole_uri SHOULD resolve to a representation of a GeoSciML borehole.

If the borehole does not have any parent, this field shall be empty.

8.9.4.21.  metadata_uri

If present, the property metadata_uri:Primitive::CharacterString contains a URI referring to a metadata record describing the provenance of data.

8.9.4.22.  genericSymbolizer

If present, the property genericSymbolizer:Primitive::CharacterString contains an identifier for a symbol from standard (locally or community defined) symbolization scheme for portrayal.

8.9.4.23.  shape

The property shape:GM_Object contains a Geometry defining the extent of the borehole start point.

8.9.4.24.  any

A data provider may add an arbitrary number of extra properties, as long as the instance is conformant to GML Simple Feature Level 0.

8.9.5.  ContactView

 

ContactView feature type.

Figure 102 — ContactView feature type

ContactView is a simplified view of a GeoSciML MappedFeature with key property values from an associated Contact feature.  These properties are summarised as labels (unconstrained character strings) or arbitrarily selected classifiers to be used for thematic mapping purposes. The latter are the properties suffixed with “_uri” and will contain URIs referring to controlled concepts in published vocabularies.

8.9.5.1.  Mapping

Table 11 — Mapping of ContactView properties to the GeoSciML data model

PropertyMapping from MappedFeature
identifierspecification:Contact::identifier
namespecification:Contact::name 1
descriptionspecification:Contact::description
contactTypespecification:Contact::contactType 2
observationMethodobservationMethod 1,2
positionalAccuracypositionalAccuracy 2
sourcespecification:GeologicUnit::metaDataProperty:(…):CI_Citation
contactType_urispecification::Contact:contactType 3
specification_urispecification 3
metadata_urispecification::Contact::metaDataProperty 3
genericSymbolizer
Shapeshape

1 In cases where multiple values are delivered for these elements in GeoSciML, data providers should choose one, or merge, or concatenate values into a representative single value for use in GeoSciML Lite

2 Use an appropriate human readable label for the vocabulary

3 Use a reference or an identifier that can be used to reach a representation.

8.9.5.2.  identifier

Globally unique identifier:Primitive::CharacterString shall uniquely identifies a tuple within the dataset and be formatted as an absolute URI conformant to RFC 3986.

Recommendation 10

Identifier/rec/gsml-lite/contactview-identifier
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

identifier SHOULD correspond to an instance of GeoSciML MappedFeature.

It should have the same value as the corresponding GeoSciML MappedFeature identifier if available.

8.9.5.3.  name

If present, the property name:Primitive::CharacterString reports the display name for the Contact.

8.9.5.4.  description

If present, the property description:Primitive::CharacterString reports the description of the Contact, typically taken from an entry on a geological map legend.

8.9.5.5.  contactType

If present, the property contactType:Primitive::CharacterString reports the type of Contact (as defined in GeoSciML) as a human readable label.  To report an identifier from a controlled vocabulary, contactType_uri shall be used.

8.9.5.6.  observationMethod

If present, the property observationMethod:Primitive::CharacterString reports a metadata snippet indicating how the spatial extent of the feature was determined. ObservationMethod is a convenience property that provides a quick and simple approach to observation metadata when data are reported using a feature view (as opposed to observation view).

8.9.5.7.  positionalAccuracy

If present, the property positionalAccuracy:Primitive::CharacterString reports quantitative values defining the radius of an uncertainty buffer around a MappedFeature (e.g., a positionalAccuracy of 100 m for a line feature defines a buffer polygon of total width 200 m centred on the line).

8.9.5.8.  source

If present, the property source:Primitive::CharacterString contains a text describing feature-specific details and citations to source materials, and if available providing URLs to reference material and publications describing the contact feature. This could be a short text synopsis of key information that would also be in the metadata record referenced by metadata_uri.

8.9.5.9.  contactType_uri

The property contactType_uri:Primitive::CharacterString reports a URI referring to a controlled concept from a vocabulary defining the Contact types.

8.9.5.10.  specification_uri

If present, the property specification_uri:Primitive::CharacterString reports a URI referring the GeoSciML Contact feature that describes the instance in detail. 

8.9.5.11.  metadata_uri

If present, the property metadata_uri:Primitive::CharacterString reports a URI referring to a metadata record describing the provenance of data.

8.9.5.12.  genericSymbolizer

If present, the genericSymbolizer:Primitive::CharacterString property contains an identifier for a symbol from standard (locally or community defined) symbolization scheme for portrayal.

8.9.5.13.  shape

The property shape:GM_Object contains a geometry defining the extent of the contact feature.

8.9.5.14.  any

A data provider can add an arbitrary number of extra properties, as long as the instance is conformant to GML Simple Feature Level 0.

8.9.6.  GeologicSpecimenView

 

GeologicSpecimenView feature type.

Figure 103 — GeologicSpecimenView feature type

GeologicSpecimenView is a simplified view of a point-located specimen from GeoSciML GeologicSpecimen (an extension of Observations & Measurements — ISO19156) with key property values summarised as labels (unconstrained character strings) or arbitrarily selected classifiers to be used for thematic mapping purposes. The latter are the properties suffixed with “_uri” and will contain URIs referring to controlled concepts in published vocabularies.

8.9.6.1.  Mapping

Table 12 — Mapping of GeologicSpecimenView properties to Observations and Measurements

PropertyMapping from OM::SF_Specimen
identifieridentifier
labelname 1
descriptiondescription
specimenTypespecimenType 2
materialClassmaterialClass 2
positionalAccuracymetadataProperty:(…):DQ_PositionalAccuracy 1
samplingTimesamplingTime:TM_Instant::position
samplingMethodsamplingMethod 1,2
currentLocationcurrentLocation:EX_GeographicDescription::geographicIdentifier:MD_Identifier::code
sourcespecification:GeologicUnit::metaDataProperty:(…):CI_Citation
specimenType_urispecimenType 3
materialClass_urimaterialClass 3
metadata_urimetadataProperty 3
genericSymbolizer
shapesamplingLocation

1 In cases where multiple values are delivered for these elements in GeoSciML, data providers should choose one, or merge, or concatenate values into a representative single value for use in GeoSciML Lite

2 Use an appropriate human readable label for the vocabulary

3 Use a reference or an identifier that can be used to reach a representation.

8.9.6.2.  identifier

Globally unique identifier:Primitive::CharacterString uniquely identifies a tuple within the dataset and be formatted as an absolute URI conformant to RFC 3986.

Recommendation 11

Identifier/rec/gsml-lite/geologicspecimenview-identifier
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

identifier SHOULD correspond to an instance of GeoSciML GeologicSpecimen.

If present, the URI should resolve to a representation that corresponds to an instance of GeoSciML GeologicSpecimen.

8.9.6.3.  label

If present, the property label:Primitive::CharacterString contains a short label for map display. (e.g., a sample number).

8.9.6.4.  description

If present, the property description:Primitive::CharacterString contains a detailed description of the specimen.

8.9.6.5.  specimenType

If present, the property specimentType:Primitive::CharacterString contains a human readable description of the specimen type (e.g., hand specimen, thin section, drill core).  To report an identifier from a controlled vocabulary, specimenType_uri shall be used.

8.9.6.6.  materialClass

If present, the property materialClass:Primitive::CharacterString reports the classification of the material that comprises the specimen (e.g., rock, sediment, etc.).  To report an identifier from a controlled vocabulary, materialClass_uri shall be used.

8.9.6.7.  positionalAccuracy

If present, the property positionalAccuracy:Primitive::CharacterString contains a description of the positional accuracy of the sampling location. (e.g., 50 metres).

8.9.6.8.  samplingTime

If present, the property samplingTime:Primitive::CharacterString reports a date or a date with time of when the specimen was collected formatted according to ISO 8601.

Examples:

  • 2012-03-28

  • 2008-02-28T14:15:23-05

8.9.6.9.  samplingMethod

If present, the property samplingMethod:Primitive::CharacterString reports the method used to collect the specimen (e.g., diamond drilling, field mapping survey).

8.9.6.10.  currentLocation

If present, the property currentLocation:Primitive::CharacterString reports the current location of the specimen (e.g., a warehouse or other repository location).

8.9.6.11.  source

If present, the property source:Primitive::CharacterString reports the citation of the source of the data (e.g., a publication, map, etc.).

8.9.6.12.  specimenType_uri

The property specimentType_uri:Primitive::CharacterString contains a URI link for a specimen type identifier from a controlled vocabulary.

8.9.6.13.  materialClass_uri

The property materialClass_uri:Primitive::CharacterString contains a URI link for a class of material drawn from a controlled vocabulary.

8.9.6.14.  metadata_uri

If present, the property metadata_uri:Primitive::CharacterString contains a URI link to a metadata document.

8.9.6.15.  genericSymbolizer

If present, the genericSymbolizer:Primitive::CharacterString property contains an identifier for a symbol from standard (locally or community defined) symbolization scheme for portrayal.

8.9.6.16.  shape

The property shape:GM_Object contains a geometry of the specimen (generally a point).

8.9.6.17.  any

A data provider can add an arbitrary number of extra properties, as long as the instance is conformant to GML Simple Feature Level 0.

8.9.7.  GeomorphologicUnitView

 

GeomorphologicUnitView feature type.

Figure 104 — GeomorphologicUnitView feature type

GeomorphologicUnitView is a simplified view of a GeoSciML GeomorphologicUnit. In GeoSciML terms this will be in instance of a MappedFeature with key property values from the associated GeomorphologicUnit feature summarised as labels (unconstrained character strings) or arbitrarily selected classifiers to be used for thematic mapping purposes. The latter are the properties suffixed with “_uri” and will contain URIs referring to controlled concepts in published vocabularies.

 

8.9.7.1.  Mapping

Table 13 — Mapping of GeomporphologicUnitView properties to GeoSciML

PropertyMapping from GeomorphologicUnit
identifieridentifier
namespecification:NaturalGeomorphologicFeature::name 1
descriptionspecification:NaturalGeomorphologicFeature::description
activityspecification:NaturalGeomorphologicFeature:activity 2
unitType

specification:NaturalGeomorphologicFeature::naturalGeomorphologicFeatureType 2

 

or

 

specification:AnthropogenicGeomorphologicUnit::anthropogenicGeomorphologicFeatureType 2

lithologyspecification:GeomorphologicUnit::unitDescription:GeologicUnit::composition:CompositionPart::material:RockMaterial::lithology 1
geologicHistoryspecification:GeomorphologicUnit::unitDescription:GeologicUnit::geologicHistory:GeologicEvent::description 1
observationMethodspecification:GeomorphologicUnit::observationMethod:Category::value 1
positionalAccuracypositionalAccuracy::value
sourcespecification:GeologicUnit::metaDataProperty:(…):CI_Citation
activity_urispecification:NaturalGeomorphologicFeature::activity
geomorphologicFeatureTypetypeOf(specification/*)::name()
geomorphologicFeatureType_uritypeOf(specification/*)::typeName()
unitType_urispecification:GeomorphologicUnit::geologicUnitType 3
representativeLithology_urispecification:GeomorphologicUnit::unitDescription:GeologicUnit::composition:CompositionPart::material:RockMaterial::lithology 3
representativeAge_uri

specification:GeomorphologicUnit::geologicHistory:

GeologicEvent 3

representativeNumericAge

specification: GeomorphologicUnit::geologicHistory:

GeologicEvent:NumericAge 1

specification_urispecification 3
metadata_urispecification:GeologicUnit:metaDataProperty 3
genericSymbolizer
shapeshape

1 In cases where multiple values are delivered for these elements in GeoSciML, data providers should choose one, or merge, or concatenate values into a representative single value for use in GeoSciML Lite

2 Use an appropriate human readable label for the vocabulary

3 Use a reference or an identifier that can be used to reach a representation.

8.9.7.2.  identifier

Globally unique identifier:Primitive::CharacterString shall uniquely identifies a tuple within the dataset and be formatted as an absolute URI conformant to RFC 3986.

Recommendation 12

Identifier/rec/gsml-lite/geomorphologicunitview-identifier
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

identifier SHOULD correspond to a representation of GeoSciML MappedFeature.

If present, the URI should resolve to a representation that corresponds to an instance of GeoSciML MappedFeature.

8.9.7.3.  name

If present, the property name:Primitive::CharacterString contains a display name for the GeomorphologicUnit.

8.9.7.4.  description

If present, the property description:Primitive::CharacterString contains human readable text description of the GeomorphologicUnit, typically taken from an entry on a map legend.

8.9.7.5.  activity

If present, the property activity:Primitive::CharacterString contains a human readable term to specify if the feature is changing and how fast. E.g. active, dormant, stable.  To report an identifier from a controlled vocabulary, activity_uri shall be used.

8.9.7.6.  geomorphologicFeatureType

If present, the property geomorphologicFeatureType:Primitive::CharacterString contains a human readable term to specify a broad classification of landform. (e.g., anthropogenic, natural).  To report an identifier from a controlled vocabulary, geomorphologicFeatureType_uri shall be used.

8.9.7.7.  unitType

If present, the property unitType:Primitive::CharacterString contains a human readable term for the type of GeomorphologicUnit (e.g., hill, crater, moraine, plain).  To report an identifier from a controlled vocabulary, unitType_uri shall be used.

8.9.7.8.  lithology

If present, the property lithology:Primitive::CharacterString contains a text, possibly formatted with formal syntax (see 8.9.2.3), for the description of the GeomorphologicUnit’s lithological composition.  To report an identifier from a controlled vocabulary, representativeLithology_uri shall be used.

8.9.7.9.  geologicHistory

If present, the property geologicHistory:Primitive::CharacterString contains text, possibly formatted with formal syntax (see 8.9.2.3), for the description of the age of the GeomorphologicUnit (where age is a sequence of events and may include process and environment information).  To report identifier from a controlled vocabulary, representativeAge_uri shall be used.

8.9.7.10.  representativeNumericAge

If present, the property representativeNumericAge:Primitive::Number contains a numerical value of the representative age in million years (Ma).

8.9.7.11.  observationMethod

If present, the property observationMethod:Primitive::CharacterString contains a metadata snippet indicating how the spatial extent of the feature was determined. ObservationMethod is a convenience property that provides a quick approach to observation metadata when data are reported using a feature view (as opposed to observation view).

8.9.7.12.  positionalAccuracy

If present, the property positionAccuracy:Primitive::CharacterString contains quantitative values defining the radius of an uncertainty buffer around a MappedFeature (e.g., a positionalAccuracy of 100 m for a line feature defines a buffer polygon of total width 200 m centred on the line).

8.9.7.13.  source

If present, the source:Primitive::CharacterString property contains text describing feature-specific details and citations to source materials, and if available providing URLs to reference material and publications describing the geologic feature. This could be a short text synopsis of key information that would also be in the metadata record referenced by metadata_uri.

8.9.7.14.  activity_uri

If present, the activity_uri:Primitive::CharacterString property reports a URI identifier of activity term drawn from a controlled vocabulary.

8.9.7.15.  geomorphologicFeatureType_uri

If present, the property geomorphologicFeatureType_uri:Primitive::CharacterString reports a URI identifier of landform term drawn from a controlled vocabulary.

8.9.7.16.  unitType_uri

If present, the property unitType_uri:Primitive::CharacterString reports a URI referring to a controlled concept from a vocabulary defining the GeomorphologicUnit types.

8.9.7.17.  representativeLithology_uri

The property representativeLithology_uri:Primitive::CharacterString contains a URI referring to a controlled concept specifying the characteristic or representative lithology of the unit. This may be a concept that defines the super-type of all lithology values present within a GeomorphologicUnit or a concept defining the lithology of the dominant CompositionPart (as defined in GeoSciML) of the unit.

8.9.7.18.  representativeAge_uri

The property representativeAge_uri:Primitive::CharacterString contains a URI referring to a controlled concept specifying the most representative stratigraphic age interval for the GeomorphologicUnit. This will be defined entirely at the discretion of the data provider. Typically geomorphic units are not assigned age ranges.

8.9.7.19.  specification_uri

If present, the property specification_uri:Primitive::CharacterString contains a URI referring the GeoSciML GeomorphologicUnit feature that describes the instance in detail.

8.9.7.20.  metadata_uri

If present, the property metadata_uri:Primitive::CharacterString contains a URI referring to a metadata record describing the provenance of data.

8.9.7.21.  genericSymbolizer

If present, the property genericSymbolizer:Primitive::CharacterString contains an identifier for a symbol from standard (locally or community defined) symbolization scheme for portrayal.

8.9.7.22.  shape

The property shape:GM_Object contains a geometry defining the extent of the feature of interest. 

8.9.7.23.  any

A data provider can add an arbitrary number of extra properties, as long as the instance is conformant to GML Simple Feature Level 0.

8.9.8.  ShearDisplacementStructureView

 

ShearDisplacementStructureView feature type.

Figure 105 — ShearDisplacementStructureView feature type

ShearDisplacementStructureView is a simplified view of a GeoSciML ShearDisplacementStructure. In GeoSciML terms this will be an instance of a MappedFeature with key property values from the associated ShearDisplacementStructure feature summarised as labels (unconstrained character strings) or arbitrarily selected classifiers to be used for thematic mapping purposes. The latter are the properties suffixed with “_uri” and will contain URIs referring to controlled concepts in published vocabularies.

8.9.8.1.  Mapping

Table 14 — Mapping of ShearDisplacementStructureView properties to GeoSciML

PropertyMapping from MappedFeature
identifieridentifier
namespecification:ShearDisplacementStructure::name 1
descriptionspecification:ShearDisplacementStructure::description
faultTypespecification:ShearDisplacementStructure::faultType 2
movementTypespecification:ShearDisplacementStructure::stStructureDescription:DisplacementValue::movementType 2
deformationStylespecification:ShearDisplacementStructure::stStructureDescription:ShearDisplacementStructureDescription::deformationStyle 2
displacementspecification:ShearDisplacementStructure::stStructureDescription:DisplacementValue 1
geologicHistoryspecification:ShearDisplacementStructure::geologicHistory:GeologicEvent::description 1
observationMethodspecification:ShearDisplacementStructure::observationMethod:Category::value 1
positionalAccuracypositionalAccuracy:Quantity::value
sourcespecification:GeologicUnit::metaDataProperty:(…):CI_Citation
faultType_urispecification:ShearDisplacementStructure::faultType 3
movementType_urispecification:ShearDisplacementStructure::stStructureDescription:DisplacementValue::movementType 3
deformationStyle_urispecification:ShearDisplacementStructure::stStructureDescription:ShearDisplacementStructureDescription::deformationStyle 3
representativeAge_urispecification:ShearDisplacementStructure::geologicHistory:GeologicEvent 3
representativeOlderAge_urispecification:ShearDisplacementStructure::geologicHistory:GeologicEvent::olderNamedAge 3
representativeYoungerAge_urispecification:ShearDisplacementStructure::geologicHistory:GeologicEvent:youngerNamedAge 3
numericOlderAgespecification:ShearDisplacementStructure::geologicHistory:GeologicEvent::numericAge:NumericAgeRange::olderBoundAge:Quantity::value 1
numericYoungerAgespecification:ShearDisplacementStructure::geologicHistory:GeologicEvent::numericAge:NumericAgeRange::youngerBoundAge:Quantity::value 1
specification_urispecification 3
metadata_urimetadataProperty 3
genericSymbolizer
shapeshape

1 In case where multiple values are delivered for these elements in GeoSciML, data providers should choose one, or merge, or concatenate values into a representative single value for use in GeoSciML Lite

2 Use an appropriate human readable label for the vocabulary

3 Use a reference or an identifier that can be used to reach a representation.

8.9.8.2.  identifier

Globally unique identifier:Primitive::CharacterString shall uniquely identifies a tuple within the dataset and be formatted as an absolute URI conformant to RFC 3986.

Recommendation 13

Identifier/rec/gsml-lite/sheardisplacemenstructureview-identifier
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

identifier SHOULD correspond to a representation of GeoSciML MappedFeature.

It should have the same value as the corresponding GeoSciML MappedFeature identifier if available.

8.9.8.3.  name

If present, the property name:Primitive::CharacterString contains a display name for the ShearDisplacementStructure.

8.9.8.4.  description

If present, the property description:Primitive::CharacterString contains a human readable text description of the ShearDisplacementStructure, typically taken from an entry on a geological map legend.

8.9.8.5.  faultType

If present, the property faultType:Primitive::CharacterString contains a human readable description of the type of ShearDisplacementStructure (as defined in GeoSciML).  To report an identifier from a controlled vocabulary, faultType_uri shall be used.

8.9.8.6.  movementType

If present, the property movementType:Primitive::CharacterString contains a human readable summary of the type of movement (e.g. dip-slip, strike-slip) on the ShearDisplacementStructure.  To report an identifier from a controlled vocabulary, movementType_uri shall be used.

8.9.8.7.  deformationStyle

If present, the property deformationStyle:Primitive::CharacterString contain a human readable description of the style of deformation (e.g. brittle, ductile etc.) for the ShearDisplacementStructure.  To report an identifier from a controlled vocabulary, deformationStyle_uri shall be used.

8.9.8.8.  displacement

If present, the property displacement:Primitive::CharacterString contains a text summarising the displacement across the ShearDisplacementStructure.

8.9.8.9.  geologicHistory

If present, the property geologicHistory:Primitive::CharacterString contains a text, possibly formatted with formal syntax (see 8.9.2.3), describing the age of the ShearDisplacementStructure (where age is a sequence of events and may include process and environment information).  To report identifiers from a controlled vocabulary, representativeAge_uri, representativeOlderAge_uri and representativeYoungerAge_uri shall be used.

8.9.8.10.  numericOlderAge

If present, the property numericOlderAge:Primitive::Number reports the older age of the fault/shear structure, represented million years (Ma).

8.9.8.11.  numericYoungerAge

If present, the property numericYoungerAge:Primitive::Number reports the younger age of the fault/shear structure, represented million years (Ma).

8.9.8.12.  observationMethod

If present, the property observationMethod:Primitive::CharacterString contains a metadata snippet indicating how the spatial extent of the feature was determined. ObservationMethod is a convenience property that provides a quick and dirty approach to observation metadata when data are reported using a feature view (as opposed to observation view).

8.9.8.13.  positionalAccuracy

If present, the property positionAccuracy:Primitive::CharacterString contains quantitative representation defining the radius of an uncertainty buffer around a MappedFeature (e.g., a positionalAccuracy of 100 m for a line feature defines a buffer polygon of total width 200 m centred on the line).

8.9.8.14.  source

If present, the property source:Primitive::CharacterString contains a text describing feature-specific details and citations to source materials, and if available providing URLs to reference material and publications describing the geologic feature. This could be a short text synopsis of key information that would also be in the metadata record referenced by metadata_uri.

8.9.8.15.  faultType_uri

The property faultType_uri:Primitive::CharacterString contains a URI referring to a controlled concept from a vocabulary defining the fault (ShearDisplacementStructure) type.

8.9.8.16.  movementType_uri

The property movementType_uri:Primitive::CharacterString contains a URI referring to a controlled concept from a vocabulary defining the ShearDisplacementStructure movement type.

8.9.8.17.  deformationStyle_uri

The property deformationStyle_uri:Primitive::CharacterString contains a URI referring to a controlled concept from a vocabulary defining the ShearDisplacementStructure deformation style.

8.9.8.18.  representativeAge_uri

The property representativeAge_uri:Primitive::CharacterString contains a URI referring to a controlled concept specifying the most representative stratigraphic age interval for the ShearDisplacementStructure. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising all or part of the feature’s history.

8.9.8.19.  representativeOlderAge_uri

The property representativeOlderAge_uri:Primitive:CharacterString contains a URI referring to a controlled concept specifying the most representative lower value in a range of stratigraphic age intervals for the ShearDisplacementStructure. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising all or part of the feature’s history.

8.9.8.20.  representativeYoungerAge_uri

The property representativeYoungerAge_uri:Primitive::CharacterString contains a URI referring to a controlled concept specifying the most representative upper value in a range of stratigraphic age intervals for the ShearDisplacementStructure. This will be defined entirely at the discretion of the data provider and may be a single event selected from the geologic feature’s geological history or a value summarising all or part of the feature’s history.

8.9.8.21.  specification_uri

If present, the property specification_uri:Primitive::CharacterString contains a URI referring the GeoSciML ShearDisplacementStructure feature that describes the instance in detail.  

8.9.8.22.  metadata_uri

If present, the property metadata_uri:Primitive::CharacterString contains a URI referring to a metadata record describing the provenance of data.

8.9.8.23.  genericSymbolizer

If present, the property genericSymbolizer:Primitive::CharacterString contains an identifier for a symbol from standard (locally or community defined) symbolization scheme for portrayal.

8.9.8.24.  shape

The property shape:GM_Object contains a geometry defining the extent of the feature of interest. 

8.9.8.25.  any

A data provider can add an arbitrary number of extra properties, as long as the instance is conformant to GML Simple Feature Level 0.

8.9.9.  SiteObservationView

 

SiteObservationView feature type.

Figure 106 — SiteObservationView feature type

SiteObservationView is a simplified view of a generally point-located geological observation, like a structural measurement. This is a simplified instance of a sampling geometry from Observations & Measurements (ISO19156) with an associated geological observation. Each tuple should represent a single observation. Key property values are summarised as labels (unconstrained character strings) or arbitrarily selected classifiers to be used for thematic mapping purposes. The latter are the properties suffixed with “_uri” and will contain URIs referring to controlled concepts in published vocabularies.

8.9.9.1.  Mapping

Table 15 — Mapping of SiteObservationView properties to Observations & Measurements

PropertyMapping from OM::OM_Observation
identifieridentifier
siteNameSF_SamplingFeature::name 1,4
observationNamename 1
labelname 1
descriptiondescription
featureOfInterestfeatureOfInterest:(…)::name 1
observedPropertyobservedProperty 2
observedValueResult 1
observedValueUomresult 5
observationMethodProcedure 1
positionalAccuracymetadataProperty:(…):DQ_PositionalAccuracy
sourcemetaDataProperty:(…):CI_Citation
featureOfInterest_urifeatureOfInterest 3
propertyType_uriobservedProperty 3
metadata_urimetaDataProperty 3
genericSymbolizer
symbolRotation
shapefeatureOfInterest:(…):GM_Object

1 In cases where multiple values are delivered for these elements in GeoSciML, data providers should choose one, or merge, or concatenate values into a representative single value for use in GeoSciML Lite

2 Use an appropriate human readable label for the vocabulary

3 Use a reference or an identifier that can be used to reach a representation.

4 Observations associated to a SF_SamplingFeature can report it although SF_SamplingFeature::relatedObservation:OM_Observation is not traversable in reverse, unless it is also the featureOfInterest

5 OM_Measurement::value type is any type and might or might not have a unit of measurement.  The property carrying depend of the result type.

8.9.9.2.  identifier

Globally unique identifier:Primitive::CharacterString shall uniquely identifies a tuple within the dataset and be formatted as an absolute URI conformant to RFC 3986.

Recommendation 14

Identifier/rec/gsml-lite/siteobservationview-identifier
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

identifier SHOULD correspond to a representation of OM::OM_Observation.

The URI should resolve to an instance of OM_Observation.

8.9.9.3.  siteName

If present, the property siteName:Primitive::CharacterString contains the name of the sampling feature at this location (e.g. a station number, a borehole).

8.9.9.4.  observationName

If present, the property observationName:Primitive::CharacterString contains a text identifying the observation.

8.9.9.5.  label

If present, the property label:Primitive::CharacterString contains a short text string to associate with a symbol in a visualization/portrayal.

8.9.9.6.  description

If present, the property description:Primitive::CharacterString contains a text string providing descriptive information about the observation.

8.9.9.7.  featureOfInterest

If present, the property featureOfInterest:Primitive::CharacterString contains a description of the geologic feature that the observation is intended to characterize, e.g. foliation (observed property= orientation), a geologic unit (observed property = age, magnetic susceptibility, density, uranium content).  The property is equivalent to O&M OM_Observation::featureOfInterest. To report a URI of the feature of interest, featureOfInterest_uri shall be used.

8.9.9.8.  observedProperty

If present, the property observedProperty:Primitive::CharacterString contains a description of the property reported in this record. (E.g. orientation, age, density, gold content) as a human readable text. To report an identifier of the observedProperty from a controlled vocabulary, propertyType_uri shall be used.

8.9.9.9.  observedValue

If present, the property observedValue:Primitive::CharacterString contains the result of the observation. This field is implemented as a character string to allow reporting various type of values, the value may be numeric (e.g., 235) or textual (e.g., red).  Units of measure shall be reported in observedValueUom.

8.9.9.10.  observedValueUom

If relevant, the property observedValueUom:Primitive::CharacterString contains the unit of measure for a numerical value of an observation or measurement, preferably from a controlled vocabulary.

8.9.9.11.  observationMethod

If present, the observationMethod:Primitive::CharacterString property contains a method description, preferably a term from a controlled vocabulary, to categorize the observation method. Further details on procedure can be put in the source field.

8.9.9.12.  positionalAccuracy

If present, the property positionalAccuracy:Primitive::CharacterString provides an estimate of the position uncertainty for the site location. For numerical measurements, include a unit of measure in the description. (e.g., 50 metres, poor, good).

8.9.9.13.  source

If present, the property source:Primitive::CharacterString contains a text description of measurement procedure, processing, and provenance of data.

8.9.9.14.  featureOfInterest_uri

The property featureOfInterest:Primitive::CharacterString is functionally equivalent to OM_Observation::featureOfInterest of IS19156.  It contains a URI link to a representation of the feature of interest (e.g., a GeoSciML geologic unit or structure).

8.9.9.15.  propertyType_uri

The property propertyType_uri:Primitive:CharacterString is functionally equivalent to OM_Observation::observedProperty.  It contains a URI to a term from a controlled vocabulary of observed property types.

 

A property type shall identify a “phenomenon associated with the feature-of-interest.” (OGC 10-004r3, clause 7.2.2.8).  The Observations and Measurements specification (op. cit.) explains that a property type “may be, but need not be, modelled as a property (in the sense of the General Feature Model) in a formal application schema that defines the type of the feature-of-interest” or “Property-type definitions may be organized into a hierarchy or ontology and managed in a register and catalogued to support discovery functions.”

8.9.9.16.  metadata_uri

If present, the property metadata_uri:Primitive::CharacterString contains a URI link to metadata document.

8.9.9.17.  genericSymbolizer

If present, the property genericSymbolizer:Primitive::CharacterString contains an identifier for a symbol to portray this observation. Conventions for symbol identifiers can be adopted within information exchange communities.

8.9.9.18.  symbolRotation

If present, the symbolRotation:Integer property contains an integer value between 0 and 359 to specify rotation of symbol at this location, e.g. rotation of a geologic strike and dip symbol to reflect the strike azimuth.  The angular convention shall be geographic angle (clockwise with 0 at geographic north pole, therefore 90 degree is east).

Requirement 49

Identifier/req/gsml-lite/siteobservationview-symbolRotation
Included inRequirements class 9: https://www.opengis.net/spec/geosciml-part1/5.0/req/gsml-lite
A

If present, the symbolRotation SHALL be a value in the range [0,360].

8.9.9.19.  shape

The property shape:GM_Object contains the geometry of the observation site.

8.9.9.20.  any

A data provider can add an arbitrary number of extra properties, as long as the instance is conformant to GML Simple Feature Level 0.


Annex A
(informative)
Conformance Class Abstract Test Suite (Normative)

A.1.  GeoSciML Conceptual

Conformance class A.1: GeoSciML Conceptual

Identifier/conf/gsml-conceptual
Requirements class/req/gsml-conceptual
Conformance testAbstract test A.1: /conf/gsml-conceptual/similarity

Abstract test A.1

Identifier/conf/gsml-conceptual/similarity
RequirementRequirement 1: /req/gsml-conceptual/similarity
Test purpose

Ensure that the target logical model is compatible with the conceptual model.

Test method

Determine semantic similarity between the logical model and conceptual model using an established method such as: (i) visual comparison of the UML diagrams, (ii) comparison of logical and conceptual components expressed in a common knowledge representation language such as first order logic, or (iii) comparison after mapping to a reference ontology.

A.2.  GeoSciML Core Abstract

Conformance class A.2: GeoSciML Core Abstract

Identifier/conf/gsml-core
Requirements class/req/gsml-core
PrerequisitesUrn:iso:dis:iso:19156:clause:A.1.1
RFC 3986
Conformance testsAbstract test A.2: /conf/gsml-core/uml-entity-name
Abstract test A.3: /conf/gsml-core/uml-cardinality
Abstract test A.4: /conf/gsml-core/uml-abstract
Abstract test A.5: /conf/gsml-core/uml-polymorphism
Abstract test A.6: /conf/gsml-core/quantities-uom
Abstract test A.7: /conf/gsml-core/codelist

Abstract test A.2

Identifier/conf/gsml-core/uml-entity-name
RequirementRequirement 2: /req/gsml-core/uml-entity-name
Test purpose

Ensure that the names used in the target implementation matches the names in the logical model

Test method

Visual inspection that, when possible, name used in the target implementation matches the names in the logical model.

Abstract test A.3

Identifier/conf/gsml-core/uml-cardinality
RequirementRequirement 3: /req/gsml-core/uml-cardinality
Test purpose

Ensure that the cardinalities of the properties are the same as the logical model

Test method

Visually inspect the target implementation and validate that all properties have the same cardinality as the one expressed in the logical model.

Abstract test A.4

Identifier/conf/gsml-core/uml-abstract
RequirementRequirement 4: /req/gsml-core/uml-abstract
Test purpose

Ensure that target implementation does not allow materialisation of abstract classes

Test method

Visually inspect the target implementation and validate that no classifiers (Feature, Type or Datatype) marked as abstract can be materialised.

Abstract test A.5

Identifier/conf/gsml-core/uml-polymorphism
RequirementRequirement 5: /req/gsml-core/uml-polymorphism
Test purpose

Ensure that target implementation has mechanisms to allow type substitutions for property values.

Test method

Visually check the target implementation accept all substitutable types for property values

Abstract test A.6

Identifier/conf/gsml-core/quantities-uom
RequirementRequirement 6: /req/gsml-core/quantities-uom
Test purpose

Ensure that quantities have a governed unit of measure

Test method

Visually check that the target implementation has a mechanism to enforce a unit of measure from a governed source.

Abstract test A.7

Identifier/conf/gsml-core/codelist
RequirementRequirement 8: /req/gsml-core/codelist
Test purpose

Ensure that vocabulary terms are encode as URI according to RFC3986

Test method

Visually check that the target implementation has a mechanism to enforce a unit of measure from a governed source.

A.3.  GeoSciML Linked Open Data

Conformance class A.3: GeoSciML Linked Open Data

Identifier/conf/gsml-lod
Requirements class/req/gsml-lod
PrerequisiteRFC 3986
Conformance testsAbstract test A.8: /conf/gsml-lod/codelistURI
Abstract test A.9: /conf/gsml-lod/identifier
Abstract test A.10: /conf/gsml-lod/byref

Abstract test A.8

Identifier/conf/gsml-lod/codelistURI
RequirementRequirement 9: /req/gsml-lod/codelistURI
Test purpose

Ensure that the implementation check that vocabulary terms are dereferenceable URI

Test method

Visual inspection of the target implementation and check that it provides a mechanism to verify that URI are dereferenceable

Abstract test A.9

Identifier/conf/gsml-lod/identifier
RequirementRequirement 10: /req/gsml-lod/identifier
Test purpose

Ensure that the URI identifier can be dereferenced.

Test method

Visually inspect the target implementation and check that it provides a mechanism to verify that the identifier can be dereferenced and return a representation of the resource assigned to the identifier

Abstract test A.10

Identifier/conf/gsml-lod/byref
RequirementRequirement 12: /req/gsml-lod/byref
Test purpose

Ensure that for properties that reference an external resource using a HTTP URI identifier, this URI is dereferenceable.

Test method

Visual inspection of the target implementation and check that it provides a mechanism to verify that URI are dereferenceable

A.4.  GeoSciML Basic Logical Model

Conformance class A.4: GeoSciML Basic Logical Model

Identifier/conf/gsml-basic
Requirements class/req/gsml-basic
PrerequisiteConformance class A.2: /conf/gsml-core
Conformance testsAbstract test A.11: /conf/gsml-basic/geologicfeature-purpose
Abstract test A.12: /conf/gsml-basic/geologicevent-non-null
Abstract test A.13: /conf/gsml-basic/plane-pol-dip-az-not-null
Abstract test A.14: /conf/gsml-basic/linear-trend-plunge-not-null
Abstract test A.15: /conf/gsml-basic/quantity-range-order
Abstract test A.16: /conf/gsml-basic/quantity-range-repeat

Abstract test A.11

Identifier/conf/gsml-basic/geologicfeature-purpose
RequirementRequirement 13: /req/gsml-basic/geologicfeature-purpose
Test purpose

Ensure that the target implementation enforces the purpose property to be restricted to the values provided in Table 2 (instance, typicalNorm, definingNorm) of 8.4.1.1.2

Test method

Visual inspection that the target implementation has a mechanism to limit the property value to those provided in Table 2

Abstract test A.12

Identifier/conf/gsml-basic/geologicevent-non-null
RequirementRequirement 15: /req/gsml-basic/geologicevent-non-null
Test purpose

Ensure that a GeologicEvent instance has either a olderNamedAge or youngerNamedAge as a non-null value

Test method

Visual inspection that the target implementation has a mechanism to prevent a GeologicEvent to have both olderNamedAge or youngerNamedAge equals to null.

Abstract test A.13

Identifier/conf/gsml-basic/plane-pol-dip-az-not-null
RequirementRequirement 16: /req/gsml-basic/plane-pol-dip-az-not-null
Test purpose

Ensure that a GSML_PlanarOrientation instance has either polarity, azimuth or dip as a non-null value

Test method

Visual inspection that the target implementation has a mechanism to prevent a GSML_PlanarOrientation to have all polarity, azimuth or dip equal to null.

Abstract test A.14

Identifier/conf/gsml-basic/linear-trend-plunge-not-null
RequirementRequirement 17: /req/gsml-basic/linear-trend-plunge-not-null
Test purpose

Ensure that a GSML_LinearOrientation instance has either trend or plunge as a non-null value

Test method

Visual inspection that the target implementation has a mechanism to prevent a GSML_LinearOrientation to have both trend and plunge equals to null.

Abstract test A.15

Identifier/conf/gsml-basic/quantity-range-order
RequirementRequirement 18: /req/gsml-basic/quantity-range-order
Test purpose

Ensure that a GSML_QuantityRange lowerValue is less or equal to upperValue

Test method

Visual inspection that the target implementation has a mechanism to constrain lowerValue to be less or equal to upperValue.

Abstract test A.16

Identifier/conf/gsml-basic/quantity-range-repeat
RequirementRequirement 19: /req/gsml-basic/quantity-range-repeat
Test purpose

Ensure that a GSML_QuantityRange lowerValue and upperValue matches the quantities in the “value” property

Test method

Visual inspection that the target implementation has a mechanism to constrain lowerValue to match value[0] and upperValue to match value[1]

A.5.  GeoSciML Extension Logical Model

Conformance class A.5: GeoSciML Extension Logical Model

Identifier/conf/gsml-extension
Requirements class/req/gsml-extension
PrerequisiteConformance class A.4: /conf/gsml-basic
Conformance testsAbstract test A.17: /conf/gsml-extension/geologicfeature-history
Abstract test A.18: /conf/gsml-extension/contact-chronoboundary
Abstract test A.19: /conf/gsml-extension/slipComponents-slip

Abstract test A.17

Identifier/conf/gsml-extension/geologicfeature-history
RequirementRequirement 20: /req/gsml-extension/geologicfeature-history
Test purpose

Ensure that the target implementation restricts GeologicEvent describing the age of GeologicUnit to geologicHistory property

Test method

Visual inspection that the target implementation has a mechanism to limit GeologicEvent describing age of GeologicFeature to geologicHistory.

Abstract test A.18

Identifier/conf/gsml-extension/contact-chronoboundary
RequirementRequirement 21: /req/gsml-extension/contact-chronoboundary
Test purpose

Ensure that the target implementation restricts ContactDescription::correlatesWith value to an instance of GeochronologicBondary only when ContactDescription::contactType is ChronostratigraphicBoundary

Test method

Visual inspection that the target implementation has a mechanism to constrain the value of correlatesWith

Abstract test A.19

Identifier/conf/gsml-extension/slipComponents-slip
RequirementRequirement 22: /req/gsml-extension/slipComponents-slip
Test purpose

Ensure that a slipComponent has at least one of heave, horizontalSlip or throw as a non-null

Test method

Visual inspection that the target implementation has a mechanism to constrain on of heave, horizontalSlip or throw to be non-null

A.6.  GeoSciML Timescale Logical Model

Conformance class A.6: GeoSciML Timescale Logical Model

Identifier/conf/gsml-timescale
Requirements class/req/gsml-timescale
PrerequisiteConformance class A.4: /conf/gsml-basic
Conformance testAbstract test A.20: /conf/gsml-timescale/start

Abstract test A.20

Identifier/conf/gsml-timescale/start
RequirementRequirement 23: /req/gsml-timescale/start
Test purpose

Ensure that the start TimeOrdinalEraBoundary is older that the end TimeOrdinalBoundaryEra

Test method

Visual inspection that the target implementation has a mechanism to check that the age of the start TimeOrdinalEraBoundary is older than the age of the “end” TimeOrdinalEraBoundary

A.7.  GeoSciML Borehole Logical Model

Conformance class A.7: GeoSciML Borehole Logical Model

Identifier/conf/gsml-borehole
Requirements class/req/gsml-borehole
PrerequisitesConformance class A.4: /conf/gsml-basic
ISO 19156 Annex A
Conformance testsAbstract test A.21: /conf/gsml-borehole/value-intervalBegin
Abstract test A.22: /conf/gsml-borehole/drill-interval-1D
Abstract test A.23: /conf/gsml-borehole/drill-interval-1D-CRS
Abstract test A.24: /conf/gsml-borehole/value-mappedIntervalBegin
Abstract test A.25: /conf/gsml-borehole/interval-1D
Abstract test A.26: /conf/gsml-borehole/interval-1D-CRS
Abstract test A.27: /conf/gsml-borehole/borehole-position-null
Abstract test A.28: /conf/gsml-borehole/borehole-elevation-dim
Abstract test A.29: /conf/gsml-borehole/borehole-elevation-CRS

Abstract test A.21

Identifier/conf/gsml-borehole/value-intervalBegin
RequirementRequirement 24: /req/gsml-borehole/value-intervalBegin
Test purpose

Ensure that the target implementation enforces the DillingDetails::intervalBegin value is less or equal to DillingDetails::intervalEnd

Test method

Visual inspection that the target implementation has a mechanism to ensure that DillingDetails::intervalBegin is less or equal to . DillingDetails::intervalEnd

Abstract test A.22

Identifier/conf/gsml-borehole/drill-interval-1D
RequirementRequirement 25: /req/gsml-borehole/drill-interval-1D
Test purpose

Ensure that the target implementation enforces the presence a 1D geometry for DrillingDetails::interval

Test method

Visual inspection that the target implementation has a mechanism to ensure DrillingDetails::interval is a 1D geometry

Abstract test A.23

Identifier/conf/gsml-borehole/drill-interval-1D-CRS
RequirementRequirement 26: /req/gsml-borehole/drill-interval-1D-CRS
Test purpose

Ensure that the target implementation enforces DillingDetails::intervalEnd geometries CRS to be a valid vertical datum

Test method

Visual inspection that the target implementation has a mechanism to ensure that DillingDetails::intervalEnd datum is a valid vertical datum.

Abstract test A.24

Identifier/conf/gsml-borehole/value-mappedIntervalBegin
RequirementRequirement 27: /req/gsml-borehole/value-mappedIntervalBegin
Test purpose

Ensure that the target implementation enforces the BoreholeInterval::mappedIntervalBegin value is less or equal to BoreholeInterval::mappedIntervalEnd

Test method

Visual inspection that the target implementation has a mechanism to ensure that BoreholeInterval::mappedIntervalBegin is less or equal to  BoreholeInterval::mappedIntervalEnd

Abstract test A.25

Identifier/conf/gsml-borehole/interval-1D
RequirementRequirement 28: /req/gsml-borehole/interval-1D
Test purpose

Ensure that the target implementation enforces the presence a GM_LineString geometry composed of  a pair of 1D coordinates for BoreholeInterval::shape

Test method

Visual inspection that the target implementation has a mechanism to ensure BoreholeInterval::shape is a GM_LineString composed of a pair of 1D coordinates.

Abstract test A.26

Identifier/conf/gsml-borehole/interval-1D-CRS
RequirementRequirement 29: /req/gsml-borehole/interval-1D-CRS
Test purpose

Ensure that the target implementation constrain the CRS to a relevant vertical datum

Test method

Visual inspection to check that the target implementation has a mechanism to constrain the CRS to a 1D vertical datum.

Abstract test A.27

Identifier/conf/gsml-borehole/borehole-position-null
RequirementRequirement 30: /req/gsml-borehole/borehole-position-null
Test purpose

Ensure that the target implementation enforce a OGC nil when there are no GM_Point available

Test method

Visual inspection to check that the target implementation has a mechanism to constrain either a GM_Point or a OGC nil marker.

Abstract test A.28

Identifier/conf/gsml-borehole/borehole-elevation-dim
RequirementRequirement 32: /req/gsml-borehole/borehole-elevation-dim
Test purpose

Ensure that the target implementation enforces that the OriginPosition::elevation has a dimension of 1

Test method

Visual inspection to check that the target implementation has a mechanism to constrain OriginPosition::elevation coordinate to have a single dimension

Abstract test A.29

Identifier/conf/gsml-borehole/borehole-elevation-CRS
RequirementRequirement 33: /req/gsml-borehole/borehole-elevation-CRS
Test purpose

Ensure that the target implementation enforces the Origin::elevation geometry CRS to be a valid 1D vertical datum

Test method

Visual inspection to check that the target implementation has a mechanism to constrain OriginPosition::elevation CRS to a value in the range EPSG:5600 to EPSG:5799

A.8.  GeoSciML LaboratoryAnalysis-Specimen Logical Model

Conformance class A.8: GeoSciML LaboratoryAnalysis-Specimen Logical Model

Identifier/conf/gsml-lab-analysis
Requirements class/req/gsml-lab-analysis
PrerequisitesConformance class A.4: /conf/gsml-basic
ISO 19156 Annex A
Conformance testsAbstract test A.30: /conf/gsml-lab-analysis/sampledFeature
Abstract test A.31: /conf/gsml-lab-analysis/accuracy-measure
Abstract test A.32: /conf/gsml-lab-analysis/accuracy-vocabulary

Abstract test A.30

Identifier/conf/gsml-lab-analysis/sampledFeature
RequirementRequirement 34: /req/gsml-lab-analysis/sampledFeature
Test purpose

Ensure that the SF_SamplingFeature::sampledFeature is not an instance of SF_SamplingFeature

Test method

Verify that the target implementation has a mechanism to prevent sampledFeature target to be an instance of SF_SamplingFeature or any of its subtypes.

Abstract test A.31

Identifier/conf/gsml-lab-analysis/accuracy-measure
RequirementRequirement 35: /req/gsml-lab-analysis/accuracy-measure
Test purpose

Ensure that DQ_Element::nameOfMeasure and ::result are not null

Test method

Verify that the target implementation has a mechanism to enforce a non-null value for DQ_Element::nameOfMeasure and DQ_Element::result

Abstract test A.32

Identifier/conf/gsml-lab-analysis/accuracy-vocabulary
RequirementRequirement 36: /req/gsml-lab-analysis/accuracy-vocabulary
Test purpose

Ensure that nameOfMeasure is a term from a controlled vocabulary

Test method

Visually check target implementation for the presence of the mechanism that verifies that the nameOfMeasure is a term from a controlled vocabulary

A.9.  GeoSciML Lite Logical

Abstract test A.33

Identifier/conf/gsml-lite/geomtype
RequirementRequirement 37: /req/gsml-lite/geomtype
Test purpose

Ensure that the target implementation only allow a single geometry per instance

Test method

Visual inspection that the target implementation has a mechanism to limit a single geometry per instance

Abstract test A.34

Identifier/conf/gsml-lite/string
RequirementRequirement 38: /req/gsml-lite/string
Test purpose

Ensure that human readable strings are allowed in all properties of type CharacterString

Test method

Visual inspection that the target implementation does not prevent human readable string (by ensuring that property data types are used)

Abstract test A.35

Identifier/conf/gsml-lite/datetime
RequirementRequirement 39: /req/gsml-lite/datetime
Test purpose

Ensure that all representation of date and time uses ISO8601

Test method

Visual inspection that the target implementation has mechanism or rules to enforce the usage of ISO8601 date and time

Abstract test A.36

Identifier/conf/gsml-lite/uri
RequirementRequirement 40: /req/gsml-lite/uri
Test purpose

Ensure that all properties ending in URI contain a URI

Test method

Check that the target implementation enforces the content to RFC 3986

Abstract test A.37

Identifier/conf/gsml-lite/user-defined
RequirementRequirement 41: /req/gsml-lite/user-defined
Test purpose

Ensure that user defined properties conform to GML Simple Feature Level 0

Test method

Check that the target implementation enforces user defined properties to be conform to GML Simple Feature Level 0

Abstract test A.38

Identifier/conf/gsml-lite/identifier-unique
RequirementRequirement 42: /req/gsml-lite/identifier-unique
Test purpose

Ensure that the identifier is unique for the dataset

Test method

Check that the target implementation implement a unique key constrain or mechanism to ensure that identifier property is unique.

Abstract test A.39

Identifier/conf/gsml-lite/identifier-uri
RequirementRequirement 43: /req/gsml-lite/identifier-uri
Test purpose

Ensure that the identifier field is formatted as a URI

Test method

Check that the target implementation implement a formatting constraint on the identifier field that check its compliance to RFC3986

Abstract test A.40

Identifier/conf/gsml-lite/geologicunitview-representativeLithology
RequirementRequirement 44: /req/gsml-lite/geologicunitview-representativeLithology
Test purpose

Ensure that the geologic unit view representative lithology come from a controlled vocabulary

Test method

Check that the target implementation implements a mechanism to ensure that the term comes from a controlled vocabulary

Abstract test A.41

Identifier/conf/gsml-lite/geologicunitview-representativeAge
RequirementRequirement 45: /req/gsml-lite/geologicunitview-representativeAge
Test purpose

Ensure that the geologic unit view representative age come from a controlled vocabulary

Test method

Check that the target implementation implements a mechanism to ensure that the term comes from a controlled vocabulary

Abstract test A.42

Identifier/conf/gsml-lite/geologicunitview-representativeOlderAge
RequirementRequirement 46: /req/gsml-lite/geologicunitview-representativeOlderAge
Test purpose

Ensure that the geologic unit view representative older age come from a controlled vocabulary

Test method

Check that the target implementation implements a mechanism to ensure that the term comes from a controlled vocabulary

Abstract test A.43

Identifier/conf/gsml-lite/geologicunitview-representativeYoungerAge
RequirementRequirement 47: /req/gsml-lite/geologicunitview-representativeYoungerAge
Test purpose

Ensure that the geologic unit view representative older age come from a controlled vocabulary

Test method

Check that the target implementation implements a mechanism to ensure that the term comes from a controlled vocabulary

Abstract test A.44

Identifier/conf/gsml-lite/boreholeview-elevation-srs
Requirement/req/gsml-lite/boreholeview-elevation-srs
Test purpose

Ensure that the elevation is using a valid SRS

Test method

Check that the target implementation implements a proper CRS reference to a EPSG vertical datum

Abstract test A.45

Identifier/conf/gsml-lite/contactview-contacttype
Requirement/req/gsml-lite/contactview-contacttype
Test purpose

Ensure that the contact’s contact type come from a controlled vocabulary

Test method

Check that the target implementation implements mechanism to ensure that the term comes from a controlled vocabulary.

Abstract test A.46

Identifier/conf/gsml-lite/siteobservationview-symbolRotation
RequirementRequirement 49: /req/gsml-lite/siteobservationview-symbolRotation
Test purpose

Ensure that the symbol rotation is the range [0,360]

Test method

Check that the target implementation implements mechanism to ensure that the rotation is in the range [0,360]


Annex B
(informative)
Abbreviations and Acronyms

EarthResourceML: Earth Resource Markup Language (www.earthresourceml.org)

INSPIRE: The INSPIRE Directive of the European Union was begun in May 2007 to establish an infrastructure for spatial information in Europe to support Community environmental policies (http://inspire.ec.europa.eu/)

IUGS: International Union of Geological Sciences (www.iugs.org)

IUGS CGI: International Union of Geological Sciences, Commission for the Management and Application of Geoscience Information (www.cgi-iugs.org)

GeoSciML: Geoscience Markup Language (link:http://www.geosciml.org/www.geosciml.org])

GWML: GroundWater Markup Language

RDBMS: Relational database management system

UCUM: Unified Code for Units of Measure (link:http://unitsofmeasure.org/ucum.htmlhttp://unitsofmeasure.org/ucum.html])


Annex C
(informative)
Revision History

Table C.1

DateReleaseEditorPrimary clauses modifiedDescription
2016-04-280.1G. Editorallinitial version

Bibliography

NOTE:  The TC has approved Springer LNCS as the official document citation type.

Springer LNCS is widely used in technical and computer science journals and other publications

– Actual References:

[n] Journal: Author Surname, A.: Title. Publication Title. Volume number, Issue number, Pages Used (Year Published)

[1]  OGC: OGC Testbed 12 Annex B: Architecture (2015).