./guide
select.pro

Last modification date:

Wed Sep 28 13:27:09 2016

select

procedure select[, count], [/keep], [/quiet], [_EXTRA=extra keywords]

This procedure is used to select data from the current data file for later processing.

Selection puts the index numbers that match the selection criteria onto the end of the stack using appendstack. Once the index numbers are there, the can be used in a call to get or to kget to retrieve them from the data source.

Data can be selected based on entries in the index file, such as source name, polarization type, IF number, etc. For a complete list of eligible parameters use the procedure listcols

See the discussion on "Select" in the User's Guide for a summary of selection syntax.

The selection criteria are ultimately passed to the io class's search_index via the _EXTRA parameter.

Examples

 select,source='Orion*',/keep
 for i=0,(!g.acount-1) do begin
    get,index=astack(i)
    ; do things here
 endfor
 

Uses

select_data appendstack

Version

$Id$

Parameters
count out, optional variable	The number of records selected and added to the stack.

Keywords
keep in, optional boolean	If set, the selection comes from the keep file. If not set, the selection comes from the input file.
quiet in, optional boolean	Turn off informational messages.
_EXTRA in, optional extra keywords	These are the selection parameters.