#set TITLE = "scat prefab"
#include top

.SH EXAMPLES 1 & 2
.ig >>
<center><table cellpadding=2 cellspacing=8><tr>
<td><img src="../prefabs/scat1.gif"></td><td><img src="../prefabs/scat2.gif"></td></tr>
</table></center>
.>>
.LP
.nf
Left:	pl  -prefab scat  data=data1  x=2  y=3  


Right:	pl  -prefab scat  data=data1  x=2  y=3  id=1 \\
	   xlbl="Total Ch"  ylbl="White Blood Cell Count"  corr=yes  


data1 file: 	A/J	1.39	331
		BALB/cJ	1.67	182
		C3H/HeJ	2.07	301
		..etc..



.fi
.SH EXAMPLE 3
.ig >>
<center><table cellpadding=2><tr>
<td><img src="../prefabs/scat3.gif"></td></tr>
</table></center>
.>>
.nf
pl  -prefab scat  data=data3  x=2  y=6  err=3  xerr=7  corr=yes \\
	  ptshape=triangle ptsize=0.08  ptcolor=red  "errcolor=gray(0.8)"

data3 file:
	129S1/SvImJ 0.4927 0.111 0.353 129S1/SvImJ 0.4080 0.0839 0.265
	A/J 0.5547 0.0768 0.243 A/J 0.6051 0.0656 0.207
	AKR/J 0.4125 0.0631 0.200 AKR/J 0.3653 0.0418 0.132
	...etc.
.fi

#include space

.LP
#set FILE = "prefabs.html#examples"
#set TAG = "How to run these examples"
#include link


#include space

.SH DESCRIPTION
\fBscat\fR is a 
#set FILE = "prefabs.html"
#set TAG = prefab
#include link
for producing 2-D scatterplots with optional point labeling, correlation, regression line,
and error bars.
Based on 
#set FILE = "scatterplot.html"
#set TAG = "proc scatterplot"
#include link
\0.

#include space

.SH PARAMETERS
#set FILE = "prefabs.html#std"
#set TAG = "standard prefab parameters"
#include link
are all supported.  \fBdata\fR, \fBx\fR and \fBy\fR are required.
.br
.br
.IP
\fBcorr\fR which, if \fCyes\fR, will cause correlation and regression 
to be computed and displayed;

.br
.br
.IP
\fBid\fR, a 
#set FILE = "attributetypes.html#dfield"
#set TAG = "data field" 
#include link
holding a data point identifier string; 

.br
.br
.IP
\fBxerr\fR, a 
#set FILE = "attributetypes.html#dfield"
#set TAG = "data field" 
#include link
holding values for horizontal error bars;

.br
.br
.IP
\fBptsym\fR, \fBptcolor\fR, and \fBptsize\fR, which control
the shape, color, radius, and fill style for the data points (see
#set FILE = "symboldetails.html"
#set TAG = "symboldetails"
#include link
), default is filled blue circle of radius 0.04

.br
.br
.IP
\fBcorrcolor\fR, the color for the regression line and correlation annotation (default green)

.br
.br
.IP
\fBidcolor\fR, the color for the id labels (default orange)

.br
.br
.IP
\fBerrcolor\fR, the color for the error bars (default gray(0.7)).

.br
.br
.IP
\fBcats\fR may be specified as \fCyes\fR to indicate that X data will be
processed as categories rather than continuous numerics.


#include bottom
