Approved

OGC Standard

OGC WaterML 2: Part 4 - GroundWaterML 2 (GWML2)
Boyan Brodaric Editor
Version: 2.2.1
Additional Formats: XML PDF DOC
OGC Standard

Approved

Document number:16-032r3
Document type:OGC Standard
Document subtype:Implementation
Document stage:Approved
Document language:English

 


License Agreement

Permission is hereby granted by the Open Geospatial Consortium, (“Licensor”), free of charge and subject to the terms set forth below, to any person obtaining a copy of this Intellectual Property and any associated documentation, to deal in the Intellectual Property without restriction (except as set forth below), including without limitation the rights to implement, use, copy, modify, merge, publish, distribute, and/or sublicense copies of the Intellectual Property, and to permit persons to whom the Intellectual Property is furnished to do so, provided that all copyright notices on the intellectual property are retained intact and that each person to whom the Intellectual Property is furnished agrees to the terms of this Agreement.

If you modify the Intellectual Property, all copies of the modified Intellectual Property must include, in addition to the above copyright notice, a notice that the Intellectual Property includes modifications that have not been approved or adopted by LICENSOR.

THIS LICENSE IS A COPYRIGHT LICENSE ONLY, AND DOES NOT CONVEY ANY RIGHTS UNDER ANY PATENTS THAT MAY BE IN FORCE ANYWHERE IN THE WORLD. THE INTELLECTUAL PROPERTY IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE DO NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE INTELLECTUAL PROPERTY WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION OF THE INTELLECTUAL PROPERTY WILL BE UNINTERRUPTED OR ERROR FREE. ANY USE OF THE INTELLECTUAL PROPERTY SHALL BE MADE ENTIRELY AT THE USER’S OWN RISK. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR ANY CONTRIBUTOR OF INTELLECTUAL PROPERTY RIGHTS TO THE INTELLECTUAL PROPERTY BE LIABLE FOR ANY CLAIM, OR ANY DIRECT, SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM ANY ALLEGED INFRINGEMENT OR ANY LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR UNDER ANY OTHER LEGAL THEORY, ARISING OUT OF OR IN CONNECTION WITH THE IMPLEMENTATION, USE, COMMERCIALIZATION OR PERFORMANCE OF THIS INTELLECTUAL PROPERTY.

This license is effective until terminated. You may terminate it at any time by destroying the Intellectual Property together with all copies in any form. The license will also terminate if you fail to comply with any term or condition of this Agreement. Except as provided in the following sentence, no such termination of this license shall require the termination of any third party end-user sublicense to the Intellectual Property which is in force as of the date of notice of such termination. In addition, should the Intellectual Property, or the operation of the Intellectual Property, infringe, or in LICENSOR’s sole opinion be likely to infringe, any patent, copyright, trademark or other right of a third party, you agree that LICENSOR, in its sole discretion, may terminate this license without any compensation or liability to you, your licensees or any other party. You agree upon termination of any kind to destroy or cause to be destroyed the Intellectual Property together with all copies in any form, whether held by you or by any third party.

Except as contained in this notice, the name of LICENSOR or of any other holder of a copyright in all or part of the Intellectual Property shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Intellectual Property without prior written authorization of LICENSOR or such copyright holder. LICENSOR is and shall at all times be the sole entity that may authorize you or any third party to use certification marks, trademarks or other special designations to indicate compliance with any LICENSOR standards or specifications. This Agreement is governed by the laws of the Commonwealth of Massachusetts. The application to this Agreement of the United Nations Convention on Contracts for the International Sale of Goods is hereby expressly excluded. In the event any provision of this Agreement shall be deemed unenforceable, void or invalid, such provision shall be modified so as to make it valid and enforceable, and as so modified the entire Agreement shall remain in full force and effect. No decision, action or inaction by LICENSOR shall be construed to be a waiver of any rights or remedies available to it.

None of the Intellectual Property or underlying information or technology may be downloaded or otherwise exported or reexported in violation of U.S. export laws and regulations. In addition, you are responsible for complying with any local laws in your jurisdiction which may impact your right to import, export or use the Intellectual Property, and you represent that you have complied with any regulations or registration procedures required by applicable law to make this license enforceable.

Suggested additions, changes and comments on this standard are welcome and encouraged. Such suggestions may be submitted using the online change request form on OGC web site: http://portal.opengeospatial.org/public_ogc/change_request.php

 



I.  Abstract

This standard describes a conceptual and logical model for the exchange of groundwater data, as well as a GML/XML encoding with examples.

II.  Keywords

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

ogcdoc, OGC document, groundwater, hydrogeology, aquifer, water well, observation, well construction, groundwater flow, groundwater monitoring, UML, GML, GroundwaterML, GWML2


III.  Preface

III.A.  Motivation

A significant portion of the global water supply can be attributed to groundwater resources. Effective management of such resources requires the collection, management and delivery of related data, but these are impeded by issues related to data availability, distribution, fragmentation, and heterogeneity: collected data are not all readily available and accessible, available data is distributed across many agencies in different sectors, often thematically fragmented, and similar types of data are diversely structured by the various data providers. This situation holds both within and between political entities, such as countries or states, impairing groundwater management across all jurisdictions. Groundwater data networks are an emerging solution to this problem as they couple data providers through a unified data delivery vehicle, thus reducing or eliminating distribution, fragmentation, and heterogeneity through the incorporation of standards for data access and data content. The relative maturity of OGC data access standards, such as the Web Feature Service (WFS) and Sensor Observation Service (SOS), combined with the rise of water data networks, have created a need for GroundWaterML2 (GWML2), a common groundwater data standard.

III.B.  Historical background

Several activities have influenced the development of GWML2.

  • GWML1: a GML application schema for groundwater data developed at Natural Resources Canada and used to exchange groundwater data within Canada, between Canada and the USA, and in some other international efforts (Boisvert & Brodaric, 2012).

  • GWIE1: an interoperability experiment within the OGC HDWG, in which groundwater data was shared across the USA-Canada border (Brodaric & Booth, 2011).

  • GW2IE: a second interoperability experiment within the OGC HDWG, that designed and tested a precursor of GroundWaterML2 (GWML2, version 2.1): a conceptual, logical, and encoding specification for the representation of core groundwater data (OGC, 2016).

  • INSPIRE Data Specification on Geology — hydrogeology package: a conceptual model and GML application schema for hydrogeology (INSPIRE, 2013), with regulatory force in the European Union and for which GWML2 is expected to be an encoding candidate.

  • BDLISA: the French Water Information System information models for water wells and hydrogeological features (BDLISA, 2013).

The primary goal of this standard is to capture the semantics, schema, and encoding syntax of key groundwater data, 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):

VI.  Submitters

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

Table 1

Name Affiliation
Boyan Brodaric GSC
Eric Boisvert GSC
Francois Létourneau GSC
Jessica Lucido USGS
Bruce Simons CSIRO
Peter Dahlhaus FedUni
Mickaël Beaufils BRGM
Sylvain Grellet BRGM
Laurence Chery BRGM
Alexander Kmoch U Salzburg

OGC WaterML 2: Part 4 - GroundWaterML 2 (GWML2)

1.  Scope

This document is an OGC® conceptual, logical and encoding standard for GWML2, which represents key groundwater data. GWML2 is implemented as an application schema of the Geography Markup Language (GML) version 3.2.1, and re-uses entities from other GML application schema, most notably the OGC Observations & Measurements standard and the OGC/IUGS GeoSciML 4.0 (16-008) standard. GWML2 version 2.2 (this document) updates version 2.1, which was developed by the GW2IE (OGC, 2016), by importing GeoSciML 4.0 instead of GeoSciML 3.2.0, and by using TimeseriesML (15-042r3) instead of OGC WaterML2.0 part 1 — Timeseries.

GWML2 is designed to enable a variety of data exchange scenarios. These scenarios are captured by its five motivating use cases, including:

  1. a commercial use-case focused on drilling water wells with knowledge of aquifers,

  2. a policy use case concerned with the management of groundwater resources,

  3. an environmental use-case that considers the role of groundwater in natural eco-systems,

  4. a scientific use-case concerned with modeling groundwater systems, and

  5. a technologic use-case concerned with interoperability between diverse information systems and associated data formats.

GWML2 is designed in three stages, each consisting of a schema that builds on the previous stages. The three schemas include:

  1. Conceptual (UML): a technology-neutral schema denoting the semantics of the domain,

  2. Logical (UML): a GML-specific schema that incorporates the OGC suite of standards,

  3. XML schema (XSD): a GML syntactical encoding of the logical schema.

In addition, this standard describes general and XML-specific encoding requirements, general and XML-specific conformance tests, and XML encoding examples. The standard is designed for future extension into other non-XML encoding syntaxes, which would require each such encoding to describe the related schema, requirements and conformance classes, as well as provide examples.

The GWML2 Logical and XML schemas are organized into 6 modular packages:

  1. GWML2-Main: core elements such as aquifers, their pores, and fluid bodies,

  2. GWML2-Constituent: the biologic, chemical, and material constituents of a fluid body,

  3. GWML2-Flow: groundwater flow within and between containers,

  4. GWML2-Well: water wells, springs, and monitoring sites,

  5. GWML2-WellConstruction: the components used to construct a well,

  6. GWML2-AquiferTest: the elements comprising an aquifer test (e.g., a pumping test).

Altogether, the schemas and packages represent a machine-readable description of the key features associated with the groundwater domain, as well as their properties and relationships. This provides a semantics and syntax for the correct machine interpretation of the data, which promotes proper use of the data in further analysis. Existing systems can use GWML2 to ‘bridge’ between existing schema or systems, allowing consistency of the data to be maintained and enabling interoperability.

