ISO Platforms

From NOAA Environmental Data Management Wiki
(Redirected from Platforms)

Most of the observations used to characterize and understand our environment are made using instruments that are mounted on platforms, such as ships, satellites or stations. These platforms can change over time so it is important to document them in order to avoid misunderstanding.

ISO 19115-2 Acquisition Details
Platform information is included in the acquisitionInformation section of the ISO 19115-2 standard (see left side of Figure). The description includes five items:
  • citation: This is a reference to a document or a web page that describes some aspect of the platform. Any number of these references can be included and the referenced documents can be in any format. Note that these ISO citations include unique identifiers for the referenced citations.
  • identifier: This is an identifier for the platform. It includes a code and an authority or source for that code. At present the standard allows only one of these for each platform. We are hoping to relax this limitation in the revision of the standard.
  • description: This is a brief paragraph describing the instrument suitable for use on a web page.
  • sponsor: This is generally an organization that sponsors the platform. Note that multiple organizations can be referenced here.
  • instrument: This describes the instrument(s) that are mounted on this platform. It would generally be done with a reference to an instrument described elsewhere in the metadata file.

Connecting Platforms and Instruments

Platforms and Instruments
The ISO 19115-2 Standard is used to describe platforms and instruments used to make observations. These objects are related to one another using the MI_Platform/instrument and MI_Instrument/mountedOn roles (see schematic UML diagram in this Figure). These relationships are illustrated schematically for a data set with two instruments and two platforms in the lower left corner of this Figure. Instrument_1 (I1) is mounted on Platform_2 (P2) and Instrument_2 (I2) is mounted on Platform_1 (P1). The XML describing these relationships is shown on the right side of the Figure. In this case ids and xlink:hrefs are used to identify and reference the instruments and platforms.

Platform Metadata

The example above shows how the platforms and instruments used to make observations are referenced from the metadata for those observations. The ISO Standard also supports the need to document the platforms themselves. This is done using the ISO Dataset Series shown in this Figure. The observing station on top of Mauna Loa provides a good example for exploring approaches to ISO platform documentation.

The Mauna Loa Platform is used for many atmospheric chemistry observations by the Global Monitoring Division of NOAA's Environmental Science Research Laboratory. The platform description provides documentation of the projects and parameters measured at this station in HTML. This documentation is easy for a human reader to understand. It has several sections:

  • The first section of the page provides basic identification and descriptive information about the station. It includes the platform identifier (MLO), coordinates (x, y, z), and contact information. The organization of the page makes it clear that this information applies to all of the observations made at this platform.
  • The remaining sections describe seven projects that use the MLO platform for making observations. Each of these projects has observed a variety of parameters, mostly chemical species, over a variety of time periods.

This page documents the MLO platform very nicely for human readers. It is a web page, so it is written in HTML. How would this same information be presented in ISO metadata?

Metadata Application
The idea of collections of related documentation is included in the ISO Standards as a very general DS_Aggregate object. The <<Abstract>> label and the triangle arrow below the DS_Aggregate object indicate that there are a number of kinds of collections, including those related to a platform (DS_Platform) or to a sensor (DS_Sensor). The MultipleAggregation line to the left of the DS_Aggregate object shows that collections can include other collects as subsets and can be included in larger supersets.

