annotate preprocess_S2.xml @ 0:0271f3623e95 draft

Uploaded
author ecology
date Sun, 08 Jan 2023 22:58:53 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
0271f3623e95 Uploaded
ecology
parents:
diff changeset
1 <tool id="srs_preprocess_s2" name="Preprocess sentinel 2 data" version="@VERSION@" profile="20.01">
0271f3623e95 Uploaded
ecology
parents:
diff changeset
2 <description>read, crop, resample and write it as a raster stack</description>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
3 <macros>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
4 <import>macro.xml</import>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
5 </macros>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
6 <requirements>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
7 <requirement type="package" version="4.2.2">r-base</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
8 <requirement type="package" version="1.0_7">r-sf</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
9 <requirement type="package" version="0.6_1">r-rgeos</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
10 <requirement type="package" version="0.5_5">r-stars</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
11 <requirement type="package" version="1.5.0">r-stringr</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
12 <requirement type="package" version="1.2.3">r-jqr</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
13 <requirement type="package" version="2.1.3">r-protolite</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
14 <requirement type="package" version="1.5.3">r-sen2r</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
15 <requirement type="package" version="1.2.2">r-progress</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
16 <requirement type="package" version="2.0.3">r-gdalutils</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
17 <requirement type="package" version="1.0.4">r-fasterize</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
18 <requirement type="package" version="3.99_0.13">r-xml</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
19 <requirement type="package" version="1.3.3">r-xml2</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
20 <requirement type="package" version="2.2.2">r-zip</requirement>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
21 </requirements>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
22 <command detect_errors="exit_code"><![CDATA[
0271f3623e95 Uploaded
ecology
parents:
diff changeset
23 Rscript
0271f3623e95 Uploaded
ecology
parents:
diff changeset
24 '$__tool_directory__/preprocess_S2.r'
0271f3623e95 Uploaded
ecology
parents:
diff changeset
25 '$input'
0271f3623e95 Uploaded
ecology
parents:
diff changeset
26 '$__tool_directory__/Lib_preprocess_S2.r'
0271f3623e95 Uploaded
ecology
parents:
diff changeset
27 '$source_s2'
0271f3623e95 Uploaded
ecology
parents:
diff changeset
28 '$type_s2'
0271f3623e95 Uploaded
ecology
parents:
diff changeset
29 '$output'
0271f3623e95 Uploaded
ecology
parents:
diff changeset
30 '$output_refl'
0271f3623e95 Uploaded
ecology
parents:
diff changeset
31 '$output_cloud'
0271f3623e95 Uploaded
ecology
parents:
diff changeset
32 ]]>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
33 </command>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
34 <inputs>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
35 <param name="input" type="data" format="zip" multiple="true" label="Input data"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
36 <param name="source_s2" type="select" label="Where does your data come from ?">
0271f3623e95 Uploaded
ecology
parents:
diff changeset
37 <option value="SAFE">From Scihub or Peps</option>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
38 <option value="THEIA">From Theia</option>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
39 </param>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
40 <param name="type_s2" type="select" label="From which satellite are the data ?">
0271f3623e95 Uploaded
ecology
parents:
diff changeset
41 <option value="2A">Sentinel 2A</option>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
42 <option value="2B">Sentinel 2B</option>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
43 </param>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
44 </inputs>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
45 <outputs>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
46 <data name="output" from_work_dir="Mission.csv" format="csv" label="Mission source"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
47 <data name="output_refl" from_work_dir="Refl.zip" format="zip" label="Reflectance"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
48 <data name="output_cloud" from_work_dir="Cloud.zip" format="zip" label="Cloud Mask"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
49 </outputs>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
50 <tests>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
51 <test>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
52 <param name="input" value="S2A_MSIL2A_20200306T015621_N0214_R117_T51JXN_20200306T034744.zip"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
53 <param name="source_s2" value="SAFE"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
54 <param name="type_s2" value="2A"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
55 <output name="output" value="Mission.csv"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
56 <output name="output_refl">
0271f3623e95 Uploaded
ecology
parents:
diff changeset
57 <assert_contents>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
58 <has_size value="12923807" delta="100"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
59 </assert_contents>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
60 </output>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
61 <output name="output_cloud">
0271f3623e95 Uploaded
ecology
parents:
diff changeset
62 <assert_contents>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
63 <has_size value="235912" delta="100"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
64 </assert_contents>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
65 </output>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
66 </test>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
67 </tests>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
68 <help><![CDATA[
0271f3623e95 Uploaded
ecology
parents:
diff changeset
69 ==========================
0271f3623e95 Uploaded
ecology
parents:
diff changeset
70 Preprocess Sentinel 2 data
0271f3623e95 Uploaded
ecology
parents:
diff changeset
71 ==========================
0271f3623e95 Uploaded
ecology
parents:
diff changeset
72
0271f3623e95 Uploaded
ecology
parents:
diff changeset
73
0271f3623e95 Uploaded
ecology
parents:
diff changeset
74 **What it does**
0271f3623e95 Uploaded
ecology
parents:
diff changeset
75
0271f3623e95 Uploaded
ecology
parents:
diff changeset
76 The goal of this tool (using the package preprocS2) is to provide a common framework for the preprocessing of Level-2A Sentinel-2 images (does not work yet for Level 1C).
0271f3623e95 Uploaded
ecology
parents:
diff changeset
77 Sentinel-2 L2A images can be produced or obtained from various data hubs or atmospheric correction methods. PreprocS2 provides a unique function to read, crop, resample the original image directory, and write it as a raster stack.
0271f3623e95 Uploaded
ecology
parents:
diff changeset
78
0271f3623e95 Uploaded
ecology
parents:
diff changeset
79 **Input description**
0271f3623e95 Uploaded
ecology
parents:
diff changeset
80
0271f3623e95 Uploaded
ecology
parents:
diff changeset
81 A zip folder with Sentinel 2 data.
0271f3623e95 Uploaded
ecology
parents:
diff changeset
82 These data can be dowloaded on 3 different platforms:
0271f3623e95 Uploaded
ecology
parents:
diff changeset
83
0271f3623e95 Uploaded
ecology
parents:
diff changeset
84 - Copernicus Open Access Hub, Scihub, which provides complete, free and open access to Sentinel-2 data : https://scihub.copernicus.eu/dhus/#/home
0271f3623e95 Uploaded
ecology
parents:
diff changeset
85
0271f3623e95 Uploaded
ecology
parents:
diff changeset
86 - PEPS, la 'Plateforme d'Exploitation de Produits Sentinel' : https://peps.cnes.fr/rocket/#/search
0271f3623e95 Uploaded
ecology
parents:
diff changeset
87
0271f3623e95 Uploaded
ecology
parents:
diff changeset
88 - Theia : https://theia.cnes.fr/atdistrib/rocket/#/search
0271f3623e95 Uploaded
ecology
parents:
diff changeset
89
0271f3623e95 Uploaded
ecology
parents:
diff changeset
90 For each of those 3 platforms you will need to create an account.
0271f3623e95 Uploaded
ecology
parents:
diff changeset
91
0271f3623e95 Uploaded
ecology
parents:
diff changeset
92 You need to select from where you dowloaded your data in order for the tool to know the format of the folder once it unzips it.
0271f3623e95 Uploaded
ecology
parents:
diff changeset
93
0271f3623e95 Uploaded
ecology
parents:
diff changeset
94 +----------+----------+
0271f3623e95 Uploaded
ecology
parents:
diff changeset
95 | ZIP | Source |
0271f3623e95 Uploaded
ecology
parents:
diff changeset
96 +==========+==========+
0271f3623e95 Uploaded
ecology
parents:
diff changeset
97 |folder.zip|Character |
0271f3623e95 Uploaded
ecology
parents:
diff changeset
98 +----------+----------+
0271f3623e95 Uploaded
ecology
parents:
diff changeset
99 | ... | ... |
0271f3623e95 Uploaded
ecology
parents:
diff changeset
100 +----------+----------+
0271f3623e95 Uploaded
ecology
parents:
diff changeset
101
0271f3623e95 Uploaded
ecology
parents:
diff changeset
102 **Output**
0271f3623e95 Uploaded
ecology
parents:
diff changeset
103
0271f3623e95 Uploaded
ecology
parents:
diff changeset
104 A zip folder containing the refelctance data with a raster stack pile in BIL format (no extension), a header with the metadata (.hdr extension) and 2 other files in .xml.
0271f3623e95 Uploaded
ecology
parents:
diff changeset
105
0271f3623e95 Uploaded
ecology
parents:
diff changeset
106 A zip folder containing the cloud mask with the 2 files for the raw data (.RAW) and 2 files containing the metadata (.hdr).
0271f3623e95 Uploaded
ecology
parents:
diff changeset
107 ]]> </help>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
108 <expand macro="SRS_S2ref"/>
0271f3623e95 Uploaded
ecology
parents:
diff changeset
109 </tool>