2.  Conformance

This standard has been written to be compliant with the OGC Specification Model — A Standard for Modular Specification (08-131r3). Extensions of this standard shall themselves be conformant to the OGC Specification Model.

2.1.  XML implementation

The XML implementation (encoding) of the conceptual and logical groundwater schemas is described using the XML Schema language and Schematron.

Requirements for one standardization target type are considered:

  • data instances.

i.e., XML documents that encode groundwater data. As data producing applications should generate conformant data instances, the requirements and tests described in this standard effectively also apply to that target.

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 ISO 19105: Geographic information — Conformance and Testing. In order to conform to this OGC encoding standard, a standardization target shall implement the core conformance class, and choose to implement any one of the other conformance classes (i.e., extensions).

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

2.2.  Use of vocabularies

Controlled vocabularies, also known as code-lists, are used in data exchange to identify particular concepts or terms, and sometimes relationships between them. For example, an organization may define a controlled vocabulary for all observed phenomena, such as water quality parameters, that are to be exchanged between parties. Some of these definitions may be related by hierarchical relationships, such as specialization, or through other relationships such as equivalence.

GroundWaterML2.0 does not define a set of vocabularies for groundwater data exchange in this version. It is envisaged that specific communities will develop local vocabularies for data exchange within the community. Future work within the Hydrology Domain Working Group could address standardized controlled vocabularies for the groundwater domain. Such vocabularies require a governance structure that allows changes to be made as definitions evolve, possibly using the OGC definition namespace (http://www.opengis.net/def/gwml/2.2), which is governed by the OGC Naming Authority (OGC-NA). The OGC-NA is responsible for processing requests to change or add new definitions to this namespace. The procedures for the OGC-NA are outlined in OGC document 09-046 (OGC-NA – Procedures) and the structure of URIs is outlined in OGC 09-048 (OGC-NA – Name type specification – definitions). Any URIs for vocabulary items (e.g. identifiers for various property values, properties, roles or other fixed labels) in this specification are included as examples only, for illustration purposes, and will not resolve, because GWML2 vocabularies are not defined. However, some such URIs in various example encodings may resolve if data providers have defined and implemented vocabularies for particular services.

The following convention has been used throughout the document to identify attributes requiring controlled vocabularies:

  • In the conceptual model, such attributes are typed with a name ending by Type (ex: PorosityType); and

  • In the logical model this suffix becomes TypeTerm (ex: PorosityTypeTerm).

2.3.  Groundwater data

Groundwater data conforming to this standard are encoded in GML-conformant XML documents, for this version of GWML2. It is anticipated that future versions or extensions will develop additional encodings such as JSON or RDF. The standard MIME-type and sub-type for GML data should be used to indicate the encoding choice as specified in MIME Media Types for GML, namely: application/gml+xml.

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 site1.

In order to conform to this OGC™ interface standard, a software implementation shall choose to implement:

  1. Any one of the conformance levels specified in Annex A (normative).

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.

James Tomkins , Dominic Lowe : OGC 15-043r3, Timeseries Profile of Observations and Measurements . Open Geospatial Consortium (2016). https://docs.ogc.org/is/15-043r3/15-043r3.html

Policy SWG: OGC 08-131r3, The Specification Model — Standard for Modular specifications. Open Geospatial Consortium (2009). https://portal.opengeospatial.org/files/?artifact_id=34762&version=2

Peter Taylor: OGC 10-126r4, OGC® WaterML 2.0: Part 1- Timeseries. Open Geospatial Consortium (2014). https://portal.opengeospatial.org/files/?artifact_id=57222

James Tomkins and Dominic Lowe: OGC 15-042r3, TimeseriesML 1.0 – XML Encoding of the Timeseries Profile of Observations and Measurements. Open Geospatial Consortium (2016). https://docs.ogc.org/is/15-042r3/15-042r3.html

Boyan Brodaric: OGC 15-082, OGC GroundWaterML 2 – GW2IE FINAL REPORT. Open Geospatial Consortium (2016). https://portal.opengeospatial.org/files/?artifact_id=64688

GeoSciML Modeling Team: OGC 16-008, OGC Geoscience Markup Language 4.1 (GeoSciML). Open Geospatial Consortium (2017). https://docs.ogc.org/is/16-008/16-008.html

Arliss Whiteside Jim Greenwood : OGC 06-121r9, OGC Web Service Common Implementation Specification. Open Geospatial Consortium (2010). https://portal.opengeospatial.org/files/?artifact_id=38867

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 19123:2005, Geographic information — Schema for coverage geometry and functions. International Organization for Standardization, Geneva (2005). https://www.iso.org/standard/40121.html

ISO: ISO/TS 19139:2007, Geographic information — Metadata — XML schema implementation. International Organization for Standardization, Geneva (2007). https://www.iso.org/standard/32557.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 8601:2004, Data elements and interchange formats — Information interchange — Representation of dates and times. International Organization for Standardization, Geneva (2004). https://www.iso.org/standard/40874.html

Simon Cox: OGC 10-004r3, Topic 20: Observations and Measurements. Open Geospatial Consortium (2010). https://portal.opengeospatial.org/files/?artifact_id=41579

Roger Lott: OGC 08-015r2, Topic 2 — Spatial referencing by coordinates. Open Geospatial Consortium (2010). https://portal.opengeospatial.org/files/?artifact_id=39049

OGC: OGC 07-011, Topic 6 — Schema for coverage geometry and functions. Open Geospatial Consortium (2007). https://portal.opengeospatial.org/files/?artifact_id=19820

ISO: OGC 01-111, Topic 11 — Metadata. Open Geospatial Consortium (2001). http://www.iso.org/iso/en/CatalogueDetailPage.CatalogueDetail?CSNUMBER=26020

Clemens Portele: OGC 07-036r1, OpenGIS Geography Markup Language (GML) Encoding Standard — with corrigendum. Open Geospatial Consortium (2018). https://portal.opengeospatial.org/files/?artifact_id=74183&version=2

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

Simon Cox: OGC 10-025r1, Observations and Measurements — XML Implementation. Open Geospatial Consortium (2011). https://portal.opengeospatial.org/files/?artifact_id=41510

Alexandre Robin: OGC 08-094r1, OGC® SWE Common Data Model Encoding Standard. Open Geospatial Consortium (2011). https://portal.opengeospatial.org/files/?artifact_id=41157

Simon Cox: OGC 06-188r1, GML Encoding of Discrete Coverages (interleaved pattern). Open Geospatial Consortium (2007). https://portal.opengeospatial.org/files/?artifact_id=20794

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

Mike Botts, Alexandre Robin, Eric Hirschorn: OGC 12-000r2, OGC SensorML: Model and XML Encoding Standard. Open Geospatial Consortium (2020). https://docs.ogc.org/is/12-000r2/12-000r2.html

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

OMG UML 2.3, Unified Modeling Language. (2010). https://www.omg.org/spec/UML/2.3/

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

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

4.  Terms and definitions

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

This document uses the terms defined in 06-121r9, Clause 5.3, 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 standard.

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.

4.1. 

coverage

Feature that acts as a function to return values from its range for any direct position within its spatial, temporal or spatiotemporal domain.

[SOURCE: ISO 19123:2005, Clause 4.17]

4.2. 

domain feature

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, Clause 4.4]

4.3. 

element <XML>

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

Note 1 to entry: From the XML Information Set ― each XML document contains one or more elements, the boundaries of which are either delimited by start-tags and end-tags, or, for empty elements, by an empty-element tag. Each element has a type, identified by name, sometimes called its “generic identifier” (GI), and may have a set of attribute specifications. Each attribute specification has a name and a value.

[SOURCE: ISO 19136:2007]

4.4. 

feature

Abstraction of a real-world phenomena.

[SOURCE: ISO 19101-1:2014, Clause 4.11]

4.5. 

GML application schema

Application schema written in XML Schema in accordance with the rules specified in ISO 19136:2007.

[SOURCE: ISO 19136:2007]

4.6. 

GML document

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: ISO 19136:2007]

4.7. 

GML schema

Schema components in the XML namespace http://www.opengis.net/gml/3.2 as specified in ISO 19136:2007.

[SOURCE: ISO 19136:2007]

4.8. 

measurement

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

[SOURCE: ISO 19101-2, Clause 4.20]

4.9. 

observation

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: ISO 19156:2011, Clause 4.10]

4.10. 

observation procedure

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

[SOURCE: ISO 19156:2011, Clause 4.11]

4.11. 

observation result

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

[SOURCE: ISO 19156:2011]

4.12. 

property <General Feature Model>

Facet or attribute of an object referenced by a name.

Example

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

4.13. 

sampled feature

The real-world domain feature of interest, such as a groundwater body, aquifer, river, lake, or sea, which is observed.

[SOURCE: ISO 19156:2011]

4.14. 

sampling feature

Feature, such as a station, transect, 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, Clause 4.16]

4.15. 

schema <XML Schema>

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: ISO 19136:2007]

4.16. 

sensor

Type of observation procedure that provides the estimated value of an observed property at its output.

Note 1 to entry: A sensor uses a combination of physical, chemical or biological means in order to estimate the underlying observed property. At the end of the measuring chain electronic devices often produce signals to be processed.

5.  Contributing organizations

The organizations that submitted this standard are listed in Section iv.

The following organizations contributed to the initiation or development of this standard:

6.  Conventions

6.1.  Requirements class

Each normative statement (requirement or recommendation) in this standard 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:

Table 2

Requirements Class: [label]
/req/{classM}
Obligationrequirement
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 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.

