Skip to content

Latest commit

 

History

History
75 lines (53 loc) · 6.18 KB

README.md

File metadata and controls

75 lines (53 loc) · 6.18 KB

Data cube Extension Specification (cube)

Extension Maturity Classification: Proposal

Data cube related metadata, especially to describe their dimensions.

Item Fields

Field Name Type Description
cube:dimensions Map<string, *> Uniquely named dimensions of the data cube.

* = One of the objects defined below:

Horizontal Spatial Dimension Object

A spatial dimension in one of the horizontal (x or y) directions.

Field Name Type Description
type string REQUIRED. Type of the dimension, always spatial.
axis string REQUIRED. Axis of the spatial dimension (x, y).
extent [number] REQUIRED. Extent (lower and upper bounds) of the dimension as two-dimensional array. Open intervals with null are not allowed.
values [number] Optionally, a set of all potential values.
step number|null The space between the values. Use null for irregularly spaced steps.
reference_system string|number The spatial reference system for the data, specified as EPSG code or PROJ definition. Defaults to EPSG code 4326.

Vertical Spatial Dimension Object

A spatial dimension in vertical (z) direction.

Field Name Type Description
type string REQUIRED. Type of the dimension, always spatial.
axis string REQUIRED. Axis of the spatial dimension, always z.
extent [number|null] If the dimension consists of ordinal values, the extent (lower and upper bounds) of the values as two-dimensional array. Use null for open intervals.
values [number|string] A set of all potential values, especially useful for nominal values.
step number|null If the dimension consists of interval values, the space between the values. Use null for irregularly spaced steps.
unit string The unit of measurement for the data, preferably the symbols from SI or UDUNITS.
reference_system string|number The spatial reference system for the data, specified as EPSG code or PROJ definition. Defaults to EPSG code 4326.

An Vertical Spatial Dimension Object MUST specify an extent or a set of values. It MAY specify both.

Temporal Dimension Object

A temporal dimension based on the ISO 8601 standard. The temporal reference system for the data is expected to be ISO 8601 compliant (Gregorian calendar / UTC). Data not compliant with ISO 8601 can be represented as an Additional Dimension Object with type set to temporal.

Field Name Type Description
type string REQUIRED. Type of the dimension, always temporal.
extent [string|null] REQUIRED. Extent (lower and upper bounds) of the dimension as two-dimensional array. The dates and/or times must be strings compliant to ISO 8601. null is allowed for open date ranges.
values [string] If the dimension consists of set of specific values they can be listed here. The dates and/or times must be strings compliant to ISO 8601.
step string|null The space between the temporal instances as ISO 8601 duration, e.g. P1D. Use null for irregularly spaced steps.

Additional Dimension Object

An additional dimension that is not spatial.

Field Name Type Description
type string REQUIRED. Custom type of the dimension, never spatial.
extent [number|null] If the dimension consists of ordinal values, the extent (lower and upper bounds) of the values as two-dimensional array. Use null for open intervals.
values [number|string] A set of all potential values, especially useful for nominal values.
step number|null If the dimension consists of interval values, the space between the values. Use null for irregularly spaced steps.
unit string The unit of measurement for the data, preferably the symbols from SI or UDUNITS.
reference_system string The reference system for the data.

An Additional Dimension Object MUST specify an extent or a set of values. It MAY specify both.

Implementations

None yet, still in proposal stage.