next up previous contents index
Next: FITS Up: CLIC Language Internal Help Previous: FILE

FIND

 

        CLIC\FIND [Append] [New_Data] [/LINE Lname]
     [/NUMBER n1 n2] [/SCAN s1 s2 [s3 s4 ...]] [/QUALITY q]
     [/TELESCOPE Tname] [/PROCEDURE Proc1 Proc2 ...]
     [/TYPE Type] [/SOURCE s1 s2 ... sn] [/OFFSET o1 o2]

    FIND performs a search in the input file   to   build   a   new   index,
    according  to  selection  criteria  defined  by  the SET command.  These
    criteria may be temporarily modified by the following options :

    /LINE Lname         search by line name
    /NUMBER n1 n2       search for the specified range of observation numbers
    /SCAN s1 s2 [s3 s4] search for the specified range(s) of scan numbers
    /OFFSET a1 a2       search for these offsets
    /PROCEDURE p1  pn   search by procedure name(s)
    /QUALITY q          search for the data of quality better than Q.
    /SOURCE s1 ... sn   search by source name
    /TELESCOPE Tname    search for the specified telescope name
    /TYPE Type          search by source type (OBJECT, PHASE, or BANDPASS)
    FIND /SCAN s1 s2 [s3 s4 ..] will loop across the 9999/0001 border if  s1
    (s3)  is  larger than s2 (s4). Using several source names in FIND/SOURCE
    is now supported.

    Ths current index is ordered by scan number or receiver number depending
    on  the  last command SET SORT. However the scan ordering is done modulo
    9999 (i.e. the time order  is  respected  if  the  9999/0001  transition
    occurs in the current index).

    FIND by default overwrites the current index.  Found observations may be
    appended  to  the  current  index by specifying the argument APPEND ; an
    index compression occurs to avoid duplication of scans in the index.

    FIND does not return an error  if  the   index   is   empty,   but   the
    variable  FOUND  is  set  to  0.   FOUND  is always set to the number of
    observations in the index.

    Argument NEW_DATA can be used to wait until new data is present  in  the
    input   file.   This  possibility  is  intended  for  sites  where  data
    acquisition is done in CLIC format (Plateau de Bure) to use CLIC  as  an
    automated  quick  look  facility.   The  behaviour is similar to that of
    command NEW_DATA, but all  selection  criteria  are  considered  and  no
    switching to a new observation type occurs.


lucas@iram.fr