#set TITLE = "dist prefab"
#include top

.SH EXAMPLE 1
.LP
.ig >>
<center><table cellpadding=2><tr>
<td><img src="../prefabs/dist1.gif"></td></tr>
</table></center>
.>>
.LP
.nf
\fC	pl -prefab dist fld=1  data=data6  curve=yes  binsize=0.05 \\
	  barwidth=0.08  ygrid=yes \fR

	data6 file:
		0.017
		0.269
		0.178
		..etc.



.fi
.SH EXAMPLE 2
.ig >>
<center><table cellpadding=2><tr>
<td><img src="../prefabs/dist2.gif"></td></tr>
</table></center>
.>>
.LP
.nf
  pl -prefab dist  fld=1  data=data8  cats=yes  yrange=0  \\
     stubvert=yes  barwidth=0.05   ylbl="# Hits"   order=rev 

  data8 file:
	home
	kwindex
	details
	browseform
	..etc.
.fi
.LP
#include space
.LP
#set FILE = "prefabs.html#examples"
#set TAG = "How to run these examples"
#include link


#include space

.SH DESCRIPTION
\fBdist\fR is a 
#set FILE = "prefabs.html"
#set TAG = prefab
#include link
that computes and displays a frequency distribution (histogram)
on a data field.
The data file does not need to be ordered in any particular way.
The field may contain continuous numeric data, or alphanumeric values.
Continuous numeric data is the default, but
the \fBcats\fR option may be used to produce category distributions 
(each unique value having a bar).
With continuous numeric data, "bins" will be set up and values will
be placed into these bins (any alpha values will be lumped into one
"alpha" category).  
.LP
This prefab is based on
#set FILE = "tabulate.html"
#set TAG = "proc tabulate"
#include link
and
#set FILE = "bars.html"
#set TAG = "proc bars"
#include link
\0.

#include space

.SH PARAMETERS

#set FILE = "prefabs.html#std"
#set TAG = "standard prefab parameters"
#include link
are all supported except \fBx\fR, \fBy\fR, and \fBerr\fR.
\fBdata\fR is required.

.br
.br
.IP
\fBfld\fR (required) is the 
#set FILE = "attributetypes.html#dfield"
#set TAG = "data field"
#include link
that the frequency distribution will be computed on

.br
.br
.IP
\fBbinsize\fR is the size of one "bin" in numeric distributions.

.br
.br
.IP
\fBcats\fR may be given as \fCyes\fR if \fBfld\fR is not
continuous numeric data.

.br
.br
.IP
\fBcurve\fR may be given as \fCyes\fR or as a 
#set FILE = linedetails.html
#set TAG = "linedetails attribute"
#include link
to cause a bspline curve to be rendered along with the histogram.

.br
.br
.IP
\fBcolor\fR is the 
#set FILE = color.html
#set TAG = color
#include link
of the bars (default = pink)

.br
.br
.IP
\fBbarwidth\fR is the width of the bars

.br
.br
.IP
\fBsavetable\fR may be given in order to save a text representation of
the computed frequency distribution.  It may be a file name, \fCstderr\fR, or
\fCstdout\fR.

.br
.br
.IP
\fBorder\fR controls the order in which bars are drawn from left to right.  
By default this is \fCnatural\fR (alphabetical order). 
Allowable values are \fCmag\fR (from low to high), and \fCrev\fR (high to low).


#include bottom
