Home
About ISIS
Support
Download

ISIS 3

Documentation
Tutorials
Technical Documents

ISIS 2

Documentation
Tutorials
Technical Documents
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.
Curtis Rose2016-06-10 Changed the application to fail immediately if the TO argument is not entered from the commandline. Fixes #3914.
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: 07/13/2023 15:21:38
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