From 598237365476252b6e1207f93d398deabf4a037a Mon Sep 17 00:00:00 2001 From: Justus Magin Date: Mon, 18 May 2026 19:29:40 +0200 Subject: [PATCH 1/8] correct the spelling of the ellipsoid in the example --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bcb7bb7..aed12d0 100644 --- a/README.md +++ b/README.md @@ -156,7 +156,7 @@ Uncompressed subdomain: "indexing_scheme": "nested", "spatial_dimension": "cells", "ellipsoid": { - "name": "wgs84", + "name": "WGS84", "semi_major_axis": 6378137.0, "inverse_flattening": 298.257223563 }, From 00e4dac94bdb9278304bf6794ef7416f26f30280 Mon Sep 17 00:00:00 2001 From: Justus Magin Date: Mon, 18 May 2026 19:36:29 +0200 Subject: [PATCH 2/8] mention that the names must be accepted by `proj` --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index aed12d0..24fe55d 100644 --- a/README.md +++ b/README.md @@ -114,6 +114,8 @@ The following values are possible: The ellipsoid object is modelled after [`projjson`](https://proj.org/en/stable/specifications/projjson.html)'s definition. It can describe either a sphere or an ellipsoid. +In all cases, the **name** must exactly correspond to the names used by the [proj](https://proj.org) library. + #### Sphere | | Type | Description | Required | From 7b4d1dfa45ee7da0fe846561daf0bde47274b85d Mon Sep 17 00:00:00 2001 From: Justus Magin Date: Tue, 2 Jun 2026 11:34:36 +0200 Subject: [PATCH 3/8] reword --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cfcc5b3..9a8b987 100644 --- a/README.md +++ b/README.md @@ -138,7 +138,7 @@ In all cases, the **name** must exactly correspond to the names used by the [pro ### DGGS specific parameters -Some DGGS have parameters other than `refinement_level`, which can be added to the `dggs` object. In this section are standardized extensions for common DGGS +Some DGGS have parameters other than `refinement_level`, which can be added to the `dggs` object. This section contains standardized extensions for common DGGS. #### HEALPix From 4e33ce63d0c4593a8551fa84c08fb35c3a96b0d4 Mon Sep 17 00:00:00 2001 From: Justus Magin Date: Tue, 2 Jun 2026 12:17:16 +0200 Subject: [PATCH 4/8] refer to the `proj:code` values --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9a8b987..f4d7230 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,7 @@ The following values are possible: The ellipsoid object is modelled after [`projjson`](https://proj.org/en/stable/specifications/projjson.html)'s definition. It can describe either a sphere or an ellipsoid. -In all cases, the **name** must exactly correspond to the names used by the [proj](https://proj.org) library. +In all cases, the **name** is equal to the names used in WKT or PROJJSON (see also the [proj](https://github.com/zarr-conventions/proj/#projcode) extension's `proj:code` property). #### Sphere From 46d3f7daaa6bc054ef4958e172c552dae46d062a Mon Sep 17 00:00:00 2001 From: Justus Magin Date: Tue, 2 Jun 2026 12:26:22 +0200 Subject: [PATCH 5/8] refer to the table in the `proj` convention's `proj:code` docs --- README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f4d7230..73b57be 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,14 @@ The following values are possible: The ellipsoid object is modelled after [`projjson`](https://proj.org/en/stable/specifications/projjson.html)'s definition. It can describe either a sphere or an ellipsoid. -In all cases, the **name** is equal to the names used in WKT or PROJJSON (see also the [proj](https://github.com/zarr-conventions/proj/#projcode) extension's `proj:code` property). +As in WKT the **name** is required to help compare the values in the ellipsoid object against other sources. For examples, look for the ellipsoid fields in CRS definitions: + +| Naming Authority | URL | +| --------------------------------------- | ------------------------------------------------------ | +| European Petroleum Survey Groups (EPSG) | http://www.opengis.net/def/crs/EPSG or http://epsg.org | +| International Astronomical Union (IAU) | http://www.opengis.net/def/crs/IAU | +| Open Geospatial Consortium (OGC) | http://www.opengis.net/def/crs/OGC | +| ESRI | https://spatialreference.org/ref/esri/ | #### Sphere From 0a96acc1b1d60860f06159fa9bb7d72aaf663742 Mon Sep 17 00:00:00 2001 From: Justus Magin Date: Tue, 2 Jun 2026 12:27:46 +0200 Subject: [PATCH 6/8] refer to the proj convention --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 73b57be..6f26ce7 100644 --- a/README.md +++ b/README.md @@ -125,6 +125,8 @@ As in WKT the **name** is required to help compare the values in the ellipsoid o | Open Geospatial Consortium (OGC) | http://www.opengis.net/def/crs/OGC | | ESRI | https://spatialreference.org/ref/esri/ | +(taken from the `proj:code` documentation of the [`proj` convention](https://github.com/zarr-conventions/proj)) + #### Sphere | | Type | Description | Required | From 4e73ad9032a921567654c0866b8e5bbcf3f0c447 Mon Sep 17 00:00:00 2001 From: Justus Magin Date: Tue, 2 Jun 2026 15:15:11 +0200 Subject: [PATCH 7/8] rewording and more advice --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6f26ce7..9498754 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,7 @@ The following values are possible: The ellipsoid object is modelled after [`projjson`](https://proj.org/en/stable/specifications/projjson.html)'s definition. It can describe either a sphere or an ellipsoid. -As in WKT the **name** is required to help compare the values in the ellipsoid object against other sources. For examples, look for the ellipsoid fields in CRS definitions: +Following `projjson` or WKT the **name** is required to help compare the values in the ellipsoid object against other sources, but should not be interpreted by a program. For examples, look for the ellipsoid fields in these CRS definitions: | Naming Authority | URL | | --------------------------------------- | ------------------------------------------------------ | From c732bcf9b47870eca2a3289d22a1d5b2d648003c Mon Sep 17 00:00:00 2001 From: Justus Magin Date: Tue, 2 Jun 2026 15:15:33 +0200 Subject: [PATCH 8/8] rewording --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9498754..2c4707f 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,7 @@ The following values are possible: The ellipsoid object is modelled after [`projjson`](https://proj.org/en/stable/specifications/projjson.html)'s definition. It can describe either a sphere or an ellipsoid. -Following `projjson` or WKT the **name** is required to help compare the values in the ellipsoid object against other sources, but should not be interpreted by a program. For examples, look for the ellipsoid fields in these CRS definitions: +Following `projjson` and WKT the **name** is required to help compare the values in the ellipsoid object against other sources, but should not be used to infer the values. For examples, look for the ellipsoid fields in these CRS definitions: | Naming Authority | URL | | --------------------------------------- | ------------------------------------------------------ |