; FACTOR
;---------------------------------------------------------------
;! scales some display or CLEANing process
;# ADVERB IMAGING HARDCOPY PLOT TV
;-----------------------------------------------------------------------
;;  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
;-----------------------------------------------------------------------
;---------------------------------------------------------------
FACTOR    LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
----------------------------------------------------------------
FACTOR
Type: Adverb  (Real)
Use:  A multiplication factor.  Often used to scale plotted symbols (no
      comment below), to speed up Clean operations, and to scale the
      input data before addition os a model as well as other scalings.
Null value:  0  (0 for Clean and with input data, 1 for plot symbols, ...)
Verbs:
   CHARMULT......Changes the multiplication factor for TV characters.
   REMOVIE.......Verb to rerun a previously loaded (TVMOVIE) movie.
                 FACTOR is the zoom factor.
   RESCALE.......Verb to modify image scale factor and offset.
   TVCUBE........Verb to load a cube into tv channel(s) & run a movie.
                 FACTOR is the zoom factor.
   TVMOVIE.......Verb to load a cube into tv channel(s) & run a movie.
                 FACTOR is the zoom factor.
Procedures:
   LINIMAGE......Build image cube from multi-IF data set.  FACTOR is the
                 Clean speed-up factor.
   MAPPR.........Simplified access to IMAGR.  FACTOR is the Clean
                 speed-up factor.
   PIPEAIPS......Calibrating amplitude and phase, and imaging VLA data.
                 FACTOR is the frequency averaging factor.
   VLBARUN.......Applies amplitude and phase calibration procs to VLBA
                 data.  FACTOR scales the image size for calibration
                 sources (FACTOR * 128)
