CF Metadata Conventions Join Smart Data Models: 4 Candidate Models for Climate and Forecast netCDF Datasets

The Smart Data Models Candidates repository now has a new candidate standard from Earth science: cf-conventions, with 4 candidate models translated from the CF (Climate and Forecast) Metadata Conventions 1.13. They cover netCDF datasets, data variables, coordinate variables and grid mappings. The conventions and the CF Standard Name Table are published under CC0 1.0. As with every candidate, each model has a JSON Schema, an NGSI-LD @context and all four example serializations (NGSI-v2 and NGSI-LD, key-values and normalized), and each example is validated against its schema.

About the CF Conventions

The CF Metadata Conventions are maintained by the CF community on GitHub. They make netCDF files self-describing. Global attributes say what a dataset is and where it comes from. Variable attributes say what each variable measures (standard_name, units, cell_methods), how it is located in space and time (coordinates, axis, calendar, grid_mapping) and how to read its values (_FillValue, valid_range, flags). The CF Standard Name Table has about 5,100 names for geophysical quantities. Climate model output (CMIP), Copernicus, NOAA and many Earth-observation archives all use it.

The models

Model CF scope Attributes Example
Dataset Global attributes: Conventions, title, institution, source, history, references, comment, featureType 15 NARR daily 2 m air temperature file
DataVariable Data variable attributes, with standard_name limited to the Standard Name Table v95 42 air (air_temperature, K)
CoordinateVariable Coordinate and auxiliary coordinate attributes: axis, positive, calendar, bounds, cf_role… 36 time
GridMapping Map projection and coordinate reference system (17 grid mappings) 40 Lambert_Conformal

Grounded in real data

The four examples use the real CF metadata of one public file: the NCEP North American Regional Reanalysis (NARR) daily mean 2 m air temperature for 2024, served by NOAA PSL. They include its global attributes, the air data variable, the time coordinate and its Lambert conformal grid mapping. NARR data are provided by the NOAA PSL, Boulder, Colorado, USA, from their website at https://psl.noaa.gov.

Translation notes

  • CF names, verbatim. Attribute names keep CF’s own spelling (standard_name, _FillValue, Conventions). Only two are renamed, because they clash with existing terms: source becomes cfSource and the UGRID location becomes cfLocation.
  • Generated from the specification. A script built the models from the attribute tables of the CF 1.13 document (Appendix A and Appendix F) and from the Standard Name Table XML.
  • Standard names as a controlled list. standard_name must be one of the 5,097 names of table version 95, optionally followed by a standard name modifier. Each name also resolves in the NERC Vocabulary Server.
  • Linked variables. Variables point to their dataset, and data variables point to their grid mapping, through NGSI-LD relationships. These links and the netCDF variableName are additions to CF; the original CF attributes are kept as they are.

Try it, and tell us what’s missing

These are Candidates: carefully sourced translations that are not yet official Smart Data Models subjects. Still to review: the Dataset type name, which also exists in the DCAT-AP models with a catalogue scope, and how dataModel.Weather and the environment models could use CF standard names. Natural next steps are the parts of CF not covered yet (geometries, UGRID meshes, discrete sampling geometry instance variables) and the ACDD discovery attributes.

Browse the models, open an issue, or send a PR:
👉 https://github.com/smart-data-models/Candidates/tree/master/standards/cf-conventions

Bookmark the permalink.

Comments are closed.