Difference between revisions of "Conventions"

Line 7: Line 7:
 
*<span style="font-size:medium;"><span style="font-family:Arial,Helvetica,sans-serif;">providing enough information about the data (metadata) in a shared "language" so others can understand the data as it was meant to by its creator</span></span>  
 
*<span style="font-size:medium;"><span style="font-family:Arial,Helvetica,sans-serif;">providing enough information about the data (metadata) in a shared "language" so others can understand the data as it was meant to by its creator</span></span>  
  
<span style="font-size:medium;"><span style="font-family:Arial,Helvetica,sans-serif;">Conventions are also convenient for anyone using them, as they provide and easy to adopt template for your data and you do not need to invent a new data model with every new project. What's more they help you being consistent and you are less likely to not be able to understand your own data&nbsp;after a few years or even months.&nbsp;</span></span>
+
<span style="font-size:medium;"><span style="font-family:Arial,Helvetica,sans-serif;">Conventions are also convenient for anyone using them, as they provide and easy to adopt template for your data and you do not need to invent a new data model with every new project. What's more they help you being consistent, and you are less likely to mis-interpret&nbsp;your own data&nbsp;later on.</span></span>
  
 
<span style="font-size:medium;"><span style="font-family:Arial,Helvetica,sans-serif;">Some conventions are universally adopted as the metric unit system, and we all use&nbsp;them without even noticing anymore. Others are community specific and are developed to tackle specific data formats and needs of a scientific discipline.</span></span>
 
<span style="font-size:medium;"><span style="font-family:Arial,Helvetica,sans-serif;">Some conventions are universally adopted as the metric unit system, and we all use&nbsp;them without even noticing anymore. Others are community specific and are developed to tackle specific data formats and needs of a scientific discipline.</span></span>
Line 29: Line 29:
 
<span style="font-family:Arial,Helvetica,sans-serif;"><span style="font-size:medium;">Important elements of the Conventions are:</span></span>
 
<span style="font-family:Arial,Helvetica,sans-serif;"><span style="font-size:medium;">Important elements of the Conventions are:</span></span>
  
*<span style="font-family:Arial,Helvetica,sans-serif;"><span style="font-size:medium;">the&nbsp;UDUNITS&nbsp;packages&nbsp;for units standards</span></span>  
+
*<span style="font-family:Arial,Helvetica,sans-serif;"><span style="font-size:medium;">the&nbsp;UDUNITS&nbsp;packages&nbsp;for units' standards</span></span>  
 
