+=============================================================================+
| |
| L1B EV 250m File Specification -- TERRA |
| V6.1.16, 2014-01-27 |
| Effective for all higher numbered versions until superceded |
| |
+=============================================================================+
This document specifies the format for the MODIS Level 1B 250m
earth-view (EV) product. The product is implemented in an HDF file.
DETECTOR ORDER CONVENTION FOR DETECTOR DEPENDENT DATA:
The "SBRS" detector order convention refers to the numbering of detectors
on each focal plane assembly as defined by the manufacturer. In this
convention, the numbering of detectors is opposite in direction from the
satellite track direction. The "product" detector order convention is the
reverse of the SBRS convention. The product detector order convention was
defined to allow consecutive scans to be laid down on an image with the
last detector of one scan abutting the first detector of the next scan.
ALL DATA ITEMS WITHIN THIS FILE FOLLOW THE "PRODUCT" DETECTOR ORDER
CONVENTION.
+=====================================================================+
| |
| Contents: |
| |
| I) Global Metadata |
| |
| II) Instrument and Uncertainty SDSs |
| |
| III) Band-Subsetting SDSs |
| |
| IV) Geolocation SDSs |
| |
+=====================================================================+
______
/\ \ +---------------------------------------------------------------+
/ \ \| +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ |
\ \_____\ | I) Global Metadata | |
\ / / +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ |
\/_____/+---------------------------------------------------------------+
Description:
This section contains granule-level metadata (i.e. ECS metadata, product
granule metadata, QA granule metadata, HDF-EOS swath metadata, and
L1B swath metadata).
Contents:
1.1) ECS Standard Core Granule Metadata
1.2) ECS Standard Archive Granule Metadata
1.3) MODIS Level 1B Product Granule Metadata
1.4) MODIS Level 1B QA Granule Metadata
1.4.1) QA Granule Metadata stored as global attributes
1.4.2) QA Granule Metadata stored as SDSs
1.5) Level 1B HDF-EOS SWATH Metadata
1.6) Level 1B Swath Metadata
For attributes dimensioned 38 (number of bands), the band order is:
1, 2, 3, .. , 13lo, 13hi, 14lo, 14hi, 15, .. , 36.
For the reflective bands, total of 22, the order is:
1, 2, 3, .. , 13lo, 13hi, 14lo, 14hi, .. , 19, 26.
The order of the 490 detectors follows the order of the 38 bands described
earlier. Within each band, the order of detectors is product order.
+=============================================================================+
| |
| 1.1) ECS Standard Core Granule Metadata |
| Stored (as One ECS PVL String) in global attribute: CoreMetadata.0 |
| |
+=============================================================================+
| |
| Name Example |
+-----------------------------------------------------------------------------+
| LOCALGRANULEID "MOD02QKM.A1996218.1555.002. |
| 1998152115306.hdf" |
+-----------------------------------------------------------------------------+
| PRODUCTIONDATETIME "1998-06-01T15:53:08.000Z" |
+-----------------------------------------------------------------------------+
| DAYNIGHTFLAG "Day" or "Night" or "Both" |
+-----------------------------------------------------------------------------+
| REPROCESSINGACTUAL "processed once" |
+-----------------------------------------------------------------------------+
| REPROCESSINGPLANNED "no further update anticipated" |
+-----------------------------------------------------------------------------+
| SIZEMBECSDATAGRANULE (set by "DSS") |
+-----------------------------------------------------------------------------+
| AUTOMATICQUALITYFLAGEXPLANATION.1 "not being investigated" |
+-----------------------------------------------------------------------------+
| AUTOMATICQUALITYFLAG.1 "Passed" |
+-----------------------------------------------------------------------------+
| OPERATIONALQUALITYFLAGEXPLANATION.1 (set by "DAAC") |
+-----------------------------------------------------------------------------+
| OPERATIONALQUALITYFLAG.1 (set by "DAAC") |
+-----------------------------------------------------------------------------+
| SCIENCEQUALITYFLAGEXPLANATION.1 (set by "DP") |
+-----------------------------------------------------------------------------+
| SCIENCEQUALITYFLAG.1 "Not Investigated" |
+-----------------------------------------------------------------------------+
| QAPERCENTMISSINGDATA.1 0 |
+-----------------------------------------------------------------------------+
| QAPERCENTINTERPOLATEDDATA.1 0 |
+-----------------------------------------------------------------------------+
| QAPERCENTOUTOFBOUNDSDATA.1 0 |
+-----------------------------------------------------------------------------+
| PARAMETERNAME.1 "EV_250_RefSB" |
+-----------------------------------------------------------------------------+
| EQUATORCROSSINGDATE.1 "1996-08-05" |
+-----------------------------------------------------------------------------+
| EQUATORCROSSINGTIME.1 "15:55:45.854788" |
+-----------------------------------------------------------------------------+
| ORBITNUMBER.1 88 |
+-----------------------------------------------------------------------------+
| EQUATORCROSSINGLONGITUDE.1 -73.021282 |
+-----------------------------------------------------------------------------+
| VERSIONID 1 |
+-----------------------------------------------------------------------------+
| SHORTNAME "MOD02QKM" |
+-----------------------------------------------------------------------------+
| INPUTPOINTER "L1A_v2_10scans_0.L1A", |
| "L1A_v2_10scans_1.L1A", |
| "L1A_v2_10scans_2.L1A", |
| "Reflective_Lookup_Tables_file",|
| "Emissive_Lookup_Tables_file", |
| "QA_Lookup_Tables_file" |
+-----------------------------------------------------------------------------+
| GRINGPOINTLONGITUDE.1 (-86.567558, -59.389000, |
| -59.836601, -86.653564) |
+-----------------------------------------------------------------------------+
| GRINGPOINTLATITUDE.1 (41.644032, 37.729759, |
| 36.824055, 40.686016) |
+-----------------------------------------------------------------------------+
| GRINGPOINTSEQUENCENO.1 (1, 2, 3, 4) |
+-----------------------------------------------------------------------------+
| EXCLUSIONGRINGFLAG.1 "N" |
+-----------------------------------------------------------------------------+
| RANGEENDINGDATE "1996-08-05" |
+-----------------------------------------------------------------------------+
| RANGEENDINGTIME "15:56:00.626488" |
+-----------------------------------------------------------------------------+
| RANGEBEGINNINGDATE "1996-08-05" |
+-----------------------------------------------------------------------------+
| RANGEBEGINNINGTIME "15:55:45.854788" |
+-----------------------------------------------------------------------------+
| PGEVERSION "2.1.1" |
+-----------------------------------------------------------------------------+
| ANCILLARYINPUTPOINTER.1 "Geoloc_v2_10scans.GEO" |
+-----------------------------------------------------------------------------+
| ANCILLARYINPUTTYPE.1 "Geolocation" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.1 "AveragedBlackBodyTemperature" |
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.1 "268.90" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.2 "AveragedMirrorTemperature" |
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.2 "250.27" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.3 "AveragedFocalPlane1Temperature"|
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.3 "361.42" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.4 "AveragedFocalPlane2Temperature"|
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.4 "363.21" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.5 "AveragedFocalPlane3Temperature"|
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.5 "118.25" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.6 "AveragedFocalPlane4Temperature"|
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.6 "85.94" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.7 "CalibrationQuality" |
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.7 "marginal" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.8 "MissionPhase" |
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.8 "A&E" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.9 "NadirPointing" |
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.9 "Y" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.10 "identifier_product_doi" |
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.10 "10.5067/MODIS/MOD02QKM.006" |
+-----------------------------------------------------------------------------+
| ADDITIONALATTRIBUTENAME.11 "identifier_product_doi_authority"|
+-----------------------------------------------------------------------------+
| PARAMETERVALUE.11 "http://dx.doi.org" |
+-----------------------------------------------------------------------------+
| ASSOCIATEDPLATFORMSHORTNAME.1 "Terra" |
+-----------------------------------------------------------------------------+
| ASSOCIATEDINSTRUMENTSHORTNAME.1 "MODIS" |
+-----------------------------------------------------------------------------+
| ASSOCIATEDSENSORSHORTNAME.1 "MODIS" |
+=============================================================================+
+=============================================================================+
| |
| 1.2) ECS Standard Archive Granule Metadata |
| Stored (as HDF ECS PVL string) in global attribute: ArchiveMetadata.0 |
| |
+=============================================================================+
| |
| Name Example |
+-----------------------------------------------------------------------------+
| ALGORITHMPACKAGEACCEPTANCEDATE "1998-04-01" |
+-----------------------------------------------------------------------------+
| ALGORITHMPACKAGEMATURITYCODE "pre-launch" |
+-----------------------------------------------------------------------------+
| ALGORITHMPACKAGENAME "MODIS Level 1B Algorithm |
| Package" |
+-----------------------------------------------------------------------------+
| ALGORITHMPACKAGEVERSION "2.3.0.0" |
+-----------------------------------------------------------------------------+
| INSTRUMENTNAME "Moderate-Resolution Imaging |
| SpectroRadiometer" |
+-----------------------------------------------------------------------------+
| PROCESSINGCENTER "GSFC" |
+-----------------------------------------------------------------------------+
| EASTBOUNDINGCOORDINATE 40.000000 |
+-----------------------------------------------------------------------------+
| WESTBOUNDINGCOORDINATE 15.000000 |
+-----------------------------------------------------------------------------+
| NORTHBOUNDINGCOORDINATE 25.000000 |
+-----------------------------------------------------------------------------+
| SOUTHBOUNDINGCOORDINATE 10.000000 |
+-----------------------------------------------------------------------------+
| DESCRREVISION "4.0" |
+-----------------------------------------------------------------------------+
| PRODUCTIONHISTORY "PGE02:3.4.5.6;PGE01:3.5.8" |
+-----------------------------------------------------------------------------+
| LONGNAME "MODIS/Terra Calibrated |
| Radiances 5-Min L1B Swath 250m" |
+-----------------------------------------------------------------------------+
| PROCESSINGENVIRONMENT "IRIX64" |
+=============================================================================+
+==================================================================================+
| |
| 1.3) MODIS Level 1B Product Granule Metadata |
| Stored as global attributes. |
| |
+==================================================================================+
| | | | |
| Name | Type |Count| Example |
+------------------------------------+---------+-----+-----------------------------+
| Number of Scans | int32 | 1 | 203 (see note 1) |
+------------------------------------+---------+-----+-----------------------------+
| Number of Day mode scans | int32 | 1 | 203 |
+------------------------------------+---------+-----+-----------------------------+
| Number of Night mode scans | int32 | 1 | 0 |
+------------------------------------+---------+-----+-----------------------------+
| Incomplete Scans | int32 | 1 | 14 |
+------------------------------------+---------+-----+-----------------------------+
| Max Earth View Frames | int32 | 1 | 1354 |
+------------------------------------+---------+-----+-----------------------------+
| %Valid EV Observations | float32 | 38 | 98.2, 87.1, ... |
+------------------------------------+---------+-----+-----------------------------+
| %Saturated EV Observations | float32 | 38 | 1.4, 0.2, ... |
+------------------------------------+---------+-----+-----------------------------+
| Electronics Redundancy Vector | uint32 | 2 | (see table 1 below) |
+------------------------------------+---------+-----+-----------------------------+
| Electronics Configuration Change | uint32 | 2 | (see table 1 below) |
+------------------------------------+---------+-----+-----------------------------+
| Reflective LUT Serial Number and | char8 | 21 | "R001 1998:01:28:12:00" |
| Date of Last Change | | | (RNNN YYYY:MM:DD:HH:MM) |
+------------------------------------+---------+-----+-----------------------------+
| Emissive LUT Serial Number and | char8 | 21 | "E001 1998:01:28:12:00" |
| Date of Last Change | | | (ENNN YYYY:MM:DD:HH:MM) |
+------------------------------------+---------+-----+-----------------------------+
| QA LUT Serial Number and | char8 | 21 | "Q001 1998:01:28:12:00" |
| Date of Last Change | | | (QNNN YYYY:MM:DD:HH:MM) |
+------------------------------------+---------+-----+-----------------------------+
| Focal Plane Set Point State | int8 | 1 | 0=Running uncontrolled |
| | | | 1=Set Point is 83 deg |
| | | | 2=Set Point is 85 deg |
| | | | 3=Set Point is 88 deg |
+------------------------------------+---------+-----+-----------------------------+
| identifier_product_doi | char8 | 26 | "10.5067/MODIS/MOD02QKM.006"|
+------------------------------------+---------+-----+-----------------------------+
| identifier_product_doi_authority | char8 | 17 | "http://dx.doi.org" |
+==================================================================================+
Note 1. Usage of "Number of Scans": The value of the global attribute
"Number of Scans" is used in the dimensioning of many of the data
items within this product. In later descriptions of the dimensions
of data items, the shortened string "nscans" is used to represent
the value of the attribute "Number of Scans". This value will
typically be 203 or 204 during operations.
However, the file format supports any value greater than zero.
+============================================================================+
| Table 1. |
| "Electronics Redundancy Vector" and "Electronics Configuration Change" |
| (bit 0 is the least significant bit in the uint32 word) |
| The Electronics Redundancy Vector gives the final valid value for |
| the corresponding telemetry point within the granule. |
| Values are 0=OFF and 1=ON. |
| The Electronics Configuration Change identifies if any change occurred |
| within the granule for the corresponding telemetry point. |
| Values are 0 = no change, 1 = change. |
+----------------------------------------------------------------------------+
| Word | Bit | System | Telemetry point |
+======+=====+===========================================+===================+
| 0 | 0 | BB - Blackbody A | CR_BB_A_PWR_ON |
| 0 | 1 | BB - Blackbody B | CR_BB_B_PWR_ON |
| 0 | 2 | CE - Calibrator Electronics A | CR_CE_A_ON |
| 0 | 3 | CE - Calibrator Electronics B | CR_CE_B_ON |
| 0 | 4 | CP - Command & Telemetry Processor A | CR_CP_A_ON_M |
| 0 | 5 | CP - Command & Telemetry Processor B | CR_CP_B_ON_M |
| 0 | 6 | FI - FDDI Formatter A | CR_FI_A_ON |
| 0 | 7 | FI - FDDI Formatter B | CR_FI_B_ON |
| 0 | 8 | FO - FIFO Memory, Block 1 | CR_FO_BLK1_ON |
| 0 | 9 | FO - FIFO Memory, Block 2 | CR_FO_BLK2_ON |
| 0 | 10 | FO - FIFO Memory, Block 3 | CR_FO_BLK3_ON |
| 0 | 11 | FO - FIFO Memory, Block 4 | CR_FO_BLK4_ON |
| 0 | 12 | FR - Formatter A | CR_FR_A_ON |
| 0 | 13 | FR - Formatter B | CR_FR_B_ON |
| 0 | 14 | FR - PC DCR | CS_FR_PC_DCR_ON |
| 0 | 15 | FR - PV DCR | CS_FR_PV_DCR_ON |
| 0 | 16 | PC - PC Bands ADCs A | CR_PCLW_A_ON |
| 0 | 17 | PC - PC Bands ADCs B | CR_PCLW_B_ON |
| 0 | 18 | PV - PV FPA, LWIR ADCs A | CR_PVLW_A_ON |
| 0 | 19 | PV - PV FPA, LWIR ADCs B | CR_PVLW_B_ON |
| 0 | 20 | PV - PV FPA, SMIR ADCs A | CR_PVSM_A_ON |
| 0 | 21 | PV - PV FPA, SMIR ADCs B | CR_PVSM_B_ON |
| 0 | 22 | PV - PV FPA, NIR ADCs A | CR_PVNIR_A_ON |
| 0 | 23 | PV - PV FPA, NIR ADCs B | CR_PVNIR_B_ON |
| 0 | 24 | PV - PV FPA, VIS ADC A | CR_PVVIS_A_ON |
| 0 | 25 | PV - PV FPA, VIS ADC B | CR_PVVIS_B_ON |
| 0 | 26 | PV - PV LWIR ECAL A | CR_PVLWA_ECAL_ON |
| 0 | 27 | PV - PV LWIR ECAL B | CR_PVLWB_ECAL_ON |
| 0 | 28 | PV - PV NIR ECAL A | CR_PVNIRA_ECALON |
| 0 | 29 | PV - PV NIR ECAL B | CR_PVNIRB_ECALON |
| 0 | 30 | PV - PV SMIR ECAL A | CR_PVSMA_ECAL_ON |
| 0 | 31 | PV - PV SMIR ECAL B | CR_PVSMB_ECAL_ON |
+------+-----+-------------------------------------------+-------------------+
| 1 | 0 | PV - PV VIS ECAL A | CR_PVVISA_ECALON |
| 1 | 1 | PV - PV VIS ECAL B | CR_PVVISB_ECALON |
| 1 | 2 | RC - SMIR Temp. Control Heater | CR_RC_SMHTR_ON |
| 1 | 3 | RC - LWIR Temp. Control Heater | CR_RC_LWHTR_ON |
| 1 | 4 | SA - Scan Mirror Assembly A | CR_SA_A_SCAN_ON |
| 1 | 5 | SA - Scan Mirror Assembly B | CR_SA_B_SCAN_ON |
| 1 | 6 | SM - SD Stability Monitor A | CR_SM_SDSM_A_ON |
| 1 | 7 | SM - SD Stability Monitor B | CR_SM_SDSM_B_ON |
| 1 | 8 | SR - Spectroradiometric Assy (SRCA) A | CR_SR_A_ON |
| 1 | 9 | SR - Spectroradiometric Assy (SRCA) B | CR_SR_B_ON |
| 1 | 10 | TG - Timing Generator A | CR_TG_A_ON |
| 1 | 11 | TG - Timing Generator B | CR_TG_B_ON |
+------+-----+-------------------------------------------+-------------------+
| 1 |12-31| (Unused) |
+============================================================================+
Note: When the most significant bit of the second word is set to 1, this
denotes that at least one of the telemetry fields had no valid values found.
+=============================================================================+
| |
| 1.4) MODIS Level 1B QA Granule Metadata |
| |
+=============================================================================+
+=============================================================================+
| |
| 1.4.1) MODIS Level 1B QA Granule Metadata |
| stored as global attributes. |
| |
+=============================================================================+
| | | | |
| Name | Type |Count| Example |
+------------------------------------------+-------+-----+--------------------+
| Doors and Screens Configuration | int8 | 1 | 2 |
+------------------------------------------+-------+-----+--------------------+
| Reflective Bands With Bad Data | int8 | 22 | 1,0,0,1... |
+------------------------------------------+-------+-----+--------------------+
| Emissive Bands With Bad Data | int8 | 16 | 1,0,0,1... |
+------------------------------------------+-------+-----+--------------------+
| Noise in Black Body Thermistors | uint8 | 12 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in Average BB Temperature | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in LWIR FPA Temperature | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in MWIR FPA Temperature | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in Scan Mirror Thermistor #1 | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in Scan Mirror Thermistor #2 | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in Scan Mirror Thermistor Average | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in Instrument Temperature | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in Cavity Temperature | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in Temperature of NIR FPA | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Noise in Temperature of Vis FPA | uint8 | 1 | 10 |
+------------------------------------------+-------+-----+--------------------+
| Dead Detector List | int8 | 490 | 1=True or 0=False |
+------------------------------------------+-------+-----+--------------------+
| Noisy Detector List | int8 | 490 | 1=True or 0=False |
+------------------------------------------+-------+-----+--------------------+
| Dead Subframe List | int8 | 520 | 1=True or 0=False |
+------------------------------------------+-------+-----+--------------------+
| Noisy Subframe List | int8 | 520 | 1=True or 0=False |
+------------------------------------------+-------+-----+--------------------+
| Detector Quality Flag | uint8 | 490 | (See table below) |
+------------------------------------------+-------+-----+--------------------+
| Detector Quality Flag2 | uint8 | 180 | (See table below) |
+------------------------------------------+-------+-----+--------------------+
| Earth-Sun Distance |float32| 1 | 1.0045 |
+------------------------------------------+-------+-----+--------------------+
| Solar Irradiance on RSB Detectors over pi|float32| 330 | 511.459,511.46,... |
+------------------------------------------+-------+-----+--------------------+
| % L1A EV All Scan Data are Missing |float32| 1 | 1.301 |
+------------------------------------------+-------+-----+--------------------+
| % L1A EV RSB DN Not in Day Mode |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % L1A EV DN Missing Within Scan |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % Dead Detector EV Data |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % Dead Subframe EV Data |float32| 180 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % Sector Rotation EV Data |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % Saturated EV Data |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % TEB EV Data With Moon in SVP |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % EV Data Where Cannot Compute BG DN |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % RSB EV Data With dn** Below Scale |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % EV Data Where Nadir Door Closed |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| % EV Data Not Calibrated |float32| 490 | 1.301, 0.012, ... |
+------------------------------------------+-------+-----+--------------------+
| Bit QA Flags Last Value | uint32| 1 | 0 |
+------------------------------------------+-------+-----+--------------------+
| Bit QA Flags Change | uint32| 1 | 0 |
+------------------------------------------+-------+-----+--------------------+
| Granule Average QA Values |float32| 50 | 290.004,289.984,...|
+=============================================================================+
+================================================================+
| Detector Quality Flag |
| bitmask, each bit has value: 1=True or 0=False |
| |
| Bit | Meaning |
|======+=========================================================+
| 0 | Noisy Detector |
| (LSB)| (same value as in attribute "Noisy Detector List") |
|------+---------------------------------------------------------+
| 1 | Dead Detector |
| | (same value as in attribute "Dead Detector List") |
|------+---------------------------------------------------------+
| 2 | Out-of-Family Gain |
|------+---------------------------------------------------------+
| 3 | Dynamic Range |
|------+---------------------------------------------------------+
| 4 | Detector saturates on calibration source |
|------+---------------------------------------------------------+
| 5 | High calibration fit residuals |
|------+---------------------------------------------------------+
| 6 | Electrical Crosstalk |
|------+---------------------------------------------------------+
| 7 | TBD |
+======+=========================================================+
+================================================================+
| Detector Quality Flag2 |
| bitmask, each bit has value: 1=True or 0=False |
| |
| Bit | Meaning |
|======+=========================================================+
| 0 | Noisy Subframe 1 |
| (LSB)| |
|------+---------------------------------------------------------+
| 1 | Noisy Subframe 2 |
|------+---------------------------------------------------------+
| 2 | Noisy Subframe 3 |
|------+---------------------------------------------------------+
| 3 | Noisy Subframe 4 |
|------+---------------------------------------------------------+
| 4 | Dead Subframe 1 |
|------+---------------------------------------------------------+
| 5 | Dead Subframe 2 |
|------+---------------------------------------------------------+
| 6 | Dead Subframe 3 |
|------+---------------------------------------------------------+
| 7 | Dead Subframe 4 |
+======+=========================================================+
+=============================================================================+
| |
| 1.4.2) MODIS Level 1B QA Granule Metadata |
| stored as SDSs. |
| |
+=============================================================================+
| | | | |
| Name | Type | Dimensions | Example |
+------------------------------------+--------+------------------+------------+
| Noise in Thermal Detectors | uint8 | [16][10] | 8,6,4... |
+------------------------------------+--------+------------------+------------+
| Change in relative responses of | | | |
| thermal detectors | uint8 | [16][10] | 10,6,8... |
+------------------------------------+--------+------------------+------------+
| DC Restore Change for Thermal Bands| int8 | [nscans][16][10] | 0,0,1 ... |
+------------------------------------+--------+------------------+------------+
| DC Restore Change for Reflective | | | |
| 250m Bands | int8 | [nscans][2][40] | 0,0,1... |
+------------------------------------+--------+------------------+------------+
| DC Restore Change for Reflective | | | |
| 500m Bands | int8 | [nscans][5][20] | 0,0,1... |
+------------------------------------+--------+------------------+------------+
| DC Restore Change for Reflective | | | |
| 1km Bands | int8 | [nscans][15][10] | 0,0,1... |
+=============================================================================+
+=============================================================================+
| |
| 1.5) Level 1B HDF-EOS SWATH Metadata |
| Stored as global attribute: StructMetadata.0 |
| |
+=============================================================================+
| |
|GROUP=SwathStructure |
| GROUP=SWATH_1 |
| |
| SwathName="MODIS_SWATH_Type_L1B" |
| |
| GROUP=Dimension |
| +-------------+---------------------+-----------------+ |
| | Object | DimensionName | Size | |
| +-------------+---------------------+-----------------+ |
| | Dimension_1 | "Band_250M" | 2 | |
| | Dimension_2 | "40*nscans" | 40*nscans | |
| | Dimension_3 | "4*Max_EV_frames" | 5416 | |
| | Dimension_4 | "10*nscans" | 10*nscans | |
| | Dimension_5 | "Max_EV_frames" | 1354 | |
| +-------------+---------------------+-----------------+ |
| |
| GROUP=DimensionMap |
| +----------------+-----------------+-------------------+--------+------+ |
| | Object | GeoDimension | DataDimension | Offset | Inc. | |
| +----------------+-----------------+-------------------+--------+------+ |
| | DimensionMap_1 | "10*nscans" | "40*nscans" | 1 | 4 | |
| | DimensionMap_2 | "Max_EV_frames" | "4*Max_EV_frames" | 0 | 4 | |
| +----------------+-----------------+-------------------+--------+------+ |
| |
| GROUP=GeoField |
| +------------+-------------+--------------+------------------------------+
| | Object | GeoFieldName| DataType | DimList |
| +------------+-------------+--------------+------------------------------+
| | GeoField_1 | "Latitude" | DFNT_FLOAT32 |("10*nscans","Max_EV_frames") |
| | GeoField_2 | "Longitude" | DFNT_FLOAT32 |("10*nscans","Max_EV_frames") |
| +------------+-------------+--------------+------------------------------+
| |
| GROUP=DataField |
| +-------------+-----------------------+-------------+------------------+ |
| | Object | DataFieldName | DataType | DimList | |
| +-------------+-----------------------+-------------+------------------+ |
| | DataField_1 | "EV_250_RefSB" | DFNT_UINT16 |("Band_250M", | |
| | | | | "40*nscans", | |
| | | | |"4*Max_EV_frames")| |
| +-------------+-----------------------+-------------+------------------+ |
| | DataField_2 | "EV_250_RefSB_ | DFNT_UINT8 |("Band_250M", | |
| | | Uncert_Indexes" | | "40*nscans", | |
| | | | |"4*Max_EV_frames")| |
| +-------------+-----------------------+-------------+------------------+ |
| | DataField_3 | "Band_250M" | DFNT_FLOAT32| ("Band_250M") | |
| +-------------+-----------------------+-------------+------------------+ |
| |
+=============================================================================+
+=============================================================================+
| |
| 1.6) Level 1B Swath Metadata |
| |
| These data are stored as a single HDF Vdata table having the name |
| "Level 1B Swath Metadata". The number of records is equal to nscans |
| (determined by the "Number of Scans" global attribute). The table |
| below describes the fields of this Vdata object. |
| |
+=============================================================================+
| | | | |
| Field Name | Type |Order| Range |
+--------------------------------+---------+-----+----------------------------+
| Scan Number | int32 | 1 | 1 to 204 |
+--------------------------------+---------+-----+----------------------------+
| Complete Scan Flag | int32 | 1 | 1=Complete, 0=Incomplete |
+--------------------------------+---------+-----+----------------------------+
| Scan Type | char8 | 4 | "D "=day, |
| | | | "N "=night, |
| | | | "O "=other |
+--------------------------------+---------+-----+----------------------------+
| Mirror Side | int32 | 1 | 0 or 1 |
+--------------------------------+---------+-----+----------------------------+
| EV Sector Start Time | float64 | 1 | TAI time (number of sec. |
| | | | since 1/1/93) |
+--------------------------------+---------+-----+----------------------------+
| EV_Frames | int32 | 1 | 1354 (constant) |
+--------------------------------+---------+-----+----------------------------+
| Nadir_Frame_Number | int32 | 1 | 677 (constant) |
+--------------------------------+---------+-----+----------------------------+
| Latitude of Nadir Frame | float32 | 1 | -90.0 to 90.0 degrees |
+--------------------------------+---------+-----+----------------------------+
| Longitude of Nadir Frame | float32 | 1 | -180.0 to 180.0 degrees |
+--------------------------------+---------+-----+----------------------------+
| Solar Azimuth of Nadir Frame | float32 | 1 | -180.0 to 180.0 degrees |
+--------------------------------+---------+-----+----------------------------+
| Solar Zenith of Nadir Frame | float32 | 1 | 0.0 to 180.0 degrees |
+--------------------------------+---------+-----+----------------------------+
| No. OBC BB thermistor outliers| int32 | 1 | 0 to 12 |
+--------------------------------+---------+-----+----------------------------+
| Bit QA Flags | uint32 | 1 | (see table below) |
+--------------------------------+---------+-----+----------------------------+
| Sector Rotation Angle | float32 | 1 | 0.0 to 360.0 degrees |
+================================+=========+=====+============================+
+=============================================================================+
| |
| 1.7) Level 1B Swath Metadata Stored as global attributes. |
| |
+=============================================================================+
| |
| Name |Type |#|const|
+-------------------------------------------------------------+-------+-+-----+
| HDFEOS_FractionalOffset_40*nscans_MODIS_SWATH_Type_L1B |float32|1| 0.5 |
+-------------------------------------------------------------+-------+-+-----+
| HDFEOS_FractionalOffset_4*Max_EV_frames_MODIS_SWATH_Type_L1B|float32|1| 0.0 |
+=============================================================+=======+=+=====+
Notes
1. Scan Type has the three "extra" characters to make it a 32 bit field
(to make reading the Vdata structure easier).
2. Bit QA Flags are as follows (bit 0 is the least significant
bit in the word):
+========+==========================================+
| bit # | flag name/desciption (1=True, 0=False) |
+========+==========================================+
| bit 0 | Moon within defined limits of SVP |
+--------+------------------------------------------+
| bit 1 | Spacecraft Maneuver |
+--------+------------------------------------------+
| bit 2 | Sector Rotation |
+--------+------------------------------------------+
| bit 3 | Negative Radiance Beyond Noise Level |
+--------+------------------------------------------+
| bit 4 | PC Ecal on |
+--------+------------------------------------------+
| bit 5 | PV Ecal on |
+--------+------------------------------------------+
| bit 6 | SD Door Open |
+--------+------------------------------------------+
| bit 7 | SD Screen Down |
+--------+------------------------------------------+
| bit 8 | NAD closed |
+--------+------------------------------------------+
| bit 9 | SDSM On |
+--------+------------------------------------------+
| bit 10 | Radcooler Heaters On |
+--------+------------------------------------------+
| bit 11 | Day mode bands telemetered at night |
+--------+------------------------------------------+
| bit 12 | Linear Emissive Calibration |
+--------+------------------------------------------+
| bit 13 | DC Restore Change |
+--------+------------------------------------------+
| bit 14 | (Unused) |
+--------+------------------------------------------+
| bit 15 | BB Heater On |
+--------+------------------------------------------+
| bit 16 | Missing Previous Granule |
+--------+------------------------------------------+
| bit 17 | Missing Subsequent Granule |
+--------+------------------------------------------+
| | SRCA calibration mode |
| bits | +--------+--------+-------------+ |
| 18-19 | | bit 18 | bit 19 | Meaning | |
| | +--------+--------+-------------+ |
| | | 0 | 0 | Radiometric | |
| | | 0 | 1 | Spatial | |
| | | 1 | 0 | Spectral | |
| | | 1 | 1 | undetermined| |
| | +--------+--------+-------------+ |
+--------+------------------------------------------+
| bit 20 | moon in keep out box, any RSB |
+--------+------------------------------------------+
| bit 21 | moon in keep out box, any TEB |
+--------+------------------------------------------+
| bit 22 | All SV data are bad for any RSB |
+--------+------------------------------------------+
| bit 23 | All BB data are bad for any RSB |
+--------+------------------------------------------+
| bit 24 | Dropped scan(s) between leading and |
| | middle granules |
+--------+------------------------------------------+
| bit 25 | Dropped scan(s) between middle and |
| | trailing granules |
+--------+------------------------------------------+
| bit 26 | Sci Abnormal |
+--------+------------------------------------------+
| bit 26 | (Remaining bits reserved for |
| ... 31 | future use) |
+========+==========================================+
______
/\ \ +---------------------------------------------------------------+
/ \ \| +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ |
\ \_____\ | II) Instrument and Uncertainty SDSs | |
\ / / +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ |
\/_____/+---------------------------------------------------------------+
Description:
This section contains the scientific data sets (SDSs) in which the
"corrected count" data (scaled to 16 bit integers) is stored and the
corresponding uncertainty indices.
SDS Indexing:
Each SDS is an array through a space of five parameters: band, detector,
scan, frame and sample. However, the SDS is written as a 3-D array so
that it can be added to the HDF-EOS "SWATH" data structure:
SDS_name[band_index, scan_and_detect_index, frame_and_sample_index]
Where "band_index" represents an index through the bands represented in
the SDS, "scan_and_detect_index" represents a double index through all
detectors and scans, and "frame_and_sample_index" represents a double
index through all frames and samples in a frame. In this discussion,
an "index" assumes a convention of 0 to N-1. The following formula can
be used to obtain the scan_and_detect_index from the detector index and
the scan index:
scan_and_det_index = scan_index * num_detectors_at_resolution
+ detector_index
where num_detectors_at_resolution = 40 for SDSs in the 250m product.
Similarly, to obtain the frame_and_sample_index from the frame and
sample indices:
frame_and_sample_index = frame_index * num_samples_at_resolution
+ sample_index
where num_samples_at_resolution = 4 for SDSs in the 250m product.
Specific Data Values:
Generally, any scaled integer (SI) value above 32767 represents unusable
data. The following values are reserved for the scaled integer and the
uncertainty index (UI) to signal the reason why data are unusable:
Reason for unusable data SI UI
---------------------------------------------- ----- ----
Fill Value (includes reflective band data
at night and completely missing L1A scans) 65535 255
L1A DN is missing within a scan 65534 15
Detector is saturated 65533 15
Cannot compute zero point DN 65532 15
Detector is dead 65531* 15
RSB dn** below the minimum of the scaling range 65530 15
TEB radiance or RSB dn** exceeds the
maximum of the scaling range 65529 15
Aggregation algorithm failure 65528 15
Rotation of Earth-View Sector from
nominal science collection position 65527 15
Calibration coefficient b1 could not be computed 65526 15
Subframe is dead 65525 15
Both sides of PCLW electronics on 65524 15
(reserved for future use) 65501-65523 15
NAD closed upper limit 65500 15
* The "Dead Detector List" attribute (Section 1.4.1) identifies those
detectors that are declared non-functional (cannot be calibrated).
In collection 5, a valid SI value will be interpolated from the nearest
functional detectors within the same scan if it is possible. Otherwise
the value will be set at 65531. In collection 6, no interpolation is
performed, and the value is always set at 65531.
For the case of nadir-aperture door (NAD) closed, the SI value will be
set to a value > 32767 (denoting unusable data). First, if appropriate,
a specific unusable data value above will be assigned. If one of the
specific reasons does not apply, then the SI value will be calculated
normally and then the most significant bit will be flipped, resulting
in a value > 32767. If the resulting scaled integer value exceeds the
value of NAD closed upper limit, the value will be set to that value.
Also, for any uncertainty value other than fill-value (255), the
uncertainty is written into the 4 least significant bits of the 8-bit
UI value (hence, 15 is the maximum 4-bit number).
To compute uncertainty in percent from the uncertainty index (UI), use
the specified_uncertainty and scaling_factor for the given band in:
% uncertainty = specified_uncertainty * exp(UI/scaling_factor)
The band-dependent values of specified_uncertainty and scaling_factor
are attached as attributes to each uncertainty index SDS.
Contents:
2.1) EV_250_RefSB
2.2) EV_250_RefSB_Uncert_Indexes
+=============================================================================+
| 2.1) EV_250_RefSB |
| |
| SDS Name Data Type Dimensions |
+-----------------------------------------------------------------------------+
| "EV_250_RefSB" uint16 (Band_250M, 40*nscans, 4*Max_EV_frames) |
| |
| Description: |
| 16 bit scaled integer array containing the 250m Earth View data. |
| |
| SDS Attributes: |
| +-----------------------------+---------+-----+------------------------+
| | Attribute Name | Type |Count| Attribute Value |
| +-----------------------------+---------+-----+------------------------+
| | units | string | 1 | "none" |
| +-----------------------------+---------+-----+------------------------+
| | valid_range | uint16 | 2 | 0, 32767 |
| +-----------------------------+---------+-----+------------------------+
| | _FillValue | uint16 | 1 | 65535 |
| +-----------------------------+---------+-----+------------------------+
| | long_name | string | 1 |"Earth View 250M Reflect|
| | | | |ive Solar Bands Scaled |
| | | | |Integers" |
| +-----------------------------+---------+-----+------------------------+
| | band_names | string | 1 | "1, 2" |
| +-----------------------------+---------+-----+------------------------+
| | radiance_scales | float32 | 2 | x.f, x.f |
| +-----------------------------+---------+-----+------------------------+
| | radiance_offsets | float32 | 2 | x.f, x.f |
| +-----------------------------+---------+-----+------------------------+
| | radiance_units | string | 1 |"Watts/m^2/micrometer/st|
| | | | | eradian" |
| +-----------------------------+---------+-----+------------------------+
| | reflectance_scales | float32 | 2 | x.f, x.f |
| +-----------------------------+---------+-----+------------------------+
| | reflectance_offsets | float32 | 2 | x.f, x.f |
| +-----------------------------+---------+-----+------------------------+
| | reflectance_units | string | 1 | "none" |
| +-----------------------------+---------+-----+------------------------+
| | corrected_counts_scales | float32 | 2 | x.f, x.f |
| +-----------------------------+---------+-----+------------------------+
| | corrected_counts_offsets | float32 | 2 | x.f, x.f |
| +-----------------------------+---------+-----+------------------------+
| | corrected_counts_units | string | 1 | "counts" |
| +-----------------------------+---------+-----+------------------------+
| |
+=============================================================================+
Note: "x.f" means the value of the attribute is variable (may change from
granule to granule). The values of all other attributes are constant.
+=============================================================================+
| 2.2) EV_250_RefSB_Uncert_Indexes |
| |
| SDS Name Data Type Dimensions |
+-----------------------------------------------------------------------------+
| "EV_250_RefSB_Uncert_Indexes" uint8 (Band_250M, 40*nscans, |
| 4*Max_EV_frames) |
| |
| Description: |
| 8 bit unsigned integer array containing the uncertainty index values |
| corresponding to the 250m Earth View data stored in the "EV_250_RefSB" |
| SDS. The uncertainty index values are calculated from the percent |
| uncertainty in the reflectance product. |
| |
| SDS Attributes: |
| +--------------------------+--------+-----+----------------------------+
| | Attribute Name | Type |Count| Attribute Value |
| +--------------------------+--------+-----+----------------------------+
| | long_name | string | 1 |"Earth View 250M Reflective |
| | | | | Solar Bands Uncertainty |
| | | | | Indexes" |
| +--------------------------+--------+-----+----------------------------+
| | units | string | 1 | "none" |
| +--------------------------+--------+-----+----------------------------+
| | valid_range | uint8 | 2 | 0, 15 |
| +--------------------------+--------+-----+----------------------------+
| | _FillValue | uint8 | 1 | 255 |
| +--------------------------+--------+-----+----------------------------+
| | specified_uncertainty | float32| 2 | x.f, x.f |
| +--------------------------+--------+-----+----------------------------+
| | scaling_factor | float32| 2 | x.f, x.f |
| +--------------------------+--------+-----+----------------------------+
| | uncertainty_units | string | 1 | "percent" |
| +--------------------------+--------+-----+----------------------------+
| |
+=============================================================================+
Note: "x.f" means the value of the attribute is variable (may change from
granule to granule). The values of all other attributes are constant.
______
/\ \ +---------------------------------------------------------------+
/ \ \| +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ |
\ \_____\ | III) Band-Subsetting SDSs | |
\ / / +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ |
\/_____/+---------------------------------------------------------------+
Description:
This section contains the scientific data sets (SDSs) which hold
the information used to accomplish band subsetting. For the 250M
product, there is 1 band-subsetting SDS.
+=============================================================================+
| Band_250M |
| |
| SDS Name Data Type Dimensions |
+-----------------------------------------------------------------------------+
| "Band_250M" float32 (Band_250M) |
| |
| Description: |
| float32 array containing the band numbers used for band subsetting. |
| The values are: 1.0, 2.0 |
| |
| SDS Attributes: |
| +-----------------+---------+-----+------------------------------------+
| | Attribute Name | Type |Count| Attribute Value |
| +-----------------+---------+-----+------------------------------------+
| | long_name | string | 1 | "250M Band Numbers for Subsetting" |
| +-----------------+---------+-----+------------------------------------+
| |
+=============================================================================+
______
/\ \ +---------------------------------------------------------------+
/ \ \| +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ |
\ \_____\ | IV) Geolocation SDSs | |
\ / / +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+ |
\/_____/+---------------------------------------------------------------+
Description:
This section contains information about the geodetic position
(latitude and longitude) used for visualization.
Contents:
4.1) Latitude
4.2) Longitude
+=============================================================================+
| 4.1) Latitude |
| |
| SDS Name Data Type Dimensions |
+-----------------------------------------------------------------------------+
| "Latitude" float32 (10*nscans, Max_EV_frames) |
| |
| Description: |
| 32 bit signed floating point array containing the geodetic latitudes |
| for the center of the corresponding 1km Earth view frames. Given the |
| offset and increment defined in the DimensionMap of Section 1.5, the |
| latitude points map to Inc1*(s-1)+offset1+0.5 in track direction and |
| Inc2*(f-1)+offset2 in scan direction, where 0.5 is the fractional |
| offset defined in Section 1.7 and 's' and 'f' are scaneline and frame |
| number starting from 1. If the formula gives a value 5.5 in track |
| direction that means 1/2 between detector 5 and detector 6. (please |
| note that detector# starts from 0) |
| |
| SDS Attributes: |
| +--------------------------+--------+-----+----------------------------+
| | Attribute Name | Type |Count| Attribute Value |
| +--------------------------+--------+-----+----------------------------+
| | units | string | 1 | "degrees" |
| +--------------------------+--------+-----+----------------------------+
| | valid_range | float32| 2 | -90.0, 90.0 |
| +--------------------------+--------+-----+----------------------------+
| | _FillValue | float32| 1 | -999.9 |
| +--------------------------+--------+-----+----------------------------+
| |
+=============================================================================+
+=============================================================================+
| 4.2) Longitude |
| |
| SDS Name Data Type Dimensions |
+-----------------------------------------------------------------------------+
| "Longitude" float32 (10*nscans, Max_EV_frames) |
| |
| Description: |
| 32 bit signed floating point array containing the geodetic longitudes |
| for the center of the corresponding 1km Earth view frames. Given the |
| offset and increment defined in the DimensionMap of Section 1.5, the |
| longitude points map to Inc1*(s-1)+offset1+0.5 in track direction and |
| Inc2*(f-1)+offset2 in scan direction, where 0.5 is the fractional |
| offset defined in Section 1.7 and 's' and 'f' are scaneline and frame |
| number starting from 1. If the formula gives a value 5.5 in track |
| direction that means 1/2 between detector 5 and detector 6. (please |
| note that detector# starts from 0) |
| |
| SDS Attributes: |
| +--------------------------+--------+-----+----------------------------+
| | Attribute Name | Type |Count| Attribute Value |
| +--------------------------+--------+-----+----------------------------+
| | units | string | 1 | "degrees" |
| +--------------------------+--------+-----+----------------------------+
| | valid_range | float32| 2 | -180.0, 180.0 |
| +--------------------------+--------+-----+----------------------------+
| | _FillValue | float32| 1 | -999.9 |
| +--------------------------+--------+-----+----------------------------+
| |
+=============================================================================+