.ig >>
<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 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="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  Version 2.40 Jan'08
     </small><br><a href="../doc/scripthome.html">Scripts</a>
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH proc_rangesweep PL "15-JAN-2008   PL ploticus.sourceforge.net"

.ig >>
<center>
<img src="../gallery/rangesweep0.gif">
</center>
.>>

\fBproc rangesweep\fR draws a moving range from the
.ig >>
<a href="dataformat.html#currentds">
.>>
\0current data set,
.ig >>
</a>
.>>
in the 
.ig >>
<a href="areadef.html">
.>>
\0current plotting area.
.ig >>
</a>
.>>
See also the 
.ig >>
<a href="../gallery/gall.rangesweep.html">
.>>
\0gallery rangesweeps page.
.ig >>
</a>
.>>

.ig >>
<br><br><br>
.>>

.SH Attributes
The \fClofield\fR and \fChifield\fR attributes \fBmust\fR be specified.

.ig >>
<br><br>
.>>

.LP
\fBlofield\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
Data field to use for low end of range.
.br
Example: \fClofield: 1\fR

.ig >>
<br><br>
.>>

.LP
\fBhifield\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
Data field to use for high end of range.
Example: \fChifield: 2\fR


.ig >>
<br><br>
.>>

.LP
\fBxfield\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#dfield">
.>>
\0dfield
.ig >>
</a>
.>>
.IP \0
Data field to use for X values.
If not specified, sequential unit locations in X will be used.
Example: \fCxfield: 1\fR

.ig >>
<br><br>
.>>

.LP
\fBcolor\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
Color of the range sweep.
Example: \fCcolor: powderblue\fR

.ig >>
<br><br>
.>>

.LP
\fBlegendlabel\fR 
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#text">
.>>
\0 text 
.ig >>
</a>
.>>
.IP \0
A label to be associated with the current range sweep in the legend.
\fBproc legend\fR must be executed later in order to
render the legend.
The \fC\\n\fR construct can be used to force a line break when the legend is displayed,
or the label can be wordwrapped using proc legend wraplen attribute (2.32+).
.br
Example: \fClegendlabel: Group A\fR

.ig >>
<br><br>
.>>

.LP
\fBsweeprange\fR 
.ig >>
&nbsp; &nbsp;
.>>
\fIxlo\fR 
.ig >>
&nbsp; &nbsp;
.>>
[\fIxhi\fR]
.IP \0
If specified, range will be rendered only at x values falling between 
\fIxlo\fR and \fIxhi\fR.  \fIxlo\fR and \fIxhi\fR must be 
.ig >>
<a href="attributetypes.html#plotvalue">
.>>
\0plottable values
.ig >>
</a>
.>>
in X.  If \fIxhi\fR is not given then this will control
only the lower bound.
.br
Example: \fCsweeprange: 5 24\fR

.ig >>
<br><br>
.>>

.LP
\fBxstart\fR  
.ig >>
&nbsp; &nbsp;
.>>
.ig >>
<a href="attributetypes.html#plotvalue">
.>>
\0plotvalue
.ig >>
</a>
.>>
.IP \0
If specified, and if using sequential locations in x (\fCxfield\fR not
specified), determines where in X the range will start.

.ig >>
<br><br>
.>>

.LP
\fBselect\fR  
.ig >>
<a href="select.html">
.>>
\0select expression
.ig >>
</a>
.>>
.IP \0
If specified, the \fIselect-expression\fR will be used to determine
whether or not to plot a given row of data.
.br
Example: \fCselect: @7 >= @9\fR

.ig >>
<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>
<br>
<center>
Ploticus is hosted at http://ploticus.sourceforge.net <br>
<img src="http://sourceforge.net/sflogo.php?group_id=38453" width="88" height="31" border="0" alt="SourceForge Logo">
</center>
.>>
