File: breakaxis.html

package info (click to toggle)
ploticus 2.0.3-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 3,696 kB
  • ctags: 2,035
  • sloc: ansic: 40,100; perl: 456; sh: 186; makefile: 129
file content (189 lines) | stat: -rw-r--r-- 4,745 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/01/02 08:56:48. -->
<!-- Do not edit! -->
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
-->
</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>
  <a href="../doc/Welcome.html">Welcome</a> &nbsp; &nbsp;
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
  <a href="../doc/Contents.html">Handbook</a> 
  <td></tr></table>
</td></tr>
<td>
<br>
<br>

<title>Manual page for proc_breakaxis(PL)</title>
</head>
<body>

<h2>DESCRIPTION</h2>
<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>

<h2>EXAMPLE</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>



<h2>MANDATORY ATTRIBUTES</h2>
The <tt>breakpoint</tt> attribute must be specified.<tt> </tt>

<h2>ATTRIBUTES</h2>
<p>
<b>axis</b> <tt>x</tt> | <tt>y</tt>
<dl>
<dt><dd><p>
The axis that is to be broken.  Default is <tt>y</tt>.<tt> </tt>

</dl>
<p>
<b>breakpoint</b>
<a href="attributetypes.html#plotvalue">
<i> plotvalue </i>
</a>
<dl>
<dt><dd><p>
Where the break is to be rendered, in <tt>axis</tt> space.<tt> </tt>
This attribute <b>must</b> be specified.<tt> </tt>
<dt><dd><p>
Example: 
<tt>axis: y
breakpoint: 25</tt>
would break the Y axis at Y = 25.<tt> </tt>

</dl>
<p>
<b>location</b> <tt>axis</tt> | 
<a href="attributetypes.html#plotvalue">
<i> plotvalue </i>
</a>
<dl>
<dt><dd><p>
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>.<tt> </tt>
<dt><dd><p>
Example: 
<tt>axis: y
breakpoint: 25
location: axis</tt>
would render a break symbol 
on the Y axis at Y = 25.<tt> </tt>
<dt><dd><p>
Example: 
<tt>axis: y
breakpoint: 25
location: 30</tt>
would render a break symbol at X = 30, Y = 25, presumably
to break a bar, etc.  

</dl>
<p>
<b>style</b> <tt>slant</tt> | <tt>straight</tt>
<dl>
<dt><dd><p>
The style of the break symbol. Default is <tt>slant</tt>.<tt> </tt>

</dl>
<p>
<b>linelength</b> <i>n</i>
<dl>
<dt><dd><p>
The length of the break symbol lines.<tt> </tt>
<i>n</i> is in absolute units.  Default is 0.2 inches.<tt> </tt>

</dl>
<p>
<b>fillcolor</b>
<a href="color.html">
<i> color </i>
</a>
<dl>
<dt><dd><p>
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>

</dl>
<p>
<b>gapsize</b> <i>n</i>
<dl>
<dt><dd><p>
The distance (in absolute units) between the two lines of the break symbol.<tt> </tt>

</dl>
<p>
<b>linedetails</b> 
<a href="linedetails.html">
<i> linedetails </i>
</a>
<dl>
<dt><dd><p>
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 &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
</dl>
<p><hr>
Markup created by <em>unroff</em> 1.0,&#160;<tt> </tt>&#160;<tt> </tt>March 01, 2002.
</body>
</html>