Debian Codegraph @

imagery/i.atcorr/i.atcorr.html

raw
1 <h2>DESCRIPTION</h2>
2
3 <b>i.atcorr</b> performs atmospheric correction on the input raster
4 map using the 6S algorithm (<em>Second Simulation of Satellite Signal
5 in the Solar Spectrum</em>). A detailed algorithm description is
6 available at the
7 <a href="https://salsa.umd.edu/">Land Surface
8 Reflectance Science Computing Facility website</a>.
9
10 <p><em>Important: Current region settings are ignored!</em> The
11 region is adjusted to cover the input raster map before the atmospheric
12 correction is performed. The previous settings are restored afterwards.
13
14 <p>If the <b>-r</b> flag is used, the input raster map is treated as
15 <em>reflectance</em>. Otherwise, the input raster map is treated
16 as <em>radiance</em> values and it is converted to reflectance at
17 the <em>i.atcorr</em> runtime. The output data are always reflectance.
18
19 <p>The satellite overpass time has to be specified in Greenwich
20 Mean Time (GMT).
21
22 <p>An example of the 6S parameters could be:
23
24 <div class="code"><pre>
25 8 - geometrical conditions=Landsat ETM+
26 2 19 13.00 -47.410 -20.234 - month day hh.ddd longitude latitude ("hh.ddd" is in decimal hours GMT)
27 1 - atmospheric model=tropical
28 1 - aerosols model=continental
29 15 - visibility [km] (aerosol model concentration)
30 -0.600 - mean target elevation above sea level [km] (here 600 m asl)
31 -1000 - sensor height (here, sensor on board a satellite)
32 64 - 4th band of ETM+ Landsat 7
33 </pre></div>
34
35 If the position is not available in longitude-latitude (WGS84), the
36 <em><a href="m.proj.html">m.proj</a></em> conversion module can be
37 used to reproject from a different reference system.
38
39 <h2>6S CODE PARAMETER CHOICES</h2>
40
41 <h3>A. Geometrical conditions</h3>
42
43 <table border="1">
44
45 <tr>
46 <td><b>Code</b></td>
47 <td><b>Description</b></td>
48 <td><b>Details</b></td>
49 </tr>
50
51 <tr>
52 <td>1</td>
53 <td><b>meteosat</b> observation</td>
54 <td>enter month,day,decimal hour (universal time-hh.ddd)
55 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
56 n. of column,n. of line. (full scale 5000*2500)&nbsp;</td>
57 </tr>
58
59 <tr>
60 <td>2</td>
61 <td><b>goes east </b>observation</td>
62 <td>enter month,day,decimal hour (universal time-hh.ddd)
63 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
64 n. of column,n. of line. (full scale 17000*12000)c</td>
65 </tr>
66
67 <tr>
68 <td>3</td>
69 <td><b>goes west</b> observation</td>
70 <td>enter month,day,decimal hour (universal time-hh.ddd)
71 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
72 n. of column,n. of line. (full scale 17000*12000)</td>
73 </tr>
74
75 <tr>
76 <td>4</td>
77 <td><b>avhrr</b> (PM noaa)</td>
78 <td>enter month,day,decimal hour (universal time-hh.ddd)
79 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
80 n. of column(1-2048),xlonan,hna
81 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
82 give long.(xlonan) and overpass hour (hna) at
83 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
84 the ascendant node at equator</td>
85 </tr>
86
87 <tr>
88 <td>5</td>
89 <td><b>avhrr</b> (AM noaa)</td>
90 <td>enter month,day,decimal hour (universal time-hh.ddd)
91 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
92 n. of column(1-2048),xlonan,hna
93 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
94 give long.(xlonan) and overpass hour (hna) at
95 <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
96 the ascendant node at equator</td>
97 </tr>
98
99 <tr>
100 <td>6</td>
101 <td><b>hrv</b> (spot)</td>
102 <td>enter month,day,hh.ddd,long.,lat. *</td>
103 </tr>
104
105 <tr>
106 <td>7</td>
107 <td><b>tm</b> (landsat)</td>
108 <td>enter month,day,hh.ddd,long.,lat. *</td>
109 </tr>
110
111 <tr>
112 <td>8</td>
113 <td><b>etm+</b> (landsat7)</td>
114 <td>enter month,day,hh.ddd,long.,lat. *</td>
115 </tr>
116
117 <tr>
118 <td>9</td>
119 <td><b>liss</b> (IRS 1C)</td>
120 <td>enter month,day,hh.ddd,long.,lat. *</td>
121 </tr>
122
123 <tr>
124 <td>10</td>
125 <td><b>aster</b></td>
126 <td>enter month,day,hh.ddd,long.,lat. *</td>
127 </tr>
128
129 <tr>
130 <td>11</td>
131 <td><b>avnir</b></td>
132 <td>enter month,day,hh.ddd,long.,lat. *</td>
133 </tr>
134
135 <tr>
136 <td>12</td>
137 <td><b>ikonos</b></td>
138 <td>enter month,day,hh.ddd,long.,lat. *</td>
139 </tr>
140
141 <tr>
142 <td>13</td>
143 <td><b>RapidEye</b></td>
144 <td>enter month,day,hh.ddd,long.,lat. *</td>
145 </tr>
146
147 <tr>
148 <td>14</td>
149 <td><b>VGT1 (SPOT4)</b></td>
150 <td>enter month,day,hh.ddd,long.,lat. *</td>
151 </tr>
152
153 <tr>
154 <td>15</td>
155 <td><b>VGT2 (SPOT5)</b></td>
156 <td>enter month,day,hh.ddd,long.,lat. *</td>
157 </tr>
158
159 <tr>
160 <td>16</td>
161 <td><b>WorldView 2</b></td>
162 <td>enter month,day,hh.ddd,long.,lat. *</td>
163 </tr>
164
165 <tr>
166 <td>17</td>
167 <td><b>QuickBird</b></td>
168 <td>enter month,day,hh.ddd,long.,lat. *</td>
169 </tr>
170
171 <tr>
172 <td>18</td>
173 <td><b>LandSat 8</b></td>
174 <td>enter month,day,hh.ddd,long.,lat. *</td>
175 </tr>
176
177
178 <tr>
179 <td>19</td>
180 <td><b>Geoeye 1</b></td>
181 <td>enter month,day,hh.ddd,long.,lat. *</td>
182 </tr>
183
184
185 <tr>
186 <td>20</td>
187 <td><b>Spot6</b></td>
188 <td>enter month,day,hh.ddd,long.,lat. *</td>
189 </tr>
190
191
192 <tr>
193 <td>21</td>
194 <td><b>Spot7</b></td>
195 <td>enter month,day,hh.ddd,long.,lat. *</td>
196 </tr>
197
198
199 <tr>
200 <td>22</td>
201 <td><b>Pleiades1A</b></td>
202 <td>enter month,day,hh.ddd,long.,lat. *</td>
203 </tr>
204
205
206 <tr>
207 <td>23</td>
208 <td><b>Pleiades1B</b></td>
209 <td>enter month,day,hh.ddd,long.,lat. *</td>
210 </tr>
211
212
213 <tr>
214 <td>24</td>
215 <td><b>Worldview3</b></td>
216 <td>enter month,day,hh.ddd,long.,lat. *</td>
217 </tr>
218
219 <tr>
220 <td>25</td>
221 <td><b>Sentinel-2A</b></td>
222 <td>enter month,day,hh.ddd,long.,lat. *</td>
223 </tr>
224
225 <tr>
226 <td>26</td>
227 <td><b>Sentinel-2B</b></td>
228 <td>enter month,day,hh.ddd,long.,lat. *</td>
229 </tr>
230
231 <tr>
232 <td>27</td>
233 <td><b>PlanetScope 0c 0d</b></td>
234 <td>enter month,day,hh.ddd,long.,lat. *</td>
235 </tr>
236
237 <tr>
238 <td>28</td>
239 <td><b>PlanetScope 0e</b></td>
240 <td>enter month,day,hh.ddd,long.,lat. *</td>
241 </tr>
242
243 <tr>
244 <td>29</td>
245 <td><b>PlanetScope 0f 10</b></td>
246 <td>enter month,day,hh.ddd,long.,lat. *</td>
247 </tr>
248
249 <tr>
250 <td>30</td>
251 <td><b>Worldview4</b></td>
252 <td>enter month,day,hh.ddd,long.,lat. *</td>
253 </tr>
254
255 <tr>
256 <td>31</td>
257 <td><b>AVIRIS</b></td>
258 <td>enter month,day,hh.ddd,long.,lat. *</td>
259 </tr>
260
261 <tr>
262 <td>32</td>
263 <td><b>Hyperion VNIR</b></td>
264 <td>enter month,day,hh.ddd,long.,lat. *</td>
265 </tr>
266
267 <tr>
268 <td>33</td>
269 <td><b>Hyperion SWIR</b></td>
270 <td>enter month,day,hh.ddd,long.,lat. *</td>
271 </tr>
272
273 </table>
274
275 <p>
276 <blockquote>
277 <em>NOTE</em>: for HRV, TM, ETM+, LISS and ASTER experiments,
278 <!-- TODO: what about the others? -->
279 longitude and latitude are the coordinates of the scene
280 center. Latitude must be &gt; 0 for northern hemisphere and &lt; 0 for
281 southern. Longitude must be &gt; 0 for eastern hemisphere and &lt; 0 for
282 western.
283 </blockquote>
284
285 <h3>B. Atmospheric model</h3>
286
287 <table border="1">
288
289 <tr>
290 <td><b>Code</b></td>
291 <td><b>Meaning</b></td>
292 </tr>
293
294 <tr>
295 <td>0</td>
296 <td>no gaseous absorption</td>
297 </tr>
298
299 <tr>
300 <td>1</td>
301 <td>tropical</td>
302 </tr>
303
304 <tr>
305 <td>2</td>
306 <td>midlatitude summer</td>
307 </tr>
308
309 <tr>
310 <td>3</td>
311 <td>midlatitude winter</td>
312 </tr>
313
314 <tr>
315 <td>4</td>
316 <td>subarctic summer</td>
317 </tr>
318
319 <tr>
320 <td>5</td>
321 <td>subarctic winter</td>
322 </tr>
323
324 <tr>
325 <td>6</td>
326 <td>us standard 62</td>
327 </tr>
328
329 <tr>
330 <td>7</td>
331 <td>Define your own atmospheric model as a set of the following 5 parameters
332 per each measurement:<br>
333 <br>altitude [km]
334 <br>pressure [mb]
335 <br>temperature [k]
336 <br>h2o density [g/m3]
337 <br>o3 density [g/m3]<br>
338 <br>For example: there is one radiosonde measurement for each altitude of
339 0-25km at a step of 1km, one measurement for each altitude of 25-50km at a step
340 of 5km, and two single measurements for altitudes 70km and 100km. This makes 34
341 measurements. In that case, there are 34*5 values to input.</td>
342 </tr>
343
344 <tr>
345 <td>8</td>
346 <td>Define your own atmospheric model providing values of the water vapor and
347 ozone content:
348 <br>
349 <br>uw [g/cm2]
350 <br>uo3 [cm-atm]
351 <br>
352 <br> The profile is taken from us62.</td>
353 </tr>
354
355 </table>
356
357 <h3>C. Aerosols model</h3>
358
359 <table border="1">
360
361 <tr>
362 <td><b>Code</b></td>
363 <td><b>Meaning</b></td>
364 <td><b>Details</b></td>
365 </tr>
366
367 <tr>
368 <td>0</td>
369 <td>no aerosols</td>
370 <td>&nbsp;</td>
371 </tr>
372
373 <tr>
374 <td>1</td>
375 <td>continental model</td>
376 <td>&nbsp;</td>
377 </tr>
378
379 <tr>
380 <td>2</td>
381 <td>maritime model</td>
382 <td>&nbsp;</td>
383 </tr>
384
385 <tr>
386 <td>3</td>
387 <td>urban model</td>
388 <td>&nbsp;</td>
389 </tr>
390
391 <tr>
392 <td>4</td>
393 <td>shettle model for background desert aerosol</td>
394 <td>&nbsp;</td>
395 </tr>
396
397 <tr>
398 <td>5</td>
399 <td>biomass burning</td>
400 <td>&nbsp;</td>
401 </tr>
402
403 <tr>
404 <td>6</td>
405 <td>stratospheric model</td>
406 <td>&nbsp;</td>
407 </tr>
408
409 <tr>
410 <td>7</td>
411 <td>define your own model</td>
412 <td>Enter the volumic percentage of each component:
413 <br>
414 <br>c(1) = volumic % of dust-like
415 <br>c(2) = volumic % of water-soluble
416 <br>c(3) = volumic % of oceanic
417 <br>c(4) = volumic % of soot
418 <br>
419 <br>All values should be between 0 and 1.</td>
420 </tr>
421
422 <tr>
423 <td>8</td>
424 <td>define your own model</td>
425 <td>Size distribution function: Multimodal Log Normal (up to 4 modes).</td>
426 </tr>
427
428 <tr>
429 <td>9</td>
430 <td>define your own model</td>
431 <td>Size distribution function: Modified gamma.</td>
432 </tr>
433
434 <tr>
435 <td>10</td>
436 <td>define your own model</td>
437 <td>Size distribution function: Junge Power-Law.</td>
438 </tr>
439
440 <tr>
441 <td>11</td>
442 <td>define your own model</td>
443 <td>Sun-photometer measurements, 50 values max, entered as:
444 <br>
445 <br>r and d V / d (logr)
446 <br>
447 <br>where r is the radius [micron], V is the volume, d V / d (logr) [cm3/cm2/micron].
448 <br>
449 <br>Followed by:
450 <br>
451 <br>nr and ni for each wavelength
452 <br>
453 <br>where nr and ni are respectively the real and imaginary part of the
454 refractive index.</td>
455 </tr>
456 </table>
457
458 <h3>D. Aerosol concentration model (visibility)</h3>
459
460 If you have an estimate of the meteorological parameter visibility
461 v, enter directly the value of v [km] (the aerosol optical depth (AOD)
462 will be computed from a standard aerosol profile).
463 <p>If you have an estimate of aerosol optical depth, enter 0 for the
464 visibility and in a following line enter the aerosol optical depth at 550nm
465 (iaer means 'i' for input and 'aer' for aerosol), for example:<br>
466 <div class="code"><pre>
467 0 - visibility
468 0.112 - aerosol optical depth at 550 nm
469 </pre></div>
470
471 <p>NOTE: if iaer is 0, enter -1 for visibility.
472 <p>NOTE: if a visibility map is provided, these parameters are ignored.
473
474 <h3>E. Target altitude (xps), sensor platform (xpp)</h3>
475
476 Target altitude (xps, in negative [km]):
477 <blockquote>xps &gt;= 0 means the target is at the sea level.
478 <br>otherwise xps expresses the altitude of the target (e.g., mean elevation)
479 in [km], given as negative value
480 </blockquote><br>
481
482 Sensor platform (xpp, in negative [km] or -1000):
483 <blockquote>
484 <br>xpp = -1000 means that the sensor is on board a satellite.
485 <br>xpp = 0 means that the sensor is at the ground level.
486 <br>-100 &lt; xpp &lt; 0 defines the altitude of the sensor expressed in [km];
487 this altitude is given <b>relative to the target</b> altitude as negative value.
488 </blockquote>
489
490 <p>For aircraft simulations only (xpp is neither equal to 0 nor equal to -1000):
491 <blockquote>
492 puw (water vapor content between the aircraft and the surface)
493 <br>po3 (ozone content between the aircraft and the surface)
494 <br>taerp (the aerosol optical thickness at 550nm between the aircraft and the
495 surface)
496 <p>If these data are not available, enter negative values for all of them.
497 puw,po3 will then be interpolated from the us62 standard profile according
498 to the values at the ground level; taerp will be computed according to a 2 km
499 exponential profile for aerosol.
500 </blockquote>
501
502 <h3>F. Sensor band</h3>
503
504 <p>There are two possibilities: either define your own spectral conditions
505 (codes -2, -1, 0, or 1) or choose a code indicating the band of one of the
506 pre-defined satellites.
507
508 <p>Define your own spectral conditions:
509
510 Note that "wlinf" and "wlsup" refer to the limits of the wavelength range
511 defined by the user for a given simulation. Specifically:
512
513 <ul>
514 <li> wlinf: This represents the lower wavelength limit (or minimum wavelength)
515 of the spectral band for which the simulation is being performed.</li>
516 <li> wlsup: This represents the upper wavelength limit (or maximum wavelength)
517 of the spectral band for the simulation.</li>
518 </ul>
519
520 <table border="1">
521
522 <tr>
523 <td><b>Code</b></td>
524 <td><b>Meaning</b></td>
525 </tr>
526
527 <tr>
528 <td>-2</td>
529 <td>Enter wlinf, wlsup.
530 <br>The filter function will be equal to 1 over the whole band (as iwave=0)
531 but step by step output will be printed.</td>
532 </tr>
533
534 <tr>
535 <td>-1</td>
536 <td>Enter wl (monochr. cond, gaseous absorption is included).</td>
537 </tr>
538
539 <tr>
540 <td>0</td>
541 <td>Enter wlinf, wlsup.
542 <br>The filter function will be equal to 1 over the whole band.</td>
543 </tr>
544
545 <tr>
546 <td>1</td>
547 <td>Enter wlinf, wlsup and user's filter function s (lambda) by step of
548 0.0025 micrometer.</td>
549 </tr>
550 </table>
551
552 <p>Pre-defined satellite bands:
553
554 <table border="1">
555
556 <tr><td><b>Code</b></td><td><b>Band name (peak response)</b></td></tr>
557
558 <tr><td>2</td><td><b>meteosat</b> vis band (0.350-1.110)</td></tr>
559
560 <tr><td>3</td><td><b>goes east</b> band vis (0.490-0.900)</td></tr>
561
562 <tr><td>4</td><td><b>goes west</b> band vis (0.490-0.900)</td></tr>
563
564 <tr><td>5</td><td><b>avhrr</b> (noaa6) band 1 (0.550-0.750)</td></tr>
565 <tr><td>6</td><td>avhrr (noaa6) band 2 (0.690-1.120)</td></tr>
566 <tr><td>7</td><td>avhrr (noaa7) band 1 (0.500-0.800)</td></tr>
567 <tr><td>8</td><td>avhrr (noaa7) band 2 (0.640-1.170)</td></tr>
568 <tr><td>9</td><td>avhrr (noaa8) band 1 (0.540-1.010)</td></tr>
569 <tr><td>10</td><td>avhrr (noaa8) band 2 (0.680-1.120)</td></tr>
570 <tr><td>11</td><td>avhrr (noaa9) band 1 (0.530-0.810)</td></tr>
571 <tr><td>12</td><td>avhrr (noaa9) band 1 (0.680-1.170)</td></tr>
572 <tr><td>13</td><td>avhrr (noaa10) band 1 (0.530-0.780)</td></tr>
573 <tr><td>14</td><td>avhrr (noaa10) band 2 (0.600-1.190)</td></tr>
574 <tr><td>15</td><td>avhrr (noaa11) band 1 (0.540-0.820)</td></tr>
575 <tr><td>16</td><td>avhrr (noaa11) band 2 (0.600-1.120)</td></tr>
576
577 <tr><td>17</td><td><b>hrv1</b> (spot1) band 1 (0.470-0.650)</td></tr>
578 <tr><td>18</td><td>hrv1 (spot1) band 2 (0.600-0.720)</td></tr>
579 <tr><td>19</td><td>hrv1 (spot1) band 3 (0.730-0.930)</td></tr>
580 <tr><td>20</td><td>hrv1 (spot1) band pan (0.470-0.790)</td></tr>
581 <tr><td>21</td><td>hrv2 (spot1) band 1 (0.470-0.650)</td></tr>
582 <tr><td>22</td><td>hrv2 (spot1) band 2 (0.590-0.730)</td></tr>
583 <tr><td>23</td><td>hrv2 (spot1) band 3 (0.740-0.940)</td></tr>
584 <tr><td>24</td><td>hrv2 (spot1) band pan (0.470-0.790)</td></tr>
585
586 <tr><td>25</td><td><b>tm</b> (landsat5) band 1 (0.430-0.560)</td></tr>
587 <tr><td>26</td><td>tm (landsat5) band 2 (0.500-0.650)</td></tr>
588 <tr><td>27</td><td>tm (landsat5) band 3 (0.580-0.740)</td></tr>
589 <tr><td>28</td><td>tm (landsat5) band 4 (0.730-0.950)</td></tr>
590 <tr><td>29</td><td>tm (landsat5) band 5 (1.5025-1.890)</td></tr>
591 <tr><td>30</td><td>tm (landsat5) band 7 (1.950-2.410)</td></tr>
592
593 <tr><td>31</td><td><b>mss</b> (landsat5) band 1 (0.475-0.640)</td></tr>
594 <tr><td>32</td><td>mss (landsat5) band 2 (0.580-0.750)</td></tr>
595 <tr><td>33</td><td>mss (landsat5) band 3 (0.655-0.855)</td></tr>
596 <tr><td>34</td><td>mss (landsat5) band 4 (0.785-1.100)</td></tr>
597
598 <tr><td>35</td><td><b>MAS</b> (ER2) band 1 (0.5025-0.5875)</td></tr>
599 <tr><td>36</td><td>MAS (ER2) band 2 (0.6075-0.7000)</td></tr>
600 <tr><td>37</td><td>MAS (ER2) band 3 (0.8300-0.9125)</td></tr>
601 <tr><td>38</td><td>MAS (ER2) band 4 (0.9000-0.9975)</td></tr>
602 <tr><td>39</td><td>MAS (ER2) band 5 (1.8200-1.9575)</td></tr>
603 <tr><td>40</td><td>MAS (ER2) band 6 (2.0950-2.1925)</td></tr>
604 <tr><td>41</td><td>MAS (ER2) band 7 (3.5800-3.8700)</td></tr>
605
606 <tr><td>42</td><td><b>MODIS</b> band 1 (0.6100-0.6850)</td></tr>
607 <tr><td>43</td><td>MODIS band 2 (0.8200-0.9025)</td></tr>
608 <tr><td>44</td><td>MODIS band 3 (0.4500-0.4825)</td></tr>
609 <tr><td>45</td><td>MODIS band 4 (0.5400-0.5700)</td></tr>
610 <tr><td>46</td><td>MODIS band 5 (1.2150-1.2700)</td></tr>
611 <tr><td>47</td><td>MODIS band 6 (1.6000-1.6650)</td></tr>
612 <tr><td>48</td><td>MODIS band 7 (2.0575-2.1825)</td></tr>
613
614 <tr><td>49</td><td><b>avhrr</b> (noaa12) band 1 (0.500-1.000)</td></tr>
615 <tr><td>50</td><td>avhrr (noaa12) band 2 (0.650-1.120)</td></tr>
616 <tr><td>51</td><td>avhrr (noaa14) band 1 (0.500-1.110)</td></tr>
617 <tr><td>52</td><td>avhrr (noaa14) band 2 (0.680-1.100)</td></tr>
618
619 <tr><td>53</td><td><b>POLDER</b> band 1 (0.4125-0.4775)</td></tr>
620 <tr><td>54</td><td>POLDER band 2 (non polar) (0.4100-0.5225)</td></tr>
621 <tr><td>55</td><td>POLDER band 3 (non polar) (0.5325-0.5950)</td></tr>
622 <tr><td>56</td><td>POLDER band 4 P1 (0.6300-0.7025)</td></tr>
623 <tr><td>57</td><td>POLDER band 5 (non polar) (0.7450-0.7800)</td></tr>
624 <tr><td>58</td><td>POLDER band 6 (non polar) (0.7000-0.8300)</td></tr>
625 <tr><td>59</td><td>POLDER band 7 P1 (0.8100-0.9200)</td></tr>
626 <tr><td>60</td><td>POLDER band 8 (non polar) (0.8650-0.9400)</td></tr>
627
628 <tr><td>61</td><td><b>etm+ (landsat7)</b> band 1 blue (435nm - 517nm)</td></tr>
629 <tr><td>62</td><td>etm+ (landsat7) band 2 green (508nm - 617nm)</td></tr>
630 <tr><td>63</td><td>etm+ (landsat7) band 3 red (625nm - 702nm)</td></tr>
631 <tr><td>64</td><td>etm+ (landsat7) band 4 NIR (753nm - 910nm)</td></tr>
632 <tr><td>65</td><td>etm+ (landsat7) band 5 SWIR (1520nm - 1785nm)</td></tr>
633 <tr><td>66</td><td>etm+ (landsat7) band 7 SWIR (2028nm - 2375nm)</td></tr>
634 <tr><td>67</td><td>etm+ (landsat7) band 8 PAN (505nm - 917nm)</td></tr>
635
636 <tr><td>68</td><td><b>liss</b> (IRC 1C) band 2 (0.502-0.620)</td></tr>
637 <tr><td>69</td><td>liss (IRC 1C) band 3 (0.612-0.700)</td></tr>
638 <tr><td>70</td><td>liss (IRC 1C) band 4 (0.752-0.880)</td></tr>
639 <tr><td>71</td><td>liss (IRC 1C) band 5 (1.452-1.760)</td></tr>
640
641 <tr><td>72</td><td><b>aster</b> band 1 (0.480-0.645)</td></tr>
642 <tr><td>73</td><td>aster band 2 (0.588-0.733)</td></tr>
643 <tr><td>74</td><td>aster band 3N (0.723-0.913)</td></tr>
644 <tr><td>75</td><td>aster band 4 (1.530-1.750)</td></tr>
645 <tr><td>76</td><td>aster band 5 (2.103-2.285)</td></tr>
646 <tr><td>77</td><td>aster band 6 (2.105-2.298)</td></tr>
647 <tr><td>78</td><td>aster band 7 (2.200-2.393)</td></tr>
648 <tr><td>79</td><td>aster band 8 (2.248-2.475)</td></tr>
649 <tr><td>80</td><td>aster band 9 (2.295-2.538)</td></tr>
650
651 <tr><td>81</td><td><b>avnir</b> band 1 (408nm - 517nm)</td></tr>
652 <tr><td>82</td><td>avnir band 2 (503nm - 612nm)</td></tr>
653 <tr><td>83</td><td>avnir band 3 (583nm - 717nm)</td></tr>
654 <tr><td>84</td><td>avnir band 4 (735nm - 922nm)</td></tr>
655
656 <tr><td>85</td><td><b>Ikonos</b> Green band (408nm - 642nm)</td></tr>
657 <tr><td>86</td><td>Ikonos Red band (448nm - 715nm)</td></tr>
658 <tr><td>87</td><td>Ikonos NIR band (575nm - 787nm)</td></tr>
659
660 <tr><td>88</td><td><b>RapidEye</b> Blue band (440nm - 512nm)</td></tr>
661 <tr><td>89</td><td>RapidEye Green band (515nm - 592nm)</td></tr>
662 <tr><td>90</td><td>RapidEye Red band (628nm - 687nm)</td></tr>
663 <tr><td>91</td><td>RapidEye Red edge band (685nm - 735nm)</td></tr>
664 <tr><td>92</td><td>RapidEye NIR band (750nm - 860nm)</td></tr>
665
666 <tr><td>93</td><td><b>VGT1 (SPOT4)</b> band 0 (420nm - 497nm)</td></tr>
667 <tr><td>94</td><td>VGT1 (SPOT4) band 2 (603nm - 747nm)</td></tr>
668 <tr><td>95</td><td>VGT1 (SPOT4) band 3 (740nm - 942nm)</td></tr>
669 <tr><td>96</td><td>VGT1 (SPOT4) MIR band (1540nm - 1777nm)</td></tr>
670
671 <tr><td>97</td><td><b>VGT2 (SPOT5)</b> band 0 (423nm - 492nm)</td></tr>
672 <tr><td>98</td><td>VGT2 (SPOT5) band 2 (600nm - 737nm)</td></tr>
673 <tr><td>99</td><td>VGT2 (SPOT5) band 3 (745nm - 945nm)</td></tr>
674 <tr><td>100</td><td>VGT2 (SPOT5) MIR band (1523nm - 1757nm)</td></tr>
675
676 <tr><td>101</td><td><b>WorldView2</b> Panchromatic band (448nm - 812nm)</td></tr>
677 <tr><td>102</td><td>WorldView2 Coastal Blue band (395nm - 457nm)</td></tr>
678 <tr><td>103</td><td>WorldView2 Blue band (440nm - 517nm)</td></tr>
679 <tr><td>104</td><td>WorldView2 Green band (503nm - 587nm)</td></tr>
680 <tr><td>105</td><td>WorldView2 Yellow band (583nm - 632nm)</td></tr>
681 <tr><td>106</td><td>WorldView2 Red band (623nm - 695nm)</td></tr>
682 <tr><td>107</td><td>WorldView2 Red edge band (698nm - 750nm)</td></tr>
683 <tr><td>108</td><td>WorldView2 NIR1 band (760nm - 905nm)</td></tr>
684 <tr><td>109</td><td>WorldView2 NIR2 band (853nm - 1047nm)</td></tr>
685
686 <tr><td>110</td><td><b>QuickBird</b> Panchromatic band (385nm - 1060nm)</td></tr>
687 <tr><td>111</td><td>QuickBird Blue band (420nm - 585nm)</td></tr>
688 <tr><td>112</td><td>QuickBird Green band (448nm - 682nm)</td></tr>
689 <tr><td>113</td><td>QuickBird Red band (560nm - 747nm)</td></tr>
690 <tr><td>114</td><td>QuickBird NIR1 band (650nm - 935nm)</td></tr>
691
692 <tr><td>115</td><td><b>Landsat 8</b> Coastal aerosol band (433nm - 455nm)</td></tr>
693 <tr><td>116</td><td>Landsat 8 Blue band (448nm - 515nm)</td></tr>
694 <tr><td>117</td><td>Landsat 8 Green band (525nm - 595nm)</td></tr>
695 <tr><td>118</td><td>Landsat 8 Red band (633nm - 677nm)</td></tr>
696 <tr><td>119</td><td>Landsat 8 Panchromatic band (498nm - 682nm)</td></tr>
697 <tr><td>120</td><td>Landsat 8 NIR band (845nm - 885nm)</td></tr>
698 <tr><td>121</td><td>Landsat 8 Cirrus band (1355nm - 1390nm)</td></tr>
699 <tr><td>122</td><td>Landsat 8 SWIR1 band (1540nm - 1672nm)</td></tr>
700 <tr><td>123</td><td>Landsat 8 SWIR2 band (2073nm - 2322nm)</td></tr>
701
702 <tr><td>124</td><td><b>GeoEye 1</b> Panchromatic band (448nm - 812nm)</td></tr>
703 <tr><td>125</td><td>GeoEye 1 Blue band (443nm - 525nm)</td></tr>
704 <tr><td>126</td><td>GeoEye 1 Green band (503nm - 587nm)</td></tr>
705 <tr><td>127</td><td>GeoEye 1 Red band (653nm - 697nm)</td></tr>
706 <tr><td>128</td><td>GeoEye 1 NIR band (770nm - 932nm)</td></tr>
707
708 <tr><td>129</td><td><b>Spot6</b> Blue band (440nm - 532nm)</td></tr>
709 <tr><td>130</td><td>Spot6 Green band (515nm - 600nm)</td></tr>
710 <tr><td>131</td><td>Spot6 Red band (610nm - 710nm)</td></tr>
711 <tr><td>132</td><td>Spot6 NIR band (738nm - 897nm)</td></tr>
712 <tr><td>133</td><td>Spot6 Pan band (438nm - 760nm)</td></tr>
713
714 <tr><td>134</td><td><b>Spot7</b> Blue band (445nm - 532nm)</td></tr>
715 <tr><td>135</td><td>Spot7 Green band (525nm - 607nm)</td></tr>
716 <tr><td>136</td><td>Spot7 Red band (610nm - 727nm)</td></tr>
717 <tr><td>137</td><td>Spot7 NIR band (745nm - 902nm)</td></tr>
718 <tr><td>138</td><td>Spot7 Pan band (443nm - 760nm)</td></tr>
719
720 <tr><td>139</td><td><b>Pleiades1A</b> Blue band (433nm - 560nm)</td></tr>
721 <tr><td>140</td><td>Pleiades1A Green band (500nm - 617nm)</td></tr>
722 <tr><td>141</td><td>Pleiades1A Red band (590nm - 722nm)</td></tr>
723 <tr><td>142</td><td>Pleiades1A NIR band (740nm - 945nm)</td></tr>
724 <tr><td>143</td><td>Pleiades1A Pan band (460nm - 845nm)</td></tr>
725
726 <tr><td>144</td><td><b>Pleiades1B</b> Blue band 438nm - 560nm)</td></tr>
727 <tr><td>145</td><td>Pleiades1B Green band (498nm - 615nm)</td></tr>
728 <tr><td>146</td><td>Pleiades1B Red band (608nm - 727nm)</td></tr>
729 <tr><td>147</td><td>Pleiades1B NIR band (750nm - 945nm)</td></tr>
730 <tr><td>148</td><td>Pleiades1B Pan band (460nm - 845nm)</td></tr>
731
732 <tr><td>149</td><td><b>Worldview3</b> Pan band (445nm - 812nm)</td></tr>
733 <tr><td>150</td><td>Worldview3 Coastal blue band (395nm - 455nm)</td></tr>
734 <tr><td>151</td><td>Worldview3 Blue band (443nm - 517nm)</td></tr>
735 <tr><td>152</td><td>Worldview3 Green band (508nm - 587nm)</td></tr>
736 <tr><td>153</td><td>Worldview3 Yellow band (580nm - 630nm)</td></tr>
737 <tr><td>154</td><td>Worldview3 Red band (625nm - 697nm)</td></tr>
738 <tr><td>155</td><td>Worldview3 Red edge band (698nm - 752nm)</td></tr>
739 <tr><td>156</td><td>Worldview3 NIR1 band (760nm - 902nm)</td></tr>
740 <tr><td>157</td><td>Worldview3 NIR2 band (855nm - 1042nm)</td></tr>
741 <tr><td>158</td><td>Worldview3 SWIR1 band (1178nm - 1242nm)</td></tr>
742 <tr><td>159</td><td>Worldview3 SWIR2 band (1545nm - 1600nm)</td></tr>
743 <tr><td>160</td><td>Worldview3 SWIR3 band (1633nm - 1687nm)</td></tr>
744 <tr><td>161</td><td>Worldview3 SWIR4 band (1698nm - 1762nm)</td></tr>
745 <tr><td>162</td><td>Worldview3 SWIR5 band (2133nm - 2195nm)</td></tr>
746 <tr><td>163</td><td>Worldview3 SWIR6 band (2170nm - 2235nm)</td></tr>
747 <tr><td>164</td><td>Worldview3 SWIR7 band (2225nm - 2295nm)</td></tr>
748 <tr><td>165</td><td>Worldview3 SWIR8 band (2283nm - 2377nm)</td></tr>
749
750 <tr><td>166</td><td><b>Sentinel2A</b> Coastal blue band B1 (430nm - 455nm)</td></tr>
751 <tr><td>167</td><td>Sentinel2A Blue band B2 (440nm - 530nm)</td></tr>
752 <tr><td>168</td><td>Sentinel2A Green band B3 (540nm - 580nm)</td></tr>
753 <tr><td>169</td><td>Sentinel2A Red band B4 (648nm - 682nm)</td></tr>
754 <tr><td>170</td><td>Sentinel2A Red edge band B5 (695nm - 712nm)</td></tr>
755 <tr><td>171</td><td>Sentinel2A Red edge band B6 (733nm - 747nm)</td></tr>
756 <tr><td>172</td><td>Sentinel2A Red edge band B7 (770nm - 795nm)</td></tr>
757 <tr><td>173</td><td>Sentinel2A NIR band B8 (775nm - 905nm)</td></tr>
758 <tr><td>174</td><td>Sentinel2A Red edge band B8A (850nm - 880nm)</td></tr>
759 <tr><td>175</td><td>Sentinel2A Water vapour band B9 (933nm - 957nm)</td></tr>
760 <tr><td>176</td><td>Sentinel2A SWIR Cirrus band B10 (1355nm - 1392nm)</td></tr>
761 <tr><td>177</td><td>Sentinel2A SWIR band B11 (1558nm - 1667nm)</td></tr>
762 <tr><td>178</td><td>Sentinel2A SWIR band B12 (2088nm - 2315nm)</td></tr>
763
764 <tr><td>179</td><td><b>Sentinel2B</b> Coastal blue band B1 (430nm - 455nm)</td></tr>
765 <tr><td>180</td><td>Sentinel2B Blue band B2 (440nm - 530nm)</td></tr>
766 <tr><td>181</td><td>Sentinel2B Green band B3 (538nm - 580nm)</td></tr>
767 <tr><td>182</td><td>Sentinel2B Red band B4 (648nm - 682nm)</td></tr>
768 <tr><td>183</td><td>Sentinel2B Red edge band B5 (695nm - 712nm)</td></tr>
769 <tr><td>184</td><td>Sentinel2B Red edge band B6 (730nm - 747nm)</td></tr>
770 <tr><td>185</td><td>Sentinel2B Red edge band B7 (768nm - 792nm)</td></tr>
771 <tr><td>186</td><td>Sentinel2B NIR band B8 (778nm - 905nm)</td></tr>
772 <tr><td>187</td><td>Sentinel2B Red edge band B8A (850nm - 877nm)</td></tr>
773 <tr><td>188</td><td>Sentinel2B Water vapour band B9 (930nm - 955nm)</td></tr>
774 <tr><td>189</td><td>Sentinel2B SWIR Cirrus band B10 (1358nm - 1397nm)</td></tr>
775 <tr><td>190</td><td>Sentinel2B SWIR band B11 (1555nm - 1667nm)</td></tr>
776 <tr><td>191</td><td>Sentinel2B SWIR band B12 (2075nm - 2300nm)</td></tr>
777
778 <tr><td>192</td><td><b>PlanetScope 0c 0d</b> Blue band B1 (440nm - 570nm)</td></tr>
779 <tr><td>193</td><td>PlanetScope 0c 0d Green band B2 (450nm - 690nm)</td></tr>
780 <tr><td>194</td><td>PlanetScope 0c 0d Red band B3 (460nm - 700nm)</td></tr>
781 <tr><td>195</td><td>PlanetScope 0c 0d NIR band B4 (770nm - 880nm)</td></tr>
782
783 <tr><td>196</td><td><b>PlanetScope 0e</b> Blue band B1 (430nm - 700nm)</td></tr>
784 <tr><td>197</td><td>PlanetScope 0e Green band B2 (450nm - 700nm)</td></tr>
785 <tr><td>198</td><td>PlanetScope 0e Red band B3 (460nm - 700nm)</td></tr>
786 <tr><td>199</td><td>PlanetScope 0e NIR band B4 (760nm - 880nm)</td></tr>
787
788 <tr><td>200</td><td><b>PlanetScope 0f 10</b> Blue band B1 (450nm - 680nm)</td></tr>
789 <tr><td>201</td><td>PlanetScope 0f 10 Green band B2 (450nm - 680nm)</td></tr>
790 <tr><td>202</td><td>PlanetScope 0f 10 Red band B3 (450nm - 680nm)</td></tr>
791 <tr><td>203</td><td>PlanetScope 0f 10 NIR band B4 (760nm - 870nm)</td></tr>
792
793 <tr><td>204</td><td><b>Worldview4</b> Pan band (424nm - 842nm)</td></tr>
794 <tr><td>205</td><td>Worldview4 Blue band (416nm - 567nm)</td></tr>
795 <tr><td>206</td><td>Worldview4 Green band (488nm - 626nm)</td></tr>
796 <tr><td>207</td><td>Worldview4 Red band (639nm - 711nm)</td></tr>
797 <tr><td>208</td><td>Worldview4 NIR1 band (732nm - 962nm)</td></tr>
798
799 <tr><td>209</td><td><b>AVIRIS</b> b1 band (365nm)</td></tr>
800 <tr><td>210</td><td>AVIRIS b2 band (375nm)</td></tr>
801 <tr><td>.</td><td>AVIRIS b. band (+10nm)</td></tr>
802 <tr><td>431</td><td>AVIRIS b223 band (2486nm)</td></tr>
803 <tr><td>432</td><td>AVIRIS b224 band (2496nm)</td></tr>
804
805 <tr><td>433</td><td><b>Hyperion</b> VNIR b8 band (427nm)</td></tr>
806 <tr><td>434</td><td>Hyperion VNIR b9 band (437.16326nm)</td></tr>
807 <tr><td>.</td><td>Hyperion VNIR b. band (+10.16326nm)</td></tr>
808 <tr><td>480</td><td>Hyperion VNIR b56 band (914.83648nm)</td></tr>
809 <tr><td>481</td><td>Hyperion VNIR b57 band (924.99974nm)</td></tr>
810
811 <tr><td>482</td><td>Hyperion SWIR b77 band (912nm)</td></tr>
812 <tr><td>483</td><td>Hyperion SWIR b78 band (922.0884nm)</td></tr>
813 <tr><td>.</td><td>Hyperion SWIR b. band (+10.0884nm)</td></tr>
814 <tr><td>627</td><td>Hyperion SWIR b223 band (2384.9064nm)</td></tr>
815 <tr><td>628</td><td>Hyperion SWIR b224 band (2394.9948nm)</td></tr>
816
817 </table>
818
819 <h2>EXAMPLES</h2>
820
821 <h3>Atmospheric correction of a Sentinel-2 band</h3>
822 <p>This example illustrates how to perform atmospheric correction of a
823 Sentinel-2 scene in the North Carolina project.
824
825 <p>Let's assume that the Sentinel-2 L1C scene
826 <em>S2A_OPER_PRD_MSIL1C_PDMC_20161029T092602_R054_V20161028T155402_20161028T155402</em>
827 was downloaded and imported with region cropping
828 (see <a href="r.import.html">r.import</a>)
829 into the <em>PERMANENT</em> mapset of the North Carolina project. The
830 computational region was set to the extent of the <em>elevation</em>
831 map in the North Carolina dataset. Now, we have 13 individual bands
832 (<em>B01-B12</em>) that we want to apply the atmospheric correction to.
833 The following steps are applied to each band separately.
834
835 <p><b>Create the parameters file for i.atcorr</b>
836 <p>In the first step we create a file containing the 6S parameters for a
837 particular scene and band. To create a 6S file, we need to obtain the
838 following information:
839 <ul>
840 <li> geometrical conditions,</li>
841 <li> moth, day, decimal hours in GMT, decimal longitude and latitude of measurement,</li>
842 <li> atmospheric model,</li>
843 <li> aerosol model,</li>
844 <li> visibility or aerosol optical depth,</li>
845 <li> mean target elevation above sea level,</li>
846 <li> sensor height and,</li>
847 <li> sensor band.</li>
848 </ul>
849
850 <ol>
851 <li><em>Geometrical conditions</em>
852 <p>For Sentinel-2A, the geometrical conditions take the value <code>25</code> and for
853 Sentinel-2B, the geometrical conditions value is <code>26</code> (See table A).
854 Our scene comes from the Sentinel-2A mission (the file name begins with
855 S2A_...).
856 <br><br>
857 <li><em>Day, time, longitude and latitude of measurement</em>
858 <p>Day and time of the measurement are hidden in the filename (i.e., the
859 second datum in the file name with format <code>YYYYMMDDTHHMMSS</code>),
860 and are also noted in the metadata file, which is included in the
861 downloaded scene (file with .xml extension). Our sample scene was taken on
862 October 28th (20161028) at 15:54:02 (155402). Note
863 that the time has to be specified in decimal hours in Greenwich Mean
864 Time (GMT). Luckily, the time in the scene name is in GMT and we can
865 convert it to decimal hours as follows: 15 + 54/60 + 2/3600 = 15.901.
866
867 <p>Longitude and latitude refer to the centre of the computational region
868 (which can be smaller than the scene), and must be in WGS84 decimal
869 coordinates. To obtain the coordinates of the centre, we can run:
870
871 <div class="code"><pre>
872 g.region -bg
873 </pre></div>
874
875 <p>The longitude and latitude of the centre are stored in <em>ll_clon</em>
876 and <em>ll_clat</em>. In our case, <code>ll_clon=-78.691</code> and
877 <code>ll_clat=35.749</code>.
878
879 <br><br>
880 <li><em>Atmospheric model</em>
881 <p>We can choose between various atmospheric models as defined at the
882 beginning of this manual. For North Carolina, we can choose <code>2 -
883 midlatitude summer</code>.
884
885 <br><br>
886 <li><em>Aerosol model</em>
887 <p>We can also choose between various aerosol models as defined at the
888 beginning of this manual. For North Carolina, we can choose <code>1 -
889 continental model</code>.
890
891 <br><br>
892 <li><em>Visibility or Aerosol Optical Depth</em>
893 <p>For Sentinel-2 scenes, the visibility is not measured, and therefore
894 we have to estimate the aerosol optical depth instead, e.g. from
895 <a href="https://aeronet.gsfc.nasa.gov">AERONET</a>. With a bit of luck,
896 you can find a station nearby your location, which measured the Aerosol
897 Optical Depth at 500 nm at the same time as the scene was taken. In our
898 case, on 28th October 2016, the <em>EPA-Res_Triangle_Pk</em> station
899 measured AOD = 0.07 (approximately).
900
901 <br><br>
902 <li><em>Mean target elevation above sea level</em>
903 <p>Mean target elevation above sea level refers to the mean elevation
904 of the computational region. You can estimate it from the digital
905 elevation model, e.g. by running:
906
907 <div class="code"><pre>
908 r.univar -g elevation
909 </pre></div>
910
911 <p>The mean elevation is stored in <em>mean</em>. In our case,
912 <code>mean=110</code>. In the 6S file it will be displayed in [-km],
913 i.e., <code>-0.110</code>.
914
915 <br><br>
916 <li><em>Sensor height</em>
917 <p>Since the sensor is on board a satellite, the sensor height will be
918 set to <code>-1000</code>.
919
920 <br><br>
921 <li><em>Sensor band</em>
922 <p>The overview of satellite bands can be found in table F (see above).
923 For Sentinel-2A, the band numbers span from 166 to 178, and for
924 Sentinel-2B, from 179 to 191.
925 </ol>
926
927 <p>Finally, here is what the 6S file would look like for Band 02 of our
928 scene. In order to use it in the <em>i.atcorr</em> module, we can save
929 it in a text file, for example <code>params_B02.txt</code>.
930 <div class="code"><pre>
931 25
932 10 28 15.901 -78.691 35.749
933 2
934 1
935 0
936 0.07
937 -0.110
938 -1000
939 167
940 </pre></div>
941
942 <p><b>Compute atmospheric correction</b>
943 <p>In the next step we run <em>i.atcorr</em> for the selected band
944 <em>B02</em> of our Sentinel 2 scene. We have to specify the following
945 parameters:
946 <ul>
947 <li><b>input</b> = raster band to be processed,</li>
948 <li><b>parameters</b> = path to 6S file created in the previous step (we could also enter the values directly),</li>
949 <li><b>output</b> = name for the output corrected raster band,</li>
950 <li><b>range</b> = from 1 to the <code>QUANTIFICATION_VALUE</code> stored in the metadata file. It is <code>10000</code> for both Sentinel-2A and Sentinel-2B.</li>
951 <li><b>rescale</b> = the output range of values for the corrected bands. This is up to the user to choose, for example: 0-255, 0-1, 1-10000.</li>
952 </ul>
953 <p>If the data is available, the following parameters can be specified
954 as well:
955 <ul>
956 <li><b>elevation</b> = raster of digital elevation model,</li>
957 <li><b>visibility</b> = raster of visibility model.</li>
958 </ul>
959
960 <p>Finally, this is how the command would look like to apply atmospheric
961 correction to band <em>B02</em>:
962
963 <div class="code"><pre>
964 i.atcorr input=B02 parameters=params_B02.txt output=B02.atcorr range=1,10000 rescale=0,255 elevation=elevation
965 </pre></div>
966
967 <p>To apply atmospheric correction to the remaining bands, only the last
968 line in the 6S parameters file (i.e., the sensor band) needs to be changed.
969 The other parameters will remain the same.
970
971 <div align="center" style="margin: 10px">
972 <a href="i_atcorr_B02_atcorr.png">
973 <img src="i_atcorr_B02_atcorr.png" width="600" height="486" alt="i.atcorr example" border="0">
974 </a><br>
975 <i>Figure: Sentinel-2A Band 02 with applied atmospheric correction (histogram equalization grayscale color scheme)</i>
976 </div>
977
978 <h3>Atmospheric correction of a Landsat-7 band</h3>
979 This example is also based on the North Carolina sample dataset (GMT -5 hours).
980 First we set the computational region to the satellite map, e.g. band 4:
981
982 <div class="code"><pre>
983 g.region raster=lsat7_2002_40 -p
984 </pre></div>
985
986 <p>It is important to verify the available metadata for the sun position
987 which has to be defined for the atmospheric correction. An option is to
988 check the satellite overpass time with sun position as reported in the
989 <a href="ftp://ftp.glcf.umd.edu/glcf/Landsat/WRS2/p016/r035/p016r035_7x20020524.ETM-EarthSat-Orthorectified/p016r035_7x20020524.met">metadata</a>
990 file (<a href="https://grassbook.org/wp-content/uploads/ncexternal/landsat/2002/p016r035_7x20020524.met">file copy</a>; North Carolina
991 sample dataset). In the case of the North Carolina sample dataset, these
992 values have been stored for each channel and can be retrieved with:
993
994 <div class="code"><pre>
995 r.info lsat7_2002_40
996 </pre></div>
997
998 In this case, we have: SUN_AZIMUTH = 120.8810347, SUN_ELEVATION = 64.7730999.
999 <p>If the sun position metadata are unavailable, we can also calculate
1000 them from the overpass time as follows
1001 (<em><a href="r.sunmask.html">r.sunmask</a></em>
1002 uses <a href="https://www.nrel.gov/grid/solar-resource/solpos.html">SOLPOS</a>):
1003
1004 <div class="code"><pre>
1005 r.sunmask -s elev=elevation out=dummy year=2002 month=5 day=24 hour=10 min=42 sec=7 timezone=-5
1006 # .. reports: sun azimuth: 121.342461, sun angle above horz.(refraction corrected): 65.396652
1007 </pre></div>
1008
1009 If the overpass time is unknown, use the
1010 <a href="https://cloudsgate2.larc.nasa.gov/cgi-bin/predict/predict.cgi">NASA LaRC Satellite Overpass Predictor</a>.
1011
1012 <h4>Convert digital numbers (DN) to radiance at top-of-atmosphere (TOA)</h4>
1013
1014 For Landsat and ASTER, the conversion can be conveniently done with
1015 <em><a href="i.landsat.toar.html">i.landsat.toar</a></em> or
1016 <em><a href="i.aster.toar.html">i.aster.toar</a></em>, respectively.
1017
1018 <p>In case of different satellites, the conversion of DN (digital number
1019 = pixel values) to radiance at top-of-atmosphere (TOA) can also be done
1020 manually, using e.g. the formula:
1021
1022 <div class="code"><pre>
1023 # formula depends on satellite sensor, see respective metadata
1024 L&lambda; = ((LMAX&lambda; - LMIN&lambda;)/(QCALMAX-QCALMIN)) * (QCAL-QCALMIN) + LMIN&lambda;
1025 </pre></div>
1026
1027 where,
1028 <ul>
1029 <li> L&lambda; = Spectral Radiance at the sensor's aperture in Watt/(meter squared * ster * &micro;m), the
1030 apparent radiance as seen by the satellite sensor;</li>
1031 <li> QCAL = the quantized calibrated pixel value in DN;</li>
1032 <li> LMIN&lambda; = the spectral radiance that is scaled to QCALMIN in watts/(meter squared * ster * &micro;m);</li>
1033 <li> LMAX&lambda; = the spectral radiance that is scaled to QCALMAX in watts/(meter squared * ster * &micro;m);</li>
1034 <li> QCALMIN = the minimum quantized calibrated pixel value (corresponding to LMIN&lambda;) in DN;</li>
1035 <li> QCALMAX = the maximum quantized calibrated pixel value (corresponding to LMAX&lambda;) in DN=255.</li>
1036 </ul>
1037
1038 LMIN&lambda; and LMAX&lambda; are the radiances related to the minimal
1039 and maximal DN value, and they are reported in the metadata file of each
1040 image. High gain or low gain is also reported in the metadata file of each
1041 satellite image. For Landsat ETM+, the minimal DN value (QCALMIN) is 1
1042 (see <a href="https://landsat.gsfc.nasa.gov/wp-content/uploads/2016/08/Landsat7_Handbook.pdf">Landsat handbook</a>, chapter 11),
1043 and the maximal DN value (QCALMAX) is 255. QCAL is the DN value for every
1044 separate pixel in the Landsat image.
1045 <p>We extract the coefficients and apply them in order to obtain the
1046 radiance map:
1047
1048 <div class="code"><pre>
1049 CHAN=4
1050 r.info lsat7_2002_${CHAN}0 -h | tr '\n' ' ' | sed 's+ ++g' | tr ':' '\n' | grep "LMIN_BAND${CHAN}\|LMAX_BAND${CHAN}"
1051 LMAX_BAND4=241.100,p016r035_7x20020524.met
1052 LMIN_BAND4=-5.100,p016r035_7x20020524.met
1053 QCALMAX_BAND4=255.0,p016r035_7x20020524.met
1054 QCALMIN_BAND4=1.0,p016r035_7x20020524.met
1055 </pre></div>
1056
1057 Conversion to radiance (this calculation is done for band 4, for the
1058 other bands, the numbers will need to be replaced with their related
1059 values):
1060
1061 <div class="code"><pre>
1062 r.mapcalc "lsat7_2002_40_rad = ((241.1 - (-5.1)) / (255.0 - 1.0)) * (lsat7_2002_40 - 1.0) + (-5.1)"
1063 </pre></div>
1064
1065 Again, the <em>r.mapcalc</em> calculation is only needed when working
1066 with satellite data other than Landsat or ASTER.
1067
1068 <h4>Create the parameters file for i.atcorr</h4>
1069
1070 The underlying 6S model is parametrized through a control file,
1071 indicated with the <b>parameters</b> option. This is a text file
1072 defining geometrical and atmospherical conditions of the satellite
1073 overpass.
1074
1075 Here we create a control file <code>icnd_lsat4.txt</code> for band 4 (NIR),
1076 based on metadata. For the overpass time, we need to define decimal
1077 hours: 10:42:07 NC local time = 10.70 decimal hours (decimal minutes:
1078 42 * 100 / 60) which is 15.70 GMT.
1079
1080 <div class="code"><pre>
1081 8 - geometrical conditions=Landsat ETM+
1082 5 24 15.70 -78.691 35.749 - month day hh.ddd longitude latitude ("hh.ddd" is in GMT decimal hours)
1083 2 - atmospheric model=midlatitude summer
1084 1 - aerosols model=continental
1085 50 - visibility [km] (aerosol model concentration)
1086 -0.110 - mean target elevation above sea level [km]
1087 -1000 - sensor on board a satellite
1088 64 - 4th band of ETM+ Landsat 7
1089 </pre></div>
1090
1091 Finally, run the atmospheric correction (-r for reflectance input map;
1092 -a for date &gt; July 2000):
1093
1094 <div class="code"><pre>
1095 i.atcorr -r -a lsat7_2002_40_rad elevation=elevation parameters=icnd_lsat4.txt output=lsat7_2002_40_atcorr
1096 </pre></div>
1097
1098 Note that the altitude value from 'icnd_lsat4.txt' file is read at the
1099 beginning to compute the initial transform. Therefore, it is necessary
1100 to provide a value that might be the mean value of the elevation model
1101 (<code>r.univar elevation</code>). For the atmospheric correction per se, the
1102 elevation values from the raster map are used.
1103 <p>Note that the process is computationally intensive. Note also, that
1104 <em>i.atcorr</em> reports solar elevation angle above horizon rather
1105 than solar zenith angle.
1106
1107 <h2>REMAINING DOCUMENTATION ISSUES</h2>
1108
1109 The influence and importance of the visibility value or map should be
1110 explained, also how to obtain an estimate for either visibility or aerosol
1111 optical depth at 550nm.
1112
1113 <h2>REFERENCES</h2>
1114
1115 <ul>
1116 <li>Vermote, E.F., Tanre, D., Deuze, J.L., Herman, M., and Morcrette, J.J., 1997,
1117 Second simulation of the satellite signal in the solar spectrum, 6S: An
1118 overview., IEEE Trans. Geosc. and Remote Sens. 35(3):675-686.</li>
1119 <!-- too new:
1120 <li> <a href="http://6s.ltdri.org/6S_code2_thinner_stuff/6S_ltdri_org_manual.htm">6S manual
1121 (new vector version; i.atcorr is based on the older scalar version)</a>
1122 at the <a href="http://6s.ltdri.org">6S homepage</a> of the Land Surface Reflectance
1123 Science Computing Facility</li>
1124 -->
1125 <li>6S Manual: <a href="http://www.rsgis.ait.ac.th/~honda/textbooks/advrs/6smanv2.0_P1.pdf">PDF1</a>,
1126 <a href="http://www.rsgis.ait.ac.th/~honda/textbooks/advrs/6smanv2.0_P2.pdf">PDF2</a>,
1127 and <a href="http://www.rsgis.ait.ac.th/~honda/textbooks/advrs/6smanv2.0_P3.pdf">PDF3</a></li>
1128 <li>RapidEye sensors have been provided by <a href="https://www.planet.com/products/rapideye/">RapidEye AG, Germany</a></li>
1129 <li>Barsi, J.A., Markham, B.L. and Pedelty, J.A., 2011, The operational
1130 land imager: spectral response and spectral uniformity., Proc. SPIE 8153,
1131 81530G; doi:10.1117/12.895438</li>
1132 </ul>
1133
1134 <h2>SEE ALSO</h2>
1135
1136 GRASS Wiki page about <a href="https://grasswiki.osgeo.org/wiki/Atmospheric_correction">Atmospheric correction</a>
1137 <p>
1138 <em>
1139 <a href="i.aster.toar.html">i.aster.toar</a>,
1140 <a href="i.colors.enhance.html">i.colors.enhance</a>,
1141 <a href="i.landsat.toar.html">i.landsat.toar</a>,
1142 <a href="r.info.html">r.info</a>,
1143 <a href="r.mapcalc.html">r.mapcalc</a>,
1144 <a href="r.univar.html">r.univar</a>
1145 </em>
1146
1147 <h2>AUTHORS</h2>
1148
1149 <p><em>Original version of the program for GRASS 5:</em>
1150 <br>Christo Zietsman, 13422863(at)sun.ac.za
1151
1152 <p><em>Code clean-up and port to GRASS 6.3, 15.12.2006:</em>
1153 <br>Yann Chemin, ychemin(at)gmail.com
1154
1155 <p><em>Documentation clean-up + IRS LISS sensor addition 5/2009:</em>
1156 <br>Markus Neteler, FEM, Italy
1157
1158 <p><em>ASTER sensor addition 7/2009:</em>
1159 <br>Michael Perdue, Canada
1160
1161 <p><em>AVNIR, IKONOS sensors addition 7/2010:</em>
1162 <br>Daniel Victoria, Anne Ghisla
1163
1164 <p><em>RapidEye sensors addition 11/2010:</em>
1165 <br>Peter L&ouml;we, Anne Ghisla
1166
1167 <p><em>VGT1 and VGT2 sensors addition from <a href="https://web.archive.org/web/20120207042414/http://6s.ltdri.org/">6SV-1.1 sources</a>, addition 07/2011:</em>
1168 <br>Alfredo Alessandrini, Anne Ghisla
1169
1170 <p><em>Added Landsat 8 from <a href="https://web.archive.org/web/20200616045331/https://landsat.gsfc.nasa.gov/preliminary-spectral-response-of-the-operational-land-imager-in-band-band-average-relative-spectral-response/">NASA sources</a>, addition 05/2014:</em>
1171 <br>Nikolaos Ves
1172
1173 <p><em>Geoeye1 addition 7/2015:</em>
1174 <br>Marco Vizzari
1175
1176 <p><em>Worldview3 addition 8/2016:</em>
1177 <br>Markus Neteler, mundialis.de, Germany
1178
1179 <p><em>Sentinel-2A addition 12/2016:</em>
1180 <br>Markus Neteler, mundialis.de, Germany
1181
1182 <p><em>Sentinel-2B addition 1/2018:</em>
1183 <br>Stefan Blumentrath, Zofie Cimburova, Norwegian Institute for Nature Research, NINA, Oslo, Norway
1184
1185 <p><em>Worldview4 addition 12/2018:</em>
1186 <br>Markus Neteler, mundialis.de, Germany
1187
1188 <p><em>AVIRIS/Hyperion addition 11/2023:</em>
1189 <br>Yann Chemin, SOPHIA Engineering, FR