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.)        | <KELVIN>  | 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)|
|               |          |                       | <KELVIN>  |         |
+------------------------------------------------------------------------+
| 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.

