Cassini MIMI<br>Magnetospheric IMaging
    Instrument




This section describes how to obtain the MIMI IDL code, calibration and auxiliary files needed to read MIMI data and read and calibrate MIMI INCA data. The following sections describes the IDL routines, calibration files and auxiliary files in more detail.

Obtain and Install Code Tar Set

MIMI_code_calibration.tar.gz is a set containing everything a user would need to run the MIMI IDL routines. It includes the IDL code, instrument calibration files and any auxiliary files needed by the user. The code, calibration and auxiliary files are placed into subdirectories expected by the IDL code SETUP routine which will make it simpler for the user to get started.
To install the MIMI IDL read routines, calibration data, and auxiliary support files, gunzip the file set, and then untar. MIMI_code_calibration.tar.gz
gunzip MIMI_code_calibration.tar.gz
tar -xvf MIMI_code_calibration.tar

Description

Any links included in the following sections are included as a convenience for the user to update their file set after the entire code and calibration file set have already been installed. It is much simpler to install the whole set first and only use the individual links when the calibration or auxiliary set has been updated. The IDL code expects the individual files to be placed into the proper subdirectories.

MIMI IDL Routines

The main read routines consist of PDS_READ_MIMI for all non-image uncalibrated files and PDS_READ_MIMIIMG for the uncalibrated image files which are found in the COMIMI_missionphase/DATA/INCA_IMAGES directory in the PDS. Included with the code, are TEST_READ_MIMI and TEST_READ_MIMIIMG procedures that the user can edit with their paths and files to get started using the MIMI routines. The MIMI user guide contains descriptions of the main IDL routines in the section on INCA. Calibration for the INCA images is also included in the IDL code set.

SPICE Leap Second Kernel

the latest leap second kernel from the JPL SPICE NAIF site which is needed for IDL Read Routines. File naming format is naif####.tls
The following link is included in case the leap second file has been updated after the user has already installed the entire code and calibration file set. naif0012.tls

MIMI Calibration File

The MIMI calibration file is a comma delimited ASCII file, which contains all the calibration constants for the MIMI instrument except for INCA's flux transfer matrixes. The file naming format is MIMI_CALIBRATION_v(version).csv.
The version is a 4 digit number.
The following link is included in case the calibration file has been updated after the user has already installed the entire code and calibration file set. MIMI_CALIBRATION_0020.csv

INCA Image Geometric Factor x Efficiency Matrix

The directory geometricfactorXefficiency_matrix contains the INCA image flux transfer files which are matrixes that contain the INCA instrument geometric factors and the efficiency factors. The selection of the proper matrix is determined by the image type, species, time-of-flight, time period in the mission and whether the instrument is in a spinning or staring mode. The matrix files are arraigned in directories based on time in the mission. The mission time periods are divided into the following directories and cover the dates listed:

preJupiter1997-244 to 2001-119T23:59
postJupiter 2001-120 to 2003-263T23:59
postFlightv342003-264 to the end of mission

In each of these directories, there is a spin and a stare directory, containing the spin and stare matrixes respectively. In each spin or stare directory is the matrix set. The naming scheme for the geometric and efficiency matrixes is based on the number of pixels in the image, the time-of-flight and the species and is as follows:

(#pixels)x(#pixels)_tof(time-of-flight index)_(species).csv

The matrices and the following calibration date file change very rarely and must match.

Calibration Matrix Date File

The file decom_incaflux_dates.txt determines the dates the INCA image geometric factor and efficiency matrices directories cover. This file is used by the MIMI IDL INCA image read routine.

Auxiliary Files:

Some of these files are used by the analysis software and are included when the entire set is downloaded and others are included as an aid to the user in determining when data is available.

INCA Out of Calibration Time Ranges

The INCA out of calibration files are comma delimited files, containing the times that the INCA images were considered out of calibration. The time ranges in the files have been further divided into periods to indicate whether the period was a planned (1) or unplanned (2) out of calibration event but all of these time periods should be considered to be out of calibration. These files are used by the MIMI IDL INCA image read routine PDS_READ_MIMIIMG . The following links are included in case the out of calibration files have been updated after the user has already installed the entire code and calibration file set.
1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018

INCA Ion/Neutral Mode Time Ranges

The INCA Ion and Neutral Mode files are comma delimited files, containing either ion or neutral mode start and stop times and mode value. The Ion and Neutral modes are determined by the voltage on the INCA High start supply. 0=Neutral, 1=Ion. These files are not used by the MIMI read routines, they are just here for the convenience of the user. The following links are included in case the Ion and Neutral files have been updated after the user has already installed the entire code and calibration file set.
1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018

MIMI Stare/Spin Mode Time Ranges

The MIMI stare/spin mode files are comma delimited files, containing either spin or stare mode start and stop times and mode value. The spin and stare modes are determined by the MIMI DPU using the current spacecraft spin rate about the spacecraft Z axis. Spin and stare mode does affect how INCA images are collected. 0=Stare, 1=Spin. These files are not used by the MIMI read routines, they are just here for the convenience of the user. The following links are included in case the stare/spin files have been updated after the user has already installed the entire code and calibration file set.
1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018

Data Gap Lists

The data gaps files are comma delimitated files, containing the science data gaps start and stop time in UTC (yyyy-doyThh:mm:ss) and total gap time. These files are not used by the MIMI read routines, they are just here for the convenience of the user. The following links are included in case the gap files have been updated after the user has already installed the entire code and calibration file set.
1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018


MIMI Home MIMI Public Data Download Tool Uncalibrated Data Calibrated Data MIDL Analysis Software INCA Analysis Software IDL, Auxiliary Files SPICE Kernel Set

Comments to MIMI Webmaster at APL Updated: Jan 15, 2013