Home
About ISIS
Support
Download

ISIS 3

Documentation
Tutorials
Technical Documents

ISIS 2

Documentation
Tutorials
Technical Documents

Search

USGS

ISIS 3 Application Documentation


msi2isis

Printer Friendly View | TOC | Home

Import NEAR MSI files into ISIS3 format

Overview Parameters Example 1

Description

This program will import raw images, acquired from the Near Earth Asteroid Rendezvous - Shoemaker (NEAR Shoemaker) mission's Multispectral Imager (MSI) instrument, to ISIS3 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 ISIS3 goes through the following processes:
  • Convert the raw FITS image data to an ISIS3 cube.
  • Save the labels from the input PDS label file to the output ISIS3 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.

Categories


Related Objects and Documents

Applications


History

Jeannie Backer2013-03-27 Original version of msi2isis. References #1248.
Kristin Berry2014-05-19 Updated to add labels from the input PDS label file to the output ISIS3 cube. References #2088.

Parameter Groups

Files

Name Description
FROM Input NEAR MSI file to be converted to an ISIS3 cube
TO Output ISIS3 cube filename

Scaling Parameters

Name Description
INTERPType of interpolation for enlarge process
X

Files: FROM


Description

Name of the input NEAR MSI image file to be imported into ISIS3 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
Close Window
X

Files: TO


Description

Name of the ISIS3 output cube file that has been imported, enlarged, flipped, and trimmed.

Type cube
File Mode output
Filter *.cub
Close Window
X

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
CUBICCONVOLUTIONCubic Convolution interpolation Each output pixel is set to the value calculated by a cubic convolution interpolation of the calculated input pixel.
NEARESTNEIGHBORNearest Neighbor Each output pixel is set to the pixel nearest the calculated input pixel.
BILINEARBi-Linear interpolation Each output pixel is set to the value calculated by a bi-linear interpolation of the calculated input pixel.
Close Window

Example 1

Usage of this import application

Description

This example shows how to import an MSI fits file to the ISIS3 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.