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):
- Geological Survey of Canada (GSC), Canada
- U.S. Geological Survey (USGS), United States of America
- Commonwealth Scientific and Industrial Research Organisation (CSIRO), Australia
- Bureau of Meteorology (BOM), Australia
- Federation University Australia (FedUni), Australia
- Bureau de Recherches Géologiques et Minières (BRGM), France
- Salzburg University (U Salzburg), Austria
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:
-
a commercial use-case focused on drilling water wells with knowledge of aquifers,
-
a policy use case concerned with the management of groundwater resources,
-
an environmental use-case that considers the role of groundwater in natural eco-systems,
-
a scientific use-case concerned with modeling groundwater systems, and
-
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:
-
Conceptual (UML): a technology-neutral schema denoting the semantics of the domain,
-
Logical (UML): a GML-specific schema that incorporates the OGC suite of standards,
-
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:
-
GWML2-Main: core elements such as aquifers, their pores, and fluid bodies,
-
GWML2-Constituent: the biologic, chemical, and material constituents of a fluid body,
-
GWML2-Flow: groundwater flow within and between containers,
-
GWML2-Well: water wells, springs, and monitoring sites,
-
GWML2-WellConstruction: the components used to construct a well,
-
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:
-
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:
-
Geological Survey of Canada (GSC), Canada
-
U.S. Geological Survey (USGS), United States of America
-
Commonwealth Scientific and Industrial Research Organisation (CSIRO), Australia
-
Federation University Australia (FedUni), Australia
-
Bureau of Meteorology (BOM), Australia
-
European Commission, Directorate General — Joint Research Centre (JRC), European Union
-
Polish Association for Spatial Information
-
Polish Geological Institute (PGI), Poland
-
Geological Surveys of Germany (GSG), Germany
-
Salzburg University (U Salzburg), Austria
-
Bureau de Recherches Géologiques et Minières (BRGM), France
-
British Geological Survey (BGS), U.K.
-
International Groundwater Resources Assessment Centre (IGRAC), UNESCO
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} | |
| Obligation | requirement |
| 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
| GF | ISO 19109:2005 General Feature Model |
| GFI | ISO 19156:2011 General Feature Model Instances |
| TM | ISO 19108:2002 Temporal Schema, Temporal Objects |
| MD | ISO 19115 Metadata |
| CV | ISO 19123:2005 Schema for Coverage Geometry and Functions |
| OM | ISO 19156:2011 Observations and Measurements |
| DQ | ISO 19157:201X Data Quality |
| WML2 | OGC® WaterML 2.0: Part 1- Timeseries |
| GW | GroundwaterML 2.0 |
| TS | TimeseriesML |
6.6. Abbreviated terms
In this document the following abbreviations and acronyms are used or introduced:
Table 6
| API | Application Program Interface |
| GeoSciML 3.2 | GeoScience Mark-up Language version 3.2 |
| GeoSciML 4.0 | GeoScience Mark-up Language version 4.0 |
| GML | OGC Geography Mark-up Language |
| GWML1 | Groundater Markup Language version 1.0 (Natural Resources Canada) |
| GWML2 | Groundwater Markup Language version 2.0 (this standard) |
| GWML2-Main | UML Logical Model of the primary GroundWaterML2 elements (namespace http://www.opengis.net/gwml-main/2.2) |
| GWML2-Flow | UML Logical Model of the elements required to capture groundwater flow (namespace http://www.opengis.net/gwml-flow/2.2) |
| GWML2-Constituent | UML Logical Model of the groundwater fluid body constituents and their relationships (namespace http://www.opengis.net/gwml-constituent/2.2) |
| GWML2-Well | UML Logical Model of the features and properties associated with water well (namespace http://www.opengis.net/gwml-well/2.2) |
| GWML2-WellConstruction | UML Logical Model of the well drilling and construction details (namespace http://www.opengis.net/gwml-wellconstruction/2.2) |
| GWML2-AquiferTest | UML Logical Model of the features and properties associated with aquifer test (namespace http://www.opengis.net/gwml-aquifertest/2.2) |
| INSPIRE | Infrastructure for Spatial Information in the European Community (Directive 2007/2/EC) |
| ISO | International Organization for Standardization |
| IUGS | International Union of Geological Sciences |
| NACSN | North American Commission on Stratigraphic Nomenclature |
| NADM | North American geological Data Model |
| OGC | Open Geospatial Consortium |
| O&M | OGC Observations and Measurements Conceptual Model |
| OMXML | Observations and Measurements XML Implementation |
| SensorML | Sensor Model Language |
| SOS | Sensor Observation Service |
| SWE | Sensor Web Enablement |
| TSML | TimeseriesML |
| UML | Unified Modeling Language |
| UTC | Coordinated Universal Time |
| URI | Universal Resource Identifier |
| URL | Universal Resource Locator |
| WML2 | WaterML 2.0 — Part 1 |
| XML | Extensible Markup Language |
| XSD | W3C 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:
-
OMXML (10-025r1)
-
sweCommon (08-094r1)
-
GML ISO 19136:2007 (07-036r1)
-
ISO/TS 19139:2007 (Metadata)
-
W3C XSD
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.
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.
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
Figure 3 — GWML2 CM — Hydrogeological Unit
Figure 4 — GWML2 CM — Groundwater Properties
Figure 5 — GWML2 CM — Fluid Body
Figure 6 — GWML2 CM — Groundwater Flow
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 solid | Organisms 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 | |
| Obligation | requirement |
| Target Type | Logical Model |
| Dependency | ISO19101:2002 Reference Model Clause 7 |
| Dependency | ISO19103 2015 Conceptual Model Language |
| Dependency | ISO19104:2008 |
| Dependency | Unified 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.
-
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.
-
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.
-
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.
-
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”).
-
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).
-
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.
-
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.
-
GWML2-Main: core items, e.g., aquifers, their pores, fluid bodies, and management areas.
-
GWML2-Constituent: the biologic, chemical, and material elements of a fluid body.
-
GWML2-Flow: fluid flow within and between containers, and water budgets.
-
GWML2-Well: water wells, springs, and monitoring sites.
-
GWML2-WellConstruction: the components used to construct a borehole or well.
-
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
Figure 8 — GWML2 LM — Package Dependencies (Internal).
Figure 9 — GWML2 LM — Package Dependencies (External — indirect dependencies not shown).
Figure 10 — GWML2 LM — Hydrogeological Unit.
Figure 11 — GWML2 LM — Groundwater Properties.
Figure 12 — GWML2 LM — Fluid Body.