Multi satellite reader allowing you to load bands and index and stack them.
Project description
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:
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).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.