Level 2 Help for HIST2D
INP
The file name of the three-dimensional input file used to generate the histogram
OUT
The two-dimensional histogram file name generated by this program
TOUT
The test file output generated by this program is a histogram of the band con-
taining the greatest DN value. The default name for this output is HIST.TST.
This file is of the same format as HISTGEN output and should be used for com-
parison to HISTGEN output.
LIMITS
Histogram bin range in data number units (DNs). Defaults are (0,255) for byte
data; (0,32767) for halfword data; and (-32752,32767) for halfword data of
calibration type RADIANCE or IOF.
RLIMIT
This sets a lower limit to valid floating point (REAL*4) data, which can be
useful for treating ISIS data which assigns the lower end of the range to
"special values". Note that this is platform-dependent; the default
(0xFF7FFFFA) is for IEEE floating point.
EXCLUDE
Variable to exclude DN 0, or -32768 for LIMITS=(-32768,upper_value),of 3-D input
file from histogram bin range. Default value is not to exclude DN 0 from
histogram processing.
FORMAT
Data format - byte or half - of two-dimensional histogram file.
Default value is BYTE.
SINC
Increment through input file by SINC number of samples to speed histogram
generation. Default value is 1.
LINC
Increment through input file by LINC number of lines to speed histogram
generation. Default value is 1.
BINC
Increment through input file by BINC number of bands to speed histogram
generation. Default value is 1.
SL
Window parameter of input file; first line of input file to be included in the
processing of the histogram. Default value is 1.
SS
Window parameter of input file; first sample of input file to be included in the
processing of the histogram. Default value is 1.
SB
Window parameter of input file; first band of input file to be included in the
processing of the histogram. Default value is 1.
NL
Number of lines of input file to be used in the processing of the histogram.
Default value is the number of lines in VICAR label of input file.
NS
Number of samples of input file to be used in the processing of the histogram.
Default value is the number of samples in VICAR label of input file.
NB
Number of bands of input file to be used in the processing of the histogram.
Default value is the number of bands in VICAR label of input file.
OUT_NL
Number of desired lines in output. Default is 512.
OUT_NS
Number of desired samples in output. Default is 512.
REPLIC
Keyword to replicate the number of bands to fit within 512. The default is
not to replicate, 'NOREP.
DN
Keyword to control the y-axis or DN scale of the two-dimensional histogram.
Possible y-axis scales are radiance in units uWatt/m**2/micron/steradian
(RAD), Bidirectional Reflectance (Radiance / SolarFlux) (IOF), or raw DN
(DN). Default is DN.
LOG
Keyword to specify that the logarithm be applied to the histogram. This
allows for a greater range of frequencies to be displayed, thus increasing
resolution of the histogram frequencies. Valid keywords are LOG and NOLOG.
LOG is the default.
TEST
This keyword controls whether output files and screen displays are printed
which are used for verification of the correct operation of the program. This
option is for the software developers' and testers' use. The following are
output to screen: band number at which maximum DN occurs in histogram plot;
scale of the Y-axis in terms of DN per pixel; scale of histogram file's DN to
histogram's frequency axis. An output histogram is also generated and is
specified by the parameter TOUT. It is the histogram of the band at which
maximum DN of all bands occurs.
BREAK_UM
Wavelength (in microns) below which Radiance is divided by Solar Flux when
displaying the histogram. This can prevent the long-wavelength end of the
histogram for cool bodies illuminated by sunlight from being overwhelmed by
the bright shorter wavelengths.