; ANTENNAS
;---------------------------------------------------------------
;! Antennas to include/exclude from the task or verb
;# ADVERB CALIBRATION
;-----------------------------------------------------------------------
;;  Copyright (C) 1995, 1998, 2007, 2012, 2020
;;  Associated Universities, Inc. Washington DC, USA.
;;
;;  This program is free software; you can redistribute it and/or
;;  modify it under the terms of the GNU General Public License as
;;  published by the Free Software Foundation; either version 2 of
;;  the License, or (at your option) any later version.
;;
;;  This program is distributed in the hope that it will be useful,
;;  but WITHOUT ANY WARRANTY; without even the implied warranty of
;;  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;  GNU General Public License for more details.
;;
;;  You should have received a copy of the GNU General Public
;;  License along with this program; if not, write to the Free
;;  Software Foundation, Inc., 675 Massachusetts Ave, Cambridge,
;;  MA 02139, USA.
;;
;;  Correspondence concerning AIPS should be addressed as follows:
;;         Internet email: aipsmail@nrao.edu.
;;         Postal address: AIPS Project Office
;;                         National Radio Astronomy Observatory
;;                         520 Edgemont Road
;;                         Charlottesville, VA 22903-2475 USA
;-----------------------------------------------------------------------
ANTENNAS  LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
----------------------------------------------------------------
ANTENNAS
Type: Adverb  (REAL(50))
Use:  Standard data selection adverb, used to specify a list of antennas
      to be included in, or excluded from, an operation.  If any element
      of the array is negative then all antennas given are excluded;
      else all are included.  The antenna numbers used are the absolute
      values of the elements of ANTENNAS.  Note that some tasks may not
      support the exclusion option; check the help file.
Null Value:  0
      ANTENNAS = 0 usually means all antennas.

      ANTENNAS is often used with BASELINE.  In that case, a baseline
      between antenna I and J is selected (or deselected if any of
      ANTENNAS or BASELINE are negative) if
      # in ANTE     # in BASE     Selected or de-selected if
           0             0        always
          >0             0        (I in ANTE) .OR. (J in ANTE)
           0            >0        (I in BASE) .OR. (J in BASE)
          >0            >0        ((I in ANTE) .AND. (J in BASE)) .OR.
                                  ((I in BASE) .AND. (J in ANTE))

       Verbs VLA, EVLA, VLBA, and HSA may be used to set values into
       ANTENNAS (or any other adverb array).  In this case, the equals
       sign is required, e.g.,
               ANTENNAS = EVLA
               BASELINE = VLA
       to process all baselines between new EVLA and old VLA antennas.
       Be careful of INNAME et al., SUBARRAY, and DOINVERS which
       control what these verbs actually do.

Examples:
  1. BASELINE=0; ANTENNAS=0
         include everything
  2. BASELINE=0; ANTENNAS=1,2,3,4,5,6
         include only baselines between antennas 1 through 6
  3. BASELINE=0; ANTENNAS=1,2,-3,4,5,6
         include only baselines between antennas 7 through N
  4. BASELINE=0; ANTENNAS = 11,-19,27
         exclude any baseline involving antennas 11, 19, and/or 27
         thus, exclude 1-11, 7-19, 11-19, 26-27, etc. etc.
  5. BASELINE=1,2,7; ANTENNAS=3,4,5
         include baselines 1-3, 1-4, 1-5, 2-3, 2-4, 2-5, 3-7,
         4-7, 5-7 only
  6. BASELINE=1,-2,7; ANTENNAS=3,4,5
         include all baselines except 1-3, 1-4, 1-5, 2-3, 2-4, 2-5,
         3-7, 4-7, 5-7
  7. BASELINE=-10; ANTENNAS=-10
         exclude baseline 10-10 (autocorrelation), include all other
         baselines including those to antenna 10.

Procedures:
   ANTNUM........Returns number of a named antenna.
   BASFIT........Fits antenna locations from SN-table data.
   CRSFRING......Procedure to calibrate cross pol. delay and phase
                 offsets.
   IMFRING.......Large image delay fitting with IM2CC and OOFRING.
   IMSCAL........Large image self-cal with IM2CC and OOCAL.
   LINIMAGE......Build image cube from multi-IF data set.
   OOCAL.........Determines antenna complex gain with frequency-dependent
                 models.
   OOFRING.......Fringe fit data to determine calibration with spectral
                 index options.
   VLACALIB......Runs CALIB and LISTR for VLA observation.
   VLALIST.......Runs LISTR for VLA observation.
   VLBABPSS......Computes spectral bandpass correction table.
   VLBAMPCL......Calculates and applies manual instrumental phase
                 calibration.
   VLBAPCOR......Calculates and applies instrumental phase calibration.
