PDS_VERSION_ID = PDS3 LABEL_REVISION_NOTE = "2004-10-1, Initial" RECORD_TYPE = STREAM OBJECT = ASCII_DOCUMENT DOCUMENT_NAME = " This file is an ASCII Text document of the VIMS Data Product SIS." PUBLICATION_DATE = 2005-04-01 DOCUMENT_TOPIC_TYPE = "DATA PRODUCT DESCRIPTION" INTERCHANGE_FORMAT = ASCII DOCUMENT_FORMAT = TEXT DESCRIPTION = "This file is an ASCII text document describing the VIMS data archive product. The work was carried out at the Jet Propulsion Laboratory, California Institute of Technology, under a contract with the National Aeronautics and Space Administration. JPL D-documents referenced herein are internal documents available to JPL employees only." END_OBJECT = ASCII_DOCUMENT END Cassini VIMS Visual and Infrared Mapping Spectrometer (VIMS) Tour Level 1A Data File Software Interface Specification (SIS) ____________________________________ __________________________________ Charles Avis Bob Brown VIMS Instrument Operations Task Lead VIMS Science Team Lead D-24905 Tour Version 2.0 - DOVI-002 Custodian: C. Avis, April 15, 2005 TABLE OF CONTENTS Change Log 5 1. INTRODUCTION 9 2. FILE NAMING 11 3. INTERFACE SPECIFICATIONS 12 TABLE 3.1 Structure Keywords 12 TABLE 3.2 History Keywords 14 TABLE 3.3 Cube Object Keywords 16 4. Band and Sample Suffix Values 38 5. START/STOP Times and VIMS Internal Clock 42 6. Packed Cube Formats 49 7. Spatial Resolution vs. Sampling Mode 50 8. APPENDIX A - Sample Label 51 9. APPENDIX B - Fast Housekeeping Channels 62 10. APPENDIX C - Mission Phase Names 63 11. APPENDIX D - Telemetry Formats 64 12. APPENDIX E - Flight Software Upgrades 65 Change Log --------------------------------------------------------------------------- | Version | Date | Responsible Party | Description --------------------------------------------------------------------------- | Cruise 1.0 | 3/27/2000 | Initial Release | Initial Release --------------------------------------------------------------------------- | Cruise 2.0 | 11/11/2000 | Updates for FSW v3.1 | Updated to PDS- | | | | compliance for Jupiter | | | | Fly-by. Added keywords | | | | and descriptions for | | | | IR High-res and | | | | Nyquist Visible | | | | High-res. ----------------------------|---------------------------------------------- | Cruise | 2001 | Updates for FSW v4.2 | Added keywords and | | | | descriptions for | | | | Occultation Mode, | | | | Time Insertion, Zero | | | | Background Subtraction | | | | for Visible. |---------------------------|---------------------------------------------- | Cruise 3.0 | 9/14/2002 | Updates for FSW v5.1 | Added keyword and | | | | description for | | | | Spectral Editing. | | | | | | | | Updated descriptions | | | | for MISSING_PIXELS | | | | and INST_CMPR_RATIO. | | | | | | | | BAND_BIN_ORIGINAL_ | | | | BAND now properly | | | | used to indicate | | | | missing bands for | | | | edited data or when | | | | Visible is OFF. | | | | | | | | Improved/updated the | | | | text in Sections 4, 5, | | | | 6 and added Appendix | | | | E. Clarified in | | | | Section 3 that all | | | | cubes will have | | | | 352 bands (using | | | | fill data in the | | | | necessary places to | | | | maintain consistency). |-------------------------------------------------------------------------- | Tour 1.0 | 11/04/2002 | Updates for Tour | Updated Introduction | | | FSW v6.1 | section. | | | | | | | | Changed source SCLK | | | | used in filename to | | | | the SCLK of the start | | | | of the integration | | | | for the first IR | | | | spectrum. | | | | | | | | Replaced DATA_REGION | | | | keyword by | | | | SWATH_LENGTH, | | | | SWATH_WIDTH, | | | | X_OFFSET, and | | | | Z_OFFSET to more | | | | accurately report | | | | what was commanded. | | | | | | | | Changed MISSION_NAME | | | | to "CASSINI-HUYGENS" | | | | per Project/PDS | | | | agreement. | | | | | | | | Renamed NOTE to | | | | DESCRIPTION. | | | | | | | | Added keywords | | | | IMAGE_OBSERVATION | | | | _TYPE, PACKING, | | | | SNAPSHOT_MODE, | | | | SPECTRAL | | | | _SUMMING_FLAG, | | | | STAR_TRACKING, | | | | SEQUENCE_TITLE | | | | and TARGET_DESC. | | | | | | | | Changed NATIVE_STOP | | | | _TIME to be the end | | | | of the last pixel's | | | | exposure time | | | | instead of the last | | | | available start time. | | | | | | | | Updated the | | | | DATA_SET_ID to the | | | | values suggested | | | | in the Project Archive | | | | Plan for Science Data | | | | (preliminary). | | | | | | | | Updated description of | | | | BAND_BIN_ORIGINAL_BAND | | | | to include its usage | | | | for Spectral Editing | | | | and Spectral Summing. | | | | | | | | Updated the | | | | SAMPLING_MODE_ID | | | | parameter to remove | | | | the Vis spectral | | | | value because that | | | | feature will not | | | | be implemented. | | | | | | | | Updated Appendix D | | | | to current set of | | | | telemetry Modes. | | | | | | | | Updated Appendix C to | | | | the defined set of | | | | mission phases. | | | | | | | | Updated the sample | | | | label with above | | | | changes and | | | | by grouping keywords | | | | more logically. | | | | | | | | Updated Appendix E for | | | | Flight Software | | | | Upgrades. | | | | | | | | Added section on pixel | | | | angular resolution | | | | dependence upon | | | | sampling mode. | | | | | | | | Deleted the | | | | PDS_VERSION_ID | | | | keyword. | | | | | | | | Removed Overview | | | | wording regarding | | | | PDS. | | | | | | | | Removed PDS Imaging | | | | Node signature line. | | | | | | | | Updated source of | | | | values for | | | | TELEMETRY_FORMAT_ID | | | | and INSTRUMENT_DATA | | | | _RATE to indicate | | | | they come from | | | | telemetry channels. ------------------------------------------------------------------------- | Tour 2.0 | 04/15/2005 | Updates for FSW v7.1 | | | | and v8.1 and ISIS | | | | label modifications | Updated document | | | | references. | | | | | | | | Added examples for | | | | keywords EARTH_ | | | | RECEIVED_TIME_START, | | | | EARTH_RECEIVED_TIME_ | | | | STOP, START_TIME, | | | | STOP_TIME | | | | | | | | Added value range for | | | | CORE_MINIMUM_DN | | | | | | | | Updated examples for | | | | keywords HOUSEKEEPING_ | | | | CLOCK_COUNT, | | | | NATIVE_START_TIME, | | | | NATIVE_STOP_TIME, | | | | PRODUCT_CREATION_TIME, | | | | SPACECRAFT_CLOCK_ | | | | START_COUNT, | | | | SPACECRAFT_CLOCK_ | | | | STOP_COUNT | | | | | | | | Updated description | | | | of keywords | | | | SNAPSHOT_MODE, | | | | SPECTRAL_SUMMING_FLAG, | | | | TARGET_NAME, | | | | TELEMETRY_FORMAT_ID, | | | | X_OFFSET, Z_OFFSET, | | | | BAND_BIN_ORIGINAL_BAND | | | | | | | | Updated information | | | | in Section 4 regarding | | | | suffix data. | | | | | | | | Replaced sample label | | | | in Section 8. | | | | | | | | Updated Section 12 | | | | for latest FSW | | | | upgrades. --------------------------------------------------------------------------- 1. INTRODUCTION 1.1 Overview This document is the Software Interface Specification (SIS) between Cassini Instrument Operations (IO) and the Cassini Visual and Infrared Mapping Spectrometer (VIMS) Science Team Leader. It describes the VIMS cube products generated by IO which are delivered to the Team Leader. The products described consist of ASCII header records followed by binary data records. This data and header format is known to be compatible with the current release of the USGS Integrated Software for Imagers and Spectrometers (ISIS) software suite. Each ASCII header describes the data file which has been reconstructed from telemetry packets into a cube. The cube has not been radiometrically or geometrically corrected. The cube data files are considered to be "Level 2" by the Committee on Data Management and Computation (CODMAC), although NASA considers these products to be "Level 0". The Cassini Project currently refers to these products as the "Level 1A". In combination with software to perform radiometric correction, the set would be called "Level 1B". 1.2 Scope This specification applies to VIMS cube files generated after 25 March 2005 which corresponds to an SCLK of 1490420505. 1.3 Applicable Documents 1 VIMS ISIS Spectral CUBE Data File, 14 May 1998 Updated 24 July 1998, 10 December 1998, 5 January 1999, 4 August 1999 2 PDS Standards - http://pds.jpl.nasa.gov/tools/data_dictionary_lookup.cfm 3 ISIS Documentation - http://wwwflag.wr.usgs.gov/isis-bin/documentation.cgi 4 "Cassini Visual and Infrared Mapping Spectrometer Instrument Operations Handbook, Version 1.0c", JPL D-18629, 20 June 2003 5 "Cassini Visual and Infrared Mapping Spectrometer Software Description Document for VIMS FSW Version 3.1", JPL D-18767, 14 March 2000 6 "Cassini Visual and Infrared Mapping Spectrometer Software Description Document for VIMS FSW Version 4.2", JPL D-21521, 20 September 2001 7 "Cassini Visual and Infrared Mapping Spectrometer Software Description Document for VIMS FSW Version 5.1", JPL D-22974, 15 July 2002 8 "Cassini Visual and Infrared Mapping Spectrometer Software Description Document for VIMS FSW Version 6.1", JPL D-24869, 20 October 2002 9 "Cassini Visual and Infrared Mapping Spectrometer Software Description Document for VIMS FSW Version 7.1", JPL D-26340, 10 June 2003 10 "Cassini Visual and Infrared Mapping Spectrometer Software Description Document for VIMS FSW Version 8.1", JPL D-27094, 20 November 2003 11 "Cassini Visual and Infrared Mapping Spectrometer Cruise Data File Planetary Data System (PDS) Label", JPL D-18980, Sepember 14, 2002 12 "Cassini Visual and Infrared Mapping Spectrometer (VIMS) University of Arizona / Instrument Operations Instrument Operations Interface", C. Avis and E. Sayfi, 11/04/02, Version 3.2, D-18982 13 "Cassini/Huygens Program Archive Plan for Science Data", Version 3, June 2004, JPL D-15976, PD 699-068 1.4 Configuration Management This document is controlled by Cassini configuration management. Changes to the scope of this document must be requested via the Cassini project Engineering Change Request (ECR) process. Under this process, ECRs are impacted by the IO ISS/VIMS Manager and the VIMS Team Lead, and approved by Project management. 2. FILE NAMING The external filename will consist of a string which incorporates information about the spacecraft clock and version. The version is required because the same cube may be built multiple times due to multiple downlinks, or multiple TDS queries, etc. The following format will be followed: nnnnn.v where nnnnn is the numeric value in seconds of the spacecraft clock at the start of the integration of the first IR spectrum and v is the version number of the file. Example: 1402898283.4 This naming convention may not be compliant with PDS product naming conventions. 3. INTERFACE SPECIFICATIONS A cube file contains ASCII text records followed by binary data. The ASCII records describe the structure and content of a cube data file. Information in the label is stored in a "keyword=value" text format and structured in the Object Definition Language of PDS. Appendix A contains an example of the label. The binary portion of a VIMS file consists of two spatial and one spectral dimension (Sample, Line and Band in ISIS terminology). While the spatial dimensions of the cube core will vary from cube to cube, the core of all cubes consists of 352 spectral bands (planes). Any bands not returned by the instrument are padded with CORE_NULL values and identified by the BAND_BIN_ORIGINAL_BAND keyword. Augmenting the core data are various suffix planes appended in the sample and band dimensions for ancillary data. The number and content of these is indicated in the ISIS label. 3.1 File Structure Label Items The first records of the label describe the file structure. The first line contains the SFDU header: CCSD3ZF0000100000001NJPL3IF0PDS300000001 Table 3.1 defines the keywords and values of the file structure items. --------------------------------------------------------------------------- | TABLE 3.1 Structure Keywords | --------------------------------------------------------------------------- | Keyword | Type | Description | Valid values | Source| --------------------------------------------------------------------------- | RECORD_TYPE | STRING | Style of records in | FIXED_LENGTH | FIXED | | | | file | | | --------------------------------------------------------------------------- | RECORD_BYTES | INTEGER | Number of bytes in | 512 | FIXED | | | | each record | | | --------------------------------------------------------------------------- | FILE_RECORDS | INTEGER | Number of records | | MIPL | | | | in this file | | | --------------------------------------------------------------------------- | LABEL_RECORDS | INTEGER | Number of label | | MIPL | | | | records. | | | --------------------------------------------------------------------------- | FILE_STATE | STRING | Always CLEAN. | CLEAN | FIXED | --------------------------------------------------------------------------- 3.2 History Object Label Items The History Object labels immediately follow the file structure labels. This set of label items points to the location of the history records themselves, usually immediately following the last label record. Therefore, the ^HISTORY pointer usually is one greater than the LABEL_RECORDS value. These files as delivered from IO contain no entries in the history records. The records are there for ISIS compliance. Table 3.2 defines the keywords and values of the history object items. --------------------------------------------------------------------------- | TABLE 3.2 History Keywords | --------------------------------------------------------------------------- | Keyword | Type | Description | Value | --------------------------------------------------------------------------- | ^HISTORY | INTEGER | Record number where | LABEL_RECORDS+1 | | | | HISTORY object begins | | --------------------------------------------------------------------------- | OBJECT | STRING | Name of object for | HISTORY | | | | which the description | | | | | starts here | | --------------------------------------------------------------------------- | END_OBJECT | STRING | Name of object for which | HISTORY | | | | the description ends here| | --------------------------------------------------------------------------- 3.3 Cube Object Label Items The Cube Object keywords immediately follow the History Object keywords. This set of keywords contains a pointer (^QUBE) to the binary data, ISIS-specific keywords and VIMS-specific keywords describing the state of the instrument during the collection of the binary data. Label values are normally based on the most recently available data at the time just after one slice has been received, processed, and stored into the output cube. If the first slice is missing, label values will be populated after the first available slice. Table 3.3 defines the keywords and values of the Cube Object items. The keywords in the Table are in alphabetical order for easy reference. See the example label in Appendix A for the actual order of appearance. The following list defines some notation used to indicate the source of label items: "TLM" means the label item is returned via telemetry (either housekeeping or science data). "Packet Header - Cassini Secondary Header" means the item came from the header of the VIMS science packets. "TUH" means the label item came from the Transfer Unit Header. "CUH" means the label item came from the Compression Unit Header. "SFDU Header" means the label item came from the SFDU Header. "MIPL" means the label item was derived during processing at the Multimission Image Processing Laboratory. "FIXED" means the label item was pre-designated by agreement between MIPL and ISIS developers, and remains constant for entire dataset. "Cassini Project" means the label item was pre-designated by the Cassini Project and remains constant for entire dataset. "TL via IOI file & MIPL catalog" means the label item was determined by the Team Lead during the uplink process and migrated to the product label through the MIPL catalog. "IO via MIPL catalog" means the label item was determined by Instrument Operations during the uplink process and migrated to the product label through the MIPL catalog. "Predicted Events File via MIPL catalog" means the label item was extracted from the Predicted Events File during the uplink process and migrated to the product label through the MIPL catalog. Some keyword values are split into multiple lines because no line in label is permitted to exceed 80 characters including CR/LF. See Section 4 for explanations of the BAND_SUFFIX and SAMPLE_SUFFIX items. -------------------------------------------------------------------------- | TABLE 3.3 Cube Object Keywords | +------------------------------------------------------------------------+ | Keyword | Type | Description | Value | Source | +------------------------------------------------------------------------+ | ^QUBE | INTEGER | Pointer to record | | | | | | where QUBE Object | | | | | | begins | | MIPL | +------------------------------------------------------------------------+ | OBJECT | STRING | Name of Object for | | | | | | which the description | | | | | | starts here | QUBE | FIXED | +------------------------------------------------------------------------+ | ANTIBLOOMING_ | | The Visible channel | "OFF", | TUH bit | | STATE_FLAG | STRING | Antiblooming mode | "ON", | 169 | | | | | "N/A" | | | | | | (if VIS | | | | | | channel | | | | | | is "OFF") | | +------------------------------------------------------------------------+ | AXES | INTEGER | The number of | | | | | | dimensions (axes) in | | | | | | the core | 3 | FIXED | +------------------------------------------------------------------------+ | AXIS_NAME |STRING - | The names of the axes | (SAMPLE, | | | | comma | in physical storage | BAND, | | | | delimited| order | LINE) | FIXED | +------------------------------------------------------------------------+ | BACKGROUND_ | | | 1, 2, 4, | TUH | | SAMPLING_ | | The number of lines | 8, 16, | bits | | FREQUENCY | INTEGER | between background | 32, 64 | 162 | | | (lines) | samples | | - 167 | +------------------------------------------------------------------------+ | BACKGROUND_ | | A two-valued array | | | | SAMPLING_ |(STRING, | describing the | IR: | TUH | | MODE_ID |(STRING) | describing the | ("NOBACK",| bits | | | | background sampling | "SINGLE", | 160,161 | | | | mode. | "AVG2", | | | | | | "AVG4"); | | | | | The first element of | | | | | | the array pertains to | VIS: | | | | | the IR - with sampling| ("NORMAL",| | | | | turned on, one, two or| "ZEROSUB")| | | | | four samples can be | | | | | | averaged for each | "ZEROSUB" | | | | | background point. | is used to| | | | | | indicate | | | | | The second element of | that no | | | | | the array pertains to | background| | | | | the Visible channel | subtrac- | | | | | and indicates whether | tion has | | | | | background subtraction| been | | | | | of normally acquired | performed | | | | | bacground values has | for the | | | | | been performed. | Visible | | | | | | Channel.) | | | | | If the VIS is powered | | | | | | off, "N/A" will be | | | | | | used. | | | | | | | | | | | | Format: (IR value, | | | | | | VIS value) | | | +------------------------------------------------------------------------+ | BAND_ SUFFIX_ | REAL - | An additive constant | (0,0,0,0, | FIXED | | BASE | comma | used to convert the | 0,0,... | | | | delimited| reported backplane | 0,0) | | | | | value to the actual | | | | | | value via a linear | | | | | | transformation. | | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed" | | | | | | | | | | | | This keyword will only| | | | | | be present if | | | | | | FAST_HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | +------------------------------------------------------------------------+ | BAND_ SUFFIX_ | INTEGER- | A special pixed value | (-32765, | FIXED | | HIGH_ INSTR_ | comma | which flags a pixel | -32765, | | | SAT | delimited| whose value exceeded | -32765,...| | | | | the maximum reportable| -32765) | | | | | by the instrument. | | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | BAND_ SUFFIX_ | INTEGER- | A special pixed value | (-32764, | FIXED | | HIGH_ REPR_SAT| comma | which flags a pixel | -32764, | | | | delimited| whose value is larger | -32764,...| | | | | than allowed by the | -32764) | | | | | numeric representation| | | | | | used. | | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | BAND_SUFFIX_ | INTEGER- | The number of bytes | (4,4,4, | FIXED | | ITEM_ BYTES | comma | per backplane pixel | ...4) | | | | delimited| value. | | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | +------------------------------------------------------------------------+ | BAND_SUFFIX_ | STRING - | The name of the | (SUN_ | FIXED | | ITEM_ TYPE | comma | numeric representation| INTEGER, | | | | delimited| of the backplane pixel| SUN_ | | | | | values. | INTEGER, | | | | | | SUN_ | | | | | Up to 6 elements | INTEGER, | | | | | depending upon | ...SUN_ | | | | | selection of Fast | INTEGER) | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | +------------------------------------------------------------------------+ | BAND_SUFFIX_ | INTEGER- | A special pixel value | (-32766, | FIXED | | LOW_ INSTR_SAT| comma | which flags a pixel | -32766, | | | | delimited| whose value was lower | -32766,...| | | | | than the minimum | -32766) | | | | | reportable by the | | | | | | instrument. | | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | BAND_SUFFIX_ | INTEGER- | A special pixel value | (-32767, | FIXED | | LOW_ REPR_ SAT| comma | which flags a pixel | -32767, | | | | delimited| whose value is smaller| -32767,...| | | | | than allowed by the | -32767) | | | | | numeric representation| | | | | | used. | | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | BAND_SUFFIX_ | REAL - | A multiplicative | (1.0, | FIXED | | MULTIPLIER | comma | constant used to | 1.0, 1.0, | | | | delimited| convert the reported | ...1.0) | | | | | backplane value to the| | | | | | actual value via a | | | | | | linear transformation.| | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | BAND_ SUFFIX_ | STRING - | The names of the data | Example: | TUH, | | NAME | comma | channels from which | (SPE_TEMP,|following| | | delimited| the data in the | ME_TEMP, | the | | | | backplances came. Up | IR_RD_ | back- | | | | to four Housekeeping | SHLD_TMP_ | ground | | | | items may be commanded| 2, IR_SPC_| data. | | | | into the Fast | BDY_TMP_1)| | | | | Housekeeping channels | | | | | | and their DN values | Example: | | | | | are placed in these | (SLICE_ | | | | | suffix planes. | TIME_ | | | | | "Packed" cubes will | SECONDS, | | | | | also have planes | SLICE_ | | | | | containing the timing | TIME_ | | | | | of each slice in the | TICKS, | | | | | cube (SLICE_TIME_ | SPE_TEMP, | | | | | SECONDS and SLICE_ | ME_TEMP, | | | | | TIME_TICKS). | IR_RD_ | | | | | | SHLD_TMP_ | | | | | This keyword will only| 2, IR_SPC_| | | | | be present if FAST_ | BDY_TMP_1)| | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | +------------------------------------------------------------------------+ | BAND_ SUFFIX_ | INTEGER- | The value placed in | (-8192, | FIXED | | NULL | comma | the backplane when no | -8192, | | | | delimited| proper data value is | -8192,... | | | | | available. | -8192) | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | +------------------------------------------------------------------------+ | BAND_ SUFFIX_ | STRING - | The units of the | DIMENSION-| MIPL | | UNIT | comma | values placed in the | LESS | | | | delimited| backplanes. | | | | | | | SECONDS | | | | | Up to 6 elements | | | | | | depending upon | TICKS | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | +------------------------------------------------------------------------+ | BAND_SUFFIX_ | INTEGER- | The minimum valid | (0,0,0, | FIXED | | VALID_MINIMUM | comma | value for the values | ...0) | | | | delimited| placed in the | | | | | | backplanes. | | | | | | | | | | | | Up to 6 elements | | | | | | depending upon | | | | | | selection of Fast | | | | | | Houskeeping channels | | | | | | and whether the cube | | | | | | is "packed". | | | | | | | | | | | | This keyword will only| | | | | | be present if FAST_ | | | | | | HK_ITEM_NAME | | | | | | selections were made, | | | | | | the OVERWRITTEN_ | | | | | | CHANNEL_FLAG = ON or | | | | | | this is a PACKED cube.| | | +------------------------------------------------------------------------+ | BIAS_ STATE_ID| STRING | The bias state of the | "LOW" | TUH | | | | IR channel. | "HIGH" | bit 65 | +------------------------------------------------------------------------+ | COMMAND_FILE_ | STRING | The name of the IOI | | TL via | | NAME | | file containing the | | MIPL | | | | observation | | catalog:| | | | description for this | | (vimsPa | | | | product - sent from | | ramHead | | | | the VIMS Team Lead to | | erTour. | | | | IO. | | command | | | | | | File | | | | | | Name) | +------------------------------------------------------------------------+ | COMMAND_ | INTEGER | Numeric identifier for| 1-255 | TL via | | SEQUENCE_ | | a sequence of commands| | IOI file| | NUMBER | | sent to the | | & MIPL | | | | spacecraft. Also | | catalog:| | | | known as "trigger | | (vimsPr | | | | number". (Comes from | | edTour. | | | | the TRIGGER_NUMBER | | command | | | | keyword in the IOI | | Sequence| | | | file header.) | | Number) | +------------------------------------------------------------------------+ | COMPRESSOR_ID | INTEGER | Identifies which of | 1,2 | TUH | | | | two identical | "N/A" if | bits | | | | compressors is used. | data is | 72, 73 | | | | | not comp- | | | | | | ressed | | +------------------------------------------------------------------------+ | CORE_BASE | REAL | An additive constant | 0.0 | FIXED | | | | used to convert the | | | | | | reported core value to| | | | | | the actual value via a| | | | | | linear transformation.| | | +------------------------------------------------------------------------+ | CORE_HIGH_ | INTEGER | A special pixel value | -32764 | FIXED | | REPR_ | | which flags a pixel | | | | SATURATION | | whose value is larger | | | | | | than allowed by the | | | | | | numeric representation| | | | | | used. | | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | CORE_HIGH_ | INTEGER | A special pixel value | -32765 | FIXED | | INSTR_ | | which flags a pixel | | | | SATURATION | | whose value exceeded | | | | | | the maximum reportable| | | | | | by the instrument. | | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | CORE_ITEMS | INTEGER- | The length of each | (number_ | TUH: | | | comma | axis of the core in | of_samples| NS bits | | | delimited| pixels. Visible data | (aka, | 176-183 | | | | will occupy bands | swath_wid-| | | | | 1-96. IR data will | th), | NS: bits| | | | occupy bands 97-352. | number_of | 70, 71 | | | | | _bands, | | | | | Pixels in bands which | number_of | NL: bits| | | | are not returned are | lines, | 184-191 | | | | filled with CORE_NULL.| (aka, | | | | | | swath_len-| | | | | | gth)) | | +------------------------------------------------------------------------+ | CORE_ITEM_ | INTEGER | The number of bytes | 2 | FIXED | | BYTES | | per pixel value. | | | +------------------------------------------------------------------------+ | CORE_ITEM_TYPE| STRING | The name of the | SUN_ | FIXED | | | | numeric representation| INTEGER | | | | | of the pixel values. | | | +------------------------------------------------------------------------+ | CORE_LOW_REPR_| INTEGER | A special pixel value | -32767 | FIXED | | SATURATION | | which flags a pixel | | | | | | whose value is smaller| | | | | | than allowed by the | | | | | | numeric representation| | | | | | used. | | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | CORE_LOW_ | INTEGER | A special pixel value | -32766 | FIXED | | INSTR_ | | which flags a pixel | | | | SATURATION | | whose value was lower | | | | | | than the minimum | | | | | | reportable by the | | | | | | instrument. | | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | CORE_ | INTEGER | The lowest DN value in| (-32760, | MIPL | | MINIMUM_DN | | the core (ignoring | 32760) | | | | | values of CORE_NULL). | if | | | | | | SPECTRAL_ | | | | | | SUMMING_ | | | | | | FLAG=ON | | | | | | | | | | | |(-4095, | | | | | | 4095) | | | | | | SPECTRAL_ | | | | | | SUMMING_ | | | | | | FLAG=OFF | | +------------------------------------------------------------------------+ | CORE_ | REAL | A multiplicative | 1.0 | FIXED | | MULTIPLIER | | constant used to | | | | | | convert the reported | | | | | | core value to the | | | | | | actual value via a | | | | | | linear transformation.| | | +------------------------------------------------------------------------+ | CORE_NAME | STRING | A name to describe the| RAW_DATA | FIXED | | | | content of the core. | NUMBER | | +------------------------------------------------------------------------+ | CORE_NULL | INTEGER | The value placed in | -8192 | FIXED | | | | the core when no | | | | | | proper data value is | | | | | | available. | | | +------------------------------------------------------------------------+ | CORE_UNIT | STRING | The units of the | DIMEN- | FIXED | | | | values placed in the | SIONLESS | | | | | core. | | | +------------------------------------------------------------------------+ | CORE_VALID_ | INTEGER | The lowest possible | -4095 | FIXED | | MINIMUM | | DN value in the core. | | | +------------------------------------------------------------------------+ | DATA_BUFFER_ | STRING | The state of the data | "ENABLED" | TUH bit | | STATE_FLAG | | buffer | "DISABLED"| 74 | +------------------------------------------------------------------------+ | DATA_SET_ID | STRING | The Project-assigned | "CO-J-VIMS| Cassini | | | | identifier for VIMS | -2-EDR- | Project | | | | Level 1A products. | V1.0" | | | | | | before | | | | | | Approach | | | | | | Science | | | | | | phase | | | | | | begins. | | | | | | | | | | | | "CO-S-VIMS| | | | | | -2-EDR- | | | | | | V1.0" | | | | | | after | | | | | | Approach | | | | | | Science | | | | | | phase | | | | | | begins. | | +------------------------------------------------------------------------+ | DESCRIPTION | STRING | Validation and quality| "N/A" | Ground | | | | information (up to 255| when not | recons- | | | | characters) determined| available | truction| | | | by ground analysis. | | or rec- | | | | Populated by IO | | oncili- | | | | telemetry processing, | | ation | | | | validation and | | s/w via | | | | reconciliation soft- | | MIPL | | | | ware to describe known| | catalog:| | | | limitations of this | | vimsPred| | | | product. | | Tour. | | | | | | note and| | | | | | vimsProd| | | | | | Tour. | | | | | | note | +------------------------------------------------------------------------+ | DETECTOR_ | (REAL | A three-valued array | (-999., | TLM: | | TEMPERATURE | REAL, | describing the | -999., | | | | REAL) | detector teperatures | -999.) | IR High | | | | of: the IR high | if not | Res: | | | | resolution (small | available | House- | | | | range) sensor, the IR | | keeping | | | | low resolution (large | | bytes | | | | range) sensor and the | | 16, 17 | | | | Visible detector. All| | | | | | values come from | | IR Low | | | | Housekeeping. | | Res: | | | | | | House- | | | | The IR high resolution| | keeping | | | | temperature comes from| | bytes | | | | focal plane array | | 20, 21 | | | | (fpa) 1. | | | | | | | | VIS: | | | | The IR low resolution | | House- | | | | temperature is from | | keeping | | | | fpa 2. | | byte 56 | | | | | | | | | | Format: (IR high res | | | | | | temp, IR low res temp,| | | | | | VIS temp) | | | +------------------------------------------------------------------------+ | EARTH_ | DATE | Earth Received time of| EXAMPLE: | SFDU | | RECEIVED_ | (UTC) | the earliest record | "2006-158 | Header | | START_TIME | | containing valid data | T05:53:34 | | | | | for this image. | .000z" | | | | | | | | | | | ASCII Consultative | | | | | | Committee on Space and| | | | | | Data Standards(CCSDS) | | | | | | format: | | | | | | yyyy-dddThh:mm:ss.fffZ| | | | | | | | | | | | (T is a delimiter | | | | | | between date and time)| | | +------------------------------------------------------------------------+ | EARTH_ | DATE | Earth Received time of| Example: | SFDU | | RECEIVED_ | (UTC) | the latest record | "2006-158 | Header | | STOP_TIME | | containing valid data | T05:53:34 | | | | | for this image. | .000z" | | | | | | | | | | | ASCII Consultative | | | | | | Committee on Space and| | | | | | Data Standards(CCSDS) | | | | | | format: | | | | | | yyyy-dddThh:mm:ss.fffZ| | | | | | | | | | | | (T is a delimiter | | | | | | between date and time)| | | +------------------------------------------------------------------------+ | EXPOSURE_ | (REAL, | A two-valued array | Example: | TUH: | | DURATION | REAL) | describing the | (160.0, | | | | msecs | integration duration | 5120.0) | IR: bits| | | | of each pixel of the | | 96-104 | | | | IR and the visible | -999. is | | | | | channel. | used if | VIS: | | | | | either | bits | | | | Format:(IR integration| channel is| 105-111 | | | | duration, VIS | "OFF" | plus | | | | integration duration) | | 174, 175| +------------------------------------------------------------------------+ | FAST_HK_ITEM_ | (STRING, | A multi-valued list | Example: | Channel | | NAME | STRING, | containing up to four | | ID comes| | | STRING, | IR Housekeeping item | ("SPE_ | from | | | STRING) | names which are | TEMP", | fast | | | | recorded in the band | "ME_TEMP",| house- | | | | sufficies (backplanes)| "IR_RD_ | keeping | | | | | SHLD_TMP_ | portion | | | | If no IR Housekeeping | 2", "IR_ | of TUH. | | | | items were selected | SPC_BDY_ | | | | | for this cube, this | TMP_1") | See | | | | keyword will not be | | Appendix| | | | present. | | B for | | | | | | trans- | | | | This list can contain | | lation | | | | up to four values. | | of | | | | More than one value | | channel | | | | may be specified. The | | IDs to | | | | list is comma | | item | | | | delimited enclosed in | | names. | | | | parentheses. | | | +------------------------------------------------------------------------+ | FAST_HK_ | INTEGER | The rate at which the | 0 to | First | | PICKUP_RATE | | IR Fast Housekeeping | SWATH_ | byte of | | | | is collected (to be | LENGTH | House- | | | | stored in the band | | keeping | | | | suffix). | Values | portion | | | | | greater | of TUH. | | | | If set to 0, house- | than 8 | | | | | keeping values will be| have not | | | | | collected at every | been | | | | | pixel (every pixel of | success- | | | | | the backplane will | fully | | | | | have a value). | tested | | | | | | (under | | | | | If (n is) set from 1 | analysis).| | | | | to swath_length, | | | | | | housekeeping values | Example: | | | | | will be collected | If FAST_ | | | | | every nth line (only | HK_PICKUP_| | | | | the first pixel of | RATE=4, | | | | | every nth line of the | Fast | | | | | backplane will have a | House- | | | | | value). | keeping | | | | | | will be | | | | | If no IR Housekeeping | collected | | | | | items were selected | every | | | | | for this cube, this | fourth | | | | | keyword will not be | line. | | | | | present. | | | +------------------------------------------------------------------------+ | FLIGHT_ | STRING | Indicates version of | | IO via | | SOFTWARE_ | | instrument flight | | MIPL | | VERSION_ID | | software used to | | catalog:| | | | acquire image. | | fsw | | | | | | Versions| | | | | | .flight | | | | | | Software| | | | | | Version | | | | | | Id | +------------------------------------------------------------------------+ | GAIN_MODE_ID | (STRING, | A two-valued array | "LOW", | TUH: | | | STRING) | describing the gain | "HIGH", | | | | | state of the IR | "N/A" | IR: bit | | | | channel and the | | 64 | | | | Visible channel. | ("N/A" is | | | | | | used if | VIS: bit| | | | Format: (IR gain mode,| VIS or IR | 66 | | | | VIS gain mode) | channel | | | | | | is turned | | | | | | off.) | | +------------------------------------------------------------------------+ | HOUSEKEEPING_ | STRING | Spacecraft clock value| Example: | Packet | | CLOCK_COUNT | | of the time of | "14328982 | Header | | | | collection of slow | 84.400" | | | | | Housekeeping used for | | (Cassini| | | | this label. Typically| "N/A" | second- | | | | this is taken from the| if House- | ary | | | | last (most recent) | keeping | header) | | | | Housekeeping packet | is un- | | | | | received before the | available | | | | | end of the cube. | | | | | | | | | | | | Format: | | | | | | seconds.subRTIs | | | | | | Note that quotes have | | | | | | been added since the | | | | | | previous version of | | | | | | this SIS. | | | +------------------------------------------------------------------------+ | IMAGE_ | (STRING, | A multi-valued list | ("CALIB- | TL via | | OBSERVATION_ | STRING, | describing the | RATION", | IOI file| | TYPE | STRING) | purpose(s) of this | "ENGINEER-| and MIPL| | | | image: science, | ING", "SC-| catalog:| | | | calibration or | IENCE") | (vimsPar| | | | engineering. (Comes | | mHeaderT| | | | from the IMAGE_ | | our.imag| | | | OBSERVATION_TYPE_* | | eObserva| | | | keywords in the IOI | | tionType| | | | file parameter set | | *) | | | | description.) | | | | | | | | | | | | This list can contain | | | | | | up to three values | | | | | | where the purposes of | | | | | | the image are | | | | | | identified. More than| | | | | | one value may be | | | | | | specified. The list is| | | | | | comma delimited | | | | | | enclosed in | | | | | | parentheses. | | | +------------------------------------------------------------------------+ | INST_CMPRS_ | REAL | The compression factor| -999. of | MIPL | | RATIO | | achieved for this cube| not comp- | | | | | product. | ressed | | +------------------------------------------------------------------------+ | INST_CMPRS_ | STRING | The name of the comp- | "OMEGA" | TUH bits| | NAME | | ression algorithm used| "NOTCOMP" | 72, 73 | | | | for this data | | | +------------------------------------------------------------------------+ | INSTRUMENT_ | REAL | The rate at which data| 182.784, | TLM | | DATA_RATE | (kilo- | is tranferred from the| 94.208 | channels| | | bytes/ | instrument to the CDS | or | C-2034 | | | second) | (see Appendix D). | 8.192 | and | | | | | | C-2060 | | | | | -999. if | or House| | | | | not | keeping | | | | | available | byte 81 | | | | | | | | | | | Example: | | | | | | 8.192 | | +------------------------------------------------------------------------+ | INSTRUMENT_ | STRING | Name of spacecraft | "CASSINI | Cassini | | HOST_ NAME | | | ORBITER | Project | +------------------------------------------------------------------------+ | INSTRUMENT_ID | STRING | Common identifier for | "VIMS" | SFDU | | | | the instrument | | Header | +------------------------------------------------------------------------+ | INSTRUMENT_ | STRING | The mode the | "LINE", | TUH bits| | MODE_ ID | | instrument was in when| "POINT", | 56-63 | | | | this data was taken | "OCCULTA- | | | | | | TION", | | | | | | "CAL_SPE- | | | | | | CTRAL", | | | | | | "CAL_BACK-| | | | | | GROUND", | | | | | | "CAL_ELE- | | | | | | CTRIC", | | | | | | "CAL_SOL- | | | | | | AR" | | +------------------------------------------------------------------------+ | INSTRUMENT_ | STRING | Proper name of the | "VISUAL | Cassini | | NAME | | instrument | AND | Project | | | | | INFRARED | | | | | | MAPPING | | | | | | SPECTRO- | | | | | | METE" | | +------------------------------------------------------------------------+ | INSTRUMENT_ | (REAL, | A two-valued array | Example: | TLM | | TEMPERATURE | REAL) | describing: the mean | | | | | | of the two samples of | (134.9700 | IR spec-| | | (degrees | temperature of the IR | 01, 144.4 | trometer| | | K) | spectrometer body, and| 60007) | body: | | | | the temperature of the| | (mean of| | | | IR grating. | (-999., | House- | | | | | -999.) if | keeping | | | | Format: (IR specto- | not | channels| | | | meter body mean | available | S-0830 | | | | temperature, IR | | and | | | | grating temp.) | | S-0831) | | | | | | | | | | | | IR grat-| | | | | | ing: | | | | | | (House- | | | | | | keeping | | | | | | channel | | | | | | S-0826) | +------------------------------------------------------------------------+ | INTEGRATION_ | STRING | This flag indicates | "ENABLED",| TUH bit | | DELAY_ FLAG | | whether the integra- | "DISABLED"| 170 | | | | tion time for a | | | | | | rapidly acquired cube | | | | | | was extended by | | | | | | shrinking the pixel | | | | | | synch pulse. | | | | | | | | | | | | Enabling this delay is| | | | | | appropriate for those | | | | | | modes where the mirror| | | | | | movements stay within | | | | | | the same pixel. The | | | | | | integration will | | | | | | continue during 2 msec| | | | | | of the 3 msec mirror | | | | | | movement. | | | | | | | | | | | | Point and Occultation | | | | | | modes only. | | | | | | | | | | | | Also known as the | | | | | | "pixel synch delay". | | | +------------------------------------------------------------------------+ | INTERFRAME_ | REAL | The duration of the | -999.0 for| TUH bits| | DELAY_ | (milli- | delay between the end | Snapshot | 128-143 | | DURATION | seconds) | of one frame and the | mode data | | | | | start of the next to | | | | | | allow time for mirror | | | | | | to return. | | | +------------------------------------------------------------------------+ | INTERLINE_ | REAL | The duration of the | 0. to | TUH bits| | DELAY_DURATION| (milli- | delay between the end | 64000. | 112-127 | | | seconds) | of one line and the | | | | | | start of the next IR | | | | | | line. It allows time | | | | | | for: 1) the IR mirror| | | | | | to return, 2) | | | | | | collection of back- | | | | | | ground data and 3) the| | | | | | alignment of the | | | | | | exposure center times | | | | | | between the IR and | | | | | | Visible channels. | | | +------------------------------------------------------------------------+ | MISSING_ | STRING | Indicator of whether | "YES", | MIPL | | PACKET_FLAG | | the expected number of| "NO" | | | | | packets were received.| | | | | | | | | | | | There can be missing | | | | | | packets even when no | | | | | | missing pixels result.| | | +------------------------------------------------------------------------+ | MISSING_PIXELS| INTEGER | The number of pixels | | MIPL | | | | missing from the core | | | | | | of a cube. This | | | | | | indicates that the | | | | | | expected number of | | | | | | pixels (as determined | | | | | | by the commanded cube | | | | | | dimensions) did not | | | | | | arrive. The positions| | | | | | of these pixels are | | | | | | filled with CORE_NULL.| | | | | | Pixels purposefully | | | | | | set to CORE_NULL | | | | | | (e.g., due to time | | | | | | insertion) are not | | | | | | included in this | | | | | | total. | | | +------------------------------------------------------------------------+ | MISSION_NAME | STRING | Mission name | "CASSINI- | Cassini | | | | associated with the | HUYGENS" | Project | | | | image. | | | +------------------------------------------------------------------------+ | MISSION_ | STRING | Indicator of the phase| See | Cassini | | PHASE_NAME | | of the mission of | Appendix C| Project | | | | which this data is a | for valid | | | | | part | values. | | +------------------------------------------------------------------------+ | NATIVE_START_ | STRING | Value of VIMS internal| Example: | TUH bits| | TIME | | clock given in first | "14328982 | 16-21 | | | | transfer unit of this | 82.11000" | | | | | cube. This is the | | | | | | start of the first IR | | | | | | exposure of the first | | | | | | pixel. See Section 5 | | | | | | for complete | | | | | | explanation. Time is | | | | | | given in the form | | | | | | seconds.ticks, where a| | | | | | tick is 1/15.959 msecs| | | | | | | | | | | | Note that quotes have | | | | | | been added since the | | | | | | previous version of | | | | | | this SIS. | | | +------------------------------------------------------------------------+ | NATIVE_STOP_ | STGING | Calculated value of | Example: | Calcu- | | TIME | | VIMS internal clock | "14328982 | lated | | | | for the end of the IR | 83.15958" | from TUH| | | | exposure of the last | | bits | | | | pixel. Time is given | | 16-21 | | | | in the form | | and bits| | | | seconds.ticks, where a| | 96-104. | | | | tick is 1/15.959 msecs| | | | | | | | | | | | Note that quotes have | | | | | | been added since the | | | | | | previous version of | | | | | | this SIS. | | | +------------------------------------------------------------------------+ | OBSERVATION_ID| STRING | Name of observation of| | Pred- | | | | which this image is a | | icted | | | | part. | | Events | | | | | | File via| | | | NOTE: The basic source| | MIPL | | | | of this value is the | | catalog:| | | | Request Name (up to | | vimsPred| | | | any "$" delimiter) | | Tour. | | | | from Predicted Events | | obser- | | | | File (PEF). There are| | vationId| | | | no checks performed by| | | | | | IO/MIPL to ensure that| | | | | | values for this | | | | | | keyword conform to PDS| | | | | | standards. | | | +------------------------------------------------------------------------+ | OPTICS_ | (REAL, | A three-valued array | (-999., | TLM: | | TEMPERATURE | REAL, | describing: the | -999., | | | | REAL) | temperatures of the IR| -999.) if | (House- | | | | primary optics, the IR| not | keeping | | | | secondary optics and | available | byte 29;| | | | the Visible optics. | | House- | | | | | Example: | keeping | | | | Format: (IR primary | (148.5800 | byte 28;| | | | optics temp, IR | 02, 140.7 | House- | | | | secondary optics temp,| 89993, 27 | keeping | | | | VIS optics temp) | 2.010010) | byte 59)| | | | | | | +------------------------------------------------------------------------+ | OVERWRITTEN_ | STGING | A flag indicating | "ON", | TUH bit | | CHANNEL_FLAG | | whether spectral data | "OFF" | 67 | | | | was sacrificed in leiu| | | | | | of more precise timing| | | | | | information. | | | | | | | | | | | | If set to "ON", the | | | | | | observation time | | | | | | values are collected | | | | | | for each pixel and | | | | | | stored in the back- | | | | | | planes of the cube. | | | | | | The spectral data in | | | | | | channels 347-352 will | | | | | | be set to the | | | | | | CORE_NULL value | | | | | | (-8192). | | | +------------------------------------------------------------------------+ | PACKING | STRING | Indicates that it was | "ON", | Deter- | | | | necessary to pack | "OFF" | mined | | | | multiple actual cubes | | from | | | | in to this cube | | SWATH_ | | | | product due to their | | LENGTH, | | | | small size and lack of| | SWATH_ | | | | unique timing | | WIDTH, | | | | information. See | | and INS-| | | | Section 6. LINE, | | TRUMENT_| | | | POINT and OCCULTATION | | MODE. | | | | mode cubes are always | | | | | | packed. | | | +------------------------------------------------------------------------+ | PARAMETER_SET_| STRING | String provided by | | TL via | | ID | | Team Lead in the IOI | | IOI file| | | | file to identify the | | & MIPL | | | | parameter set which | | catalog:| | | | produced this cube. | | vims.Par| | | | (Comes from the | | amTour | | | | SETUP_NAME keyword in | | .paramet| | | | the IOI file parameter| | erSetId | | | | set description.) | | | | | | | | | | | | Typically this will be| | | | | | the COMMAND_SEQUENCE_ | | | | | | NUMBER with a counter | | | | | | character appended to | | | | | | the end. IO does not | | | | | | insure or check that | | | | | | this convention is | | | | | | followed. | | | +------------------------------------------------------------------------+ | POWER_STATE_ | (STRING, | A two-valued array | (IR: | Derived | | FLAG | STRING) | describing the power | ("ON", | from | | | | state of the IR | "OFF"), | TUH bits| | | | channel and the Visble| | 70, 71 | | | | channel. | VIS: | | | | | | ("ON", | | | | | Format: (IR power | "OFF")) | | | | | state, VIS power | | | | | | state) | | | | | | | | | | | | NOTE: When Visible | | | | | | power is OFF, bands | | | | | | 1-96 of the cube | | | | | | reconstructed on the | | | | | | ground are digitally | | | | | | padded to maintain | | | | | | consistent cube size. | | | | | | See BAND_BIN_ORIGINAL_| | | | | | BAND. | | | +------------------------------------------------------------------------+ | PRODUCT_ID | STRING | Unique identifier for | Example: | MIPL | | | | each cube. Required | "1_143289 | | | | | by PDS. | 8283.456" | | | | | | | | | | | PRODUCT_ID will be | | | | | | constructed: | | | | | | | | | | | | SPACECRAFT_CLOCK_CNT_ | | | | | | PARTITION"_" NATIVE_ | | | | | | START_TIME | | | +------------------------------------------------------------------------+ | PRODUCT_ | DATE | Time of creation of | Example: | MIPL | | CREATION_TIME | (Pacific | this cube on the | "2006-158T| | | | Time) | ground. | 05:53:34.0| | | | | ASCII CCSDS format: | 00z" | | | | | yyyy-dddThh:mm:ss.fffZ| | | +------------------------------------------------------------------------+ | PRODUCT_ | STRING | Identifies the version| "PRELIMI- | MIPL | | VERSION_TYPE | | of an individual data | NARY", | | | | | product. "PRELIM- | "FINAL" | | | | | LINARY" indicates | | | | | | missing data or other | | | | | | problems requiring | | | | | | attempts at | | | | | | regeneration prior to | | | | | | assignment as "FINAL".| | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| REAL | An additive constant | 0.0 | FIXED | | BASE | | used to convert the | | | | | | reported value to the | | | | | | ctual value via a | | | | | | linear transformation.| | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| INTEGER | A special pixel value | -32765 | FIXED | | HIGH_INSTR_SAT| | which flags a pixel | | | | | | whose value exceeded | | | | | | the maximum reportable| | | | | | by the instrument. | | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| INTEGER | A special pixel value | -32764 | FIXED | | HIGH_REPR_SAT | | which flags a pixel | | | | | | whose value is larger | | | | | | than allowed by the | | | | | | numeric representation| | | | | | used. | | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| INTEGER | The number of bytes | 4 | FIXED | | ITEM_BYTES | | per pixel value. | | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| STRING | The name of the | SUN_ | FIXED | | ITEM_TYPE | | numeric representation| INTEGER | | | | | of the pixel values. | | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| INTEGER | A special pixel value | -32766 | FIXED | | LOW_INSTR_SAT | | which flags a pixel | | | | | | whose value was lower | | | | | | than the minimum | | | | | | reportable by the | | | | | | instrument. | | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| INTEGER | A special pixel value | -32767 | FIXED | | LOW_REPR_SAT | | which flags a pixel | | | | | | whose value is smaller| | | | | | than allowed by the | | | | | | numeric representation| | | | | | used. | | | | | | | | | | | | (THIS KEYWORD IS | | | | | | REQUIRED FOR ISIS BUT | | | | | | THE VALUES ARE NEVER | | | | | | USED WITHIN THE CUBE.)| | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| REAL | A multiplicative | 1.0 | FIXED | | MULTIPLIER | | constant used to | | | | | | convert the reported | | | | | | value to the actual | | | | | | value via a linear | | | | | | transformation. | | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| STRING | The type of data | BACKGROUND| FIXED | | NAME | | stored in the sample | | | | | | suffix location. In | | | | | | general for VIMS, this| | | | | | data comes from IR and| | | | | | VIS background | | | | | | measurements. | | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| INTEGER | The value placed in | -8192 | FIXED | | NULL | | the suffix when no | | | | | | proper data value is | | | | | | available. | | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| STRING | The units of the | DIMENSION-| FIXED | | UNIT | | values placed in the | LESS | | | | | suffix. | | | +------------------------------------------------------------------------+ | SAMPLE_SUFFIX_| INTEGER | The minimum valid | 0 | FIXED | | VALID_MINIMUM | | value for the values | | | | | | placed in the suffix. | | | +------------------------------------------------------------------------+ | SAMPLING_MODE_| (STRING, | A two-valued array | IR: | TUH: | | ID | STRING) | describing: the | "NORMAL", | | | | | resolution mode of the| "UNDER" | IR: bits| | | | IR channel, and the | (aka | 82, 83 | | | | spatial resolution | "NYQUIST")| | | | | mode of the VIS | "HI-RES" | VIS | | | | channel. | | spatial:| | | | | VIS | bit 6 | | | | "N/A" is used if the | spatial: | | | | | channel is powered OFF| "NORMAL", | | | | | | "HI_RES", | | | | | See Section 7 for the | "N/A" | | | | | angular size of the | | | | | | pixels for a given | Example: | | | | | mode. | ("NORMAL",| | | | | | "HI-RES") | | +------------------------------------------------------------------------+ | SCAN_MODE_ID | STRING | The scan directions | "BOTH" | TUH bits| | | | which were enabled for| "XONLY" | 70, 71 | | | | the IR when acquiring | "ZONLY | | | | | this data. | "NONE" | | +------------------------------------------------------------------------+ | SEQUENCE_ID | STRING | Identifies the name of| Example: | IO via | | | | the mission sequence | "C22" | MIPL | | | | associated with this | | catalog:| | | | image. | | (vimsPre| | | | | | dTour.Se| | | | | | quenceID| +------------------------------------------------------------------------+ | SEQUENCE_TITLE| STRING | The name assigned by | | TL via | | | | the Team Lead for an | | IOI file| | | | activity of which this| | & MIPL | | | | observation is a part.| | catalog:| | | | (Comes from the SEQ- | | vimsPara| | | | UENCE_TITLE keyword in| | mHeaderT| | | | the IOI file header) | | our.sequ| | | | | | uenceTit| | | | | | le | +------------------------------------------------------------------------+ | SHUTTER_STATE_| STRING | The state of the IR | "DISABLED"| TUH bit | | FLAG | | shutter. | "ENABLED" | 76 | +------------------------------------------------------------------------+ | SNAPSHOT_MODE | STRING | Indicates whether the | "ON", | TUH bit | | | | data collection was | "OFF" | 108 | | | | determined by data | | | | | | volume or time | | | | | | duration. If "ON", | | | | | | then data collection | | | | | | ends after one full | | | | | | transfer unit (one | | | | | | "packed" product). | | | | | | If "OFF", then data | | | | | | collection ends after | | | | | | the commanded duration| | | | | | has expired (possibly | | | | | | resulting in multiple | | | | | | products). | | | +------------------------------------------------------------------------+ | SOFTWARE_ | STRING | Ground software | | MIPL | | VERSION_ID | | version used to | | | | | | generate this cube. | | | +------------------------------------------------------------------------+ | SPACECRAFT_ | INTEGER | Indicates the clock | | IO via | | CLOCK_CNT_ | | partition active for | | MIPL | | PARTITION | | the SPACECRAFT_CLOCK_ | | catalog:| | | | START_COUNT and | | vimsPred| | | | SPACECRAFT_CLOCK_STOP_| | Tour.scl| | | | COUNT elements. | | kCntPart| | | | Remains at 1 unless | | ition | | | | the spacecraft clock | | | | | | rolls over or is reset| | | +------------------------------------------------------------------------+ | SPACECRAFT_ | STRING | The seconds and subRTI| Example: | Packet | | CLOCK_START_ | | portions of the space-| "143289828| Header | | COUNT | | craft clock at the | 3.123" | (Cassini| | | | time the first packet | | second- | | | | in the observation is | | ary | | | | created. | | header) | | | | | | | | | | A subRTI is | | | | | | approximately 4 msec | | | | | | (1/256 second). | | | | | | | | | | | | Format:seconds.subRTIs| | | | | | | | | | | | Note that quotes have | | | | | | been added since the | | | | | | previous version of | | | | | | this SIS. | | | +------------------------------------------------------------------------+ | SPACECRAFT_ | STRING | The seconds and subRTI| Example: | Packet | | CLOCK_STOP_ | | portions of the space-| "143289828| Header | | COUNT | | craft clock at the | 4.456" | (Cassini| | | | time the last packet | | second- | | | | of the observation is | | ary | | | | created. | | header) | | | | | | | | | | Format:seconds.subRTIs| | | | | | | | | | | | Note that quotes have | | | | | | been added since the | | | | | | previous version of | | | | | | this SIS. | | | +------------------------------------------------------------------------+ | SPECTRAL_ | STRING | Indicates whether this| "ON", | TUH bits| | EDITING_FLAG | | cube has been reduced | "OFF" | 92-95 | | | | to a subset of the | | | | | | bands in the original | | | | | | cube. If "OFF", none | | | | | | of the original bands | | | | | | of the cube were | | | | | | intentionally omitted.| | | | | | See BAND_BIN_ORIGINAL_| | | | | | BAND to determine | | | | | | which bands are | | | | | | present. | | | +------------------------------------------------------------------------+ | SPECTRAL_ | STRING | Indicates whether this| "ON", | TUH bits| | SUMMING_FLAG | | cube has had its bands| "OFF" | 88-91 | | | | summed (in groups of | | | | | | 8) to reduce the SSR | | | | | | data volume. If so, | | | | | | each band contains the| | | | | | sum of its group of 8.| | | +------------------------------------------------------------------------+ | STAR_TRACKING | STRING | Indicates whether an | "ON", | TUH bit | | | | Occultation Mode cube | "OFF" | 87 | | | | used the commanded | | | | | | X_OFFSET and Z_OFFSET | | | | | | ("OFF") or used | | | | | | offsets calculated by | | | | | | the flight software | | | | | | from the non-Occult- | | | | | | ation Mode cube ("ON")| | | +------------------------------------------------------------------------+ | START_TIME | DATE(UTC)| Time corresponding to | Example: | Calcu- | | | | the NATIVE_START_TIME.| "2006-158T| lated | | | | | 05:53:34.0| from | | | | ASCII CCSDS format: | 00z" | NATIVE_ | | | | yyyy-dddThh:mm:ss.fff | | START_ | | | | T is a delimiter | | TIME | | | | between date and time | | (in TUH)| +------------------------------------------------------------------------+ | STOP_TIME | DATE(UTC)| Time corresponding to | Example: | Calcu- | | | | the NATIVE_STOP_TIME. | "2006-158T| lated | | | | | 05:53:34.0| from | | | | ASCII CCSDS format: | 00z" | NATIVE_ | | | | yyyy-dddThh:mm:ss.fff | | STOP_ | | | | T is a delimiter | | TIME | | | | between date and time | | (in TUH)| +------------------------------------------------------------------------+ | SUFFIX_BYTES | INTEGER | The number of bytes | 4 | FIXED | | | | per pixel value in all| | | | | | suffix values. | | | +------------------------------------------------------------------------+ |SUFFIX_ITEMS | INTEGER- | The number of data | (number_of| MIPL: | | | comma | items present in each | suffix_ | Side- | | | delimited| of the suffix regions | samples | planes:1| | | | | [aka,"side| Back | | | | | planes"] | planes: | | | | | number_of_| 0-4 | | | | | suffix_ | if non- | | | | | bands | packed, | | | | | [aka,"back| 0-6 if | | | | | planes"] | packed. | | | | | number_of_| Bottom | | | | | suffix_ | planes: | | | | | lines | 0 | | | | | [aka, | | | | | | "bottom | | | | | | planes"]) | | +------------------------------------------------------------------------+ | SWATH_WIDTH | INTEGER | The number of pixels | 1-64 | TUH: | | | (pixels) | (in the X direction) | | | | | | collected during this | | bits | | | | observation. This | | 176-183 | | | | will differ from | | | | | | CORE_ITEMS (1) for | | | | | | Occultation Mode cubes| | | | | | | | | | | | The angular size of | | | | | | these pixels is | | | | | | dependent upon the | | | | | | resolution mode | | | | | | selected (see Section | | | | | | 7). | | | +------------------------------------------------------------------------+ | SWATH_LENGTH | INTEGER | The number of slices | 1-64 | TUH: | | | (slices- | (in the Z direction) | | | | | or lines)| collected during this | | bits | | | | observation. This | | 184-191 | | | | will differ from | | | | | | CORE_ITEMS (3) for | | | | | | packed cubes and | | | | | | Occultation Mode cubes| | | | | | | | | | | | The angular size of | | | | | | these pixels is | | | | | | dependent upon the | | | | | | resolution mode | | | | | | selected (see Section | | | | | | 7). | | | +------------------------------------------------------------------------+ | TARGET_DESC | STRING | A string assigned by | | TL via | | | | the TL (in the IOI | | IOI file| | | | file) to describe the | | and MIPL| | | | object/event being | | catalog:| | | | observed. (Comes from | | vimsPara| | | | the TARGET_DESC | | mHeaderT| | | | keyword in the IOI | | our.targ| | | | file header.) | | etDesc | +------------------------------------------------------------------------+ | TARGET_NAME | STRING | The name of the target| | Pred- | | | | being observed | | icted | | | | (assigned by the | | Events | | | | Project). | | File via| | | | | | MIPL | | | | The source of this | | catalog:| | | | value is the Predicted| | vimsPred| | | | Events File (PEF) | | Tour.sca| | | | which contains the | | rtTarget| | | | targeting commands. | | Name | | | | There are no checks | | | | | | performed by IO/MIPL | | | | | | to ensure that values | | | | | | for this keyword also | | | | | | appear in the PDS Data| | | | | | Dictionary. | | | +------------------------------------------------------------------------+ | TELEMETRY_ | STRING | The telemetry mode | Always | | | FORMAT_ID | | used to send | "UNK" (no | | | | | packetized data from | longer | | | | | the spacecraft to the | available | | | | | ground. | in | | | | | | telemetry)| | +------------------------------------------------------------------------+ | X_OFFSET | INTEGER | The commanded mirror | 1-64 in | TUH: | | | | offset (in the X | units of | bits | | | | direction) within the | normal- | 144-151 | | | | IR normal-resolution | resolution| | | | | field-of-view. For | pixels. | For OCCU| | | | Visible and IR, the | | LTATION | | | | actual data collection| For OCCULT| mode | | | | area will differ when | ATION mode| only, | | | | not in normal- | only, | TLM: in | | | | resolution mode. | 1-128 in | band 345| | | | For OCCULTATION mode, | units of | of | | | | this is the single | high- | science | | | | pixel being observed | resolution| data | | | | (the IR mirror is not | pixels | | | | | moving). | | | +------------------------------------------------------------------------+ | Z_OFFSET | INTEGER | The commanded mirror | 1-64 in | TUH: | | | | offset (in the Z | units of | bits | | | | direction) within the | normal- | 152-159 | | | | IR normal-resolution | resolution| | | | | field-of-view. For | slices (or| For OCCU| | | | Visible, the actual | lines) | LTATION | | | | data collection area | | mode | | | | will differ when not | | only, | | | | in normal-resolution | | TLM: in | | | | mode. For OCCULTATION| | band 346| | | | mode, this is the | | of | | | | single pixel being | | science | | | | observed (the IR | | data. | | | | mirror is not moving).| | | +------------------------------------------------------------------------+ | GROUP | STRING | Name of the Group of | BAND_BIN | ISIS | | | | keywords for which the| | | | | | description starts | | | | | | here | | | +------------------------------------------------------------------------+ | BAND_BIN_ | REAL | List of wavelength | | FIXED | | CENTER | (micro- | values corresponding | | (values | | | meters) | to each band number. | | from TL | | | comma | | | calibra-| | | delimited| | | tion | | | | | | results)| +------------------------------------------------------------------------+ | BAND_BIN_ | INTEGER- | Array of 352 band | 0-352 | CUH | | ORIGINAL_BAND | comma | numbers from the | | | | | delimited| original cube which | If SPECTRA| | | | | correspond to the band| L_EDITING_| | | | | numbers in this cube. | FLAG=ON, | | | | | If this cube is | then a "0"| | | | | unaltered, this is a | indicates | | | | | list from 1 to 352. | that the | | | | | However,the value 0 is| band was | | | | | used to indicate bands| deleted | | | | | which were not | on-board. | | | | | returned by the | A value of| | | | | instrument as in the | "1" indica| | | | | case of spectral | tes that | | | | | editing, time | this band | | | | | insertion or Visible | was | | | | | power OFF | retained | | | | | | unaltered | | +------------------------------------------------------------------------+ | BAND_BIN_UNIT | STRING | Unit which applies to | MICROMETER| FIXED | | | | the values of the | | | | | | BAND_BIN_CENTER | | | | | | keyword | | | +------------------------------------------------------------------------+ | END_GROUP | STRING | Name of the Group of | BAND_BIN | ISIS | | | | keywords for which the| | | | | | description ends here | | | +------------------------------------------------------------------------+ | END_OBJECT | STRING | Name of Object for | QUBE | ISIS | | | | which the description | | | | | | ends here | | | +------------------------------------------------------------------------+ 4. Band and Sample Suffix Values Band suffix The band suffix (aka, backplanes) is a portion of a standard ISIS cube reserved for ancillary data relevant to the data in the core portion. These backplanes are appended to the rear of the cube so that the spectrum of a pixel may appear to have (352+number of backplanes) spectral values. The backplane values are collected at the time of the pixel spectrum collection, so the association of the 352 spectral values with the backplane values is real. ISIS requires that all suffix values be 4-byte values. VIMS follows this requirement by using 4-byte integer values. Any pixel of a backplane which has no value is given the CORE_NULL value. VIMS uses the backplanes for storage of 2 kinds of ancillary information (each in its own backplane): * Selected IR housekeeping values (up to 4 channels) * IR Spectrum acquisition time If acquisition time is present, it will always occur in backplanes 1 and 2, followed by the IR housekeeping backplanes (if any). The contents of the backplanes are identified in the ISIS label by the value of the keyword BAND_ SUFFIX_ NAME. IR Housekeeping Backplanes For all cubes for which Fast Housekeeping items were selected, the values of each selected item are placed in that item's backplane. If the Fast Housekeeping Pickup Rate is set to 0, housekeeping values will be collected at every pixel (every pixel of the backplane will have a value). If the rate is set from n=1 to n=swath_length, housekeeping values will be collected every nth line (only the first pixel of every nth line of the backplane will have a value). Note that this collection at every nth line continues across cube boundaries while resetting to start on line 1 at each new parameter set. Thus, all pixels in a housekeeping backplane contain values only when the pickup rate is 0. At other rates, the pixels not given values are set to CORE_NULL. Note: It has been observed that these "unvalued" pixels may contain a constant old value for the Fast Housekeeping item rather than the desired CORE_NULL. This behavior is being investigated. Acquisition Time Backplanes Each IR spectrum has its own unique observation time and this time may be stored in the backplanes of the cube. Backplane 1 contains the "seconds" portion of the spacecraft clock. Backplane 2 contains the "ticks" portion of the VIMS internal clock (see Section 5 for a discussion of VIMS time). Backplanes with Acquisition Time will be present in the following cases: * Occultation mode(indicated in the ISIS label by the INSTRUMENT_MODE_ID keyword) * Packed cubes (indicated in the ISIS label by the PACKED keyword) * When Time Insertion is specified (indicated in the ISIS label by the OVERWRITTEN_CHANNEL_FLAG keyword) For Time Insertion and Occultation cases, each spectrum will get a time value. For packed cubes without Time Insertion, only one time per slice will be present. All backplane pixels not filled with data are set to CORE_NULL. Sample suffix The sample suffix (aka, sideplane) is a portion of a standard ISIS cube reserved for ancillary data relevant to the data in the core portion. VIMS produces only one sample suffix value for each line, so there is always only one sideplane. However, the Visible and IR channels use the sideplane differently. The background data for each slice of the Visible channel is collected as a 'swath_width' x 1 x 1 "line" which is then rotated to become a 1 x 1 x 'swath_width' "spectrum" and appended to the side of the slice as the suffix. Therefore, sample suffix bands 1 through 'swath_width' (up to 64) contain 'swath_width' Visible background words. In addition, suffix bands 65 through 67 contain the Visible sine_value, Visible cosine_value, and Visible motor_current_value for each slice. Visible Background Data Collection And Storage For the IR channel, bands 97 through 352 of each slice's suffix contain an actual IR background spectrum for that slice (collected during the time between the end of one slice and the beginning of another). However, there is in the transfer unit only room for one set of 256 background values. If multiple sub-slices are packaged in the same transfer unit (Swath-width is greather than or equal to 32), then the last one packaged will have its background stored. This background will then be replicated for each sub-slice in the transfer unit when the Level 1A products are generated. 5. START/STOP Times and VIMS Internal Clock Internal Time VIMS has an internal clock synched to spacecraft time which is accurate to 1/15959th second (a unit we call a "tick"). VIMS uses this clock and the spacecraft clock to time-stamp the beginning of the integration time for the first pixel of the IR exposure of selected slices in a cube. The offset from IR start to Vis start is calculated by (IrExposMsec - VisExposMsec) / 2. Times vs. Slices Only selected slices get time-stamped with the actual time because multiple slices go into each transfer unit and the time-stamp used for the entire transfer unit comes from its first slice. The subsequent slices which fill the transfer unit will be tagged with the time from the first slice of the transfer unit. The algorithm for determining how many slices fit into a transfer unit is complex. For Image Mode: * A 64-pixel line gets a time for each slice. * A 32-pixel line gets a time for every odd numbered slice. * A 12-pixel line gets a time for every 4th slice (4, 8, 12, ...).. For Line mode: * A 64-pixel line gets a time for each slice. * A 32-pixel line gets a time for every odd numbered slice. * A 12-pixel line gets a time for every 5th slice (5, 10, 15, ...). For slices which are not uniquely time-stamped, the last available time is used. Thus, in 12-pixel line in Line mode there could be as many as 5 slices with same time. Time-Stamp Example for Line Mode 12-pixel line +-----------------------------------------------------+ | Slice | Exact Time Available? | Time used | +-----------------------------------------------------+ | 01 | Yes | correct time-stamp | +-----------------------------------------------------+ | 02-05 | No | from Slice 1 | +-----------------------------------------------------+ | 06 | Yes | correct time-stamp | +-----------------------------------------------------+ | 07-10 | No | from Slice 6 | +-----------------------------------------------------+ | 11 | Yes | correct time-stamp | +-----------------------------------------------------+ | 12-15 | No | from Slice 11 | +-----------------------------------------------------+ | 16 | Yes | correct time-stamp | +-----------------------------------------------------+ | 17-20 | No | from Slice 16 | +-----------------------------------------------------+ | 21 | Yes | correct time-stamp | +-----------------------------------------------------+ | 22-25 | No | from Slice 21 | +-----------------------------------------------------+ Time in Labels In the ISIS labels, the NATIVE_START_TIME uses the first available time for the file. The NATIVE_STOP_TIME is calculated from the last available time for the file and the integration time. Therefore, the NATIVE_STOP_ TIME is the best estimate of the end of the integration period. The NATIVE times are of the format "SSSSSSSSSSS.TTTTT", where S = spacecraft clock (seconds) and T = number of ticks. 6. Packed Cube Formats LINE and POINT Mode Packing The current cube-building software attempts to save disk space by packing multiple LINE mode or POINT mode cubes into single cubes. For LINE Mode, the software takes the N (sample) x 1 (line) x 352 (band) cubes and appends them sequentially to form Nx64x352 cubes. This LINE mode packing occurs also for CAL_BACKGROUND and CAL_SPECTRAL modes (if the swath length is 1). For POINT Mode, the software takes the 1x1x352 cubes and appends them sequentially to form 1x64x352 cubes. Because each POINT and LINE mode observation (slice) has its own observation time, this time is stored in the backplanes of these packed cubes (see Section 4). The keyword PACKED indicates that packing was necessary for this cube. Notice that another indicator of packed products is that the swath_length value differs from the number of lines listed in CORE_ITEMS. IMAGE Mode Packing In the case of small image mode cubes acquired with the data compressor ON, the instrument does its own data packing which requires special handling. In trying to combine multiple sub-slices for submission to the data compressor, the instrument will include sub-slices from multiple cubes if the dimensions are small enough. This set of sub-slices gets compressed together and put into one transfer unit and tagged with a SINGLE time. Therefore, when the sub-slices get uncompressed and repackaged into cubes, only that one time is available to identify the cubes. So, all the cubes get the same time tag if they were small enough to be compress together. The criteria for multi-cube compression to occur is Swath-width x Swath-length < 64. The number of cubes which get packaged together is determined by: 64 / (Swath-width x Swath-length). So, 8x8 cubes are handled normally - one cube at a time. On the other hand, 2x2 cubes get compressed 16 cubes at a time. Because of the data product tracking problems resulting from the single time tag on the transfer unit, cubes which compress together are packed into a single IMAGE mode Level 1A product (similar to packed LINE and POINT modes). Each such product file packages the multiple cubes by appending them in the line direction sequentially in time. Examples: * A set of 16 2x2 cubes produces a Level 1A product which is 2 (samples) x 32 (lines) x 352 (bands). * A set of 4 4x4 cubes produces a Level 1A product which is 4 (samples) x 16 (lines) x 352 (bands) The keyword PACKED indicates that packing was necessary for this cube. In addition, an indicator of packed products is that the swath_length value (plus 1) differs from that in CORE_ITEMS. 7. Spatial Resolution vs. Sampling Mode The angular size of a VIMS depends upon the resolution chosen (see SAMPLING_MODE_ID). The physical sensors are fixed in size - only the summation of the sensors is variable. The following table shows the relationships for both IR and Visible. +------------------------------------------------------------------------+ | SAMPLING MODE | Angular Size in Z | Angular Size in X | +------------------------------------------------------------------------+ | IR NORMAL | 0.5 mrad | 0.5 mrad | +------------------------------------------------------------------------+ | IR HIGH-RES | 0.5 mrad | 0.25 mrad | +------------------------------------------------------------------------+ | IR NYQUIST | 0.5 mrad | 0.5 mrad (with overlap of| | | | 50 % with neighboring | | | | pixels) | +------------------------------------------------------------------------+ | | +------------------------------------------------------------------------+ | VIS NORMAL | 0.5 mrad | 0.5 mrad | +------------------------------------------------------------------------+ | VIS HIGH-RES | 0.167 mrad | 0.167 mrad | +------------------------------------------------------------------------+ 8. APPENDIX - Sample Label CCSD3ZF0000100000001NJPL3IF0PDS200000001 = CASSFDU_LABEL /* File Structure */ RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 512 FILE_RECORDS = 4501 LABEL_RECORDS = 21 FILE_STATE = CLEAN /* Pointer to ISIS history label */ ^HISTORY = 22 OBJECT = HISTORY END_OBJECT = HISTORY /* Qube structure: Standard ISIS Cube of VIMS Data */ ^QUBE = 47 OBJECT = QUBE AXES = 3 AXIS_NAME = (SAMPLE,BAND,LINE) /* Core description. */ CORE_ITEMS = (64,352,48) CORE_ITEM_BYTES = 2 CORE_ITEM_TYPE = SUN_INTEGER CORE_BASE = 0.0 CORE_MULTIPLIER = 1.0 CORE_VALID_MINIMUM = -4095 CORE_NULL = -8192 CORE_LOW_REPR_SATURATION = -32767 CORE_LOW_INSTR_SATURATION = -32766 CORE_HIGH_REPR_SATURATION = -32764 CORE_HIGH_INSTR_SATURATION = -32765 CORE_MINIMUM_DN = -174 CORE_NAME = RAW_DATA_NUMBER CORE_UNIT = DIMENSIONLESS /* Suffix description. */ SUFFIX_ITEMS = (1,4,0) SUFFIX_BYTES = 4 SAMPLE_SUFFIX_NAME = BACKGROUND SAMPLE_SUFFIX_UNIT = DIMENSIONLESS SAMPLE_SUFFIX_ITEM_BYTES = 4 SAMPLE_SUFFIX_ITEM_TYPE = SUN_INTEGER SAMPLE_SUFFIX_BASE = 0.0 SAMPLE_SUFFIX_MULTIPLIER = 1.0 SAMPLE_SUFFIX_VALID_MINIMUM = 0 SAMPLE_SUFFIX_NULL = -8192 SAMPLE_SUFFIX_LOW_REPR_SAT = -32767 SAMPLE_SUFFIX_LOW_INSTR_SAT = -32766 SAMPLE_SUFFIX_HIGH_REPR_SAT = -32764 SAMPLE_SUFFIX_HIGH_INSTR_SAT = -32765 BAND_SUFFIX_NAME = (IR_DETECTOR_TEMP_HIGH_RES_1, IR_GRATING_TEMP, IR_PRIMARY_OPTICS_TEMP, IR_SPECTROMETER_BODY_TEMP_1) BAND_SUFFIX_UNIT = (DIMENSIONLESS, DIMENSIONLESS, DIMENSIONLESS, DIMENSIONLESS) BAND_SUFFIX_ITEM_TYPE = (SUN_INTEGER, SUN_INTEGER, SUN_INTEGER, SUN_INTEGER) BAND_SUFFIX_ITEM_BYTES = (4,4,4,4) BAND_SUFFIX_BASE = (0.0,0.0,0.0,0.0) BAND_SUFFIX_MULTIPLIER = (1.0,1.0,1.0,1.0) BAND_SUFFIX_VALID_MINIMUM = (0,0,0,0) BAND_SUFFIX_NULL = (-8192,-8192,-8192,-8192) BAND_SUFFIX_LOW_REPR_SAT = (-32767,-32767,-32767,-32767) BAND_SUFFIX_LOW_INSTR_SAT = (-32766,-32766,-32766,-32766) BAND_SUFFIX_HIGH_INSTR_SAT = (-32765,-32765,-32765,-32765) BAND_SUFFIX_HIGH_REPR_SAT = (-32764,-32764,-32764,-32764) /* Data description: General */ MISSION_NAME = "CASSINI-HUYGENS" MISSION_PHASE_NAME = "TOUR" INSTRUMENT_HOST_NAME = "CASSINI ORBITER" INSTRUMENT_NAME = "VISUAL AND INFRARED MAPPING SPECTROMETER" INSTRUMENT_ID = "VIMS" DATA_SET_ID = "CO-S-VIMS-2-EDR-V1.0" SPACECRAFT_CLOCK_CNT_PARTITION = 1 SPACECRAFT_CLOCK_START_COUNT = "1491031871.002" SPACECRAFT_CLOCK_STOP_COUNT = "1491033951.002" NATIVE_START_TIME = "1491031827.14308" NATIVE_STOP_TIME = "1491033905.00872" START_TIME = "2005-091T07:03:38.739Z" STOP_TIME = "2005-091T07:38:15.897Z" HOUSEKEEPING_CLOCK_COUNT = "1491033904.131" EARTH_RECEIVED_START_TIME = "2005-091T21:35:50.661Z" EARTH_RECEIVED_STOP_TIME = "2005-091T21:39:28.334Z" /* Uplink Data */ SEQUENCE_ID = "S09" SEQUENCE_TITLE = "VIMS_005TI_LIMBCOMB001_CIRS" OBSERVATION_ID = "VIMS_005TI_LIMBCOMB001" COMMAND_FILE_NAME = "VIMS_005TI_LIMBCOMB001_CIRS.V2.ioi" COMMAND_SEQUENCE_NUMBER = 45 PARAMETER_SET_ID = "VIMS_005TI_LIMBCOMB001_CIRS_035" TELEMETRY_FORMAT_ID = "UNK" TARGET_NAME = "TITAN" TARGET_DESC = "TITAN" IMAGE_OBSERVATION_TYPE = "SCIENCE" /* Instrument Status (IR, Visible) */ /* In the following section, parameters with single values apply to */ /* both the IR and visible portions of the instrument. Parameters */ /* with two values apply to the IR and the visible respectively. For */ /* parameters with more than two values, see the accompanying comment */ /* for an indication of how the values are to be applied. */ SAMPLING_MODE_ID = ("NORMAL","NORMAL") INSTRUMENT_MODE_ID = "IMAGE" BACKGROUND_SAMPLING_MODE_ID = ("SINGLE","ZERO_SUB") COMPRESSOR_ID = 1 INST_CMPRS_NAME = "OMEGA" INST_CMPRS_RATIO = 1.881667 DATA_BUFFER_STATE_FLAG = "ENABLED" INSTRUMENT_DATA_RATE = 94.208000 POWER_STATE_FLAG = ("ON","ON") GAIN_MODE_ID = ("LOW","LOW") EXPOSURE_DURATION = (640.000000,41000.000000) INTERLINE_DELAY_DURATION = 1642.000000 INTERFRAME_DELAY_DURATION = 1840.000000 X_OFFSET = 1 Z_OFFSET = 1 SWATH_WIDTH = 64 SWATH_LENGTH = 48 OVERWRITTEN_CHANNEL_FLAG = "OFF" SPECTRAL_EDITING_FLAG = "OFF" SPECTRAL_SUMMING_FLAG = "OFF" STAR_TRACKING = "OFF" SNAPSHOT_MODE = "OFF" PACKING = "OFF" /* IR high resolution, IR low resolution, Visible (degree K) */ DETECTOR_TEMPERATURE = (59.650791,58.759590,233.435440) /* IR primary, IR secondary, Visible (degree K) */ OPTICS_TEMPERATURE = (133.989594,131.353134,274.901215) /* IR spectrometer, grating (degree K) */ INSTRUMENT_TEMPERATURE = (131.312607,129.860535) /* Instrument status: IR */ BIAS_STATE_ID = "LOW" SCAN_MODE_ID = "BOTH" SHUTTER_STATE_FLAG = "ENABLED" INTEGRATION_DELAY_FLAG = "DISABLED" BACKGROUND_SAMPLING_FREQUENCY = 1 FAST_HK_ITEM_NAME = ("IR_DETECTOR_TEMP_HIGH_RES_1", "IR_GRATING_TEMP", "IR_PRIMARY_OPTICS_TEMP", "IR_SPECTROMETER_BODY_TEMP_1") FAST_HK_PICKUP_RATE = 2 /* Instrument status: Visible */ ANTIBLOOMING_STATE_FLAG = "OFF" /* Data processing data */ FLIGHT_SOFTWARE_VERSION_ID = "8.1" SOFTWARE_VERSION_ID = "VIMS 10.0 11-23-2004" MISSING_PIXELS = 0 MISSING_PACKET_FLAG = "NO" DESCRIPTION = "N/A" PRODUCT_ID = "1_1491031827.14308" PRODUCT_CREATION_TIME = "2005-091T21:52:04.000Z" PRODUCT_VERSION_TYPE = "FINAL" /* Spectral axis description */ GROUP = BAND_BIN BAND_BIN_CENTER = (0.35054,0.35895,0.36629,0.37322,0.37949,0.38790,0.39518, 0.40252,0.40955,0.41731,0.42436,0.43184,0.43919,0.44652,0.45372,0.46163, 0.46841,0.47622,0.48629,0.48967,0.49777,0.50628,0.51222,0.51963,0.52766, 0.53416,0.54156,0.54954,0.55614,0.56353,0.57131,0.57810,0.58548,0.59312, 0.59938,0.60757,0.61505,0.62207,0.62940,0.63704,0.64408,0.65142,0.65910, 0.66609,0.67342,0.68102,0.68803,0.69535,0.70288,0.71000,0.71733,0.72484, 0.73198,0.73930,0.74676,0.75396,0.76128,0.76874,0.77595,0.78328,0.79072, 0.79793,0.80522,0.81262,0.81989,0.82721,0.83463,0.84190,0.84922,0.85663, 0.86391,0.87122,0.87863,0.88589,0.89386,0.90032,0.90787,0.91518,0.92254, 0.92983,0.93713,0.94445,0.95177,0.95907,0.96638,0.97382,0.98100,0.98883, 0.99588,1.00295,1.01005,1.01695,1.02471,1.03195,1.03865,1.04598,0.88421, 0.90075,0.91692,0.93308,0.94980,0.96568,0.98226,0.99882,1.01479,1.03132, 1.04755,1.06541,1.08183,1.09806,1.11396,1.13024,1.14695,1.16370,1.17996, 1.19622,1.21246,1.22859,1.24492,1.26166,1.27813,1.29482,1.31091,1.32695, 1.34324,1.35952,1.37695,1.39326,1.40940,1.42557,1.44184,1.45841,1.47514, 1.49169,1.50794,1.52421,1.54035,1.55674,1.57361,1.59018,1.60228,1.62523, 1.64160,1.65567,1.67238,1.68901,1.70536,1.72175,1.73802,1.75436,1.77105, 1.78771,1.80401,1.82004,1.83616,1.85288,1.86933,1.88679,1.90261,1.91916, 1.93545,1.95191,1.96871,1.98531,2.00167,2.01781,2.03424,2.05091,2.06757, 2.08400,2.10034,2.11667,2.13337,2.15018,2.16652,2.18288,2.19920,2.21591, 2.23282,2.24952,2.26622,2.28238,2.29921,2.31612,2.33325,2.35043,2.36765, 2.38472,2.40156,2.41820,2.43471,2.45097,2.46723,2.48360,2.50002,2.51659, 2.53292,2.54916,2.56437,2.58176,2.59807,2.61508,2.63000,2.64650,2.66146, 2.68085,2.69620,2.71205,2.73270,2.74770,2.76305,2.78118,2.79889,2.81606, 2.83247,2.84954,2.86609,2.88242,2.89878,2.91540,2.93143,2.94726,2.96327, 2.97720,3.00072,3.01382,3.02970,3.04806,3.06446,3.08036,3.09689,3.11213, 3.12962,3.14667,3.16304,3.17974,3.19708,3.21364,3.23150,3.24806,3.26561, 3.28298,3.29946,3.31619,3.33338,3.34981,3.36564,3.38183,3.39872,3.41546, 3.43178,3.44874,3.46475,3.48137,3.49795,3.51284,3.53015,3.54664,3.56274, 3.58034,3.59610,3.61387,3.63085,3.64853,3.66522,3.68283,3.69953,3.71743, 3.73439,3.75103,3.76763,3.78444,3.80083,3.81742,3.83472,3.85141,3.86184, 3.88167,3.89859,3.91478,3.93069,3.94762,3.96375,3.98015,3.99672,4.01280, 4.02944,4.04730,4.06295,4.080861,4.09743,4.11450,4.13183,4.14883,4.16644, 4.18299,4.19839,4.21120,4.22402,4.24220,4.26028,4.27840,4.29650,4.31470, 4.33280,4.35094,4.36646,4.38295,4.39793,4.41537,4.43172,4.44772,4.46573, 4.48240,4.499511,4.51591,4.53379,4.55187,4.56797,4.58556,4.60290,4.62010, 4.63615,4.65416,4.67034,4.68721,4.70290,4.719561,4.73706,4.75351,4.77031, 4.78673,4.80349,4.81952,4.83577,4.85292,4.869401,4.88553,4.90265,4.91983, 4.93685,4.95389,4.97178,4.98896,5.00576,5.02240,5.040781,5.05734,5.07402, 5.09106,5.10680,5.108000) BAND_BIN_UNIT = MICROMETER BAND_BIN_ORIGINAL_BAND = (1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18, 19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42, 43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66, 67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90, 91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110, 111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128, 129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146, 147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164, 165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182, 183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200, 201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218, 219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236, 237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,254, 255,256,257,258,259,260,261,262,263,264,265,266,267,268,269,270,271,272, 273,274,275,276,277,278,279,280,281,282,283,284,285,286,287,288,289,290, 291,292,293,294,295,296,297,298,299,300,301,302,303,304,305,306,307,308, 309,310,311,312,313,314,315,316,317,318,319,320,321,322,323,324,325,326, 327,328,329,330,331,332,333,334,335,336,337,338,339,340,341,342,343,344, 345,346,347,348,349,350,351,352) END_GROUP = BAND_BIN END_OBJECT = QUBE END 9. APPENDIX B - Fast Housekeeping Channels The following table shows the correspondence between Fast Housekeeping Channel ID and the Channel Name used in the labels. Channel ID Fast Housekeeping Item Name 1 PLUS_12_VOLTS 2 MINUS_12_VOLTS 3 UNREGULATED_PLUS_5_VOLTS 4 UNREGULATED_MINUS_5_VOLTS 5 PS_PLUS_5_VOLTS 6 ADC_0_VOLT_REFERENCE 7 PLUS_5_VOLT_REFERENCE 8 X_SCAN_DRIVE_CURRENT 9 Z_SCAN_DRIVE_CURRENT 10 X_SCAN_MIRROR_POSITION 11 Z_SCAN_MIRROR_POSITION 12 IR_CHANNEL_OUTPUT 13 IR_DETECTOR_TEMP_HIGH_RES_1 14 IR_DETECTOR_TEMP_HIGH_RES_2 15 IR_DETECTOR_TEMP_LOW_RES 16 SPE_TEMP 17 ME_TEMP 18 IR_SHIELD_TEMP_1 19 IR_SHIELD_TEMP_2 20 IR_GRATING_TEMP 21 IR_SLIT/SHUTTER_TEMP 22 IR_PRIMARY_OPTICS_TEMP 23 IR_SECONDARY_OPTICS_TEMP 24 IR_SPECTROMETER_BODY_TEMP_1 25 IR_SPECTROMETER_BODY_TEMP_2 26 SHUTTER_POSITION 27 OPTICAL_CALIBRATION_CURRENT 28 PLUS_12_VOLTS_SWITCH 29 IR_SCAN_POWER 30 IR_SHUTTER_POWER 31 IR_SHUTTER_DRIVE 10. APPENDIX C - Mission Phase Names The following are the Cassini Project's official names for the various phases of the mission. "CRUISE SCIENCE" "VENUS 1 ENCOUNTER" "VENUS 2 ENCOUNTER" "EARTH ENCOUNTER" "EARTH-JUPITER CRUISE" "HIGH GAIN ANTENNA TRANSITION" "INSTRUMENT CHECKOUT 1" "INSTRUMENT CHECKOUT 2" "INSTRUMENT CHECKOUT 3" "JUPITER ENCOUNTER" "SATURN ORBIT INSERTION" "SCIENCE_CRUISE" "SPACE_SCIENCE" "APPROACH_SCIENCE" "TOUR PRE-HUYGENS" "PHOEBE ENCOUNTER" "TITAN A ENCOUNTER" "TITAN B ENCOUNTER" "HUYGENS DESCENT" "HUYGENS PROBE SEPARATION" "TITAN C HUYGENS" "TOUR" 11. APPENDIX D - Telemetry Formats A limited number of telemetry formats have been implemented by CDS during Cruise. Their correspondence to VIMS data rates is listed in the following table. +-------------------------------------------------------------+ | TELEMETRY FORMAT ID (Ops Mode) | VIMS Data Rate (Kbits/sec) | +-------------------------------------------------------------+ | SAF_142200 | 8.192 | +-------------------------------------------------------------+ | S_N_ER_4 | | | S_N_ER_5 | | | S_N_ER_5a | 18.432 | +-------------------------------------------------------------+ | S_N_ER_2 | | | S_N_ER_3 | | | S_N_ER_6 | 94.208 | +-------------------------------------------------------------+ | S_N_ER_1 | 182.784 | +-------------------------------------------------------------+ 12. APPENDIX E - Flight Software Upgrades Version 3.1 Normal IR Mirror Motion Two servo amplifiers turn the mirror. The X-Axis (fast scan) servo turns the mirror in .25 mrad steps and the Z-Axis (slow scan) servo turns the mirror in .5 mrad steps. At the beginning of a slice the mirror step timer is set to one-half the integration time and the integration begins approximately .640ms after the rising edge of Pixel_Sync. The first mirror step turns the X-Axis mirror .25 mrad while the integration continues. At the second mirror step while the mirror turns another .25 mrad, the integration stops and the data is collected. During each Pixel_Sync the 256 detectors along the frequency axis are read by the ADC and moved into FSW memory. IR Nyquist Sampling Upgrade: A timer is added to inhibit the X-Axis mirror step during data collection. At the beginning of a slice the mirror is inhibited. At the end of Pixel_Sync the mirror is enabled for one-half the integration time minus the 3ms Pixel_Sync pulse width plus .5ms margin. This causes the 0.0 mrad mirror location and the 0.25 mrad mirror location to be integrated as a pixel followed by the 0.25 mirror location and the 0.50 mirror location. At the end of a row the mirror moves down a pixel. Leaving the cube dimension (in pixels) unchanged reduces the field of view to 1/2 of normal in the X direction but normal in the Z direction. High IR Resolution Upgrade: In this mode the resolution is doubled along the X-axis. After recording a pixel the mirror is not moved and the same location is recorded again. Only after the second integration is the mirror moved again. At the end of a row the mirror will move down a pixel. The X-Axis mirror step inhibit timer is used to inhibit the step between data collections. This changes the resolution in the X-Axis from 0.5 mrad to 0.25 mrad. At the beginning of a slice the mirror will be enabled. At the end of Pixel_Sync the mirror will be inhibited for one-half the integration time minus the 3ms Pixel_Sync pulse width plus .5ms margin. This causes the 0.0 mrad mirror location to be integrated as a pixel followed by the 0.25 mirror location. Leaving the cube dimension (in pixels) unchanged reduces the field of view to 1/2 of normal in the X direction but normal in the Z direction. High Visible Resolution Upgrade With High-Resolution mode, the image appears to zoom-in at 3x magnification. The nine sensor/mirror locations that are usually summed for a normal pixel are left unsummed. Leaving the cube dimension (in pixels) unchanged reduces the field of view to 1/3 of normal. Cal Solar Data Reduction Upgrade In the original version the Cal Solar always performed a 64x64 observation. All image size controls which are available in Image mode are now enabled for Cal Solar. A smaller (e.g., 64x12) cube can be imaged, greatly reducing the volume of data to be transmitted. For more information see "Software Description Document for VIMS FSW Version 3.1", JPL D-18767. Version 4.2 During C27, the VIMS flight software was upgraded to handle Time Insertion, Occultation mode and Visible background subtraction control. The flight software features described below are available for data acquired by the VIMS instrument after August 2001. Time Insertion allows the observation time for each IR pixel to be collected and stored within the spectral data itself. At the end of integration 6 data locations are overwritten with the Native Time of the start of the integration for the spectrum. The affected cube channels are 347-352 (Visible ON) or 251-256 (Visible OFF). The Native Time is synchronized to the Spacecraft time every second and has a resolution of .06266 milliseconds. In addition, Time Insertion also inserts the commanded X and Z offset values into two additional spectral channels (345-346 with Visible ON or 249-250 with Visible OFF). At the time of cube file generation on the ground, the time values will be stripped from the spectral data and placed in the backplanes of the delivered cube. The offset values are extracted for insertion into the cube header. The spectral locations which held the times and positions will, in the delivered cubes, be set to the CORE_NULL value defined in the cube header. This feature is identifiable in product labels where OVERWRITTEN_CHANNEL_FLAG="ON". Occultation Mode was designed to image quickly and report precisely in time when each spectrum was exposed. The product labels of cubes acquired using Occultation Mode can be identified where INSTRUMENT_MODE_ID="OCCULTATION". In order to image quickly in Occultation Mode the Visible camera is always turned OFF and the mirrors do not move. Background collection is allowed, but for the highest data collection rate may be disabled. In addition, there is no restriction on integration times. Precise timing and offset information is achieved by using the "time insertion" feature described above. An option was added to use zero as the background data value for Visible background subtraction instead of the acquired background data. When the second parameter of the BACKGROUND_SAMPLING_MODE_ID is set to "ZERO_SUB", zero is passed to the compressor as the Visible background data value. If set to "NOMINAL" the compressor receives the nominal background value acquired by the Visible camera. The background data acquired by the Visible camera during an observation will not be zeroed out. It will appear in the delivered cube data regardless of the use of this option. For more information see "Software Description Document for VIMS FSW Version 4.2", JPL D-21521. Version 5.1 During C34 (about 7 October 2002) Flight Software version 5.1 was loaded into the instrument for evaluation. The major upgrade included in this version is the ability to perform Spectral Editing. This capability allows a subset of the collected bands to be deleted prior to transmission to the ground. The software will allow 0, 32, 64 or 96 Visible bands to be returned and similar multiples of 32 for the IR bands. The bands which are deleted are filled with CORE_NULL values by the ground software in order to retain the cube format of 352 bands. The identification of deleted bands is stored in the BAND_BIN_ORIGINAL_BAND keyword. An error was corrected which affected the storage of time in Transfer Unit Header. Transfer Unit Headers may contain multiple slices of science data. A single time value is stored in the header. The error caused that time to be the time of the last data added to the Transfer Unit rather than the more appropriate time of the first data added. The upgrade makes the acquisition time of the first pixel of the cube available for ground use. The other upgrades in this version have little effect upon the cube data and no effect upon the format or content of the cube. * A command was added to load the Spectral Mask memory with the information describing which bands should be retained or deleted. * A command was added to clear all IEBs from memory. * Correct bug in Visible Hi-res offset calculation. * Correct bug causing Time Insertion to shift the IR spectral data. * Correct bug in the usage of the Major Frame ID to identify begin and end of individual cubes. * The code was reworked to reduce its size in the patch area For more information see "Software Description Document for VIMS FSW Version 5.1", JPL D-22974. Version 6.1 Star Finding The compressor has always returned the location (within the VIMS FOV) of the brightest pixel within every subslice passed to the compressor. In previous versions of the VIMS FSW, this location has been ignored. Version 6.1 will now accept the derived locations from all subslices processed for a given cube. In the absence of noise, all subslices should return the same location. The algorithm avoids charged particle data noise by letting the subslices vote on the location. The final derived location is stored for potential later use. It does not affect the current cube data. The FSW algorithm for locating the star is always in use whenever the compressor is used. The data is always stored for use by the next observation, if desired. Version 6.1 gives Occultation mode the option of using either the commanded mirror offsets (present in the standard command) or of using the stored calculated location. The selection is controlled at the Instrument Operations Interface (IOI) file level by selecting the values of ON or OFF for the STAR_TRACKING keyword. This selection is sent forward in the IEB by toggling a previously unused bit in the Image mode command. This bit is the least significant bit of the field called "Spatial Summing" in word 3 of the 37IMAGE_MODE command. The steps involved in targeting a star for occultation science are: 1. Spacecraft points at predefined location 2. VIMS is commanded to perform a 16 pixel by 4 line Image mode in high-resolution 3. VIMS is commanded to start Occultation mode with the "Star Finding" flag ON. Code Compaction The standard compiler used for all upgrades in the past contains options which alter the compiling function. Past upgrades have used the "optimize for speed" option. This upgrade uses the "optimize for size" option in order to reduce the size of the compiled code. For more information see "Software Description Document for VIMS FSW Version 6.1", JPL D-24869. Version 7.1 Code Compaction Changes to some function calls achieved code size reduction with no loss of functionality. Visible-only Major Frame Correction The VIMS telemetry returns a Major Frame ID which designates the end of individual cubes in the data stream. During operation with the IR data collection disabled, the incrementing of the Major Frame ID was incorrect. The routine "line_sync_isr" was altered to increment the Major Frame one line later when IR is disabled. For more information see "Software Description Document for VIMS FSW Version 7.1", JPL D-26340. Version 8.1 Code Compaction Changes to some function calls achieved code size reduction with no loss of functionality. Spectral Summing One of the capabilities planned for VIMS but deferred to post-launch was the ability to sum spectral channels prior to downlink. This capability, called Spectral Summing, was designed into the compressor, but the Flight Software necessary to package the data for this compressor function could not be coded or tested pre-launch. While the software and compressor can sum either 2, 4 or 8 spectra during compression, the ground software can only handle the sum-by-8 mode. This simplification was necessary due to ground software complexity and schedule required to command the instrument and decipher the output. When Spectral Summing is selected, the spectra are sent to the compressor in contiguous groups of eight. Thus, no spectral mask data is required as it is with Spectral Editing. The compressor sums the data and then divides by 2 to eliminate the bit with the most noise. It then compresses the result. In addition to packaging the data sent to the compressor for summing, a change to the threshold parameters was necessary. These parameters cause the compressor to again divide the data by two when exceeded. They were previously set to 4095 (the maximum unsummed DN value), but had to be reset to 32767 to avoid the extra divides. When time insertion is selected, the FSW ensures that the last eight IR channels (where the time data are inserted) are not summed. For more information see "Software Description Document for VIMS FSW Version 8.1", JPL D-27094.