AIPS HELP file for SCANTIME in 31DEC24

As of Thu Apr 25 18:34:30 2024

INPUTS

INNAME                             Name of data file
INCLASS                            Class of data file
INSEQ              0.0      9999.0 Sequence number of data file
INDISK             0.0        15.0 Disk number of data file

          Give the scan number as an immediate argument. For
          example, SCANTIME(3)

          SCANTIME is defined in the VLBAUTIL run file.

HELP SECTION

SCANTIME
Type: Procedure
Use:  SCANTIME returns the time range covered by a scan listed in an index
      table as an 8-element array value having the same form as TIMERANG.

      Type RUN VLBAUTIL before using ANTNUM for the first time

Adverbs
  INNAME......The name of the data file. Wildcards allowed.
  INCLASS.....The class of the data file. Wildcards allowed.
  INSEQ.......The sequence number of the data file.
                0 => highest
  INDISK......The disk number of the disk that holds the data file
                0 => any

EXPLAIN SECTION

SCANTIME:         Procedure to look up scan time range.
Documentor:       Chris Flatters
Related Programs: LISTR, VLBAUTIL

SCANTIME returns the timerange covered by a scan defined by an index table.
It may be used to set the TIMERANG adverb for a single scan given a scan
number as shown by LISTR with OPTYPE = 'SCAN' as in the following example.

GETN 3
TIMERANG = SCANTIME(5)

To have SCANTIME print the scan time range to the terminal type, for the
3rd scan as an example:
TYPE SCANTIME(3)

The starting time of the scan is rounded up to the nearest second and the
ending time of the scan is rounded down to the nearest second so that time
returned time range is wholly contained within the scan.

If the argument specifies a scan that is not in the index table then the
returned value is all zeros.