Global attributes — HARP 1.20 documentation

# Global attributes

The HARP format defines the following global attributes:

`Conventions` string

  This attribute should follow the netCDF convention and should contain `HARP-1.0` in its value to indicate that the file conforms to the HARP data format conventions.

`history` string (optional)

  This attribute is used by all HARP tools to keep a trace of the operations performed on a product. Each time a command is performed on a HARP file the full command line is appended to this attribute (using a newline separator between commands). The command line is prepended by the current UTC time and the version of HARP (using the format `YYY-MM-DDThh:mm:ssZ [harp-x.y] <command line>`). This usage is in line with the general netCDF conventions for this attribute.

`source_product` string (optional)

  This attribute will hold the name of the original product in case the HARP file was converted using `harpconvert`. This approach makes it possible to use your own file naming approach for HARP files without losing trace of which original product files the data came from. Note that this attribute value is used as the main source to uniquely identify a product within a dataset. Only if the attribute is absent then the current filename of the product will be used as product id within a dataset. It is therefore important that the value of `source_product` (or, if absent, the current filename) is unique within a dataset to allow the product to be uniquely identified. Tools such as `harpcollocate` rely on this.

`datetime_start` double (optional)

  This attribute is mandatory if the file is to be used with `harpcollocate`. It allows for quick extraction of the time range of the product. The attribute should be a scalar double precision floating point value giving the `datetime` of the first measurement as `days since 2000-01-01` (using the fractional part to represent time-of- day). When exporting data, HARP will itself generate the value by looking at the minimum value of the available `datetime_start` (or, if absent, `datetime`) variable.

`datetime_stop` double (optional)

  This attribute is mandatory if the file is to be used with `harpcollocate`. It allows for quick extraction of the time range of the product. The attribute should be a scalar double precision floating point value giving the `datetime` of the last measurement as `days since 2000-01-01` (using the fractional part to represent time-of- day). When exporting data, HARP will itself generate the value by looking at the maximum value of the available `datetime_stop` (or, if absent, `datetime`) variable.

Note that the `Conventions`, `datetime_start`, and `datetime_stop` attributes are only used inside files. For the in-memory representation (in C, Python, etc.) only the `history` and `source_product` attributes are present.

Note that files using the HARP data format can include global attributes in addition to the ones mentioned above. However, such attributes will be ignored when the product is imported.