NAME

mkhistogram -- print or plot the histogram of a data stream

USAGE

mkhistogram file

PARAMETERS

file

The name of the text file containing the data (may be STDIN).

nbins

The number of bins in the histogram.

z= INDEF, z2 = INDEF

The minimum and maximum histogram intensity. Z1 and z2 default to the data minimum and maximum.

listout = yes

List instead of plot the histogram.

device = "stdgraph"

The output graphics device.

DESCRIPTION

MKHISTOGRAM calculates the histogram of the data in the text file file using the parameters nbins , z1 and z2 . If the z1 or z2 are undefined the image min or max is used. If listout = no, the histogram is plotted on the graphics device specified by device . Otherwise the histogram is listed on the standard output.

EXAMPLES

1. Output the histogram of data to a file.

    cl> mkhisto magsdata nbins=100 > magsdata.hst

2. Plot the histogram of data between the 12.0 and 26.0 with a binsize if 0.5 on standard graph. Notice that the extra bin will contain points for which z2 is exactly 26.

    cl> mkhist magsdat nbins=29 z1=12.0 z2=26.0 li-

TIME REQUIREMENTS

BUGS

USE INSTEAD

plot.phistogram

SEE ALSO

images.imhistogram, fields