Discovery metadata¶
Discovery metadata describes a given dataset or collection. Data being published through a wis2box requires discovery metadata (describing it) to be created, maintained and published to the wis2box catalogue API.
wis2box supports managing discovery metadata using the WMO Core Metadata Profile (WCMP) 2.0 standard.
Note
WCMP 2.0 is currently in development as part of WMO activities.
Creating a discovery metadata record in wis2box is as easy as completing a YAML configuration file. wis2box leverages the pygeometa project’s metadata control file (MCF) format. Below is an example MCF file.
wis2box:
retention: P30D
topic_hierarchy: mwi.mwi_met_centre.data.core.weather.surface-based-observations.SYNOP
data_category: observationsSurfaceLand
country: mwi
center_id: mwi_met_centre
mcf:
version: 1.0
metadata:
identifier: mwi.mwi_met_centre.data.core.weather.surface-based-observations.SYNOP
language: en
language_alternate: fr
charset: utf8
hierarchylevel: dataset
datestamp: 2021-11-29
spatial:
datatype: vector
geomtype: point
identification:
language: en
charset: utf8
title:
en: Surface weather observations from Malawi
abstract:
en: Surface weather observations from Malawi
dates:
creation: 2021-11-29
publication: 2021-11-29
keywords:
default:
keywords:
en:
- surface weather
- temperature
- observations
wmo:
keywords:
en:
- weatherObservations
keywords_type: theme
vocabulary:
name:
en: WMO Category Code
url: https://github.com/wmo-im/wcmp-codelists/blob/main/codelists/WMO_CategoryCode.csv
wis2:
keywords:
en:
- mw.malawi.weatherObservations.dataset_name
keywords_type: theme
vocabulary:
name:
en: WMO Core Metadata profile topic hierarchy
url: https://github.com/wmo-im/wcmp2-codelists/blob/main/codelists/topic_hierarchy.csv
topiccategory:
- climatologyMeteorologyAtmosphere
extents:
spatial:
- bbox: [32.6881653175,-16.8012997372,35.7719047381,-9.23059905359]
crs: 4326
temporal:
- begin: 2021-11-29
end: null
resolution: P1H
fees: None
accessconstraints: otherRestrictions
rights:
en: WMO Unified Policy for the International Exchange of Earth System Data
url: https://example.org/malawi-surface-weather-observations
status: onGoing
maintenancefrequency: continual
contact:
pointOfContact: &contact_poc
organization: Department of Climate Change and Meteorologial Services (DCCMS)
url: https://www.metmalawi.gov.mw
individualname: Firstname Lastname
positionname: Position Name
phone: +265-1-822-014
fax: +265-1-822-215
address: P.O. Box 1808
city: Blantyre
administrativearea: Blantyre District
postalcode: M3H 5T4
country: Malawi
email: you@example.org
hoursofservice: 0700h - 1500h UTC
contactinstructions: email
distributor: *contact_poc
dataquality:
scope:
level: dataset
lineage:
statement: this data was generated by the csv2bufr tool
Note
There are no conventions to the MCF filename. The filename does not get used/exposed or published. It is up to the user to determine the best filename, keeping in mind your wis2box system may manage and publish numerous datasets (and MCF files) over time.
Summary¶
At this point, you have created discovery metadata for your given dataset(s).