AIPS NRAO AIPS HELP file for ANTNUM in 31DEC25



As of Mon Jun 30 16:54:57 2025


ANTNUM: Procedure to return the number of an antenna

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
SUBARRAY           0.0             Subarray number
                                     0 => 1

          Give the name of the antenna as an immediate argument.
          For example, ANTNUM('PT')

          ANTNUM is defined in the VLBAUTIL run file.

HELP SECTION

ANTNUM
Type: Procedure
Use:  ANTNUM returns the antenna number of the antenna named as its
      immediate argument in the specified subarray belonging to the
      specified data file.  If the named antenna can not be found then
      ANTNUM will return zero.

      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
  SUBARRAY....Subarray number. 0 => 1

EXPLAIN SECTION

ANTNUM:           Procedure to look up antenna number
Documentor:       Chris Flatters
Related Programs: Any using ANTENNAS, BASELINE, or REFANT.

ANTNUM returns the antenna number of a named antenna. You can use
ANTNUM to set antenna adverbs for AIPS tasks without having to consult
antenna table listings as in the following example.

TASK = 'CALIB'
GETN 3
SUBARRAY = 1
ANTENNAS = ANTNUM('PT'), ANTNUM('LA'), ANTNUM('FD')
REFANT   = ANTNUM('PT')

To have ANTNUM print an antenna number to the terminal type, for SC as
an example:
TYPE ANTNUM('SC')

ANTNUM will not work on files without antenna (AN) tables.

AIPS