; OUTFILE
;---------------------------------------------------------------
;! specifies name of output disk file, not in regular catalog
;# ADVERB GENERAL HARDCOPY
;-----------------------------------------------------------------------
;;  Copyright (C) 1995, 2002, 2008, 2019-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
;-----------------------------------------------------------------------
OUTFILE   LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
----------------------------------------------------------------
OUTFILE
Type: Adverb  (String*48)
Use:  To specify the name of some disk file outside the usual AIPS
      catalog system to be used as output from an AIPS verb or task.
      The file can be a text file giving a printer display or a
      graphics plot for printing or it can be a FITS file containing
      ASCII headers and binary data.

Format: The name is usually given by specifying a logical device plus
      directory, followed by a colon, followed by the actual file
      name.  In Unix, logicals are environment variables.  The
      logical name must be set up before entering the AIPS program
      and is usually in upper case.  Thus, for example:
             % setenv MYAREA ~joeuser
      for the C shell, and
             $ myarea=$HOME; export MYAREA
      for bourne, korn, and bash shells.  Then in AIPS,
             OUTFILE = 'MYAREA:FITS.DAT'
      Note that the Unix-standard $ ahead of the logical is omitted.
      AIPS-standard logicals like FITS (often AIPS/FITS) are available
      also.  Other forms are now acceptable as well:
             OUTFILE = 'FITS.DAT
      will find the file in the $FITS directory (when reading or
      writing FITS disk files) or in the directory local when you
      started AIPS.  A full path name may also be given
             OUTFILE = '/home/primate2/egreisen/AIPS/Text.prt
      if it fits in 48 characters.  Note that the trailing quote mark
      is left off and this is the last command on the input line so
      that the case is preserved.

      In most programs, it is regarded as an error if OUTFILE already
      exists.  Some may concatenate to or replace pre-existing
      OUTFILEs.

      Under UNIX, it is now possible to read and write tape files with
      other, cooperating computers.  If the other computer is running
      the AIPS "deamon" task TPMON, then INFILE may also take the form
            <node>::<logical>:<file-name>
      where <node> is the name of the other computer, and <logical> is
      a name known to TPMON on that computer.  This limitation
      probably requires you to use the $FITS or $RUNFIL or other
      widely known AIPS areas.  (For real tape, the node name is given
      in the MOUNT command instead.) This option only applies to tapes
      (i.e. FITTP).

Null value:  '          '
      Taken to mean no subsidiary file.  This can be an error.
      For tapes, it means use a real tape drive given by INTAPE
      (which must already be MOUNTed).

Verbs:
    SG2RUN.......Verb copies the K area to a text file suitable for
                 RUN; OUTFILE contains POPS commands suitable for
                 re-creating a full POPS vocabulary with current adverb
                 values and compiled procedures.
Procedures:
    VLBAMPHC.....Applies VLBARUN calibration to additional phase
                 stopping centers.  OUTFILE is the directory to receive
                 the output html, text, and plot gifs.
    VLBARUN......Applies amplitude and phase calibration procs to VLBA
                 data.  OUTFILE is the directory to receive
                 the output html, text, and plot gifs.
    VLBDDT.......Verification tests using simulated data; OUTFILE
                 contains test results
Tasks:
    AFILE........Sorts and edits MkIII correlator A-file; OUTFILE is
                 the output A-file
    CONFI........Optimize array configuration by minimum side lobes;
                 OUTFILE contains the final configuration information
    DELZN........Determines residual atmosphere depth at zenith and
                 clock errors; OUTFILE is a table of delays and clock
                 errors suitable for CLCOR
    EXTAB........Exports AIPS table data as tab-separated text;
                 OUTFILE is tab-separated text suitable for input to
                 various data-base and spread-sheet programs
    FGTAB........Writes frequency-range flags to a text file to be
                 read by UVFLG
    FTARS........Fits 1-dimensional polarization spectrum to Q/U text
                 file.  OUTFILE is the output RM spectrum generated by
                 TARS and is an input to FTARS.
    HF2SV........Convert HF tables from FRING/MBDLY to form used by
                 Calc/Solve; OUTFILE is the directory name for holding
                 all the output files
    LWPLA........Translates plot file(s) to a PostScript printer or
                 file; OUTFILE is a disk file containing the
                 PostScript commands
    MTARS........Compute model inputs to TARS.
    OMFIT........Fits sources and, optionally, a self-cal model to uv
                 data; OUTFILE is final fitted model in KEYIN format
    PANEL........Convert HOLOG output to panel adjustment table
    PCRMS........Finds statistics of a pulse-cal table; flags bad
                 times and channels
    PRTSY........Prints statistics from the SY table
    QUXTR........Extracts text files from Q,U cubes for input to TARS
    RMTFC........Convolves rotation measure transfer function with
                 various slab models.
    TARS.........Simulation of Faraday rotation synthesis (mainly task
                 FARS)
    TFILE........Sorts and edits MkIII correlator UNIX-based A-file;
                 OUTFILE is the output A-file
    TVCPS........Task to copy a TV screen-image to a PostScript file;
                 OUTFILE is a disk file containing the PostScript
                 commands (suitable for printing, TeX, etc)
    TVRGB........Make TV image from images of true color (RGB) images;
                 OUTFILE is a disk file containing the PostScript
                 commands (suitable for printing, TeX, etc)
    UVCON........Generate sample UV coverage given a user defined
                 array layout; OUTFILE has antenna positions in
                 equatorial system plus other info cpoied from INFILE
    VLOG.........Pre-process external VLBA calibration files; OUTFILE
                 specifies the prefix used to name the output files
----------------------------------------------------------------
