<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: vdist 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>vdist 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 vdist_prefab(PL)</title>
</head>
<body>
<center><a href="prefab_vdist_ex.html">
<img src="../gallery/prefab_img/vdist1thm.gif" border=0>
<img src="../gallery/prefab_img/vdist3thm.gif" border=0>
<br><b>View the vdist prefab examples</a></b><br><br></center>
<p>
<b>vdist</b> is a
<a href="prefabs.html">
prefab
</a>
for displaying distributions of one or two variables.<tt> </tt>
Distributions may be depicted using histograms, and bee-swarm diagrams.<tt> </tt>
Data do not need to be in any particular order.<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>Most 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 an input data file)
(<b>data2</b> is also available for producing a second distribution, see below).
The X axis formatting parameters, legend parameters, and clickmap parameters aren't available
with this prefab.
<b>rectangle</b> controls the left plotting area.. the right plotting
area is automatically derived from the left one. <b>ygrid</b> is on by default.. use
<tt>ygrid=no</tt> to turn off the grid. <b>title</b> will be shown centered over the first
distribution.. use <b>title2</b> to label the second distribution. <b>ptselect</b> and
<b>ptselect2</b> may be used to select different data rows for left and right side.
</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>y</td>
<td><a href="atypes.html#dfield">data field</a></td>
<td><font color=D00000>must be specified</font></td>
<td><nobr>Data field containing data for the first distribution.</nobr></td>
<td><tt>y=2<br><br>y=pmb</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>y2</td>
<td><a href="atypes.html#dfield">data field</a></td>
<td> </td>
<td>Data field containing data for the second (right panel) distribution.</td>
<td><tt>y2=4<br><br>y2=rmb</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>data2</td>
<td>filename <br>or<br><tt>-</tt></td>
<td> </td>
<td>Name of an optional second data file to get <b>y2</b> from.
May be given as <tt>-</tt> to read data from standard input.
If not specified, it is assumed that both <b>y1</b> and <b>y2</b>
are coming from the same data file (<b>data</b>).</td>
<td><tt>data=file1 data2=file2 y=3 y2=3</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>title2</td>
<td>text</td>
<td> </td>
<td>A title to be displayed centered over the second distribution.</td>
<td><tt>"title2= Control Group"</td>
</tr>
</table>
<br>
<br>
<h2>Pertaining to the distribution histogram</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>dist</b>
<td><tt>centered</tt><br><tt>histo</tt><br><tt>no</td>
<td><tt>centered</tt></td>
<td>Appearance of the distribution. <tt>centered</tt> gives a beeswarm-like
display; <tt>histo</tt> gives a histogram.
<td><tt>dist=histo</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>bindiv</td>
<td>numeric</td>
<td>5.0</td>
<td>Control the bin size, based on Y axis stub increment.
If specified, the bin size will be the stub increment divided by this value.
This can be a convenient way to control the bin size since the stub increment
is often automatically set, based on the data.</td>
<td><tt>bindiv=2</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>binsize</td>
<td>numeric</td>
<td> </td>
<td>Specify the bin size explicitly, for cases where the
automatically determined bin size isn't ideal.</td>
<td><tt>binsize=50</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>distcolor</td>
<td><a href="color.html">color</a></td>
<td><tt>blue</td>
<td>The color of the distribution histogram bars.</td>
<td><tt>distcolor=black</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>distdotspread</td>
<td>numeric</td>
<td>2.0</td>
<td>Distributions are made up of a series of dots; this parameter
controls how far apart (horizontally) the dots are rendered.
If you have lots of dots and they are extending
too far horizontally, reduce this value; for the opposite effect increase this value.</td>
<td><tt>distdotspread=1.5</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>distdotshape</td>
<td><tt> circle <br> square <br> diamond <br> triangle </td>
<td><tt>diamond</td>
<td>The shape of the individual dots.</td>
<td><tt>distdotshape=square</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>distdotsize</td>
<td><a href="atypes.html#punits">inches or cm</a></td>
<td>0.04 "</td>
<td>The radius of the individual data point dots. </td>
<td><tt>distdotsize=0.025</td>
</tr>
<tr bgcolor=FFFFFF>
<td><b>distcenter</td>
<td>0 to 10</td>
<td>4</td>
<td>When doing a centered (beeswarm) display, controls the location of the center
of the display in X, using a data space ranging from 0 to 10.</td>
<td><tt>distcenter=3</td>
</tr>
</table>
<br>
<br>
<h2>Pertaining to the rangebars (boxplots)</h2>
<b>As of version 2.40, the rangebar functionality of this prefab is nonfunctional... </b>
Not sure how much (if any) user interest is out there.
If there is some, this prefab would need to be modified to use proc boxplot.
Community involvement in accomplishing this is solicited.
<br>
<br>
<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>
<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
>
96
