<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/11/09 12:56:13. -->
<!-- Do not edit! -->
<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>
<title>Manual page for proc_catlines(PL)</title>
</head>
<body>
<center>
<a href="../gallery/catlines1.htm">
<img src="../gallery/catlines1.gif">
</a>
</center>
<b>proc catlines</b> displays individual plots, one per category in X.<tt> </tt>
Useful in comparing various entities, each of which have a displayable characteristics curve.<tt> </tt>
Typically line plots are rendered, but column bars are also possible. Error bars and
data point symbols are optional. New in 2.40
<p>
Plot data set must be ordered on category then subcategory.<tt> </tt>
<p>
Categories must be set up in X (based on catfield, see below), and a numeric
axis in Y.<tt> </tt>
<br><br><br>
<h2>Attributes</h2>
<tt>catfield</tt>, <tt>subcatfield</tt>, <tt>valfield</tt>, and <tt>subcats</tt> attributes <b>must</b> all be specified.<tt> </tt>
<br><br>
<p>
<b>plotmode</b>
<tt>lines | bars | symonly</tt>
<dl>
<dt> <dd>
Controls the type of plot rendered for each category.<tt> </tt>
Default is <tt>lines</tt> which gives lineplots. If <tt>bars</tt> is specified bar graphs will be rendered instead
(and see the column bar options below).<tt> </tt>
If <tt>symonly</tt> is specified no line plot or bar graph will be generated, and you must specify dpsymbol (see below) to
plot data points only. <tt>bars</tt> and <tt>symonly</tt> are new in 2.41
<br><br><br>
</dl>
<p>
<b>catfield</b>
<a href="attributetypes.html#dfield">
dfield
</a>
<dl>
<dt> <dd>
A data field that contains primary category tags.<tt> </tt>
This is the same data field that plot area X axis categories should be based on.<tt> </tt>
There will be one curve drawn for each primary category.<tt> </tt>
<br><br><br>
</dl>
<p>
<b>subcatfield</b>
<a href="attributetypes.html#dfield">
dfield
</a>
<dl>
<dt> <dd>
A data field that contains secondary category tags.<tt> </tt>
Secondary categories determine plot position within a given curve.<tt> </tt>
Specify the set of allowable secondary categories in the <tt>subcats</tt> attribute.<tt> </tt>
<br><br><br>
</dl>
<p>
<b>valfield</b>
<a href="attributetypes.html#dfield">
dfield
</a>
<dl>
<dt> <dd>
A data field that contains the numeric plottable value.<tt> </tt>
<br><br><br>
</dl>
<p>
<b>subcats</b>
<i>list</i> | <tt>auto</tt>
<dl>
<dt> <dd>
A comma-delmited or space-delimited list of allowable subcats, or else <tt>auto</tt> 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.<tt> </tt>
<br>
Example: <tt>subcats: A B C</tt>
<br>
Example: <tt>subcats: auto</tt>
<br><br><br>
</dl>
<p>
<b>errfield</b>
<a href="attributetypes.html#dfield">
dfield
</a>
<dl>
<dt> <dd>
A data field that contains a numeric error bar value. Optional.. if omitted no error bars will be drawn.<tt> </tt>
For example if valfield contains means, this field might contain SEM or SD.<tt> </tt>
<br><br><br>
</dl>
<p>
<b>plotwidth</b>
<i>h</i>
<dl>
<dt><dd><p>
Controls the width of the plot region within the category space and allows for separating margins on each side.<tt> </tt>
Usable range of <i>h</i> is 0.2 to 0.8 or so.<tt> </tt>
For lineplots default is 0.6 ; for bars the default is set based on number of subcategories.<tt> </tt>
<br><br><br>
</dl>
<p>
<b>select</b>
<a href="select.html">
select expression
</a>
<dl>
<dt> <dd>
Allows data rows to be selected for inclusion using a selection expression.<tt> </tt>
<br>
Example: <tt>@@2 = B</tt>
<br><br><br>
</dl>
<h2>Lineplot options</h2>
<p>
<b>linedetails</b>
<a href="linedetails.html">
linedetails
</a>
<dl>
<dt> <dd>
Color, line width, dash style for lineplot curves.<tt> </tt>
<br><br>
</dl>
<p>
<b>gapmissing</b>
<tt>yes | no</tt>
<dl>
<dt> <dd>
Default is yes.
If no, data points that are missing in any curve will be bridged.<tt> </tt>
If yes, missing data points cause the curve to be interrupted.<tt> </tt>
<br><br><br>
</dl>
<h2>Column bar options</h2>
You must specify <tt>plotmode: bars</tt> in order to use these options. New in 2.41
<p>
<b>barcolor</b>
<a href="color.html">
color
</a>
<dl>
<dt> <dd>
Specify this attribute if you want all bars in a group to be this color.<tt> </tt>
Default is <tt>green</tt>.<tt> </tt>
<br><br>
</dl>
<p>
<b>barcolorlist</b>
list of
<a href="color.html">
color
</a>
<dl>
<dt> <dd>
Specify this attribute if you want bars in a group to have different colors.<tt> </tt>
A comma- or space-delimited list of
<a href="color.html">
colors.<tt> </tt>
</a>
<br>
Example: <tt>barcolorlist: green,red,blue
<br><br>
</tt></dl>
<p>
<b>barlinewidth</b>
<i>linewidth</i>
<dl>
<dt> <dd>
Linewidth of bars. Default is 2.0 ; use higher numbers for thicker bars, lower numbers for thinner bars.<tt> </tt>
<br><br>
</dl>
<p>
<b>crossover</b>
<i>h</i>
<dl>
<dt> <dd>
If specified, values less than <i>h</i> will result in downward bars.<tt> </tt>
Typically specified as <tt>0</tt> so that negative values give downward bars.<tt> </tt>
<br><br><br>
</dl>
<h2>Data point options</h2>
Data point symbols can be rendered with lineplots (<tt>plotmode: lines</tt>) or alone (<tt>plotmode: symonly</tt>).<tt> </tt>
<p>
<b>dpsymbol</b>
<a href="symboldetails.html">
symboldetails
</a>
<dl>
<dt> <dd>
Default is for small light-gray data point symbols to be rendered
(specifically, <tt>style=filled color=gray(0.7) shape=circle radius=0.02</tt>).<tt> </tt>
Specify another
<a href="symboldetails.html">
symboldetails
</a>
for a different data point symbol.<tt> </tt>
Specify <tt>none</tt> to omit data points.<tt> </tt>
<br><br>
</dl>
<p>
<b>altsymbol</b>
<a href="symboldetails.html">
symboldetails
</a>
<dl>
<dt> <dd>
If specified, defines an alternate symbol to be drawn when <tt>altwhen</tt> condition is true.<tt> </tt>
<br><br>
</dl>
<p>
<b>altwhen</b>
<a href="select.html">
select expression
</a>
<dl>
<dt> <dd>
A conditional expression that, if true, causes the <tt>altsymbol</tt> to be drawn instead of the
<tt>dpsymbol</tt>.<tt> </tt>
<br><br><br>
</dl>
<h2>Error bar options</h2>
Error bars will be rendered if <tt>errfield</tt> is specified (see above).<tt> </tt>
<br><br>
<p>
<b>errbardetails</b>
<a href="linedetails.html">
linedetails
</a>
<dl>
<dt> <dd>
Color and line width for error bars.<tt> </tt>
<br><br>
</dl>
<p>
<b>taillen</b>
<i>h</i>
<dl>
<dt> <dd>
Size of error bar tails in inches (cm). Default is 0.04 inches.<tt> </tt>
<br><br>
<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 <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> </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>
</dl>
<p><hr>
Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>March 11, 2009.
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
ed05dc5f357c49fdded780f52b150dce
>
files
>
24
