Essential Ocean Variables

Essential Ocean Variables#

This section details initial documentation of approaches for describing elements of a schema:Dataset with a focus on approaches supporting Essential Ocean Variables.

A rough description of these links leveraging pseudo schema.org terms follows with a detailed and valid data graph as an example after that.

Reference image:

notes image

The image above details out some of the key points to be encoded. These include:

Links to and description of methods
QA/QC references
Links to GOOS Specification sheets
Information on variables measured
Connections to the event measured and potential associated instruments
Spatial coverage
Temporal coverage

The valid data graph follows the reference section and details follow that. The highlighted lines in the data graph represented the detailed sections.

References:#

{
    "@context": {
        "@vocab": "https://schema.org/"
    },
    "@type": "Dataset",
    "@id": "https://example.org/permanentUrlToThisJsonDoc",
    "name": "Example Vessel Surveys Jan-Apr 2007",
    "description": "Original provider: HDR Environmental, Operations and Construction, Inc. Dataset credits: The U.S. Navy Marine Species Monitoring Program Abstract:Features in this feature class represent sightings from the NAVFAC MISTCS Vessel Surveys Jan-Apr 2007.",
    "url": "https://obis.org/dataset/dcbb8f12-c869-4d31-aa8b-23abb27898ce",
    "license": "This work is licensed under a  Creative Commons Attribution (CC-BY) 4.0 License",
    "citation": "Ampela, K. and G. Miller-Francisco. 2017. MIRC NAVFAC MISTCS Vessel Surveys Jan-Apr 2007. Data downloaded from OBIS-SEAMAP (http://seamap.env.duke.edu/dataset/1519) on yyyy-mm-dd.",
    "version": "2021-04-24T06:34:56.000Z",
    "keywords": [
        "Sea State",
        "Mariana Islands Range Complex",
        "Oceanography",
        "Marine Physics"
    ],
    "variableMeasured": [
        {
            "@type": "PropertyValue",
            "name": "Sea State",
            "description": "Sea State is the characterization of wave and swell, typically in terms of height, wavelength, period, and directional wave energy flux ",
            "propertyID": [
                "http://purl.obolibrary.org/obo/ENVO_01001374",
                "https://gcmd.earthdata.nasa.gov/KeywordViewer/scheme/all/11aca777-8a01-42ce-b076-b3059c3d8cae?gtm_keyword=SEA%20STATE&gtm_scheme=Earth%20Science"
            ]
        },
        {
            "@type": "PropertyValue",
            "name": "Ocean Surface Stress",
            "description": "The 2-dimensional horizontal vector Ocean Surface Stress is the rate per unit area at which momentum is transferred from the atmosphere to the ocean.",
            "propertyID": "http://purl.obolibrary.org/obo/ENVO_01001844",
            "value": 0.2,
            "unitCode": "http://qudt.org/vocab/unit/N-PER-M2"
        }
    ],
    "measurementTechnique": [
        "http://dx.doi.org/10.1002/exampleMethodsSeaStateDOI.ch1",
        "http://dx.doi.org/10.1002/exampleMethodsOceanStressDOI.ch1"
    ],
    "publishingPrinciples": [
        {
            "@type": "CreativeWork",
            "url": "http://www.goosocean.org/components/com_oe/oe.php?task=download&id=34494&version=1.0&lang=1&format=1",
            "name": "Ocean Observations Physics and Climate Panel (OOPC) Sea State GOOS EOV Specification Sheet",
            "description": "This is the EOV specification sheet released by GOOS for Sea State.  It was composed by the Ocean Observations Panel for Climate.  OOPC is sponsored by the Global Ocean Observing System the Global Climate Observing System and the World Climate Research Program. OOPC provides advice on scientific requirements to the Joint Commission for Oceanography and Marine Meteorology. "
        },
        {
            "@type": "CreativeWork",
            "url": "http://www.goosocean.org/components/com_oe/oe.php?task=download&id=34507&version=1.0&lang=1&format=1",
            "name": "Ocean Observations Physics and Climate Panel (OOPC) Ocean Surface Stress GOOS EOV Specification Sheet",
            "description": "This is the EOV specification sheet released by GOOS for Ocean Surface Stress.  It was composed by the Ocean Observations Panel for Climate.  OOPC is sponsored by the Global Ocean Observing System the Global Climate Observing System and the World Climate Research Program. OOPC provides advice on scientific requirements to the Joint Commission for Oceanography and Marine Meteorology. "
        },
        {
            "@type": "CreativeWork",
            "url": "http://example.org/id/doc/ID",
            "name": "QA/QC guidance",
            "description": "QA/QC  - EOV data and the methods used to generate them should have been vetted through some QA/QC methods, ideally performed by an independent third-party. These should be included in a dedicated JSON-LD block, even if it points to the same methodology linked to in the measurementTechnique block. "
        }
    ],
    "distribution": {
        "@type": "DataDownload",
        "contentUrl": "http://example.org/archive.do?r=zd_1519",
        "encodingFormat": "application/zip"
    },
    "spatialCoverage": {
        "@type": "Place",
        "geo": {
            "@type": "GeoShape",
            "description": "schema.org expects lat long (Y X) coordinate order",
            "polygon": "10.161667 142.014,18.033833 142.014,18.033833 147.997833,10.161667 147.997833,10.161667 142.014"
        },
        "additionalProperty": {
            "@type": "PropertyValue",
            "propertyID": "https://dbpedia.org/page/Spatial_reference_system",
            "value": "https://www.w3.org/2003/01/geo/wgs84_pos"
        }
    },
    "provider": [
        {
            "@id": "https://oceanexpert.org/institution/INSTITUTE_ID",
            "@type": "Organization",
            "legalName": "Example University",
            "name": "Example University",
            "url": "https://oceanexpert.org/institution/INSTITUTE_ID"
        }
    ],
    "about": {
        "@type": "Event",
        "description": "describe the activity, might include name here too.",
        "name": "Measurement of sea state",
        "potentialAction": [
            {
                "@type": "Action",
                "name": "Measurement of sea state",
                "instrument": {
                    "@type": "Thing",
                    "name": "OceanWaveS WaMoS II 500 waves and surface current radar",
                    "url": "http://vocab.nerc.ac.uk/collection/L22/current/TOOL0999/",
                    "description": "The WaMoS II 500 radar is an industry-proven X-band radar-based wave and surface current monitoring system developed by OceanWaveS. This sensor is able to measure and displays essential wave field parameters including wave heights, periods, directions and surface currents. The operating range extends to 4.0 km depending on X-band radar type and installation gemoetry. Requiring a minimum wind speed of 3 m/s and a minimum wave height of about 0.5m."
                }
            },
            {
                "@type": "Action",
                "name": "Measurement of ocean stress",
                "instrument": {
                    "@type": "Thing",
                    "name": "Metek uSonic-3 Scientific {formerly: USA-1} ultrasonic anemometer",
                    "url": "http://vocab.nerc.ac.uk/collection/L22/current/TOOL1402/",
                    "description": "A high precision 3D sonic anemometer. Typical applications for this device include: meteorological systems, meteorological networks, measuring dispersion parameters for pollution modelling, research stations, industrial sites, air quality forecasts, eddy correlation fluxes, marine and offshore platforms, wind shear detection, wind energy, and wake vortex monitoring. This device takes accurate measurement of 3 wind components and turbulence. Constructed with stainless steel. "
                }
            }
        ]
    },
    "datePublished": "2018-07-29",
    "dateModified": "2018-07-30T14:30Z",
    "temporalCoverage": "2012-09-20/2016-01-22"
}

