FIND
Keywords: clic

Next: FIND /POLAR Up: CLIC Language Internal Help Previous: FILE Contents Index

##
FIND

            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]
            [/RECEIVER number] [/MODE CORR|AUTO] [/LOAD HOT|COLD|SKY]
            [/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)
        /POLARISATION        search by polarisation subscan

        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.

        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.

Subsections

- FIND /POLAR