.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>ploticus: scat prefab</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550><tr>
<td>
  <table cellpadding=2 width=550><tr>
  <td><br><h2>scat prefab</h2></td>
  <td align=right>
  <small>
  <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  Version 2.33 Jun'06
     </small><br><a href="../doc/prefabs.html">Prefabs</a>
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH scat_prefab PL "02-JUN-2006   PL ploticus.sourceforge.net"

.ig >>
<center><a href="prefab_scat_ex.html"><img src="../gallery/prefab_img/scat2thm.gif" border=0>
 <br><b>View the scat prefab examples</a></b><br><br></center>
.>>


.LP
\fBscat\fR is a 
.ig >>
<a href="prefabs.html">
.>>
\0prefab
.ig >>
</a>
.>>
for producing 2-D scatterplots with optional point labeling, correlation, regression line,
and error bars.  Up to four groups can be displayed, although some options apply only to the first set.

.ig >>
<br><br><br>
.>>

.SH Parameters

.ig >>

<table cellpadding=2 bgcolor=A0A0A0 width=600>

<tr bgcolor=FFFFEC align=center><td><b>Prefab<br>parameter<br>name</td><td>Data type</td>
<td>Default</td><td>Description</td>
<td>Examples<br><small>(ignore line wrapping)</td></tr>


<tr bgcolor=FFFFFF>
<td><b><a href="prefab_stdparms.html">Standard parameters</a></td>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td colspan=2>All of the <a href="prefab_stdparms.html">standard prefab parameters</a> may be used.
You <font color=D00000>must specify</font> <b>data</b> (the name of the input data file).
</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>x<br><br>x2<br>x3<br>x4</td>
<td><a href="atypes.html#dfield">data field</a></td>
<td><b>x</b> <font color=D00000>must be specified</font></td>
<td><nobr>Identifies the data field(s) that will hold</nobr> X component for the
first, second, third, and fourth point sets respectively.</td>
<td><tt>x=2<br><br>x=pmb x2=pmc</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>y<br><br>y2<br>y3<br>y4</td>
<td><a href="atypes.html#dfield">data field</a></td>
<td><b>y</b> <font color=D00000>must be specified</font></td>
<td><nobr>Identifies the data field(s) that will hold</nobr> Y component for the
first, second, third, and fourth point sets respectively.</td>
<td><tt>y=3<br><br>y=smb y2=smc</td>
</tr>


<tr bgcolor=FFFFFF>
<td><b><b>ptsym<br><br>ptsym2<br>ptsym3<br>ptsym4</td>
<td>circle </tt><br>or<br><tt> square </tt><br>or<br><tt> triangle </tt><br>or<br><tt> diamond </tt><br>or<br><tt> downtriangle </td>
<td>&nbsp;</td>
<td>Controls the shape of the data point symbol(s).
Note: the scat prefab uses the new direct-pixel data points whenever possible
(eg. <tt>circle</tt> is converted internally to <tt>pixcircle</tt>)
</td>
<td><tt>ptsym=square</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b><b>ptsize<br><br>ptsize2<br>ptsize3<br>ptsize4</td>
<td><a href="atypes.html#punits">inches or cm</a></td>
<td>0.04</td>
<td>Controls the size of the data point symbol(s).</td>
<td><tt>ptsize=0.07</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b><b>ptcolor<br><br>ptcolor2<br>ptcolor3<br>ptcolor4</td>
<td><a href="color.html">color</a></td>
<td>&nbsp;</td>
<td>Controls the color of the data point symbol(s).</td>
<td><tt>ptcolor=gray(0.4)</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b><b>ptstyle</td>
<td><tt>filled</tt> or <tt>outline</tt></td>
<td><tt>filled</td>
<td>Determines whether all data point symbols will be filled (solid color) or outline shape.</td>
<td><tt>ptstyle=outline</td>
</tr>


<tr bgcolor=FFFFEC>
<td colspan=5>
<br>The default for the 1st set of data points is filled blue circle.
<br>The default for the 2nd set of data points is filled red square.
<br>The default for the 3rd set of data points is filled black diamond.
<br>The default for the 4th set of data points is filled blue triangle.
<br>
<br>
<br>
</td></tr>


<tr bgcolor=FFFFFF>
<td><b>cluster</td>
<td><tt>yes</tt> or <tt>no</td>
<td><tt>no</td>
<td>Clustering forces duplicate (or near-duplicate) points to be visible by offsetting duplicate points slightly.</td>
<td><tt>cluster=yes</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>cats</td>
<td><tt>yes</tt> or <tt>no</td>
<td><tt>no</td>
<td>If <tt>yes</tt>, indicates that X data will be processed as categories rather than continuous numerics.</td>
<td><tt>cats=yes</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>corr</td>
<td><tt>yes</tt> or <tt>no</td>
<td>no</td>
<td>Compute and display correlation and regression curve.
This is available for the first set of points only.</td>
<td><tt>corr=yes</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>corrcolor</td>
<td><a href="color.html">color</a></td>
<td><tt>green</td>
<td>Color of the regression line and correlation annotation.</td>
<td><tt>corrcolor=black</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>id</td>
<td><a href="atypes.html#dfield">datafield</a></td>
<td>&nbsp;</td>
<td>A data field holding data point identifier strings.
This is available for the first set of points only.</td>
<td><tt>id=5<br><br>id=desc</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>idcolor</td>
<td><a href="color.html">color</a></td>
<td>orange</td>
<td>Color of the id labels</td>
<td><tt>idcolor=gray(0.5)</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>err<br><br>err2</td>
<td><a href="atypes.html#dfield">datafield</a></td>
<td>&nbsp;</td>
<td>If specified, this data field causes vertical error bars to be rendered for
the first (or second) set of data points.  The data field should hold error amounts related
to <b>y</b> (or <b>y2</b>), such as standard deviations.</td>
<td><tt>xerr=5<br><br>xerr=sd</td>
</tr>

<tr bgcolor=FFFFFF>
<td><b>xerr<br><br>xerr2</td>
<td><a href="atypes.html#dfield">datafield</a></td>
<td>&nbsp;</td>
<td>If specified, this data field causes horizontal error bars to be rendered for
the first (or second) set of data points.  The data field should hold error amounts
related to <b>x</b> (or <b>x2</b>) such as standard deviations.</td>
<td><tt>xerr=5<br><br>xerr=sd</td>
</tr>


<tr bgcolor=FFFFFF>
<td><b>errcolor</td>
<td><a href="color.html">color</a></td>
<td>gray(0.7)</td>
<td>Color for the error bars (default gray(0.7))</td>
<td><tt>errcolor=red</td>
</tt>

<tr bgcolor=FFFFFF>
<td><b>maxinpoints</td>
<td>n</td>
<td></td>
<td>If doing a regression curve and there are more than 1000 data points, use this parameter to indicate the
maximum number of data points. version 2.33+</td>
<td><tt>maxinpoints=20000</td>
</tt>

</table>
.>>

.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif"> 
</center>
</td></tr>
</table>
<br>
<center>
Ploticus is hosted at http://ploticus.sourceforge.net <br>
<img src="http://sourceforge.net/sflogo.php?group_id=38453" width="88" height="31" border="0" alt="SourceForge Logo">
</center>
.>>