Tasks:
   ACFIT.........Determine antenna gains from autocorrelations.
   ACLIP.........Edits suto-corr data for amplitudes, phases, and weights
                 out of range.
   ALVAR.........Plots the Allan Variance statistic of a UV data set.
   ANBPL.........Plots and prints uv data converted to antenna based
                 values.
   APCAL.........Apply TY and GC tables to generate an SN table.
   APGPS.........Apply GPS-derived ionospheric corrections.
   ATMCA.........Determines delay/phase gradient from calibrator
                 observations.
   BLAPP.........Applies baseline-based fringe solutions a la BLAPP.
   BLAVG.........Average cross-polarized UV data over baselines.
   BLCAL.........Compute closure offset corrections.
   BLING.........Find residual rate and delay on individual baselines.
   BLPLT.........Plots BLCAL tables in 2 dimensions as function of
                 baseline and IF.
   BPASS.........Computes spectral bandpass correction table.
   BPCOR.........Correct BP table.
   BPEDT.........Interactive TV task to edit uv data based on BP tables.
   BPEPL.........Plots bandpass tables overlaying multiple times like
                 BPEDT.
   BPFLG.........Flgas uv data based on bad BP values.
   BPLOT.........Plots bandpass tables in 2 dimensions as function of
                 time.
   CALIB.........Determines antenna calibration: complex gain.
   CLCAL.........Merges and smooths SN tables, applies them to CL tables.
   CLCOR.........Applies user-selected corrections to the calibration CL
                 table.
   CLIP..........Edits data based on amplitudes, phases, and weights out
                 of range.
   CLSMO.........Smooths a calibration CL table.
   COHER.........Baseline Phase coherence measurement.
   CPASS.........Computes polynomial spectral bandpass correction table.
   CSCOR.........Applies specified corrections to CS tables.
   DEFLG.........Edits data based on decorrelation over channels and time.
   DELZN.........Determines residual atmosphere depth at zenith and clock
                 errors.
   DFCOR.........Applies user-selected corrections to the calibration CL
                 table.
   DTCHK.........Task to check results of a test using simulated data.
   EDITA.........Interactive TV task to edit uv data based on TY/SY/SN/CL
                 tables.
   EDITR.........Interactive baseline-oriented visibility editor using the
                 TV.
   ELFIT.........Plots/fits selected contents of SN, TY, SY, PC or CL
                 files.
   ELINT.........Determines and removes gain dependence on elevation.
   EVASN.........Evaluates statistics in SN/CL tables.
   EVAUV.........Subtracts & divides a model into UV data, does statistics
                 on results.
   FARAD.........Add ionospheric Faraday rotation to CL table.
   FGCNT.........Counts samples comparing two flag tables.
   FGPLT.........Plots selected contents of FG table.
   FRING.........Fringe fit data to determine antenna calibration, delay,
                 rate.
   FRMAP.........Task to build a map using fringe rate spectra.
   FRPLT.........Task to plot fringe rate spectra.
   FTFLG.........Interactive flagging of UV data in channel-time using the
                 TV.
   FUDGE.........Modifies UV data with user's algorithm: paraform task.
   GCPLT.........Plots gain curves from text files.
   GETJY.........Determines calibrator flux densities.
   HF2SV.........Convert HF tables from FRING/MBDLY to form used by
                 Calc/Solve.
   IBLED.........Interactive BaseLine based visibility EDitor.
   IMAGR.........Wide-field and/or wide-frequency Cleaning / imaging task.
   KRING.........Fringe fit data to determine antenna calibration, delay,
                 rate.
   LISTR.........Prints contents of UV data sets and assoc. calibration
                 tables.
   LOCIT.........Fits antenna locations from SN-table data.
   LPCAL.........Determines instrumental polarization for UV data.
   MAPBM.........Map VLA beam polarization.
   OBTAB.........Recalculate orbit parameters and other spacecraft info.
   OMFIT.........Fits sources and, optionally, a self-cal model to uv
                 data.
   PCAL..........Determines instrumental polarization for UV data.
   PCEDT.........Interactive TV task to edit pulse-cal (PC) tables.
   PCFLG.........Interactive flagging of Pulse-cal data in channel-TB
                 using the TV.
   PCPLT.........Plots pulse-cal tables in 2 dimensions as function of
                 time.
   PDEDT.........Interactive TV task to edit polarization D-term (PD)
                 tables.
   PDPLT.........Plots selected contents of PD tables.
   PEEK..........Fits pointing model function to output from the VLA.
   POSSM.........Task to plot total and cross-power spectra.
   PRTSD.........Prints contents of AIPS single-dish data sets.
   QUACK.........Flags beginning or end portions of UV-data scans.
   RESEQ.........Renumber antennas.
   RLCAL.........Determines instrumental right-left phase versus time (a
                 self-cal).
   RLDIF.........Determines Right minus Left phase difference, corrects
                 cal files.
   RLDLY.........Fringe fit data to determine antenna R-L delay
                 difference.
   SBCOR.........Task to correct VLBA data for phase shift between USB &
                 LSB.
   SHOUV.........Displays uv data in various ways.
   SNBLP.........Plots selected contents of SN or CL files on a baseline
                 basis.
   SNCOR.........Applies user-selected corrections to the calibration SN
                 table.
   SNEDT.........Interactive SN/CL/TY/SY table editor using the TV.
   SNFIT.........Fits parabola to SN amplitudes and plots result.
   SNFLG.........Writes flagging info based on the contents of SN files.
   SNIFS.........Plots selected contents of SN, TY, SY, PC or CL files by
                 IF.
   SNPLT.........Plots selected contents of SN, SY, TY, PC or CL files
                 versus time.
   SNSMO.........Smooths and filters a calibration SN table.
   SOLCL.........Adjust gains for solar data according to nominal
                 sensitivity.
   SPCAL.........Determines instrumental polzn. for spec. line UV data.
   SPFLG.........Interactive flagging of UV data in channel-TB using the
                 TV.
   SPLAT.........Applies calibration and splits or assemble selected
                 sources.
   SPLIT.........Converts multi-source to single-source UV files w
                 calibration.
   SPRMS.........Plots spectral statistics of a selected subset of a uv
                 data set.
   SWPOL.........Swap polarizations in a UV data base.
   SYPRT.........Task to print values from the SY table.
   SYVSN.........Plots selected SY/TY data with SN solution values versus
                 time.
   TECOR.........Calculate ionospheric delay and Faraday rotation
                 corrections.
   TVFLG.........Interactive flagging of UV data using the TV.
   TYCOP.........Copy TY or SY table calibration between IFs.
   TYSMO.........Smooths and filters a calibration TY or SY table.
   UFLAG.........Plots and edits data using a uv-plane grid and the TV.
   USUBA.........Assign subarrays within a uv-data file.
   UVCOP.........Task to copy a subset of a UV data file.
   UVCRS.........Finds the crossing points of UV-ellipses.
   UVFIT.........Fits source models to uv data.
   UVFLG.........Flags UV-data.
   UVFND.........Prints selected data from UV data set to search for
                 problems.
   UVGIT.........Fits source models to uv data.
   UVHGM.........Plots statistics of uv data files as histogram.
   UVHIM.........Makes image of the histogram on two user-chosen axes.
   UVHOL.........Prints holography data from a UV data base with
                 calibration.
   UVIMG.........Grid UV data into an "image".
   UVPLT.........Plots data from a UV data base in multiple ways.
   UVPRM.........Measures parameters from a UV data base.
   UVPRT.........Prints data from a UV data base with calibration.
   UVRMS.........Computes statistics of a selected subset of a uv data
                 set.
   VPLOT.........Plots uv data and model from CC file.
   WETHR.........Plots selected contents of WX tables, flags data based on
                 WX.
   WIPER.........Plots and edits data from a UV data base using the TV.
   XYDIF.........Find/apply X minus Y linear polarization phase
                 difference.
   XYMOD.........Compute linear polarization point source model, applies
                 to data.
----------------------------------------------------------------