MLO UML
The translation of this UML into a picture relevant to the MLO case is shown in the MLO UML Figure. The observations made at platform MLO include subsets made by the Carbon Cycle Surface Flask sensor, the HATS In Situ Observatory sensor, and the Surface Ozone sensor (as well as four other sensors that were left out of the picture). This conceptual model is represented (schematically) in ISO 19139 XML as:
<gmd:DS_Platform>
   <gmd:composedOf/> <!-- Empty at present, no data outside of subsets -->
   <gmd:seriesMetadata/> <!-- Described below -->
   <gmd:subset> <!-- Carbon Cycle Surface Flasks -->
      <gmd:DS_Sensor>
         <gmd:composedOf/> <!-- Observation Documentation -->
         <gmd:seriesMetadata/> <!-- Sensor Documentation -->
      </gmd:DS_Sensor>
   </gmd:subset>
   <gmd:subset> <!-- Carbon Cycle In Situ Observatory -->
      <gmd:DS_Sensor>
         <gmd:composedOf/> <!-- Observation Documentation -->
         <gmd:seriesMetadata/> <!-- Sensor Documentation -->
      </gmd:DS_Sensor>
   </gmd:subset>
   <gmd:subset> <!-- HATS In Situ Observatory: -->
      <gmd:composedOf/> <!-- Observation Documentation -->
      <gmd:seriesMetadata/> <!-- Sensor Documentation -->
   </gmd:subset>
   <gmd:subset> <!-- Aerosol Surface, Continuous Measurements -->
      <gmd:DS_Sensor>
         <gmd:composedOf/> <!-- Observation Documentation -->
         <gmd:seriesMetadata/> <!-- Sensor Documentation -->
       </gmd:DS_Sensor>
  </gmd:subset>
   <gmd:subset> <!-- Surface Ozone -->
       <gmd:DS_Sensor>
          <gmd:composedOf/> <!-- Observation Documentation -->
          <gmd:seriesMetadata/> <!-- Sensor Documentation -->
      </gmd:DS_Sensor>
   </gmd:subset>
   <gmd:subset> <!-- Meteorology -->
      <gmd:DS_Sensor>
         <gmd:composedOf/> <!-- Observation Documentation -->
         <gmd:seriesMetadata/> <!-- Sensor Documentation -->
      </gmd:DS_Sensor>
   </gmd:subset>
</gmd:DS_Platform>

Note that this structure is not limited to collections from particular sensors. They could be any collection that makes sense and helps users understand the observations made at the platform.

This Figure also includes some of the other elements that are available in the DS_Platform and DS_Seneor objects. First is the seriesMetadata element. The UML above shows that this object is a MI_Metadata object, a complete metadata record. It holds documentation that is shared by all of the observations made by this platform. This is exactly the information that is included in the first section of the HTML version of the MLO platform description. Some details of the seriesMetadata will be discussed below.

The other additional element that is shown is the composedOf element. This is a DS_DataSet object that contains (has) one or more MI_Metadata objects. These are the members of the collection. They could be metadata records that describe the products available for each sensor or they could describe different deployments. Once again, their content is determined by the data provider and, ultimately, the users of the data.

At this point it seems reasonable to conclude that the structure that makes sense to human readers in HTML can be replicated in the ISO Standard. Note that this structure is also very similar a directory structure that might be used to hold metadata records or data files. The top level directory would be the platform and it would have a sub-directory for each project or sensor on the platform. Each of those sub-directories would hold data files which are equivalent to the MI_Metadata records included in the DS_DataSet. All of the directories could contain a readme.txt file that described the contents of the directory which is equivalent to the seriesMetadata.

Platform seriesMetadata

The seriesMetadata section of the HTML page holds documentation that is relevant to all of the observations made at the platform, including the basic identification and descriptive information from the HTML version of the documentation (platform identifier (MLO), coordinates (x, y, z), and contact information). Most of this information fits easily into the MD_IdentificationInformation section. The seriesmetadata also contains ISO Boilerplate and other information to facillitate discovery. Specifically:

gmd:MD_DataIdentification/gmd:citation

Gives a citation to the platform description. The originator of the page this page is the Global Monitoring Division website.

gmd:MD_DataIdentification/gmd:abstract

Gives a short description of the Platform. It is the Description from the platform description:

<gmd:abstract>
   <gco:CharacterString>Mauna Loa Observatory is located on the Island of Hawaii at an elevation of 3397 m on the northern
      flank of Mauna Loa volcano at 200 north. Established in 1957, Mauna Lao Observatory has grown to become the premier
      long-term atmospheric monitoring facility on earth and is the site where the ever-increasing concentrations of global
      atmospheric carbon dioxide were determined. The observatory consists of 10 buildings from which up to 250 different
      atmospheric parameters are measured by a complement of 12 NOAA/ESRL and other agency scientists and engineers
   </gco:CharacterString>
