ISIS Application Documentation
percent | Printer Friendly View | TOC | Home |
Obtains the DN value at a percent in a histogram
| Overview | Parameters | Example 1 |
Description
This program will output the DN value at a cumulative
percentage in a histogram. For example, requesting
the 50% DN will output the median. Values such as
the 0.5% and 99.5% are good for selecting minimums and
maximums which do not include outliers. The histogram
will be obtained from a single band in the input cube and
is identified using the band specifier (e.g., file.cub:5).
In general, this program is used
within batch jobs, perl programs, or other scripting
languages. The value(s) will be written to the output
text file specified by the parameter TO and it can
be extracted using the "getkey" program. If multiple
percents were requested, the values are printed to the
text file in the same order as the requested percents
and are comma delimited.
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 21:48:38 |
Parameter GroupsFiles
Selection
|
| 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 21:48:38 |
Files: FROM
Description
Compute the histogram using this cube file. The program operates on only one band and therefore a band specifier is required (e.g., file.cub:3)
| Type | cube |
|---|---|
| File Mode | input |
| Filter | *.cub |
Files: TO
Description
A text file in label format which will contain the results of this program. This file can be used inconjunction with the "getkey" program in order to pass the results to another program.
| Type | filename |
|---|---|
| File Mode | output |
| Internal Default | None |
Selection: PERCENTAGE
Description
This parameter indicates the cumulative percentage to examine in the histogram. The DN value at that percentage will be output by this program. For example, PERCENTAGE=50 will return the median of the image. When entering multiple percentages, be sure they are comma delimited.
| Type | string |
|---|---|
| Minimum | 0.0 (exclusive) |
| Maximum | 100.0 (exclusive) |
Example 1percent.txt Description Use text file output
Command Line
percent f=../IN/f332s28.cub t=OUT/percent.txt p=50
Set TO parameter to percent.txt
GUI Screenshot
Input Image
Output Images
|
![percent GUI](javascript:popUpNewWindow ("assets/image/percentGui.jpg",487, 251))
![Input image](javascript:popUpNewWindow ("assets/image/f332s28.jpg",500, 439))
![This is the text file percent.txt.](javascript:popUpNewWindow ("assets/image/percentTxt.jpg",410, 200))
![This is the text file multiple-percents.txt.](javascript:popUpNewWindow ("assets/image/mPercentTxt.JPG",610, 300))
| 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 21:48:38 |