
.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: proc catlines</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>proc catlines</h2></td>
  <td align=right>
  <small>
  <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  Version 2.40 Jan'08
     </small><br><a href="../doc/scripthome.html">Scripts</a>
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH proc_catlines PL "15-JAN-2008   PL ploticus.sourceforge.net"

.ig >>
<center>
<a href="../gallery/catlines1.htm">
<img src="../gallery/catlines1.gif">
</a>
</center>
.>>

\fBproc catlines\fR displays individual lineplots, one per category in X.
Useful in comparing various entities, each of which have a displayable curve.
New in 2.40
.LP
Plot data set must be ordered on category then subcategory.
.LP
Categories must be set up in X (based on catfield, see below), and a numeric
axis in Y.


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

.SH Attributes
\fCcatfield\fR, \fCsubcatfield\fR, \fCvalfield\fR, and \fCsubcats\fR attributes \fBmust\fR all be specified.

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

.LP
\fBcatfield\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
A data field that contains primary category tags.
This is the same data field that plot area X axis categories should be based on.
There will be one curve drawn for each primary category.

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

.LP
\fBsubcatfield\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
A data field that contains secondary category tags.
Secondary categories determine plot position within a given curve.
Specify the set of allowable secondary categories in the \fCsubcats\fR attribute.

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

.LP
\fBvalfield\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
A data field that contains the numeric plottable value.

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

.LP
\fBsubcats\fR
.ig >>
&nbsp; &nbsp;
.>>
\fIlist\fR | \fCauto\fR
.IP \0
A comma-delmited or space-delimited list of allowable subcats, or else \fCauto\fR which causes 
the data set to be scanned to determine the list of allowable subcats at some performance penalty.  
The order found here determines the left-to-right plotting position.
.br
Example: \fCsubcats: A B C\fR
.br
Example: \fCsubcats: auto\fR

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

.LP
\fBerrfield\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
A data field that contains a numeric error bar value.  Optional.. if omitted no error bars will be drawn.
For example if valfield contains means, this field might contain SEM or SD.

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

.LP
\fBplotwidth\fR
.ig >>
&nbsp; &nbsp;
.>>
\fIh\fR
.IP
Controls the plot region within the category space.
Default is 0.6 which allows for a visible margin between primary categories.
Increase this value to diminish the margin, or decrease this value to get a bigger margin.

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

.LP
\fBselect\fR  
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="select.html">
.>>
\0select expression
.ig >>
</a>
.>>
.IP \0
Allows data rows to be selected for inclusion using a selection expression.
.br
Example: \fC@@2 = B\fR

.ig >>
<br><br><br>
.>>
.SH Appearance details 

.LP
\fBlinedetails\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="linedetails.html">
.>>
\0linedetails
.ig >>
</a>
.>>
.IP \0
Color, line width, dash style for the drawn curves.


.ig >>
<br><br>
.>>
.LP
\fBgapmissing\fR
.ig >>
&nbsp; &nbsp;
.>>
\fCyes | no\fR
.IP \0
Default is yes. 
If no, data points that are missing in any curve will be bridged.
If yes, missing data points cause the curve to be interrupted.


.ig >>
<br><br>
.>>
.LP
\fBdpsymbol\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="symboldetails.html">
.>>
\0symboldetails
.ig >>
</a>
.>>
.IP \0
If specified, causes each data point to be marked with a geometric point symbol
superimposed on top of the curve.

.ig >>
<br><br>
.>>
.LP
\fBaltsymbol\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="symboldetails.html">
.>>
\0symboldetails
.ig >>
</a>
.>>
.IP \0
If specified, defines an alternate symbol to be drawn when \fCaltwhen\fR condition is true.

.ig >>
<br><br>
.>>
.LP
\fBaltwhen\fR
.ig >>
<a href="select.html">
.>>
\0select expression
.ig >>
</a>
.>>
.IP \0
A conditional expression that, if true, causes the \fCaltsymbol\fR to be drawn instead of the 
\fCdpsymbol\fR.

.ig >>
<br><br>
.>>
.LP
\fBerrbardetails\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="linedetails.html">
.>>
\0linedetails
.ig >>
</a>
.>>
.IP \0
Color and line width for error bars, if any.


.ig >>
<br><br>
.>>
.LP
\fBtaillen\fR
.ig >>
&nbsp; &nbsp;
.>>
\fIh\fR
.IP \0
Size of error bar tails in inches (cm).

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



.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>
.>>
