.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: 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.40 Jan'08
     </small><br><a href="../doc/prefabs.html">Prefabs</a>
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

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

.ig >>
<center><a href="prefab_vbars_ex.html">
<img src="../gallery/prefab_img/vbars2thm.gif" border=0> &nbsp;
<img src="../gallery/prefab_img/vbars3thm.gif" border=0>
 <br><b>View the vbars prefab examples</a></b><br><br></center>
.>>


.LP
\fCvbars\fR is a 
.ig >>
<a href="prefabs.html">
.>>
\0prefab
.ig >>
</a>
.>>
for producing bar graphs with vertical solid bars for one or two groups.
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).
.LP
Note that several of the other 
.ig >>
<a href="prefabs.html">
.>>
\0prefabs
.ig >>
</a>
.>>
produce bar graphs.
For chronological-based data use the
.ig >>
<a href="prefab_chron.html">
.>>
\0chron prefab.
.ig >>
</a>
.>>
The
.ig >>
<a href="prefab_compare.html">
.>>
\0compare prefab
.ig >>
</a>
.>>
computes means and SD on the fly, and graphs them.


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

.SH Parameters

.ig >>

<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>&nbsp;</td>
<td>&nbsp;</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>&nbsp;</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>&nbsp;</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>&nbsp;</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>
.>>

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