[GRASS-SVN] r73918 - grass-addons/grass7/imagery/i.sentinel/i.sentinel.download
svn_grass at osgeo.org
svn_grass at osgeo.org
Sun Jan 6 11:28:21 PST 2019
Author: neteler
Date: 2019-01-06 11:28:21 -0800 (Sun, 06 Jan 2019)
New Revision: 73918
Modified:
grass-addons/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.html
grass-addons/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.py
Log:
i.sentinel.download addon: define S2MSI2A product as default product; all examples rewritten
Modified: grass-addons/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.html
===================================================================
--- grass-addons/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.html 2019-01-06 17:51:07 UTC (rev 73917)
+++ grass-addons/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.html 2019-01-06 19:28:21 UTC (rev 73918)
@@ -17,16 +17,16 @@
<li>Sentinel-2
(optical) <a href="https://sentinel.esa.int/web/sentinel/missions/sentinel-2/data-products">products</a>:
<ul>
+ <li>S2MSI2A: operational Bottom-Of-Atmosphere reflectances in cartographic geometry Level-2A)</li>
+ <li>(S2MSI2Ap: pilot products of Bottom-Of-Atmosphere reflectances in cartographic geometry Level-2A), until March 2018)</li>
<li>S2MSI1C: Top-Of-Atmosphere reflectances in cartographic geometry (Level-1C)</li>
- <li>S2MSI2A: operational Bottom-Of-Atmosphere reflectances in cartographic geometry Level-2A)</li>
- <li>S2MSI2Ap: pilot products of Bottom-Of-Atmosphere reflectances in cartographic geometry Level-2A), until March 2018</li>
</ul>
</li>
</ul>
<p>
-To connect Copernicus Open Access Hub a <em>user</em>
-and <em>password</em> are required,
+To connect to the Copernicus Open Access Hub both a <em>user</em> name
+and <em>password</em> are required;
see <a href="https://scihub.copernicus.eu/dhus/#/self-registration">Register
new account</a> page for signing up.
@@ -43,7 +43,7 @@
<h2>NOTES</h2>
-<p>User credentials can be also defined interactively
+User credentials can be also defined interactively
when <b>settings=-</b> is given. Note that interactive prompt does not
work in GUI.
@@ -71,8 +71,8 @@
Filtered products can be reduced by <b>limit</b> option.
<p>
-Module searches for products in last 60 days, exact date range can be
-defined by <b>start</b> and <b>end</b> options.
+<em>i.sentinel.download</em> searches for products of the last 60 days,
+an exact date range can be defined by <b>start</b> and <b>end</b> options.
<p>
Sentinel products can be also filtered by <b>producttype</b> or
@@ -87,71 +87,94 @@
<h3>List filtered products</h3>
-<p>
-Find S2MSI1C products in last 60 days covering current computation region extent.
+Find all atmospherically corrected Sentinel-2 L2A products (S2MSI2) in 2018 (area in Italy as an example):
<div class="code"><pre>
-i.sentinel.download -l settings=sentinel.txt
+g.region n=42 w=12 s=41 e=13 res=0:01 -p
-1 Sentinel product(s) found
-ae1c33ec-aa33-4303-a525-9e6481709614 2017-12-08T10:23:59Z 18% S2MSI1C
+i.sentinel.download -l settings=.sentinel.txt producttype=S2MSI2A start=2018-01-01 end=2018-12-31
+
+357 Sentinel product(s) found
+379e2896-408d-4642-bc6f-ee941e395c32 2018-04-19T10:10:31Z 0% S2MSI2A
+0e3e361d-e8e0-4e71-a10d-c1faf1640beb 2018-04-19T10:10:31Z 0% S2MSI2A
+72ed25c8-5a36-40a5-97ce-e0b4d6347c7f 2018-04-06T10:00:31Z 0% S2MSI2A
+eee28af8-aaa6-4e59-9902-dd5cbfc08bab 2018-04-06T10:00:31Z 0% S2MSI2A
+e2a9d80d-da35-44bd-ab88-76bad398da41 2018-07-18T10:10:31Z 0% S2MSI2A
+...
</pre></div>
-Find all S2MSI2Ap products in 2017.
+Sort products by <b>ingestiondate</b>, limit cloud coverage to 3% per scene:
<div class="code"><pre>
-i.sentinel.download -l settings=sentinel.txt 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
+g.region n=42 w=12 s=41 e=13 res=0:01 -p
+i.sentinel.download -l settings=.sentinel.txt producttype=S2MSI2A start=2018-01-01 end=2018-12-31 sort=ingestiondate order=desc clouds=3
+
+191 Sentinel product(s) found
+1b0ee27e-c51a-49d9-b2a4-78db128a49f9 2018-12-27T10:04:19Z 0% S2MSI2A
+8da04aa9-5d8b-42bc-abb3-d2c9b61c5ee4 2018-12-27T10:04:19Z 1% S2MSI2A
+e4f324f4-8e98-440c-9141-ae3d24cd1faa 2018-12-27T10:04:19Z 1% S2MSI2A
+be507500-8538-44f0-969c-d6d45a16beea 2018-12-27T10:04:19Z 0% S2MSI2A
+1ab5dd20-4845-4325-bd71-5d0596f4d11d 2018-12-27T10:04:19Z 0% S2MSI2A
+...
</pre></div>
-Sort products by <b>ingestiondate</b>, limit cloud coverage to 5% per scene.
+Create a vector map of <b>footprints</b> of S-2 scenes with <b>clouds</b>
+limited to 3% per scene (note that topological errors will be shown since
+some footprint overlap):
<div class="code"><pre>
-i.sentinel.download -l settings=sentinel.txt producttype=S2MSI2Ap start=2017-01-01 end=2017-12-31 sort=ingestiondate order=desc clouds=5
+g.region n=42 w=12 s=41 e=13 res=0:01 -p
+i.sentinel.download -l settings=sentinel.txt producttype=S2MSI2A start=2018-01-01 end=2018-12-31 clouds=1 footprints=s2_scenes_footprints
-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
+131 Sentinel product(s) found
+Writing footprints into <s2_scenes_footprints>...
+...
+379e2896-408d-4642-bc6f-ee941e395c32 2018-04-19T10:10:31Z 0% S2MSI2A
+0e3e361d-e8e0-4e71-a10d-c1faf1640beb 2018-04-19T10:10:31Z 0% S2MSI2A
+...
</pre></div>
-Create vector map with <b>footprints</b>.
+<p>
+Find Sentinel-2 L1C products (S2MSI1C) of last 60 days (default) covering current computation region extent:
<div class="code"><pre>
-i.sentinel.download -l settings=sentinel.txt producttype=S2MSI2Ap start=2017-01-01 end=2017-12-31 footprints=ft
+g.region n=42 w=12 s=41 e=13 res=0:01 -p
+i.sentinel.download -l settings=sentinel.txt producttype=S2MSI1C sort=ingestiondate
+
+57 Sentinel product(s) found
+c5f6e871-3cd9-471f-a022-712f5e10a43a 2018-11-10T10:12:39Z 15% S2MSI1C
+a83ad139-c420-4433-bd21-f7ed35536e69 2018-11-10T10:12:39Z 14% S2MSI1C
+6a4f093a-3fa7-466e-8ec9-77718d7b8eac 2018-11-12T10:02:41Z 8% S2MSI1C
+9a668bfa-1a7e-4d92-8c51-ed2024415e6a 2018-11-15T10:12:51Z 6% S2MSI1C
+5f3d19a2-eddb-42eb-ab6d-67f0fdd18c58 2018-11-15T10:12:51Z 5% S2MSI1C
+...
</pre></div>
<h3>Download Sentinel products</h3>
-Download first (<b>limit=1</b>) found S2MSI2Ap product into <i>data</i> directory.
+Download first (<b>limit=1</b>) S2MSI2A product found into the <i>data</i> directory:
<div class="code"><pre>
-i.sentinel.download settings=sentinel.txt producttype=S2MSI2Ap start=2017-01-01 end=2017-12-31 limit=1 output=data
+g.region n=42 w=12 s=41 e=13 res=0:01 -p
+i.sentinel.download settings=sentinel.txt producttype=S2MSI2A start=2018-05-01 end=2018-05-31 limit=1 output=s2_L2A_may2018
</pre></div>
-Such downloaded data can be easily imported into GRASS
+The downloaded Sentinel data can subsequently be easily imported into GRASS GIS
using <em><a href="i.sentinel.import.html">i.sentinel.import</a></em>
module.
<h3>Download Sentinel products by UUID</h3>
-<em>i.sentinel.download</em> also allows downloading Sentinel products
-by giving a list of UUID. This operation is performed by <b>uuid</b>
-option. Note this option is mutually exclusive with all of other
+<em>i.sentinel.download</em> also allows downloading of Sentinel products
+by specifying a (list of) UUID. This operation is performed by the <b>uuid</b>
+option. Note that this option is mutually exclusive with all of other
filtering options.
-Example of downloading one Sentinel product:
+<p>
+Example of downloading a single Sentinel product:
<div class="code"><pre>
-i.sentinel.download settings=sentinel.txt uuid=98f00e12-3b62-4c54-8554-c4439bb1ebef output=data
+i.sentinel.download settings=sentinel.txt uuid=6a10da0f-7777-4818-bc2c-4680e82297ac output=s2_data
<pre></div>
<h2>REQUIREMENTS</h2>
Modified: grass-addons/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.py
===================================================================
--- grass-addons/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.py 2019-01-06 17:51:07 UTC (rev 73917)
+++ grass-addons/grass7/imagery/i.sentinel/i.sentinel.download/i.sentinel.download.py 2019-01-06 19:28:21 UTC (rev 73918)
@@ -67,7 +67,7 @@
#% description: Sentinel product type to filter
#% required: no
#% options: SLC,GRD,OCN,S2MSI1C,S2MSI2A,S2MSI2Ap
-#% answer: S2MSI1C
+#% answer: S2MSI2A
#% guisection: Filter
#%end
#%option
More information about the grass-commit
mailing list