naiflab Documentation

naiflab - Add "SPICE" data to cube labels from NAIF kernel files
"naiflab" updates the keywords in the cube labels with data from NAIF
kernel files for future radiometric and geometric processing.  The
keywords that are possibly updated or added are: SPACECRAFT_NAME,
INSTRUMENT_ID, IMAGE_NUMBER, PRODUCT_ID, and TARGET_NAME (all user
supplied); A_AXIS_RADIUS, B_AXIS_RADIUS, C_AXIS_RADIUS, and
POSITIVE_LONGITUDE_DIRECTION (from $ISISDATA/planet.sav); and
INSTRUMENT_RIGHT_ASCENSION, INSTRUMENT_DECLINATION, INSTRUMENT_TWIST,
PLANET_RIGHT_ASCENSION, PLANET_DECLINATION, PLANET_SPIN,
SC_TARGET_POSITION_VECTOR, and SC_SUN_POSITION_VECTOR (from NAIF
kernels).  Five types of NAIF kernel files are used: the .tls file
(leapseconds), the .tsc file (spacecraft_clock), the .tpc or .bpc file
(planet constants), the .bsp file (spacecraft ephemeris), and the .plt
file (camera pointing).  To see if a particular mission is supported
look in the $ISISDATA directory for the mission specific .bsp and .plt
files.  See the NAIF TOOLKIT manual for more information about the
NAIF kernel files.

"naiflab" uses the Ascii table, naif_kernels.sav, in the directory
$ISISDATA to match the MISSION, INST, and TARGET to the appropriate
data files (kernels).  The START_TIME (or IMAGE_NUMBER) is then used
to select data from each file to fill the keyword values in the cube
labels.

Programmer:  Debbie A. Cook, U.S.G.S., Flagstaff

Input cube file name
(no default extension)

Use the following parameters
only if different from labels:

NONE

Spacecraft_name

--

Instrument_id or camera

--

Image_number

--

Product_id

--

Target_name

--

Adjust time to shutter center

NO

ADDITIONAL NOTES:

Parm	Description
FROM	The lables of the FROM file will be updated with the information found by "naiflab".
MISSION	This is the spacecraft name followed by an "_" and the spacecraft number. For missions with a single space- craft, use "_1". For example CLEMENTINE_1. This value will replace the keyword value that is on the labels for SPACECRAFT_NAME. If no value is entered, then the value on the labels will not be changed and "naiflab" will attempt to use the SPACECRAFT_NAME on the labels of the cube to identify which SPICE kernels to read. If a value for MISSION is not entered and SPACECRAFT_NAME is not on the labels, then "naiflab" will fail and issue an error message.
INST	This is the instrument identifier or camera name that collected the data. This value will replace the keyword value that is on the labels for INSTRUMENT_ID. If no value is entered, then the value on the labels will not be changed and "naiflab" will attempt to use the INSTRUMENT_ID on the lables of the cub to identify which SPICE kernels to read. If a value for INST is not entered and INSTRUMENT_ID is not on the labels, then "naiflab" will fail and issue an error message.
IMAGE_NO	This is the image number. It is also known as RIM count, FRAME_ID, or FSC. In the keyword label area of the cube, this value will be called IMAGE_NUMBER. This value will replace the keyword value that is on the labels for IMAGE_NUMBER. If no value is entered, then the value on the labels will not be changed and "naiflab" will attempt to use the IMAGE_NUMBER on the lables of the cube to locate SPICE data. If a value for IMAGE_NO is not entered and IMAGE_NUMBER is not on the labels, then "naiflab" will attempt to generate an image number from the START_TIME on the labels. "naiflab" will fail and issue an error message if START_TIME is also not on the labels.
PRODID	This is the product identification. In the keyword label area of the cube, this value will be called PRODUCT_ID. This value will replace the keyword value that is on the labels for PRODUCT_ID. If no value is entered, then the value on the labels will not be changed.
TARGET	This is the TARGET_NAME keyword value that will be written to the labels of the cube. If no value is input, this label value will not be changed and "naiflab" will attempt to use the TARGET_NAME on the labels of the cube to identify which SPICE kernels to read. If a value for TARGET is not entered and TARGET_NAME is not on the labels, then "naiflab" will fail and issue an error message.
CENTIME	If this option is set to YES, the program will write the keyword SHUTTER_CENTER_TIME. All SPICE keywords will be retrieved based on the SHUTTER_CENTER_TIME. If this option is set to NO, START_TIME will be used to retrieve the SPICE. For Voyager, START_TIME is actually shutter close time, so the SPICE for CENTIME=YES will differ from the SPICE FOR CENTIME=NO. For Galileo START_TIME is the shutter center time so the results from CENTIME=YES will be identical to CENTIME=NO. If CENTIME=YES, and the definition for the START_TIME is unknown for the mission, an error will be issued and the program will exit. If the SHUTTER_CENTER_TIME is already on the labels, the program will use that time if CENTIME=YES.