From 4a96be07942719a60cde901e5cabefcdc8ab12b3 Mon Sep 17 00:00:00 2001 From: Markus Neteler Date: Tue, 19 Nov 2019 12:17:41 +0100 Subject: [PATCH] i.sentinel.download manual: example download Sentinel products by scene name --- .../i.sentinel.download.html | 41 +++++++++++++++---- 1 file changed, 34 insertions(+), 7 deletions(-) diff --git a/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.html b/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.html index 3bb7f7502c..760d8cc22c 100644 --- a/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.html +++ b/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.html @@ -71,8 +71,9 @@

NOTES

Filtered products can be reduced by limit option.

-i.sentinel.download searches for products of the last 60 days, -an exact date range can be defined by start and end options. +i.sentinel.download limits the default search for products to the last 60 days; +an exact date range can be defined by start and end parameters to search +beyond that.

Sentinel products can be also filtered by producttype or, in case of @@ -92,6 +93,9 @@

NOTES

The output directory is created if not yet available. + +

+The query string sent to ESA can be shown with --verbose.

EXAMPLES

@@ -171,7 +175,8 @@

List filtered products

Find Sentinel-1 products with date range filter and query filter limit to -a specific polarisationmode: +a specific polarisation mode (see +here for query details): 

 i.sentinel.download -l settings=credentials.txt producttype=SLC start=2018-01-01 end=2018-12-31 query='polarisationmode=VV'
@@ -189,7 +194,7 @@ 
Download Sentinel products

 
 
 g.region n=42 w=12 s=41 e=13 res=0:01 -p
-i.sentinel.download settings=credentials.txt producttype=S2MSI2A start=2018-05-01 end=2018-05-31 limit=1 output=s2_L2A_may2018
+i.sentinel.download settings=credentials.txt producttype=S2MSI2A start=2018-05-01 end=2018-05-31 limit=1 output=s2_L2A_may2018/
 

 
 The downloaded Sentinel data can subsequently be easily imported into GRASS GIS
@@ -200,14 +205,33 @@ 
Download Sentinel products by UUID

 
 i.sentinel.download also allows downloading of Sentinel products
 by specifying a (list of) UUID. This operation is performed by the uuid
-option. Note that this option is mutually exclusive with all of other
+option. Note that this option is mutually exclusive with all other
 filtering options.
 
 

-Example of downloading a single Sentinel product:
+Example of downloading a single Sentinel product by UUID:
 
 
-i.sentinel.download settings=credentials.txt uuid=6a10da0f-7777-4818-bc2c-4680e82297ac output=s2_data
+i.sentinel.download settings=credentials.txt uuid=6a10da0f-7777-4818-bc2c-4680e82297ac output=s2_data/
+

+
+
Download Sentinel products by scene name

+
+i.sentinel.download also allows downloading of Sentinel products
+by specifying a (list of) scene names (name of the SAFE.zip file). This operation is
+performed by the query option. Note that this option is mutually exclusive with
+all other filtering options.
+
+

+Example of downloading a single Sentinel product by scene names (name of the SAFE.zip file).
+Importantly, the producttype, start and end date need to be specified to
+override the default settings (otherwise no product will be found):
+
+
+# North Carolina sample dataset example
+i.sentinel.download settings=credentials.txt \
+  query='filename=S2A_MSIL1C_20180822T155901_N0206_R097_T17SPV_20180822T212023.SAFE' \
+  producttype=S2MSI1C start=2018-01-01 end=2018-12-31 output=s2_data/
 

 
 
REQUIREMENTS

@@ -232,6 +256,9 @@ 
SEE ALSO

 v.import
 
 
+

+Copernicus Scihub reference: Simple search query
+
 

 See also GRASS
 GIS Workshop in Jena for usage examples.