Eoreader

Enhancements

- **ENH: Adding the support of Capella constellation** ([74](https://github.com/sertit/eoreader/issues/74))
- **ENH: Allow the user to load bands with a window (pixels and geo)** ([25](https://github.com/sertit/eoreader/issues/25))
, [notebook](https://eoreader.readthedocs.io/en/latest/notebooks/windowed_reading.html))

Bug Fixes

- FIX: Fix extent computation for `CSG` products with Shapely 2.0
- FIX: Shapely 2.0 deprecation warnings

Other

- DEPR: Add deprecation warning for EOReader spectral indices (used for legacy in 0.18.0) that are aliases of ASI names ([72](https://github.com/sertit/eoreader/issues/72)):
- `AFRI_1_6`: `AFRI1600`,
- `AFRI_2_1`: `AFRI2100`,
- `BSI`: `BI`,
- `NDGRI`: `NGRDI`,
- `NDRE1`: `NDREI`,
- `RGI`: `RGRI`,
- `WV_BI`: `NHFD`,
- `WI`: `WI2015`,
- `RDI`: `DSI`,
- `DSWI`: `DSWI5`,
- `GRI`: `DSWI4`,
- `WV_SI`: `NDSIWV`,
- `PANI`: `BITM`
- DOC: Changing copyright from 2022 to 2023

Bug Fixes

- FIX: Fix regression for missing EOReader aliases for `spyndex` spectral indices
- FIX: Fix bug in footprint computation of DIMAP V1 data

Other

- DOC: Add latest DOI link
- LIB: Pass to `sertit==1.21.0` to handle windowed data in read natively

Breaking Changes

- **BREAKING CHANGES: Refactoring spectral indices management** ([47](https://github.com/sertit/eoreader/issues/47))
- Using [spyndex](https://github.com/awesome-spectral-indices/spyndex) library, allowing to use all spectral indices
listed [here](https://github.com/awesome-spectral-indices/awesome-spectral-indices/blob/main/output/spectral-indices-table.csv)
- SAR products may now compute indices if possible (see [this list](https://awesome-ee-spectral-indices.readthedocs.io/en/latest/list.html#radar))
- Old EOReader indices are still available for legacy purposes, with some changes:
- For Sentinel-2 data, the band `NIR` and `NARROW_NIR` may be interchanged for some index (
see [this discussion](https://github.com/awesome-spectral-indices/awesome-spectral-indices/issues/27))
- OSAVI formula has changed to stick with the original paper definition (see [issue](https://github.com/awesome-spectral-indices/awesome-spectral-indices/issues/12))
- `NDRE2/3` formula are fixed, now using `VRE_2/3` and `NDRE1` corresponds to `NDREI` and uses `VRE_1`
- `CI1` is renamed `CI32` and `CI2` is renamed `CI21` for readability purposes
- `NDWI21` can be written `NDWI2100` for homogeneity purposes
- `RDI` (or `DSI`) uses now `SWIR_1` instead of `SWIR_2` (see [this](https://github.com/awesome-spectral-indices/awesome-spectral-indices/issues/18) issue)
- `PANI` equivalent is now `BITM` and is normalised ! (divided by 3)
- `SBI` is normalized (divided by 2) to fit with `BIXS` definition
- ⚠ *You may need to install the last `spyndex` directly from GitHub latest version to have all available indices*
- **BREAKING CHANGES: Using `pyresample` to geocode Sentinel-3 data** ([55](https://github.com/sertit/eoreader/issues/55))
- Cleaner: better conversion from swath to grid
- Faster: Up to 4 times faster
- Allows code refactoring between OLCI and SLSTR
- **BREAKING CHANGES: For SAR product types that are not available in the Data Access Portfolio, default resolution is now the pixel spacing instead of the rg x az resolution**
- Changes mainly Sentinel-1 default resolutions (except from IW mode)

Enhancements

- **ENH: Adding the support of Harmonized Landsat-Sentinel constellation** ([49](https://github.com/sertit/eoreader/issues/49))
- **ENH: Adding the support of GEOSAT-2 constellation** ([59](https://github.com/sertit/eoreader/issues/59))

Bug Fixes

- FIX: Fixing `CustomProduct` initialization when fields are set to None (instead of not declaring them)
- FIX: SNAP cannot handle float predictors other than 1! Set it to 1 when saving ortho SAR images to disk, in order for SNAP to be able to despeckle
them. See [SNAP issue](https://forum.step.esa.int/t/exception-found-when-reading-compressed-tif/654/7). ([#62](https://github.com/sertit/eoreader/issues/62))
- FIX: Fixing mix in `Sentinel-2` mapping for `B8` (`NIR`, 10m resolution, large spectral bandwidth) and `B8A` (`NARROW_NIR`, 20m resolution, narrow spectral bandwidth)

Other

- DOC: Add FAQ entry concerning SAR constellations extent KML files failing to be read (TLDR: needs `ogr2ogr` in your
PATH)
- DOC: Add Technical Note published in Remote Sensing MDPI in Readme
- DOC: Update optical band mapping graphs (fix regression to 0.15.0 supported constellation)
- DOC: Add information about DEM management in SAR notebook ([61](https://github.com/sertit/eoreader/issues/61))
- DOC: Updating indices paragraphs
- CI: Using actions/checkoutv3
- CI: Updating versions of pre-commit hooks
- LIBS: Updating `requirements.txt` and `setup.py` to add `pyresample` and `zarr`

Enhancements

- **ENH: Adding the support of RapidEye constellation**
- **ENH: Handling Planet data with multiple subdatasets** ([45](https://github.com/sertit/eoreader/issues/45))
- **ENH: Adding the support of Landsat Level-2 products** ([49](https://github.com/sertit/eoreader/issues/49))
- **ENH: Adding the support of Pleides Neo SEN and PRJ products** *(needs GDAL 3.5+ or rasterio 1.3.0+)*
- **ENH: Adding the function `bands.is_thermal_band`**
- **ENH: Adding the ability for optical custom stacks to load indices**
- **ENH: Adding [BAIM (MODIS Burned Area Index)](https://www.researchgate.net/publication/248428333_Burnt_Area_Index_BAIM_for_burned_area_discrimination_at_regional_scale_using_MODIS_datafire)
spectral index**
- **ENH: Better management of raw units of the bands of optical products**
- **ENH: Copying files from `tmp_process` when changing product's output**

Bug Fixes

- FIX: Stacks saved as integers on disk keep their original dtype (float32) in Python
- FIX: Stacks with bands loaded "as is" are correctly saved as integers on disk ([52](https://github.com/sertit/eoreader/issues/52))
- FIX: Using stack CRS (if projected) for `DIMAP` products instead of recomputing from lat/lon, solving potential discrepancies between stack and product CRS
- FIX: Workaround for JP2 bug when updating an existing raster (maybe related to [this bug](https://github.com/rasterio/rasterio/issues/2528))
- FIX: Better management of SkySat datetime conversion from JSON to XML (deterministic way)
- FIX: Fixing computation of invalid pixels for `Sentinel-2` and `DIMAP` products (do not remove straylight mask)
- FIX: Fixing reprojection resolution of VHR data
- FIX: Computing Brightness Temperature of `Landsat` TIR bands instead of leaving them as is
- FIX: Better management of Landsat Instrument values
- FIX: Better radiometry attribute (adding `brightness temperature` and `reflectance and brightness temperature` values)
- FIX: Changing `Brilliance Temperature` to the correct `Brightness Temperature`
- FIX: Fixing pandas FutureWarning `The frame.append method is deprecated and will be removed from pandas in a future version.`
- FIX: Fixing DeprecationWarning `invalid escape sequence \.`
- FIX: Manage correctly Planet dubious pixels [(especially for 8 bands products)](https://community.planet.com/planet-s-community-forum-3/planetscope-8-bands-and-udm-mask-245?postid=427#post427)

Optimizations

- OPTIM: Reduce memory usage when updating all the bands attributes
- OPTIM: Reduce memory usage when stacking as integers

Other

- DOC: Add the need of using SNAP 8.0 up-to-date or SNAP 9.0 ([42](https://github.com/sertit/eoreader/issues/42))
- DOC: Add the STAC session in API documentation
- DOC: Add warnings for shifts when orthorectifying DIMAP SEN products (using RPCs) ([53](https://github.com/sertit/eoreader/issues/53))
- DOC: Add limitations to custom stacks
- DEPS: Dropping support of Python 3.7 ([18](https://github.com/sertit/eoreader/issues/18))
- DEPS: Update minimum version of libs *(geopandas 0.11.0+, rasterio 1.3.0+...)*

Bug Fixes

- FIX: Add the missing conversion to reflectance for `Sentinel-3 OLCI`
- FIX: Better condition for the conversion to reflectance for `Sentinel-2 THEIA`
- FIX: Add logs for `SkySat` data that cannot been converted to reflectance and fix the `radiometry` field of its band xarrays
- FIX: Add the correct nodata (when overridden by the user) to stacks saved as uint16

Optimizations

- OPTIM: Reduce memory usage during stacking

Other

- CI: Test reflectance values

Enhancements

- **ENH: Adding the support of SuperView-1 constellation ([21](https://github.com/sertit/eoreader/issues/21))**
- **ENH: Adding the support of SPOT-4/5 constellations ([39](https://github.com/sertit/eoreader/issues/39))**
- **ENH: Allow the possibility to pass a constellation (or a constellation list) to `Reader().open()` to speed up the opening of a product**
- **ENH: Add a quicklook search for `Sentinel-3` products**

Bug Fixes

- FIX: Fix quicklook media type with `JP2` files
- FIX: Fix `Sentinel-3 SLSTR` `F1` bands based on F grid
- FIX: Correct the UTM projection for `Sentinel-3` data
- FIX: Fix handling of zipped `Sentinel-2 L2Ap`
- FIX: Fix zipped `Sentinel-2` with other XML files in GRANULE subdirectories

Other

- Renaming `master` branch to `main`