6.2.  Requirement

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

Table 3

Requirement [serial number]:
/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 standard to be easily located by implementers.

6.3.  Conformance class

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

Table 4

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 standard, 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="origin_elevation">

<title>Test requirement: /req/well-xsd/origin-elevation</title>

<rule context="gwml2w:GW_Well">

<assert test="count(gwml2w:gwWellReferenceElevation/gwml2w:Elevation[gwml2w:elevationType/@xlink:href='http://www.opengis.net/req/well/origin_elevation']) = 1">A GW_Well needs at least one origin Elevation</assert>

</rule>

</pattern>

6.4.  Identifiers

Each requirements class, requirement and recommendation is identified by a URI. The identifier supports cross-referencing of class membership, dependencies, and links from each conformance test to the requirements tested. In this standard, 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/groundwaterml/2.2/req/[classM].

The URI for each requirement or recommendation has the form:

http://www.opengis.net/spec/groundwaterml/2.2/req/[classM]/[reqN].

The URI for each conformance class has the form:

http://www.opengis.net/spec/groundwaterml/2.2/conf/[classM].

The URI for each conformance test has the form:

http://www.opengis.net/spec/groundwaterml/2.2/conf/[classM]/[testN].

6.5.  External package abbreviations

Concepts from schemas defined in some other International Standards are designated with names that start with alpha codes as follow:

Table 5

GFISO 19109:2005 General Feature Model
GFIISO 19156:2011 General Feature Model Instances
TMISO 19108:2002 Temporal Schema, Temporal Objects
MDISO 19115 Metadata
CVISO 19123:2005 Schema for Coverage Geometry and Functions
OMISO 19156:2011 Observations and Measurements
DQISO 19157:201X Data Quality
WML2OGC® WaterML 2.0: Part 1- Timeseries
GWGroundwaterML 2.0
TSTimeseriesML

6.6.  Abbreviated terms

In this document the following abbreviations and acronyms are used or introduced:

Table 6

