<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/11/09 12:56:12. -->
<!-- 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 boxplot</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 boxplot</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_boxplot(PL)</title>
</head>
<body>
<center><a href="../gallery/boxplot1.htm"><img src="../gallery/boxplot1.gif" border=0></a>
</center>
<b>proc boxplot</b> renders boxplots also known as box-and-whisker plots in the
<a href="areadef.html">
current plotting area.<tt> </tt>
</a>
By default it produces <b>median-based</b> boxplots which use median and interquartile range, but it can also produce
<b>mean-based</b> boxplots using mean and SD.<tt> </tt>
<p>
Recommended method is to use proc getdata to read in raw data, then use proc processdata (action: summaryplus) to
compute the necessary summary statistics, then invoke this proc to render boxplots.<tt> </tt>
<p>
Prior to version 2.40 this proc was called proc rangebar, and it rendered one boxplot (including computation of the
necessary statistics). In version 2.40 proc processdata's summaryplus action was implemented.
Correspondingly this proc's operation changed.. it now renders a series of boxplots and has a tighter coupling with proc processdata.<tt> </tt>
Some previously available functionality was removed out of necessity
or where deemed obscure, including options for display of outlier data points,
1.5 IQR tails, log transform, setting of variables such as RANGEBARMIN, and output of computed stats.<tt> </tt>
<br><br><br>
<h2>Attributes</h2>
Rangebars may be vertical (the default) or horizontal (see <tt>orientation</tt> below);
to make things easier to explain in this document, vertical boxplots are assumed.<tt> </tt>
<p>
<b>basis</b>
<tt>median | mean</tt>
<dl>
<dt> <dd>
If <tt>median</tt> (the default) median-based boxplots are produced (using median, 5th, 25th, 75th, and 95th percentiles).<tt> </tt>
If <tt>mean</tt>, then mean-based boxplots are produced (using mean, +/- sd, min, max ).<tt> </tt>
<br><br>
</dl>
<p>
<b>tailmode</b>
<tt>5/95 | minmax </tt>
<dl>
<dt> <dd>
Used only with median-based boxplots.<tt> </tt>
Specifies whether the rangebar tails are to extend to the 5th and 95th percentile, to the min and max.<tt> </tt>
Default is <tt>5/95</tt>.<tt> </tt>
<br>
Example: <tt>tailmode: minmax</tt>
<br><br>
</dl>
<p>
<b>locfield</b>
<a href="attributetypes.html#dfield">
dfield
</a>
<dl>
<dt> <dd>
The data field indicating boxplot location in X (or location in Y with <tt>orientation: horizontal</tt>).<tt> </tt>
If not given, boxplots will be rendered at X=1, X=2, X=3 .. X=N.<tt> </tt>
<br><br>
</dl>
<p>
<b>statfields</b>
<a href="attributetypes.html#dfield">
dfield
</a>
list
<dl>
<dt> <dd>
If you're using proc processdata (action: summaryplus) first, this attribute should not be set (it will be automatic).<tt> </tt>
If you computed statistics externally, you will need to provide a list of the data fields holding your statistics, using
the exact order shown here.<tt> </tt>
For median-based boxplots specify the fields for #observations, 5thpercentile, 25thpercentile, median, 75thpercentile, 95thpercentile, and
optionally the mean (if you're doing min/max tails then substitute min for 5thpercentile and max for 95thpercentile).<tt> </tt>
For mean-based boxplots specify the fields for #observations, mean, sd, min, max.<tt> </tt>
<br><br>
</dl>
<p>
<b>orientation</b>
<tt>vertical | horizontal</tt>
<dl>
<dt> <dd>
Orientation of the boxplots. Default is <tt>vertical</tt>.<tt> </tt>
<a href="../gallery/boxplot2.htm">
Click here for an example of horizontally-oriented boxplots
</a>
<br><br><br>
</dl>
<h2>Bar appearance details</h2>
<p>
<b>barwidth</b>
<i>n</i>
<dl>
<dt> <dd>
The width of the box portion of the rangebar in
<a href="attributetypes.html#positionunits">
absolute units.<tt> </tt>
</a>
Default is 0.12 inches.<tt> </tt>
<br>
Example: <tt>barwidth: 0.1</tt>
<br><br>
</dl>
<p>
<b>color</b>
<a href="color.html">
color
</a>
<dl>
<dt> <dd>
Specifies the color of the box area.<tt> </tt>
Example: <tt>color: yellow</tt>
<br><br>
</dl>
<p>
<b>mediansym</b>
<a href="symboldetails.html">
symboldetails
</a>
<tt> | dot | line </tt>
<dl>
<dt> <dd>
Specifies the symbol that will be displayed to show the median (or the mean with <tt>basis: mean</tt>).<tt> </tt>
May be a symbol specification (to get dots, etc.) or <tt>line</tt> which
is the default. <tt>dot</tt> or <tt>yes</tt> gives a small black dot.<tt> </tt>
Example: <tt>mediansym: shape=diamond</tt>
<br><br>
</dl>
<p>
<b>outline</b>
<tt>yes | no</tt>
<dl>
<dt> <dd>
If <tt>yes</tt>, box is outlined with a line.<tt> </tt>
<br><br>
</dl>
<p>
<b>taildetails</b>
<a href="linedetails.html">
linedetails
</a>
<dl>
<dt> <dd>
Controls color, linewidth, etc. of tail lines.<tt> </tt>
<br>
Example: <tt>taildetails: color=blue width=1.8</tt>
</dl>
<p>
<b>outlinedetails</b>
<a href="linedetails.html">
linedetails
</a>
<dl>
<dt> <dd>
Controls color, linewidth, etc. of box outline and tics.<tt> </tt>
<br><br>
</dl>
<p>
<b>truncate</b>
<tt>yes | no</tt>
<dl>
<dt> <dd>
If <tt>yes</tt>, bars are truncated to plotting area.<tt> </tt>
Default is <tt>yes</tt>.<tt> </tt>
<br><br>
</dl>
<p>
<b>ticlen</b>
<i>n</i>
<dl>
<dt> <dd>
Length, in
<a href="attributetypes.html#positionunits">
absolute units
</a>
, of the tics which appear at the end of the tails.<tt> </tt>
Default is 70% of the width of the bar.<tt> </tt>
<br><br>
</dl>
<p>
<b>95tics</b>
<tt>yes | no</tt>
<dl>
<dt> <dd>
On median-based boxplots using <tt>tailmode: minmax</tt>, this option allows display of 5th and 95th percentile by adding tics.<tt> </tt>
Example: <tt>95tics: yes</tt>
<br><br>
</dl>
<p>
<b>meansym</b>
<tt>yes | dot | </tt>
<a href="symboldetails.html">
symboldetails
</a>
<dl>
<dt> <dd>
With median-based boxplots, this option causes a second data point symbol to be placed at the mean.
The result will be two symbols, one at the median, and another at the mean.<tt> </tt>
If <tt>yes</tt> or <tt>dot</tt>, a default symbol (a small black dot) will be placed at the mean.<tt> </tt>
Other symbols may be rendered by giving
other symboldetails specifications. If <tt>no</tt>, a mean symbol will not
be rendered. Default is <tt>no</tt>.<tt> </tt>
<br>
Example: <tt>meansym: shape=circle style=filled fillcolor=black radius=0.04</tt>
<br><br><br>
</dl>
<h2>Selecting data rows</h2>
<p>
<b>select</b>
<a href="select.html">
select expresion
</a>
<dl>
<dt> <dd>
Allows cases to be selected for inclusion using a selection expression.<tt> </tt>
<br>
Example: <tt>select: @2 = B</tt>
<br><br><br>
</dl>
<h2>Legend</h2>
<p>
<b>legendlabel</b>
<a href="attributetypes.html#text">
text
</a>
<dl>
<dt> <dd>
A label to be associated with the current set of bars, in a legend to be rendered later (proc legend).<tt> </tt>
The <tt>\n</tt> construct can be used to force a line break,
or the label can be wordwrapped using proc legend wraplen attribute.<tt> </tt>
<br><br>
</dl>
<p>
<b>legendtype</b>
<tt>color | symbol</tt>
<dl>
<dt> <dd>
Legend sample can be the boxplot color or the data point symbol used for the median or mean.<tt> </tt>
Default is <tt>color</tt>.<tt> </tt>
<br><br><br>
</dl>
<h2>N= annotation</h2>
<p>
<b>printn</b>
<tt>yes | no</tt>
<dl>
<dt> <dd>
If <tt>yes</tt>, a label showing N (the number of observations) is produced. Default is <tt>yes</tt>.<tt> </tt>
Example: <tt>printn: no</tt>
<br><br>
</dl>
<p>
<b>nlocation</b>
<a href="attributetypes.html#locvalue">
locvalue
</a>
<dl>
<dt> <dd>
Where to position the N label. The label will be aligned with the rangebar.<tt> </tt>
For vertical rangebars <tt>location</tt> indicates where to place the label
in Y; for horizontal, X.<tt> </tt>
Example: <tt>nlocation: -4</tt>
<br><br>
</dl>
<p>
<b>textdetails</b>
<a href="textdetails.html">
textdetails
</a>
<dl>
<dt> <dd>
Details for the N= text.<tt> </tt>
<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
>
20
