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
|
<html>
<head>
<!-- This file has been generated by unroff 1.0, 06/18/01 09:23:44. -->
<!-- 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 rangesweep</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 rangesweep</h2></td>
<td align=right>
<small>
<a href="Welcome.html"><img src="ploticus.gif" border=0></a><br>
<a href="Welcome.html">Welcome</a>
<a href="../gallery/index.html">Gallery</a>
<a href="Contents.html">Handbook</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
<title>Manual page for proc_rangesweep(PL)</title>
</head>
<body>
<center>
<img src="../gallery/rangesweep0.gif">
</center>
<h2>DESCRIPTION</h2>
<b>proc rangesweep</b> draws a moving range.<tt> </tt>
The plot is drawn beginning with first data record, working to the last one.<tt> </tt>
<h2>EXAMPLES</h2>
See the Gallery Rangesweep page
<a href="../gallery/gall.rangesweep.html"><img src="../gallery/btn/here.gif"></a>
<h2>UNPLOTTABLE DATA</h2>
Invalid values are skipped;
the rangesweep will be drawn to connect only the points corresponding to plottable
values. Points lying outside of the plotting area are displayed if possible.<tt> </tt>
<h2>PREREQUISITES</h2>
A plotting area must be set up using <b>proc areadef</b>
and <b>proc getdata</b> must be executed to
access or define some data.<tt> </tt>
The data must be ordered in X.<tt> </tt>
<h2>MODES</h2>
This proc can operate in one of these modes:
<p>
<b>Y only (points "where they fall"):</b>
<dl>
<dt><dd><p>
By not specifying <tt>xfield</tt>, range values are shown
at consecutive unit locations in X.<tt> </tt>
</dl>
<p>
<b>X, Y:</b>
<dl>
<dt><dd><p>
By specifying <tt>xfield</tt> as well as <tt>lofield</tt> and <tt>hifield</tt>,
range values are shown at given X, Y locations in the data.<tt> </tt>
</dl>
<h2>MANDATORY ATTRIBUTE</h2>
The <tt>lofield</tt> and <tt>hifield</tt> attributes MUST be specified.<tt> </tt>
<h2>ATTRIBUTES</h2>
<p>
<b>lofield</b>
<a href="attributetypes.html#dfield">
<i> dfield </i>
</a>
<dl>
<dt><dd><p>
Data field to use for low end of range.<tt> </tt>
Example: <tt>lofield: 1</tt>
</dl>
<p>
<b>hifield</b>
<a href="attributetypes.html#dfield">
<i> dfield </i>
</a>
<dl>
<dt><dd><p>
Data field to use for high end of range.<tt> </tt>
Example: <tt>hifield: 2</tt>
</dl>
<p>
<b>xfield</b>
<a href="attributetypes.html#dfield">
<i> dfield </i>
</a>
<dl>
<dt><dd><p>
Data field to use for X values.<tt> </tt>
If not specified, sequential unit locations in X will be used.<tt> </tt>
Example: <tt>xfield: 1</tt>
</dl>
<p>
<b>color</b>
<a href="color.html">
<i> color </i>
</a>
<dl>
<dt><dd><p>
Color of the range sweep.<tt> </tt>
Example: <tt>color: powderblue</tt>
</dl>
<p>
<b>legendlabel</b>
<a href="attributetypes.html#text">
<i> text </i>
</a>
<dl>
<dt><dd><p>
A label to be associated with the current range sweep in the legend.<tt> </tt>
<b>proc legend</b> must be executed later in order to
render the legend.<tt> </tt>
<br>
Example: <tt>legendlabel: Group A</tt>
</dl>
<p>
<b>sweeprange</b> <i>xlo</i> [<i>xhi</i>]
<dl>
<dt><dd><p>
If specified, range will be rendered only at x values falling between
<i>xlo</i> and <i>xhi</i>. <i>xlo</i> and <i>xhi</i> must be plottable
values in X. If <i>xhi</i> is not given then this will control
only the lower bound.<tt> </tt>
<br>
Example: <tt>sweeprange: 5 24</tt>
</dl>
<p>
<b>xstart</b>
<a href="attributetypes.html#plotvalue">
<i> plotvalue </i>
</a>
<dl>
<dt><dd><p>
If specified, and if using sequential locations in x (<tt>xfield</tt> not
specified), determines where in X the range will start.<tt> </tt>
</dl>
<p>
<b>select</b>
<a href="condex.html">
<i> conditional-expression </i>
</a>
<dl>
<dt><dd><p>
If specified, the <i>select-expression</i> will be used to determine
whether or not to plot a given row of data.<tt> </tt>
<br>
Example: <tt>select: @7 >= @9</tt>
<br>
<br>
</td></tr>
<td align=right>
<a href="Welcome.html">
<img src="ploticus.gif" border=0></a><br><small>data display engine <br>
<a href="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, <tt> </tt> <tt> </tt>June 18, 2001.
</body>
</html>
|