<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 breakaxis</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 breakaxis</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_breakaxis(PL)</title>
</head>
<body>
<center><img src="../gallery/thumbnails/brokenaxis.png"></center>
<p>
<b>proc breakaxis</b> may be used to render a "break" symbol
when preparing plots that have a broken axis in order to accomodate
an extreme value.
<p>
In terms of plotting mechanics, breaking an axis means that one
region of the plotting area uses one scale space, while the other
region uses a different scale space. A "break" symbol is used to
illustrate where these two regions meet.<tt> </tt>
Ploticus cannot render broken axis plots
automatically; generally they are "by hand" efforts.<tt> </tt>
<p>
The general approach is to use a "trick":
set up one space, plot the values with
a truncate option so that the extreme values do not go out of range,
then set up a second space immediately adjacent to the first one,
plot the values again so that only extremeties show, then
use <b>proc breakaxis</b> to render a break symbol along the
axis and again within the plot.<tt> </tt>
The two plotting areas must be proportional in scaling.<tt> </tt>
<p>
Broken axis plotting works with proc bars, proc rangebar, and proc scatterplot.<tt> </tt>
It currently does not work with lineplots or rangesweep,
because these are unable to confine to the plotting area.<tt> </tt>
<br><br><br>
<h2>Examples</h2>
Gallery examples where this is used is
<a href="../gallery/brokenaxis.htm">
brokenaxis
</a>
and
<a href="../gallery//spence1_rt.htm">
spence_rt
</a>
<br><br><br>
<h2>Attributes</h2>
The <tt>breakpoint</tt> attribute <b>must</b> be specified.<tt> </tt>
<p>
<b>axis</b>
<tt>x</tt> | <tt>y</tt>
<dl>
<dt> <dd>
The axis that is to be broken. Default is <tt>y</tt>.<tt> </tt>
<br><br>
</dl>
<p>
<b>breakpoint</b>
<a href="attributetypes.html#plotvalue">
plotvalue
</a>
<dl>
<dt> <dd>
Where the break is to be rendered, in <tt>axis</tt> space.<tt> </tt>
This attribute <b>must</b> be specified. Example:
<pre>
axis: y
breakpoint: 25
</pre>
would break the Y axis at Y = 25.<tt> </tt>
<br><br>
</dl>
<p>
<b>location</b>
<tt>axis</tt> |
<a href="attributetypes.html#plotvalue">
plotvalue
</a>
<dl>
<dt> <dd>
The location where the break symbol is to be rendered.<tt> </tt>
<tt>axis</tt> causes the symbol to be placed on the left
or bottom axis. Otherwise, <i>plotvalue</i> is used.<tt> </tt>
Default is <tt>axis</tt>. Example:
<pre>
axis: y
breakpoint: 25
location: axis
</pre>
The above code would render a break symbol
on the Y axis at Y = 25.<tt> </tt>
<dt> <dd>
Another Example:
<pre>
axis: y
breakpoint: 25
location: 30
</pre>
The above code would render a break symbol at X = 30, Y = 25, presumably
to break a bar, etc.
<br><br>
</dl>
<p>
<b>style</b>
<tt>slant | straight</tt>
<dl>
<dt> <dd>
The style of the break symbol. Default is <tt>slant</tt>.<tt> </tt>
<br><br>
</dl>
<p>
<b>linelength</b>
<i>n</i>
<dl>
<dt> <dd>
The length of the break symbol lines.<tt> </tt>
<i>n</i> is in absolute units. Default is 0.2 inches.<tt> </tt>
<br><br>
</dl>
<p>
<b>fillcolor</b>
<a href="color.html">
color
</a>
<dl>
<dt> <dd>
The color used for the rubout area. Default is the current background
color. If you used a different color for the plotting area, that color
should be specified here.<tt> </tt>
<br><br>
</dl>
<p>
<b>gapsize</b>
<i>n</i>
<dl>
<dt> <dd>
The distance (in absolute units) between the two lines of the break symbol.<tt> </tt>
<br><br>
</dl>
<p>
<b>linedetails</b>
<a href="linedetails.html">
linedetails
</a>
<dl>
<dt> <dd>
Controls the color, line width, etc. of the break symbol lines.<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
>
21
