~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to imagery/i.modis.qc/i.modis.qc.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>i.modis.qc</em> extracts Requested Quality Assessment flags from the
 
4
following MODIS products: MOD09A1, MOD09Q1, MOD11A1, MOD11A2, MOD13A2,
 
5
MCD43B2. This does include MOD09A1 QA_state_500m layer (see Notes).
 
6
 
 
7
<pre>
 
8
<em>MOD09A1/Q1: MODLAND QA Bits. bits=[0-1]</em>
 
9
</pre>
 
10
<ul>
 
11
 <li>[00]= class 0: Corrected product produced at ideal quality -- all bands</li>
 
12
 <li>[01]= class 1: Corrected product produced at less than ideal quality -- some or all bands</li>
 
13
 <li>[10]= class 2: Corrected product NOT produced due to cloud effect -- all bands</li>
 
14
 <li>[11]= class 3: Corrected product NOT produced due to other reasons --
 
15
 some or all bands maybe be fill value (Note that a value of [11] overrides a value of [01])</li>
 
16
</ul>
 
17
 
 
18
<pre>
 
19
<em>MOD09Q1: Cloud State. bits=[2-3] </em>
 
20
</pre>
 
21
<ul>
 
22
 <li>[00]= class 0: Clear -- No clouds</li>
 
23
 <li>[01]= class 1: Cloudy</li>
 
24
 <li>[10]= class 2: Mixed</li>
 
25
 <li>[11]= class 3: Not Set ; Assumed Clear</li>
 
26
</ul>
 
27
 
 
28
<pre>
 
29
<em>MOD09Q1: Band-wise Data Quality 250m bits=[4-7][8-11]</em>
 
30
<em>MOD09A1: Band-wise Data Quality 500m bits=[2-5][6-9][10-13][14-17][18-21][22-25][26-29]</em>
 
31
</pre>
 
32
<ul>
 
33
 <li>[0000]= class 0: highest quality</li>
 
34
 <li>[0111]= class 1: noisy detector</li>
 
35
 <li>[1000]= class 2: dead detector; data interpolated in L1B</li>
 
36
 <li>[1001]= class 3: solar zenith &ge; 86 degrees</li>
 
37
 <li>[1010]= class 4: solar zenith &ge; 85 and &lt; 86 degrees</li>
 
38
 <li>[1011]= class 5: missing input</li>
 
39
 <li>[1100]= class 6: internal constant used in place of climatological data for at least one atmospheric constant</li>
 
40
 <li>[1101]= class 7: correction out of bounds, pixel constrained to extreme allowable value</li>
 
41
 <li>[1110]= class 8: L1B data faulty</li>
 
42
 <li>[1111]= class 9: not processed due to deep ocean or cloud</li>
 
43
 <li>Class 10-15: Combination of bits unused</li>
 
44
</ul>
 
45
 
 
46
<pre>
 
47
<em>MOD09A1/Q1: Atmospheric correction bit=[12]/[30]</em>
 
48
</pre>
 
49
<ul>
 
50
 <li>[0]= class 0: Not Corrected product</li>
 
51
 <li>[1]= class 1: Corrected product</li>
 
52
</ul>
 
53
 
 
54
<pre>
 
55
<em>MOD09A1/Q1: Adjacency correction bit=[13]/[31]</em>
 
56
</pre>
 
57
<ul>
 
58
 <li>[0]= class 0: Not Corrected product</li>
 
59
 <li>[1]= class 1: Corrected product</li>
 
60
</ul>
 
61
 
 
62
<pre>
 
63
<em>MOD09Q1: Different orbit from 500m product, bit=[14]</em>
 
64
</pre>
 
65
<ul>
 
66
 <li>[0]= class 0: same orbit as 500m</li>
 
67
 <li>[1]= class 1: different orbit from 500m</li>
 
68
</ul>
 
69
 
 
70
<pre>
 
71
<em>MOD11A1: Mandatory QA Flags bits=[0-1]</em>
 
72
</pre>
 
73
<ul>
 
74
 <li>[00]= class 0: LST produced, good quality, not necessary to examine more detailed QA</li>
 
75
 <li>[01]= class 1: LST produced, other quality, recommend examination of more detailed QA</li>
 
