Metadata
Metadata are provided at different levels (global attributes, variable attributes and variables containing metadata for specific time ranges).
Metadata can be required or recommended by different metadata convention. Additionally, the full set of EBAS metadata is provided at the different levels.
Metadata governed by mentioned conventions are on a more generic an higher level. Those metadata are particularly useful for data discovery, visualisation or processing in a more generic way. They are very important to make standard tools work seamlessly with EBAS NetCDF files.
EBAS metadata are more detailed and very specific to the various types of measurement.
Supported Metadata Conventions
NetCDF
The NetCDF Users Guide
recommends the global attributes title
, history
and Conventions
as well as the variable attribute long_name
and unit
for all variables.
CF Metadata Conventions
The CF Metadata Conventions requires a longer list of metadata as global or variable attributes as well as some additional concepts, like boundary variables.
ACDD convention
The ACDD convention focuses on attributes recommended for describing netCDF datasets to discovery systems. Cataloging tools like the THREDDS can use this metadata or map to other metadata standards (Dublin Core, ISO 19115).
EBAS Metadata
All EBAS metadata are supported and used in EBAS NetCDF files.
Metadata will appear in three different places:
As global attributes: EBAS metadata will appear as global attributes when:
The respective metadata element is the same for all variables and the full time ranges in the file. This is typically the case for common metadata like e.g. station and instrument metadata.
For some metadata elements an aggregation of metadata in the file is useful. This is the case for framework, originator (PI) and submitter as well as revision date.
EBAS metadata are implemented as global attributes with the prefix
ebas_
. The attribute names of all possible EBAS metadata can be seen in the column NetCDF Tag in this listExample: global attribute
ebas_data_definition
.As variable attributes: EBAS metadata will appear as variable attributes when the metadata value applies to the whole time range of the variable. EBAS metadata are variable attribues with the prefix
ebas_
. The attribute names of all possible EBAS metadata can be seen in the column NetCDF Tag in this listAs time dependent metadata: Some metadata may change over time during the valid period of the dataset. As an example, the instrument serial number might change during many years of measurement. More on time dependent metadata in the next paragraph.
Time depenendent EBAS metadata
As mentioned above, some metadata in EBAS can change over time. For file formats like the EBAS Nasa Ames file format, this means that a files need to be split on every change of metadata during history.
One of the biggest technical advantage of the EBAS NetCDF fileformat is that those metadata changes can be stored in the file. Thus, all datasets (DOIs) in EBAS can be written to a single NetCDF file.
Time dependent metadata are implemented as an additional variable for each data variable, see Metadata variable
There is a dedicated time dimension for all metadata changes, called :ref:metadata_time<dim_metadata_time>
.
This should not be confused with the time
dimension used for the measurement data.
The time
dimension has usually a length of > 1000 (one for each measurement interval),
the metadata_time
dimension has typically only a length of < 10, one for each change of metadata.