GRASS GIS manual: r.sentinel.download

NAME

r.sentinel.download - Downloads Sentinel data from Copernicus Open Access Hub using sentinelsat library.

KEYWORDS

SYNOPSIS

r.sentinel.download

r.sentinel.download --help

r.sentinel.download [-l] [map=name] [clouds=integer] [producttype=string] [limit=integer] [start=string] [end=string] user=string password=string [output=name] [footprints=name] [sort=string[,string,...]] [order=string] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-l: List filtered products and exist
--overwrite: Allow output files to overwrite existing files
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

map=name: Name of input vector map to define Area of Interest (AOI); If not given than current computational extent is used
clouds=integer: Maximum cloud cover percentage for Sentinel scene; Default: 30
producttype=string: Sentinel product type to filter; Options: SLC, GRD, OCN, S2MSI1C, S2MSI2Ap; Default: S2MSI1C
limit=integer: Limit number of Sentinel products
start=string: Start date ('YYYY-MM-DD')
end=string: End date ('YYYY-MM-DD')
user=string [required]: Username for connecting SciHub
password=string [required]: Password for connecting SciHub
output=name: Name for output directory where to store downloaded Sentinel data
footprints=name: Name for output vector map with footprints
sort=string[,string,...]: Sort by values in given order; Options: ingestiondate, cloudcoverpercentage, footprint; Default: cloudcoverpercentage,ingestiondate,footprint
order=string: Sort order (see sort parameter); Options: asc, desc; Default: asc

NOTES
EXAMPLES
- List filtered products
- Download Sentinel products
REQUIREMENTS
SEE ALSO
AUTHOR

r.sentinel.download allows downloading Sentinel products from Copernicus Open Access Hub.

To connect Copernicus Open Access Hub a user and password are required, see Register new account page for signing up.

NOTES

By default Sentinel products are sorted by cloudcoverpercentage and ingestiondate (see sort option). Only products which footprint intersects current computation region extent are filtered. The extent can be optionally defined also by vector map. Filtered products can be reduced by limit option.

Module searches for products in last 60 days, exact date range can be defined by start and end options.

Sentinel products can be also filtered by producttype or maximum clouds cover percentage.

EXAMPLES

List filtered products

Find S2MSI1C products in last 60 days covering current computation region extent.

r.sentinel.download -l user=myusername password=mypassword

1 Sentinel product(s) found
ae1c33ec-aa33-4303-a525-9e6481709614 2017-12-08T10:23:59Z 18% S2MSI1C

Find all S2MSI2Ap products in 2017.

r.sentinel.download -l user=myusername password=mypassword producttype=S2MSI2Ap start=2017-01-01 end=2017-12-31
    
7 Sentinel product(s) found
e5df8b4f-a4c6-47bd-88f3-e16b7540cc7a 2017-05-27T10:20:31Z  2% S2MSI2Ap
b62afeda-a28d-475c-8220-91e24fc368ff 2017-05-17T10:20:31Z  2% S2MSI2Ap
9a6bc289-98e9-4489-84eb-1aac95aaa056 2017-08-15T10:20:21Z  3% S2MSI2Ap
35c72002-78a0-45f8-b39d-66c2d7b4ad87 2017-10-14T10:20:21Z  6% S2MSI2Ap
c0ae8085-c1bb-4a27-89f2-2138a0866586 2017-07-06T10:20:21Z 12% S2MSI2Ap
433ebfbc-5144-42f8-97dc-b9f4f1eb7b5a 2017-11-03T10:22:01Z 12% S2MSI2Ap
fc56a594-d9d8-4e93-8dec-af3a58b24080 2017-09-04T10:20:21Z 19% S2MSI2Ap

Sort products by ingestiondate, limit cloud coverage to 5% per scene.

r.sentinel.download -l user=myusername password=mypassword producttype=S2MSI2Ap start=2017-01-01 end=2017-12-31 sort=ingestiondate order=desc clouds=5

3 Sentinel product(s) found
9a6bc289-98e9-4489-84eb-1aac95aaa056 2017-08-15T10:20:21Z  3% S2MSI2Ap
b62afeda-a28d-475c-8220-91e24fc368ff 2017-05-17T10:20:31Z  2% S2MSI2Ap
e5df8b4f-a4c6-47bd-88f3-e16b7540cc7a 2017-05-27T10:20:31Z  2% S2MSI2Ap

Create vector map with footprints.

r.sentinel.download -l user=myusername password=mypassword producttype=S2MSI2Ap start=2017-01-01 end=2017-12-31 footprints=ft

Download Sentinel products

Download first (limit=1) found S2MSI2Ap product into data directory.

r.sentinel.download user=myusername password=mypassword producttype=S2MSI2Ap start=2017-01-01 end=2017-12-31 limit=1 output=data

Such downloaded data can be easily imported into GRASS using r.sentinel.import module.

REQUIREMENTS

AUTHOR

Martin Landa, GeoForAll Lab, CTU in Prague, Czech Republic with support of OpenGeoLabs company

SOURCE CODE

Available at: r.sentinel.download source code (history)