76
 <li>[10]= class 2: LST not produced due to cloud effects</li>
 
77
 <li>[11]= class 3: LST not produced primarily due to reasons other than cloud</li>
 
78
</ul>
 
79
 
 
80
<pre>
 
81
<em>MOD11A1: Data Quality Flag bits=[2-3]</em>
 
82
</pre>
 
83
<ul>
 
84
 <li>[00]= class 0: Good data quality of L1B in bands 31 and 32</li>
 
85
 <li>[01]= class 1: Other quality data</li>
 
86
 <li>[10]= class 2: TBD</li>
 
87
 <li>[11]= class 3: TBD</li>
 
88
</ul>
 
89
 
 
90
<pre>
 
91
<em>MOD11A1: Emis Error Flag bits=[4-5]</em>
 
92
</pre>
 
93
<ul>
 
94
 <li>[00]= class 0: Average emissivity error &le; 0.01</li>
 
95
 <li>[01]= class 1: Average emissivity error &le; 0.02</li>
 
96
 <li>[10]= class 2: Average emissivity error &le; 0.04</li>
 
97
 <li>[11]= class 3: Average emissivity error &gt; 0.04</li>
 
98
</ul>
 
99
 
 
100
<pre>
 
101
<em>MOD11A1: LST Error Flag bits=[6-7]</em>
 
102
</pre>
 
103
<ul>
 
104
 <li>[00]= class 0: Average LST error &le; 1</li>
 
105
 <li>[01]= class 1: Average LST error &le; 2</li>
 
106
 <li>[10]= class 2: Average LST error &le; 3</li> 
 
107
 <li>[11]= class 3: Average LST error &gt; 3</li>
 
108
</ul>
 
109
<pre>
 
110
 
 
111
<em>MOD11A2: Mandatory QA Flags bits=[0-1]</em>
 
112
</pre>
 
113
<ul>
 
114
 <li>[00]= class 0: LST produced, good quality, not necessary to examine more detailed QA</li>
 
115
 <li>[01]= class 1: LST produced, other quality, recommend examination of more detailed QA</li>
 
116
 <li>[10]= class 2: LST not produced due to cloud effects</li>
 
117
 <li>[11]= class 3: LST not produced primarily due to reasons other than cloud</li>
 
118
</ul>
 
119
 
 
120
<pre>
 
121
<em>MOD11A2: Data Quality Flag bits=[2-3]</em>
 
122
</pre>
 
123
<ul>
 
124
 <li>[00]= class 0: Good data quality of L1B in 7 TIR bands</li>
 
125
 <li>[01]= class 1: Other quality data</li>
 
126
 <li>[10]= class 2: TBD</li>
 
127
 <li>[11]= class 3: TBD</li>
 
128
</ul>
 
129
 
 
130
<pre>
 
131
<em>MOD11A2: Emis Error Flag bits=[4-5]</em>
 
132
</pre>
 
133
<ul>
 
134
 <li>[00]= class 0: Average emissivity error &le; 0.01</li>
 
135
 <li>[01]= class 1: Average emissivity error &le; 0.02</li>
 
136
 <li>[10]= class 2: Average emissivity error &le; 0.04</li>
 
137
 <li>[11]= class 3: Average emissivity error &gt; 0.04</li>
 
138
</ul>
 
139
 
 
140
<pre>
 
141
<em>MOD11A2: LST Error Flag bits=[6-7]</em>
 
142
</pre>
 
143
<ul>
 
144
 <li>[00]= class 0: Average LST error &le; 1</li>
 
145
 <li>[01]= class 1: Average LST error &le; 2</li>
 
146
 <li>[10]= class 2: Average LST error &le; 3</li> 
 
147
 <li>[11]= class 3: Average LST error &gt; 3</li>
 
148
</ul>
 
149
 
 
150
<pre>
 
151
<em>MOD09A1s: Cloud State bits=[0-1]</em>
 
152
</pre>
 
153
<ul>
 
154
 <li>[00]= class 0: clear</li>
 
155
 <li>[01]= class 1: cloudy</li>
 
156
 <li>[10]= class 2: mixed</li>
 