Tasks:
   ALVAR.........Plots the Allan Variance statistic of a UV data set.
   ANBPL.........Plots and prints uv data converted to antenna based
                 values.
   APCLN.........Deconvolves images with CLEAN algorithm.  FACTOR is the
                 Clean speedup parameter.
   BLPLT.........Plots BLCAL tables in 2 dimensions as function of
                 baseline and IF.
   BLSUM.........Sums images over irregular sub-images, displays spectra.
   BLWUP.........Blow up an image by any positive integer factor.
   BPLOT.........Plots bandpass tables in 2 dimensions as function of
                 time.
   BSCOR.........Combines two beam-switched images.  Beam throws are
                 scaled by FACTOR.
   BSGRD.........Task to image beam-switched single-dish data.  Beam
                 throws are scaled by FACTOR.
   BSROT.........Modifies SD beam-switch continuum data for error in
                 throw.  Beam throws are scaled by FACTOR.
   BSTST.........Graphical display of solutions to frequency-switched
                 data.  Beam throws are
                 scaled by FACTOR.
   CAPLT.........Plots closure amplitude and model from CC file.
   CCFND.........Prints the contents of a Clean Components extension file.
                 FACTOR scales the negative flux in the 2nd pass.
   CCGAU.........Converts point CLEAN components to Gaussians.  FACTOR
                 scales the component flux.
   CCRES.........Removes or restores a CC file to a map with a gaussian
                 beam.  FACTOR scales the residual image in addition to
                 the default (beam area) scaling.
   CLPLT.........Plots closure phase and model from CC file.
   CONVL.........Convolves an image with a Gaussian or another image.
                 FACTOR scales the output for the change in units.
   CORFQ.........Corrects uvw for incorrect observing frequency.  FACTOR
                 scales the input frequency.
   CUBIT.........Model a galaxy's density and velocity distribution from
                 full cube.  FACTOR is a convergence criterion.
   DCONV.........Deconvolves a gaussian from an image.  FACTOR is the
                 fraction of non-blanked pixels to call a pixel "not
                 isolted".
   ELFIT.........Plots/fits selected contents of SN, TY, SY, PC or CL
                 files.
   FRPLT.........Task to plot fringe rate spectra.
   GAL...........Determine parameters from a velocity field.
   GSTAR.........Task to read a Guide Star (UK) table and create an ST
                 table.  FACTOR is the start type.
   HOLGR.........Read & process holography visibility data to telescope
                 images.  FACTOR is the magnification.
   HOLOG.........Read & process holography visibility data to telescope
                 images.  FACTOR is the antenna magnification.
   IMAGR.........Wide-field and/or wide-frequency Cleaning / imaging task.
                 FACTOR is the Clean speedup parameter.
   IMERG.........Merges images of different spatial resolutions.
                 Optional normalization factor for the low-resolution
                 image.
   IMMOD.........Adds images of model objects to an image.  FACTOR
                 scales the input data before addition of the model.
   IMTXT.........Write an image to an external text file.  FACTOR scales
                 the input pixels before they are written.
   IRING.........Integrates intensity / flux in rings / ellipses.
   ISPEC.........Plots and prints spectrum of region of a cube.  FACTOR
                 scales derivatives when plotting them.
   KNTR..........Make a contour/grey plot file from an image w multiple
                 panels.  FACTOR scales polarization vectors.
   LISTR.........Prints contents of UV data sets and assoc. calibration
                 tables.  FACTOR scales GAIN listings.
   MODIM.........Adds images of model objects to image cubes in IQU
                 polarization.  FACTOR scales the input image before
                 addition of the model.
   MODSP.........Adds images of model objects to image cubes in I/V
                 polarization.  FACTOR scales the input image before
                 addition of the model.
   OOSUB.........Subtracts/divides a model from/into a uv data base.
                 FACTOR scales coponent fluxes.
   PASTE.........Pastes a selected subimage of one image into another.
                 FACTOR scales the sub-image pixel values.
   PCNTR.........Generate plot file with contours plus polarization
                 vectors.  FACTOR scales the plotted polarization vectors.
   PCPLT.........Plots pulse-cal tables in 2 dimensions as function of
                 time.  FACTOR scales the plotted spectra.
   PDPLT.........Plots selected contents of PD tables.
   PLOTR.........Basic task to generate a plot file from text input.
   POSSM.........Task to plot total and cross-power spectra.
   PRTAN.........Prints the contents of the ANtenna extension file.
   PRTIM.........Prints image intensities from an MA catalog entry.
   RGBMP.........Task to create an RGB image from the 3rd dim of an image.
                 FACTOR scales input image values to produce an "optical
                 depth" used with some OPTYPEs.
   RSTOR.........Restores a Clean component file to a map with a Gaussian
                 beam.  FACTOR scales component fluxes.
   SCIMG.........Full-featured imaging plus self-calibration loop with
                 editing.  FACTOR is the Clean speedup parameter.
   SCMAP.........Imaging plus self-calibration loop with editing.
                 FACTOR is the Clean speedup parameter.
   SDCLN.........Deconvolves image by Clark and then "SDI" cleaning
                 methods.  FACTOR is the Clean speedup parameter.
   SNBLP.........Plots selected contents of SN or CL files on a baseline
                 basis.
   SNFIT.........Fits parabola to SN amplitudes and plots result.
   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.
   SOUSP.........Fits source spectral index from SU table or adverbs.
   SPMOD.........Modify UV database by adding a model with spectral lines.
                 FACTOR scales the input data before addition of model.
   SPRMS.........Plots spectral statistics of a selected subset of a uv
                 data set.
   SUMIM.........Task to sum overlapping, sequentially-numbered images.
                 FACTOR scales the images.
   SUMSQ.........Task to sum the squared pixel values of overlapping images
.                FACTOR scales each squared image before being added.
   SYPRT.........Task to print values from the SY table.  FACTOR scales
                 the numbers being printed.
   SYVSN.........Plots selected SY/TY data with SN solution values versus
                 time.
   TAPLT.........Plots data from a Table extension file.
   TARPL.........Plot input and output text files of the TARS task.
   UVADC.........Fourier transforms and corrects a model and adds to uv
                 data.  FACTOR scales component fluxes.
   UVCON.........Generate sample UV coverage given a user defined array
                 layout.  FACTOR scales the model.
   UVHOL.........Prints holography data from a UV data base with
                 calibration.
   UVMOD.........Modify UV database by adding a model incl spectral index.
                 FACTOR scales the input data before addition of the model.
   UVPLT.........Plots data from a UV data base in multiple ways.
   UVSUB.........Subtracts/divides a model from/into a uv data base.
                 FACTOR scales the component fluxes.
   VPLOT.........Plots uv data and model from CC file.
   WARP..........Model warps in Galaxies.  FACTOR is the convergence
                 criterion.
   WETHR.........Plots selected contents of WX tables, flags data based on
                 WX.
----------------------------------------------------------------
