Utility to search and download Sentinel-1 Imagery
Project description
sentinelsat
Sentinelsat makes finding and downloading Copernicus Sentinel satellite images from the Sentinels Scientific Datahub easy.
It offers an easy to use command line interface.
sentinel search --sentinel2 --cloud 30 user password search_polygon.geojsonand a powerful Python API.
from sentinelsat.sentinel import SentinelAPI, get_coordinates
api = SentinelAPI('user', 'password')
products = api.query(get_coordinates('search_polygon.geojson'), \
producttype = 'SLC', \
orbitdirection='ASCENDING')
api.download_all(products)Documentation is published at http://sentinelsat.readthedocs.io/.
Installation
Sentinelsat depends on homura, which depends on PycURL, so you might need to install some dependencies on your system.
Install sentinelsat through pip:
pip install sentinelsatThe documentation contains examples on how to install the dependencies for Ubuntu, Fedora and Windows.
Usage
Sentinelsat provides a Python Library and a Command Line Interface to search and download Sentinel products.
Python Library
# connect to the API
from sentinelsat.sentinel import SentinelAPI, get_coordinates
api = SentinelAPI('user', 'password', 'https://scihub.copernicus.eu/dhus')
# download single scene by known product id
api.download(<product_id>)
# search by polygon, time, and SciHub query keywords
products = api.query(get_coordinates('map.geojson'), \
'20151219', date(2015, 12, 29), \
platformname = 'Sentinel-2', \
cloudcoverpercentage = '[0 TO 30]'})
# download all results from the search
api.download_all(products)
# GeoJSON FeatureCollection containing footprints and metadata of the scenes
api.get_footprints(products)Valid search query keywords can be found at the ESA SciHub documentation.
Command Line Interface
A basic search query consists of a search polygon as well as the username and password to access the Scihub.
sentinel search [OPTIONS] <user> <password> <geojson>Search areas are provided as GeoJSON polygons, which can be created with QGIS or geojson.io. If you do not specify a start and end date only products published in the last 24 hours will be queried.
Example
Search and download all Sentinel-1 scenes of type SLC, in descending orbit for the year 2015.
sentinel search -s 20150101 -e 20151231 -d \
-q "producttype=SLC, orbitdirection=Descending" \
-u "https://scihub.copernicus.eu/dhus" <user> <password> <poly.geojson>Options
-s |
--start |
TEXT |
Start date of the query in the format YYYYMMDD. |
-e |
--end |
TEXT |
End date of the query in the format YYYYMMDD. |
-d |
--download |
Download all results of the query. |
|
-f |
--footprints |
Create geojson file search_footprints.geojson with footprints of the query result. |
|
-p |
--path |
PATH |
Set the path where the files will be saved. |
-q |
--query |
TEXT |
Extra search keywords you want to use in the query. Separate keywords with comma. Example: ‘producttype=GRD,polarisationmode=HH’. |
-u |
--url |
TEXT |
Define another API URL. Default URL is ‘https://scihub.copernicus.eu/apihub/’. |
--md5 |
Verify the MD5 checksum and write corrupt product ids and filenames to corrupt_scenes.txt. |
||
--sentinel1 |
Limit search to Sentinel-1 products. |
||
--sentinel2 |
Limit search to Sentinel-2 products. |
||
-c |
--cloud |
INT |
Maximum cloud cover in percent. (Automatically sets –sentinel2) |
--help |
Show help message and exit. |
Troubleshooting
The download from Scihub will fail if the server certificate cannot be verified because no default CA bundle is defined, as on Windows, or when the CA bundle is outdated. In most cases the easiest solution is to install or update certifi:
pip install -U certifi You can also override the the path setting to the PEM file of the CA bundle using the pass_through_opts keyword argument when calling api.download() or api.download_all():
from pycurl import CAINFO
api.download_all(pass_through_opts={CAINFO: 'path/to/my/cacert.pem'})Tests
To run the tests on sentinelsat:
git clone https://github.com/ibamacsr/sentinelsat.git
cd sentinelsat
pip install -e .[test]
export SENTINEL_USER=<your scihub username>
export SENTINEL_PASSWORD=<your scihub password>
py.test -vBy default, prerecorded responses to SciHub queries are used to not be affected by Scihub’s downtime. The only exceptions are downloading tests, which can be disabled with -m "not homura". To allow the tests to run actual queries on SciHub add --vcr disable to py.test arguments. If you wish to update the recordings use --vcr record_new or --vcr reset_all.
Changelog
Check CHANGELOG.
Contributors
Wille Marcel
Kersten Clauss
Martin Valgur
Jonas Sølvsteen
Luca Delucchi
License
GPLv3+
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
Built Distributions
Hashes for sentinelsat-0.9-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e9db81078d9ac7c2c5a985ad57e333e2edc0b695f88862a2c21447f6aa4e575c |
|
| MD5 | 5b146bd8d203e2b260d625cf8177fd3d |
|
| BLAKE2b-256 | bc3795800587804aec74f7782912eed3e9047e1b8a5eecda6ba6858a14d10eb4 |
Hashes for sentinelsat-0.9-py2-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6b1062b859bc2942800b253e9debd8ee694826b682e9299820c4a96b97224e76 |
|
| MD5 | cca1f74549380a991a0ea9fc5afedbff |
|
| BLAKE2b-256 | 21c9b61a807d2933906757df115b9462f034d3ae640d86c5c01f78bf31932f5f |
