eoreader 0.3.1.post2

Multi satellite reader allowing you to load bands and index and stack them.

EOReader

EOReader is a multi-satellite reader allowing you to open optical and SAR data.

	Optical	SAR
Sensors	+ Sentinel-2 & Theia + Sentinel-3 OLCI & SLSTR + Landsats 1 - 8	+ Sentinel-1 + COSMO-Skymed + TerraSAR-X + RADARSAT-2

It also implements additional sensor-agnostic features:

• eoreader.products.product.Product.load: Load many band types:
  • satellite bands (optical or SAR)
  • index
  • cloud bands
  • DEM bands
• eoreader.products.product.Product.stack: Stack all these type of bands

EOReader works with xarrays.DataArray and geopandas.GeoDataFrames

Python Quickstart

The main features of EOReader are gathered hereunder:

>>> from eoreader.reader import Reader
>>> from eoreader.bands.alias import *

>>> # Your variables
>>> path = r"path/to/your/satellite/product"  # Optical in this example

>>> # Create the reader object and open satellite data
>>> eoreader = Reader()
>>> prod = eoreader.open(path)  # The Reader will recognize the satellite type from its name

>>> # Get the footprint of the product (usable data) and its extent (envelope of the tile)
>>> footprint = prod.footprint
>>> extent = prod.extent

>>> # Load some bands and index: they will all share the same metadata
>>> bands = prod.load([NDVI, GREEN, HILLSHADE, CLOUDS]

>>> # Create a stack with some other bands
>>> stack = prod.stack([NDVI, MNDWI, GREEN, SLOPE, CIRRUS])

>>> # Read Metadata
>>> mtd, namespace = prod.read_mtd()

Sentinel-3 and SAR products need SNAP gpt to be geocoded. Ensure that you have the folder containing your gpt.exe in your PATH.

Documentation

The API documentation can be found here.

Examples

Available notebooks provided as examples:

• Basic tutorial
• Water detection

Installation

pip install eoreader

EOReader depends mainly on geopandas and rasterio. (with GDAL installation issues on Windows, so please install them from wheels that you can find here).

License

EOReader is licensed under Apache License v2.0. See LICENSE file for details.

##Authors

EOReader has been created by ICube-SERTIT.

Credits

EOReader is built on top of amazing libs, without which it couldn't have been coded:

• geopandas
• rasterio
• xarray
• rioxarray