Schemas and Namespaces

As indicated previously, XML namespaces are part of National Geothermal Data System (NGDS) service-level naming conventions. Compliance with NGDS naming conventions means specifying a namespace that identifies the schema used to structure the data being deployed by the web service. An XML namespace can be provided when creating the web service:

  • In an ArcGIS environment, the namespace is provided when specifying the web feature service capabilities of your web service
  • In a GeoServer environment, the namespace is provided when creating a workspace

For a more detailed examination of XML and XML namespaces, see the USGIN XML Tutorial.

Table 2 contains a list of namespaces enumerated by the schemas they identify; see below for a description of each field in the table.

Schema and Version Namespace Prefix
ActiveFault 1.2 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/activefault/1.2 aasg
ActiveFault 1.5 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/activefault/1.5 aasg
AqueousChemistry 1.10 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/aqueouschemistry/1.10 aasg
BoreholeLithIntercept 1.1 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/bhlithintercept/1.1 aasg
BoreholeLithInterval .9 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/bhlithinterval/0.9 aasg
Borehole Temperature 1.5 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/boreholetemperature/1.5 aasg
Borehole Temperature 1.6 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/boreholetemperature/1.6 aasg
ContactView 2.0 http://xmlns.geosciml.org/geosciml-portrayal/2.0 gsmlp
DirectUseSite 1.5 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/directusesite/1.5 aasg
DrillStemTest 1.8 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/drillstemtest/1.8 aasg
DrillStemTest 1.9 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/DrillStemTest/1.9 aasg
EventHypocenter 1.7 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/hypocenter/1.7 aasg
FaultFeature 1.0 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/fault/1.0 aasg
FaultFeature 1.1 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/fault/1.1 aasg
FluidFluxInjection 1.1 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/fluidfluxinjection/1.1 aasg
FluidProduction 1.1 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/fluidproduction/1.1 aasg
GeologicUnitView 2.0 http://xmlns.geosciml.org/geosciml-portrayal/2.0 gsmlp
GeothermalArea 0.5 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/geothermalarea/0.5 aasg
GeothermalFluidProduction 1.1 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/geothermalfluidproduction/1.1 aasg
Geothermometry 0.1 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/geothermometry/0.1 aasg
HeatFlow 1.23 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/heatflow/1.23 aasg
HeatPumpFacility 0.6 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/HeatPumpFacility/0.6 aasg
PowerPlantFacilities 0.2 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/PowerPlant/0.2 aasg
PowerPlantProduction 0.8 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/PowerPlantProduction/0.8 aasg
RockChemistry 0.4 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/rockchemistry/0.4 aasg
ShearDisplacementStructure 2.0 http://xmlns.geosciml.org/geosciml-portrayal/2.0 gsmlp
ThermalConductivity 2.0 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/thermalconductivity/2.0 aasg
ThermalSpring 1.6 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/thermalspring/1.6 aasg
ThermalSpring 1.8 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/thermalspring/1.8 aasg
VolcanicVent 1.4 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/volcanicvent/1.4 aasg
Wellheader 1.5 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/wellheader/1.5 aasg
Wellheader 1.7 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/wellheader/1.7 aasg
WellLog 0.8 http://stategeothermaldata.org/uri-gin/aasg/xmlschema/welllog/0.8 aasg

Table 2: XML namespaces that identify NGDS schemas; namespaces are listed by schema; entries highlighted in red represent schemas that have not yet been deployed; entries highlighted in gray represent schemas that are deprecated but remain in use

The fields in Table 2 are as follows:

  • Schema and Version: The most up-to-date version of the NGDS schema used to structure the data deployed by the user; multiple versions of a given schema indicate that a transition to a newer version of that schema is in progress
  • Namespace: The XML namespace that identifies the corresponding schema in the Schema and Version column
  • Prefix: The XML prefix that is used to invoke the namespace later in the capabilites document of the web service deployed by the user (see below)
    • aasg indicates an AASG Geothermal Data schema
    • gsmlp indicates a GeoSciML-Portrayal schema; GeoSciML-Portrayal schemas are used for NGDS web services with line and polygon geometry (as opposed to mere points on a map); for more information, see the GeoSciML-Portrayal Cookbook

To provide a more concrete example, the capabilities document of a live web service containing data structured by the AqueousChemistry schema would appear as follows:

  • In the root element of the capabilities document, the XML namespace attribute (xmlns) is used to bind the aasg prefix (which functions here as an attribute) with the corresponding namespace listed in the table above, thereby declaring the namespace, like so:
    xmlns:aasg="http://stategeothermaldata.org/uri-gin/aasg/xmlschema/aqueouschemistry/1.9"
  • Having been declared as a namespace using the xmlns attribute, the aasg prefix can now be used to refer back to and invoke this namespace at any time by modifying an existing element, like so:
    <wfs:Name>aasg:WaterQuality</wfs:Name>

Here, the aasg prefix modifies the content within the Name element (itself modified by the wfs prefix, also declared in the root element of this capabilities document), thereby indicating that the content of the Name element should be interpreted within the context of the AqueousChemistry schema identified by the namespace indicated by the aasg prefix.

For help interpreting the above, the USGIN XML Tutorial is strongly recommended, particularly the section on prefixes and namespaces.

To continue this tutorial, click the links below.