</gmd:abstract>

gmd:MD_DataIdentification/gmd:pointOfContact

Gives contact information for the platform:

<gmd:pointOfContact>
    <gmd:CI_ResponsibleParty>
        <gmd:individualName>
            <gco:CharacterString>John Barnes</gco:CharacterString>
        </gmd:individualName>
        <gmd:organisationName>
            <gco:CharacterString>DOC/NOAA/ESRL/GMD > Global Monitoring Division, Earth System Research Laboratory, NOAA, U.S. Department of
                Commerce</gco:CharacterString>
        </gmd:organisationName>
        <gmd:positionName>
            <gco:CharacterString>NOSA Observing System Manager</gco:CharacterString>
        </gmd:positionName>
        <gmd:contactInfo>
            <gmd:CI_Contact>
                <gmd:phone>
                    <gmd:CI_Telephone>
                        <gmd:voice>
                            <gco:CharacterString>(808) 933-6965</gco:CharacterString>
                        </gmd:voice>
                        <gmd:facsimile>
                            <gco:CharacterString>(808)933-6967</gco:CharacterString>
                        </gmd:facsimile>
                    </gmd:CI_Telephone>
                </gmd:phone>
                <gmd:address>
                    <gmd:CI_Address>
                        <gmd:deliveryPoint>
                            <gco:CharacterString>NOAA - Mauna Loa Observatory 1437 Kilauea Ave. #102</gco:CharacterString>
                        </gmd:deliveryPoint>
                        <gmd:city>
                            <gco:CharacterString>Hilo</gco:CharacterString>
                        </gmd:city>
                        <gmd:administrativeArea>
                            <gco:CharacterString>HI</gco:CharacterString>
                        </gmd:administrativeArea>
                        <gmd:postalCode>
                            <gco:CharacterString>96720</gco:CharacterString>
                        </gmd:postalCode>
                        <gmd:country>
                            <gco:CharacterString>USA</gco:CharacterString>
                        </gmd:country>
                        <gmd:electronicMailAddress>
                            <gco:CharacterString>John.E.Barnes@noaa.gov</gco:CharacterString>
                        </gmd:electronicMailAddress>
                    </gmd:CI_Address>
                </gmd:address>
                <gmd:hoursOfService>
                    <gco:CharacterString>7:30 - 5:00 UTC-10</gco:CharacterString>
                </gmd:hoursOfService>
            </gmd:CI_Contact>
        </gmd:contactInfo>
        <gmd:role>
            <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="pointOfContact">pointOfContact</gmd:CI_RoleCode>
        </gmd:role>
    </gmd:CI_ResponsibleParty>
</gmd:pointOfContact>

gmd:MD_DataIdentification/gmd:graphicOverview

Gives links to pictures of the platform:

<gmd:graphicOverview>
    <gmd:MD_BrowseGraphic>
        <gmd:fileName>
            <gco:CharacterString>http://www.esrl.noaa.gov/gmd/Photo_Gallery/Field_Sites/MLO/</gco:CharacterString>
        </gmd:fileName>
        <gmd:fileDescription>
            <gco:CharacterString>A collection of images of MLO</gco:CharacterString>
        </gmd:fileDescription>
    </gmd:MD_BrowseGraphic>
</gmd:graphicOverview>

gmd:MD_DataIdentification/gmd:resourceFormat

Gives information about the native format(s) of the platform observations:

<gmd:resourceFormat>
    <gmd:MD_Format>
        <gmd:name>
            <gco:CharacterString>ASCII</gco:CharacterString>
        </gmd:name>
        <gmd:version gco:nilReason="unknown"/>
        <gmd:specification>
            <gco:CharacterString>http://www.esrl.noaa.gov/gmd/aero/data/datafmt.html</gco:CharacterString>
        </gmd:specification>
    </gmd:MD_Format>
</gmd:resourceFormat>

