<html> <head> <!-- This file has been generated by unroff 1.0, 03/11/09 12:56:20. --> <!-- 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: vbars 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>vbars 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 vbars_prefab(PL)</title> </head> <body> <center><a href="prefab_vbars_ex.html"> <img src="../gallery/prefab_img/vbars2thm.gif" border=0> <img src="../gallery/prefab_img/vbars3thm.gif" border=0> <br><b>View the vbars prefab examples</a></b><br><br></center> <p> <tt>vbars</tt> is a <a href="prefabs.html"> prefab </a> for producing bar graphs with vertical solid bars for one or two groups.<tt> </tt> Error bars may be added above or below the bar graph, or error bars alone may be rendered (error bar amounts must be precomputed with this prefab).<tt> </tt> <p> Note that several of the other <a href="prefabs.html"> prefabs </a> produce bar graphs.<tt> </tt> For chronological-based data use the <a href="prefab_chron.html"> chron prefab.<tt> </tt> </a> The <a href="prefab_compare.html"> compare prefab </a> computes means and SD on the fly, and graphs them.<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>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</td> <td><a href="atypes.html#dfield">data field</a></td> <td><font color=D00000>must be specified</font></td> <td><nobr>Identifies the data field that will hold</nobr> X component. By default these are assumed to be categories, but thay can be continuous numeric values if the <b>xnumeric</b> parameter is specified. </td> <td><tt>x=2<br><br>x=pmb</td> </tr> <tr bgcolor=FFFFFF> <td><b>y<br><br>y2</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. Data must be numeric. If <b>y</b> and <b>y2</b> are specified, two sets of bars will be produced.</td> <td><tt>y=3<br><br>y=cfr y2=cfl</td> </tr> <tr bgcolor=FFFFFF> <td><b>err<br><br>err2</td> <td><a href="atypes.html#dfield">data field</a></td> <td> </td> <td><nobr>Identifies the data field(s) that will hold</nobr> error amount, such as SD. Data must be numeric. <td><tt>err=4<br><br>err=cfr_sd err2=cfl_sd</td> </tr> <tr bgcolor=FFFFFF> <td><b>color<br><br>color2</td> <td><a href="color.html">color</a></td> <td><tt>orange, powderblue</td> <td>Color of bars.</td> <td><tt>color=green</td> </tr> <tr bgcolor=FFFFFF> <td><b>barwidth</td> <td><a href="atypes.html#punits">inches or cm</a><br>or<br><tt>line</tt></td> <td>based on data</td> <td>Specifies the width of the filled bars. May be given as <tt>line</tt> to produce very thin bars. The default bar width is not always appropriate. </td> <td><tt>barwidth=0.05<br><br>barwidth=line</td> </tr> <tr bgcolor=FFFFFF> <td><b>errcolor<br><br>errcolor2</td> <td><a href="color.html">color</a></td> <td><tt>black</td> <td>Color of error bars.</td> <td><tt>errcolor=gray(0.4)</td> </tr> <tr bgcolor=FFFFFF> <td><b>errwidth</td> <td><a href="atypes.html#punits">inches or cm</a><br>or<br><tt>line</tt></td> <td>0.08 "</td> <td>Width of error bar tails.</td> <td><tt>errwidth=0.1</td> </tr> <tr bgcolor=FFFFFF> <td><b>errthick</td> <td><a href="linedetails.html">line thickness value</a></td> <td>0.5</td> <td>The thickness of the error bar lines (default = 0.5)</td> <td><tt>errthick=1</td> </tr> <tr bgcolor=FFFFFF> <td><b>erroneway</td> <td><tt>yes</tt> or <tt>no</td> <td><tt>no</td> <td>Draw one-way upward error bars instead of the usual symmetrical error bars. Old name: <b>errunder</b></td> <td><tt>erroneway=yes</td> </tr> <tr bgcolor=FFFFFF> <td><b>erronly</td> <td><tt>yes</tt> or <tt>no</td> <td><tt>no</td> <td>If <tt>yes</tt>, render error bars only. <b>y</b> will control the location of the center of the bar and <b>err</b> will control the error amount.</td> <td><tt>erronly=yes</td> </tr> <tr bgcolor=FFFFFF> <td><b>xnumeric</td> <td><tt>yes</tt> or <tt>no</td> <td><tt>no</td> <td>If <tt>yes</tt>, signifies that X values are numeric rather than categories.</td> <td><tt>xnumeric=yes</td> </tr> <tr bgcolor=FFFFFF> <td><b>vals</td> <td><tt>yes</tt> or <tt>no</td> <td><tt>no</td> <td>If <tt>yes</tt>, display numeric values near the top of each bar.</td> <td><tt>vals=yes</td> </tr> <tr bgcolor=FFFFFF> <td><b>crossover</td> <td>Y value</td> <td> </td> <td>A 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>curve <br><br><b>order</td> <td><tt>yes</tt><br>or<br><a href="linedetails.html">linedetails</a></td> <td> </td> <td>Generate a moving average curve fit to the bars. It will be drawn behind the bars. Not applicable to a second set of bars. <b>order</b> is an attitional parameter may be set to the number of preceding data points to be considered when computing averages (default = 5). </td> <td><tt>curve=yes<br><br>"curve= color=blue"</td> </tr> <tr bgcolor=FFFFFF> <td><b>sep</td> <td><a href="atypes.html#punits">inches or cm</a></td> <td>0.15 "</td> <td>Controls bar separation when two bar sets are being rendered.</td> <td><tt>sep=0.08</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>