ISIS Application Documentation
tonematch  Standard View  TOC  Home 
Matches the tone of two, singleband images
Description
Categories
Groups
History
This application matches the tone of two singleband 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.
Name  Description 

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

POVERLAP  Projection Overlap 
MINCOUNT  Minimum number of points in overlapping area required for the overlap to be valid. 
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 
The match cube will be used to find the tone that the output cube should have.
Type  cube 

File Mode  input 
Filter  *.cub 
The resultant cube containing the tonematched image.
Type  cube 

File Mode  output 
Filter  *.cub 
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 
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 

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 
Jeff Anderson  19980112  Original version 
Elizabeth Ribelin  20050829  Documented and refactored 
Elizabeth Miller  20051122  Added appTest and poverlap option 
Elizabeth Miller  20060210  Moved to Photometry and Radiometry group in documentation 
Kimberly Oyama  20130114  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 Oyama  20140116  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. 