Deprecate snow/ice cover (#13)

stac-extensions · May 29, 2024 · babdb1b · babdb1b
1 parent 8bee966
commit babdb1b
Show file tree

Hide file tree

Showing 4 changed files with 6 additions and 5 deletions.
diff --git a/README.md b/README.md
@@ -41,7 +41,6 @@ The fields in the table below can be used in these parts of STAC documents:
 | s2:datatake_type                        | string   | Datatake Type                                  |
 | s2:reflectance_conversion_factor        | number   | Reflectance Conversion Factor                  |
 | s2:water_percentage                     | number   | Water Percentage                               |
-| s2:snow_ice_percentage                  | number   | Snow and Ice Percentage                        |
 | s2:vegetation_percentage                | number   | Vegetation Percentage                          |
 | s2:thin_cirrus_percentage               | number   | Thin Cirrus Percentage                         |
 | s2:cloud_shadow_percentage              | number   | Cloud Shadow Percentage                        |
@@ -53,6 +52,7 @@ The fields in the table below can be used in these parts of STAC documents:
 | s2:high_proba_clouds_percentage         | number   | High Probability Clouds Percentage             |
 | s2:medium_proba_clouds_percentage       | number   | Medium Probability Clouds Percentage           |
 | s2:saturated_defective_pixel_percentage | number   | Saturated Defective Pixel Percentage           |
+| s2:snow_ice_percentage                  | number   | **DEPRECATED** Snow and Ice Percentage         |
 | s2:generation_time                      | datetime | **DEPRECATED** Generation Time                                |
 | s2:processing_baseline                  | string   | **DEPRECATED** [Processing Baseline](https://sentinels.copernicus.eu/web/sentinel/technical-guides/sentinel-2-msi/processing-baseline) |
 | s2:granule_id                           | string   | **DEPRECATED** Granule Identifier              |
@@ -62,6 +62,8 @@ The fields in the table below can be used in these parts of STAC documents:
 
 ### Additional Field Information
 
+**s2:snow_ice_percentage** is deprecated in favor of `eo:snow_cover`
+
 **s2:generation_time** is deprecated in favor of `processing:datetime`
 
 **s2:processing_baseline** is deprecated in favor of `processing:version`

diff --git a/examples/item.json b/examples/item.json
@@ -715,8 +715,8 @@
     "processing:datetime": "2023-11-07T18:21:59.14490Z",
     "sat:relative_orbit": 139,
     "s2:water_percentage": 95.782292,
+    "eo:snow_cover": 0,
     "processing:version": "05.09",
-    "s2:snow_ice_percentage": 0,
     "s2:vegetation_percentage": 0,
     "s2:thin_cirrus_percentage": 0.774645,
     "s2:cloud_shadow_percentage": 0,
@@ -732,7 +732,7 @@
   },
   "stac_extensions": [
     "https://stac-extensions.github.io/sentinel-2/v1.0.0/schema.json",
-    "https://stac-extensions.github.io/eo/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/eo/v1.1.0/schema.json",
     "https://stac-extensions.github.io/sat/v1.0.0/schema.json",
     "https://stac-extensions.github.io/projection/v1.1.0/schema.json",
     "https://stac-extensions.github.io/processing/v1.2.0/schema.json"

diff --git a/examples/item2.json b/examples/item2.json
@@ -21,6 +21,7 @@
       "msi"
     ],
     "eo:cloud_cover": 51.580326,
+    "eo:snow_cover": 0,
     "sat:orbit_state": "descending",
     "sat:relative_orbit": 13,
     "processing:datetime": "2020-10-07T16:08:57.135Z",
@@ -55,7 +56,6 @@
     "s2:medium_proba_clouds_percentage": 14.61311,
     "s2:high_proba_clouds_percentage": 24.183494,
     "s2:thin_cirrus_percentage": 12.783723,
-    "s2:snow_ice_percentage": 0,
     "datetime": "2019-02-12T19:26:51.024000Z"
   },
   "geometry": {

diff --git a/json-schema/schema.json b/json-schema/schema.json
@@ -59,7 +59,6 @@
         { "required": ["s2:product_type"] },
         { "required": ["s2:datatake_type"] },
         { "required": ["s2:water_percentage"] },
-        { "required": ["s2:snow_ice_percentage"] },
         { "required": ["s2:vegetation_percentage"] },
         { "required": ["s2:thin_cirrus_percentage"] },
         { "required": ["s2:cloud_shadow_percentage"] },