sentinelsat 0.1.dev0

Utility to search and download Sentinel-1 Imagery

sentinelsat

Utility to search and download Sentinel-1 imagery.

Installation

pip install sentinelsat

Usage

Sentinelsat provides a Python Library and a Command Line Interface to search and download Sentinel-1 products.

Command Line Interface

Search

sentinel search [OPTIONS] <user> <password> <geojson>

Search for Sentinel-1 products and, optionally, download all the results. Beyond your scihub user and password, you must pass a geojson file containing the polygon of the area where you want to search for. If you don’t especify the start and end dates, it will search in the last 24 hours.

Options:

-s, --start TEXT

Start date of the query in the format YYYY-MM-DD.

-e, --end TEXT

End date of the query in the format YYYY-MM-DD.

-d, --download

Download all the results of the query.

-p, --path PATH

Set the path where the files will be saved.

Download

sentinel download [OPTIONS] <user> <password> <productid>

Download a Sentinel-1 Product. Just needs you scihub user and password and the id of the product you want to download.

Options:

-p, --path PATH

Set the path where the file will be saved.

Python Library

Connect to the API:

from sentinelsat.sentinel import SentinelAPI
api = SentinelAPI('user', 'password')

If you know the id of the product you want to download, you can download it using:

api.download('079ed72f-b330-4918-afb8-b63854e375a5', path='.')

Search products specifying the coordinates of the area and date interval:

api.query('0 0,1 1,0 1,0 0', '20150531', '20150612')

You can query using date or datetime objects too.If you don’t specify the start and end dates, it will query in the last 24 hours.

api.query('0 0,1 1,0 1,0 0', datetime(2015, 5, 31, 12, 5), date(2015, 6, 12))

Beyond area and date parameters, you can use any search keywords accepted by the SciHub API, example:

api.query('0 0,1 1,0 1,0 0', producttype='SLC')

See the SciHub User Guide for all the Search Keywords.

To download all the results of your query, use:

api.download_all()

License

GPLv3+