stac-extensions / raster

Describes raster assets at band level (one or multiple) with specific information such as data type, unit, number of bits used, nodata.
Apache License 2.0
13 stars 7 forks source link

Best practices for `unit` values? #47

Closed tylere closed 2 months ago

tylere commented 4 months ago

The current raster spec does not give much guidance about the unit field, and inconsistency in the field may make datasets less interoperable.

As a concrete example, should a unit be meter or metre or meters or m or cm or km?

It would be good to describe a best practice for this field. For example:

m-mohr commented 3 months ago

The datacube extension (and others, too, I think) use:

The unit of measurement for the data, preferably compliant to UDUNITS-2 units (singular).

Is this good enough? It's difficult to standardize here as people have so diverging needs. This field will be migrated to STAC core metadata in 1.1 (raster 2.0) so is not that relevant for the raster extension, but for core.

m-mohr commented 2 months ago

Implemented in https://github.com/radiantearth/stac-spec/pull/1254 through commit https://github.com/radiantearth/stac-spec/pull/1254/commits/f35f5d8cf63f1f12ea1da59cd21825f32a08898c