Change history for TERRA L1B OBC File Specification ============================================================================ ============================================================================ V6.1.14 06/26/2012 Added the doi metadata. ============================================================================ ============================================================================ V6.0.0 05/22/2008 Added following 4 global attributes used by 250m and 500m bands only: "Detector_Quality_Flag2" "deadSubframeDataPercent" "dead_subframes" "noisy_subframe" ============================================================================ ============================================================================ V4.3.0 10/27/2003 The meaning of "bit QA flags" Bit 1 ("Spacecraft Maneuver") was changed to reflect whether any of the spacecraft attitude angles yaw, pitch, or roll are greater than threshold values set within the QA LUTs. Added Bit 26, "Sci Abnormal", which is set when SS_FR_SCIABNORM is set, which reflects the way Bit 1 was formerly set. Changed examples to be specific to MODIS/Terra. ============================================================================ ============================================================================ V4.0.5 07/15/2002 Added "bit QA flags" Bit 24, "dropped scan(s) between leading granule and granule being processed", and Bit 25, "dropped scan(s) between granule being processed and trailing granule". ============================================================================ ============================================================================ V4.0.0 03/27/2002 1. Added ECS Archive Metadata object "ProcessingEnvironment". ============================================================================ ============================================================================ V3.0.1 02/07/2002 (effective with MOD_PR02 (Terra), V3.0.1) ============================================================================ ============================================================================ All changes given were made to bring the Engineering and Telemetry data into agreement with SBRS Memo 151840, Release "C", June, 2000. Changes were made to the common Terra/Aqua L1B OBC File Specification V3.0.0, and specific to TERRA only. 1. Removed SR_SA_APX_PERIOD and replaced with SD_SA_APX_PERIOD in Telemetry Major Cycle All Part 1. 2. Removed CR_BB_SPARE and replaced it with SS_BB_DCYCLE in Telemetry Major Cycle 0 of 7. 3. Removed CS_FR_SPARE_1 and replaced it with CS_FR_SCI_QLKSET in Telemetry Major Cycle 1 of 7. 4. Removed CS_FR_SPARE_2 and replaced it with CS_FR_ENG_QLKSET in Telemetry Major Cycle 1 of 7. 5. Removed CS_SR_LAMP_USE and replaced it with SR_SPARE in Engineering SRCA data. (CS_SR_LAMP_USE was redundant to CS_SR_LAMPSE and still a viable copy through January 2002. Users should change any references to CS_SR_LAMP_USE to CS_SR_LAMPSE.) 6. Removed TP_RC_MNT_RING and replaced it with TP_RC_SPARE_2 in Telemetry Major Cycle 19 of 63. (TP_RC_MNT_RING is not enabled on TERRA.) 7. Added fields VR_TM_REF_BB_1E, VR_TM_REF_BB_2E, and VR_TM_REF_BB_3E at end of Engineering Temperature Data. ============================================================================ ============================================================================ ALL CHANGES BELOW WERE MADE TO COMMON AQUA/TERRA PRODUCT FILE SPECIFICATIONS and are included for completeness. ============================================================================ ============================================================================ V3.0.0 04/01/2001 (change effective with MOD_PR02, V3.0.0) ============================================================================ ============================================================================ (reference: CCR ****) 1. Set "ASSOCIATEDPLATFORMSHORTNAME.1" to "MODIS" 2. Removed "ASSOCIATEDPLATFORMSHORTNAME.2", "ASSOCIATEDINSTRUMENTSHORTNAME.2", "ASSOCIATEDSENSORSHORTNAME.2", "ASSOCIATEDPLATFORMSHORTNAME.3", "ASSOCIATEDINSTRUMENTSHORTNAME.3", "ASSOCIATEDSENSORSHORTNAME.3", "ASSOCIATEDPLATFORMSHORTNAME.4", "ASSOCIATEDINSTRUMENTSHORTNAME.4", and "ASSOCIATEDSENSORSHORTNAME.4". ============================================================================ ============================================================================ V2.5.1 01/12/2001 (changes effective with MOD_PR02, V2.5.5) ============================================================================ ============================================================================ (reference: CCR 528) 1. Added global attribute "Granule Average QA Values". 2. Added global attribute "Solar Irradiance on RSB Detectors over pi" ============================================================================ ============================================================================ V2.5.0, release 2 08/18/2000 (changes effective with MOD_PR02, V2.5.0) ============================================================================ ============================================================================ There is currently no CCR for this change. Prior to delivering V2.5.0, it was learned that the MCF files were not constructed properly. Rather than having ASSOCIATEDSENSORSHORTNAME appear as ("VNIR","SWIR","MIR","TIR"), there should be multiple containers in the MCF files for the object "AssociatedPlatformInstrumentSensorContainer", one for each value in ASSOCIATEDSENSORSHORTNAME. Thus, in the file specifications, there will be: | ASSOCIATEDPLATFORMSHORTNAME.1 "Terra" or "Aqua" | +-----------------------------------------------------------------------------+ | ASSOCIATEDINSTRUMENTSHORTNAME.1 "MODIS" | +-----------------------------------------------------------------------------+ | ASSOCIATEDSENSORSHORTNAME.1 "VNIR" | +-----------------------------------------------------------------------------+ | ASSOCIATEDPLATFORMSHORTNAME.2 "Terra" or "Aqua" | +-----------------------------------------------------------------------------+ | ASSOCIATEDINSTRUMENTSHORTNAME.2 "MODIS" | +-----------------------------------------------------------------------------+ | ASSOCIATEDSENSORSHORTNAME.2 "SWIR" | +-----------------------------------------------------------------------------+ | ASSOCIATEDPLATFORMSHORTNAME.3 "Terra" or "Aqua" | +-----------------------------------------------------------------------------+ | ASSOCIATEDINSTRUMENTSHORTNAME.3 "MODIS" | +-----------------------------------------------------------------------------+ | ASSOCIATEDSENSORSHORTNAME.3 "MIR" | +-----------------------------------------------------------------------------+ | ASSOCIATEDPLATFORMSHORTNAME.4 "Terra" or "Aqua" | +-----------------------------------------------------------------------------+ | ASSOCIATEDINSTRUMENTSHORTNAME.4 "MODIS" | +-----------------------------------------------------------------------------+ | ASSOCIATEDSENSORSHORTNAME.4 "TIR" | ============================================================================ ============================================================================ V2.5.0 08/15/2000 (changes effective with MOD_PR02, V2.5.0) ============================================================================ ============================================================================ There are two groups of changes: (1) planned changes unrelated to Aqua, and (2) changes required by Aqua. I) Planned changes unrelated to Aqua ------------------------------------ CCR 526: Approval pending Title: Remove Obsolete Data from MOD02 Products Remove the following obsolete metadata: Sec. 1.3: "Post Processing Indicates Bad data" Sec. 1.4.1: "Managers VIS/NIR Quality Index" "Managers SWIR Quality Index" "Managers MWIR/LWIR Quality Index" "Discontinuities in linear gain b1 across granules" For all of the above, remove the annotations in the file specifications that describe these items as obsolete. Miscellaneous changes (no CCR filed): In each of the MOD02 file specifications, clarify the follow items: A) section 1.6, note 2, bits 18-19, under the "Meaning" column, change "SRCA off" to "undetermined", B) section 1.3, note 1, remove the phrase: "(204 is the maximum)". C) added ".1" to ASSOCIATEDPLATFORMSHORTNAME, ASSOCIATEDINSTRUMENTSHORTNAME, ASSOCIATEDSENSORSHORTNAME II) Changes required by Aqua ---------------------------- 1. Provide examples for both Terra and Aqua for the following: LOCALGRANULEID SHORTNAME ASSOCIATEDPLATFORMSHORTNAME 2. Clarify the examples of ASSOCIATEDSENSORSHORTNAME: 1km and obc file: ("VNIR","SWIR","MIR","TIR") ============================================================================ ============================================================================ V2.4.1 07/10/2000 ============================================================================ ============================================================================ No changes. The version was updated to remain consistent with the three EV file specifications resulting in a single version for the products. ============================================================================ ============================================================================ V2.4.0 04/24/2000 ============================================================================ ============================================================================ CCR 523: Approval pending Title: New MCF Files and File Spec Explanations for ECS Metadata Changes 1. Incorporate new MCF files into MOD_PR02 delivered from ECS. 2. In ECS Core Metadata, in the example for for SCIENCEQUALITYFLAG, add "Not Investigated" as the example. 3. In ECS Archive Metadata, add: DESCRREVISION "1.0" PRODUCTIONHISTORY (for future use) CCR 508: Approved for adding QA attributes: 11/22/1999 Part of this CCR was approved on 11/22/1999: add several new granule level attributes for QA purposes. The following attributes have now been added for this release (see details in the file specifications): % L1A EV All Scan Data are Missing % L1A EV RSB DN Not in Day Mode % L1A EV DN Missing Within Scan % Dead Detector EV Data % Sector Rotation EV Data % Saturated EV Data % TEB EV Data With Moon in SVP % EV Data Where Cannot Compute BG DN % RSB EV Data With dn** Below Scale % EV Data Where Nadir Door Closed % EV Data Not Calibrated Bit QA Flags Last Value Bit QA Flags Change ============================================================================ ============================================================================ L1B V2.3.1 12/28/1999 ============================================================================ ============================================================================ The version number and date were changed to be consistent with the L1B EV file specifications. No other changes were made. ============================================================================ ============================================================================ L1B V2.3.0 12/14/1999 ============================================================================ ============================================================================ CCR 485: Rejected: 11/22/1999 Title: Remove Unused QA Metadata "Discontinuities in..." From L1B Files This CCR proposed to remove the granule level QA metadata item "Discontinuities in linear gain b1 across granules" which contains only fill values and is not planned to be implemented. This CCR was rejected to ensure that L1B version 2.3.0 is backward compatible with current readers at launch. However, the CCB recommended adding a note to the file specs identifying this as an obsolete data item that will be removed at launch + 6 months. This note was added. ============================================================================ ============================================================================ CCR 491: Approved: 11/22/1999 Title: MOD02 File Specifications, Electronics Redundancy Vector Change This change was approved as long as the name of the attribute "Electronics Redundancy Vector" stays the same. The meaning of the bits was changed, the number of subsystems was expanded, the implementation was changed to being from telemetry, not a LUT. The attribute "Electronics Configuration Change" was added. ============================================================================ ============================================================================ CCR 501: Approved: 11/22/1999 Title: Add additional granule level attributes: Detector Quality Flag and Earth-Sun Distance These two attributes were added. ============================================================================ ============================================================================ CCR 502: Approved: 11/22/1999 Title: L1B File Specifications Documentation Clarifications and Changes The examples of ALGORITHMPACKAGEVERSION, ALGORITHMPACKAGEMATURITYCODE, and ALGORITHMPACKAGENAME were changed to be more accurate. A note was added about computed the uncertainty in percent from the uncertainty index (the CCR proposed specific formulas. However, due to conflicting opinions within MCST about the formulas, the note simply stated to see the Product User's Guide). ============================================================================ ============================================================================ CCR 504: Rejected: 11/22/1999 Title: Remove Unused L1B Product Metadata "Post Processing Indicates Bad data" This CCR proposed to remove the granule level attribute "Post Processing Indicates Bad data" which contains only fill values and is not planned to be implemented. This CCR was rejected to ensure that L1B version 2.3.0 is backward compatible with current readers at launch. However, the CCB recommended adding a note to the file specs identifying this as an obsolete data item that will be removed at launch + 6 months. This note was added. ============================================================================ ============================================================================ CCR 508: Rejected/Approved: 11/22/1999 Title: Remove unused attributes and add additional granule level QA attributes in L1B files. This CCR proposed to remove the granule level attributes: "Managers VIS/NIR Quality Index", "Managers SWIR Quality Index", and "Managers MWIR/LWIR Quality Index" which contains only fill values and is not planned to be implemented. This part of the CCR was rejected to ensure that L1B version 2.3.0 is backward compatible with current readers at launch. However, the CCB recommended adding a note to the file specs identifying this as an obsolete data item that will be removed at launch + 6 months. This note was added. This CCR also proposed to add several granule level attributes for QA purposes. This part of the CCR was approved. However, the attributes have not yet been implemented in L1B V2.3.0. They will be implemented in the next release. This CCR also proposed to add meaning to 2 bits of the Bit QA Flags. This part of the CCR was also approved and the changes were made for V2.3.0. ============================================================================ ============================================================================ L1B V2.2.0 5/30/1999 ============================================================================ ============================================================================ CCR-472: 4/19/1999 Approved: 5/11/1999 Title: Change to L1B OBC File Specification MOD02OBC.fs Delete Refl_SV_Avg and Refl_SV_Uncert SDSs (the SDSs we plan to add supercede these). See the file "CCR_OBC_SDSs_to_add.doc" for details on all additions. Additionally, we need to change the ordering of the dimensions of all DN SDSs to [track,band,frame] from [band,track,frame]. This change affects "SD_250m", "SD_500m", "SD_1km_day", "SD_1km_night", and similar SDSs for space view (SV), black body (BB) and SRCA. This change restores the order to the same order as in the L1A products. ============================================================================ ============================================================================ CCR-478: 5/24/1999 Approved: June 14, 1999 Title: L1B OBC File SDS Name Changes Change the names of 12 SDSs that contain "DN_elec_bg" to names that contain "DN_obc". Example: DN_elec_bg_250m_avg becomes DN_obc_avg_250m Change the names of two global attributes: DN electronic BG 1km frames becomes DN_obc_avg_number_of_frames_to_use DN electronic BG first 1km frame becomes DN_obc_avg_first_frame_to_use