Tip

@id around line#6 should point to whatever resolves eventually to the JSON-LD - if you only have an external JSON-LD file (and not embedded into the html <script> tag) then the @id should point to the .json file itself. Otherwise, @id should point to the landing page of the record (HTML page), that embeds the JSON-LD.

license#

As licenses are an important cross-cutting item there is a separate section on licenses at: License chapter

keywords#

As keywords are an important cross-cutting item there is a separate section on keywords at: Keywords chapter

variableMeasured#

A key section detailing approaches to describing variables. This property expects either of text or the more detailed schema:PropertyValue.

Note

There can be multiple links in the proertyID property. Preference should be given to those with semantic descriptions.

Note

In cases where a single value can be associated with a variable, or a min max value, this can be provided along with a unitCode property. In cases where a variable represents a large collection of data this can be omitted and the data obtained in a distribution reference.

measurementTechnique#

https://schema.org/measurementTechnique is used to provide either text about or a URL to information about the techniques or technology used in a Dataset.

{
    "@context": {
        "@vocab": "https://schema.org/"
    },
    "@id": "https://example.org/permanentUrlToThisJsonDoc",
    "@type": "Dataset",
    "measurementTechnique": [
        "http://dx.doi.org/10.1002/exampleMethodsSeaStateDOI.ch1",
        "http://dx.doi.org/10.1002/exampleMethodsOceanStressDOI.ch1"
    ]
}

../../_images/7128f2679d72448c4a3a01c672d9f16fe0367607e574e5a2c63008402b148805.svg

publishingPrinciples#

