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


ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


tonematch

Standard View | TOC | Home

Matches the tone of two, single-band images

Description
Categories
Groups
History


Description

This application matches the tone of two single-band images. It is very similar to the equalizer application, but is only used on two images and only works on single band images. The user can choose whether to match the tone of the entire image, or perform overlap matching using the projection information. The default behavior is to match the tones of the entire area of the input cube and the match cube.

First, tonematch collects statistics on each individual cube. It then uses this data to find a linear regression between the pixel values of the input cube and the match cube. The linear regression provides offset and gain values that are applied to the input cube, creating the output cube whose tone is equal to that of the match cube.


Categories


Related Objects and Documents

Applications


Parameter Groups

Files

Name Description
FROM Input single band cube
MATCH Match Cube (single band)
TO Output cube
OUTSTATS Output text file containing thorough equalization-related statistics

Option

Name Description
POVERLAP Projection Overlap
MINCOUNT Minimum number of points in overlapping area required for the overlap to be valid.

Files: FROM

Description

The pixels of the input cube will be altered using the base and multiplier found in the linear regression to make the tone of the output and match cubes equal.

Type cube
File Mode input
Filter *.cub

Files: MATCH

Description

The match cube will be used to find the tone that the output cube should have.

Type cube
File Mode input
Filter *.cub

Files: TO

Description

The resultant cube containing the tonematched image.

Type cube
File Mode output
Filter *.cub

Files: OUTSTATS

Description

This file will contain the statistics of the overlapping area along with the computed equalizing factors (OFFSET and GAIN). Since the output statistics are of the overlapping area, the POVERLAP option must be selected. Specifying this output file is optional.

Type filename
File Mode output
Internal Default None
Filter *.txt *.pvl *.lis *.lst

Option: POVERLAP

Description

This parameter allows the user to match the tone of the overlapping area of the cubes instead of matching the tone of the entire area of both cubes. If this option is set to TRUE, both cubes must have the same projection parameters and must overlap.

Type boolean
Default FALSE
Inclusions
  • OUTSTATS

Option: MINCOUNT

Description

If the number of points in the overlapping area meets or exceeds this value, the area is considered valid. If there are fewer points the output statistics may not be accurate.

Type integer
Default 1000

History

Jeff Anderson1998-01-12 Original version
Elizabeth Ribelin2005-08-29 Documented and refactored
Elizabeth Miller2005-11-22 Added appTest and poverlap option
Elizabeth Miller2006-02-10 Moved to Photometry and Radiometry group in documentation
Kimberly Oyama2013-01-14 Output the statistics used for the linear regression to the log. Updated documentation to correctly describe the POVERLAP option and to explain that this application only works on single band cubes. Fixes #1383.
Kimberly Oyama2014-01-16 Added the MINCOUNT option to allow the user to determine how much of the images need to overlap for the overlap to be considered valid. References #1383.