histplane Documentation

histplane - Create histogram(s) of image bands in a cube.
This program creates a histogram of frequency vs. DN for each spatial-
spatial core and back plane specified in the SFROM parameter in a
standard ISIS 3D cube file.  Each image plane (samples x lines) is
processed separately and a character "plot"  histogram is written to
the session log file for each plane chosen.  The DN value of each
point within the requested subarea of the image plane is used to
compute the mean, standard deviation, and the skew coefficient with and
without the saturated DN level, for each selected band. The program
always works in the 8-bit range (0 - 255), so 16- and 32-bit data are
scaled using the RANGE parameters.  The histogram(s) is (are) written
to the session log file.

Programmer: Debbie Cook  U.S.G.S., Flagstaff

Input cube file name
  (default extension is .cub)

NONE

Input subcube specifier

" "

Automatically select range
(YES/NO)

YES

Min/max to list in histogram

1.,254.

Number of histogram bins to use

254

Title for histogram

The follwing parameters are
output only

--

Number of NULL values

LOCAL1

Number of low representation
values

LOCAL2

Number of low instrument values

LOCAL3

Number of high representation
values

LOCAL4

Number of high instrument values

LOCAL5

Number of values below minimum

LOCAL6

Number of values above maximum

LOCAL7

Minimum value in histogram

LOCAL8

Maximum value in histogram

LOCAL9

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".CUB" will be assumed.
SFROM	Input subcube specifier. This selects the desired sub-area of the input cube file that is to be passed to the program and/or propagated to the output file. See the ISIS User's Manual for details.
AUTO	Flag to automatically select the range for each plane by finding the minimum and maximum DN value. If AUTO=NO, then the RANGE values are used for each plane. Otherwise the program calculates the DN range for each selected plane.
RANGE	The values of the first and last histogram bins. Data outside this range is counted as saturated.
NBINS	The number of bins to create in the histogram. The program calculates the bin size as RANGE/NBINS.
TITLE	Enter an optional string to place in the session log file to identify the histogram(s). This parameter is limited to 128 characters.