157
 <li>[11]= class 3: not set, assumed clear</li>
 
158
</ul>
 
159
 
 
160
<pre>
 
161
<em>MOD09A1s: Cloud shadow bits=[2]</em>
 
162
</pre>
 
163
<ul>
 
164
 <li>[0]= class 0: no</li>
 
165
 <li>[1]= class 1: yes</li>
 
166
</ul>
 
167
 
 
168
<pre>
 
169
<em>MOD09A1s: Land/Water Flag bits=[3-5]</em>
 
170
</pre>
 
171
<ul>
 
172
 <li>[000]= class 0: Shallow ocean</li>
 
173
 <li>[001]= class 1: Land</li>
 
174
 <li>[010]= class 2: Ocean coastlines and lake shorelines</li>
 
175
 <li>[011]= class 3: Shallow inland water</li>
 
176
 <li>[100]= class 4: Ephemeral water</li>
 
177
 <li>[101]= class 5: Deep inland water</li>
 
178
 <li>[110]= class 6: Continental/moderate ocean</li>
 
179
 <li>[111]= class 7: Deep ocean</li>
 
180
</ul>
 
181
 
 
182
<pre>
 
183
<em>MOD09A1s: Aerosol Quantity bits=[6-7]</em>
 
184
</pre>
 
185
<ul>
 
186
 <li>[00]= class 0: Climatology</li>
 
187
 <li>[01]= class 1: Low</li>
 
188
 <li>[10]= class 2: Average</li>
 
189
 <li>[11]= class 3: High</li>
 
190
</ul>
 
191
 
 
192
<pre>
 
193
<em>MOD09A1s: Cirrus detected bits=[8-9]</em>
 
194
</pre>
 
195
<ul>
 
196
 <li>[00]= class 0: None</li>
 
197
 <li>[01]= class 1: Small</li>
 
198
 <li>[10]= class 2: Average</li>
 
199
 <li>[11]= class 3: High</li>
 
200
</ul>
 
201
 
 
202
<pre>
 
203
<em>MOD09A1s: Internal Cloud Algorithm Flag bits=[10]</em>
 
204
</pre>
 
205
<ul>
 
206
 <li>[0]= class 0: No cloud</li>
 
207
 <li>[1]= class 1: Cloud</li>
 
208
</ul>
 
209
 
 
210
<pre>
 
211
<em>MOD09A1s: Internal Fire Algorithm Flag bits=[11]</em>
 
212
</pre>
 
213
<ul>
 
214
 <li>[0]= class 0: No fire</li>
 
215
 <li>[1]= class 1: Fire</li>
 
216
</ul>
 
217
 
 
218
<pre>
 
219
<em>MOD09A1s: MOD35 snow/ice flag bits=[12]</em>
 
220
</pre>
 
221
<ul>
 
222
 <li>[0]= class 0: No</li>
 
223
 <li>[1]= class 1: Yes</li>
 
224
</ul>
 
225
 
 
226
<pre>
 
227
<em>MOD09A1s: Pixel adjacent to cloud bits=[13]</em>
 
228
</pre>
 
229
<ul>
 
230
 <li>[0]= class 0: No</li>
 
231
 <li>[1]= class 1: Yes</li>
 
232
</ul>
 
233
 
 
234
<pre>
 
235
<em>MOD09A1s: BRDF correction performed bits=[14]</em>
 
236
</pre>
 
237
<ul>
 
238
 <li>[0]= class 0: No</li>
 
239
 <li>[1]= class 1: Yes</li>
 
240
</ul>
 
241
 
 
242
<pre>
 
243
<em>MOD09A1s: Internal Snow Mask bits=[15]</em>
 
244
</pre>
 
245
<ul>
 
246
 <li>[0]= class 0: No snow</li>
 
247
 <li>[1]= class 1: Snow</li>
 
248
</ul>
 
249
 
 
250
<pre>
 
251
<em>MOD13A2: Mandatory QA Flags 1km bits[0-1]</em>
 
252
</pre>
 
253
<ul>
 
254
 <li>[00]= class 0: VI produced, good quality</li>
 
255
 <li>[01]= class 1: VI produced, but check other QA</li>
 
