Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Public Release
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


desmile

Standard View | TOC | Home

Resample an image to correct for spectral smile

Description
Categories
Groups
History


Description

This program will spectrally resample an image. A common use is to correct for spectral smile. The pixels of each spectrum must be spatially aligned (i.e., The pixel at (sample, line, band) (1,1,1) represents the same point on the target body as (1,1,2), and (1,1,3), .... and so on for all spectra in the image.) For instruments where the spectra are not spatially aligned, the ISIS program cam2map can be used to project the cube.

The program requires two spectral definition files as input. See the parameters SMILEDEF and OBJECTIVE for specifics. SMILEDEF is used to define the wavelength and filter width of each element in the sensor. OBJECTIVE is used to define the wavelength and filter width of the pixels in the output cube.

Spectral definitions can have multiple sections. Each section represents the wavelength and filter width of a subset of bands. For example: a 256 band image may have two sections, where the first 200 entries define the wavelength centers and filter widths for 2.489 to 1.2204 um, and the last 56 entries define the wavelength centers and filter widths for 2.2623 to 2.0898 um. Each section is defined by a reversal of the wavelength center values (i.e., 2.2, 2.3, 2.20, 2.25, 2.30 would define two sections with two entries in the first and three in the second). The input and output spectral definitions must have the same number of sections, and should contain wavelengths in the same range. Spectral resampling will not cross section boundaries.

WARNING: This program is computationally intense and may take a long time to process large cubes.


Categories


Parameter Groups

Files

Name Description
FROM Multi-band cube with a spectral smile that needs to be corrected.
TO Output ISIS cube for the spectral smile corrected cube
SMILEDEF Spectral definition of the input cube
OBJECTIVE Desired spectral definition of the output cube

Files: FROM

Description

Use this parameter to select the file name of a multi-band cube with spectral smile that needs to be corrected. The cube must have an associated ISIS camera model and may be projected as long as the camera can still be used (i.e., The instrument and kernels groups in the label are intact). See the main description for information about how this cube must be spatially aligned.

Type cube
File Mode input
Filter *.cub

Files: TO

Description

The output cube file that will contain the smile-corrected cube. This cube will be created using the same number of samples and lines as the input cube (FROM) and the number of bands in the OBJECTIVE spectral definition.

Type cube
File Mode output
Filter *.cub

Files: SMILEDEF

Description

Spectral definition file containing center wavelength and filter width information for each element of the sensor. Typically elements are the pixels of the sensor, requiring a two-dimensional set of wavelength center and filter width pairs. Elements can also be defined as the lines of the sensor, requiring a one-dimensional set of wavelength center and filter width pairs. The former case is typically used to correct spectral smile and the latter case to to spectrally resample an image that does not contain spectral smile.

The two-dimensional definition is supported as a ISIS cube. The spectral definition cube must have the same number of samples as the sensor, a number of bands equal to the number of lines on the sensor, and two lines. The first line contains the center wavelengths and the second contains the filter widths.

The one-dimensional definition is supported as a text file with comma separated values. Each line contains the information for one band. Each line has center wavelength and filter width separated by a comma.

Type cube
File Mode input
Filter *.cub

Files: OBJECTIVE

Description

The spectral definition desired for the output cube. Each spectrum of the input cube will be resampled to fit this definition. Both one-dimensional and two-dimensional definitions are allowed. The one-dimensional type is used to flatten out a spectral smile. See the description for the SMILEDEF parameter for more information regarding spectral definition files.

Type filename
File Mode input
Filter *.csv

History

Stuart Sides and Kristin Berry2015-06-15 Original version
Kristin Berry2015-11-06 Added history to desmile output.