-
Notifications
You must be signed in to change notification settings - Fork 42
/
Copy pathindex.html
281 lines (248 loc) · 32.5 KB
/
index.html
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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Find, Download and Process Sentinel-2 Data • sen2r</title>
<!-- jquery --><script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script><!-- Bootstrap --><link href="https://cdnjs.cloudflare.com/ajax/libs/bootswatch/3.4.0/yeti/bootstrap.min.css" rel="stylesheet" crossorigin="anonymous">
<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script><!-- bootstrap-toc --><link rel="stylesheet" href="bootstrap-toc.css">
<script src="bootstrap-toc.js"></script><!-- Font Awesome icons --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous">
<!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- pkgdown --><link href="pkgdown.css" rel="stylesheet">
<script src="pkgdown.js"></script><meta property="og:title" content="Find, Download and Process Sentinel-2 Data">
<meta property="og:description" content="Functions to download Sentinel-2 optical images
and perform preliminary processing operations.
sen2r provides the instruments required to easily perform
(and eventually automate) the steps necessary to build a complete
Sentinel-2 processing chain.
A Graphical User Interface to facilitate data processing is also provided.
For additional documentation refer to the following article:
Ranghetti et al. (2020) <doi:10.1016/j.cageo.2020.104473>.">
<!-- mathjax --><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script><!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]-->
</head>
<body data-spy="scroll" data-target="#toc">
<div class="container template-home">
<header><div class="navbar navbar-inverse navbar-fixed-top" role="navigation">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<span class="navbar-brand">
<a class="navbar-link" href="index.html">sen2r</a>
<span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="">1.6.0</span>
</span>
</div>
<div id="navbar" class="navbar-collapse collapse">
<ul class="nav navbar-nav"></ul>
<ul class="nav navbar-nav navbar-right">
<li>
<a href="index.html">
<span class="fa fa-home fa-lg"></span>
</a>
</li>
<li>
<a href="reference/index.html">
<span class="fa fa-file-code"></span>
Reference
</a>
</li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
<span class="fa fa-book"></span>
Articles
<span class="caret"></span>
</a>
<ul class="dropdown-menu" role="menu">
<li>
<a href="articles/installation.html">Installation</a>
</li>
<li>
<a href="articles/docker.html">Run in a Docker container</a>
</li>
<li>
<a href="articles/sen2r_gui.html">Using sen2r() from the GUI</a>
</li>
<li>
<a href="articles/sen2r_cmd.html">Using sen2r() from the command line</a>
</li>
<li>
<a href="articles/outstructure.html">Output file structure</a>
</li>
</ul>
</li>
<li>
<a href="news/index.html">
<span class="fa fa-newspaper"></span>
Changelog
</a>
</li>
<li>
<a href="http://luigi.ranghetti.info" class="external-link">
<span class="fa fa-user"></span>
</a>
</li>
<li>
<a href="https://github.com/ranghetti/sen2r/" class="external-link">
<span class="fa fa-github fa-lg"></span>
</a>
</li>
</ul>
</div>
<!--/.nav-collapse -->
</div>
<!--/.container -->
</div>
<!--/.navbar -->
</header><div class="row">
<div class="contents col-md-9">
<p><img src="reference/figures/sen2r_logo_200px.png" width="200" height="113" align="right"></p>
<div class="section level1">
<div class="page-header"><h1 id="sen2r-find-download-and-process-sentinel-2-data">sen2r: Find, Download and Process Sentinel-2 Data<a class="anchor" aria-label="anchor" href="#sen2r-find-download-and-process-sentinel-2-data"></a>
</h1></div>
<p><span style="color:#5793dd;vertical-align:top;font-size:90%;font-weight:normal;">sen</span><span style="color:#6a7077;vertical-align:baseline;font-size:115%;font-weight:bolder;">2</span><span style="color:#2f66d5;vertical-align:baseline;font-size:90%;font-weight:bold;">r</span> is an R library which helps to download and preprocess Sentinel-2 optical images. The purpose of the functions contained in the library is to provide the instruments required to easily perform (and eventually automate) all the steps necessary to build a complete Sentinel-2 processing chain, without the need of any manual intervention nor the needing to manually integrate any external tool.</p>
<p>In particular, <span style="color:#5793dd;vertical-align:top;font-size:90%;font-weight:normal;">sen</span><span style="color:#6a7077;vertical-align:baseline;font-size:115%;font-weight:bolder;">2</span><span style="color:#2f66d5;vertical-align:baseline;font-size:90%;font-weight:bold;">r</span> allows to:</p>
<ul>
<li>retrieve the list of available products on a selected area (which can be provided by specifying a bounding box, by loading a vector file or by drawing it on a map) in a given time window;</li>
<li>download the required SAFE Level-1C products, or retrieve the required SAFE Level-2A products by downloading them (if available) or downloading the corresponding Level-1C and correcting them with <strong>Sen2Cor</strong>;</li>
<li>obtain the required products (Top of Atmosphere radiances, Bottom of Atmosphere reflectances, Surface Classification Maps, True Colour Images) clipped on the specified area (adjacent tiles belonging to the same frame are merged);</li>
<li>mask cloudy pixels (using the Surface Classification Map as masking layer);</li>
<li>computing spectral indices and RGB images.</li>
</ul>
<p><strong>Important</strong>: since November 2023, Sentinel-2 SAFE archives can be searched and retrieved only from <a href="https://cloud.google.com/storage/docs/public-datasets/sentinel-2" class="external-link">Google Cloud Sentinel-2 bucket</a>; to use it, <strong>Google Cloud SDK must be installed</strong> and configured following the <a href="https://cloud.google.com/sdk/docs/install" class="external-link">official instructions</a>. Refer to <a href="https://luigi.ranghetti.info/post/safe-gcloud/" class="external-link">this post</a> for details about how to install configure the required external dependency Google Cloud SDK. Notice that this mode is not optimal (a modern STAC API approach should be used), and searching products could be a very slow process. Nevertheless, the replacement of the old official data source (ESA Hub) with the new <a href="https://dataspace.copernicus.eu/analyse/apis" class="external-link">Copernicus Data Space</a> is not planned (this package is no longer actively maintained due to a career change of the developer). Anyone who wants to help <a href="https://github.com/ranghetti/sen2r/issues/464" class="external-link">can contribute</a>).</p>
<p>Setting the execution of this processing chain is particularly easy using the <span style="color:#5793dd;vertical-align:top;font-size:90%;font-weight:normal;">sen</span><span style="color:#6a7077;vertical-align:baseline;font-size:115%;font-weight:bolder;">2</span><span style="color:#2f66d5;vertical-align:baseline;font-size:90%;font-weight:bold;">r</span> GUI, which allows to set the parameters, to directly launch the main function or to save them in a JSON file which can be used to launch the processing at a later stage.</p>
<p>The possibility to launch the processing with a set of parameters saved in a JSON file (or directly passed as function arguments) makes easy to build scripts to automatically update an archive of Sentinel-2 products. Specific processing operations (i.e. applying <strong>Sen2Cor</strong> on Level-1c SAFE products, merging adjacent tiles, computing spectral indices from existing products) can also be performed using intermediate functions (see <a href="#usage">usage</a>).</p>
<p><a href="https://www.sciencedirect.com/science/article/pii/S0098300419304893" target="_blank" class="external-link"><img style="margin-right:20px;" src="data:image/gif;base64,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" width="120" height="160" align="left"></a></p>
<p><span style="color:#5793dd;vertical-align:top;font-size:90%;font-weight:normal;">sen</span><span style="color:#6a7077;vertical-align:baseline;font-size:115%;font-weight:bolder;">2</span><span style="color:#2f66d5;vertical-align:baseline;font-size:90%;font-weight:bold;">r</span> was published on the ISI journal <em>Computers & Geosciences</em>; the manuscript is available here:</p>
<p><a href="https://www.sciencedirect.com/science/article/pii/S0098300419304893" target="_blank" class="external-link"> L. Ranghetti, M. Boschetti, F. Nutini, L. Busetto (2020). <strong>“sen2r: An R toolbox for automatically downloading and preprocessing Sentinel-2 satellite data”</strong>. <em>Computers & Geosciences</em>, 139, 104473. doi: 10.1016/j.cageo.2020.104473, URL: https://sen2r.ranghetti.info </a>.</p>
<p>Users which processed Sentinel-2 data and used them for a scientific work are strongly encouraged to cite this publication within their work (see <a href="#credits">Credits</a>).</p>
<div class="section level2">
<h2 id="installation">Installation<a class="anchor" aria-label="anchor" href="#installation"></a>
</h2>
<p>The package can be installed from CRAN:</p>
<div class="sourceCode" id="cb1"><pre class="downlit sourceCode r">
<code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/utils/install.packages.html" class="external-link">install.packages</a></span><span class="op">(</span><span class="st">"sen2r"</span>, dependencies <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></code></pre></div>
<p>For detailed instructions about installing the package (including dependencies), see the <a href="articles/installation.html">Installation</a> page.</p>
<p>A dockerised version of <span style="color:#5793dd;vertical-align:top;font-size:90%;font-weight:normal;">sen</span><span style="color:#6a7077;vertical-align:baseline;font-size:115%;font-weight:bolder;">2</span><span style="color:#2f66d5;vertical-align:baseline;font-size:90%;font-weight:bold;">r</span> is available <a href="https://hub.docker.com/r/ranghetti/sen2r" class="external-link">here</a>. For detailed instructions about using it, see the page <a href="articles/docker.html">“Run in a Docker container”</a>.</p>
</div>
<div class="section level2">
<h2 id="usage">Usage<a class="anchor" aria-label="anchor" href="#usage"></a>
</h2>
<p>The simplest way to use <span style="color:#5793dd;vertical-align:top;font-size:90%;font-weight:normal;">sen</span><span style="color:#6a7077;vertical-align:baseline;font-size:115%;font-weight:bolder;">2</span><span style="color:#2f66d5;vertical-align:baseline;font-size:90%;font-weight:bold;">r</span> is to execute it in interactive mode (see <a href="articles/sen2r_gui.html">this vignette</a>):</p>
<div class="sourceCode" id="cb2"><pre class="downlit sourceCode r">
<code class="sourceCode R"><span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://sen2r.ranghetti.info" class="external-link">sen2r</a></span><span class="op">)</span></span>
<span><span class="fu"><a href="reference/sen2r.html">sen2r</a></span><span class="op">(</span><span class="op">)</span></span></code></pre></div>
<p style="text-align:center;">
<a href="https://github.com/ranghetti/sen2r/raw/main/man/figures/sen2r_gui_sheet1.png" target="_blank" class="external-link"> <img src="reference/figures/sen2r_gui_sheet1_small.png"></a> <a href="https://github.com/ranghetti/sen2r/raw/main/man/figures/sen2r_gui_sheet2.png" target="_blank" class="external-link"> <img src="reference/figures/sen2r_gui_sheet2_small.png"></a> <br><a href="https://github.com/ranghetti/sen2r/raw/main/man/figures/sen2r_gui_sheet3.png" target="_blank" class="external-link"> <img src="reference/figures/sen2r_gui_sheet3_small.png"></a> <a href="https://github.com/ranghetti/sen2r/raw/main/man/figures/sen2r_gui_sheet4.png" target="_blank" class="external-link"> <img src="reference/figures/sen2r_gui_sheet4_small.png"></a> <a href="https://github.com/ranghetti/sen2r/raw/main/man/figures/sen2r_gui_sheet5.png" target="_blank" class="external-link"> <img src="reference/figures/sen2r_gui_sheet5_small.png"></a>
</p>
<p>Alternatively, <a href="reference/sen2r.html"><code>sen2r()</code></a> can be launched with a list of parameters (created with <a href="reference/s2_gui.html"><code>s2_gui()</code></a>) or passing manually the parameters as arguments of the function (see <a href="articles/sen2r_cmd.html">this vignette</a> for further details).</p>
<p>Other specific functions can be used to run single steps separately. This is a list of the principal processing functions (the complete list can be found in the Reference page):</p>
<ul>
<li>
<a href="reference/s2_list.html"><code>s2_list()</code></a> to retrieve the list of available Sentinel-2 products based on input parameters;</li>
<li>
<a href="reference/s2_download.html"><code>s2_download()</code></a> to download Sentinel-2 products;</li>
<li>
<a href="reference/s2_order.html"><code>s2_order()</code></a> to order products from the Long Term Archive;</li>
<li>
<a href="reference/sen2cor.html"><code>sen2cor()</code></a> to correct level-1C products using <a href="https://step.esa.int/main/snap-supported-plugins/sen2cor/" class="external-link">Sen2Cor</a>;</li>
<li>
<a href="reference/s2_mask.html"><code>s2_mask()</code></a> to apply a cloud mask to Sentinel-2 products;</li>
<li>
<a href="reference/s2_rgb.html"><code>s2_rgb()</code></a> to generate RGB images from Sentinel-2 Surface Reflectance multiband raster files;</li>
<li>
<a href="reference/s2_calcindices.html"><code>s2_calcindices()</code></a> to compute maps of spectral indices from Sentinel-2 Surface Reflectance multiband raster files.</li>
</ul>
<p>Output products follow a specific naming convention (see <a href="articles/outstructure.html">here</a> for details).</p>
</div>
<div class="section level2">
<h2 id="credits">Credits<a class="anchor" aria-label="anchor" href="#credits"></a>
</h2>
<p><a href="http://www.irea.cnr.it" target="_blank" class="external-link"> <img src="reference/figures/irea_logo_200px.png" height="100" align="left" style="padding-right: 100px;"></a> <span style="color:#5793dd;vertical-align:top;font-size:90%;font-weight:normal;">sen</span><span style="color:#6a7077;vertical-align:baseline;font-size:115%;font-weight:bolder;">2</span><span style="color:#2f66d5;vertical-align:baseline;font-size:90%;font-weight:bold;">r</span> is being developed by Luigi Ranghetti and Lorenzo Busetto (<a href="http://www.irea.cnr.it" class="external-link">IREA-CNR</a>), and it is released under the <a href="https://www.gnu.org/licenses/gpl-3.0.html" class="external-link">GNU General Public License version 3</a> (GPL‑3).</p>
<p>The <a href="https://github.com/ranghetti/sen2r/raw/main/man/figures/sen2r_logo_200px.png" class="external-link"><span style="color:#5793dd;vertical-align:top;font-size:90%;font-weight:normal;">sen</span><span style="color:#6a7077;vertical-align:baseline;font-size:115%;font-weight:bolder;">2</span><span style="color:#2f66d5;vertical-align:baseline;font-size:90%;font-weight:bold;">r</span> logo</a>, partially derived from the <a href="https://www.r-project.org/logo" class="external-link">R logo</a>, is released under the <a href="https://creativecommons.org/licenses/by-sa/4.0" class="external-link">Creative Commons Attribution-ShareAlike 4.0 International license</a> (CC-BY-SA 4.0).</p>
<p>To cite this library, please use the following entry:</p>
<p>L. Ranghetti, M. Boschetti, F. Nutini, L. Busetto (2020). <strong>“sen2r: An R toolbox for automatically downloading and preprocessing Sentinel-2 satellite data”</strong>. <em>Computers & Geosciences</em>, 139, 104473. doi: <a href="https://dx.doi.org/10.1016/j.cageo.2020.104473" target="_blank" class="external-link">10.1016/j.cageo.2020.104473</a>, URL: <a href="https://sen2r.ranghetti.info" target="_blank" class="external-link">https://sen2r.ranghetti.info</a>.</p>
<div class="sourceCode" id="cb3"><pre class="sourceCode bibtex"><code class="sourceCode bibtex"><span id="cb3-1"><a href="#cb3-1" tabindex="-1"></a><span class="va">@Article</span>{<span class="ot">sen2r_cageo</span>,</span>
<span id="cb3-2"><a href="#cb3-2" tabindex="-1"></a> <span class="dt">title</span> = {sen2r: An R toolbox for automatically downloading and preprocessing Sentinel-2 satellite data},</span>
<span id="cb3-3"><a href="#cb3-3" tabindex="-1"></a> <span class="dt">author</span> = {Luigi Ranghetti and Mirco Boschetti and Francesco Nutini and Lorenzo Busetto},</span>
<span id="cb3-4"><a href="#cb3-4" tabindex="-1"></a> <span class="dt">journal</span> = {Computers & Geosciences},</span>
<span id="cb3-5"><a href="#cb3-5" tabindex="-1"></a> <span class="dt">year</span> = {2020},</span>
<span id="cb3-6"><a href="#cb3-6" tabindex="-1"></a> <span class="dt">volume</span> = {139},</span>
<span id="cb3-7"><a href="#cb3-7" tabindex="-1"></a> <span class="dt">pages</span> = {104473},</span>
<span id="cb3-8"><a href="#cb3-8" tabindex="-1"></a> <span class="dt">doi</span> = {10.1016/j.cageo.2020.104473},</span>
<span id="cb3-9"><a href="#cb3-9" tabindex="-1"></a> <span class="dt">url</span> = {https://sen2r.ranghetti.info/},</span>
<span id="cb3-10"><a href="#cb3-10" tabindex="-1"></a>}</span></code></pre></div>
</div>
<div class="section level2">
<h2 id="contributing">Contributing<a class="anchor" aria-label="anchor" href="#contributing"></a>
</h2>
<p>This project is released with a <a href="CODE-OF-CONDUCT.html">Contributor Code of Conduct</a>. By participating in this project you agree to abide by its terms.</p>
<p>Users are encouraged to use GitHub issues in case of errors with the package. Before opening a new issue, please read <a href="https://github.com/ranghetti/sen2r/issues/186" target="_blank" class="external-link">these notes</a>.</p>
</div>
</div>
</div>
<div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
<div class="links">
<h2 data-toc-skip>Links</h2>
<ul class="list-unstyled">
<li><a href="https://cloud.r-project.org/package=sen2r" class="external-link">View on CRAN</a></li>
<li><a href="https://github.com/ranghetti/sen2r/" class="external-link">Browse source code</a></li>
<li><a href="https://github.com/ranghetti/sen2r/issues" class="external-link">Report a bug</a></li>
</ul>
</div>
<div class="license">
<h2 data-toc-skip>License</h2>
<ul class="list-unstyled">
<li><a href="LICENSE.html">Full license</a></li>
<li><small><a href="https://www.r-project.org/Licenses/GPL-3" class="external-link">GPL-3</a></small></li>
</ul>
</div>
<div class="citation">
<h2 data-toc-skip>Citation</h2>
<ul class="list-unstyled">
<li><a href="authors.html#citation">Citing sen2r</a></li>
</ul>
</div>
<div class="developers">
<h2 data-toc-skip>Developers</h2>
<ul class="list-unstyled">
<li>Luigi Ranghetti <br><small class="roles"> Author, maintainer </small> <a href="https://orcid.org/0000-0001-6207-5188" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
<li>Lorenzo Busetto <br><small class="roles"> Author </small> <a href="https://orcid.org/0000-0001-9634-6038" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
<li><a href="authors.html">More about authors...</a></li>
</ul>
</div>
<div class="dev-status">
<h2 data-toc-skip>Dev status</h2>
<ul class="list-unstyled">
<li><a href="https://cran.r-project.org/package=sen2r" class="external-link"><img src="https://www.r-pkg.org/badges/version-ago/sen2r" alt="CRAN Status"></a></li>
<li><a href="https://doi.org/10.5281/zenodo.1240384" class="external-link"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.1240384.svg" alt="DOI"></a></li>
<li><a href="https://cran.rstudio.com/web/packages/ggplot2/index.html" class="external-link"><img src="https://cranlogs.r-pkg.org/badges/last-month/sen2r?color=green" alt="CRAN RStudio mirror downloads"></a></li>
<li><a href="https://github.com/ranghetti/sen2r/actions/workflows/R-CMD-check.yaml" class="external-link"><img src="https://github.com/ranghetti/sen2r/workflows/R-CMD-check/badge.svg" alt="R-CMD-check"></a></li>
<li><a href="http://codecov.io/github/ranghetti/sen2r?branch=main" class="external-link"><img src="http://img.shields.io/codecov/c/github/ranghetti/sen2r/main.svg" alt="Coverage Status"></a></li>
<li><a href="https://hub.docker.com/r/ranghetti/sen2r" class="external-link"><img src="https://img.shields.io/docker/automated/ranghetti/sen2r.svg" alt="Docker Automated build"></a></li>
<li><a href="http://www.gnu.org/licenses/gpl-3.0" class="external-link"><img src="https://img.shields.io/badge/License-GPL%20v3-blue.svg" alt="License: GPL v3"></a></li>
<li><a href="CODE-OF-CONDUCT.html"><img src="https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg" alt="Contributor Covenant"></a></li>
</ul>
</div>
</div>
</div>
<footer><div class="copyright">
<p></p>
<p>Developed by Luigi Ranghetti, Lorenzo Busetto.</p>
</div>
<div class="pkgdown">
<p></p>
<p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.0.7.</p>
</div>
</footer>
</div>
</body>
</html>