PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM OBJECT = TEXT NOTE = "Comments on MGS Thermal Emission Spectrometer (TES) Archive Volumes (ERRATA.TXT)" PUBLICATION_DATE = 2000-01-12 END_OBJECT = TEXT END COMMENTS ON MGS TES ARCHIVE VOLUMES MGST_0001 THROUGH MGST_0111 This document contains comments and errata concerning the MGS Thermal Emission Spectrometer Archive Volumes MGST_0001 through MGST_0111. 1. Modification to INDEX/CLASS.TXT in volumes MGST_0100 through MGST_0111 The vanilla -select examples given in INDEX/CLASS.TXT, Section 3 of volumes MGST_0100 through MGST_0111 should be modified to read: -select "OBSERVATION_CLASSIFICATION:OBSERVATION_TYPE 1 1 \ OBSERVATION_CLASSIFICATION:TES_SEQUENCE 3 3" returns surface periapsis nadir observations conducted in the mapping spacecraft configuration -select "OBSERVATION_CLASSIFICATION:OBSERVATION_TYPE 6 6 \ OBSERVATION_CLASSIFICATION:TES_SEQUENCE 2 2 \ OBSERVATION_CLASSIFICATION:CLASSIFICATION_VALUE +1 +1" returns ANS roll, Mars and space observations collected in mapping mode during the first outbound roll. 2. Error in Appendix of SOFTWARE/DOC/USERDOC.TXT on MGST_0106 to MGST_0111 In Appendix A.1 of the SOFTWARE/DOC/USERDOC.TXT on MGST_0106 to MGST_0111 the following columns are incorrectly identified as being QUALITY bit columns: FFT_START_INDEX and PRIMARY_DIAGNOSTIC_TEMPERATURES. Both should be accessed using only the column name as shown. 3. Errors in DATA/ENB.TXT label on MGST_0100 through MGST_0105 The following keywords and associated values are missing from the label of the DATA/ENB.TXT on the volumes indicated: MGST_0100 through MGST_0102 START_ORBIT_NUMBER = 1583 STOP_ORBIT_NUMBER = 244 START_TIME = 1999-059T20:08:12.259 STOP_TIME = 1999-087T07:08:49.001 MGST_0103 START_ORBIT_NUMBER = 133 STOP_ORBIT_NUMBER = 648 START_TIME = 1999-078T21:05:43.080 STOP_TIME = 1999-121T01:03:35.667 MGST_0104 START_ORBIT_NUMBER = 304 STOP_ORBIT_NUMBER = 648 START_TIME = 1999-092T20:27:36.948 STOP_TIME = 1999-121T01:03:35.667 MGST_0105 START_ORBIT_NUMBER = 386 STOP_ORBIT_NUMBER = 717 START_TIME = 1999-099T13:16:07.000 STOP_TIME = 1999-126T20:17:33.610 The DATA/ENB.TXT on these volumes is also missing the follwing note: NOTE =" This document includes the Experimenter's Notebook (ENB) entries summarizing data collection by TES during Mapping; the ENB was originally produced by the TES Mission Planner to be available online throughout the duration of the mission. This document is appropriate for orbits included in this volume, but may also include orbits from previous or later volumes. Two types of information can be found in this document: blocks of TES orbits and time entries, followed by the corresponding p*.img notes. TES data is organized by orbit which begins at the MGS descending equator crossing (times given in UTC). Orbits are labeled here with the TES orb number which is equivalent to ock (see obs.fmt OBJECT = ORBIT_COUNTER_KEEPER) except where deviations are noted. TES operations during a particular orbit are controlled by the *.img file available onboard; key information from this file is provided in the p*.img notes." 4. Errors in DATA/GEOMETRY.TXT on MGST_0100 through MGST_0105 The following keywords and associated values are missing from the label of the DATA/GEOMETRY.TXT on the volumes indicated: MGST_0100 through MGST_0102 START_ORBIT_NUMBER = 1583 STOP_ORBIT_NUMBER = 244 START_TIME = 1999-059T20:08:12.259 STOP_TIME = 1999-087T07:08:49.001 MGST_0103 START_ORBIT_NUMBER = 128 STOP_ORBIT_NUMBER = 648 START_TIME = 1999-078T11:13:45.084 STOP_TIME = 1999-121T01:03:35.667 MGST_0104 START_ORBIT_NUMBER = 304 STOP_ORBIT_NUMBER = 648 START_TIME = 1999-092T20:27:36.948 STOP_TIME = 1999-121T01:03:35.667 MGST_0105 START_ORBIT_NUMBER = 380 STOP_ORBIT_NUMBER = 727 START_TIME = 1999-099T01:30:04.000 STOP_TIME = 1999-127T11:58:37.604 Each entry in the DATA/GEOMETRY.TXT contains an "orbit" range designation; the values listed actually indicate the "ock" range of each entry. 5. Notice of new appendix to SOFTWARE/DOC/USERDOC.TXT Starting with Volume MGST_0106 an appendix containing a list of the Column Names and associated .fmt files has been added to the SOFTWARE/DOC/USERDOC.TXT for the ease of the user. These are the names used with vanilla in the specification string after -field or -select. 6. Error of omission in DATA/MARS/GEO.FMT Description All geometry data related to TES data is derived from MGS project geometry sources and is always given relative to Mars. Although this is true for all TES data volumes, it is first stated explicitly in the DATA/MARS/GEO.FMT Description on MGST_0106. 7. Notice of new data fields and corresponding software version on MGST_0100 Starting with Volume MGST_0100, the following, previously blank data fields have been filled: OBS.OBSERVATION_CLASSIFICATION, OBS.QUALITY, and RAD.QUALITY. These fields contain indexing values as described in INDEX/CLASS.TXT and INDEX/QUALITY.TXT. The values in these fields are stored as bit-string integer numbers which are not accessible by the software versions on Volumes MGST_0001 through MGST_0061. The software and corresponding *.FMT files available on MGST_0100 are required for accessing the OBSERVATION_CLASSIFICATION and QUALITY fields; see SOFTWARE/DOC/USERDOC.TXT for the command format used to call up data from these fields. The revised software can also be used to manipulate data on any previous volume. 8. Unusual entries in DATA/MARS/GEO*.TAB.LOCAL_TIME Some volumes may contain a GEO*.TAB.LOCAL_TIME entry of 65.543 hrs; this is a default value indicating that local (Martian) time was not calculated for this observation. This default is commonly applied to observations of targets other than the Martian surface. 9. Error in DATA/MARS/BOL.FMT on MGST_0001 through MGST_0061 The object CALIBRATED_VISUAL_BOLOMETER is incorrectly listed as having the units of "watt cm-2 stradian-1 micron-1"; the correct units for this measurement are "watt cm-2 stradian-1". 10. Error in DATA/MARS/IFG.FMT on MGST_0001 through MGST_0100 The column object INTERFEROGRAM_DATA in the DATA/MARS/IFG.FMT file is incorrectly listed with the DATA_TYPE = MSB_UNSIGNED_INTEGER; in order for the software to acess the INTERFEROGRAM_DATA, the line should read: DATA_TYPE = MSB_INTEGER. 11. Order of entries in INDEX/CUMINDEX.TAB Volumes MGST_0001 through MGST_0061 contain data collected during the Aerobraking and Science Phasing Orbit phases of the MGS mission; these volumes were not produced sequentially in the order of data collection. The order of entries in the index/cumindex.tab file on these volumes indicates the order that the volumes were produced, i.e.: MGST_0021 MGST_0061 MGST_0041 to MGST_0044 MGST_0001 to MGST_0016 For clarity, the entries in the index/cumindex.tab file on MGST_0100 and later volumes has been reorganized by volume name. 12. Nonstandard file names in SOFTWARE directory A few files in the SOFTWARE/SRC directory do not conform to the ISO 9660 8.3 filename standard. Specifically, the file MAKEFILE does not have an extension, and the files IO_LABLIB3.C and IO_LABLIB3.H have more than 8 characters in the filename. 13. Nonstandard file sizes in DATA/MARS/ directory on Volumes MGST_0001 through MGST_0008 The following TES Standard Data Products contain only one orbit of size 130 to 250 Mb; this is significantly larger than the documented 100 Mb per product (see DOCUMENT/ARCHSIS.ASC section 3.2): MGST_0001: TES000101, TES000102 MGST_0002: TES000201, TES000202 MGST_0003: TES000301, TES000302 MGST_0004: TES000401, TES000402, TES000403 MGST_0005: TES000501, TES000502, TES000503 MGST_0006: TES000601, TES000602 MGST_0007: TES000701, TES000702, TES000703 MGST_0008: TES000801, TES000802, TES000803 14. Errors in DOCUMENT/PROCESS.ASC and PROCESS.PDF on Volumes MGST_0001 through MGST_0010, and MGST_0021 through MGST_0061 While converting the document text files PROCESS.ASC and PROCESS.PDF, superscript and subscript formats were lost and could potentially lead to confusion. The documents should be read with the understanding that 10-6 indicates 10, or another value, raised to the -6 power; cm-1 indicates cm, or another unit, raised to the -1 power; d2?/d?2 indicates the second derivative is taken; the equation on line 476 should read dIRF/dT = 3*af*(detector_temp)^2 + 2*bf*detector_temp + cf; and the equation on line 493 should read Corr_IRF = IRF + dIRF/dT *deltaT + d2IRF/dT2 * deltaT^2 / 2! . 15. Errors in DOCUMENT directory on Volumes MGST_0041 through MGST_0061 On Volumes MGST_0061 and MGST_0041 through MGST_0044, the files SDPSIS.PDF and SDPSIS.ASC, section 3.1 lists a sample label with the nested PDS object "PRIMARY_KEYS". It should be "PRIMARY_KEY". 16. Nonstandard keyword in DATA/MARS/*.FMT files and associated software On Volume MGST_0021, the DATA/MARS/*.FMT files contain the keyword PRIMARY_KEYS; on subsequent volumes, this keyword was modified to PRIMARY_KEY and the associated software was adjusted to accommodate the change. Therefore, the software on MGST_0021 is incompatible with the DATA/MARS/*.FMT files on any volume produced later. The revised software and corresponding *.FMT files can be used to manipulate the MGST_0021 data located in the DATA/MARS/*.TAB or DATA/MARS/*.VAR files. 17. Errors in CATALOG directory on Volume MGST_0021 On Volume MGST_0021, some files in the CATALOG directory do not conform to the PDS standard for names of catalog object files. Specifically, HOST.CAT should be INSTHOST.CAT, TESINST.CAT should be INST.CAT, TSDRDS.CAT should be DATASET.CAT, PERSONEL.CAT should be PERSON.CAT, and REFS.CAT should be REF.CAT. Also on Volume MGST_0021, the file TARGET.CAT is missing from the CATALOG directory. Also on Volume MGST_0021, the file REFS.CAT is missing the following reference: OBJECT = REFERENCE REFERENCE_KEY_ID = "ASMAR&RENZETTI1993" REFERENCE_DESC = "Asmar, S.W., and N.A. Renzetti, The Deep Space Network as an Instrument for Radio Science Research, Jet Propulsion Laboratory Publication 80-93, Rev. 1, 15 April 1993." END_OBJECT = REFERENCE 18. Errors in DOCUMENT directory on Volume MGST_0021 On Volume MGST_0021, the files SDPSIS.PDF and SDPSIS.ASC, section 3.1 lists a sample label with the statement TABLE = "xxx". It should be ^TABLE = "xxx". On Volume MGST_0021, the PDS label files ARCHSIS.LBL, PROCESS.LBL, and SDPSIS.LBL in the DOCUMENT directory all have the keyword DESCRIPTION. It should be called NOTE to conform to PDS standards for text object labels. On Volume MGST_0021, the files ARCHSIS.ASC, PROCESS.ASC, and SDPSIS.ASC in the DOCUMENT directory are not PDS-compliant because they contain TAB characters and have some lines longer than 80 characters.