256
 <li>[10]= class 2: Pixel produced, but most probably cloud</li>
 
257
 <li>[11]= class 3: Pixel not produced due to other reasons than clouds</li>
 
258
</ul>
 
259
 
 
260
<pre>
 
261
<em>MOD13A2: VI Usefulness Flag bits[2-5]</em>
 
262
</pre>
 
263
<ul>
 
264
 <li>[0000]= class 0: Highest quality</li>
 
265
 <li>[0001]= class 1: Lower quality</li>
 
266
 <li>[0010]= class 2: Decreasing quality</li>
 
267
 <li>[0100]= class 3: Decreasing quality</li>
 
268
 <li>[1000]= class 4: Decreasing quality</li>
 
269
 <li>[1001]= class 5: Decreasing quality</li>
 
270
 <li>[1010]= class 6: Decreasing quality</li>
 
271
 <li>[1100]= class 7: Lowest quality</li>
 
272
 <li>[1101]= class 8: Quality so low that it is not useful</li>
 
273
 <li>[1110]= class 9: L1B data faulty</li>
 
274
 <li>[1111]= class 10: Not useful for any other reason/not processed</li>
 
275
</ul>
 
276
 
 
277
<pre>
 
278
<em>MOD13A2: Aerosol quantity Flags 1km bits[6-7]</em>
 
279
</pre>
 
280
<ul>
 
281
 <li>[00]= class 0: Climatology</li>
 
282
 <li>[01]= class 1: Low</li>
 
283
 <li>[10]= class 2: Average</li>
 
284
 <li>[11]= class 3: High</li>
 
285
</ul>
 
286
 
 
287
<pre>
 
288
<em>MOD13A2: Adjacent cloud detected 1km bit[8]</em>
 
289
</pre>
 
290
<ul>
 
291
 <li>[00]= class 0: No</li>
 
292
 <li>[01]= class 1: Yes</li>
 
293
</ul>
 
294
 
 
295
<pre>
 
296
<em>MOD13A2: Atmosphere BRDF correction performed 1km bit[9]</em>
 
297
</pre>
 
298
<ul>
 
299
 <li>[00]= class 0: No</li>
 
300
 <li>[01]= class 1: Yes</li>
 
301
</ul>
 
302
 
 
303
<pre>
 
304
<em>MOD13A2: Mixed clouds 1km bit[10]</em>
 
305
</pre>
 
306
<ul>
 
307
 <li>[00]= class 0: No</li>
 
308
 <li>[01]= class 1: Yes</li>
 
309
</ul>
 
310
 
 
311
<pre>
 
312
<em>MOD13A2: Land/Water Flags 1km bits[11-13]</em>
 
313
</pre>
 
314
<ul>
 
315
 <li>[000]= class 0: Shallow Ocean</li>
 
316
 <li>[001]= class 1: Land (Nothing else but land)</li>
 
317
 <li>[010]= class 2: Ocean Coastlines and lake shorelines</li>
 
318
 <li>[011]= class 3: Shallow inland water</li>
 
319
 <li>[100]= class 4: Ephemeral water</li>
 
320
 <li>[101]= class 5: Deep inland water</li>
 
321
 <li>[110]= class 6: Moderate or continental ocean</li>
 
322
 <li>[111]= class 7: Deep ocean</li>
 
323
</ul>
 
324
 
 
325
<pre>
 
326
<em>MOD13A2: Possible Snow/Ice 1km bits[14]</em>
 
327
</pre>
 
328
<ul>
 
329
 <li>[0]= class 0: No</li>
 
330
 <li>[1]= class 1: Yes</li>
 
331
</ul>
 
332
 
 
333
<pre>
 
334
<em>MOD13A2: Possible Shadow 1km bits[15]</em>
 
335
</pre>
 
336
<ul>
 
337
 <li>[0]= class 0: No</li>
 
338
 <li>[1]= class 1: Yes</li>
 
339
</ul> 
 
340
 
 
341
 
 
342
<pre>
 
343
<em>MCD43B2: Albedo Quality Ancillary Platform Data 1km bits[0-3]</em>
 
344
<em>SDS: BRDF_Albedo_Ancillary</em>
 
345
</pre>
 
346
<ul>
 
