Sentinel Hub Utilities
Project description
[![Join the chat at https://gitter.im/sinergise/Lobby](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/sinergise/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Build Status](https://travis-ci.org/sentinel-hub/sentinelhub-py.svg?branch=master)](https://travis-ci.org/sentinel-hub/sentinelhub-py)
# Description
The **sentinelhub** Python package allows users to make OGC (WMS and WCS)
web requests to download and process satellite images within your Python
scripts. It supports Sentinel-2 L1C and L2A, Sentinel-1, Landsat 8, MODIS and DEM data source.
The package also supports obtaining data from Amazon Web Service. It can either provide data from public bucket with
Sentinel-2 L1C imagery or requester pays bucket with Sentinel-2 L2A imagery. If specified the downloaded data can be
stored in ESA .SAFE format (all types of .SAFE format are supported).
# Installation
The package requires a Python version >= 3.5 and installed C/C++ compiler. The package is available on
the PyPI package manager and can be installed with
```
$ pip install sentinelhub --upgrade
```
To install the package manually, clone the repository and
```
$ python setup.py build
$ python setup.py install
```
Once installed or updated the package can be configured according to [instructions in documentation](http://sentinelhub-py.readthedocs.io/en/latest/configure.html).
# Content
### OGC web service
Some of the major features are linked to one's [Sentinel Hub account](https://services.sentinel-hub.com/oauth/subscription):
* 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;
* support for various data sources:
* Sentinel-2 L1C,
* Sentinel-2 L2A,
* Sentinel-1,
* Landsat 8,
* MODIS,
* DEM.
### AWS data download
The package allows to download Sentinel-2 data from Sentinel-2 on AWS
and reconstruct data into ESA .SAFE format.
The following are implemented:
* support for Sentinel-2 L1C and Sentinel-2 L2A data;
* 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;
* adjustable threaded downloads, and optional redownloads of existing data (not default);
* requires either S-2 product ID, or tile name and date of a product.
In case of Sentinel-2 L2A data AWS access key is required.
### Documentation
For more information on the package and to access the documentation, visit [readthedocs](http://sentinelhub-py.readthedocs.io/).
# Examples
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](examples/)
folder, or viewed in the [docs](http://sentinelhub-py.readthedocs.io/):
* Using OGC web services ([link](http://sentinelhub-py.readthedocs.io/en/latest/examples/ogc_request.html))
* Using utilities for large geographical areas ([link](http://sentinelhub-py.readthedocs.io/en/latest/examples/large_area_utilities.html))
* AWS data download ([link](http://sentinelhub-py.readthedocs.io/en/latest/examples/aws_request.html))
* AWS data download from command line in .SAFE format ([link](http://sentinelhub-py.readthedocs.io/en/latest/aws_cli.html))
# Blog posts
* [Upgrading the sentinelhub Python package](https://medium.com/sentinel-hub/upgrading-the-sentinelhub-python-package-2665f9c10df)
* [Release of sentinelhub Python Package 2.0](https://medium.com/sentinel-hub/release-of-sentinelhub-python-package-2-0-a3d47709f8fd)
# License
See [LICENSE](LICENSE.md).
[![Build Status](https://travis-ci.org/sentinel-hub/sentinelhub-py.svg?branch=master)](https://travis-ci.org/sentinel-hub/sentinelhub-py)
# Description
The **sentinelhub** Python package allows users to make OGC (WMS and WCS)
web requests to download and process satellite images within your Python
scripts. It supports Sentinel-2 L1C and L2A, Sentinel-1, Landsat 8, MODIS and DEM data source.
The package also supports obtaining data from Amazon Web Service. It can either provide data from public bucket with
Sentinel-2 L1C imagery or requester pays bucket with Sentinel-2 L2A imagery. If specified the downloaded data can be
stored in ESA .SAFE format (all types of .SAFE format are supported).
# Installation
The package requires a Python version >= 3.5 and installed C/C++ compiler. The package is available on
the PyPI package manager and can be installed with
```
$ pip install sentinelhub --upgrade
```
To install the package manually, clone the repository and
```
$ python setup.py build
$ python setup.py install
```
Once installed or updated the package can be configured according to [instructions in documentation](http://sentinelhub-py.readthedocs.io/en/latest/configure.html).
# Content
### OGC web service
Some of the major features are linked to one's [Sentinel Hub account](https://services.sentinel-hub.com/oauth/subscription):
* 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;
* support for various data sources:
* Sentinel-2 L1C,
* Sentinel-2 L2A,
* Sentinel-1,
* Landsat 8,
* MODIS,
* DEM.
### AWS data download
The package allows to download Sentinel-2 data from Sentinel-2 on AWS
and reconstruct data into ESA .SAFE format.
The following are implemented:
* support for Sentinel-2 L1C and Sentinel-2 L2A data;
* 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;
* adjustable threaded downloads, and optional redownloads of existing data (not default);
* requires either S-2 product ID, or tile name and date of a product.
In case of Sentinel-2 L2A data AWS access key is required.
### Documentation
For more information on the package and to access the documentation, visit [readthedocs](http://sentinelhub-py.readthedocs.io/).
# Examples
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](examples/)
folder, or viewed in the [docs](http://sentinelhub-py.readthedocs.io/):
* Using OGC web services ([link](http://sentinelhub-py.readthedocs.io/en/latest/examples/ogc_request.html))
* Using utilities for large geographical areas ([link](http://sentinelhub-py.readthedocs.io/en/latest/examples/large_area_utilities.html))
* AWS data download ([link](http://sentinelhub-py.readthedocs.io/en/latest/examples/aws_request.html))
* AWS data download from command line in .SAFE format ([link](http://sentinelhub-py.readthedocs.io/en/latest/aws_cli.html))
# Blog posts
* [Upgrading the sentinelhub Python package](https://medium.com/sentinel-hub/upgrading-the-sentinelhub-python-package-2665f9c10df)
* [Release of sentinelhub Python Package 2.0](https://medium.com/sentinel-hub/release-of-sentinelhub-python-package-2-0-a3d47709f8fd)
# License
See [LICENSE](LICENSE.md).
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.
Source Distribution
sentinelhub-2.1.0.tar.gz
(51.2 kB
view hashes)