ISIS Application Documentation
histmatch | Printer Friendly View | TOC | Home |
Match histograms of 2 cubes
| Overview | Parameters | Example 1 | Example 2 |
Description
This program takes in two input images, FROM and MATCH, and uses their histograms to compute stretch pairs. The data
in the stretch depends on which matching algorithm is chosen. If Culmulative Distribution Function (CDF) is chosen,
the histogram data will be stored into stretch pairs at regular intervals, the default being every one percent between
0.5 and 99.5 percent. If MODE is chosen, only the histogram data at the endpoints and mode are stored. The
pixels from the input image are remapped based on the data in the stretch pairs and the results are written to
a new cube file. This is useful for tone matching two images. The following figures
illustrate what is happening. Band 1 is FROM, Band 6 is MATCH, and CDF and Mode are two different output cubes. The
blue line is the histogram and the red line is the cumulative distribution.
Notice how the endpoints, mode, and overall shape of Band 1's histogram is now roughly equivalent to Band 6. CategoriesRelated Objects and DocumentsApplicationsHistory
|
| U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 02/21/2025 19:28:11 |
Parameter GroupsFiles
Algorithm
Histogram Options
|
| U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 02/21/2025 19:28:11 |
Files: FROM
Description
This file will have its histogram reshaped to resemble MATCH's histogram
| Type | cube |
|---|---|
| File Mode | input |
| Filter | *.cub |
Files: MATCH
Description
This file's histogram will be matched by FROM
| Type | cube |
|---|---|
| File Mode | input |
| Filter | *.cub |
Files: TO
Description
The resultant cube containing the altered input file
| Type | cube |
|---|---|
| File Mode | output |
| Filter | *.cub |
Algorithm: STRETCH
Description
This parameter specifies how the histogram will be stretched. The options are to stretch by by percentage (CDF), or by mode (Mode).
| Type | string | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Default | CDF | |||||||||
| Option List: |
|
Histogram Options: MINPER
Description
Minimum cut-off value for the histogram
| Type | double |
|---|---|
| Default | 0.5 |
| Minimum | 0.0 (inclusive) |
| Less Than | MAXPER |
Histogram Options: MAXPER
Description
Maximum cut-off value for the histogram
| Type | double |
|---|---|
| Default | 99.5 |
| Maximum | 100.0 (inclusive) |
Histogram Options: INCREMENT
Description
Percentage increment for the histogram
| Type | integer |
|---|---|
| Default | 1 |
| Minimum | 1 (inclusive) |
| Less Than | MAXPER |
Example 1Peaks histogram matching with CDF Description
This example shows the results of histogram matching using the cumulative distribution function.
Command Line
histmatch
from=../peaks.cub+1 match=../peaks.cub+6 stretch=cdf to=../result.cub
Use CDF matching to adjust Band 1's histogram to resemble Band 6's histogram
GUI Screenshot
Input Images
Output Images
|
![Histmatch Gui](javascript:popUpNewWindow ("assets/image/histmatchgui.jpg",500, 500))
![Input Peaks (Band 1) image](javascript:popUpNewWindow ("assets/image/FROMparameter.jpg",500, 500))
![Input Peaks (Band 1) image](javascript:popUpNewWindow ("assets/image/band1plot.jpg",500, 500))
![Input Peaks (Band 6) image](javascript:popUpNewWindow ("assets/image/MATCHparameter.jpg",500, 500))
![Input Peaks (Band 6) image](javascript:popUpNewWindow ("assets/image/band6plot.jpg",500, 500))
![Output image showing results of the CDF histogram matching.](javascript:popUpNewWindow ("assets/image/CDFTOparameter.jpg",500, 500))
![Output image](javascript:popUpNewWindow ("assets/image/cdfplot.jpg",500, 500))
| U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 02/21/2025 19:28:11 |
Example 2Peaks histogram matching with mode Description
This example shows the results of histogram matching using the match mode function.
Command Line
histmatch
from=../peaks.cub+1 match=../peaks.cub+6 stretch=mode to=../result.cub
Use mode matching to adjust Band 1's histogram to resemble Band 6's histogram
Input Images
Output Images
|
![Output image showing results of the modal histogram matching.](javascript:popUpNewWindow ("assets/image/MODETOparameter.jpg",500, 500))
![Output image](javascript:popUpNewWindow ("assets/image/modeplot.jpg",500, 500))
| U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 02/21/2025 19:28:11 |