Monthly Product (08_M3) File Format Basics
MODIS Atmosphere Monthly (08_M3) product files are stored in Hierarchical Data Format (HDF). HDF is a multi-object file format for sharing scientific data in multi-platform distributed environments. HDF files should only be accessed through HDF library subroutine and function calls, which can be downloaded from the HDF web site.
Each of the global gridded statistical fields within the HDF file is stored as a Scientific Data Set (SDS). L3 Atmosphere products contain hundreds of 1°×1° global gridded Scientific Data Sets (SDSs) or statistics derived from up to 31 consecutive days of the Daily (08_D3) product. (The Daily product is derived from L2 products of Aerosol (04_L2), Water Vapor (05_L2), Cloud (06_L2), and Atmospheric Profile (07_L2)). The grid domain or size is 360x180 pixels, which corresponds to 360 degrees of longitude and 180 degrees of latitude.
There are a number of general L3 Monthly algorithm characteristics:
- Only the L3 Daily files are used as input. (Greatly improves algorithm efficiency.)
- L3 Daily and L3 Multiday HDF files use an identical grid, SDS dimensions, and histogram bin definitions. (This is an algorithm requirement.)
- There is no “valid range” check, only “Fill_Value” L3 Daily (08_D3) grid cells are universally excluded from L3 Multiday statistics.
One of three weighting schemes are used to compute Monthly statistics from Daily statistics:
- Unweighted, where each L3 Daily grid cell is given equal weight in the L3 Multiday mean. This is a simple time-averaged mean, useful for computing such things as temperature averages over a multi-day period.
- Pixel Count Weighted, where each L3 Daily grid cell is weighted by the valid L2 Pixel Counts in that grid. This is a count-averaged mean that ensures computed means match means computed from histograms -- useful for example, for cloud optical properties.
- Min Num Days (Aerosol derived products only), where each L3 Daily grid cell is given equal weight in the L3 Multiday mean, however there is a requirement that at least three (3) days have a valid data value. This is a simple time-averaged mean, but requires at least 3 days to have valid data. This is a new weighting scheme implemented in Collection 061 (6.1), it's useful for computing Aerosol statistics over a monthly period, which minimized cloud and snow/ice contamination of the Monthly Aerosol statistics.
Monthly Product File (08_M3) Parameter List (primary parameters only)
Parameters derived from the L2 Aerosol (04_L2) Product
|Aerosol Combined Ocean and Land|
|Scattering_Angle||Derived from the 04_L2 SDS "Scattering_Angle".|
|Aerosol_Optical_Depth_Land_Ocean||Derived from the 04_L2 SDS "Optical_Depth_Land_And_Ocean". Note that the land part of this SDS is taken from the 04_L2 SDS Corrected_Optical_Depth_Land at 0.55 microns and the ocean part of this SDS is taken from the 04_L2 SDS Effective_Optical_Depth_Best_Ocean (a parameter that is not propagated into L3 by itself).|
|Aerosol Land Only|
|Aerosol_Optical_Depth_Land||Derived from the 04_L2 SDS "Corrected_Optical_Depth_Land". Three solutions (computed at 0.47, 0.55, and 0.66 microns) are retained. Note that this parameter group contains three joint histograms for optical depth computed using 0.47 vs. 0.55 microns, 0.47 vs. 0.66 microns, and 0.55 vs. 0.66 microns.|
|Aerosol Ocean Only|
|Aerosol_Optical_Depth_Average_Ocean||Derived from the 04_L2 SDS "Effective_Optical_Depth_Average_Ocean".|
|Aerosol_Optical_Depth_Small_Ocean||Derived from the 04_L2 SDS "Optical_Depth_Ratio_Small_Ocean_0.55micron". Only the L2 "best" solution is retained in L3. The "average" solution is computed in L2 but not propagated to L3.|
|Aerosol_PSML003_Ocean||Derived from the 04_L2 SDS "Cloud_Condensation_Nuclei_Ocean".|
|Aerosol_Optical_Depth_by_models_ocean||Derived from the 04_L2 SDS "Optical_Depth_by_models_ocean". The parameter has solutions at 9 models.|
|AEROSOL: DEEP BLUE ()|
|Deep_Blue_Aerosol_Optical_Depth_Land||Derived from the 04_L2 SDS "Deep_Blue_Aerosol_Optical_Depth_Land ".|
|AOD_550_Dark_Target_Deep_Blue_Combined||Derived from the 04_L2 SDS "". Combines Dark Target and Deep Blue Aerosol.|
Parameters derived from the L2 Water Vapor (05_L2) Product
|Derived from the 05_L2 SDS "Water_Vapor_Near_Infrared" and aggregated into a clear or cloud category from the 05_L2 SDS "Quality_Assurance_Near_Infrared".|
Parameters derived from the L2 Cloud (06_L2) Product
|Derived from the 06_L2 SDS "Cirrus_Reflectance" and aggregated into a cirrus or contrail category from the 06_L2 SDS "Cirrus_Reflectance_Flag".|
|Derived from the 06_L2 SDS "Cirrus_Reflectance_Flag" and aggregated into a cirrus or contrail category from the 06_L2 SDS "Cirrus_Reflectance_Flag". This flag differentiates between BadData, Non-Cirrus, Cirrus, or Contrail at 1km resolution.|
|Cloud Top Properties|
|Derived from the 06_L2 SDS "Cloud_Top_Temperature" and aggregated into Day or Night categories from the 06_L2 SDS "Cloud_Mask_5km".|
|Derived from the 06_L2 SDS "Cloud_Top_Pressure" and aggregated into Day or Night categories from the 06_L2 SDS "Cloud_Mask_5km".|
|Derived from the 06_L2 SDS "Cloud_Top_Height" and aggregated into Day or Night categories from the 06_L2 SDS "Cloud_Mask_5km".|
|Derived from the 06_L2 SDS "Cloud_Effective_Emissivity" and aggregated into Day or Night categories from the 06_L2 SDS "Cloud_Mask_5km".|
|Derived from the 06_L2 SDS "Cloud_Phase_Infrared" and aggregated into Day or Night categories from the 06_L2 SDS "Cloud_Mask_5km". The bins of the Histogram Counts statistic corresponds to clear (1st bin), liquid water clouds (2nd bin), ice clouds (3rd bin), undetermined phase clouds (4th bin). (Note there are no mixed phase clouds in C6 and later).|
|This is the primary L3 Cloud Fraction parameter from Cloud Mask. This is derived from the 06_L2 SDS "Cloud_Fraction" and aggregated into Day or Night categories using the day/night flag from the 06_L2 SDS "Cloud_Mask_5km".|
|Derived from the Cirrus and High Cloud Flags in the 06_L2 SDS "Quality_Assurance_5km". The numbers computed are actually ratios of cirrus clouds (or high clouds) to all clouds. They are not true cloud fractions, where clear sky pixels are accounted for in the denominator. (Note that in the upcoming Collection 006, these numbers will change to true cloud fractions where clear sky pixels will be accounted for in the denominator.)|
|Cloud Optical Properties|
|Derived from the 06_L2 SDS "Cloud_Optical_Thickness" and aggregated into Cloud Phase categories (liquid water, ice, undetermined, & combined) using the Primary Cloud Retrieval Phase Flag from the 06_L2 SDS "Quality_Assurance_1km". Note that the liquid water and ice cloud parameters contain joint histograms vs. Cloud Effective Radius, vs. Cloud Top Temperature, vs. Cloud Top Pressure, & vs. Cloud Effective Emissivity (for ice clouds only)|
|Derived from the 06_L2 SDS "Cloud_Effective_Radius" and aggregated into Cloud Phase categories (liquid water, ice, undetermined, & combined) using the Primary Cloud Retrieval Phase Flag from the 06_L2 SDS "Quality_Assurance_1km". Note that the liquid water and ice cloud parameters contain joint histograms vs. Cloud Top Temperature & vs. Cloud Top Pressure|
|Derived from the 06_L2 SDS "Cloud_Water_Path" and aggregated into Cloud Phase categories (liquid water, ice, undetermined, & combined) using the Primary Cloud Retrieval Phase Flag from the 06_L2 SDS "Quality_Assurance_1km".|
|This is the Cloud Fraction (really the successful cloud retrieval fraction) from the Cloud Optical Properties retrieval aggregated into Cloud Phase categories: liquid water, ice, undetermined, combined from the 06_L2 SDS "Quality_Assurance_1km". The SDS's are an interpretation of the Primary Cloud Retrieval Phase Flag (cloud optical properties decision tree outcome) determined from the Cloud Mask, IR and SWIR tests, which is read from the 06_L2 SDS "Quality_Assurance_1km".|
Parameters derived from the L2 Profiles (07_L2) Product
|Total_Ozone||Derived from the 07_L2 SDS "Total_Ozone".|
|Total_Totals||Derived from the 07_L2 SDS "Total_Totals".|
|Lifted_Index||Derived from the 07_L2 SDS "Lifted_Index".|
|K_Index||Derived from the 07_L2 SDS "K_Index".|
|Derived from the 07_L2 SDS's "Water_Vapor, "Water_Vapor_Low", and "Water_Vapor_High", respectively. The keywords "Low" and "High" refer to the lower and higher portions of the atmospheric column. Note that the parameter "Water Vapor" is also refered to as "Precipitable Water".|
Monthly Product (08_M3) Statistic List
A number of statistical summaries are computed, depending on the science parameter being considered. Statistics for a given Level-2 measurement might include:
Simple Statistics of the Mean
Mean of the Standard Deviation
QA Weighted Statistics
Histograms of the quantity within each grid box
Histograms of the confidence placed in each measurement
Mean and Standard Deviation of the Fraction of pixels that satisfy some condition (e.g. cloudy, clear)
Total number of observations (pixels) within each grid box
Parameters of Log-Normal Distributions
Parameters of QA Weighted Log-Normal Distributions
Regressions and/or Histograms derived from comparing one science parameter to another, statistics may be computed for a subset that satisfies some condition
Monthly Product (08_M3) Statistic Computation Details
Below are more details on the computation of each statistic:
For the multiday product, assume that x1, x2, ..., xn represent the L3 Daily value of a parameter over a 1 x 1 degree grid box, wi is the weighting factor (1 for the unweighted case and the pixel count value for the pc-weighted case), then the simple statistics are defined as:
In these equations, (1) will be referred to as the 'regular' mean, (2) not computed in the multiday, (3) as the regular standard deviation, (4) not computed in the multiday, (5) as the minimum, and (6) as the maximum.
The simple statistics also include daily log regular mean, log standard deviation, log QA mean, and log QA standard deviation. These log quantities are calculated as shown in equations (1) and (3), except that x1, x2, ..., xn are replaced by their logarithms.
The histograms and joint histograms report the counts of the pixels falling into predetermined numerical intervals.
The pixel counts are used to represent the number of pixels for the parameters which do not have QA flags, while the confidence-histograms-counts are used to represent the number of counts for each parameter that falls within each QA bin (e.g., questionable, good, very good, and total).