The sentinelhub Python package allows users to make OGC (WMS and WCS) web requests to download and process Sentinel-2 images within your Python scripts.
Version 1.0 is backwards compatible with previous releases, and therefore allows users to also download raw data from AWS to .SAFE format.
The package requires a Python 3.* version. The package is available on the PyPI package manager and can be installed with
$ pip install -U sentinelhub
To install the package manually, clone the repository and
$ python setup.py build
$ python setup.py install
The package is backward compatible with the previous version.
A summary of the package content is provided below. For more information on the package and to access the documentation, visit the docs.
Some of the major features introduced in version 1.0 are linked to one's Sentinel-Hub account:
- support for Web Map Service (WMS) and Web Coverage Service (WCS) requests using your Sentinel-Hub account;
- support for standard and custom multi-spectra layers, such as unprocessed bands, true color imagery, or NDVI;
- support for multi-temporal requests;
- support for cloud coverage filtering;
- support for different Coordinate Reference Systems;
- support to read and write downloaded data to disk in the most common image and data formats.
The package allows to download Sentinel-2 data from Sentinel-2 on AWS and reconstruct data into ESA .SAFE format. Sentinel-Hub account is not required to use this functionality.
The following are implemented:
- support of old and new (i.e. compact) .SAFE format;
- support for downloading of either entire product, or a map of the .SAFE structure only;
- support of command lines entries;
- support of threaded downloads, and redownloads of existing data (not default);
- requires either S-2 product ID, or tile name and date of a product.
Jupyter notebooks on how to use the modules to execute OGC requests, or download raw data from AWS in .SAFE format can be found in the examples folder, or viewed in the docs:
- AWS data download cli (link);
- AWS data download using Jupyter notebook (link);
- Using OGC web services within Jupyter notebook (link).
See LICENSE.