.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 usedata</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 usedata</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>
.>>

.TH proc_usedata PL "11-MAR-2009   PL ploticus.sourceforge.net"
 
.LP
Select the 
.ig >>
<a href="dataformat.html#currentds">
.>>
\0current data set
.ig >>
</a>
.>>
for plotting.  
Typically used when additional derivations have been produced by proc processdata or tabulate, in order to
return to the original data set, or to "pop back" to an earlier data set on the stack.
.LP
Note: \fBproc getdata\fR always clears the stack and its result becomes dataset 1.

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

.SH Attributes
.LP
If no attributes are specified, default is \fCpop: all\fR.

.ig >>
<br><br>
.>>
.LP
\fBpop\fR  
.ig >>
&nbsp; &nbsp;
.>>
\fCall | \fIn\fR
.IP \0
If \fCall\fR, pop back to the original data set (proc getdata).
Otherwise, pop back \fIn\fR data sets.
After this is done, data sets above the current one in the stack are removed and unavailable.

.ig >>
<br><br>
.>>
.LP
\fBoriginaldata\fR  
.ig >>
&nbsp; &nbsp;
.>>
\fCyes\fR
.IP \0
Equivalent to \fCpop: all\fR

.ig >>
<br><br>
.>>
.LP
\fBfieldnames\fR 
.ig >>
&nbsp; &nbsp;
.>>
\fInamelist\fR
.IP \0
Set any data field names that will be in effect.  Field names are not retained in the data set stack structure,
so if a data set that had field names is made the current data set, the field names must be respecified here 
using this attribute.

.ig >>
<br><br>
.>>
.LP
\fBelement\fR  
.ig >>
&nbsp; &nbsp;
.>>
\fIn\fR
.IP \0
Stack element \fIn\fR becomes the current data set for plotting.
\fBDiscontinued as of version 2.40\fR.  

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

.SH Example
.LP
.nf
 \0 #proc usedata
 \0   original: yes
.fi

.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>
<table><tr><td>
Ploticus is hosted at http://ploticus.sourceforge.net</td><td> &nbsp; </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>
.>>
