./guide
find.pro

Last modification date:

Wed Sep 28 13:27:08 2016

find

procedure find, [/keep], [/append]

Put entries in to the stack based on the given selection criteria in the global find structure. This is an alternative to select.

Use setfind to set specific selection criteria. Once set, they remain set until cleared using clearfind. FIND uses those selection criteria and select to add entries to the stack corresponding to items in the data source that match the selection criteria. The stack can then be iterated through to process just the most recently found data.

Note: unlike select, find clears the stack unless the /append keyword is used. This has been done to make the behavior of FIND more like the CLASS version of FIND.

Examples

  ; define the selection
  setfind,'scan',100,200 ; scans 100 through 200
  find
  ; refine it
  setfind,'polarization','LL'  ; only the LL polarization
  find
  ; refine it
  setfind,'int','2:3'   ; only integrations 2 and 3
  find
  ; refine it
  setfind,'int',4,/append ; add integration 4 to the set
  find
  ; this is equivalent to the previous 2 setfind examples.
  ; note that any valid selection string can be used
  setfind,'int','2:3,4'
  setfind,'polarization','RR'   ; the other polarization
  find,/append   ; the LL selection is still there due to /append
  clearfind,'int'    ; clear the integration parameter
  find           ; all integrations, RR polarization, scans 100 to 200.
 

If you often set the same parameter, you can write a procedure, as in this example, to save yourself time. You might add optional feedback to the user that the parameter was set and you might add additional parameter checks.

   pro setsrc,src
      setfind,'source',src
   end
 

Uses

emptystack select

Version

$Id$

Keywords
keep in, optional boolean	Select entries from the currently attached output (keep) file.
append in, optional boolean	When set, the stack is not first cleared before select is used to add values to the stack. Use this with some caution since this may cause the same entries to appear more than once in the stack unless the selection criteria used by FIND are changed carefully.