-
Notifications
You must be signed in to change notification settings - Fork 20
/
Copy pathSentinel.Download.pyt.xml
136 lines (136 loc) · 55.7 KB
/
Sentinel.Download.pyt.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
<metadata xml:lang="de"><Esri><CreaDate>20161110</CreaDate><CreaTime>12182600</CreaTime><ArcGISFormat>1.0</ArcGISFormat><SyncOnce>TRUE</SyncOnce><ModDate>20180817</ModDate><ModTime>19082600</ModTime><scaleRange><minScale>150000000</minScale><maxScale>5000</maxScale></scaleRange><ArcGISProfile>ItemDescription</ArcGISProfile></Esri><tool name="Download" displayname="Download Marked packages" toolboxalias="" xmlns=""><arcToolboxHelpPath>c:\program files (x86)\arcgis\desktop10.6\Help\gp</arcToolboxHelpPath><parameters><param name="DHUSUSR" displayname="DHuS user name" type="Required" direction="Input" datatype="String" expression="DHUSUSR"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>Your user name, as registered at the selected data hub (Open Access Hub, or CODE-DE).</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="DHUSPWD" displayname="DHuS password" type="Required" direction="Input" datatype="String Hidden" expression="DHUSPWD"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>Your password, as registered at the selected data hub.</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="DHUSALT" displayname="DHuS alternative site" type="Optional" direction="Input" datatype="String" expression="{CODE-DE}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>If not specified (blank entry), ESA’s Open Access Hub will be used implicitly</SPAN><SPAN>.</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="PRODCAT" displayname="Product catalog where Marked rows denote download" type="Required" direction="Input" datatype="Raster Catalog" expression="PRODCAT"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>The local product catalog containing search results that have the Marked attribute set (as per preparatory editing of Marked attribute values, see Search tool usage). Designated downloads are prioritized by Marked's value magnitude, where 0 or Null means "no download at all", and the highest Marked value means "download first" (ORDER BY Marked DESC).</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="RASTERDIR" displayname="Directory to store downloads" type="Required" direction="Input" datatype="Folder" expression="RASTERDIR"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>Due to a Windows limitation regarding the total length of an absolute path, the collective directory prefix must not be longer than 11 characters (not longer than C:\abcdefgh). Even then it may happen that a certain package content file cannot be extracted to its original relative path – in such a case it will be omitted from extraction and a respective warning is shown.</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="OPMODE" displayname="Operation mode" type="Optional" direction="Input" datatype="String" expression="{Image selection (bare raster) | Cart-only (no raster data) | Full product (cart in parallel)}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>In terms of the Size of each Marked product, make sure that there is enough free disk space for storing the respective raster data.</SPAN></P><P><SPAN>Except for the "Image selection" mode, a tiny Cart file (XML format) containing the download URLs of Marked products will always be generated (regardless of the Operation mode). It can be used as input for a highly specialized download utility such as aria2 (</SPAN><A href="https://aria2.github.io"><SPAN>https://aria2.github.io</SPAN></A><SPAN>).</SPAN></P><P><SPAN>📓 Note: With the "Image selection" mode, only the bare raster images are downloaded. This might be useful in cases in which any corresponding product metadata files are not needed and just a few of the product image files are sufficient.</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="UNZIP" displayname="Unzip .zip after download" type="Optional" direction="Input" datatype="Boolean" expression="{UNZIP}"><dialogReference><DIV STYLE="text-align:Left;"><P><SPAN>Make sure to have enough free disk space for unzipping – each product intermediately needs about double its .zip file Size. Upon unzip success, the respective .zip file is deleted. Upon unzip failure or any warning, it remains on disk.</SPAN></P></DIV></dialogReference></param><param name="CLDMSK" displayname="Create Cloud mask layer (according to threshold)" type="Optional" direction="Input" datatype="Boolean" expression="{CLDMSK}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>🔑 License: "Customize" ▸ "Extensions..." ▸ "☑ Spatial Analyst"</SPAN></P><P><SPAN>Reduces the respective L2A cloud probability image to an own binary image (by means of a raster function chain) that highlights those areas where the specified cloud probability is reached/exceeded. Might be useful in assessing the effect of different mask thresholds (see threshold slider below, parameter CLDTHR).</SPAN></P><P><SPAN>⛯ Tip 1: To change the mask color of an existing mask layer, expand the mask layer (within Table Of Contents, TOC), identify the color indicator (box symbol left to its value label), single-click on it (opens the Color Selector), and change the color to your liking. The Symbology tab from its Layer Properties dialog box doesn't help (for this kind of raster layer).</SPAN></P><P><SPAN>⛯ Tip 2: To retroactively change the threshold value of an existing mask layer, edit the function chain as follows:</SPAN></P><OL><LI><P><SPAN>From the context menu (right-click) on the respective mask layer (within TOC), choose Properties...</SPAN></P></LI><LI><P><SPAN>When prompted to "Build Raster Attribute Table", choose No (important: do not choose Yes).</SPAN></P></LI><LI><P><SPAN>From the Layer Properties dialog box, go to the Functions tab.</SPAN></P></LI><LI><P><SPAN>From the Function Chain, identify and double-click the Local Function (opens its Raster Function Properties dialog box).</SPAN></P></LI><LI><P><SPAN>From the Raster Function Properties dialog box, go to the Local tab, and select the second item from the Input Rasters list (the item that shows the current threshold value as a scalar item).</SPAN></P></LI><LI><P><SPAN>A single click on this selected scalar item makes it editable. Now change the scalar to your liking (value must be between 1 and 100).</SPAN></P></LI></OL></DIV></DIV></DIV></dialogReference></param><param name="CLDFLT" displayname="Apply Cloud filter to selected filterable* indices (according to threshold)" type="Optional" direction="Input" datatype="Boolean" expression="{CLDFLT}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>🔑 License: "Customize" ▸ "Extensions..." ▸ "☑ Spatial Analyst"</SPAN></P><P><SPAN>* From the list of available indices (see respective parameters below), each index whose name ends with an asterisk "*" is filterable.</SPAN></P><P><SPAN>Filter rationale: Occasionally an index misleadingly indicates water at bright locations where no water is actually present (e.g. bright rooftops, or bright fields), and where the respective local L2A cloud probability coincidentally has a likewise misleading high value. This filter enables one to reduce the amount of false positives by masking out index pixels where the cloud probability reaches/exceeds the specified threshold (see threshold slider below, parameter CLDTHR).</SPAN></P><P><SPAN>📓 Note: The outlined filter functionality introduces additional raster functions into the function chain. In order to keep the computational load reasonable, use this filter option with care.</SPAN></P><P><SPAN>⛯ Tip 1: To retroactively remove the entire filter from an existing index layer, modify the function chain as follows:</SPAN></P><OL><LI><P><SPAN>From the Layer Properties dialog box of the respective index layer, go to the Functions tab.</SPAN></P></LI><LI><P><SPAN>From the Function Chain, identify and right-click the topmost Local Function (opens its context menu).</SPAN></P></LI><LI><P><SPAN>From this Local Function's context menu, choose Remove (prompts to Resolve Dataset).</SPAN></P></LI><LI><P><SPAN>From the Resolve Dataset dialog box, switch the Datasets input to &lt;Resample Function.OutputRaster&gt;, and click OK.</SPAN></P></LI></OL><P><SPAN>⛯ Tip 2: To retroactively change the filter threshold value, edit the function chain as follows:</SPAN></P><OL><LI><P><SPAN>From the Layer Properties dialog box of the respective index layer, go to the Functions tab.</SPAN></P></LI><LI><P><SPAN>From the Function Chain, identify and double-click the Local Function closest to the "CLD" raster dataset (opens the Raster Function Properties dialog).</SPAN></P></LI><LI><P><SPAN>From the Raster Function Properties dialog box, go to the Local tab, and select the second item from the Input Rasters list (the item that shows the current threshold value as a scalar item).</SPAN></P></LI><LI><P><SPAN>A single click on this selected scalar item makes it editable. Now change the scalar to your liking (value must be between 1 and 100).</SPAN></P></LI></OL></DIV></DIV></DIV></dialogReference></param><param name="CLDTHR" displayname="Cloud threshold (probability percentage)" type="Optional" direction="Input" datatype="Long" expression="{CLDTHR}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>Used for creating a Cloud mask, as well as for adding a Cloud filter to selected filterable* indices (see the previous two options).</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="SNWMSK" displayname="Create Snow/Ice mask layer (according to threshold)" type="Optional" direction="Input" datatype="Boolean" expression="{SNWMSK}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><P><SPAN>Analogous to the CLDMSK parameter (see above), but with respect to the snow/ice probability image (instead of the cloud probability image).</SPAN></P></DIV></DIV></dialogReference></param><param name="SNWFLT" displayname="Apply Snow/Ice filter to selected filterable* indices (according to threshold)" type="Optional" direction="Input" datatype="Boolean" expression="{SNWFLT}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><P><SPAN>Analogous to the CLDFLT parameter (see above), but with respect to the snow/ice probability image (instead of the cloud probability image).</SPAN></P></DIV></DIV></dialogReference></param><param name="SNWTHR" displayname="Snow/Ice threshold (probability percentage)" type="Optional" direction="Input" datatype="Long" expression="{SNWTHR}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><P><SPAN>Used for creating a Snow/Ice mask, as well as for adding a Snow/Ice filter to selected filterable* indices (see the previous two options).</SPAN></P></DIV></DIV></dialogReference></param><param name="NDWI" displayname="NDWI(McFeeters)*" type="Optional" direction="Input" datatype="Boolean" expression="{NDWI}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">N</SPAN><SPAN>ormalized </SPAN><SPAN STYLE="font-weight:bold;">D</SPAN><SPAN>ifference </SPAN><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex</SPAN></P><P><SPAN>McFeeters S.K. (1996)</SPAN></P><P><SPAN>[not to be confused with NDWI(Gao)]</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>(ρ₃ - ρ₈) / (ρ₃ + ρ₈) = θ</SPAN></P><P><SPAN>(typically θ=0)</SPAN></P><P><SPAN>⇔</SPAN></P><P><SPAN>(1-θ)⋅ρ₃ - (1+θ)⋅ρ₈ = 0</SPAN></P><P><SPAN>(hyperplane that passes through the feature space origin)</SPAN></P><P><SPAN>⛯ General Tip (also applies to other indices): Try out different thresholds (θ value) to find the most appropriate one with respect to the scene's specific circumstances. All indices are more or less sensitive to the variability of certain conditions like seasonal changes (notably shadow), water turbidity, content of phytoplankton, and so on.</SPAN></P><P><SPAN>General click path to change the threshold (or other coefficients of the index Expression):</SPAN></P><OL><LI><P><SPAN>From the Layer Properties dialog box of the respective index layer, go to the Functions tab.</SPAN></P></LI><LI><P><SPAN>From the Function Chain, identify and double-click the topmost Band Arithmetic Function (opens its Raster Function Properties dialog).</SPAN></P></LI><LI><P><SPAN>From the Raster Function Properties dialog box, go to the Band Arithmetic tab, and modify the Expression to your liking.</SPAN></P></LI></OL><P><SPAN>📓 General Notes (also apply to other indices):</SPAN></P><UL><LI><P><SPAN>If you need a decimal within the Expression, you can express it by an integer fraction (for example, use "12/100" instead of "0.12" or "0,12"). This way, the expression becomes independent of the locale. Otherwise, you would have to use your locale's specific decimal separator character.</SPAN></P></LI><LI><P><SPAN>Availability of indices requires ArcGIS version ≥10.5, since the Expression parser of the Band Arithmetic Function is too error prone (notably regarding a constant term) in lower ArcGIS versions.</SPAN></P></LI></UL></DIV></DIV></DIV></dialogReference></param><param name="MNDWI" displayname="MNDWI*" type="Optional" direction="Input" datatype="Boolean" expression="{MNDWI}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">M</SPAN><SPAN>odified </SPAN><SPAN STYLE="font-weight:bold;">N</SPAN><SPAN>ormalised </SPAN><SPAN STYLE="font-weight:bold;">D</SPAN><SPAN>ifference </SPAN><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex</SPAN></P><P><SPAN>Xu H.Q. (2005)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>(ρ₃ - ρ₁₁) / (ρ₃ + ρ₁₁) = θ</SPAN></P><P><SPAN>(typically θ=0)</SPAN></P><P><SPAN>⇔</SPAN></P><P><SPAN>(1-θ)⋅ρ₃ - (1+θ)⋅ρ₁₁ = 0</SPAN></P><P><SPAN>(hyperplane that passes through the feature space origin)</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="nNDVI" displayname="-NDVI*" type="Optional" direction="Input" datatype="Boolean" expression="{nNDVI}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>(negative) </SPAN><SPAN STYLE="font-weight:bold;">N</SPAN><SPAN>ormalized </SPAN><SPAN STYLE="font-weight:bold;">D</SPAN><SPAN>ifference </SPAN><SPAN STYLE="font-weight:bold;">V</SPAN><SPAN>egetation </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex</SPAN></P><P><SPAN>Rouse J.W., Haas R.H., Schell J.A., Deering, D.W. (1973)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>(ρ₄ - ρ₈) / (ρ₄ + ρ₈) = θ</SPAN></P><P><SPAN>(typically θ=0)</SPAN></P><P><SPAN>⇔</SPAN></P><P><SPAN>(1-θ)⋅ρ₄ - (1+θ)⋅ρ₈ = 0</SPAN></P><P><SPAN>(hyperplane that passes through the feature space origin)</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="nNDVI_GREEN" displayname="-NDVI-GREEN*" type="Optional" direction="Input" datatype="Boolean" expression="{nNDVI_GREEN}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>(negative) </SPAN><SPAN STYLE="font-weight:bold;">N</SPAN><SPAN>ormalized </SPAN><SPAN STYLE="font-weight:bold;">D</SPAN><SPAN>ifference </SPAN><SPAN STYLE="font-weight:bold;">V</SPAN><SPAN>egetation </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex - </SPAN><SPAN STYLE="font-weight:bold;">Green</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>ρ₃⋅(ρ₄ - ρ₈) / (ρ₄ + ρ₈) = θ</SPAN></P><P><SPAN>(typically θ=0)</SPAN></P><P><SPAN>⇔</SPAN></P><P><SPAN>(ρ₃-θ)⋅ρ₄ - (ρ₃+θ)⋅ρ₈ = 0</SPAN></P><P><SPAN>(non-planar hypersurface that passes through the feature space origin)</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="SWI" displayname="SWI" type="Optional" direction="Input" datatype="Boolean" expression="{SWI}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">S</SPAN><SPAN>uperfine </SPAN><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex</SPAN></P><P><SPAN>Sharma R.C., Tateishi R., Hara K., Nguyen L.V. (2015)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>(S - 7⋅ρ₈) / (S + 7⋅ρ₈) = θ</SPAN></P><P><SPAN>(typically θ=0)</SPAN></P><P><SPAN>where S is the saturation component of the HSV representation (as converted from RGB composite)</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="WRI" displayname="WRI*" type="Optional" direction="Input" datatype="Boolean" expression="{WRI}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">R</SPAN><SPAN>atio </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex</SPAN></P><P><SPAN>Shen L., Li C.C. (2010)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>(ρ₃ + ρ₄) / (ρ₈ + ρ₁₁) = θ</SPAN></P><P><SPAN>(typically θ=1)</SPAN></P><P><SPAN>⇔</SPAN></P><P><SPAN>ρ₃ + ρ₄ - θ⋅(ρ₈ + ρ₁₁) = 0</SPAN></P><P><SPAN>(hyperplane that passes through the feature space origin)</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="NWIgreen" displayname="NWI(green)*" type="Optional" direction="Input" datatype="Boolean" expression="{NWIgreen}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><P><SPAN STYLE="font-weight:bold;">N</SPAN><SPAN>ew </SPAN><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex</SPAN></P><P><SPAN>Ding F. (2009)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>(ρ₃ - (ρ₈+ρ₁₁+ρ₁₂)) / (ρ₃ + (ρ₈+ρ₁₁+ρ₁₂)) = θ</SPAN></P><P><SPAN>(typically θ=0)</SPAN></P><P><SPAN>⇔</SPAN></P><P><SPAN>(1-θ)⋅ρ₃ - (1+θ)⋅(ρ₈+ρ₁₁+ρ₁₂) = 0</SPAN></P><P><SPAN>(hyperplane that passes through the feature space origin)</SPAN></P></DIV></DIV></dialogReference></param><param name="NWIblue" displayname="NWI(blue)*" type="Optional" direction="Input" datatype="Boolean" expression="{NWIblue}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><P><SPAN STYLE="font-weight:bold;">N</SPAN><SPAN>ew </SPAN><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex</SPAN></P><P><SPAN>Yang H.B., Wang Z.M., Zhao H.L., Guo Y. (2011)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>(ρ₂ - (ρ₈+ρ₁₁+ρ₁₂)) / (ρ₂ + (ρ₈+ρ₁₁+ρ₁₂)) = θ</SPAN></P><P><SPAN>(typically θ=0)</SPAN></P><P><SPAN>⇔</SPAN></P><P><SPAN>(1-θ)⋅ρ₂ - (1+θ)⋅(ρ₈+ρ₁₁+ρ₁₂) = 0</SPAN></P><P><SPAN>(hyperplane that passes through the feature space origin)</SPAN></P></DIV></DIV></dialogReference></param><param name="MBWI" displayname="MBWI" type="Optional" direction="Input" datatype="Boolean" expression="{MBWI}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">M</SPAN><SPAN>ulti-</SPAN><SPAN STYLE="font-weight:bold;">B</SPAN><SPAN>and </SPAN><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex</SPAN></P><P><SPAN>Wang X.B., Xie S.P., Du J.K. (2018)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>2⋅ρ₃ - ρ₄ - ρ₈ - ρ₁₁ - ρ₁₂ = θ</SPAN></P><P><SPAN>(typically θ=0; hyperplane, with distance to the feature space origin if θ≠0)</SPAN></P><P><SPAN>⛯ Tip: Adjust the threshold according to the shadow length. For example, in the case of a winter scene with significant shadow, a value around θ=-5/100 might be reasonable to limit the amount of false positives. In the case of a summer scene with minor shadow, the threshold can be set to a lower value around θ=-15/100. This minimizes the loss of details, i.e. minimizes the amount of false negatives.</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="WI2015" displayname="WI2015*" type="Optional" direction="Input" datatype="Boolean" expression="{WI2015}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex </SPAN><SPAN STYLE="font-weight:bold;">2015</SPAN></P><P><SPAN>Fisher A., Flood N., Danaher T. (2016)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>1.7204 + 171⋅ρ₃ + 3⋅ρ₄ - 70⋅ρ₈ - 45⋅ρ₁₁ - 71⋅ρ₁₂ = 0</SPAN></P><P><SPAN>(hyperplane with distance to the feature space origin)</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="AWEInsh" displayname="AWEInsh*" type="Optional" direction="Input" datatype="Boolean" expression="{AWEInsh}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">A</SPAN><SPAN>utomated </SPAN><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">E</SPAN><SPAN>xtraction </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex (</SPAN><SPAN STYLE="font-weight:bold;">n</SPAN><SPAN>on-</SPAN><SPAN STYLE="font-weight:bold;">sh</SPAN><SPAN>adow scene)</SPAN></P><P><SPAN>Feyisa G.L., Meilby H., Fensholt R., Proud S.R. (2014)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>4⋅(ρ₃ - ρ₁₁) - (0.25⋅ρ₈ + 2.75⋅ρ₁₂) = 0</SPAN></P><P><SPAN>(hyperplane that passes through the feature space origin)</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="AWEIsh" displayname="AWEIsh*" type="Optional" direction="Input" datatype="Boolean" expression="{AWEIsh}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">A</SPAN><SPAN>utomated </SPAN><SPAN STYLE="font-weight:bold;">W</SPAN><SPAN>ater </SPAN><SPAN STYLE="font-weight:bold;">E</SPAN><SPAN>xtraction </SPAN><SPAN STYLE="font-weight:bold;">I</SPAN><SPAN>ndex (scene with </SPAN><SPAN STYLE="font-weight:bold;">sh</SPAN><SPAN>adow)</SPAN></P><P><SPAN>Feyisa G.L., Meilby H., Fensholt R., Proud S.R. (2014)</SPAN></P><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>ρ₂ + 2.5⋅ρ₃ - 1.5⋅(ρ₈ + ρ₁₁) - 0.25⋅ρ₁₂ = 0</SPAN></P><P><SPAN>(hyperplane that passes through the feature space origin)</SPAN></P></DIV></DIV></DIV></dialogReference></param><param name="SBM2m3_6p2m8p6m11p6m12p2" displayname="SBM(2•3—6²•8⁶•11⁶•12²)" type="Optional" direction="Input" datatype="Boolean" expression="{SBM2m3_6p2m8p6m11p6m12p2}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN STYLE="font-weight:bold;">S</SPAN><SPAN>imple </SPAN><SPAN STYLE="font-weight:bold;">B</SPAN><SPAN>and </SPAN><SPAN STYLE="font-weight:bold;">M</SPAN><SPAN>ultiplication (variant's working title herein: </SPAN><SPAN STYLE="font-style:italic;">Pine</SPAN><SPAN>)</SPAN></P><P><SPAN>(Experimental index by the author, 2018)</SPAN></P><P><SPAN>General notation: SBM(⋯) = C⋅Πρᵢ↑xᵢ (C=const)</SPAN></P><P><SPAN>Notation convention of "⋯" (that identifies the respective variant):</SPAN></P><UL><LI><P><SPAN>The letter "ρ" of each band's reflectance identifier is left out, i.e. only the respective band number is noted (e.g. "ρ₈" is abbreviated to "8").</SPAN></P></LI><LI><P><SPAN>Factors that carry a negative exponent are grouped to the right side of the fraction line symbol "—", whereupon the respective negative exponent sign becomes inverted (cp. ρ⁻²/1 = 1/ρ²).</SPAN></P></LI></UL><P><SPAN>Separatrix manifold:</SPAN></P><P><SPAN>SBM(⋯) - 1 = 0</SPAN></P><P><SPAN>(non-planar hypersurface that passes through the feature space origin)</SPAN></P><P><SPAN>⛯ Tip: Adjust the constant C according to the shadow length. The aim is to balance the multiplier in such a way that a reasonable trade-off between minimizing the amount of false positives (at higher C values) and minimizing the amount of false negatives (at lower C values) is reached:</SPAN></P><OL><LI><P><SPAN>From the Layer Properties dialog box of the respective index layer, go to the Functions tab.</SPAN></P></LI><LI><P><SPAN>From the Function Chain, identify and double-click the topmost Band Arithmetic Function (opens its Raster Function Properties dialog box).</SPAN></P></LI><LI><P><SPAN>From the Raster Function Properties dialog box, go to the Band Arithmetic tab, and vary the multiplier (placed at the beginning of the Expression), typically by powers of ten. For example, if the initial value reads 50000, try 5000 or 500 (or even less) in the case of a winter scene (with significant shadow), whereas higher values like 500000 or 5000000 (or even higher) might fit better in the case of a summer scene (with minor shadow).</SPAN></P></LI></OL><P><SPAN>⛯ Additional tips:</SPAN></P><UL><LI><P><SPAN>Incorporating a 10m band (e.g. ρ₈) as multiplier of a resampled 20m band should improve sharpness (cp. multiplicative sharpening).</SPAN></P></LI><LI><P><SPAN>A higher exponent might emphasize the respective band's significance (note: a change of any exponent value requires the constant C to be readjusted accordingly).</SPAN></P></LI></UL></DIV></DIV></DIV></dialogReference></param><param name="B01" displayname="B01: Coastal aerosol, 443nm(20nm), 60m" type="Optional" direction="Input" datatype="Boolean" expression="{B01}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>For each of the 13 images whose name begins with a capital B, the following applies:</SPAN></P><UL><LI><P><SPAN>Band name: Capital B followed by the band number, then</SPAN></P></LI><LI><P><SPAN>a short descriptive label, then</SPAN></P></LI><LI><P><SPAN>the nominal central wavelength (in nanometer) of the band's instrument spectral response (followed by the bandwidth, in nanometer), then</SPAN></P></LI><LI><P><SPAN>the spatial resolution (in meter, pixel size on the ground).</SPAN></P></LI><LI><P><SPAN>Single band image, radiometric resolution is 12 bit (stored as 16 bit unsigned integer).</SPAN></P></LI></UL><P><A href="https://sentinels.copernicus.eu/web/sentinel/missions/sentinel-2/instrument-payload/resolution-and-swath"><SPAN>https://sentinels.copernicus.eu/web/sentinel/missions/sentinel-2/instrument-payload/resolution-and-swath</SPAN></A></P></DIV></DIV></DIV></dialogReference></param><param name="B02" displayname="B02: Blue, 490nm(65nm), 10m" type="Optional" direction="Input" datatype="Boolean" expression="{B02}"/><param name="B03" displayname="B03: Green, 560nm(35nm), 10m" type="Optional" direction="Input" datatype="Boolean" expression="{B03}"/><param name="B04" displayname="B04: Red, 665nm(30nm), 10m" type="Optional" direction="Input" datatype="Boolean" expression="{B04}"/><param name="B05" displayname="B05: Vegetation (red edge), 705nm(15nm), 20m" type="Optional" direction="Input" datatype="Boolean" expression="{B05}"/><param name="B06" displayname="B06: Vegetation (red edge), 740nm(15nm), 20m" type="Optional" direction="Input" datatype="Boolean" expression="{B06}"/><param name="B07" displayname="B07: Vegetation (red edge), 783nm(20nm), 20m" type="Optional" direction="Input" datatype="Boolean" expression="{B07}"/><param name="B08" displayname="B08: NIR (broad), 842nm(115nm), 10m" type="Optional" direction="Input" datatype="Boolean" expression="{B08}"/><param name="B8A" displayname="B8A: Vegetation (red edge), 865nm(20nm), 20m" type="Optional" direction="Input" datatype="Boolean" expression="{B8A}"/><param name="B09" displayname="B09: Water vapour, 945nm(20nm), 60m" type="Optional" direction="Input" datatype="Boolean" expression="{B09}"/><param name="B10" displayname="B10: (L1C-only) SWIR (cirrus), 1380nm(30nm), 60m" type="Optional" direction="Input" datatype="Boolean" expression="{B10}"/><param name="B11" displayname="B11: SWIR (snow/ice/cloud), 1610nm(90nm), 20m" type="Optional" direction="Input" datatype="Boolean" expression="{B11}"/><param name="B12" displayname="B12: SWIR (snow/ice/cloud), 2190nm(180nm), 20m" type="Optional" direction="Input" datatype="Boolean" expression="{B12}"/><param name="TCI" displayname="TCI: Natural color composite (3•8 bit), 10m" type="Optional" direction="Input" datatype="Boolean" expression="{TCI}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>Termed "True Color Image", full spatial resolution RGB composite (Red=B04,Green=B03,Blue=B02), where each channel's radiometric resolution has been reduced from 12 bit to 8 bit (stored as byte).</SPAN></P><P><SPAN>⛯ Tip: The size of a particular TCI image roughly takes up just half the size of the sum of sizes of the corresponding RGB images (B04.jp2, B03.jp2, B02.jp2).</SPAN></P><P><SPAN>📓 Note: The TCI image is not available for older products that conform to a product specification version less than 14, i.e. products dated before 2016-12-06.</SPAN></P><P><A href="https://scihub.copernicus.eu/news/News00124"><SPAN>https://scihub.copernicus.eu/news/News00124</SPAN></A></P></DIV></DIV></DIV></dialogReference></param><param name="TCI_20m" displayname="TCI_20m" type="Optional" direction="Input" datatype="Boolean" expression="{TCI_20m}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>📓 General Notes:</SPAN></P><UL><LI><P><SPAN>Any image that comes with name suffix "_20m" or "_60m" is also available at a higher ground resolution (see above).</SPAN></P></LI><LI><P><SPAN>Only images with category "TCI", "CLD", "SNW", or "SCL" are added to the collection of displayed output layers.</SPAN></P></LI><LI><P><SPAN>Within each category, only the selected image at highest ground resolution is added to the collection of displayed output layers.</SPAN></P></LI></UL></DIV></DIV></DIV></dialogReference></param><param name="TCI_60m" displayname="TCI_60m" type="Optional" direction="Input" datatype="Boolean" expression="{TCI_60m}"><dialogReference><DIV STYLE="text-align:Left;"><P><SPAN>⛯ Tip: As an alternative to the coarse Search result preview (only 320m ground resolution), this image might be helpful as an improved preview (greater detail, but maintaining a moderate size of few megabytes), in that it helps to decide whether to download a specific product or not.</SPAN></P></DIV></dialogReference></param><param name="CLD" displayname="CLD: Cloud confidence, 20m" type="Optional" direction="Input" datatype="Boolean" expression="{CLD}"><dialogReference><DIV STYLE="text-align:Left;"><P><SPAN>Ranging from 0 for high confidence clear sky to 100 for high confidence cloudy.</SPAN></P></DIV></dialogReference></param><param name="CLD_60m" displayname="CLD_60m" type="Optional" direction="Input" datatype="Boolean" expression="{CLD_60m}"/><param name="SNW" displayname="SNW: Snow/ice confidence, 20m" type="Optional" direction="Input" datatype="Boolean" expression="{SNW}"><dialogReference><DIV STYLE="text-align:Left;"><DIV><P><SPAN>Ranging from 0 for high confidence NO snow/ice to 100 for high confidence snow/ice.</SPAN></P></DIV></DIV></dialogReference></param><param name="SNW_60m" displayname="SNW_60m" type="Optional" direction="Input" datatype="Boolean" expression="{SNW_60m}"/><param name="SCL" displayname="SCL: Scene Classification, 20m" type="Optional" direction="Input" datatype="Boolean" expression="{SCL}"><dialogReference><DIV STYLE="text-align:Left;"><P><SPAN>Unique pixel values (stored as 8-bit integers), along with their respective display color and label (in compliance with L2A Product Definition Document S2-PDGS-MPC-L2A-PDD-V14.2, Issue: 4.6, Date: 2017-06-23):</SPAN></P><OL>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:red"> </SPAN><SPAN> Saturated or defective pixel (red).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:dimgray"> </SPAN><SPAN> Dark features / Shadows (very dark grey).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:saddlebrown"> </SPAN><SPAN> Cloud shadows (dark brown).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:forestgreen"> </SPAN><SPAN> Vegetation (green).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:khaki"> </SPAN><SPAN> Not-vegetated (dark yellow).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:royalblue"> </SPAN><SPAN> Water (dark and bright) (blue).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:darkgray"> </SPAN><SPAN> Unclassified (dark grey).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:lightgray"> </SPAN><SPAN> Cloud medium probability (grey).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:white"> </SPAN><SPAN> Cloud high probability (white).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:lightskyblue"> </SPAN><SPAN> Thin cirrus (very bright blue).</SPAN></P></LI>
<LI><P><SPAN STYLE="border:thin solid gray;background-color:pink"> </SPAN><SPAN> Snow or ice (very bright pink).</SPAN></P></LI>
</OL>
<P><SPAN>⛯ Tip: The click path to change the color of a specific class to full transparency is as follows:</SPAN></P><OL><LI><P><SPAN>From the expanded SCL layer (within Table Of Contents), single-click on the color indicator of the respective class (opens the Color Selector).</SPAN></P></LI><LI><P><SPAN>From the Color Selector dialog box, go to the Properties tab.</SPAN></P></LI><LI><P><SPAN>Within the Properties tab, from the Other Options section, tick "☑ Color is Null".</SPAN></P></LI></OL>
</DIV></dialogReference></param><param name="SCL_60m" displayname="SCL_60m" type="Optional" direction="Input" datatype="Boolean" expression="{SCL_60m}"/><param name="AOT" displayname="AOT: Aerosol Optical Thickness (at 550nm), 10m" type="Optional" direction="Input" datatype="Boolean" expression="{AOT}"/><param name="AOT_20m" displayname="AOT_20m" type="Optional" direction="Input" datatype="Boolean" expression="{AOT_20m}"/><param name="AOT_60m" displayname="AOT_60m" type="Optional" direction="Input" datatype="Boolean" expression="{AOT_60m}"/><param name="WVP" displayname="WVP: Water Vapour, 10m" type="Optional" direction="Input" datatype="Boolean" expression="{WVP}"/><param name="WVP_20m" displayname="WVP_20m" type="Optional" direction="Input" datatype="Boolean" expression="{WVP_20m}"/><param name="WVP_60m" displayname="WVP_60m" type="Optional" direction="Input" datatype="Boolean" expression="{WVP_60m}"/><param name="B02_20m" displayname="B02_20m" type="Optional" direction="Input" datatype="Boolean" expression="{B02_20m}"/><param name="B02_60m" displayname="B02_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B02_60m}"/><param name="B03_20m" displayname="B03_20m" type="Optional" direction="Input" datatype="Boolean" expression="{B03_20m}"/><param name="B03_60m" displayname="B03_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B03_60m}"/><param name="B04_20m" displayname="B04_20m" type="Optional" direction="Input" datatype="Boolean" expression="{B04_20m}"/><param name="B04_60m" displayname="B04_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B04_60m}"/><param name="B05_60m" displayname="B05_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B05_60m}"/><param name="B06_60m" displayname="B06_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B06_60m}"/><param name="B07_60m" displayname="B07_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B07_60m}"/><param name="B8A_60m" displayname="B8A_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B8A_60m}"/><param name="B11_60m" displayname="B11_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B11_60m}"/><param name="B12_60m" displayname="B12_60m" type="Optional" direction="Input" datatype="Boolean" expression="{B12_60m}"/></parameters><summary><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>For each Marked entry in the local product catalog, download the respective raster data package.</SPAN></P></DIV></DIV></DIV></summary><usage><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>Batch download those products where the Marked attribute has a value greater than 0 (see Search tool usage for details). Each download of a product package (.zip file) has an additional file extension ".partial" until the respective download action finishes as expected.</SPAN></P><P><SPAN>Output: Depending on the respective product's processing level, a collection of</SPAN></P><UL><LI><P><SPAN>Level-1C raster datasets, ArcGIS' </SPAN><A href="http://desktop.arcgis.com/en/arcmap/latest/manage-data/raster-and-images/satellite-sensor-raster-types.htm"><SPAN>predefined</SPAN></A><SPAN /><SPAN> Sentinel-2 L1C product type, processing template "Multispectral (10m)",</SPAN></P></LI><LI><P><SPAN>Level-2A group layers, each composed of: cloud &amp; snow/ice probability image, scene classification, natural color composite (plus processing template "BOA reflectance-10m" from ArcGIS' </SPAN><A href="http://desktop.arcgis.com/en/arcmap/latest/manage-data/raster-and-images/satellite-sensor-raster-types.htm"><SPAN>predefined</SPAN></A><SPAN> Sentinel-2 L2A product type, if available*), optional cloud &amp; snow/ice mask, and various optional water indices (accompanied by the Near Infrared image for the purpose of visual comparison, once any index has been added).</SPAN></P><P><SPAN>[*available with: ArcGIS version 10.6, but only for products with processing baseline number not higher than 02.06, i.e. products dated before 2018-03-26]</SPAN></P></LI></UL><P><SPAN>For demonstration purposes, any histogram-based symbology is omitted.</SPAN></P><P><SPAN>📓 Note: As a follow-up to completed downloads, consider clearing their respective Marked values afterwards, notably when downloaded packages may possibly be (re)moved later on (by user) but are not intended to be downloaded once again! However, if a package is Marked for download, but already exists locally, its download action will be skipped. Despite this, the corresponding output layers will always be generated (irrespective of whether a specific product already exists locally). This might be useful when you simply want to recreate those layers incl. appropriate symbology.</SPAN></P><P><SPAN>⛯ Tip: An unexpected termination of a download action (as indicated by the remaining ".partial" extension) may be continued by using a specialized download utility.</SPAN></P><P><SPAN>For example, aria2 offers a "continue" option (-c). When using this utility, please don't forget to strip off the ".partial" extension in advance (rename file). In combination with a suitable Cart file (see below, parameter OPMODE), an exemplary aria2 command line looks like:</SPAN></P><P><SPAN>aria2c -c --http-user=%DHUSUSR% --http-passwd=%DHUSPWD% -M Cart.2016-11-10_09.08.07.xml</SPAN></P></DIV></DIV></DIV></usage></tool><dataIdInfo><idCitation><resTitle>Download Marked packages</resTitle></idCitation><idAbs><DIV STYLE="text-align:Left;"><DIV><DIV><P><SPAN>For each Marked entry in the local product catalog, download the respective raster data package.</SPAN></P></DIV></DIV></DIV></idAbs><searchKeys><keyword>Sentinel</keyword><keyword>Download</keyword><keyword>L1C</keyword><keyword>L2A</keyword><keyword>BOA</keyword><keyword>Classification</keyword><keyword>Index</keyword><keyword>DHuS</keyword><keyword>SciHub</keyword><keyword>Open Access Hub</keyword><keyword>CODE-DE</keyword><keyword>Copernicus</keyword></searchKeys></dataIdInfo><distInfo><distributor><distorFormat><formatName>ArcToolbox Tool</formatName></distorFormat></distributor></distInfo><mdHrLv><ScopeCd value="005"/></mdHrLv><Binary><Enclosure rel="side-panel-help"><Data EsriPropertyType="Image" OriginalFileName="thumbnail.jpg">/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsK
CwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQU
FBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBT/wAARCABBALADASIA
AhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQA
AAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3
ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWm
p6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEA
AwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSEx
BhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElK
U1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3
uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD708M+
GdHuPDelSy6VYySPaRMzvbISxKAkk45NcT8dviZ4H/Z98L6fr2v+F5dRtL2/WwSPSbCCSRGMUkpk
YOyDYqQuSQSeOAar6Z8ZPEel6baWcHwU+IuqwW8KQx39jBphguVVQBLGXvlbYwG4blU4IyAeK8z/
AGgNS8ZfGSx8HWEXwJ+IiWOm68moagl1FpimW1+zXELpHtvjlz54wDtGAeRxRKTjZpX1X3XV/wAC
YKDvzdn99tPxPTrb4tfD24+M2r/Df+whDqWlaU2rXWqz2VumnpGohZ08wtu3qlzC5ym0Bvvdq2of
iF8ILnw2PEMPiXwTLoBuGtBqqX9mbXzlQyNF5obbvCAsVznAJ6V8VWfgP47Na3+q3Pwg8T/8JfqH
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</Data></Enclosure></Binary></metadata>