; TIMERANG
;---------------------------------------------------------------
;! Specifies a time range
;# ADVERB GENERAL
;-----------------------------------------------------------------------
;;  Copyright (C) 1995, 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
;-----------------------------------------------------------------------
;---------------------------------------------------------------
TIMERANG  LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
----------------------------------------------------------------
TIMERANG
Type: Adverb  (REAL(8))
Use:  Standard data selection adverb, used to specify a time range. The
      first four entries specify the start day, hour, minute and second
      and the last four give the end day, hour, minute and second.  Note
      that floating point values may also be used, e.g.
          timerang = 0.5 0 0 0 0.75
      mean to include times from 12:00 to 18:00 on the first day.
Null Value:  0
      All null value for the start time means include from the beginning
      and all null value for the stop time means include to the end.
Verbs:
   OBITIMAG......Access to OBIT task Imager without self-cal or peeling.
   OBITPEEL......Access to OBIT task Imager with self-cal and peeling.
   OBITSCAL......Access to OBIT task Imager with self-cal, NOT peeling.
Procedures:
   BREAK.........Procedure to TELL FILLM to break all current uv files,
                 start new.
   CRSFRING......Procedure to calibrate cross pol. delay and phase
                 offsets.
   FEW...........Procedure to TELL FILLM to append incoming data to
                 existing uv files.
   FXALIAS.......Least squares fit aliasing function and remove.
   LINIMAGE......Build image cube from multi-IF data set.
   MANY..........Procedure to TELL FILLM to start new uv files on each
                 scan.
   MAPPR.........Simplified access to IMAGR.
   QUIT..........Procedure to TELL FILLM to stop at the end of the current
                 scan.
   SCANTIME......Returns time range for a given scan number.
   STOP..........Procedure to TELL FILLM to break all current uv files and
                 stop.
   TELFLM........Procedure to TELL real-time FILLM a new APARM(1) value.
   VLACALIB......Runs CALIB and LISTR for VLA observation.
   VLACLCAL......Runs CLCAL and prints the results with LISTR.
   VLALIST.......Runs LISTR for VLA observation.
   VLBABPSS......Computes spectral bandpass correction table.
   VLBACPOL......Procedure to calibrate cross-polarization delays.
   VLBACRPL......Plots crosscorrelations.
   VLBAFRGP......Fringe fit phase referenced data and apply calibration.
   VLBAFRNG......Fringe fit data and apply calibration.
   VLBAKRGP......Fringe fit phase referenced data and apply calibration.
   VLBAKRNG......Fringe fit data and apply calibration.
   VLBAMPCL......Calculates and applies manual instrumental phase
                 calibration.
   VLBAPCOR......Calculates and applies instrumental phase calibration.
   VLBARUN.......Applies amplitude and phase calibration procs to VLBA
                 data.
   VLBASNPL......Plots selected contents of SN or CL files.
