ISIS Application Documentation
Matches the tone of two, single-band images
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
Applications
History
| Jeff Anderson | 1998-01-12 |
Original version
|
| Elizabeth Ribelin | 2005-08-29 |
Documented and refactored
|
| Elizabeth Miller | 2005-11-22 |
Added appTest and poverlap option
|
| Elizabeth Miller | 2006-02-10 |
Moved to Photometry and Radiometry group in documentation
|
| Kimberly Oyama | 2013-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 Oyama | 2014-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.
|
|
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
|
|
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 |