Home
About ISIS
Support
Download

ISIS 3

Documentation
Tutorials
Technical Documents

ISIS 2

Documentation
Tutorials
Technical Documents

Search

USGS

ISIS 3 Application Documentation


hist

Printer Friendly View | TOC | Home

Generates a histogram table of cube in text format

Overview Parameters

Description

This program reads a single band from a cube and creates a tabular representation of the histogram. If a band specification is not given for the input file then the program will default to using the first band. The output results can then be viewed in a graphical form by using your favorite spreadsheet (e.g., Excel) or other graphing package (e.g., IDL, GNU plotutils).

Categories


Related Applications to Previous Versions of ISIS

This program replaces the following application existing in previous versions of ISIS:
  • histplane

History

Tracie Sucharski2002-09-11 Original version
K Teal Thompson2002-11-21 Add example
K Teal Thompson2002-12-09 Make images smaller
Tracie Sucharski2002-12-09 TO parameter is now always output. Add FORMAT parameter.
K Teal Thompson2003-03-19 Added thumb and image directories.
Stuart Sides2003-04-04 Fixed problem with isiscvs not checking in the thumb and image directories.
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Jeff Anderson2003-08-27 Changed default extension handling mechansim
Stuart Sides2004-12-17 Fixed a bug for the text output option, where a c string was going out of bounds.
Jeff Anderson2005-05-23 Removed postscript capabilities due to camgraph difficulties with 64-bit compiling.
Elizabeth Miller2005-10-25 Added truth file to fix appTest
Jeff Anderson2006-10-18 Added NBINS, MINIMUM, and MAXIMUM parameters
Elizabeth Miller2007-01-08 Added plot of histogram in ui mode, and added parameters to set values on the plot
Steven Lambright2008-05-06 Histogram object no longer has SetRange, updated to use SetValidRange
Steven Lambright2008-05-12 Removed references to CubeInfo
Noah Hilt2008-08-01 Changed the plot window to the new HistogramToolWindow
Tyler Wilson2015-09-01 Changed SetValidRange call to SetBinRange so correct number of user-specified bins displayed in grapical/text output. See Ref #2188.

Parameter Groups

Files

Name Description
FROM Single plane of a cube to get statistics from
TO Output text file

Options

Name Description
MINIMUM Minimum DN value in histogram
MAXIMUM Maximum DN value in histogram
NBINS Bins in the histogram

Plot Options

Name Description
TITLE Plot Title
XAXIS X-Axis Title
FREQAXIS Frequency Y-Axis Title
PERCENTAXIS Percent Y-Axis Title
X

Files: FROM


Description

The file specification for the input cube. The histogram will be calculated for one plane only. The default plane is one (1).

Type cube
File Mode input
Filter *.cub
Close Window
X

Files: TO


Description

Output text file containing the tabular representation of the histogram.

Type filename
File Mode output
Internal Default None
Filter *.txt
Close Window
X

Options: MINIMUM


Description

Minimum DN value in histogram. If not entered it will automatically be computed.

Type double
Internal Default Computed
Less Than MAXIMUM
Close Window
X

Options: MAXIMUM


Description

Maximum DN value in histogram. If not entered it will automatically be computed.

Type double
Internal Default Computed
Close Window
X

Options: NBINS


Description

Number of bins in the histogram. If not entered it will automatically be computed.

Type integer
Internal Default Computed
Close Window
X

Plot Options: TITLE


Description

This will be the title for the plot of the histogram. The plot will only be shown in ui mode.

Type string
Internal Default Default
Close Window
X

Plot Options: XAXIS


Description

This will be the title for the x axis, which represents the pixel value (or DN), in the plot of the histogram. The plot will only be shown in ui mode.

Type string
Internal Default Default
Close Window
X

Plot Options: FREQAXIS


Description

This will be the title for the y axis to the right of the histogram plot, which represents the frequency of the pixel value. The plot will only be shown in GUI mode.

Type string
Internal Default Default
Close Window
X

Plot Options: PERCENTAXIS


Description

This will be the title for the y axis to the left of the histogram plot, which represents the percentage of pixel seen so far. The plot will only be shown in GUI mode.

Type string
Internal Default Default
Close Window