next up previous contents index
Next: FIND /POLAR Up: CLIC Language Internal Help Previous: FILE   Contents   Index


FIND

        CLIC\FIND [APPEND] [NEW_DATA] [/LINE lname] [/NUMBER n1 n2]
        [/SCAN s1 s2 [s3 s4 ...]] [/OFFSET o1 o2] [/PROCEDURE proc1 [...]]
        [/QUALITY q] [/SOURCE s1 s2 ... sn] [/TELESCOPE tel] [/TYPE type]
        [/RECEIVER number]

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

    /LINE lname          search by line name
    /NUMBER n1 n2        search for the specified range of obs. numbers
    /SCAN s1 s2 [s3 s4]  search for the specified range(s) of scan numbers
    /OFFSET o1 p2        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 tel       search for the specified telescope name
    /TYPE type           search by source type
    /RECEIVER number     search by receiver number

    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. Source name and Line name matching is not case  sensi-
    tive.

    The current index is ordered by scan number or receiver number depending
    on the last command SET SORT issued. However the scan ordering  is  done
    modulo  9999  (i.e. the time order is respected if the 9999/0001 transi-
    tion 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 in-
    dex 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. The command IGNORE can be used to declare a list of  observa-
    tions to be ignored by the FIND command.

    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  acquisi-
    tion is done in CLIC format (Plateau de Bure) to use CLIC as an automat-
    ed 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.


Subsections

Gildas manager 2014-07-01