; IM2PARM
;---------------------------------------------------------------
;! Specifes enhancement parameters for OOP-based imaging: 2nd set
;# ADVERB IMAGING OOP
;-----------------------------------------------------------------------
;;  Copyright (C) 2009
;;  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
;-----------------------------------------------------------------------
IM2PARM   LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
----------------------------------------------------------------
IM2PARM
Type: Adverb  (array(40))
Use:  To specify additional correction and other "enhancement"
      parameters to IMAGR above and beyond those in IMAGRPRM.  See
      EXPLAIN IMAGR for further discussion.

IM2PARM(1)-(7) Auto-boxing during Clean controls

       (1) IMAGR can create Clean boxes automatically.  In OVERLAP 2
     mode it will do this only in the facet about to be Cleaned.  In
     OVERLAP < 2, it looks at every facet at each major cycle.  It
     will find no more than the strongest IM2PARM(1) boxes each time
     it looks.  <= 0 => don't do auto-boxing.  Limit 50.

       (2) The auto-boxing starts by finding islands of emission >
     IM2PARM(2) * rms in the residual image.  This defines the size of
     the box if it is accepted.  (0 -> 3.0)

       (3) A box can only be accepted if its peak brightness is >
     IM2PARM(3) * rms in the residual.  A box is also accepted only if
     the peak in it is not already in a Clean box.
     < IM2PARM(2) -> IM2PARM(2) + 2.0

       (4) A box is also only accepted if its peak brightness is >
     IM2PARM(4) * maximum residual in the whole image.  < 0.01 OR >
     0.9 -> 0.1

       (5) The box determined by the island may be extended outward in
     all directions by IM2PARM(5) pixels.  < -1 => +1.  Note that -1
     means contract in all directions by 1 pixel.

       (6) The residual image is examined only in an ellipse (circle
     if IMSIZE(1) = IMSIZE(2)) of radius in X of IMSIZE(1)/2 -
     IM2PARM(6) and in Y of IMSIZE(2)/2 - IM2PARM(6).  <= 0 -> 5

       (7) When imaging an output cube, should spectral channel N+1
     begin with the boxes of channel N or only with those set up by
     BOXFILE, CLBOX, etc.?
           > 0 - begin with initial boxes in each channel
           < 0 - pass boxes along to next channel
           = 0 => +1 when auto-boxing, -1 when not doing auto-boxing

IM2PARM(8)-(10) Future expansion


IM2PARM(11)-(12) Baseline-length dependent time averaging:

       (11) The maximum elapsed time over which averaging of data may
            be done in seconds.  0 -> infinite
       (12) The desired field of view radius in arc minutes which is
            not to be distorted by time averaging in a
            baseline-dependent fashion.  <= 0 -> infinite or no
            averaging.  The field of view is the region in which
            averaging is not to reduce the amplitude by more than 1%
            on any baseline.  No data separated by more than 268.5
            wavelengths divided by IM2PARM(12) are averaged together.

IM2PARM(13)-(40) Future expansion

Tasks:
    IMAGR.....Wide-field and/or wide-frequency Cleaning / imaging
              task.
----------------------------------------------------------------
