AIPS NRAO AIPS HELP file for ANTENNAS in 31DEC24



As of Mon Mar 18 22:53:41 2024



HELP SECTION

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.
   ACIMG.........Makes image of autocorrelation data showing time vs
                 frequency
   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.
   AVGWT.........Computes the average visibility weight of the included
                 data.
   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.
   BPPLT.........Plots selected contents of bandpass (BP) files versus
                 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.
   CLOSE.........Plots closure phase or amplitude spectra averaged over
                 closures.
   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.
   EVACL.........Evaluates statistics in closure phase and amplitude.
   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.
   HOLIS.........Prints information about holography sampling.
   IANTB.........Writes out GC and TY data in ANTAB format
   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.
   PLRFI.........Plots spectral statistics from output of VBRFI & VLBRF
   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.
   RIRMS.........Computes rms of real/imag of a selected subset of a uv
                 data set
   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.
   SHAHO.........Flags Holography data for shadowing
   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.
   SNRMS.........Print statistics for selected contents of SN, SY, TY,
                 PC or CL files.
   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.
   TEPLT.........Plots selected contents of TE (TECOR) parameter tables.
   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.
   VBRFI.........Plots spectral statistics of VLBA autocorrelation data
                 for RFI.
   VH2RL.........Converts from linear to circular polarization and vice
                 versa.
   VLBRF.........Plots spectral statistics of VLBA autocorrelation data
                 for RFI.
   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.

EXPLAIN SECTION


AIPS