gmd:MD_DataIdentification/gmd:aggregationInfo

Gives information about programs/projects that the Platform is part of (largerWorkCitations) or related to (crossReferences). See ISO AggregationInformation for more information. Citations to these programs/projects are likely to be used in many records, so this is a good place to taks advantage of ISO Components:

<gmd:aggregationInfo xlink:href="http://www.ngdc.noaa.gov/docucomp/abe67960-48ab-11df-9879-0800200c9a66"/><!-- Global Monitoring Division -->
<gmd:aggregationInfo xlink:href="http://www.ngdc.noaa.gov/docucomp/abe67963-48ab-11df-9879-0800200c9a66"/><!-- Carbon Cycle Surface Flasks -->
<gmd:aggregationInfo xlink:href="http://www.ngdc.noaa.gov/docucomp/abe67964-48ab-11df-9879-0800200c9a66"/><!-- Carbon Cycle In Situ Observatory -->
<gmd:aggregationInfo xlink:href="http://www.ngdc.noaa.gov/docucomp/abe67965-48ab-11df-9879-0800200c9a66"/><!-- HATS In Situ Observatory -->
<gmd:aggregationInfo xlink:href="http://www.ngdc.noaa.gov/docucomp/abe67966-48ab-11df-9879-0800200c9a66"/><!-- Surface Ozone -->
<gmd:aggregationInfo xlink:href="http://www.ngdc.noaa.gov/docucomp/abe67961-48ab-11df-9879-0800200c9a66"/><!-- Dobson Total Ozone -->
<gmd:aggregationInfo xlink:href="http://www.ngdc.noaa.gov/docucomp/abe67962-48ab-11df-9879-0800200c9a66"/><!-- Meteorology -->

gmd:MD_DataIdentification/gmd:descriptiveKeywords

Gives keywords from various controlled vocabularies in order to facilitate discovery. The keyword lists from the NASA Global Change Master Directory and the NIST Chemistry Webbook (for chemical compounds) might be useful for the MLO data:

<gmd:descriptiveKeywords>
    <gmd:MD_Keywords>
        <gmd:keyword>
            <gco:CharacterString>Benzene</gco:CharacterString>
        </gmd:keyword>
        <gmd:keyword>
            <gco:CharacterString>Carbon Dioxide</gco:CharacterString>
        </gmd:keyword>
        <gmd:keyword>
            <gco:CharacterString>Carbon Monoxide</gco:CharacterString>
        </gmd:keyword>
        <gmd:keyword>
            <gco:CharacterString>other compounds measured at MLO fill out this list</gco:CharacterString>
        </gmd:keyword>
        <gmd:type>
            <gmd:MD_KeywordTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode" codeListValue="theme">theme</gmd:MD_KeywordTypeCode>
        </gmd:type>
        <gmd:thesaurusName>
            <gmd:CI_Citation>
                <gmd:title>
                    <gco:CharacterString>NIST Chemistry WebBook NIST Standard Reference Database Number 69</gco:CharacterString>
                </gmd:title>
                <gmd:date>
                    <gmd:CI_Date>
                        <gmd:date>
                            <gco:Date>20100201</gco:Date>
                        </gmd:date>
                        <gmd:dateType>
                            <gmd:CI_DateTypeCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode" codeListValue="revision"/>
                        </gmd:dateType>
                    </gmd:CI_Date>
                </gmd:date>
                <gmd:citedResponsibleParty>
                    <gmd:CI_ResponsibleParty>
                        <gmd:individualName>
                            <gco:CharacterString>P.J. Linstrom and W.G. Mallard</gco:CharacterString>
                        </gmd:individualName>
                        <gmd:organisationName>
                            <gco:CharacterString>DOC/NIST > National Institute of Standards and Technology, U.S. Department of Commerce</gco:CharacterString>
                        </gmd:organisationName>
                        <gmd:contactInfo>
                            <gmd:CI_Contact>
                                <gmd:onlineResource>
                                    <gmd:CI_OnlineResource>
                                        <gmd:linkage>
                                            <gmd:URL>http://webbook.nist.gov/chemistry/</gmd:URL>
                                        </gmd:linkage>
                                        <gmd:name>
                                            <gco:CharacterString>NIST Chemistry WebBook NIST Standard Reference Database Number 69</gco:CharacterString>
                                        </gmd:name>
                                        <gmd:description>
                                            <gco:CharacterString>The NIST Chemistry WebBook provides users with easy access to chemical and physical property data for chemical species through the
                                                internet. The data provided in the site are from collections maintained by the NIST Standard Reference Data Program and outside contributors. Data in
                                                the WebBook system are organized by chemical species. The WebBook system allows users to search for chemical species by various means. Once the desired
                                                species has been identified, the system will display data for the species. </gco:CharacterString>
                                        </gmd:description>
                                    </gmd:CI_OnlineResource>
                                </gmd:onlineResource>
                            </gmd:CI_Contact>
                        </gmd:contactInfo>
                        <gmd:role>
                            <gmd:CI_RoleCode codeList="http://www.isotc211.org/2005/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="custodian">custodian</gmd:CI_RoleCode>
                        </gmd:role>
                    </gmd:CI_ResponsibleParty>
                </gmd:citedResponsibleParty>
            </gmd:CI_Citation>
        </gmd:thesaurusName>
    </gmd:MD_Keywords>