*<span style="font-family:Arial,Helvetica,sans-serif;"><span style="font-size:medium;">the [https://cfconventions.org/Data/cf-standard-names/77/build/cf-standard-name-table.html standard_name]&nbsp;whose scope is to provide a common terminology for variables names.&nbsp;For example, every variable with the&nbsp;standard_name '''''air_temperature'''''&nbsp;can be defined&nbsp;as "''Air temperature is the bulk temperature of the air, not the surface (skin) temperature.''" with K or equivalent units, regardless of the way the actual variable name in the file. Standard_name is a very useful attribute but should be applied with attention. It is better to leave it out if a suitable one is not available.</span></span>  
 
*<span style="font-family:Arial,Helvetica,sans-serif;"><span style="font-size:medium;">the [https://cfconventions.org/Data/cf-standard-names/77/build/cf-standard-name-table.html standard_name]&nbsp;whose scope is to provide a common terminology for variables names.&nbsp;For example, every variable with the&nbsp;standard_name '''''air_temperature'''''&nbsp;can be defined&nbsp;as "''Air temperature is the bulk temperature of the air, not the surface (skin) temperature.''" with K or equivalent units, regardless of the way the actual variable name in the file. Standard_name is a very useful attribute but should be applied with attention. It is better to leave it out if a suitable one is not available.</span></span>  
  
Line 36: Line 36:
 
'''<span style="font-size:large;"><span style="font-family:Arial,Helvetica,sans-serif;">Attribute Convention for Data Discovery&nbsp;</span></span>'''&nbsp;
 
'''<span style="font-size:large;"><span style="font-family:Arial,Helvetica,sans-serif;">Attribute Convention for Data Discovery&nbsp;</span></span>'''&nbsp;
  
Other conventions specific to sub-domains
+
<span style="font-size:medium;"><span style="font-family:Arial,Helvetica,sans-serif;">Other conventions specific to sub-domains</span></span>
  
&nbsp; Land&nbsp;: &nbsp;[https://www.lmd.jussieu.fr/~polcher/ALMA/ https://www.lmd.jussieu.fr/~polcher/ALMA/]
+
<span style="font-size:medium;"><span style="font-family:Arial,Helvetica,sans-serif;">&nbsp; Land&nbsp;: &nbsp;[https://www.lmd.jussieu.fr/~polcher/ALMA/ https://www.lmd.jussieu.fr/~polcher/ALMA/]</span></span>

Revision as of 20:46, 1 June 2021

Template:Working on New page under construction

Data conventions and standards are an important tool to manage your data in a way it can be easily and effectively shared with others. Conventions help achieving this in two ways:

  • formatting the data in a way which is easy for others in the same community to use;
  • providing enough information about the data (metadata) in a shared "language" so others can understand the data as it was meant to by its creator

Conventions are also convenient for anyone using them, as they provide and easy to adopt template for your data and you do not need to invent a new data model with every new project. What's more they help you being consistent, and you are less likely to mis-interpret your own data later on.

Some conventions are universally adopted as the metric unit system, and we all use them without even noticing anymore. Others are community specific and are developed to tackle specific data formats and needs of a scientific discipline.

To read more about why data standards are important there is this article from the ARDC.

The climate research community uses mostly netCDF (Network Common Data Format) as a data format. NetCDF is a self-describing binary format which means that metadata information is stored with the data itself. The Climate and Forecast Conventions (CF Conventions) were developed to standardised this metadata.

 

CF Conventions

The CF conventions are specifically designed to facilitate the processing and sharing of netCDF files. They are based on the older COARDS conventions, which they extend. The first version ( v1.0 ) of the CF Conventions was released in 2003, the current version ( in 2021 ) is v1.8. Each new version tries, as much as possible, to be compatible with older versions. The first versions, as the name implied were focusing on climate and forecast data, since then they broaden their scope to earth data in general, including observational data.

CF is now widely adopted as the main standard both in the production of netCDF related code and for the publication of netCDF data. As the initial focus was to allow interoperability of netCDF based software packages, the conventions main aim is to define clearly each variable and the spatial and temporal properties of the data.

As a consequence, applying these Conventions to your netCDF files makes them more re-usable.  Most software used in Climate science will know how to open and process correctly the files. The metadata required will describe clearly the characteristic of the data in the files, making it easier, for a potential user, to identify correctly the variables and compare them to similar data.

CF Conventions focus mostly on the variable and dimensions description, the full Conventions document is quite long but, in most cases, you will be using the same attributes. This CMS Blog provides an example on how to apply them to your data covering the attributes most commonly required.

Important elements of the Conventions are:

  • the UDUNITS packages for units' standards
  • the standard_name whose scope is to provide a common terminology for variables names. For example, every variable with the standard_name air_temperature can be defined as "Air temperature is the bulk temperature of the air, not the surface (skin) temperature." with K or equivalent units, regardless of the way the actual variable name in the file. Standard_name is a very useful attribute but should be applied with attention. It is better to leave it out if a suitable one is not available.

There are various tools available to help you check your files against a version of the CF Conventions. We covered some in this wiki page: CF checker  

Attribute Convention for Data Discovery  

Other conventions specific to sub-domains

  Land :  https://www.lmd.jussieu.fr/~polcher/ALMA/