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


        CLIC\FIND [APPEND] [NEW_DATA] [UPDATE] [/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]
        [/SKIPAUTO] [/EXCLUDE proc1 [...]] [/POLAR]

    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 :

    /TYPE type           search by source type
    /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
    /SOURCE s1 ... sn    search by source name
    /PROCEDURE p1 .. pn  search by procedure name(s)
    /QUALITY q           search for the data of quality better than q
    /TELESCOPE tel       search for the specified telescope name
    /RECEIVER number     search by receiver number
    /MODE mode           search by correlation mode (auto/cross)
    /LOAD load           search by load type (hot/cold/sky)
    /SKIPAUTO            skip the autocorrelations in cross scans
    /EXCLUDE             exclude from the search by procedure name(s)

    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-

    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.

    Argument UPDATE will perform a FIND using an updated input file, in case
    new observations were added since the last FILE IN.

    Options /SOURCE, /PROCEDURE, /EXCLUDE and /SCAN have a maximum number of
    arguments  (20  sources,  10  procedures  kept  or excluded and 100 scan
    ranges). Input list will be truncated with a warning if needs be.


Gildas manager 2022-01-17