This program will import raw images, acquired from the Near Earth Asteroid
Rendezvous - Shoemaker (NEAR Shoemaker) mission's Multispectral Imager
(MSI) instrument, to ISIS data file format.
The raw image must be in FITS (Flexible Image Transport) format and
have a PDS label file that points to the location of the FITS image. You must input either the label file or the FITS file for the "TO" input
parameter. Projected images are not supported. Please note if the FITS file is given, the label file must
exist in the same directory or the program will throw an error.
This program will verify that the input files are valid by checking the
following label keyword values. An error will be thrown if any of these
criteria are not met.
INSTRUMENT_ID = MSI
LINE_SAMPLES = 537
LINES = 244
SAMPLE_DISPLAY_DIRECTION = RIGHT
LINE_DISPLAY_DIRECTION = UP
The output cube- successfully imported into ISIS goes through the following processes:
Convert the raw FITS image data to an ISIS cube.
Save the labels from the input PDS label file to the output ISIS cube. Note that FITS labels are not transferred.
Enlarge the image from 537 samples x 244 lines to 537 x 412 using the user-specified interpolation algorithm. Defaults to cubic convolution.
Flip the image vertically, i.e. across the horizontal axis.
Trim 33 pixels from the top, bottom, left and right sides. These
pixels along the borders will be set to nulls.
Name of the input NEAR MSI image file to be imported into ISIS
format. You may enter the label or the image file. If the image
file is given, the program will search in the same directory for a
label file with the same base name as the image file base name.
Type
filename
File Mode
input
Filter
*.lbl *.fit *.fits
Files:
TO
Description
Name of the ISIS output cube file that has been imported, enlarged,
flipped, and trimmed.
Type
cube
File Mode
output
Filter
*.cub
Scaling Parameters:
INTERP
Description
This is the type of interpolation to be performed on the input when
the image is enlarged from 537 samples x 244 lines to
537 samples x 412 lines.
Type
string
Default
CUBICCONVOLUTION
Option List:
Option
Brief
Description
CUBICCONVOLUTION
Cubic Convolution interpolation
Each output pixel is set to the value calculated by
a cubic convolution interpolation of the calculated input pixel.
NEARESTNEIGHBOR
Nearest Neighbor
Each output pixel is set to the pixel nearest the
calculated input pixel.
BILINEAR
Bi-Linear interpolation
Each output pixel is set to the value calculated by
a bi-linear interpolation of the calculated input pixel.
Examples
Example 1
Usage of this import application
Description
This example shows how to import an MSI fits file to the ISIS cube format using the label file.
Command Line
msi2isis
from=msi_raw_file.lbl to=imported.cub
The command line arguments to import a file to cube format.
GUI Screenshot
GUI Example
The application's GUI
Example with parameters set to import MSI raw image to a cube.
Input Image
Raw image
Original image
Parameter Name:
FROM
Example of raw NEAR MSI image without the enlarge, flip, and trim processes performed by msi2isis.
Output Image
Imported cube
Imported NEAR MSI cube
Parameter Name:
TO
Example of imported NEAR MSI image with the enlarge, flip, and trim processes applied.
History
Jeannie Backer
2013-03-27
Original version of msi2isis. References #1248.
Kristin Berry
2014-05-19
Updated to add labels from the input PDS label file to the output ISIS cube. References #2088.