Next: FITS
Up: CLIC Language Internal Help
Previous: FILE
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