ISIS Application Documentation
msi2isis | Standard View | TOC | Home |
Import NEAR MSI files into ISIS format
Description
Categories
Groups
Examples
History
Shortly after orbit insertion around Eros, the NEAR spacecraft experienced a failed burn that contaminated the MSI instrument with hydrazine. The NEAR/MSI team developed a preliminary remediation [1] of the blur effect of the contamination using FFTs to correct the point spread function (PSF). A residual side effect of this correction was degradation of ~33 pixels on all edges of the images. As a result, by default, NEAR/MSI images are trimmed 33 pixels around all edges after import. MSI images requiring trmming of these data are of the form m0132069107f4_2p_iof_dbl.img.
Additional remediation work of the PSF function used to correct MSI
images was performed by Golish [2] that resulted in an enhanced PDF
correction that did not introduce edge-artifacts as was seen in [1].
The TRIM parameter was added to optionally retain the 33 pixels around
the image edges when the dataset from [2] is used. File names that do
not require trimming are of the form m0132069107f4_2p_iof_gbl.img (note
the
Note the images produced by Golish [2] have already been expanded. So msi2isis was altered to check for the expanded size (in lines only) to allow for the full frame to be ingested. In this case, the intermediate step to interpolate in the line dimension to expand the the number of lines from 244 to 412 is not needed and excluded from ingestion processing. All other (label) checks were left to complete the validation of the input files.
Name | Description |
---|---|
FROM | Input NEAR MSI file to be converted to an ISIS cube |
TO | Output ISIS cube filename |
Name | Description |
---|---|
INTERP | Type of interpolation for enlarge process |
Name | Description |
---|---|
TRIM | Trim all image border edges |
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 |
Name of the ISIS output cube file that has been imported, enlarged, flipped, and trimmed.
Type | cube |
---|---|
File Mode | output |
Filter | *.cub |
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: |
|
This parameter is provided to turn off trimming 33 pixels from the edge of images. When TRIM=TRUE, 33 pixels on all sides of the expanded image are set to NULL but not removed. The source of this degradation is image edge-effects created from the remediation of hydrazine contamination of the MSI filters. If TRIM=FALSE, no pixels around the edge of the images are NULLed. This is useful to retain image edges that originate from several alternative archive sources [2].
Type | boolean |
---|---|
Default | true |
Usage of this import application
GUI Example
|
The application's GUI Example with parameters set to import MSI raw image to a cube. |
Raw image
|
Original image
Parameter Name:
FROM Example of raw NEAR MSI image without the enlarge, flip, and trim processes performed by msi2isis. |
Imported cube
|
Imported NEAR MSI cube
Parameter Name:
TO Example of imported NEAR MSI image with the enlarge, flip, and trim processes applied. |
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. |
Kris Becker | 2019-08-15 | Correct SpacecraftClockStartCount/SpacecraftClockStopCount values to be compatible with NAIF SCLK kernels that enables use in the camera model. Save original values in new keywords prepended with "Original". |
Kris Becker | 2021-02-19 | Added the TRIM parameter to optionally trim data around the edges of some MSI images due to degradation resulting from remediation of the PSF. |