Tasks:
   ACCOR.........Corrects cross amplitudes using auto correlation
                 measurements.
   ACFIT.........Determine antenna gains from autocorrelations.
   ACLIP.........Edits suto-corr data for amplitudes, phases, and weights
                 out of range.
   ACSCL.........Corrects cross amplitudes using auto correlation
                 measurements.
   ALVAR.........Plots the Allan Variance statistic of a UV data set.
   ALVPR.........Prints statistics on the Allan Variance 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.
   ATLOD.........Reads ATCA data in RPFITS dormat into AIPS.
   ATMCA.........Determines delay/phase gradient from calibrator
                 observations.
   AVSPC.........Averages uv-data in the frequency domain.
   BLAPP.........Applies baseline-based fringe solutions a la BLAPP.
   BLAVG.........Average cross-polarized UV data over baselines.
   BLCAL.........Compute closure offset corrections.
   BLCHN.........Compute closure offset corrections on a
                 channel-by-channel basis.
   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.
   BPWAY.........Determines channel-dependent relative weights.
   BPWGT.........Calibrates data and scales weights by bandpass
                 correction.
   BSCAN.........Seeks best scan to use for phase cal, fringe search, ..
   BSGRD.........Task to image beam-switched single-dish data.
   CALIB.........Determines antenna calibration: complex gain.
   CAPLT.........Plots closure amplitude and model from CC file.
   CL2HF.........Convert CL table to HF table.
   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.
   CLPLT.........Plots closure phase and model from CC file.
   CLSMO.........Smooths a calibration CL table.
   COHER.........Baseline Phase coherence measurement.
   CORER.........Calculates correlator statistics and flags bad ones.
   CPASS.........Computes polynomial spectral bandpass correction table.
   CSCOR.........Applies specified corrections to CS tables.
   CVEL..........Shifts spectral-line UV data to a given velocity.
   DECOR.........Measures the decorrelation between channels and IF of uv
                 data.
   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.
   DFTIM.........Makes image of DFT at arbitrary point showing time vs
                 frequency.
   DFTPL.........Plots DFT of a UV data set at arbitrary point versus
                 time.
   DIFRL.........Divides the RR data by LL data.
   DTCHK.........Task to check results of a test using simulated data.
   DTSUM.........Task to provide a summary of the contents of a dataset.
   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.
   FGPRT.........Pprints counts of selected portions of an FG table.
   FGSPW.........Flags bad spectral windows.
   FILLM.........Reads VLA on-line/archive format uv data tapes (post Jan
                 88).
   FINDR.........Find normal values for a uv data set.
   FITLD.........Reads FITS files to load images or UV (IDI or UVFITS)
                 data to disk.
   FLAGR.........Edit data based on internal RMS, amplitudes, weights.
   FLGIT.........Flags data based on the rms of the spectrum.
   FLOPM.........Reverses the spectral order of UV data, can fix VLA
                 error.
   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.
   GETJY.........Determines calibrator flux densities.
   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.
   M3TAR.........Translate Haystack MKIII VLBI format "A" TAR's into AIPS.
   MAPBM.........Map VLA beam polarization.
   MBDLY.........Fits multiband delays from IF phases, updates SN table.
   MK3IN.........Translate Haystack MKIII VLBI format "A" tapes into AIPS.
   NOIFS.........Makes all IFs into single spectrum.
   OBEDT.........Task to flag data of orbiting antennas.
   OMFIT.........Fits sources and, optionally, a self-cal model to uv
                 data.
   PCAL..........Determines instrumental polarization for UV data.
   PCCOR.........Corrects phases using  PCAL tones data from PC table.
   PCEDT.........Interactive TV task to edit pulse-cal (PC) tables.
   PCFIT.........Finds delays and phases using a pulse-cal (PC) table.
   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.
   PCVEL.........Shifts spectral-line UV data to a given velocity: planet
                 version.
   PDEDT.........Interactive TV task to edit polarization D-term (PD)
                 tables.
   PEEK..........Fits pointing model function to output from the VLA.
   PHSRF.........Perform phase-referencing within a spectral line
                 database.
   PLOTC.........Plots color schems used by 3-color plot tasks.
   POSSM.........Task to plot total and cross-power spectra.
   PRTSD.........Prints contents of AIPS single-dish data sets.
   PRTSY.........Task to print statistics from the SY table.
   QUACK.........Flags beginning or end portions of UV-data scans.
   REWAY.........Computes weights based in rms in spectra.
   RFI...........Look for RFI in uv data.
   RFLAG.........Flags data set based on time and freq rms in fringe
                 visibilities.
   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.
   SDCAL.........Task to apply single dish calibration.
   SDGRD.........Task to select and image random-position single-dish
                 data.
   SDVEL.........Shifts spectral-line single-dish data to a given
                 velocity.
   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.
   SPMOD.........Modify UV database by adding a model with spectral lines.
   SPRMS.........Plots spectral statistics of a selected subset of a uv
                 data set.
   SUFIX.........Modifies source numbers on uv data.
   SWAPR.........Modifies UV data by swapping real and imaginary parts.
   SYPRT.........Task to print values from the SY table.
   SYVSN.........Plots selected SY/TY data with SN solution values versus
                 time.
   TABED.........Task to edit tables.
   TI2HA.........Modifies times in UV data to hour angles.
   TIORD.........Checks data for time baseline ordering, displays
                 failures.
   TRUEP.........Determines true antenna polarization from special data
                 sets.
   TVFLG.........Interactive flagging of UV data using the TV.
   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.
   UV2MS.........Append single-source file to multi-source file.
   UV2TB.........Converts UV autocorrelation spectra to tables.
   UVAVG.........Average or merge a sorted (BT, TB) uv database.
   UVBAS.........Averages several channels and subtracts from uv data.
   UVCOP.........Task to copy a subset of a UV data file.
   UVFIT.........Fits source models to uv data.
   UVFLG.........Flags UV-data.
   UVFND.........Prints selected data from UV data set to search for
                 problems.
   UVFRE.........Makes one data set have the spectral structure of
                 another.
   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".
   UVLIN.........Fits and removes continuum visibility spectrum, also can
                 flag.
   UVLSD.........Least squares fit to channels and divides the uv data.
   UVLSF.........Least squares fit to channels and subtracts from uv data.
   UVMLN.........Edits data based on the rms of the spectrum.
   UVMOD.........Modify UV database by adding a model incl spectral index.
   UVMTH......... Averages one data set and applied it to another.
   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.
   UVRFI.........Mitigate RFI by Fourier transform or fitting the circle.
   UVRMS.........Computes statistics of a selected subset of a uv data
                 set.
   VLBIN.........Task to read VLBI data from an NRAO/MPI MkII correlator.
   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.
----------------------------------------------------------------