As defined in the Linking to Principles section on publishing principles, This can be used to connect CreativeWork, Organization, or Person to either of CreativeWork or URL. So this allows us to link a CreativeWork to a policy or principle statement. This has some very useful use cases where resources can be grouped based on their connection to those principles and policies.

For this section on EOVs, it is used to link in the specification sheets for the measured variables. This can also be used to link in QA/QC documentation. There is no direct connection between the creative works linked here and the measured variables though convention would be to keep the order the same if possible. Such order is not maintained through potential serialization of the JSON-LD records though list order can be maintained with an @list keyword.

{
    "@context": {
        "@vocab": "https://schema.org/"
    },
    "@id": "https://example.org/permanentUrlToThisJsonDoc",
    "@type": "Dataset",
    "publishingPrinciples": [
        {
            "@type": "CreativeWork",
            "description": "This is the EOV specification sheet released by GOOS for Sea State.  It was composed by the Ocean Observations Panel for Climate.  OOPC is sponsored by the Global Ocean Observing System the Global Climate Observing System and the World Climate Research Program. OOPC provides advice on scientific requirements to the Joint Commission for Oceanography and Marine Meteorology. ",
            "name": "Ocean Observations Physics and Climate Panel (OOPC) Sea State GOOS EOV Specification Sheet",
            "url": "http://www.goosocean.org/components/com_oe/oe.php?task=download&id=34494&version=1.0&lang=1&format=1"
        },
        {
            "@type": "CreativeWork",
            "description": "This is the EOV specification sheet released by GOOS for Ocean Surface Stress.  It was composed by the Ocean Observations Panel for Climate.  OOPC is sponsored by the Global Ocean Observing System the Global Climate Observing System and the World Climate Research Program. OOPC provides advice on scientific requirements to the Joint Commission for Oceanography and Marine Meteorology. ",
            "name": "Ocean Observations Physics and Climate Panel (OOPC) Ocean Surface Stress GOOS EOV Specification Sheet",
            "url": "http://www.goosocean.org/components/com_oe/oe.php?task=download&id=34507&version=1.0&lang=1&format=1"
        },
        {
            "@type": "CreativeWork",
            "description": "QA/QC  - EOV data and the methods used to generate them should have been vetted through some QA/QC methods, ideally performed by an independent third-party. These should be included in a dedicated JSON-LD block, even if it points to the same methodology linked to in the measurementTechnique block. ",
            "name": "QA/QC guidance",
            "url": "http://example.org/id/doc/ID"
        }
    ]
}

../../_images/8f377f841e926b3f73ff631ec5a5406308d2154c92e01ae1caf56609f28b93cd.svg

spatialCoverage#

More details on spatial elements are found at: Spatial Geometry

{
    "@context": {
        "@vocab": "https://schema.org/"
    },
    "@id": "https://example.org/permanentUrlToThisJsonDoc",
    "@type": "Dataset",
    "spatialCoverage": {
        "@type": "Place",
        "additionalProperty": {
            "@type": "PropertyValue",
            "propertyID": "https://dbpedia.org/page/Spatial_reference_system",
            "value": "https://www.w3.org/2003/01/geo/wgs84_pos"
        },
        "geo": {
            "@type": "GeoShape",
            "description": "schema.org expects lat long (Y X) coordinate order",
            "polygon": "10.161667 142.014,18.033833 142.014,18.033833 147.997833,10.161667 147.997833,10.161667 142.014"
        }
    }
}

../../_images/bc802aebbdfc7e309cee8cefb21cb0d0889c412933caa92c012587a0eb217e0f.svg

about#

This section is an attempt to leverage schema.org to link instrument information. This is done via the Event type with a connected Action type.

temporalCoverage#

Representation of temporal coverage follows ISO 8601 patterns. ESIP Science on Schema as has patterns for Deep Time (geologic time) patterns.

Science on Schema temporalCoverage#

Example from Science on Schema recommendations:

{    "@context": {
    "@vocab": "https://schema.org/",
    "time": "http://www.w3.org/2006/time#"
},

"@type": "Dataset",
    "description": "Eruptive activity at Mt. St. Helens, Washington, March 1980 - January 1981",
    "temporalCoverage": ["1980-03-27T19:36:00/1981-01-03T00:00:00Z",
        {
            "@type": "time:ProperInterval",
            "time:hasBeginning": {
                 "@type": "time:Instant",
                 "time:inXSDDateTimeStamp": "1980-03-27T19:36:00Z"
             },
             "time:hasEnd": {
                "@type": "time:Instant",
                "time:inXSDDateTimeStamp": "1981-01-03T00:00:00Z"
             }
        }]
}