Metadata-Version: 2.1
Name: eoreader
Version: 0.3.2.post1
Summary: Multi satellite reader allowing you to load bands and index and stack them.
Home-page: UNKNOWN
Author: Rémi BRAUN
Author-email: dev-sertit@unistra.fr
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/sertit/eoreader/issues/
Project-URL: Documentation, https://sertit.github.io/eoreader/
Project-URL: Source Code, https://github.com/sertit/eoreader
Description: [![pypi](https://img.shields.io/pypi/v/eoreader.svg)](https://pypi.python.org/pypi/eareader)
        [![Conda](https://img.shields.io/conda/vn/conda-forge/eoreader.svg)](https://anaconda.org/conda-forge/eoreader)
        [![Tests](https://github.com/sertit/eoreader/actions/workflows/test.yml/badge.svg)](https://github.com/sertit/eoreader/actions/workflows/test.yml)
        [![Gitter](https://badges.gitter.im/eoreader/community.svg)](https://gitter.im/eoreader/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
        [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
        [![black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)
        [![Apache](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/sertit/eoreader/blob/master/LICENSE)
        
        # ![eoreader_logo](https://raw.githubusercontent.com/sertit/eoreader/master/docs/eoreader_small.png) EOReader
        
        **EOReader** is a **multi-satellite reader** allowing you to open
        [optical](https://sertit.github.io/eoreader/eoreader#implemented-optical-satellites)
        and [SAR](https://sertit.github.io/eoreader/eoreader#implemented-sar-satellites) data.
        
        ||**Optical** | **SAR**|
        |--- | --- | ---|
        |Sensors|+ Sentinel-2 & Theia<br>+ Sentinel-3 OLCI & SLSTR<br>+ Landsats 1 - 8| + Sentinel-1<br>+ COSMO-Skymed<br>+ TerraSAR-X<br>+ RADARSAT-2|
        
        It also implements additional **sensor-agnostic** features:
        
        - `eoreader.products.product.Product.load`: Load many band types:
            - satellite bands ([optical](https://sertit.github.io/eoreader/eoreader#band-mapping) or [SAR](https://sertit.github.io/eoreader/eoreader#sar-bands))
            - [index](https://sertit.github.io/eoreader/eoreader#available-index)
            - [cloud bands](https://sertit.github.io/eoreader/eoreader#cloud-bands)
            - [DEM bands](https://sertit.github.io/eoreader/eoreader#dem-bands)
        - `eoreader.products.product.Product.stack`: Stack all these type of bands
        
        EOReader works with [`xarrays.DataArray`](http://xarray.pydata.org/en/stable/generated/xarray.DataArray.html#xarray.DataArray)
        and [`geopandas.GeoDataFrames`](https://geopandas.org/docs/user_guide/data_structures.html#geodataframe)
        
        
        ## Python Quickstart
        
        The main features of EOReader are gathered hereunder.
        For optical data:
        
        ```python
        >>> from eoreader.reader import Reader
        >>> from eoreader.bands.alias import *
        
        >>> # Your variables
        >>> l5_path = "D:/eoreader/CI/DATA/LM05_L1TP_200029_19841014_20200902_02_T2.tar"
        
        >>> # Create the reader object and open satellite data
        >>> eoreader = Reader()
        >>> l5_prod = eoreader.open(l5_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 = l5_prod.footprint
        >>> extent = l5_prod.extent
        
        >>> # Load some bands and index: they will all share the same metadata
        >>> bands = l5_prod.load([NDVI, GREEN, HILLSHADE, CLOUDS]
        
        >>> # Create a stack with some other bands
        >>> stack = l5_prod.stack([NDWI, RED, SLOPE])
        
        >>> # Read Metadata
        >>> mtd, namespace = l5_prod.read_mtd()
        ```
        
        For SAR data:
        
        ```python
        >>> from eoreader.reader import Reader
        >>> from eoreader.bands.alias import *
        
        >>> # Your variables
        >>> s1_path = "D:/eoreader/S1B_EW_GRDM_1SDH_20200422T080459_20200422T080559_021254_028559_784D.zip"  # Not in the package
        
        >>> # Create the reader object and open satellite data
        >>> eoreader = Reader()
        >>> s1_prod = eoreader.open(s1_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 = s1_prod.footprint
        >>> extent = s1_prod.extent
        
        >>> # Load some bands and index: they will all share the same metadata
        >>> bands = s1_prod.load([VV, VV_DSPK, DEM]
        
        >>> # Create a stack with some other bands
        >>> stack = s1_prod.stack([VV, VV_DSPK, SLOPE])
        
        >>> # Read Metadata
        >>> mtd, namespace = s1_prod.read_mtd()
        ```
        
        Sentinel-3 and SAR products need [`SNAP gpt`](https://senbox.atlassian.net/wiki/spaces/SNAP/pages/70503590/Creating+a+GPF+Graph) to be geocoded.
        Ensure that you have the folder containing your `gpt.exe` in your `PATH`.
        
        ## Documentation
        The API documentation can be found [here](https://sertit.github.io/eoreader/eoreader/).
        
        ## Examples
        
        Available notebooks provided as examples:
        
        - [Basic tutorial](https://sertit.github.io/eoreader/examples/base.html)
        - [Water detection](https://sertit.github.io/eoreader/examples/water_detection.html)
        
        ## Installation
        
        `pip install eoreader` or `conda install eoreader`
        
        EOReader mainly relies on `geopandas` and `rasterio` (through `rioxarray`).
        
        On Windows and with pip, you may face installation issues due to GDAL.
        The well known workaround of installing from [Gohlke's wheels](https://www.lfd.uci.edu/~gohlke/pythonlibs/#rasterio)
        also applies here.
        Please look at the [rasterio page](https://rasterio.readthedocs.io/en/latest/installation.html)
        to learn more about that.
        
        ## License
        
        **EOReader** is licensed under Apache License v2.0. See LICENSE file for details.
        
        ## Authors
        
        **EOReader** has been created by [ICube-SERTIT](https://sertit.unistra.fr/).
        
        ## Credits
        
        **EOReader** is built on top of amazing libs, without which it couldn't have been coded:
        
        - [`geopandas`](https://geopandas.org/)
        - [`rasterio`](https://rasterio.readthedocs.io/en/latest/)
        - [`xarray`](http://xarray.pydata.org/en/stable/)
        - [`rioxarray`](https://corteva.github.io/rioxarray/stable/)
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
