dawnvir2isis

This program will import a PDS formatted Dawn Visual and InfraRed Mapping Spectrometer (VIR) level 1A (EDR) or level 1B (RDR) image into an ISIS cube. It supports ingestion of detached PDS labels. The file containing the label needs to be provided in the FROM parameter. This is typically a file ending with a .LBL suffix. If it is not the actual image data, it will search for a file with the same base name and suffix with .QUB.

Description

Use this parameter to select the existing Dawn VIR EDR or RDR filename. This file must contain a PDS label, with the actual image data either attached (within FROM file) or detached (separate file). For the detached case, the image data filename will automatically be obtained from the PDS image pointer keyword (^IMAGE =...). To override the existing pointer value, use this application's IMAGE parameter to specify the file containing the binary image data.

Type	filename
File Mode	input
Filter	*.qub *.QUB *.lbl *.LBL *.img

Description

Use this parameter, if desired, to override the image pointer (^IMAGE =...) value in the detached PDS label (FROM). Or, if the existing pointer value is not resolved as an existing file, this application will search for an image file with the same FROM path and base name, only now with extension .QUB.

Type	filename
File Mode	input
Internal Default	Cube data embedded with label or file pointer in label file.
Filter	*.img *.qub *.QUB

Description

Housekeeping label file describing the HKTABLE. This parameter is optional but the relevant label file must exist and be accessible by this application. Without a user entry here, the application will derive an expected label filename (two options) as follows.

To start, the HKFROM filename is derived by using the FROM base filename, and replacing the .extension with _HK.LBL. If this file does not exist, the application then replaces, within the derived filename, the string '_1B_' with '_1A_', and attempts a second search for the file. This second attempt is relevant since table data for 1A (uncalibrated) images can be used with 1B (calibrated) images.

For example (again, without a user HKFROM entry), if the input image label file (FROM) is VIR_IR_1B_1_358284474_1.LBL, then the housekeeping file name first derived is VIR_IR_1B_1_358284474_1_HK.LBL. If deemed nonexistent, the second derived file name is VIR_IR_1A_1_358284474_1_HK.LBL. Otherwise, user input is required for the HKFROM parameter.

Note this file is assumed to exist in the same directory as the image data (FROM). Otherwise, the user must provide the full path and filename.

Type	filename
File Mode	input
Internal Default	Derived from input image (FROM)
Filter	*.LBL *.TAB

Description

This parameter is provided in the event where the table data is not readily determined from the input file. As described in the HKFROM parameter, this filename is typically contained with the KHFROM label. If for some reason, it cannot be resolved/found, this parameter allows the user to provide it directly.

This table contains data that is required in order for the camera model to work properly. Uncalibrated (1A) tables can be used for calibrated (1B) table.

Type	filename
File Mode	input
Internal Default	Deterministic from input label file (HKFROM)
Filter	*.img *.qub *.QUB

Description

Use this parameter to select the output filename of the ISIS cube generated by this application.

Type	cube
File Mode	output
Filter	*.cub

Description

This parameter may be necessary as some Dawn EDR labels may not contain incorrect values for the TARGET_NAME keyword.

Dawn had a long cruise period before arriving at Vesta in August 2011. During cruise, a Mars flyby and various stellar observations occurred. Proper specification of the TARGET_NAME is critical.

With many star observations being made by Dawn, and in order to properly instantiate the ISIS camera model, the target must be either a recognized NAIF body or defined as Sky. NAIF bodies provide the means to map image coordinates to latitude/longitude values.

Sky is a special instantiation within ISIS providing the ability to map image coordinates to RA/DEC coordinates. If not defined here (TARGET), the default is to honor the TARGET_NAME value in the existing EDR label. For some observed targets, Sky is required in order to properly instantiate the camera model orignally validated by the spiceinit ISIS application.

Type	string
Internal Default	Label Value