diff --git a/kpi/wcmp2-kpi-DRAFT.docx b/kpi/wcmp2-kpi-DRAFT.docx index 1e8720d..bb46019 100644 Binary files a/kpi/wcmp2-kpi-DRAFT.docx and b/kpi/wcmp2-kpi-DRAFT.docx differ diff --git a/kpi/wcmp2-kpi-DRAFT.html b/kpi/wcmp2-kpi-DRAFT.html index a334adb..a061cd0 100644 --- a/kpi/wcmp2-kpi-DRAFT.html +++ b/kpi/wcmp2-kpi-DRAFT.html @@ -1653,7 +1653,7 @@

8.6. Examples

diff --git a/kpi/wcmp2-kpi-DRAFT.pdf b/kpi/wcmp2-kpi-DRAFT.pdf index ae3fe1f..657d487 100644 Binary files a/kpi/wcmp2-kpi-DRAFT.pdf and b/kpi/wcmp2-kpi-DRAFT.pdf differ diff --git a/standard/wcmp2-DRAFT.docx b/standard/wcmp2-DRAFT.docx index b917eb9..66c75c9 100644 Binary files a/standard/wcmp2-DRAFT.docx and b/standard/wcmp2-DRAFT.docx differ diff --git a/standard/wcmp2-DRAFT.html b/standard/wcmp2-DRAFT.html index a29bcfc..44cba74 100644 --- a/standard/wcmp2-DRAFT.html +++ b/standard/wcmp2-DRAFT.html @@ -1292,16 +1292,14 @@

7. The WMO Core Metadata Profile Record

-

A WCMP record provides descriptive information about a dataset made available -through WIS2.

+

A WCMP record provides descriptive information about a dataset made available through WIS2.

7.1. Conformance Class Core

7.1.1. Overview

-

The WCMP Core Conformance Class provides requirements to articulate the required elements -of a WCMP discovery metadata record.

+

The WCMP Core Conformance Class provides requirements for a WCMP discovery metadata record.

@@ -1366,12 +1364,12 @@

7.1.1. Overview

- + - + @@ -1381,12 +1379,12 @@

7.1.1. Overview

- + - + @@ -1396,7 +1394,7 @@

7.1.1. Overview

- + @@ -1411,7 +1409,7 @@

7.1.1. Overview

- + @@ -1441,22 +1439,22 @@

7.1.1. Overview

- + - + - + - + @@ -1466,7 +1464,7 @@

7.1.1. Overview

- +

id

required

A unique identifier to the dataset (see Identifier)

A unique identifier of the dataset (see Identifier)

type

required

A fixed value denoting the record as a GeoJSON Feature (see Validation)

A fixed value denoting the WCMP record as a GeoJSON Feature (see Validation)

conformsTo

properties.type

required

The resource type described by the record (see Properties / Type)

The resource type described by the WCMP record (see Properties / Type)

properties.title

required

A human-readable name for a given dataset (see Properties / Title)

A human-readable name of the dataset (see Properties / Title)

properties.description

properties.keywords

optional

Keywords, tags, key phrases, or classification codes (see Properties / Keywords)

Keywords, tags or key phrases (see Properties / Keywords)

properties.themes

time

required

Temporal extent associated with a dataset (see Temporal Extent)

Temporal extent associated with the dataset (see Temporal Extent)

additionalExtents.spatial

properties.created

required

The date that the record was created (see Properties / Record Creation Date)

The date that the WCMP record was created (see Properties / Record Creation Date)

properties.updated

optional

The date that the record was updated (see Properties / Record Update Date)

The date that the WCMP record was updated (see Properties / Record Update Date)

properties.status

optional

The operational status of a given dataset (see Properties / Status)

The operational status of the dataset (see Properties / Status)

properties.wmo:dataPolicy

conditional

