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

percent

Standard View | TOC | Home

Obtains the DN value at a percent in a histogram

Description
Categories
Groups
Examples
History

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.

Categories

Related Objects and Documents

Applications

Parameter Groups

Files

Name Description
FROM Filename of a cube
TOText file

Selection

Name Description
PERCENTAGE Histogram percentage to return

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)

Examples

Example 1

percent.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

percent GUI

Example GUI

Screenshot of GUI with parameters filled in to perform the percent operation

Input Image

Input image

Input image for percent

Parameter Name: FROM

This is the input image f332s28.cub

Output Images

This is the text file percent.txt.

Output text file

Parameter Name: TO

Output text file shown in editor giving results of the percent application.

This is the text file multiple-percents.txt.

Results of the percent application when multiple percentages are requested.

History

Jeff Anderson2002-10-25 Original version
K Teal Thompson2002-11-25 Add example
K Teal Thompson2003-03-28 Make images smaller.
Stuart Sides2003-04-04 Fixed problem with isiscvs not checking in the thumb and image directories.
Kim Sides2003-05-13 Added application test
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Jeff Anderson2003-06-03 Updated application test due to compiler optimizations
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Jeff Anderson2003-08-27 Change default extension handling mechanism
Stuart Sides2003-11-07 Modified results pvl to not include the results group
Jacob Danton2006-01-23 Fixed appTest to comply to changes in String
Steven Lambright2008-05-13 Removed references to CubeInfo