</gmd:descriptiveKeywords>

gmd:MD_DataIdentification/gmd:extent

Gives the bounding temporal and spatial extent of the observations from the Platform. This is the union of the subset extents. It includes the id="boundingExtent" in order to simplify external access to this information and facilitate discovery:

<gmd:extent>
    <gmd:EX_Extent id="boundingExtent">
        <gmd:description>
            <gco:CharacterString>MLO Bounding Extent</gco:CharacterString>
        </gmd:description>
        <gmd:geographicElement>
            <gmd:EX_GeographicBoundingBox id="boundingGeographicBoundingBox">
                <gmd:extentTypeCode>
                    <gco:Boolean>1</gco:Boolean>
                </gmd:extentTypeCode>
                <gmd:westBoundLongitude>
                    <gco:Decimal>-155.5763</gco:Decimal>
                </gmd:westBoundLongitude>
                <gmd:eastBoundLongitude>
                    <gco:Decimal>-155.5763</gco:Decimal>
                </gmd:eastBoundLongitude>
                <gmd:southBoundLatitude>
                    <gco:Decimal>19.5362</gco:Decimal>
                </gmd:southBoundLatitude>
                <gmd:northBoundLatitude>
                    <gco:Decimal>19.5362</gco:Decimal>
                </gmd:northBoundLatitude>
            </gmd:EX_GeographicBoundingBox>
        </gmd:geographicElement>
        <gmd:temporalElement>
            <gmd:EX_TemporalExtent id="boundingTemporalExtent">
                <gmd:extent>
                    <gml:TimePeriod gml:id="tp_bound">
                        <gml:begin>
                            <gml:TimeInstant gml:id="tp_start">
                                <gml:timePosition>1963-12-26</gml:timePosition>
                            </gml:TimeInstant>
                        </gml:begin>
                        <gml:end>
                            <gml:TimeInstant gml:id="tp_end">
                                <gml:timePosition indeterminatePosition="now"/>
                            </gml:TimeInstant>
                        </gml:end>
                    </gml:TimePeriod>
                </gmd:extent>
            </gmd:EX_TemporalExtent>
        </gmd:temporalElement>
        <gmd:verticalElement>
            <gmd:EX_VerticalExtent>
                <gmd:minimumValue>
                    <gco:Real>3397</gco:Real>
                </gmd:minimumValue>
                <gmd:maximumValue>
                    <gco:Real>3397</gco:Real>
                </gmd:maximumValue>
                <gmd:verticalCRS gco:nilReason="unknown"/>
            </gmd:EX_VerticalExtent>
        </gmd:verticalElement>
    </gmd:EX_Extent>
</gmd:extent>