APIApplication Program Interface
GeoSciML 3.2GeoScience Mark-up Language version 3.2
GeoSciML 4.0GeoScience Mark-up Language version 4.0
GMLOGC Geography Mark-up Language
GWML1Groundater Markup Language version 1.0 (Natural Resources Canada)
GWML2Groundwater Markup Language version 2.0 (this standard)
GWML2-MainUML Logical Model of the primary GroundWaterML2 elements (namespace http://www.opengis.net/gwml-main/2.2)
GWML2-FlowUML Logical Model of the elements required to capture groundwater flow (namespace http://www.opengis.net/gwml-flow/2.2)
GWML2-ConstituentUML Logical Model of the groundwater fluid body constituents and their relationships (namespace http://www.opengis.net/gwml-constituent/2.2)
GWML2-WellUML Logical Model of the features and properties associated with water well (namespace http://www.opengis.net/gwml-well/2.2)
GWML2-WellConstructionUML Logical Model of the well drilling and construction details (namespace http://www.opengis.net/gwml-wellconstruction/2.2)
GWML2-AquiferTestUML Logical Model of the features and properties associated with aquifer test (namespace http://www.opengis.net/gwml-aquifertest/2.2)
INSPIREInfrastructure for Spatial Information in the European Community (Directive 2007/2/EC)
ISOInternational Organization for Standardization
IUGSInternational Union of Geological Sciences
NACSNNorth American Commission on Stratigraphic Nomenclature
NADMNorth American geological Data Model
OGCOpen Geospatial Consortium
O&MOGC Observations and Measurements Conceptual Model
OMXMLObservations and Measurements XML Implementation
SensorMLSensor Model Language
SOSSensor Observation Service
SWESensor Web Enablement
TSMLTimeseriesML
UMLUnified Modeling Language
UTCCoordinated Universal Time
URIUniversal Resource Identifier
URLUniversal Resource Locator
WML2WaterML 2.0 — Part 1
XMLExtensible Markup Language
XSDW3C XML Schema Definition Language

6.7.  UML notation

The diagrams that appear in this standard, including the GWML2 Conceptual and Logical schemas, are presented using the Unified Modeling Language (UML), in compliance with ISO/IEC 19505-2.

Note: Within the GWML2 conceptual and logical diagrams, the following color scheme is used to identify packages in some cases. This is just for information purposes.

Amber: GWML2 defined within this standard

Green and Purple: from GeoSciML 4.0

Blue: from O&M

6.8.  Finding requirements and recommendations

This standard is identified as http://www.opengis.net/spec/groundwaterml/2.2. For clarity, each normative statement in this standard is in one and only one place, and defined within a requirements class table and identified with a URI, whose root is the standard URI. In this standard, all requirements are associated to tests in the abstract test suite in Annex A. using the URL of the requirement as the reference identifier. Recommendations are not tested but are assigned URLs and are identified using the ‘Recommendation’ label in the associated requirements table.

Requirements classes are separated into their own clauses, named, and specified according to inheritance (direct dependencies). The Conformance test classes in the test suite are similarly named to establish an explicit and mnemonic link between requirements classes and conformance test classes.

7.  Background

7.1.  Technical Basis

This standard builds on a number of standards for encoding XML data, including:

This standard also builds on existing schema, primarily Observations & Measurements (OMXML) and GeoSciML 4.0 (16-008). It accomplishes this by (a) extending these schemas with groundwater specializations, (b) referring to a class in these schema in order to type a named property, or © using a class from the schemas as one of the two participants in a binary relationship.

7.2.  Overview of Observations & Measurements

ISO 19156:2011 — Observations and Measurements is a generic GML schema for observations. As shown in Figure 1, it defines an observation as “…​an act associated with a discrete time instant or period through which a number, term or other symbol is assigned to a phenomenon. It involves application of a specified procedure, such as a sensor, instrument, algorithm or process chain. The procedure may be applied in-situ, remotely, or ex-situ with respect to the sampling location. The result of an observation is an estimate of the value of a property of some feature.

7.2.1.  Sampling features

Sampling features in O&M are defined as a “feature, such as a station, transect, section or specimen, which is involved in making observations concerning a domain feature.” Sampling features in the groundwater domain are features along which, or upon, observations are made. The most relevant are water wells and boreholes, which effectively host observations along staged intervals; a collection of these intervals and their observations constitutes a log.

image

Figure 1 — Observation in O&M (from ISO 19156:2011)

7.3.  Overview of GeoSciML 4.0

GeoSciML 4.0 is a GML schema for core geological entities including geological units, structures, and earth materials. It is particularly relevant to GWML2 because bodies of rock serve as containers for subsurface water bodies. Such rock bodies possess variable hydrogeologic properties according to their material composition and topological organization. Thus, geological units and earth materials are the key GeoSciML 4.0 entities required by GWML2.

GeoSciML 4.0 defines a geological unit as “a body of material in the Earth whose complete and precise extent is inferred to exist (NADM GeologicUnit, Stratigraphic unit in sense of NACSN or International Stratigraphic Code), 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’).

GeoSciML 4.0 defines an earth material as “naturally occurring substance in the Earth” and intuitively refers to various types of rocks such as sandstone, granite, and gneiss.

8.  Conceptual Model

The GWML2 conceptual model is designed to be technology-neutral, and focused on the semantics of the groundwater domain. It consists of five components, as well as related properties and other entities: hydrogeological units, fluid bodies, voids, fluid flow, and wells. Conceptually, these entities form a simple template for a subsurface water container: the fluid container (a unit or its materials), the fluid itself (fluid body), the spaces in the container occupied by the fluid (void), the flow of fluid within and between containers and their spaces (flow), and the natural and artificial artifacts used to withdraw, inject, or monitor fluid with respect to a container (wells, springs, monitoring sites).

Well construction details are excluded from the conceptual model, but are included in the logical model for two reasons: (1) thematic, inasmuch as well construction was considered on the periphery of groundwater science, but important to resource management as well as important to significant data exchange scenarios, and (2) practical, as it is sufficiently modeled in GWML1 and could thus be directly imported with few changes. This eliminates the need for its re-conceptualization in the GWML2 conceptual model, keeping it tightly focused.

8.1.  Hydrogeological Units

These are distinct volumes of earth material that serve as containers for subsurface fluids. The boundaries of a unit are typically discriminated from those of another unit using properties related to the potential or actual ability to contain or move water. The properties can be geological or hydraulic, and typically include influences from the surrounding hydrological environment. More specifically, the conceptual model delineates two types of hydrogeological units, with slightly different orientations: aquifer-related units have boundaries delimited by the hydrogeological properties of the rock body, while groundwater basins have boundaries delimited by distinct flow regimes. Aquifer-related units are subdivided into aquifer systems, which are collections of aquifers, confining beds, and other aquifer systems. Confining beds are units that impede water flow to surrounding units, and supersede notions such as aquitards, aquicludes, and aquifuges, which are not included herein, as it is difficult to differentiate these in practice.

Several significant properties are typically attributed to hydrogeological units, such as porosity, permeability, and conductivity, but these and others are modeled more accurately here as occurring necessarily concurrent with (dependent on) voids or fluid bodies. For example, porosity, in its various forms, requires both the presence of a unit (container) and its voids, as it is typically defined as the proportion of void volume to total unit volume (i.e., volume of solid material plus voids). Likewise, properties such as hydraulic conductivity and yield require the presence of units and fluid bodies, as they are concerned with the rate of movement of a fluid through a unit. Note that permeability and hydraulic conductivity are differentiated here: permeability refers to intrinsic permeability, which measures the ability of a unit to host fluid flow, independent of fluid properties and based solely on the connectivity and size of voids, whereas hydraulic conductivity additionally considers fluid properties.

Likewise, management areas are also relational entities in the sense that they are typically necessarily linked with a unit (or system) and possibly a fluid body. Management areas are earth bodies identified for groundwater management purposes and their boundaries can be delineated by social factors, such as policy or regulation, in addition to physical factors related to hydrogeology or hydrology.

8.2.  Fluid Bodies

These are distinct bodies of fluid (liquid or gas) that fill the voids in hydrogeological units. Fluid bodies are made of biologic (e.g., organisms), chemical (e.g., solutes), or material constituents (e.g., sediment). While it is expected that the major constituent of a fluid body will be water, the conceptual model allows for other types of major constituents such as petroleum. Minor constituents are not necessarily fluids, but can be gases, liquids, or solids (including organisms), and are included in the fluid body in various forms of mixture, such as solution, suspension, emulsion, and precipitates. Fluid bodies can also have other fluid bodies as parts, such as plumes or gas bubbles. Surfaces can be identified on a fluid body, such as a water table, piezometric or potentiometric surface, and some such surfaces can contain divides, which are lines projected to the fluid surface denoting divergence in the direction of flow systems within the fluid.

8.3.  Voids

Voids are the spaces inside a unit (e.g., aquifer) or its material (e.g., the sandstone material of an aquifer), and might contain fluid bodies. Voids are differentiated from porosity, in that porosity is a ratio of void volume to total volume of unit plus voids, while voids are the spaces themselves. It is important to conceptually differentiate voids from units and their containers, in order to represent, for example, the volume of fractures, caves, or pores in a particular unit or its portion.

8.4.  Flow

Groundwater flow denotes the process by which a fluid enters or exits a container (unit) or its voids, or flows within them. Flow between one container or void and another is named InterFlow, and flow within a container or void is named IntraFlow. Recharge is the flow into a groundwater container or void, and discharge is flow out of a groundwater container or void. The reciprocal source or destination entity can be any appropriate container or void such as a river, lake, pipe, reservoir, canyon, flood plain, ground surface, etc. A flow system is then a collection of flows ordered in a sequence from recharge to discharge, such that the flow segments of the system make up a connected flow path from source to destination. A water budget is a measure of the balance of recharge and discharge valid for a specific time and relative to a specific groundwater feature, such as a basin, aquifer, management area, or well.

Many of these concepts are depicted in Figure 2. Shown is a flow system (A+B) and two subsystems (A, B) that are its parts. Each subsystem is composed of interior flows, indicated by the solid lines with arrows, as well as input and output flows indicated as recharge and discharge, respectively. These flow systems are contained by three distinct hydrogeologic unit bodies, with the middle body oriented at an angle and having a K (hydraulic conductivity) value of 10-5. Intraflow is exemplified by a flow line within the right hydrogeologic unit body, while Interflow is exemplified by the flow from right body (the source container) to middle body (the destination container). The boundary between the bodies serves as the interface through which the flow occurs. While not shown, the three hydrogeologic unit bodies contain a groundwater body (i.e., a fluid body) in their pores (i.e., voids), and it is this groundwater body that is flowing.

image

Figure 2 — Example flow system with two subsystems (after Freeze & Cherry, 1978, p. 204)

8.5.  Wells

Well-related entities include water wells, springs, and monitoring sites. Water wells are man-made constructions for monitoring, withdrawing, or injecting water from/into a hydrogeological unit, while springs are features where water discharges to the surface naturally. Both wells and springs possess important links to the hydrogeological environment, including their host units and materials, as well as the intersecting fluid body. Monitoring sites are locations where devices are placed to measure various properties of significance to hydrogeology, such as water level, flow rate, water temperature, or chemical composition, or to take samples. As such, monitoring sites are roles played by other features, for example, water wells or springs.

8.6.  Conceptual Model Specification

image

Figure 3 — GWML2 CM — Hydrogeological Unit

image

Figure 4 — GWML2 CM — Groundwater Properties

image

Figure 5 — GWML2 CM — Fluid Body

image

Figure 6 — GWML2 CM — Groundwater Flow

image

Figure 7 — GWML2 CM — Wells

8.6.1.  DocumentCitation

The class DocumentCitation is abstract, and has no attributes, operations or associations. It serves as a placeholder for legislative and reference documentation for a management area. Legislative documentation refers to the legal instrument or document that required the establishment of the management area. Reference documentation might describe the environmental objectives and measures that are to be undertaken in the management area to protect the environment (a reference to a management or action plan), licensing information, and associated maps.

The ‘Legislation References’ and ‘DocumentCitation’ classes from the INSPIRE Generic Conceptual Model are possible candidates for DocumentCitation.

Table 7

Relation Source Target Description
Association

Entity: GW_ManagementArea

Role:

Entity: DocumentCitation

Role: documentation

Relates legislative and reference documentation to a management area.

8.6.2.  Elevation

Elevation of a feature in reference to a datum.

Table 8

Attribute Type and Multiplicity Definition
elevation Geometry Numeric value and coordinate reference system (CRS), including the unit of measure (UoM) for the elevation.
elevationAccuracy PositionalAccuracyType Description of the accuracy of the elevation measurement.
elevationMeasurementMethod ElevationMeasurementMethodType Method used to measure the elevation, e.g., GPS, Survey, DEM, etc.
elevationType elevationTypeTerm Type of reference elevation, defined as a feature, e.g., Top of Casing, Ground, etc.

8.6.3.  GL_EarthMaterial

From GeoSciML 4.0:

Earth materials are substances, e.g., sandstone or granite, that constitute physical bodies, e.g., hydrogeological units. This class enables various hydrogeological properties to be attributed to a specific occurrence of a material, e.g., the sandstone of a specific aquifer.

Table 9

Attribute Type and Multiplicity Definition
gwVoidProperty GW_UnitVoidProperty The porosity or permeability of a particular earth material that hosts a void.
gwFluidProperty GW_UnitFluidProperty The hydraulic conductivity, transmissivity, or storativity of an earth material.

8.6.4.  GL_GeologicUnit

From GeoSciML 4.0:

Conceptually, may represent a body of material in the Earth whose complete and precise extent is inferred to exist (NADM GeologicUnit, Stratigraphic unit in sense of NACSN or International Stratigraphic Code), 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’).

Table 10

Attribute Type and Multiplicity Definition
gwUnitDescription char [1..*]Description of the unit.
gwUnitMetadata GW_Metadata [1..*]Metadata for the unit .
gwUnitName char [1..*]Name of the unit (common local name or formal name).
gwUnitShape Geometry The geometry of the unit.
gwUnitThickness Measurement Typical thickness of the unit.

Table 11

Relation Source Target Description
Generalization

Entity: GW_HydrogeoUnit

Role:

Entity: GL_GeologicUnit

Role:

A hydrogeological unit is a type of geological unit.

8.6.5.  GW_Aquifer

A body of earth material that contains / potentially contains / potentially contained sufficient saturated permeable material to yield significant quantities of water to wells and springs (after Lohman, 1972).

Table 12

Attribute Type and Multiplicity Definition
gwAquiferType AquiferType Several aquifer types can be distinguished: unconfined, confined, artesian, subartesian, or aquitard (after INSPIRE, 2013).
gwAquiferIsExploited boolean Denotes whether groundwater from the hydrogeological unit is being exploited by wells or other intakes (after INSPIRE, 2013).
gwAquiferIsMain boolean Denotes whether the unit is primary in an Aquifer System (after INSPIRE, 2013).

Table 13

Relation Source Target Description
Association

Entity: GW_Aquifer

Role: gwConfinedAquifer

Entity: GW_ConfiningBed

Role: gwConfiningBed

Relates an aquifer and its confining beds.
Generalization

Entity: GW_Aquifer

Role:

Entity: GW_AquiferUnit

Role:

An aquifer is a type of aquifer-related unit.

8.6.6.  GW_AquiferSystem

Aquifer system — a body of permeable and poorly permeable material that functions regionally as a water-yielding unit; it comprises two or more permeable beds separated at least locally by confining beds that impede groundwater movement but do not greatly affect the regional hydraulic continuity of the system; includes both saturated and unsaturated parts of permeable material (after ASCE, 1987).

Table 14

Attribute Type and Multiplicity Definition
gwAquiferSystemIsLayered boolean True if this aquifer / system is a layered system. (after INSPIRE, 2013).

Table 15

Relation Source Target Description
Generalization

Entity: GW_AquiferSystem

Role:

Entity: GW_AquiferUnit

Role:

An aquifer system is a type of aquifer-related unit.
Association

Entity: GW_AquiferSystem

Role: gwAquiferSystem

Entity: GW_AquiferUnit

Role: gwAquiferSystemPart

Relates an aquifer system with its parts, which can be other systems, aquifers or confining beds.

8.6.7.  GW_AquiferUnit

Denotes aquifer-related hydrogeological units: aquifer systems, aquifers, or confining beds.

Table 16

Relation Source Target Description
Generalization

Entity: GW_AquiferUnit

Role:

Entity: GW_HydrogeoUnit

Role:

An aquifer unit is a type of hydrogeological unit.
Generalization

Entity: GW_AquiferSystem

Role:

Entity: GW_AquiferUnit

Role:

An aquifer system is a type of aquifer-related unit.
Association

Entity: GW_AquiferSystem

Role: gwAquiferSystem

Entity: GW_AquiferUnit

Role: gwAquiferSystemPart

Relates an aquifer system with its parts, which can be other systems, aquifers or confining beds.
Generalization

Entity: GW_ConfiningBed

Role:

Entity: GW_AquiferUnit

Role:

A confining bed is a type of aquifer-related unit.
Generalization

Entity: GW_Aquifer

Role:

Entity: GW_AquiferUnit

Role:

An aquifer is a type of aquifer-related unit.

8.6.8.  GW_Basin

A large hydrogeologically defined body of ground typically consisting of hydraulically connected hydrogeological units, whose waters are flowing to a common or multiple outlets, and which is delimited by a groundwater divide.

Table 17

Attribute Type and Multiplicity Definition
gwDivide GW_Divide [1..*]“Line on a water table or piezometric surface on either side of which the groundwater flow diverges” (IGH0556).

Table 18

Relation Source Target Description
Generalization

Entity: GW_Basin

Role:

Entity: GW_HydrogeoUnit

Role:

A basin is a type of hydrogeological unit.
Aggregation

Entity: GW_Basin

Role:

Entity: GW_HydrogeoUnit

Role: gwBasinUnit

Relates hydrogeological units and the basins that contain them, in full or part.

8.6.9.  GW_BiologicConstituent

Characterisation of the biological composition of the fluid body, both natural and man-made.

Table 19

Attribute Type and Multiplicity Definition
gwOrganism OrganismType Biological species.
gwState StateType solidOrganisms are always solids.

Table 20

Relation Source Target Description
Generalization

Entity: GW_BiologicConstituent

Role:

Entity: GW_Constituent

Role:

A biologic constituent is a type of fluid body constituent. There are 3 types of fluid body constituents: chemical (e.g., arsenic), biologic (e.g., organisms), and material (e.g., sediment).

8.6.10.  GW_ChemicalConstituent

Characterisation of the chemical composition of the fluid body, both natural and man-made.

Table 21

Attribute Type and Multiplicity Definition
gwChemical ChemicalType Chemical component type, e.g., arsenic.

Table 22

Relation Source Target Description
Generalization

Entity: GW_ChemicalConstituent

Role:

Entity: GW_Constituent

Role:

A chemical constituent is a type of fluid body constituent. The 3 types of fluid body constituent are: chemical (e.g., arsenic), biologic ( e.g., organisms), and material (e.g., sediment).

8.6.11.  GW_ConfiningBed

A layer of rock having very low porosity and in consequence hydraulic conductivity that hampers the movement of water into and out of an aquifer (Heath, 1983).

Table 23

Attribute Type and Multiplicity Definition
gwSpatialConfinement SpatialConfinementType Degree of spatial confinement (typically: “Unconfined-Confined”, “Partially Confined”).
gwConductivityConfinement ConductivityConfinementType Degree of hydraulic confinement (e.g., aquiclude).

Table 24

Relation Source Target Description
Association

Entity: GW_Aquifer

Role: gwConfinedAquifer

Entity: GW_ConfiningBed

Role: gwConfiningBed

Relates an aquifer and its confining beds.
Generalization

Entity: GW_ConfiningBed

Role:

Entity: GW_AquiferUnit

Role:

A confining bed is a type of aquifer-related unit.

8.6.12.  GW_Constituent

General (abstract) entity denoting a material, chemical or biological constituent of a fluid body.

Table 25

Attribute Type and Multiplicity Definition
gwConcentration Measurement The concentration of the constituent in the fluid body.
gwState StateType The physical state of the constituent, i.e., solid, liquid, or gas.

Table 26

Relation Source Target Description
Association

Entity: GW_FluidBody

Role:

Entity: GW_Constituent

Role: gwBackgroundConstituent

Relates a fluid body to typical background constituent values for that body.
AssociationClass

Entity: GW_Constituent

Role: gwConstituent

Entity: GW_Constituent

Role: gwConstitutedOf

A general binary relation between constituents, in which the relation type can be specified in addition to the causal mechanism that caused the relationship.
Generalization

Entity: GW_BiologicConstituent

Role:

Entity: GW_Constituent

Role:

A biologic constituent is a type of fluid body constituent. There are 3 types of fluid body constituents: chemical (e.g., arsenic), biologic (e.g., organisms), and material (e.g., sediment).
Generalization

Entity: GW_ChemicalConstituent

Role:

Entity: GW_Constituent

Role:

A chemical constituent is a type of fluid body constituent. There are 3 types of fluid body constituents: chemical (e.g., arsenic), biologic (e.g., organisms), and material (e.g., sediment).
Generalization

Entity: GW_MaterialConstituent

Role:

Entity: GW_Constituent

Role:

A material constituent is a type of fluid body constituent. There are 3 types of fluid body constituents: chemical (e.g., arsenic), biologic (e.g., organisms), and material (e.g., sediment).
AssociationClass

Entity: GW_FluidBody

Role:

Entity: GW_Constituent

Role: gwBodyConstituent

Relates a fluid body to its chemical, biologic, or material constituents, and specifies the nature of the mixture of the constituent within the body, e.g., solution, suspension.

8.6.13.  GW_ConstituentRelation

Relation between fluid body components, typically caused by a specific mechanism, e.g., coating (from adsorption), constitution (from chemical bonding forming a new material), aggregation (from physical bonding, e.g., pressure), containment (from absorption, digestion).

Table 27

Attribute Type and Multiplicity Definition
gwConstituentRelationType ConstituentRelationType Specific type of relation between fluid body components, e.g., coating, constitution, aggregation, containment.
gwConstitutionRelationMechanism MechanismType Mechanisms by which materials (of various states) come into a relationship, e.g., sorption, precipitation, digestion, excretion, etc.

8.6.14.  GW_Discharge

An outflow of fluid from a container such as an aquifer, watershed, pipe.

Table 28

Relation Source Target Description
Generalization

Entity: GW_Discharge

Role:

Entity: GW_InterFlow

Role:

Discharge is a type of interflow in which fluid exits a feature.

8.6.15.  GW_Divide

“A line on a water table or piezometric surface, on either side of which the groundwater flow diverges” (IGH0556).

Table 29

Attribute Type and Multiplicity Definition
gwDivideShape Geometry Shape / position of the divide (line, plane or point) intersecting a fluid body surface.
gwDivideFlow GW_FlowSystem [2..*]Flow system on each side of the divide.

Table 30

Relation Source Target Description
Association

Entity: GW_Divide

Role: gwSurfaceDivide

Entity: GW_FluidBodySurface

Role: gwDivideSurface

Relates a fluid body surface to a line on e.g., a water table or piezometric surface, on either side of which the groundwater flow diverges.

8.6.16.  GW_Flow

Process by which the fluid enters or exits a hydrogeological unit or a void, or flows within a unit or a void. Can flow from/to other natural or man-made features such as rivers, filtration stations, etc.

Table 31

Attribute Type and Multiplicity Definition
gwFlowProcess WaterFlowProcess The process causing the flow, e.g., evapotranspiration, evaporation, transpiration, runoff, baseflow, pumping, infiltration, injection, etc.
gwFlowTime TemporalType Refers to the duration, instant or interval of the flow (actual time, not observation time). E.g., “yearly”, “summer”, “2009” or “2009-2011”.
gwFlowVelocity Measurement Measure of length traveled per time period.
gwFlowVolumeRate Measurement Measure of water quantity per time period.
gwFlowPersistence FlowPersistenceType The regularity of flow occurrence, e.g., ephemeral, intermittent, perennial, seasonal. After http://inspire.ec.europa.eu/codeList/WaterPersistenceValue/ (INSPIRE, 2013).

Table 32

Relation Source Target Description
Generalization

Entity: GW_InterFlow

Role:

Entity: GW_Flow

Role:

An interflow is a type of directed flow between two features, e.g., flow between two units.
Generalization

Entity: GW_IntraFlow

Role:

Entity: GW_Flow

Role:

An intraflow is a type of flow within a single feature, e.g., flow within a unit.
Aggregation

Entity: GW_FlowSystem

Role:

Entity: GW_Flow

Role: gwFlow

Relates a flow system to the individual flows that comprise the system. Flows are atomic entities that cannot have parts, but which form parts of flow systems.

8.6.17.  GW_FlowSystem

Flow path from recharge to discharge location, through hydrogeological units. It is related to a fluid body, and consists of a collection or aggregation of at least two specific flows, as well as possibly other flow systems.

Table 33

Attribute Type and Multiplicity Definition
gwFlowPath Geometry [1..*]The path of flow of a fluid through a container.

Table 34

Relation Source Target Description
Association

Entity: GW_FlowSystem

Role: gwFlowSystemPart

Entity: GW_FlowSystem

Role: gwPartOfSystemFlow

Relates a flow system part to a flow system whole.
Aggregation

Entity: GW_FlowSystem

Role:

Entity: GW_Flow

Role: gwFlow

Relates a flow system to the individual flows that comprise the system. Flows are atomic entities that cannot have parts, but which form parts of flow systems.

8.6.18.  GW_FluidBody

A distinct body of some fluid (liquid, gas) that fills the voids of a container such as an aquifer, system of aquifers, water well, etc. In hydrogeology this body is usually constituted by groundwater, but the model allows for other types of fillers e.g., petroleum.

Table 35

Attribute Type and Multiplicity Definition
gwBodyDescription char [1..*]General description of the fluid body
gwBodyFlow GW_Flow [1..*]Flows associated with the fluid body.
gwBodyMetadata GW_Metadata [1..*]Metadata about the fluid body.
gwBodyQuality BodyQualityType [1..*]

Categorical assessment of quality of the fluid body as a whole: e.g., saline, brackish, fresh, turbide, sulfurous, mixed, …​ 1000-3000mg/l tds, etc.

A normative quality description is an assesment based upon some guideline edited by a government or a quality standard.

gwBodyShape Geometry Shape and position of the fluid body.
gwBodyVolume Measurement Description of the volume/quantity of a fluid present in a container at a certain time.
gwBodyVulnerability GW_Vulnerability [0..*]The susceptibility of the fluid body to specific threats such as surface contamination, etc.

Table 36

Relation Source Target Description
Association

Entity: GW_HydrogeoVoid

Role: gwFluidBodyVoid

Entity: GW_FluidBody

Role: gwVoidFluidBody

Relates a void and a fluid body contained by the void. Each void contains at most one fluid body, which can have multiple parts that could be disconnected. Likewise, each fluid body is contained by a single void, which could be an aggregation of disconnected void parts.
Association

Entity: GW_ManagementArea

Role:

Entity: GW_FluidBody

Role: gwAreaBody

Relates a management area to the fluid bodies contained within the area. As with units, the spatial boundaries of management areas do not necessarily coincide with the spatial boundaries of fluid bodies.
Association

Entity: GW_FluidBodySurface

Role: gwBodySurface

Entity: GW_FluidBody

Role: gwSurfaceBody

Relates a fluid body to a surface hosted by the body, e.g., the top of the water table.
Aggregation

Entity: GW_FluidBody

Role: gwPartOfBody

Entity: GW_FluidBody

Role: gwBodyPartOf

Relates a fluid body part to a fluid body whole.
AssociationClass

Entity: GW_HydrogeoUnit

Role: gwFluidBodyUnit

Entity: GW_FluidBody

Role: gwUnitFluidBody

Relates hydrogeological units and the fluid bodies contained by the units.
Association

Entity: GW_FluidBody

Role:

Entity: GW_FluidBodyProperty

Role: gwBodyProperty

Relates a fluid body to additional properties such as age, temperature, density, viscosity, turbidity, color, hardness, acidity, etc.
Association

Entity: GW_FluidBody

Role:

Entity: GW_Constituent

Role: gwBackgroundConstituent

Relates a fluid body to typical background constituent values for that body.
AssociationClass

Entity: GW_FluidBody

Role:

Entity: GW_Constituent

Role: gwBodyConstituent

Relates a fluid body to its chemical, biologic, or material constituents, and specifies the nature of the mixture of the constituent within the body, e.g., solution, suspension.

8.6.19.  GW_FluidBodyProperty

Additional properties that characterize a fluid body. Can include synoptic values for the whole body or location-specific observations such as age, temperature, density, viscosity, turbidity, color, hardness, acidity, etc.

Table 37

Attribute Type and Multiplicity Definition
gwBodyProperty gwBodyPropertyType Type of fluid body property, e.g., age, temperature, density, viscosity, turbidity, color, hardness, acidity, etc.
gwBodyPropertyValue Measurement Value of the fluid body property (with uom).

Table 38

Relation Source Target Description
Association

Entity: GW_FluidBody

Role:

Entity: GW_FluidBodyProperty

Role: gwBodyProperty

Relates a fluid body to additional properties such as age, temperature, density, viscosity, turbidity, color, hardness, acidity, etc.

8.6.20.  GW_FluidBodySurface

A surface on a fluid body within a local or regional area, e.g., piezometric, potentiometric, water table, salt wedge, etc.

Table 39

Attribute Type and Multiplicity Definition
gwSurfaceShape Surface Geometry / position of the surface.
gwSurfaceType SurfaceType Type of fluid body surface, e.g., piezometric, potentiometric, water table, salt wedge, etc.
gwSurfaceMetadata ObservationMetadata Date, time, method, etc., of the observation or calculation of the surface.

Table 40

Relation Source Target Description
Association

Entity: GW_Divide

Role: gwSurfaceDivide

Entity: GW_FluidBodySurface

Role: gwDivideSurface

Relates a fluid body surface to a line on e.g., a water table or piezometric surface, on either side of which the groundwater flow diverges.
Association

Entity: GW_FluidBodySurface

Role: gwBodySurface

Entity: GW_FluidBody

Role: gwSurfaceBody

Relates a fluid body to a surface hosted by the body, e.g., the top of the water table.

8.6.21.  GW_HydrogeoUnit

Any soil or rock unit or zone that by virtue of its hydraulic properties has a distinct influence on the storage or movement of groundwater (after ANS, 1980).

Table 41

Attribute Type and Multiplicity Definition
gwUnitMedia PorosityType Type of material or, by proximity, type of voids (e.g., granular, fracture, karstic, or mixed).
gwUnitRecharge GW_Recharge [1..*]Volumetric flow rate of water that enters an hydrogeologic unit, at potentially multiple locations.
gwUnitDischarge GW_Discharge [1..*]Volumetric flow rate of water that goes out of an hydrogeologic unit, at potentially multiple locations.
gwUnitWaterBudget GW_WaterBudget Sum of water input and output of a hydrogeologic unit, at a particular point in time, with a description of inflows and outflows.
gwUnitVulnerability GW_Vulnerability [0..*]The susceptibility of the aquifer to specific threats such as various physical events (earthquakes), human processes (depletion), etc.

Table 42

Relation Source Target Description
Generalization

Entity: GW_Basin

Role:

Entity: GW_HydrogeoUnit

Role:

A basin is a type of hydrogeological unit.
Generalization

Entity: GW_AquiferUnit

Role:

Entity: GW_HydrogeoUnit

Role:

An aquifer unit is a type of hydrogeological unit.
Generalization

Entity: GW_HydrogeoUnit

Role:

Entity: GL_GeologicUnit

Role:

A hydrogeological unit is a type of geological unit.
AssociationClass

Entity: GW_HydrogeoUnit

Role: gwVoidUnit

Entity: GW_HydrogeoVoid

Role: gwUnitVoid

Relates hydrogeological units with a void hosted by the units. A unit hosts one void, which can be an aggregation of multiple voids potentially spatially disconnected. Voids in turn can be hosted by many units, particularly when units are arranged in whole-part relations, such that a void hosted by a part is also hosted by any associated whole, e.g., a void is hosted by both an aquifer and a related aquifer system, or a member and a related formation.
Association

Entity: GW_HydrogeoUnit

Role:

Entity: GW_UnitProperties

Role: gwUnitProperty

Relates a hydrogeological unit to possibly many additional properties.
Aggregation

Entity: GW_Basin

Role:

Entity: GW_HydrogeoUnit

Role: gwBasinUnit

Relates hydrogeological units and the basins that contain them, in full or part.
AssociationClass

Entity: GW_HydrogeoUnit

Role: gwFluidBodyUnit

Entity: GW_FluidBody

Role: gwUnitFluidBody

Relates hydrogeological units and the fluid bodies contained by the units.
Association

Entity: GW_ManagementArea

Role: gwManagementArea

Entity: GW_HydrogeoUnit

Role: gwManagedUnit

Relates a management area to the hydrogeological units contained within it. Because the spatial boundaries of management areas can be determined by human concerns, e.g., regulatory, these boundaries do not necessarily align with the spatial boundaries of units, which are determined by physical criteria.

8.6.22.  GW_HydrogeoVoid

Voids represent the spaces inside (hosted by) a unit or its material. E.g., the pores in an aquifer, or in the sandstone of an aquifer. Voids can contain fluid bodies. Voids are differentiated from ‘porosity’ in that porosity is the proportion of void volume to total volume, while voids are the spaces themselves. Voids are required in GWML2, for example, to capture the volume of fractures in an aquifer.

Table 43

Attribute Type and Multiplicity Definition
gwVoidDescription char General description of the void
gwVoidHostMaterial EarthMaterial [0..*]The material that hosts the void, if specified. Note voids can be hosted by a unit (an aquifer) or its material (e.g., sandstone).
gwVoidMetadata GW_Metadata Metadata for the void.
gwVoidShape Geometry Shape and position of the void.
gwVoidType PorosityType Type of void e.g., fractured, intergranular, etc.
gwVoidVolume Measurement Volume of the void.

Table 44

Relation Source Target Description
Association

Entity: GW_HydrogeoVoid

Role: gwFluidBodyVoid

Entity: GW_FluidBody

Role: gwVoidFluidBody

Relates a void and a fluid body contained by the void. Each void contains at most one fluid body, which can have multiple parts that could be disconnected. Likewise, each fluid body is contained by a single void, which could also be an aggregation of disconnected void parts.
AssociationClass

Entity: GW_HydrogeoUnit

Role: gwVoidUnit

Entity: GW_HydrogeoVoid

Role: gwUnitVoid

Relates hydrogeological units with a void hosted by the units. A unit hosts one void, which can be an aggregation of multiple voids potentially spatially disconnected. Voids in turn can be hosted by many units, particularly when units are arranged in whole-part relations, such that a void hosted by a part is also hosted by any associated whole, e.g., a void is hosted by both an aquifer and a related aquifer system, or a member and a related formation.
Aggregation

Entity: GW_HydrogeoVoid

Role: gwPartOfVoid

Entity: GW_HydrogeoVoid

Role: gwVoidPartOf

Relates a void part to a void whole.

8.6.23.  GW_InterFlow

Fluid flow between features through an interface, exiting one feature and entering another. Features into which fluid is flowing are usually units, voids, or fluid bodies, but can be natural surface water features such as rivers or lakes, or even man-made features such as dams or canals. Likewise for features where water is exiting.

Table 45

Attribute Type and Multiplicity Definition
gwFlowLocation Geometry [1..*]The location at which water is being transferred from one feature into another.
gwFlowSourceContainer Feature The feature from which water is flowing.
gwFlowSourceBody Feature The fluid body from which water is flowing.
gwFlowDestinationContainer Feature The feature into which water is flowing.
gwFlowDestinationBody Feature The fluid body into which water is flowing.
gwFlowInterfaceFeature Feature [0..*]The feature that denotes the interface between, for example, the groundwater and surface, such as a well, spring, seep, etc., or between two aquifers.

Table 46

Relation Source Target Description
Generalization

Entity: GW_InterFlow

Role:

Entity: GW_Flow

Role:

An interflow is a type of directed flow between two features, e.g., flow between two units.
Generalization

Entity: GW_Recharge

Role:

Entity: GW_InterFlow

Role:

Recharge is a type of interflow in which fluid enters a feature.
Generalization

Entity: GW_Discharge

Role:

Entity: GW_InterFlow

Role:

Discharge is a type of interflow in which fluid exits a feature.

8.6.24.  GW_IntraFlow

Fluid flow within a feature such as a unit, void, gw body, or even a man-made feature such as a conduit of some kind.

Table 47

Attribute Type and Multiplicity Definition
gwFlowLocation Geometry The location where a fluid is flowing within a feature.
gwFlowContainer Feature The feature in which the fluid is flowing. Typically a unit, void, or gw body, but can also be a man made feature such as some conduit.
gwFlowBody Feature The fluid body that is flowing.

Table 48

Relation Source Target Description
Generalization

Entity: GW_IntraFlow

Role:

Entity: GW_Flow

Role:

An intraflow is a type of flow within a single feature, e.g., flow in a unit.

8.6.25.  GW_Licence

Licence relating to the drilling of a well, the extraction of groundwater, etc.

Table 49

Attribute Type and Multiplicity Definition
gwLicenceID CharacterString Licence ID, e.g., a number.
gwPurpose CharacterString Purpose of the licence.
gwAssociatedGWVolume QuantityRange Fluid volume associated with the licence.
gwTimePeriod TimeRange The period of time for which the licence is valid.

8.6.26.  GW_ManagementArea

The GW_ManagementArea represents an area of ground identified for management purposes. The area can be delineated by human factors such as policy or regulation concerns, as well as by domain concerns (in this case hydrogeological or hydrological). The spatial boundaries of a management area do not necessarily align exactly with associated hydrogeological feature boundaries. GW_ManagementArea has the potential to provide a pattern for a more generic OGC ‘trans-domain’ feature management class. GW_ManagementArea is equivalent to InspireAM:ManagementRestrictionOrRegulationZone.

Table 50

Attribute Type and Multiplicity Definition
gwAreaName char [1..*]Name of the management area.
gwAreaDescription char [1.. *] General description of the management area.
gwAreaFeature Feature [1..*]Other features that are associated with the management area (watershed, ecological zones, etc) that are not hydrogeological units.
gwAreaWaterBudget GW_WaterBudget [1..*]Water budget associated with the management area.
gwAreaYield GW_Yield Yield associated with the management area.
gwAreaShape Geometry Geometric shape and position of management area.
gwAreaType ManagementAreaType General classification of the management area (e.g., restricted use zone, irrigation area, consumption area, etc.)
gwAreaSpecialisedAreaType SpecialisedZoneAreaTypeTerm Additional classification value which further specialises the gwAreaType.
gwAreaEnvironmentalDomain EnvironmentalDomainTypeTerm Classification of the environment domain(s) for which, through the establishment of the management area, certain environmental objectives are to be reached.
gwAreaCompetentAuthority CI_ResponsibleParty [0..*]Description of the organization(s) responsible for managing, restricting or regulating measures or activities within the management area.
gwAreaDesignationPeriod TM_Period Time period specifying when the management area was legally designated or became effective in the real world

Table 51

Relation Source Target Description
Association

Entity: GW_ManagementArea

Role:

Entity: DocumentCitation

Role: documentation

Relates legislative and reference documentation to a management area.
Association

Entity: GW_ManagementArea

Role:

Entity: GW_FluidBody

Role: gwAreaBody

Relates a management area to the fluid bodies contained within the area. As with units, the spatial boundaries of management areas do not necessarily coincide with the spatial boundaries of fluid bodies.
Association

Entity: GW_ManagementArea

Role:

Entity: GW_ManagementArea

Role: relatedManagementArea

Relates a management area part to a management area whole.
Association

Entity: GW_ManagementArea

Role: gwManagementArea

Entity: GW_HydrogeoUnit

Role: gwManagedUnit

Relates a management area to the hydrogeological units contained within it. Because the spatial boundaries of management areas can be determined by human concerns, e.g., regulatory, these boundaries do not necessarily align with the spatial boundaries of units, which are determined by physical criteria.

8.6.27.  GW_MaterialConstituent

Suspended or colloidal material in a fluid body, e.g sediment.

Table 52

Attribute Type and Multiplicity Definition
gwMaterial MaterialType Name of the suspended or colloid material in the fluid body, e.g., a lithology or mineral name.

Table 53

Relation Source Target Description
Generalization

Entity: GW_MaterialConstituent

Role:

Entity: GW_Constituent

Role:

A material constituent is a type of fluid body constituent. There are 3 types of fluid body constituents: chemical (e.g., arsenic), biologic (e.g., organisms), and material (e.g., sediment).

8.6.28.  GW_Mixture

The nature of the inclusion of the constituent in the fluid body, e.g., suspension, emulsion, etc.

Table 54

Attribute Type and Multiplicity Definition
gwMixture MixtureType The manner in which a constituent is within a fluid body, e.g., solution, suspension, emulsion, precipitate, colloidal.

8.6.29.  GW_MonitoringSite

Site of observation related to groundwater.

Table 55

Attribute Type and Multiplicity Definition
gwSiteName char [0..*]Name (or identifier) of the monitoring site.
gwSiteLocation Geometry Spatial location of the site.
gwSiteReferenceElevation Elevation [1..*]Reference elevation for all observations at the site, e.g., ground elevation, casing elevation. This can differ from the host feature elevation, or be more specific.
gwSiteType SiteType Type of monitoring site, e.g., well, gauging station, etc.
gwMonitoringHost Feature The feature hosting the site, e.g., a well, spring, lake or stream.

8.6.30.  GW_Porosity

Measure of the proportion of the volume occupied by voids over the total volume of material including the voids. Voids are differentiated from ‘porosity’ in that porosity is a proportion, while voids are the spaces themselves. Types of porosity include: primary, secondary, dual, specific, effective, granular, fractured, karstic, etc.

Table 56

Attribute Type and Multiplicity Definition
gwPorosityType PorosityType Type of porosity (primary, secondary, dual, specific, effective, granular, fractured, karstic, etc.)
gwPorosity Measurement Measure of the proportion of the volume occupied by specific voids over the total volume of material including the voids.

Table 57

Relation Source Target Description
Association

Entity: GW_UnitVoidProperty

Role:

Entity: GW_Porosity

Role: gwPorosity

Relates possibly many types of porosity values to a unit and related void combination.

8.6.31.  GW_Recharge

Fluid added to an aquifer by various means such as precipitation, injection, etc.

Table 58

Relation Source Target Description
Generalization

Entity: GW_Recharge

Role:

Entity: GW_InterFlow

Role:

Recharge is a type of interflow in which fluid enters a feature.

8.6.32.  GW_Spring

Any natural feature where groundwater flows to the surface of the earth.

Table 59

Attribute Type and Multiplicity Definition
gwSpringName CharacterString [0..*]Name or ID of the spring.
gwSpringLocation Geometry Geometry / position of the spring.
gwSpringReferenceElevation Elevation [1..*]Reference elevation for all observations at the site, e.g., ground elevation, casing elevation.
gwSpringType SpringType Type of spring e.g., mineral, thermal, saline, etc.
gwSpringCauseType SpringCauseType The cause of the spring e.g., artesian, geyser, perched, etc.
gwSpringPersistence SpringPersistenceType The periodicity of the spring e.g., ephemeral, perennial, intermittent, seasonal, etc.
gwSpringGeology GL_Feature [0..*]Related geology features.
gwSpringUnit GW_HydrogeoUnit [1..*]The hydrogeological unit(s) hosting the spring.
gwSpringBody GW_FluidBody [0..*]The fluid body being depleted by the spring.
gwSpringConstruction SpringConstruction [0..1]Spring construction details
gwSpringLicence GW_Licence [0..*]Any licence relating to the spring.

8.6.33.  GW_UnitFluidProperty

A measured or calculated physical or hydraulic property that can be inherent in either an aquifer or its material, and some fluid body, e.g., hydraulic conductivity, transmissivity, storativity, permeability, porosity.

Table 60

Attribute Type and Multiplicity Definition
gwHydraulicConductivity Measurement [1..*]Hydraulic conductivity measures how easily a fluid can move through the voids in a material.
gwTransmissivity Measurement [1..*]The rate of groundwater flow laterally through an aquifer, determined by hydraulic conductivity and container thickness.
gwStorativity Measurement [1..*]Storativity is the volume of water released from storage per unit decline in hydraulic head in the aquifer, per unit area of the aquifer.

Table 61

Relation Source Target Description
Association

Entity: GW_UnitFluidProperty

Role:

Entity: GW_Yield

Role: gwYield

Relates possibly many types of yield values to a unit and fluid body combination.

8.6.34.  GW_UnitProperties

Additional properties of an aquifer not included in the model.

Table 62

Attribute Type and Multiplicity Definition
gwUnitProperty gwUnitPropertyType The type of hydrogeological unit property, e.g., average well depth.
gwUnitPropertyValue Any The value of the hydrogeological unit property.

Table 63

Relation Source Target Description
Association

Entity: GW_HydrogeoUnit

Role:

Entity: GW_UnitProperties

Role: gwUnitProperty

Relates a hydrogeological unit to possibly many additional properties.

8.6.35.  GW_UnitVoidProperty

Properties inherent in the relation between a hydrogeological unit and a void: includes the proportion of voids to the unit (porosity) or to the connectivity / size of void openings (intrinsic permeability).

Table 64

Attribute Type and Multiplicity Definition
gwPermeability Measurement [1..*]Refers to intrinsic permeability: a measure of a material’s ability to allow fluid flow that is independent of fluid properties, and based on connectivity of pores and size of their openings. This is different from hydraulic conductivity.

Table 65

Relation Source Target Description
Association

Entity: GW_UnitVoidProperty

Role:

Entity: GW_Porosity

Role: gwPorosity

Relates possibly many types of porosity values to a unit and related void combination.

8.6.36.  GW_Vulnerability

The susceptibility of a feature to specific threats such as various physical events (earthquakes), human processes (depletion), etc.

Table 66

Attribute Type and Multiplicity Definition
gwVulnerabilityType VulnerabilityType The type of vulnerability.
gwVulnerability Measurement A quantitative estimate of the susceptibility to contamination, e.g., a DRASTIC value. Should be accompanied by metadata about the method of calculation.

8.6.37.  GW_WaterBudget

An accounting of the water input and output of a hydrogeological unit, at a particular point in time or over a period of time, with a description of inflows and outflows.

Table 67

Attribute Type and Multiplicity Definition
gwBudgetAmount Measurement Final quantity (sum) of the budget. If recharge = discharge, the sum is 0.
gwBudgetValidTime TemporalType Valid time of this budget (e.g, 2010).
gwBudgetRecharge GW_Recharge [1..*]Recharge (inflows) considered by the budget.
gwBudgetDischarge GW_Discharge [1..*]Discharge (outflows) considered in the budget.

8.6.38.  GW_Well

A shaft or hole sunk, dug or drilled into the Earth to observe, extract or inject water (after IGH1397).

Table 68

Attribute Type and Multiplicity Definition
gwWellName char [0..*]Name or ID of the well.
gwWellLocation Geometry Surface location of the well.
gwWellReferenceElevation Elevation [1..*]Reference elevation for all observations at the site, e.g., ground elevation, casing elevation.
gwWellContributionZone Geometry The area or volume surrounding a pumping well or other discharge site that encompasses all areas and features that supply groundwater to the well or discharge site.
gwWellGeology GeologyLog [0..*]Related borehole, including lithology log.
gwWellUnit GW_HydrogeoUnit [1..*]The aquifers or confining beds intersecting the well.
gwWellBody GW_FluidBody [0..*]The fluid body occupying the well.
gwWellPurpose WellPurposeType [1..*]Purpose of well, e.g., extraction, injection, observation, dewatering, cathodic protection, decontamination, disposal, FlowingShot, Geotechnical, Mineral, MonitoringlevelHead, MonitoringQuality, Oil, OilExploratory, Seismic, WaterExploratory, etc.
gwWellStatus WellStatusType Status of the well, Can be new, unfinished, reconditioned, deepened, not in use, standby, unknown, abandoned dry, abandoned insufficient, abandoned quality. (gwml1)
gwWellWaterUse WellWaterUseType [1..*]E.g., Agricultural, Domestic, Industrial, Recreation.
gwWellTotalLength Measurement Total length of the well from reference elevation.
gwWellConstructedDepth Measurement [0..1]Constructed depth of the well.
gwWellStaticWaterDepth Measurement Depth of the fluid body (e.g., piezometric level).
gwWellYield GW_Yield Estimated or calculated yield from a well.
gwWellConstruction WellConstruction Construction details for a well.
gwWellLicence GW_Licence [0..*]Licence relating to the drilling of the well or to the extraction of groundwater.

8.6.39.  GW_Yield

Yield is the rate of fluid withdrawal associated with a unit, well, etc., expressed as m3. There are several types of yield, that can be considered: specific yield, sustainable yield, safe yield, aquifer yield, etc.

Table 69

Attribute Type and Multiplicity Definition
gwYieldType YieldType Type of aquifer yields: e.g., specific yield, safe yield, etc.
gwYield Measurement Measurement of the yield in units of volume per unit of time.

Table 70

Relation Source Target Description
Association

Entity: GW_UnitFluidProperty

Role:

Entity: GW_Yield

Role: gwYield

Relates possibly many types of yield values to a unit and fluid body combination.

8.7.  Requirements

Requirement Class: GWML2 conceptual model

/req/conceptual

Obligationrequirement
Target TypeLogical Model
DependencyISO19101:2002 Reference Model Clause 7
DependencyISO19103 2015 Conceptual Model Language
DependencyISO19104:2008
DependencyUnified Modeling Language (UML). Version 2.3. May 2010

Requirement 1:

/req/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 and must not specify any requirements that would contradict or result in non-conformance to 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:

/req/conceptual/similarity

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, and the logical model must not specify any requirements that would contradict or result in non-conformance to the conceptual model.

9.  Logical Model

The logical model incorporates all concepts from the conceptual model, and maintains their general intent. It differs from the conceptual model in its introduction of technology-specific artifacts from the OGC General Reference Model and derived schemas. These include additions such as classes, relations, properties, constraints, and usage principles. Another difference is the incorporation of the well construction package from GWML1.

The logical model is not a syntactical encoding, but is an OGC-compliant schema that is syntax-neutral. Syntactical encodings are derived from the logical model, such as the reference GML encoding described herein.

The addition of OGC constructs to the conceptual model amounts to the integration of several OGC-compliant GML schemas, primarily GeoSciML 4.0 and Observations & Measurements, but also MD_Metadata and others. These are adapted using the following strategies.

  1. HydrogeologicalUnit in GWML2 specializes GeologicUnit from GeoSciML 4.0, recognizing that in its most basic sense a hydrogeological unit is a body of rock (a geological unit) exhibiting some hydrogeological properties including possibly fluid storage and transfer.

  2. Water wells and boreholes specialize O&M:SF_SamplingCurve, which allows them to have a shape described by 3D points at the start and end of each segment along the well or borehole. Wells and boreholes differ by purpose and use: boreholes are physical engineering artifacts consisting of a hole and potentially materials fitted inside the hole for some human use, and wells are constructions for the extraction or injection of water from/into the ground, and have specific hydrogeological properties such as water yield and intended use. As a consequence, well and associated borehole lengths can differ for the same well. A well can be seen as a specific role played by a borehole.

  3. Property values are assigned datatypes from O&M: properties that can be numeric and/or categorical are assigned the OM_Observation datatype. Two factors compel this choice: method metadata can be added to each value to describe determination of the value, and each property can be further soft-typed for greater precision. An example of the latter is the porosity property, which in pratice could refer to any of a wide range of porosity types such as effective porosity, primary porosity, or secondary porosity.

  4. Fluid body constituent values are modeled as observations: for example, a chemical analysis of a groundwater sample might be represented in the following way:

    • Each measured value is the result of an observation;

    • The observedProperty would be e.g., “As_Concentration;” and

    • The featureOfInterest would be an instance of e.g., GW_ChemicalConstituent with ChemicalTypeTerm = “As” and gwState = “solid.”

This approach is quite flexible: it allows for different mixture types (e.g., suspension, solution, emulsion), states (i.e., liquid, solid, gas), and measurement types (e.g., concentration) for a constituent type (e.g., “As”).

  1. Aquifer Tests are completely modelled using O&M, except for the single signature class GW_AquiferTest. This class is a property-less extension of O&M Sampling Feature. The logical model for Aquifer Test is thus the O&M logical model, as illustrated further in Figure 17. Time series generated by aquifer tests are represented using TimeseriesML1.0 (15-042r3).

  2. DocumentCitation is replaced by Any type (i.e., the ‘documentation’ role is assigned a datatype of Any), in order to satisfy the original intention of the DocumentCitation class of enabling re-use of relevant classes from other schemas. This allows, for example, use of classes such as GW_Licence, MD_Metadata, INSPIRE’s DocumentCitation or LegislativeReferences.

  3. If an entity in the logical model is stereotyped as GMF_Feature (from the OGC General Feature Model), then any name, description and identifier attributes from the conceptual model are replaced by equivalents from GMF_Feature (e.g., GW_FluidBody::gwBodyDescription maps to AbstractFeature::description).

The logical model is organized into six application schema packages, as mentioned in Section 1.

  1. GWML2-Main: core items, e.g., aquifers, their pores, fluid bodies, and management areas.

  2. GWML2-Constituent: the biologic, chemical, and material elements of a fluid body.

  3. GWML2-Flow: fluid flow within and between containers, and water budgets.

  4. GWML2-Well: water wells, springs, and monitoring sites.

  5. GWML2-WellConstruction: the components used to construct a borehole or well.

  6. GWML2-AquiferTest: aspects associated with an aquifer test.

Because most of the differences between the logical and conceptual model can be inferred directly from the logical model UML diagrams, all diagrams are included below. Complete class descriptions are subsequently included only for additions or alterations to the conceptual model. Additions primarily include borehole construction elements and geology logs, while the alterations mainly consist of a cardinality revision: all attributes and relations are now optional, primarily to enable sparse encodings that avoid empty data fields if so desired.

9.1.  Logical Model Specification

image

Figure 8 — GWML2 LM — Package Dependencies (Internal).

image

Figure 9 — GWML2 LM — Package Dependencies (External — indirect dependencies not shown).

image

Figure 10 — GWML2 LM — Hydrogeological Unit.

image

Figure 11 — GWML2 LM — Groundwater Properties.

image

Figure 12 — GWML2 LM — Fluid Body.