NAME
fimhisto - Creates a histogram of the image extension.
USAGE
fimhisto infile outfile range binsize <nbins>
DESCRIPTION
FIMHISTO creates a histogram of an image extension within user defined
minimum and maximum values(range) inclusive. If these values are INDEF,
the minimum and maximum values are calculated from the input
image array. Options are provided to input either binsize OR the no. of bins.
In case, if binsize<=0, user is prompted for the no. of bins parameter
for the histogram.
PARAMETERS
infile [string]
The name of the input image file to create histogram for.
outfile [string]
The name of output file.
range[string]
The minimum and maximum value, inclusive, for the histogram. The values are
to be separated by 'comma'. For example, if minimum value is 2.0 and maximum
is to be calculated from the data, then user input looks like (2.0,INDEF)
binsize[float]
Size of each bin user wants to be. This value is in terms of the values
of the pixels. If binsize value is <=0, then user is asked for the no. of bins.
nbins[integer]
No. of bins for histogram. Binsize will be calculated depending on this
parameter. This parameter is prompted for if and only if user input for
binsize is <= 0. Thus if an user wants
no. of bins as input instead of binsize, then one should input binsize=0 or
any -ve no. so then user is asked for nbins parameter.
(clobber = no) [boolean])
Flag specifying whether or not a pre-existing file with the
same name as that requested as the output file from this task
will be overwritten.
EXAMPLES
1. To calculate histogram of an image extension, with minimum and maximum
values to be calculated from the input array, range parameter need to be INDEF
and with nbins=20, then
prompt> fimhisto infile outfile range=INDEF,INDEF binsize=0 nbins=20
or, minimum value =2.0 and maximum to be calculated from input array and
with binsize=3, then
prompt> fimhisto infile outfile range=2.0,INDEF binsize=3
BUGS
None Known
LOG OF SIGNIFICANT CHANGES
V1.0.0 (1997 August)
PRIMARY AUTHOR
Banashree M Seifert
CONTACT FOR PROBLEM
http://heasarc.gsfc.nasa.gov/cgi-bin/ftoolshelp
CATEGORY
August,1997 ftools.fimage