./guide
nget.pro

Last modification date:

Wed Sep 28 13:27:09 2016

nget

procedure nget, nsave, [buffer=long], [/infile], [useflag=boolean or string], [skipflag=boolean or string], [ok=variable]

Get a previously saved data container with the matching nsave number, and put it in the indicated global buffer number.

Only spectral line data can currently be fetched using an nsave number.

nget fetchs data from the output file (keep file) unless infile is set.

Flags (set via flag) can be selectively applied or ignored using the useflag and skipflag keywords. Only one of those two keywords can be used at a time (it is an error to use both at the same time). Both can be either a boolean (/useflag or /skipflag) or an array of strings. The default is /useflag, meaning that all flag rules that have been previously set are applied when the data is fetched from disk, blanking data as described by each rule. If /skipflag is set, then all of the flag rules associated with this data are ignored and no data will be blanked when fetched from disk (it may still contain blanked values if the actual values in the disk file have already been blanked by some other process). If useflag is a string or array of strings, then only those flag rules having the same idstring value are used to blank the data. If skipflag is a string or array of strings, then all flag rules except those with the same idstring value are used to blank the data.

Examples

   getps,10  ; get some data
   ; do stuff to it
   nsave,50  ; its now in nsave=50
   ; do more stuff to that data, oops, thats no good
   ; back to previous state
   nget,50
 

Uses

set_data_container

Version

$Id$

Parameters
nsave in, required long	nsave number to be retrieved

Keywords
buffer in, optional long	global buffer number where the retrieved spectrum is stored (defaults to 0).
infile in, optional boolean	if set, use line input file instead of the output file.
useflag in, optional boolean or string (def. true)	Apply all or just some of the flag rules?
skipflag in, optional boolean or string	Do not apply any or do not apply a few of the flag rules?
ok out, optional variable	status output