MOD09 UserGuide v1 3 PDF
MOD09 UserGuide v1 3 PDF
MOD09 UserGuide v1 3 PDF
Version 1.3
February, 2011
Table of Contents
2
List of Tables
3
1. Product description
MOD09 (MODIS Surface Reflectance) is a seven-band product computed from the MODIS Level
1B land bands 1 (620-670 nm), 2 (841-876 nm), 3 (459-479), 4 (545-565 nm), 5 (1230-1250 nm), 6
(1628-1652 nm), and 7 (2105-2155 nm). The product is an estimate of the surface spectral reflectance
for each band as it would have been measured at ground level as if there were no atmospheric scatter-
ing or absorption. It corrects for the effects of atmospheric gases and aerosols.
The advantage of level 3 data over less processed forms of data is that each pixel of L3 data is pre-
cisely geolocated; a disadvantage is that the process of compositing or averaging that results in L3 data
limits the usefulness of the L3 product. The Level 2G format, consisting of gridded Level 2 data, was
developed as a means of separating geolocating from compositing and averaging. The L2G format
preserves all the data that maps to a given pixel as observations at that pixel. Programs which produce
level 3 data can then have all available data at each pixel to choose from, without having to geolocate
everything themselves. An additional step of processing, level 2G-lite, provides a minimal level of
compositing of daily level 2G data.
4
Table 1: Inputs and outputs of MODIS surface reflectance programs.
input output
program file level res. publically not publical- level res. collection
available ly available
MOD_PR09.exe MOD021KM 1B 1 MOD09 2 1,H,Q all
MOD02HKM 1B H MOD09IDT 3 5 4 and up
MOD02QKM 1B Q MOD09IDN 3 5 4 and up
MOD03 1A 1 MOD09IDS 3 5 4 and up
MOD35_L2 2 1
MOD_PRMGR.exe MOD09 2 1,H,Q MOD09GHK none 2G H all
MOD09GQK 2G Q all
MOD09GST 2G 1 all
MOD_PR09A.exe MOD09GHK 2G H MOD09A1 none 3 H up to/and 4
MOD09GQK 2G Q MOD09Q1 3 Q up to/and 4
MOD09GST 2G 1
MOD_PR09G.exe MOD09GHK 2G H MOD09GA none 2GL 1,H 5 and up
MOD09GQK 2G Q MOD09GQ 2GL Q 5 and up
MOD09GST 2G 1
where '2GL' stands for level 2G-lite and resolutions (res.) are 5, 0.05, Q, 250 m, H, 500 m, and 1, 1 km..
Please note:
1) A collection is a MODIS data archive that has been reprocessed in order to incorporate better cali-
bration, algorithm refinements, and improved upstream products into all MODIS products. The cur-
rent collection is 5. Later collections supersede all earlier collections.
2) This table focuses upon MOD09-related products, and for purposes of clarity omits pointer files,
coarse-resolution files, browse files, ancillary data files, destriped L1B input files, subsets, et cetera.
3) The "MOD" prefix should be taken as referring to the dataset in general, not to Terra-derived data in
particular. All programs discussed in this document process either Terra- or Aqua-derived data. All
datasets referred to in this document will be referred to as "MOD" data, but meaning either Terra- or
Aqua-derived data.
Please also note that not all MOD09 products are publically available. This User's Guide is meant to
be a guide for the use of publically available MOD09 products, so it is the publically available prod-
ucts that are described here in detail. Other products are described for the sake of completeness (e. g.,
the MOD09IDN, -IDT and -IDS products).
The level 2 MOD09 output includes all corrected bands and band quality data, as well as aerosol re-
trieval data and data for assessing the quality of the aerosol retrieval algorithm (brightness temperature
data from thermal bands 20, 31 and 32, water vapor data, path radiance data, et cetera). Data is written
to the output files as Scientific Data Sets (SDSs). One additional data set of importance is the 1 km
State QA SDS. While band quality SDSs contain information about the quality of the atmospheric cor-
rection of each pixel, the State QA SDS contains information about the pixel's state -- that is, characte-
ristics of each pixel that are not dependent upon band or resolution. Each State QA pixel contains data
such as whether the pixel has been flagged as land, deep ocean, shallow ocean, or as containing cloud,
high aerosol, low aerosol, snow, or fire. State QA data reflects the qualities of the pixel itself, not the
quality of any of the surface reflectance data.
One other output of MOD_PR09.exe are the MOD09 Intermediate Surface Reflectance datasets
(MOD09IDN, -IDT and -IDS), in which all surface reflectance data and band quality data for each or-
bit is geolocated into a linear latitude and longitude projection at 5 km (0.05) resolution. Data in
these files is averaged. These files are intermediate in the sense that they serve as inputs to
MOD_PR09C.exe, which composites MOD09IDN, -IDT and -IDS files for each orbit into daily
MOD09CMG and MOD09CMA files.
6
Figure 1. The MODIS sinusoidal grid consists of 460 nonoverlapping tiles which measure approximately 10 x 10. Data
from an example tile (tile h11v05, derived from MOD09A1.A2000337.h11v05.005.2006342055602.hdf) is shown as a
RGB-image.
The resulting data can be conceived of as forming a three-dimensional cube, with its depth determined
by the number of observations at each pixel. The L2G data is written to output files in two parts: the
first part consisting of "first layer" data, data at zero depth in the cube, as a 2-dimensional SDSs; and
the second part as either "full format" data (the rest of the observations as 3-dimensional SDSs) or as
"compact format" data (the rest of the observations with all fill values removed and written as one-
dimensional SDSs). The format operationally generated is the compact format.
The level 2G output includes MOD09GHK (500 m surface reflectance and band quality data),
MOD09GQK (250 m surface reflectance and band quality data), and MOD09GST (1 km State QA da-
ta). These datasets were archived until collection 5, when they were superseded by level 2G-lite prod-
ucts (see below). Apart from having been geolocated, the 1 km State QA dataset is identical to the
State QA in MOD09 files.
7
All data in input files that map to a given pixel are called observations. The MOD_PR09A compositing
process selects the best observation for each pixel. The criteria for selection include observational
coverage and view angle, and whether the observation is flagged as cloudy, clear, containing high
aerosol or low aerosol, or in cloud shadow.
1) Observations from the same orbit are composited by observational coverage. Observations with the
highest coverage are saved, and the rest discarded. This yields a list of one observation from each or-
bit.
2) Each orbit's observation is then assigned a score, based upon whether it is flagged for cloud, cloud
shadow, high aerosol or low aerosol, or contains high view angle or low solar zenith angle. The lowest
score, 0, is assigned to observations with fill values for data. The remaining scores are
The observation with the highest score and the lowest view angle is selected for the MOD09A1 and
MOD09Q1 outputs.
The MOD09A1 outputs also contain a 500 m version of the 1 km State QA composited from all 8-day
inputs.
9
3. Detailed product descriptions
3.1. Description and Science Data Sets (Collection 5)
3.1.1. MOD09
MODIS Terra/Aqua Surface Reflectance 5-minute L2 Swath
10
(620-670 nm) integer
250m Surface Reflectance Band 2: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(841-876 nm) integer
250m Reflectance Band Quality 16-bit un-
Bit Field 2995 NA NA
(see Table 13) signed integer
500m Surface Reflectance Band 1: 16-bit signed
500 m Reflectance -28672 -100 - 16000 0.0001
(620-670 nm) integer
500m Surface Reflectance Band 2: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(841-876 nm) integer
500m Surface Reflectance Band 3: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(459-479 nm) integer
500m Surface Reflectance Band 4: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(545-565 nm) integer
500m Surface Reflectance Band 5 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(1230-1250 nm) integer
500m Surface Reflectance Band 6: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(1628-1652 nm) integer
500m Surface Reflectance Band 7: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(2105-2155 nm) integer
500m Reflectance Band Quality 32-bit un-
Bit Field 3 NA NA
(see Table 15) signed integer
1km Surface Reflectance Band 1: 16-bit signed
1 km Reflectance -28672 -100 - 16000 0.0001
(620-670 nm) integer
1km Surface Reflectance Band 2: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(841-876 nm) integer
1km Surface Reflectance Band 3: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(459-479 nm) integer
1km Surface Reflectance Band 4: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(545-565 nm) integer
1km Surface Reflectance Band 5 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(1230-1250 nm) integer
1km Surface Reflectance Band 6: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(1628-1652 nm) integer
1km Surface Reflectance Band 7: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(2105-2155 nm) integer
1km Surface Reflectance Band 8: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(405-420 nm) integer
1km Surface Reflectance Band 9: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(438-448 nm) integer
1km Surface Reflectance Band 10: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(483-493 nm) integer
1km Surface Reflectance Band 11: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(526-536 nm) integer
11
1km Surface Reflectance Band 12: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(546-556 nm) integer
1km Surface Reflectance Band 13: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(662-672 nm) integer
1km Surface Reflectance Band 14: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(673-683 nm) integer
1km Surface Reflectance Band 15: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(743-753 nm) integer
1km Surface Reflectance Band 16: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(862-877 nm) integer
16-bit un-
BAND20: (3.66-3.84 m) Degrees K 0 0 - 33300 0.01
signed integer
1km Surface Reflectance Band 26: 16-bit signed
Reflectance -28672 -100 - 16000 0.0001
(1.36-1.39 m) integer
16-bit un-
BAND31: (10.78-11.284 m) Degrees K 0 0 - 33300 0.01
signed integer
16-bit un-
BAND32: (11.77-12.27 m) Degrees K
signed integer
0 0 - 33300 0.01
12
3.1.2. MOD09GQ
MODIS Terra/Aqua Surface Reflectance Daily L2G Global
250 m
13
3.1.3. MOD09GA
MODIS Terra/Aqua Surface Reflectance Daily L2G Global 500 m and 1 km
Table 4. Science Data Sets for MOD09GA. (Only 2-dimensional SDSs are listed.)
Data Science Data Sets Scale Fac-
Units Data Type Fill Value Valid Range
Group (HDF Layers (21)) tor
num_observations_1km: 8-bit signed
1 km none -1 0 - 127 NA
Number of Observations integer
State_1km: Reflectance 16-bit unsigned
Bit Field 65535 NA NA
Data State (see Table 16) integer
16-bit signed
Sensor Zenith Angle Degree -32767 0 - 18000 0.01
integer
16-bit signed
Sensor Azimuth Angle Degree -32767 -18000 - 18000 0.01
integer
16-bit unsigned
Range: pixel to sensor Meter 65535 27000 - 65535 0.04
integer
16-bit signed
Solar Zenith Angle Degree -32767 0 - 18000 0.01
integer
16-bit signed
Solar Azimuth Angle Degree -32767 -18000 - 18000 0.01
integer
gflags: Geolocation flags Bit Field
8-bit unsigned
255 0 - 248 NA
(see Table 19) integer
8-bit signed
orbit_pnt: Orbit Pointer none -1 0 - 15 NA
integer
14
8-bit signed
500 m num_observations_500m none -1 0 - 127 NA
integer
sur_refl_b01: 500m Surface
16-bit signed
Reflectance Band 1 (620- Reflectance -28672 -100 - 16000 0.0001
integer
670 nm)
sur_refl_b02: 500m Surface
16-bit signed
Reflectance Band 2 (841- Reflectance -28672 -100 - 16000 0.0001
integer
876 nm)
sur_refl_b03: 500m Surface
16-bit signed
Reflectance Band 3 (459- Reflectance -28672 -100 - 16000 0.0001
integer
479 nm)
sur_refl_b04: 500m Surface
16-bit signed
Reflectance Band 4 (545- Reflectance -28672 -100 - 16000 0.0001
integer
565 nm)
sur_refl_b05: 500m Surface
16-bit signed
Reflectance Band 5 (1230- Reflectance -28672 -100 - 16000 0.0001
integer
1250 nm)
sur_refl_b06: 500m Surface
16-bit signed
Reflectance Band 6 (1628- Reflectance -28672 -100 - 16000 0.0001
integer
1652 nm)
sur_refl_b07: 500m Surface
16-bit signed
Reflectance Band 7 (2105- Reflectance -28672 -100 - 16000 0.0001
integer
2155 nm)
QC_500m: 500m Reflec-
32-bit unsigned
tance Band Quality (see Bit Field 787410671 NA NA
integer
Table 15)
Obs_cov_500m: Observa- 8-bit signed
Percent -1 0 - 100 0.01
tion coverage integer
iobs_res: Observation num- 8-bit unsigned
none 255 0 - 254 NA
ber integer
q_scan: 250m scan value 8-bit unsigned
none 255 0 - 255 NA
information (see Table 20) integer
15
3.1.4. MOD09Q1
MODIS Terra/Aqua Surface Reflectance 8-Day L3 Global 250 m
16
3.1.5. MOD09A1
MODIS Terra/Aqua Surface Reflectance 8-Day L3 Global 500 m
Product description: MOD09A1 provides MODIS band 1-7 surface reflectance at 500 m resolution.
It is a level-3 composite of 500 m resolution MOD09GA. Each
product pixel contains the best possible L2G observation dur-
ing an 8-day period as selected on the basis of high observa-
tion coverage, low view angle, absence of clouds or cloud sha-
dow, and aerosol loading.
17
3.1.6. MOD09CMG
MODIS Terra/Aqua Surface Reflectance Daily L3 Global 0.05 Deg CMG
Product description: MOD09CMG provides MODIS band 1-7 surface reflectance at 0.05-degree res-
olution. This product is based on a Climate Modeling Grid (CMG) for the purpose of being used in
climate simulation models.
18
integer
Coarse Resolution Relative Azimuth 16-bit signed
Degree 0 -18000 - 18000 0.01
Angle integer
8-bit unsigned
Coarse Resolution Ozone cm atm 0 0 -255 0.0025
integer
Coarse Resolution Brightness Tempera- 16-bit unsigned
degrees K 0 0 - 40000 0.01
ture Band 20 (3.360-3.840 m) integer
Coarse Resolution Brightness Tempera- 16-bit unsigned
degrees K 0 0 - 40000 0.01
ture Band 21 (3.929-3.989 m) integer
Coarse Resolution Brightness Tempera- 16-bit unsigned
degrees K 0 0 - 40000 0.01
ture Band 31 (10.780-11.280 m) integer
Coarse Resolution Brightness Tempera- 16-bit unsigned
degrees K 0 0 - 40000 0.01
ture Band 32 (11.770-12.270 m) integer
Coarse Resolution Granule Time HHMM 16-bit integer 0 0 - 2355 1
16-bit signed
Coarse Resolution Band 3 Path Radiance Reflectance -28672 -100 - 16000 0.0001
integer
32-bit unsigned
Coarse Resolution QA (see Table 15) Bit Field 0 NA NA
integer
Coarse Resolution Internal CM (see Ta- 16-bit unsigned
Bit Field 0 NA NA
ble 18) integer
Coarse Resolution State QA (see Table 16-bit unsigned
Bit Field 0 NA NA
16) integer
8-bit unsigned
Number of Pixels Averaged unitless 0 1 - 40 NA
integer
19
3.2. Description and Science Data Sets (Collection 4)
3.2.1. MOD09GQK
MODIS Terra/Aqua Surface Reflectance Daily L2G Global 250 m
20
3.2.2. MOD09GHK
MODIS Terra/Aqua Surface Reflectance Daily L2G Global 500 m
Product description: MOD09GHK provides surface reflectance data at 250 m resolution for bands 1-
2 and at 500 m resolution for bands 3-7. The best observa-
tions during a 24-hour period, as determined by overall pixel
quality and observational coverage, are matched geographi-
cally according to corresponding 500 m Pointer Files
(MODPTHKM; see Section 7). Quality information for this
product is provided at three different levels of detail: for in-
dividual pixels, for each band and each resolution, and for
the whole file.
Table 9. Science Data Sets for MOD09GHK. (Only 2-dimensional SDSs are listed.)
Science Data Sets
Units Data Type Fill Value Valid Range Scale Factor
(HDF Layers (10))
250m Surface Reflectance
Reflectance 16-bit signed integer -28672 -100 - 16000 0.0001
Band 1 (620-670 nm)
250m Surface Reflectance
Reflectance 16-bit signed integer -28672 -100 - 16000 0.0001
Band 2 (841-876 nm)
500m Surface Reflectance
Reflectance 16-bit signed integer -28672 -100 - 16000 0.0001
Band 3 (459-479 nm)
500m Surface Reflectance
Reflectance 16-bit signed integer -28672 -100 - 16000 0.0001
Band 4 (545-565 nm)
500m Surface Reflectance
Reflectance 16-bit signed integer -28672 -100 - 16000 0.0001
Band 5 (1230-1250 nm)
500m Surface Reflectance
Reflectance 16-bit signed integer -28672 -100 - 16000 0.0001
Band 6 (1628-1652 nm)
500m Surface Reflectance
Reflectance 16-bit signed integer -28672 -100 - 16000 0.0001
Band 7 (2105-2155 nm)
500m Reflectance Band 32-bit unsigned in-
Bit field 787410671 NA NA
Quality (see Table 15) teger
Orbit and coverage (see Ta-
Bit field 8-bit unsigned integer 15 0 - 255 NA
ble 21)
Number of Observations NA 8-bit signed integer -1 0 - 127 NA
21
3.2.3. MOD09Q1
MODIS Terra/Aqua Surface Reflectance 8-Day L3 Global 250 m
22
3.2.4. MOD09A1
MODIS Terra/Aqua Surface Reflectance 8-Day L3 Global 500 m
23
3.2.5 MOD09GST
MODIS Terra/Aqua Surface Reflectance Quality Daily L2G Global 1 km
Product description: MOD09GST is a restructured version of the State QA quality data in level 2 sur-
face reflectance. It summarizes the status of each pixel, specifically containing information pertaining
to cloud and cloud shadow, land and water designations, aerosol quantity, and the results of fire and
snow detection algorithms.
Table 12. Science Data Sets for MOD09GST. (Only 2-dimensional SDSs are listed.)
Science Data Sets
Units Data Type Fill Value Valid Range
(HDF Layers (3))
1km Reflectance Data State QA
Bit field 16-bit unsigned integer 65535 NA
(see Tables 16 and 17)
Orbit and coverage (see Table 21) Bit field 8-bit unsigned integer 15 0 - 255
Number of Observations NA 8-bit signed integer -1 0 - 127
24
3.3. Data product quality
3.3.1. 250 m resolution QA
Table 13. 250 m Level 2/Level 2G Surface Reflectance Band Quality Description (16-bit). Note that
bit 0 is the Least Significant Bit (LSB).
Bit Bit
Parameter Name QC_250m
No. Comb.
00 corrected product produced at ideal quality all bands
01 corrected product produced at less than ideal quality some or all bands
0-1 MODLAND QA bits 10 corrected product not produced due to cloud effects all bands
corrected product not produced due to other reasons some or all bands
11
may be fill value [Note that a value of (11) overrides a value of (01)].
00 clear
2-3 cloud state
(spare) 01 cloudy
10 mixed
11 not set; assumed clear
0000 highest quality
0111 noisy detector
1000 dead detector; data interpolated in L1B
1001 solar zenith >= 86 degrees
1010 solar zenith >= 85 and < 86 degrees
band 1 data quality
4-7 1011 missing input
four bit range
internal constant used in place of climatological data for at least one at-
1100
mospheric constant
1101 correction out of bounds, pixel constrained to extreme allowable value
1110 L1B data faulty
1111 not processed due to deep ocean or clouds
band 2 data quality
8-11 SAME AS BAND ABOVE
four bit range
25
Table 14. 250 m Level 3 Surface Reflectance Band Quality Description (16-bit). Bit 0 is LSB.
Bit Bit
Parameter Name sur_refl_qc_250m
No. Comb.
00 corrected product produced at ideal quality all bands
01 corrected product produced at less than ideal quality some or all bands
0-1 MODLAND QA bits 10 corrected product not produced due to cloud effects all bands
corrected product not produced due to other reasons some or all bands
11
may be fill value [Note that a value of (11) overrides a value of (01)].
00 clear
2-3 cloud state
(spare) 01 cloudy
10 mixed
11 not set; assumed clear
0000 highest quality
0111 noisy detector
1000 dead detector; data interpolated in L1B
1001 solar zenith >= 86 degrees
1010 solar zenith >= 85 and < 86 degrees
band 1 data quality
4-7 1011 missing input
four bit range
internal constant used in place of climatological data for at least one at-
1100
mospheric constant
1101 correction out of bounds, pixel constrained to extreme allowable value
1110 L1B data faulty
1111 not processed due to deep ocean or clouds
band 2 data quality
8-11 SAME AS BAND ABOVE
four bit range
26
3.3.2. 500 m, 1km and coarse resolution QA
Table 15. 500 m, 1 km and Coarse Resolution Surface Reflectance Band Quality Description (32-bit).
Bit 0 is LSB.
QC_500m / Coarse Resolution QA /
Bit Bit
Parameter Name surf_refl_qc_500m/ 500m Reflectance Band Quality /
No. Comb.
1km Reflectance Band Quality
00 corrected product produced at ideal quality -- all bands
corrected product produced at less than ideal quality --
01
some or all bands
0-1 MODLAND QA bits corrected product not produced due to cloud effects -- all
10
bands
corrected product not produced for other reasons -- some
11 or all bands, may be fill value (11) [Note that a value of
(11) overrides a value of (01)].
0000 highest quality
0111 noisy detector
1000 dead detector; data interpolated in L1B
1001 solar zenith >= 86 degrees
1010 solar zenith >= 85 and < 86 degrees
2-5 band 1 data quality, four bit range 1011 missing input
internal constant used in place of climatological data for at
1100
least one atmospheric constant
correction out of bounds, pixel constrained to extreme al-
1101
lowable value
1110 L1B data faulty
1111 not processed due to deep ocean or clouds
6-9 band 2 data quality four bit range same as band above
10-13 band 3 data quality four bit range same as band above
14-17 band 4 data quality four bit range same as band above
18-21 band 5 data quality four bit range same as band above
22-25 band 6 data quality four bit range same as band above
26-29 band 7 data quality four bit range same as band above
1 yes
30 atmospheric correction performed
0 no
1 yes
31 adjacency correction performed
0 no
27
3.4. Data product state flags
3.4.1. State QA (Collection 5)
Table 16. State QA description (16-bit). Bit 0 is LSB.
state_1km / Coarse Resolution State QA /
Bit No. Parameter Name Bit Comb. surf_refl_state_500m / 1km Reflectance
Data State QA
00 clear
01 cloudy
0-1 cloud state
10 mixed
11 not set, assumed clear
1 yes
2 cloud shadow
0 no
000 shallow ocean
001 land
010 ocean coastlines and lake shorelines
011 shallow inland water
3-5 land/water flag
100 ephemeral water
101 deep inland water
110 continental/moderate ocean
111 deep ocean
00 climatology
01 low
6-7 aerosol quantity
10 average
11 high
00 none
01 small
8-9 cirrus detected
10 average
11 high
1 cloud
10 internal cloud algorithm flag
0 no cloud
1 fire
11 internal fire algorithm flag
0 no fire
1 yes
12 MOD35 snow/ice flag
0 no
13 Pixel is adjacent to cloud 1 yes
28
0 no
1 yes
14 BRDF correction performed
0 no
1 snow
15 internal snow mask
0 no snow
29
3.5. Internal CM (Collection 5)
Table 18. Coarse Resolution Internal CM, 1km Atmospheric Optical Depth Band QA (16-bit). Bit 0 is
LSB.
Bit No. Description Bit Comb. state
1 yes
0 cloudy
0 no
1 yes
1 clear
0 no
1 yes
2 high clouds
0 no
1 yes
3 low clouds
0 no
1 yes
4 snow
0 no
1 yes
5 fire
0 no
1 yes
6 sun glint
0 no
1 yes
7 dust
0 no
1 yes
8 cloud shadow
0 no
1 yes
9 pixel is adjacent to cloud
0 no
00 none
01 small
10-11 cirrus
10 average
11 high
1 salt pan
12 pan flag
0 no salt pan
1 criterion 2
13 criteria used for aerosol retrieval
0 criterion 1
1 yes
14 AOT (aerosol optical thickness) has climatological values
0 no
15 Unused - -
30
3.6. Geolocation flags (Collection 5)
Table 19. 1 km Geolocation Flags (16-bit). Bit 0 is LSB.
Bit No. Description Bit Comb. state_1km
0-2 Fill 00 Fill
0 Valid
3 Sensor range validity flag
1 Invalid
0 Valid
4 Digital elevation model quality flag
1 Missing/inferior
0 Valid
5 Terrain data validity
1 Invalid
0 Valid intersection
6 Ellipsoid intersection flag
1 No intersection
0 Valid
7 Input data flag
1 Invalid
31
Note: The 250 m samples are for each of four quadrants within a 500 m cell. The first line/sample is in
the upper left (north-west) corner of the image.
range: from 0 to 13
0-3 orbit number
key: from 0000 (0) to 1011 (13)
0 top half
4 scan half flag
1 bottom half
000 0.0 12.5%
001 12.5 25.0%
010 25.0 37.5%
011 37.5 50.0%
6-7 land/water flag
100 50.0 62.5%
101 62.5 75.0%
110 75.0 87.5%
111 87.5 100.0%
Note: The orbit number is not the absolute orbit number but a relative orbit number in the file. In addi-
tion a flag is stored which distinguishes between observations which are in the top half of the scan (the
first 5 1 km scan lines in the along track direction) and the bottom half of the scan (the last 5 1 km scan
lines). The observation coverage is the area of intersection of observation footprint and cell divided by
the area of the observation.
32
4. Frequently asked questions.
4.1. How are MODLAND QA bits set, and how should they be used?
The MODLAND QA bits are bits 0 and 1 of the band quality SDS pixel values. They are meant as a
brief summary of quality control aspects of each pixel, with 00 meaning the best possible atmospher-
ic correction and any other value indicating errors or problems, and serving as a flag to check other QA
data in more detail. Although the MODLAND QA bits are still set in this manner, other band quality
bits and other QA products (e. g., the State QA) have superseded the MODLAND QA bits in impor-
tance.
a) MOD_PR09.exe processing.
In the MOD_PR09.exe program, the MODLAND QA bits are initialized to '00' and then set in three
passes:
Pass #1:
The MODLAND QA bits are set to '11' for pixels over oceans, if pixels over
oceans are not being atmospherically corrected.
or else, they are set to '10' for pixels over clouds, if pixels over clouds
are not being atmospherically corrected.
However, since at least collection 3 and up to the present, atmospheric correction is being performed
over clouds and ocean, so the MODLAND QA bits are not being set in pass #1.
In other words, the description "corrected product not produced due to cloud effects" for bits '10' in the
MODLAND QA bits is relevant only for PGEs that process cloudy pixels differently than non-cloudy
pixels; but this description is no longer relevant for PGE11, which applies an atmospheric correction
algorithm to both cloudy and non-cloudy pixels. PGE11 produces the level 2 MOD09 product from
which L2G and L3 MOD09 products are in turn produced. For MOD09 products the MODLAND QA
bits are not to be used for determining whether a pixel is cloudy or not. Other QA products (e. g., the
state QA) contain cloud information (below).
Pass #2:
The MODLAND QA bits are then set to '11' for pixels that have not been at-
mospherically corrected.
Pass #3:
Note that passes 1 and 2 are with respect to each pixel, but not with respect to each band. The next
pass goes through each band at that pixel and resolution and resets the MODLAND QA bits like this:
or '01' (if it hasn't been set to '11' already), for any band
33
that has a solar zenith angle between 85 and 86 (band quality
value 10)
in which an internal constant was used in place of climatological
data for an atmospheric constant (band quality value 12)
in which the atmospherically-corrected value is out of bounds
and has been constrained to an extreme allowable value (either
-100 or 16000) (band quality value 13)
In summary: the MODLAND QA bits default to '00' (ideal quality), are set to '01' (less than ideal
quality, some or all bands) for data corrected with an internal constant, or data constrained to extreme
allowable values, or to data at a high solar zenith angle; and are set to '11' (corrected product not pro-
duced for other reasons, some or all bands) for uncorrected data, missing L1B, faulty L1B, or data at
solar zenith angles beyond 86.
b) MOD_PRGR.exe processing.
The MOD_PRGR.exe program grids data from level 2 MOD09 files into MOD09GA and MOD09GQ
files. Regions of L2G files that are not populated with MOD09 data (e. g., missing orbits, spaces be-
tween orbits) contain fill values for reflectance data and for band quality data. In these places all band
quality data bits have a value of 1, and the MODLAND QA bits are '11'. However these regions are
clearly flagged for non-use (e. g., containing zeros in the 'num_observations' SDSs).
2) the MODLAND QA bits are also not to be taken as denoting cloud status.
They are meant to denote whether a pixel was not processed because of cloud
effects, but PGE11 has been doing atmospheric correction over clouds since
at least Collection 3. (See above.)
All cloud information should be derived from State QA SDSs, and in particular, the SDS 'state_1km' in
MOD09GA or MOD09GST files, and/or SDS 'sur_refl_state_500m' in MOD09A1 files. In these
SDSs, each pixel contains two cloud masks: one that is read from MOD35 (bits 0-1) and one that is
generated by PGE11's internal cloud algorithm (bit 10).
34
To expand the compact data to its original three-dimensional form, the compact data and the
'num_observations' SDSs must have memory allocated for them and must be read. Additionally;
1) Determine the number of additional layers in the L2G file.
This value can be read from the metadatum ADDITIONALLAYERS
in each L2G file. (In the example below, variable depth is set to that value.)
2) For each additional layer, allocate memory for the uncompacted data (variable
uncompact_data[][] below):
e. g., for integer data:
uncompact_data = (int **)malloc(depth*sizeof(int *));
for(i=0;i<depth;i++) {
uncompact_data[i] = (int *)malloc(rows*columns*sizeof(int));
}
Ancillary data is either read from coarse resolution meterological data and interpolated spatially and
temporally (surface pressure, ozone), or is calculated within MOD_PR09.exe (water vapor, aerosol
optical thickness). Aerosol optical thickness (AOT) is estimated by comparing actual corrected top-of-
atmosphere values to modeled top-of-atmosphere values with known amounts of AOT added. The de-
rived AOT is then used in a second pass of atmospheric correction.
[see also
Vermote E.F. and Saleous, N., 2006, Operational Atmospheric Correction of MODIS Visible to Mid-
dle Infrared Land Surface Data in the Case of an Infinite Lambertian Target, chapter 8 in "Earth
Science Satellite Remote Sensing, Vol. 1: Science and Instruments" John J. Qu et al., Springer Berlin
Heidelberg.
Vermote E.F., El Saleous N., Justice C., 2002, Atmospheric correction of the MODIS data in the visi-
ble to middle infrared: First results, Remote Sensing Of Environment, 83, 1-2, 97-111.
Petitcollin F. and Vermote E. F., 2002, Land Surface Reflectance, Emissivity and Temperature from
MODIS Middle and Thermal Infrared data, Remote Sensing Of Environment, 83, 1-2,112-134.]
35
4.4. What is surface reflectance? What are its units?
Surface reflectance is the amount of light reflected by the surface of the earth; it is a ratio of surface
radiance to surface irradiance, and as such is unitless, and typically has values between 0.0 and 1.0.
MOD09's surface reflectance values are scaled by 10000 and then cast to 16-bit integers, so surface
reflectance values in MOD09 files are typically between 0 and 10000. The atmospheric correction al-
gorithm that is used results in values normally between -100 and 16000. Any values outside of this
range are either uncorrected L1B data (e. g., data at high solar zenith angles) or fill values (e. g., data
between orbits in L2G or L2G-lite files).
4.5. All I've seen in this document is "MOD", meaning Terra -- what about Aqua (MYD)?
The "MOD" prefix should be taken as referring to the datasets in general, not to Terra-derived data in
particular. All programs discussed in this document process either Terra- or Aqua-derived data. All
datasets referred to in this document will be referred to as "MOD" data, but meaning either Terra- or
Aqua-derived data.
36
5. Caveats and Known Problems
The performance of the atmospheric correction algorithm degrades as the view and solar zenith angles
get larger and as aerosol optical thickness gets larger; the algorithm is also less accurate for bands at
shorter wavelengths. The level of accuracy of the atmospheric correction is typically
(0.005 + 0.05*reflectance)
under favorable conditions (not high aerosol). The look-up tables used in the atmospheric correction
algorithm also assume upper limits of 5.0 for aerosol optical thickness and 75 for solar zenith angles.
37
6.2. Data product granule ID
All archived data is accessed by its LOCALGRANULEID. For data in the sinusoidal grid, the LO-
CALGRANULEID is constructed like this:
Example 1: MOD09GHK.A2006351.h18v06.004.2006353163945.hdf
MOD09GHK: product name (MODIS Terra Surface Reflectance Daily L2G Global 500 m)
A2000351: Acquisition year (2006) and Julian day (351)
h18v06: tile ID (see figure 1)
004: Collection 4
2006353163945: Production year (2006), Julian day (353), and time (16:39:45)
For Climate Modeling Grid data (CMGs), the LOCALGRANULEID is constructed like this:
Example 2: MOD09CMG.A2000338.005.2006332091104.hdf
MOD09CMG: product name (MODIS Terra Surface Reflectance Daily L3 Global 0.05Deg. CMG)
A2000338: Acquisition year (2000) and Julian day (338)
005: Collection 5
2006332091104: Production year (2006), Julian day (332), and time (09:11:04)
38
6.3. Data viewing tools
a) Imager (platform: Linux)
A software tool specifically designed by the MODIS LSR SCF for viewing surface reflectance suites.
Link: http://modis-sr.ltdri.org/software/IMAGER.html
b) HDFLook (platforms: SUN, AIX, SGI, Linux, MacOSX, Cygwin)
A multifunctional data processing and visualization tool for land, ocean and atmosphere MODIS data.
Link: http://www-loa.univ-lille1.fr/Hdflook/hdflook_gb.html
c) ENVI (platforms: Windows & Linux)
A software for the visualization, analysis, and presentation of all types of digital imagery.
Link: http://www.ittvis.com/envi/
d) HDF Explorer (platform: Windows)
A software environment where data are first viewed in a tree-like interface, and then optionally loaded
and visualized in a variety of ways.
Link: http://www.space-research.org/
39
7. Useful links
a) 250 m Pointer Files (MODPTQKM):
Link: http://edcdaac.usgs.gov/modis/modptqkmv4.asp
b) 500 m Pointer Files (MODPTQKM):
Link: http://edcdaac.usgs.gov/modis/modptqkmv4.asp
c) Detailed description of changes in the MOD09 algorithm and other MODIS land science algorithms
at the MODIS Land Quality Assessment website:
Link: http://landweb.nascom.nasa.gov/cgi-bin/QA_WWW/newPage.cgi
d) The MODIS Land Surface Reflectance Science Computing Facilitys website:
Link: http://modis-sr.ltdri.org.
E-mail: mod09@ltdri.org
40