- **BREAKING CHANGES: Platform becomes Constellation to fit STAC vocabulary**

- **ENH: Add a STAC object that can be used to retrieve STAC Items from every Product (`prod.stac.create_item()`)**
- **ENH: Extending `get_raw_band_paths` to every products ([#31](#31
- **ENH: Adding a `is_ortho` attribute corresponding to when the product is already orthorectified/geocoded, in order to avoid computing heavy processes without wanting it (i.e. footprint...)**
- OPTIM: Retrieve extent from metadata when possible

Author: remi-braun

CHANGES.md

@@ -5,6 +5,7 @@
 ### Breaking Changes
 
 - **BREAKING CHANGES: `Optical` becomes `Spectral` when more appropriate**
+- **BREAKING CHANGES: `Platform` becomes `Constellation` to fit STAC vocabulary**
 - **BREAKING CHANGES: File `alias` is removed, replaced by `*_bands` files and proper imports in `bands.__init__`**
 - **BREAKING CHANGES: Product attribute `band_names` becomes `bands` in order to be STAC compliant ([#29](https://github.com/sertit/eoreader/issues/29))**
 - **BREAKING CHANGES: Better use of `NIR` and `NARROW_NIR` in the `indices` file (according to the gsd of `Sentinel-2` bands composing the indices)**
@@ -19,10 +20,14 @@
 - **ENH: Adding the `GREEN1` mapped band, corresponding to PlanetScope `GREEN I` and `Sentinel-3 OLCI` `Oa05` band**
 - **ENH: Handle some slightly broken `Sentinel-2` products, i.e. when the metadata files are corrupted or when the detfoo vectors are empty ([#34](https://github.com/sertit/eoreader/issues/34))**
 - **ENH: Handle exception for corrupted bands (in `Sentinel-2` and `utils.read`) ([#34](https://github.com/sertit/eoreader/issues/34))**
+- **ENH: Add a STAC object that can be used to retrieve STAC Items from every Product (`prod.stac.create_item()`)**
+- **ENH: Extending `get_raw_band_paths` to every products ([#31](https://github.com/sertit/eoreader/issues/31))**
+- **ENH: Adding a `is_ortho` attribute corresponding to when the product is already orthorectified/geocoded, in order to avoid computing heavy processes without wanting it (i.e. footprint...)**
 
 ### Optimizations
 
-- OPTIM: retrieve name from filename if possible
+- OPTIM: Retrieve name from filename if possible
+- OPTIM: Retrieve extent from metadata when possible
 
 ### Bug Fixes
 

CI/SCRIPTS/test_custom.py

@@ -43,7 +43,7 @@ def test_custom():
         name="20200310T030415_WV02_Ortho",
         datetime="20200310T030415",
         sensor_type=SensorType.OPTICAL,
-        platform="WV02",
+        constellation="WV02",
         resolution=2.0,
         product_type="Ortho",
         band_map={BLUE: 1, GREEN: 2, RED: 3, NIR: 4, SWIR_1: 5},
@@ -150,7 +150,7 @@ def test_custom():
         sensor_type=SensorType.SAR,
         name="20210827T162210_ICEYE_SC_GRD",
         datetime="20210827T162210",
-        platform="ICEYE",
+        constellation="ICEYE",
         resolution=6.0,
         product_type="GRD",
         band_map={VV: 1, VV_DSPK: 2},
@@ -198,7 +198,7 @@ def test_custom():
         sensor_type=SensorType.OPTICAL,
         name="SPOT6_WGS84",
         datetime="20181218T090308",
-        platform="SPOT6",
+        constellation="SPOT6",
         resolution=1.5 * 15,
         product_type="ORT",
         band_map={RED: 1, GREEN: 2, BLUE: 3, NIR: 4},
@@ -221,7 +221,7 @@ def test_custom():
     assert root.findtext("name") == "SPOT6_WGS84"
     assert root.findtext("datetime") == "2018-12-18T09:03:08"
     assert root.findtext("sensor_type") == "Optical"
-    assert root.findtext("platform") == "Spot-6"
+    assert root.findtext("constellation") == "Spot-6"
     assert root.findtext("resolution") == str(1.5 * 15)
     assert root.findtext("product_type") == "ORT"
     assert root.findtext("band_map") == "{'BLUE': 3, 'GREEN': 2, 'RED': 1, 'NIR': 4}"

CI/SCRIPTS/test_others.py

@@ -13,7 +13,7 @@
 from eoreader.env_vars import DEM_PATH, S3_DB_URL_ROOT
 from eoreader.exceptions import InvalidTypeError
 from eoreader.products import SensorType
-from eoreader.reader import Platform
+from eoreader.reader import Constellation
 
 from .scripts_utils import (
     AWS_ACCESS_KEY_ID,
@@ -331,15 +331,15 @@ def test_reader_methods():
     prod_path = opt_path().joinpath("LC08_L1GT_023030_20200518_20200527_01_T2")
 
     # NAME
-    READER.valid_name(prod_path, Platform.L8)
+    READER.valid_name(prod_path, Constellation.L8)
     READER.valid_name(prod_path, "L8")
     READER.valid_name(prod_path, "Landsat-8")
-    READER.valid_name(prod_path, Platform.L8.name)
-    READER.valid_name(prod_path, Platform.L8.value)
+    READER.valid_name(prod_path, Constellation.L8.name)
+    READER.valid_name(prod_path, Constellation.L8.value)
 
     # MTD
-    READER.valid_mtd(prod_path, Platform.L8)
+    READER.valid_mtd(prod_path, Constellation.L8)
     READER.valid_mtd(prod_path, "L8")
     READER.valid_mtd(prod_path, "Landsat-8")
-    READER.valid_mtd(prod_path, Platform.L8.name)
-    READER.valid_mtd(prod_path, Platform.L8.value)
+    READER.valid_mtd(prod_path, Constellation.L8.name)
+    READER.valid_mtd(prod_path, Constellation.L8.value)

CI/SCRIPTS/test_satellites.py

@@ -260,7 +260,7 @@ def _test_core(
 
                 # Check attributes
                 assert stack.attrs["long_name"] == " ".join(to_str(stack_bands))
-                assert stack.attrs["sensor"] == prod._get_platform().value
+                assert stack.attrs["sensor"] == prod._get_constellation().value
                 assert stack.attrs["sensor_id"] == prod.sat_id
                 assert stack.attrs["product_type"] == prod.product_type.value
                 assert stack.attrs["acquisition_date"] == prod.get_datetime(
@@ -301,7 +301,7 @@ def _test_core(
 
                 # Check attributes
                 assert band_arr.attrs["long_name"] == first_band.name
-                assert band_arr.attrs["sensor"] == prod._get_platform().value
+                assert band_arr.attrs["sensor"] == prod._get_constellation().value
                 assert band_arr.attrs["sensor_id"] == prod.sat_id
                 assert band_arr.attrs["product_type"] == prod.product_type.value
                 assert band_arr.attrs["acquisition_date"] == prod.get_datetime(