<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/11/09 12:56:18. -->
<!-- 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: compare 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>compare prefab</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/prefabs.html">Prefabs</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
<title>Manual page for compare_prefab(PL)</title>
</head>
<body>
<center><a href="prefab_compare_ex.html">
<img src="../gallery/prefab_img/compare4thm.gif" border=0>
<br><b>View the "prefab compare" examples</a></b><br><br></center>
<p>
<b>As of version 2.40 this prefab is currently suspended and nonfunctional.</b>
support for it is suspended...<tt> </tt>
I'm not sure if there's any user interest out there... if there is, this prefab
needs to be rewritten, probably to use proc processdata action: summary (the
old proc rangebar functionality is no longer supported). Community involvement
in accomplishing this is solicited.<tt> </tt>
<br><br><br>
<p>
<b>compare</b> is a
<a href="prefabs.html">
prefab
</a>
designed to allow convenient comparison of one to four variables.<tt> </tt>
It computes means and standard deviations, and then produces groups of bars
with error bars, arranged for easy comparison.<tt> </tt>
Categories and subcategories are supported, and from one to four data fields/variables can be examined.<tt> </tt>
I wrote it because I wanted an easy way to compare 2, 3, or 4 measurments
for different mouse strains (categories), with female and male separate (subcategories).<tt> </tt>
This prefab does not support more than 2 subcategories.<tt> </tt>
This prefab is new in version 2.21-01.<tt> </tt>
<br><br><br>
<h2>Parameters</h2>
<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> </td>
<td> </td>
<td colspan=2>Any 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>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>Specifies the data field(s) to be displayed and compared.</td>
<td><tt>y=Rbw y2=Lbw</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>catfields</td>
<td><a href="atypes.html#dfield">data field</a>, or comma-delimited list of 2 data fields.</td>
<td><font color=D00000>must be specified</font></td>
<td><nobr>One field that identifies the category, or two</nobr> data fields identifying the category and the
subcategory, for each data row. The data set must be sorted on these fields.</td>
<td><tt>catfields=2<br>catfields=strain,sex</tt></td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>leftsub</td>
<td>text</td>
<td>must be specified if doing subgroups</td>
<td>A value that will be found in the subgroup field
(the 2nd catfield value as described above) of data records.
Data records having this tag will be considered part of the subgroup that is displayed on the left.
For example, if the subgroups are denoted in the data using tags of <tt>female</tt> and <tt>male</tt>,
and female subgroup appears on the left, then use <tt>leftsub=female</tt>.
See <a href="prefab_compare_ex.html">examples 4 and 5</a>.
</td>
<td><tt>leftsub=female</tt><br></td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>rightsub</td>
<td>text</td>
<td>must be specified if doing subgroups</td>
<td>Same as <tt>leftsub</tt> but for the subgroup appearing on the right.
<td><tt>rightsub=male</tt></td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>barwidth</td>
<td><a href="atypes.html#punits">inches or cm</a></td>
<td>0.05 "</td>
<td>Width of bars.</td>
<td><tt>barwidth=0.08</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>subgroupoffset</td>
<td>Units in X</td>
<td>0.4</td>
<td>Distance between clusters when subgroups are being displayed.</td>
<td><tt>subgroupoffset=0.5</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>clustersep</td>
<td><a href="atypes.html#punits">inches or cm</a></td>
<td>0.012 "</td>
<td>Amount of separation between individual bars within clusters</td>
<td><tt>clustersep=0</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>color<br><br>color2<br>color3<br>color4</td>
<td><a href="color.html">color</a></td>
<td>orange, powderblue, green, dullyellow</td>
<td>Colors for the bars.
<b>color</b> goes with <b>y</b>, <b>color2</b> goes with <b>y2</b>, and so on.</td>
<td><tt>color=red color2=green</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>outline</b></td>
<td><tt>yes</tt><br>or<br><a href="linedetails.html">linedetails</a></td>
<td> </td>
<td>If <tt>yes</tt>, outline the bars.</td>
<td><tt>outline=yes</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>crossover</td>
<td>value in Y</td>
<td> </td>
<td>This may be specified as the value in Y where bars begin
to point downward instead of upward. For instance, <tt>crossover=0</tt>
is often useful when dealing with financial income, to show loss
using downward bars.</td>
<td><tt>crossover=0</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>ptselect<br><br>ptselect2<br>ptselect3<br>ptselect4</td>
<td><a href="select.html">select expression</a></td>
<td> </td>
<td>Specifies conditionals for selecting data rows. For instance, can be used
so that one data field is used for <b>y</b>, <b>y2</b> (etc.), with the segregation
being performed by the conditional expressions.
See <a href="prefab_compare_ex.html">example 6</a>.
<b>ptselecttags</b> must also be specified for this to work.
Note that since these are passed in only one at-sign should be used, not two.
</td>
<td><tt>"ptselect = 24 && = ctrl"</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>ptselecttags</td>
<td>comma-delimited list</td>
<td>must be specified if ptselect* used</td>
<td>This is a comma-delimited list of tags or identifiers, one unique member per ptselect. For example,
if you are using <b>ptselect</b> and <b>ptselect2</b> then the <b>ptselecttags</b> list must have two
members. The tags will be shown in the default legend, and also be used internally.
See <a href="prefab_compare_ex.html">example 6</a>.</td>
<td><tt>ptselecttags="0,3"</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>dataoutfile</td>
<td>filename</td>
<td> </td>
<td>If specified, computed summary statistics will be written to this file.
Fields are: the catfields (1 or 2), variable name, N, mean, SD, median, min, max, and number of
missing (non-numeric) observations.</td>
<td><tt>dataoutfile=tmp1</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>errline</td>
<td><a href="linedetails.html">linedetails</a></td>
<td>width=0.4</td>
<td>Controls the thickness, color, etc. of all error bars.</td>
<td><tt>"errline= width=1"</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>errwidth</td>
<td><a href="atypes.html#punits">inches or cm</a></td>
<td>0.05"</td>
<td>Size of error bar tails</td>
<td><tt>errwidth=0.8</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>erroneway</td>
<td><tt>yes</tt> or <tt>no</td>
<td><tt>no</td>
<td>If <tt>yes</tt>, error bars are only drawn one way (upward).</td>
<td><tt>erroneway=yes</td>
</tr>
</table>
<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>
<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
>
70
