
.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.41 Mar2009
     </small><br><a href="../doc/scripthome.html">Scripts</a>
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH proc_catlines PL "11-MAR-2009   PL ploticus.sourceforge.net"

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

\fBproc catlines\fR displays individual plots, one per category in X.
Useful in comparing various entities, each of which have a displayable characteristics curve.
Typically line plots are rendered, but column bars are also possible.  Error bars and
data point symbols are optional.  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
\fBplotmode\fR
.ig >>
&nbsp; &nbsp;
.>>
\fClines | bars | symonly\fR
.IP \0
Controls the type of plot rendered for each category.
Default is \fClines\fR which gives lineplots.  If \fCbars\fR is specified bar graphs will be rendered instead
(and see the column bar options below).
If \fCsymonly\fR is specified no line plot or bar graph will be generated, and you must specify dpsymbol (see below) to 
plot data points only.  \fCbars\fR and \fCsymonly\fR are new in 2.41

.ig >>
<br><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 width of the plot region within the category space and allows for separating margins on each side.
Usable range of \fIh\fR is 0.2 to 0.8 or so.
For lineplots default is 0.6 ; for bars the default is set based on number of subcategories.

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

.LP
\fBlinedetails\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="linedetails.html">
.>>
\0linedetails
.ig >>
</a>
.>>
.IP \0
Color, line width, dash style for lineplot 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><br>
.>>

.SH Column bar options
You must specify \fCplotmode: bars\fR in order to use these options.  New in 2.41

.LP
\fBbarcolor\fR
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
Specify this attribute if you want all bars in a group to be this color.
Default is \fCgreen\fR.

.ig >>
<br><br>
.>>
.LP
\fBbarcolorlist\fR
.ig >>
&nbsp; &nbsp;
.>>
list of 
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
Specify this attribute if you want bars in a group to have different colors.
A comma- or space-delimited list of 
.ig >>
<a href="color.html">
.>>
\0colors.
.ig >>
</a>
.>>
.br
Example: \fCbarcolorlist:   green,red,blue

.ig >>
<br><br>
.>>
.LP
\fBbarlinewidth\fR
.ig >>
&nbsp; &nbsp;
.>>
\fIlinewidth\fR
.IP \0
Linewidth of bars.  Default is 2.0 ; use higher numbers for thicker bars, lower numbers for thinner bars.

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

.LP
\fBcrossover\fR
.ig >>
&nbsp; &nbsp;
.>>
\fIh\fR
.IP \0
If specified, values less than \fIh\fR will result in downward bars.
Typically specified as \fC0\fR so that negative values give downward bars.

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


.SH Data point options
Data point symbols can be rendered with lineplots (\fCplotmode: lines\fR) or alone (\fCplotmode: symonly\fR).
.LP
\fBdpsymbol\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="symboldetails.html">
.>>
\0symboldetails
.ig >>
</a>
.>>
.IP \0
Default is for small light-gray data point symbols to be rendered 
(specifically, \fCstyle=filled color=gray(0.7) shape=circle radius=0.02\fR).
Specify another 
.ig >>
<a href="symboldetails.html">
.>>
\0symboldetails
.ig >>
</a>
.>>
for a different data point symbol.
Specify \fCnone\fR to omit data points.

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

.SH Error bar options
Error bars will be rendered if \fCerrfield\fR is specified (see above).

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


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

.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>
<table><tr><td>
Ploticus is hosted at http://ploticus.sourceforge.net</td><td> &nbsp; </td><td>
<a href="http://sourceforge.net/projects/ploticus"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=38453&type=12" 
width="120" height="30" border="0" 
alt="Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads" /></a>
</td></tr></table>


</center>
.>>
