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
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
|
<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/01/02 09:13:42. -->
<!-- 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: xautorange and yautorange attributes</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>xautorange and yautorange attributes</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>
<a href="../gallery/index.html">Gallery</a>
<a href="../doc/Contents.html">Handbook</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
<title>Manual page for xautorange_and_yautorange_attributes(PL)</title>
</head>
<body>
<h2>USAGE</h2>
<tt>xautorange: datafield=</tt><i>dfields</i><tt> </tt><i>other subattributes..</i>
<br>
or..<tt> </tt>
<br>
<tt>yautorange: datafield=</tt><i>dfields</i><tt> </tt><i>other subattributes..</i>
<br><br><br>
<h2>DESCRIPTION</h2>
<b>xautorange</b> and <b>yautorange</b> are attributes of
<a href="areadef.html">
proc areadef
</a>
that allow the plot range to be determined by the range of data.<tt> </tt>
Because this attribute is fairly involved, it has a manual page of its own.<tt> </tt>
<p>
Default autorange behavior is as follows:
For numeric data the range is set to the nearest whole high and low scale increments
that encompass the min and max of the data.<tt> </tt>
For date and time data the range is set to the exact min and max of the data.<tt> </tt>
<br><br><br>
<h2>VARIABLES THAT ARE SET</h2>
<p>
<b>DATAXMIN</b>, <b>DATAXMAX</b>
<dl>
<dt><dd><p>
The actual minima and maxima of the data field when ranging in X.
Different from XMIN and XMAX in that these do not include any margin.<tt> </tt>
</dl>
<p>
<b>DATAYMIN</b>, <b>DATAYMAX</b>
<dl>
<dt><dd><p>
The actual minima and maxima of the data field when ranging in Y.
Different from YMIN and YMAX in that these do not include any margin.<tt> </tt>
<br><br><br>
</dl>
<h2>SUBATTRIBUTES</h2>
<p>
<tt>datafield=</tt><i>dfields</i>
<dl>
<dt><dd><p>
The only subattribute that <b>must</b> be specified is <tt>datafield=</tt><i>dfields</i>,
and it must be given before any other subattribute.<tt> </tt>
The <i>dfields</i> will be scanned to automatically find minima
and maxima, and the range (either x or y) will be set accordingly.<tt> </tt>
<i>dfields</i> may be a single
<a href="attributetypes.html#dfield">
dfield
</a>
or a comma-delimited list of several dfields with no embedded space.<tt> </tt>
Unless <tt>combomode=</tt> is given, all fields will be treated independently
when searching for a minima and maxima.<tt> </tt>
Invalid or non-existant dfields will be silently ignored, but there must be at
least one valid dfield.
[Field list contributed by Paul Totten.]
</dl>
<p>
<tt>combomode=stack | hilo</tt>
<dl>
<dt><dd><p>
If <tt>stack</tt> is specified, and multiple <tt>datafields</tt> are given,
the datafields will be summed before searching for minima and maxima.<tt> </tt>
This is useful when generating stacked bar graphs.<tt> </tt>
<tt>hilo</tt> allows autoranging to work properly when superimposing error bars over another graph.<tt> </tt>
Usually 2 datafields are used, one of which is the error bar amount.<tt> </tt>
</dl>
<p>
The following subattributes allow autorange behavior to be controlled explicitly:
<p>
<tt>incmult=</tt><i>h</i>
<dl>
<dt><dd><p>
controls the amount of margin at high and low end when
working with numeric data in default mode as described above.
The default <i>h</i> is 1.0.<tt> </tt>
The scale increment will be multiplied by <i>h</i> before determining the range.<tt> </tt>
The low end of the range will not dip below zero if data are all positive.
Probably should not be used with any other
subattributes except <tt>datafield=</tt>.
</dl>
<p>
<tt>nearest=</tt><i>s</i>
<dl>
<dt><dd><p>
may be used to explicitly define the extent of the range,
to a boundary corresponding to a round value of your choice.
If you do not specify a <tt>nearest=</tt> value autorange
will guess based on the magnitude of the data.<tt> </tt>
If <tt>nearest=exact</tt> is specified, the range will be the
exact minima to the exact maxima.<tt> </tt>
See the table below for some possible values for <i>s</i>.<tt> </tt>
An example: if <i>s</i> is <tt>100</tt>, and the data range
from 23 to 1162, the plot's range will be 0 to 1200.<tt> </tt>
The following illustrates some possible values for <tt>nearest=</tt><i>s</i>:
<br>
<pre>
s range min and max will be set to:
------- ---------------------------------
10 the nearest multiple of 10
0.1 the nearest multiple of 0.1
month the nearest month boundary (date or datetime scaletypes only)
quarter the nearest quarter-year boundary (date or datetime only)
year the nearest year boundary (date or datetime only)
hour the nearest hour boundary (time or datetime only)
day the nearest day boundary (datetime only)
exact the exact minima and maxima
(none) a reasonable default (numeric data only)
</pre>
<tt></tt></dl>
<p>
<tt>margin=</tt><i>m</i>
<dl>
<dt><dd><p>
If specified, <i>m</i> basic units will be added to the
maxima and also subtracted from the minima, before considering <tt>nearest</tt>.
This may be used to guarantee margins at each end of the range.<tt> </tt>
(Basic units are days for <tt>date</tt> and <tt>datetime</tt> scaletypes; and
minutes for <tt>time</tt>.)
</dl>
<p>
<tt>lowfix=</tt><i>lowval</i>
<dl>
<dt><dd><p>
If specified, the minima will always be <i>lowval</i>.<tt> </tt>
This is useful when you want only the maxima to be automatically set based on data.<tt> </tt>
</dl>
<p>
<tt>hifix=</tt><i>hival</i>
<dl>
<dt><dd><p>
If specified, the maxima will always be <i>hival</i>.<tt> </tt>
This is useful when you want only the minima to be automatically set based on data.<tt> </tt>
</dl>
<p>
<tt>format=</tt><i>printfspec</i>
<dl>
<dt><dd><p>
For very small numbers this subattribute may be useful, since normally
values are rounded to six decimal places.<tt> </tt>
</dl>
<p>
<tt>selectrows=</tt><i>conditional expression</i>
<dl>
<dt><dd><p>
This allows a
<a href="condex.html">
conditional expression
</a>
to be applied in order to select data rows to be tested when
scanning for minima and maxima.<tt> </tt>
If used, this subattribute must be the last on the line, and
will have embedded spaces, unlike the other subattributes.<tt> </tt>
New in 2.00. See example below.<tt> </tt>
</dl>
<p>
Example: <tt>xautorange: datafield=2 nearest=month margin=31</tt>
<p>
Example: <tt>yautorange: datafield=3,4,5,6,7 selectrows=@sex = f</tt>
<p>
Some gallery examples where <tt>xautorange</tt> is used:
<a href="../gallery/qual.htm">
qual
</a>
,
<a href="../gallery/hitcount.htm">
hitcount
</a>
, and
<a href="../gallery/milltest.htm">
milltest
</a>
<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>
<p><hr>
Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>March 01, 2002.
</body>
</html>
|
