ISIS Application Documentation
Generates a histogram table of cube in text format
Description
Categories
Groups
History
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:
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
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
|
Files:
TO
Description
Output text file containing the tabular representation
of the histogram.
|
Type
| filename |
|
File Mode
| output |
|
Internal Default
| None |
|
Filter
|
*.txt
|
Options:
MINIMUM
Description
Minimum DN value in histogram. If not entered it will automatically be computed.
|
Type
| double |
|
Internal Default
| Computed |
|
Less Than
|
|
Options:
MAXIMUM
Description
Maximum DN value in histogram. If not entered it will automatically be computed.
|
Type
| double |
|
Internal Default
| Computed |
Options:
NBINS
Description
Number of bins in the histogram. If not entered it will automatically be computed.
|
Type
| integer |
|
Internal Default
| Computed |
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 |
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 |
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 |
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 |
History
| Tracie Sucharski | 2002-09-11 |
Original version
|
| K Teal Thompson | 2002-11-21 |
Add example
|
| K Teal Thompson | 2002-12-09 |
Make images smaller
|
| Tracie Sucharski | 2002-12-09 |
TO parameter is now always output. Add FORMAT parameter.
|
| K Teal Thompson | 2003-03-19 |
Added thumb and image directories.
|
| Stuart Sides | 2003-04-04 |
Fixed problem with isiscvs not checking in the thumb and image directories.
|
| Stuart Sides | 2003-05-16 |
Modified schema location from astogeology... to isis.astrogeology..."
|
| Stuart Sides | 2003-07-29 |
Modified filename parameters to be cube parameters where necessary
|
| Jeff Anderson | 2003-08-27 |
Changed default extension handling mechansim
|
| Stuart Sides | 2004-12-17 |
Fixed a bug for the text output option, where a c string was going out of bounds.
|
| Jeff Anderson | 2005-05-23 |
Removed postscript capabilities due to camgraph difficulties with
64-bit compiling.
|
| Elizabeth Miller | 2005-10-25 |
Added truth file to fix appTest
|
| Jeff Anderson | 2006-10-18 |
Added NBINS, MINIMUM, and MAXIMUM parameters
|
| Elizabeth Miller | 2007-01-08 |
Added plot of histogram in ui mode, and added parameters to set values on the
plot
|
| Steven Lambright | 2008-05-06 |
Histogram object no longer has SetRange, updated to use SetValidRange
|
| Steven Lambright | 2008-05-12 |
Removed references to CubeInfo
|
| Noah Hilt | 2008-08-01 |
Changed the plot window to the new HistogramToolWindow
|
| Tyler Wilson | 2015-09-01 |
Changed SetValidRange call to SetBinRange so correct number
of user-specified bins displayed in grapical/text output.
See Ref #2188.
|
| Curtis Rose | 2016-06-10 |
Changed the application to fail immediately if the TO argument is not
entered from the commandline. Fixes #3914.
|
| Austin Sanders | 2020-06-08 |
Updated logic such that min/max values are no longer calculated from .cub
if values are provided by the user. Fixes #3881.
|
| Kaitlyn Lee | 2020-06-11 |
Added "Pixels Below Min" and "Pixels Above Max" to the CSV output and changed how the data is
outputted. Originally, the CSV output and the GUI histogram would use the DN value in the
middle of a bin to represent that bin. That is, the CSV output used to have a "DN" value that
was the bin's middle pixel DN. This was not intuitive to users. Removed the "DN" value and added "MinInclusive" and "MaxExclusive" to the CSV so that bins are represented by their min/max values. These changes were also reflected in the histrogram creation. The x-axis is now based off of the min value of a bin instead of the middle value. These changes were made alongside changes made to Histogram and cnethist.
|
| Kristin Berry | 2020-06-25 |
Re-added the ability to set number of bins without setting min/max values after the last update.
Follow-on to #3881.
|
| Stuart Sides | 2020-09-02 |
Added GUI helper for filling in computed min/max. Fixed #3880.
|