WMO data policy as per Resolution 1 (Cg-Ext(2021) [30]. Required for datasets (see Properties / WMO Data Policy)

Classification code of core or recommended based on the WMO Unified Data Policy[30]. Required for datasets (see Properties / WMO Data Policy)

links

properties.*

optional

Additional properties as required (see Additional Properties)

Additional properties as needed (see Additional Properties)
@@ -1503,7 +1501,7 @@

7.1.2. Validation

C

-

Each WCMP record type property SHALL be set to a fixed value of Feature for GeoJSON compliance.

+

The type property SHALL be set to a fixed value of Feature for GeoJSON compliance.

@@ -1513,8 +1511,7 @@

7.1.2. Validation

7.1.3. Identifier

The id property is a unique identifier -of the dataset. A record identifier is essential for querying and identifying -records within the GDC.

+of the dataset. A record identifier is essential for querying and identifying records within the GDC.

Example
@@ -1537,25 +1534,25 @@

7.1.3. Identifier

A

-

A WCMP record SHALL have an identifier via the id property.

+

A WCMP record SHALL provide an identifier via the id property.

B

-

A WCMP record identifier SHALL have the following notation: urn:x-wmo:md:{centre_id}:{local_identifier}.

+

The id property SHALL have the following notation: urn:x-wmo:md:{centre_id}:{local_identifier}.

C

-

A WCMP record identifier SHALL include a centre_id based on the associated vocabulary specified in the WIS topic hierarchy.

+

Thecentre_id SHALL be based on the associated vocabulary specified in the WIS topic hierarchy.

D

-

A WCMP record identifier SHALL include a local identifier as defined by the data publisher. The local identifier SHALL NOT have spaces or special or accented characters.

+

The id property SHALL include a local identifier as defined by the data publisher. The local identifier SHALL NOT have spaces or special or accented characters.

@@ -1575,7 +1572,7 @@

7.1.3. Identifier

A

-

A WCMP record identifier’s local identifier MAY also have colons (:) as required by the data publisher.

+

The local identifier MAY also have colons (:) as required by the data publisher.

@@ -1616,7 +1613,7 @@

7.1.4. Conf

B

-

A WCMP record conformsTo property SHALL advertise conformance to WCMP.

+

The`conformsTo` property SHALL advertise conformance to WCMP.

@@ -1668,7 +1665,7 @@

7.1.5.

B

-

A WCMP record’s properties.type property SHALL provide a valid resource type from the WCMP resource type codelist [31].

+

The properties.type property SHALL be a valid code from the WCMP resource type codelist[31].

@@ -1755,7 +1752,7 @@

7.1.8. Properties / Keywords

-

The keywords property is a list keywords, tags, specific phrases, or classification codes associated with the resource, but are not referenced to a particular vocabulary or knowledge organization system.

+

The keywords property is a list of keywords, tags or specific phrases associated with the resource, but are not referenced to a particular vocabulary or knowledge organization system.

Example
@@ -1796,13 +1793,15 @@

7.1.9. Properties / Themes

-

The themes property is a list of concepts that are referenced to a vocabulary or knowledge organization system used to classify the resource. A concept’s id -provides an identifier for the given concept, as well as optional title, description and url properties to further describe the concept as desired.

+

The themes property is a list of concepts that are referenced to a vocabulary or knowledge organization system used to classify the resource.

A theme’s scheme property provides a remote reference to a controlled vocabulary, codelist or knowledge organization system.

+

A concept’s id provides an identifier for the given concept, as well as optional title, description and url properties to further describe the concept as desired.

+
+

A concept’s optional url property can provide a remote reference to a given concept (for example, to an online ontology or code registry).

@@ -1818,19 +1817,19 @@

7.1 "concepts": [ { "id": "Temperature", - "url": "http://codes.wmo.int/grib2/codeflag/4.2/_0-0-0" + "url": "http://codes.wmo.int/grib2/codeflag/4.2/0-0-0" }, { "id": "Relative humidity", - "url": "http://codes.wmo.int/grib2/codeflag/4.2/_0-1-1" + "url": "http://codes.wmo.int/grib2/codeflag/4.2/0-1-1" }, { "id": "u-component of Wind", - "url": "http://codes.wmo.int/grib2/codeflag/4.2/_0-2-2" + "url": "http://codes.wmo.int/grib2/codeflag/4.2/0-2-2" }, { "id": "v-component of Wind", - "url": "http://codes.wmo.int/grib2/codeflag/4.2/_0-2-3" + "url": "http://codes.wmo.int/grib2/codeflag/4.2/0-2-3" } ], "scheme": "http://codes.wmo.int/grib2/codeflag/4.2" @@ -1847,11 +1846,11 @@

7.1 "concepts": [ { "id": "Temperature/air temperature", - "url": "http://codes.wmo.int/bufr4/b/12/_001" + "url": "http://codes.wmo.int/bufr4/b/12/001" }, { "id": "Dewpoint temperature", - "url": "http://codes.wmo.int/bufr4/b/12/_003" + "url": "http://codes.wmo.int/bufr4/b/12/003" } ], "scheme": "http://codes.wmo.int/bufr4/b" @@ -1867,7 +1866,7 @@

7.1 { "concepts": [{ "id": "weather", - "url": "https://github.com/wmo-im/wis2-topic-hierarchy/blob/main/topic-hierarchy/earth-system-discipline/index.csv#L2" + "url": "http://codes.wmo.int/topic-hierarchy/earth-system-discipline/weather" }], "scheme": "https://github.com/wmo-im/wis2-topic-hierarchy/blob/main/topic-hierarchy/earth-system-discipline/index.csv" } @@ -1889,33 +1888,27 @@

7.1

-

A

-
-

A WCMP record SHALL use themes/concepts when describing a dataset based on an associated controlled vocabulary.

-
- -

B

-

A WCMP record SHALL provide at least one theme.

+

A WCMP record SHALL provide at least one themes property.

C

-

Within each theme, a WCMP record SHALL provide at least one concept.

+

Each themes property SHALL provide at least one concept property.

D

-

Within each theme, a WCMP record SHALL provide a scheme that refers to a controlled vocabulary or thesaurus.

+

Each themes property SHALL provide a scheme property that refers to a controlled vocabulary or thesaurus.

E

-

A WCMP record SHALL provide a theme/concept identifying all applicable Earth system disciplines as defined in the WIS2 Topic Hierarchy.

+

A WCMP record describing a dataset SHALL provide a themes property identifying all applicable Earth system disciplines as defined in the WIS2 Topic Hierarchy.

@@ -1935,13 +1928,13 @@

7.1

A

-

A WCMP record describing a WIS2 global service SHALL provide a theme/concept identifying all Earth system disciplines as defined in WCMP codelists.

+

A WCMP record describing a WIS2 global service SHALL provide a themes property identifying all Earth system disciplines as defined in WCMP codelists.

B

-

A WCMP record describing a WIS2 global service SHALL provide a theme/concept identifying the service type provided.

+

A WCMP record describing a WIS2 global service SHALL provide a themes property identifying the service type provided.

@@ -1993,8 +1986,7 @@

7.1.10.1. Geospatial Extent

The geometry property is the general bounding spatial extent of the dataset in the geographic coordinate system. -Geospatial bounding -extents provide a useful indicator of the location of the dataset to facilitate search and map displays in the GDC.

+Geospatial bounding extents provide a useful indicator of the location of the dataset to facilitate search and map displays in the GDC.

Examples
@@ -2045,13 +2037,13 @@
7.1

B

-

A WCMP record SHALL provide geometry values as integer or float data types.

+

The geometry values SHALL be integer or float data types.

C

-

A WCMP record SHALL provide the value of null when a conformant geometry cannot be derived.

+

The geometry property SHALL provide the value of null when geometry cannot be derived.

@@ -2071,7 +2063,7 @@
7.1

A

-

For datasets based on a geometry without a calculated area (i.e. single station point), a WCMP record SHOULD provide the GeoJSON geometry as a Point type.

+

For datasets based on a geometry without a calculated area (for example, single station point), a WCMP record SHOULD provide the GeoJSON geometry as a Point type.

@@ -2120,7 +2112,7 @@
7.1
7.1.10.2. Additional Geospatial Extents
-

The additionalExtents.spatial property is for other geospatial extents associated with the dataset, for example, non-geographic data or for describing multiple sub-areas of a dataset. +

The additionalExtents.spatial property is for other geospatial extents associated with the dataset. For example, it may be useful for non-geographic data or for describing multiple sub-areas of a dataset. The additionalExtents.spatial.bbox property provides the ability to list one to many minimum bounding geometries for a given dataset, where:

@@ -2181,7 +2173,7 @@

B

-

A WCMP record’s geometry MAY provide a third element (height) as per clause 4 of the GeoJSON specification.

+

The geometry property MAY provide a third element (height) as per clause 4 of the GeoJSON specification.

@@ -2303,13 +2295,13 @@
7.1.10.

A

-

A WCMP record SHALL provide ONE time item property using the Gregorian calendar.

+

A WCMP record SHALL provide ONE time property using the Gregorian calendar.

B

-

A WCMP record SHALL provide the value of null when a conformant time cannot be derived.

+

The time property SHALL provide the value of null when a conformant time cannot be derived.

@@ -2335,7 +2327,7 @@
7.1.10.

A

-

For datasets with known or discrete intervals, a WCMP record SHOULD provide the temporal resolution (time.resolution) as a valid ISO 8601 duration (e.g., P1D).

+

For datasets with known or discrete intervals, a WCMP record SHOULD provide the temporal resolution (time.resolution) as a valid ISO 8601 duration (for example, P1D).

@@ -2376,9 +2368,8 @@
7.1.10.
7.1.10.4. Additional Temporal Extents
-

The additionalExtents.temporal property is for describing other temporal extents associated with the dataset, for example, multiple time instances or to identify other temporal reference systems. -Temporal extents can be fully bound or open in either direction (e.g., until or before). An additionalExtents.temporal.resolution -property is able express the temporal granularity at which a given dataset’s data is measured, generated, or reported.

+

The additionalExtents.temporal property is for describing other temporal extents associated with the dataset. For example, it may be useful to represent multiple time instances or to identify other temporal reference systems. +Temporal extents can be fully bound or open in either direction. An additionalExtents.temporal.resolution property is able express the temporal granularity at which a given dataset’s data is measured, generated, or reported.

Example
@@ -2457,7 +2448,7 @@

-

Note that a contact can also be specified by using a URL:

+

A contact can also be specified by using a URL.

@@ -2467,7 +2458,7 @@

@@ -2494,13 +2485,13 @@

B

-

A WCMP record’s contact SHALL provide a organization property.

+

The properties.contacts SHALL provide an organization property.

C

-

A WCMP record’s contact roles, when specified, SHALL provide a role type from the WCMP resource type codelist.

+

The `roles`property, when specified, SHALL provide a role type from the WCMP role type codelist.

@@ -2520,7 +2511,7 @@

A

-

A WCMP record properties.contacts property MAY provide more than one contact via multiple objects or a single contact object with multiple roles.

+

The properties.contacts property MAY provide more than one contact via multiple objects or a single contact object with multiple roles.

@@ -2529,7 +2520,7 @@

7.1.12. Properties / Version

-

The version property is the version of the dataset. Datasets may be versioned by an organization, for example, the version of an NWP model or a processing chain/workflow, and data providers can make this information available when there are multiple versions of a dataset over time.

+

The version property is the version or edition of the dataset. Datasets may be versioned by an organization, for example, the version of an NWP model or a processing chain/workflow, and data providers can make this information available when there are multiple versions of a dataset over time.

Example
@@ -2565,8 +2556,7 @@

7

7.1.13. Properties / Persistent Identifiers

-

The externalIds property is a persistent (or handle) identifier used to provide a long lasting reference to a digital resource. Persistent identifiers -are commonly used for scientific publications and datasets.

+

The externalIds property is a persistent (or handle) identifier used to provide a long lasting reference to a digital resource. Persistent identifiers are commonly used for scientific publications and datasets.

Examples of persistent identifiers include, but are not limited to:

@@ -2574,13 +2564,13 @@

@@ -2631,7 +2621,7 @@

A

-

A WCMP record SHOULD provide persistent identifier references via items in the properties.externalIds array property, where the value of scheme is based on an established persistent identifier scheme (such as doi, ark, handle, etc.), and the value of value is the persistent identifier (e.g. https://dx.doi.org/10.14287/10000001).

+

A WCMP record SHOULD provide persistent identifier references via items in the properties.externalIds array property, where the value of scheme is based on an established persistent identifier scheme (such as doi, ark, handle, etc.), and the value property is the persistent identifier (for example, https://dx.doi.org/10.14287/10000001).

@@ -2666,19 +2656,7 @@

7.1.14. Properties / Record Creation Date

-

The created property is a single date that the WCMP metadata record was created.

-
-
- - - - - -
-
Note
-		 -This property relates to the date of the metadata record, not the start or end time of a given dataset. See Temporal Extent for more information on defining dataset temporal extents. -
+

The created property is a single date that the WCMP metadata record was created. Note, that this date is not the start or end time of a given dataset. See Temporal Extent for more information on defining dataset temporal extents.

Example
@@ -2711,7 +2689,7 @@

B

-

A WCMP record SHALL NOT be repeatable or used to document change history.

+

The properties.created property SHALL NOT be repeated or used to document change history.

@@ -2720,19 +2698,7 @@

7.1.15. Properties / Record Update Date

-

The updated property is the date that the WCMP metadata record was last updated.

-
-
- - - - - -
-
Note
-		 -This property relates to the date of the metadata record, not the start or end time of a given dataset. See Temporal Extent for more information on defining dataset temporal extents. -
+

The updated property is the date that the WCMP metadata record was last updated. Note, that this date is not the start or end time of a given dataset. See Temporal Extent for more information on defining dataset temporal extents.

Example
@@ -2785,10 +2751,11 @@

7.1

7.1.17. Properties / WMO Data Policy

-

The wmo:dataPolicy property is a codelist that identifies the classification of the dataset exchange as described by WMO Unified Data Policy for the International Exchange of Earth System Data (Resolution 1 (Cg-Ext(2021) [35]. The codelist values are core or recommended. wmo:dataPolicy is required if the record describes a dataset.

+

The wmo:dataPolicy property is a codelist that identifies the classification of the dataset exchange as described by WMO Unified Data Policy[35] +for the international exchange of Earth system data. The codelist values are core or recommended. The wmo:dataPolicy property is required if the metadata record describes a dataset.

-

Licensing and copyright are expressed via the links property (see distribution section), providing access, license and attribution details as required. Conditions on use are essential for the WMO Unified Data Policy, but for transparency and clarification any other conditions should also be indicated.

+

Licensing and copyright are expressed via the links property (see distribution section), providing access, license and attribution details as required. Conditions on use of the data should be indicated for transparency and clarification.

Example: Core Data
@@ -2827,7 +2794,7 @@

-

It is useful to add provider-specific details to have the most detailed information about data policy and additional conditions.

+

It is useful to add provider-specific details to complete information about data policy and additional conditions.

@@ -2844,7 +2811,7 @@

A

@@ -2880,25 +2847,25 @@

A

@@ -2918,7 +2885,7 @@

A

@@ -2929,12 +2896,10 @@ + by IANA link relations[36] or WCMP2 + defined extensions[37] (see Link relation selection)

@@ -2984,12 +2949,12 @@
7.1.18.1. Overvie
- + - @@ -3005,7 +2970,7 @@
7.1.18.1. Overvie
- + @@ -3020,8 +2985,7 @@
7.1.18.1. Overvie
-

A WCMP record’s additional conditions represented by a links item SHOULD provide a title property to provide additional human-readable information about link.

+

Additional conditions represented by a links item SHOULD also provide a title property to include human-readable information about link.
-

If a WCMP record’s type (properties.type) is a dataset (i.e. dataset), the record SHALL provide exactly one properties.wmo:dataPolicy property.

+

When the properties.type property is dataset, the record SHALL provide exactly one properties.wmo:dataPolicy property.

B
-

A WCMP record’s properties.wmo:dataPolicy property SHALL have a value of either core or recommended.

+

The properties.wmo:dataPolicy property SHALL be core or recommended.

C
-

If a WCMP record’s properties.wmo:dataPolicy is equal to recommended, any data licensing SHALL be provided by at least one links item with link relations (rel) of license.

+

When the properties.wmo:dataPolicy property is recommended, data licensing SHALL be provided by at least one links item with link relations (rel) of license.

D
-

If a WCMP record’s properties.wmo:dataPolicy is equal to recommended, any copyright SHALL be provided by at least one links item with link relations (rel) of copyright.

+

When the properties.wmo:dataPolicy property is recommended, copyright information SHALL be provided by at least one links item with link relations (rel) of copyright.
-

A WCMP record whose data policy is core MAY provide attribution licensing as needed.

+

When the properties.wmo:dataPolicy property is core, attribution licensing MAY be provided as needed.

rel

optional

The relationship that the link bears in the context of the WCMP record. This is a controlled vocabulary defined - by IANA link relations [36] or WCMP2 - defined extensions [37] (see Link relation selection)

type

templated

optional

Whether the link is a URI template

Indicates whether the link is a URI template or not

variables

optional

If the link is a URI template (templated=true), the variable definitions that help the user construct a +

If the link is a URI template (templated=true), the variables help the user construct a link from the template with the appropriate values

channel

conditional

For data made available via MQTT, the topic to which a user should subscribe, to download/access data

For data made available via MQTT, the topic to which a user may subscribe to for notifications and access

security
-

WCMP record links may also provide links to services that implement access control in support of authentication and authorization. In -secure data use cases, a user needs to be able to detect access-controlled data as part of data discovery and evaluation.

+

The links property may also provide links to services that implement access control in support of authentication and authorization. In secure data use cases, a user needs to be able to detect access-controlled data as part of data discovery and evaluation.

Example
@@ -3160,43 +3124,43 @@
7.1.18.1. Overvie

A

-

A WCMP record SHALL define a links property.

+

A WCMP record SHALL provide a links property.

B

-

A WCMP record links property SHALL contain at least one link to the data access service allowing users to download the data in one of the supported formats.

+

The links property SHALL contain at least one link to the data access service allowing users to download the data.

C

-

A WCMP record links property SHALL contain a Web Accessible Folder (WAF) OR an API link for non real-time data (e.g., climate records, hydrometric data archives).

+

The links property SHALL contain a Web Accessible Folder (WAF) OR an API link for non-real-time data (such as climate records or hydrometric data archives).

D

-

A WCMP record links property SHALL contain access control information for data, products, and services requiring authentication or authorization.

+

The links property SHALL contain access control information for data, products, and services that require authentication or authorization.

E

-

For representing MQTT links, a WCMP record SHALL use the URI scheme of mqtt (default port 1883) and mqtts (default port 8883) for secure TLS encrypted connections.

+

For representing MQTT links, the URI scheme SHALL be mqtt (default port 1883) or mqtts (default port 8883) for secure TLS encrypted connections.

F

-

A WCMP record links property SHALL contain the channel property of the MQTT topic for for real-time data under which the data publication notifications will be accessible from the WIS2 Global Broker, following the WIS2 topic hierarchy.

+

The links property SHALL provide the channel property of the MQTT topic for real-time data under which the data publication notifications will be accessible from the WIS2 Global Broker, following the WIS2 topic hierarchy.

G

-

A WCMP record links property SHALL include a valid link relation from IANA [38] or the WCMP link type codelist [39].

+

The links property SHALL include a valid link relation from IANA [38] or the WCMP link type codelist [39].

@@ -3231,7 +3195,7 @@
7.1.18.1. Overvie

B

-

A WCMP record links property SHOULD provide the type` property with a valid media type from IANA or as designated by WMO.

+

The links property SHOULD provide a type` property with a valid media type from IANA or as designated by WMO.

@@ -3251,7 +3215,7 @@
7.1.18.1. Overvie

A

-

A WCMP record links property MAY additionally contain a Web Accessible Folder (WAF) OR an API link for real-time data.

+

The links property MAY contain a Web Accessible Folder (WAF) OR an API link for real-time data.

@@ -6608,7 +6572,7 @@

Annex 29. https://gisc.dwd.de/wis2.0/WIS_2.0_final.mp4

-30. https://library.wmo.int/doc_num.php?explnum_id=11113#page=9 +30. https://library.wmo.int/idurl/4/58009
32. https://doi.org @@ -6620,7 +6584,7 @@

Annex 34. https://handle.net

-35. https://library.wmo.int/doc_num.php?explnum_id=11113#page=9 +35. https://library.wmo.int/idurl/4/58009
36. https://www.iana.org/assignments/link-relations/link-relations.xhtml @@ -6631,7 +6595,7 @@

Annex

diff --git a/standard/wcmp2-DRAFT.pdf b/standard/wcmp2-DRAFT.pdf index 4bb0f64..7ce9ff8 100644 Binary files a/standard/wcmp2-DRAFT.pdf and b/standard/wcmp2-DRAFT.pdf differ