347
 <li>[0000]= class 0: Satellite Platform: Terra</li>
 
348
 <li>[0001]= class 1: Satellite Platform: Terrra/Aqua</li>
 
349
 <li>[0010]= class 2: Satellite Platform: Aqua</li>
 
350
 <li>[1111]= class 15: Fill Value</li>
 
351
 <li>Classes 3-14: Not used</li>
 
352
</ul>
 
353
 
 
354
<pre>
 
355
<em>MCD43B2: Albedo Quality Ancillary Land/Water Data 1km bits[4-7]</em>
 
356
<em>SDS: BRDF_Albedo_Ancillary</em>
 
357
</pre>
 
358
<ul>
 
359
 <li>[0000] class 0: Shallow Ocean</li>
 
360
 <li>[0001] class 1: Land (Nothing else but land)</li>
 
361
 <li>[0010] class 2: Ocean and lake shorelines</li>
 
362
 <li>[0011] class 3: Shallow inland water</li>
 
363
 <li>[0100] class 4: Ephemeral water</li>
 
364
 <li>[0101] class 5: Deep inland water</li>
 
365
 <li>[0110] class 6: Moderate or continental ocean</li>
 
366
 <li>[0111] class 7: Deep ocean</li>
 
367
 <li>[1111] class 15: Fill Value</li>
 
368
 <li>Classes 8-14: Not used</li>
 
369
</ul>
 
370
 
 
371
<pre>
 
372
<em>MCD43B2: Albedo Quality Ancillary Sun Zenith Angle at Local Solar Noon Data 1km bits[8-14]</em>
 
373
<em>SDS: BRDF_Albedo_Ancillary</em>
 
374
</pre>
 
375
<ul>
 
376
   Returns integer value [0-90], 127 is Fill Value
 
377
</ul>
 
378
 
 
379
 
 
380
<pre>
 
381
<em>MCD43B2: Band-wise Albedo Quality Data 1km</em>
 
382
<em>SDS: BRDF_Albedo_Band_Quality</em>
 
383
</pre>
 
384
bits[0-3][4-7][8-11][12-15][16-19][20-23][24-27]<br>
 
385
<ul>
 
386
 <li>[0000]= class 0: best quality, 75% or more with best full inversions</li>
 
387
 <li>[0001]= class 1: good quality, 75% or more with full inversions</li>
 
388
 <li>[0010]= class 2: Mixed, 50% or less full inversions and 25% or less fill values</li> 
 
389
 <li>[0011]= class 3: All magnitude inversions or 50% or less fill values</li> 
 
390
 <li>[0100]= class 4: 75% or more fill values</li> 
 
391
 <li>Classes 5-14: Not Used</li>
 
392
 <li>[1111]= class 15: Fill Value</li>
 
393
</ul>
 
394
 
 
395
 
 
396
<h2>NOTES</h2>
 
397
In MOD09A1: It seems that cloud related info is not filled properly in the
 
398
standard QC (MOD09A1 in this module) since version 3, State-QA 500m images
 
399
(MOD09A1s in this module) should be used (see Vermote et al., 2008).
 
400
 
 
401
<h2>TODO</h2>
 
402
Add more daily products.
 
403
 
 
404
<h2>SEE ALSO</h2>
 
405
 
 
406
<em>
 
407
<a href="i.vi.html">i.vi</a>
 
408
</em>
 
409
 
 
410
<h2>REFERENCES</h2>
 
411
 
 
412
<ul>
 
413
<li> <a href="https://lpdaac.usgs.gov/products/modis_products_table">MODIS Products</a>
 
414
<li> Vermote E.F., Kotchenova S.Y., Ray J.P. MODIS Surface Reflectance User's Guide. 
 
415
 Version 1.2. June 2008. MODIS Land Surface Reflectance Science Computing Facility.
 
416
 <a href="http://modis-sr.ltdri.org">Homepage</a>
 
417
</ul>
 
418
 
 
419
<h2>AUTHOR</h2>
 
420
Yann Chemin
 
421
 
 
422
<p>
 
423
<i>Last changed: $Date: 2014-12-12 00:16:30 +0100 (Fri, 12 Dec 2014) $</i>