; 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. ----------------------------------------------------------------