Skip to content

Commit 9b4f695

Browse files
Add Zarr Geo Projection Attribute Extension specifications and schema (#39)
* Add Zarr Geo Projection Attribute Extension specifications and schema * Update attributes/README.md Co-authored-by: Davis Bennett <[email protected]> * Update attributes/README.md Co-authored-by: Davis Bennett <[email protected]> * Update attributes/geo/proj/README.md Co-authored-by: Davis Bennett <[email protected]> * Add implementation requirement to attribute specifications and enhance geo/proj documentation with versioning details * Remove status and registry entry from Geo Projection Attribute Extension section in README.md --------- Co-authored-by: Davis Bennett <[email protected]>
1 parent 01bdda8 commit 9b4f695

File tree

3 files changed

+583
-0
lines changed

3 files changed

+583
-0
lines changed

attributes/README.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Zarr Attributes Specifications
2+
3+
This directory contains specifications for encoding Geospatial metadata in Zarr hierarchies.
4+
5+
## Overview
6+
7+
Zarr attributes are metadata stored in the `attributes` object in Zarr array and group metadata documents. While the `attributes` can contain arbitrary metadata, this directory provides specifications for commonly used attribute conventions within the Zarr community. These specifications also define the structure of a Zarr hierarchy, e.g. the layout of groups, the names of the nodes in the hierarchy, and the properties of the arrays.
8+
9+
## Registered Attributes
10+
11+
### [`geo/proj`](./geo/proj/README.md) - Geo Projection Attribute Extension
12+
13+
Defines a JSON object that encodes datum and coordinate reference system (CRS) information for geospatial data stored under the `proj` key within the `geo` dictionary.
14+
15+
**Key Features**:
16+
17+
- Simple, standardized CRS encoding without complex nested structures
18+
- Compatible with existing geospatial tools (GDAL, rasterio, pyproj)
19+
- Based on the proven STAC Projection Extension model
20+
- Group-to-array inheritance model for CRS metadata
21+
- Support for multiple CRS representations (EPSG codes, WKT2, PROJJSON)
22+
23+
**Specification**: [./geo/proj/README.md](./geo/proj/README.md)
24+
25+
## Contributing
26+
27+
For changes to attribute specifications:
28+
29+
1. **Content Changes**: Submit PRs to this repository for specification content
30+
2. **Registration Changes**: Submit PRs to [zarr-extensions](https://github.com/zarr-developers/zarr-extensions) for registry updates
31+
3. **New Attributes**: Follow the [registration process](https://github.com/zarr-developers/zarr-extensions#registering-an-attribute) in zarr-extensions
32+
4. **Implementation Requirement**: Every specification should include a reference implementation in this repository to ensure the spec can be practically implemented
33+
34+
## License
35+
36+
All attribute specifications are licensed under the [Creative Commons Attribution 3.0 Unported License](https://creativecommons.org/licenses/by/3.0/), consistent with the zarr-extensions registry.

0 commit comments

Comments
 (0)