From 8bee9667056bc0eb2c550d3b1455b557fdc3d03e Mon Sep 17 00:00:00 2001 From: Matthias Mohr Date: Wed, 29 May 2024 13:37:37 +0200 Subject: [PATCH] Deprecate baseline and generation time (#14) --- CHANGELOG.md | 4 ++++ README.md | 8 ++++++-- examples/item.json | 7 ++++--- examples/item2.json | 5 +++-- json-schema/schema.json | 8 ++++---- 5 files changed, 21 insertions(+), 11 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2a2f90e..860f144 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Deprecated +- `s2:generation_time` in favor of `processing:datetime` + +- `s2:processing_baseline` in favor of `processing:version` + ### Removed ### Fixed diff --git a/README.md b/README.md index 40ee8a4..7fd3cda 100644 --- a/README.md +++ b/README.md @@ -39,8 +39,6 @@ The fields in the table below can be used in these parts of STAC documents: | s2:datastrip_id | string | Datastrip Identifier | | s2:product_type | string | Product Type | | s2:datatake_type | string | Datatake Type | -| s2:generation_time | datetime | Generation Time | -| s2:processing_baseline | string | [Processing Baseline](https://sentinels.copernicus.eu/web/sentinel/technical-guides/sentinel-2-msi/processing-baseline) | | s2:reflectance_conversion_factor | number | Reflectance Conversion Factor | | s2:water_percentage | number | Water Percentage | | s2:snow_ice_percentage | number | Snow and Ice Percentage | @@ -55,6 +53,8 @@ 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: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 | | s2:mgrs_tile | string | **DEPRECATED** Sentinel-2 MGRS Tile Identifier | | s2:mean_solar_zenith | number | **DEPRECATED** Mean Solar Zenith | @@ -62,6 +62,10 @@ The fields in the table below can be used in these parts of STAC documents: ### Additional Field Information +**s2:generation_time** is deprecated in favor of `processing:datetime` + +**s2:processing_baseline** is deprecated in favor of `processing:version` + **s2:granule_id** is deprecated in favor of `s2:tile_id` **s2:mean_solar_zenith** is deprecated in favor of the View Extension field `view:sun_elevation` diff --git a/examples/item.json b/examples/item.json index 9609c95..3de0392 100644 --- a/examples/item.json +++ b/examples/item.json @@ -712,10 +712,10 @@ "s2:product_type": "S2MSI2A", "sat:orbit_state": "descending", "s2:datatake_type": "INS-NOBS", - "s2:generation_time": "2023-11-07T18:21:59.14490Z", + "processing:datetime": "2023-11-07T18:21:59.14490Z", "sat:relative_orbit": 139, "s2:water_percentage": 95.782292, - "s2:processing_baseline": "05.09", + "processing:version": "05.09", "s2:snow_ice_percentage": 0, "s2:vegetation_percentage": 0, "s2:thin_cirrus_percentage": 0.774645, @@ -734,7 +734,8 @@ "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/sat/v1.0.0/schema.json", - "https://stac-extensions.github.io/projection/v1.1.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" ], "stac_version": "1.0.0" } \ No newline at end of file diff --git a/examples/item2.json b/examples/item2.json index 40fb9be..51072d0 100644 --- a/examples/item2.json +++ b/examples/item2.json @@ -23,6 +23,8 @@ "eo:cloud_cover": 51.580326, "sat:orbit_state": "descending", "sat:relative_orbit": 13, + "processing:datetime": "2020-10-07T16:08:57.135Z", + "processing:version": "02.12", "proj:epsg": 32707, "proj:centroid": { "lat": -31.6824, @@ -35,8 +37,6 @@ "view:sun_azimuth": 62.3286549448294, "view:sun_elevation": 57.292926148638, "s2:product_uri": "S2A_MSIL2A_20190212T192651_N0212_R013_T07HFE_20201007T160857.SAFE", - "s2:generation_time": "2020-10-07T16:08:57.135Z", - "s2:processing_baseline": "02.12", "s2:product_type": "S2MSI2A", "s2:datatake_id": "GS2A_20190212T192651_019029_N02.12", "s2:datatake_type": "INS-NOBS", @@ -1785,6 +1785,7 @@ "https://stac-extensions.github.io/eo/v1.1.0/schema.json", "https://stac-extensions.github.io/raster/v1.1.0/schema.json", "https://stac-extensions.github.io/sat/v1.0.0/schema.json", + "https://stac-extensions.github.io/processing/v1.2.0/schema.json", "https://stac-extensions.github.io/projection/v1.1.0/schema.json", "https://stac-extensions.github.io/mgrs/v1.0.0/schema.json", "https://stac-extensions.github.io/grid/v1.1.0/schema.json", diff --git a/json-schema/schema.json b/json-schema/schema.json index a7e72d0..3735c4f 100644 --- a/json-schema/schema.json +++ b/json-schema/schema.json @@ -58,8 +58,6 @@ { "required": ["s2:datastrip_id"] }, { "required": ["s2:product_type"] }, { "required": ["s2:datatake_type"] }, - { "required": ["s2:generation_time"] }, - { "required": ["s2:processing_baseline"] }, { "required": ["s2:water_percentage"] }, { "required": ["s2:snow_ice_percentage"] }, { "required": ["s2:vegetation_percentage"] }, @@ -111,12 +109,14 @@ "s2:generation_time": { "title": "Generation Time", "type": "string", - "format": "date-time" + "format": "date-time", + "deprecated": true }, "s2:processing_baseline": { "title": "Processing Baseline", "type": "string", - "pattern": "^\\d\\d\\.\\d\\d$" + "pattern": "^\\d\\d\\.\\d\\d$", + "deprecated": true }, "s2:water_percentage": { "title": "Water Percentage",