.ti -4
2 CLEAN__ARES

This is the minimal flux in the dirty map that the program will consider as
significant.  Alternatively, the threshold can be specified as a fraction
of the peak flux using CLEAN__FRES.  Once this level has been reached the program
stops subtracting, and starts the restoration phase.  The unit for this
parameter is the map unit (typically Jy/Beam).  The parameter should
usually be of the order of magnitude of the expected noise in the clean
map.

If 0, CLEAN__FRES will be used instead. If all of CLEAN__NITER, CLEAN__ARES 
and CLEAN__FRES are 0,
an absolute residual equal to the noise level will be used for CLEAN__ARES.

Short form is ARES.

This may be overseded by the /ARES option which imposes a limit
per plane through an array of values.

.ti -4
2 CLEAN__FRES

This is the minimal fraction of the peak flux in the dirty map that the
program will consider as significant.  Alternatively, an absolute threshold
can be specified using CLEAN__ARES.  Once this level has been reached the program
stops subtracting, and starts the restoration phase.  This parameter is
normalized to 1 (neither in % nor in db).  It should usually be of the
order of magnitude of the inverse of the expected dynamic range of the
intensity.

If 0, CLEAN__ARES will be used instead. If all of CLEAN__NITER, CLEAN__ARES 
and CLEAN__FRES are 0, an absolute residual equal to the noise level will 
be used for CLEAN__ARES.

Short form is FRES.

.ti -4
2 CLEAN__GAIN

This is the gain of the subtraction loop.  It should typically be chosen in
the range 0.05 and 0.3.  Higher values give faster convergence, while lower
values give a better restitution of the extended structure. A sensible
default is 0.2.

Short form is GAIN.

.ti -4
2 CLEAN__INFLATE 

  Maximum Inflation factor for UV__RESTORE (MULTISCALE method).
If the number of true (i.e. pixel based) Clean components found by 
MULTISCALE is larger than CLEAN__INFLATE times the number of compressed 
(i.e. those with the smoothing factor information) components, expansion
of the compressed components will not be possible, and UV__RESTORE
will not be useable. 

  A default of 50 is in general adequate.  Better solutions might
be found in the future, and this parameter suppressed. Apart from
memory usage, this number has no consequence on the algorithm.

.ti -4
2 CLEAN__NCYCLE     

  Maximum number of Major Cycles for the SDI and CLARK methods.

.ti -4
2 CLEAN__NGOAL   

  Number of clean components to be selected in a Cycle in the
ALMA heterogeneous array cleaning method.  
      

.ti -4
2 CLEAN__NITER

This is the maximum number of components the program will accept to
subtract.  Once it has been reached, the program starts the restoration
phase. 

If 0, the program will guess a number, based on the image
size and maximum signal-to-noise ratio, and specified residual level
CLEAN__ARES and/or CLEAN__FRES.

Short form is NITER.

This may be overseded by the /NITER option which imposes a limit
per plane through an array of values.

.ti -4
2 CLEAN__NKEEP

This is an integer specifying the minimum number of Clean components
before testing if Cleaning has converged. The convergence is criterium 
is a comparison of the cumulative flux evolution separated by
CLEAN__NKEEP components. If th

IF CLEAN__NKEEP is 0, CLEAN will ignore this convergence criterium, 
and continue clean until the CLEAN__NITER, CLEAN__ARES or CLEAN__FRES 
criteria indicate to stop.

With CLEAN__NKEEP > 0, CLEAN will explore the stability of the total clean
flux over the last CLEAN__NKEEP  iterations. For a positive (resp. 
negative) source, if the Clean flux becomes smaller (resp. larger) 
than the Clean flux CLEAN__NKEEP iterations earlier, CLEAN will stop.

Using CLEAN__NKEEP about 70 is a reasonable value.
Some special cases (faint extended sources) may require larger 
values of CLEAN__NKEEP. 

.ti -4
2 CLEAN__POSITIVE

The minimum number of positive components before negative ones are
selected.

.ti -4
2 CLEAN__SEARCH    


  Fraction of peak response of the primary beams coverage beyond
which no Clean component is searched in a Mosaic deconvolution.

The default is 0.2.
    
.ti -4
2 CLEAN__SIDELOBE  

Minimal relative intensity to consider for fitting the syntheized
beam to obtain the Clean beam parameters (MAJOR, MINOR and ANGLE) 
when 0.  The default is 0.35.

In case of poor UV coverage, CLEAN__SIDELOBE should be higher than the
maximum sidelobe level to perform a good Gaussian fit. Some particularly
bad UV coverage may not allow any good fit at all, however.


.ti -4
2 CLEAN__SMOOTH     

  Smoothing factor between different scales in the MRC and MULTISCALE
methods.  The default is 2 or 4 for MRC
depending on image size. It is sqrt(3) for MULTISCALE and may
be set to larger values if needed. 
  
.ti -4
2 CLEAN__SPEEDY    

  Speed-up factor for the CLARK major cycles. The default is 1.0.
Larger values may be used, but at the expense of possible instabilities
of the algorithm.

.ti -4
2 CLEAN__TRUNCATE   

  Fraction of peak response of the primary beams coverage under
which the Sky brightness image is blanked in a Mosaic deconvolution.
  
  It is also used as a default truncation value in the PRIMARY
command.

The default is 0.2.

.ti -4
2 CLEAN__WORRY     

  Worry factor in the MULTISCALE method for convergence. It propagates
the S/N from one iteration to the other, so that if this S/N
degrades, the method stops. Default is 0 (no propagation, and
hence no test on S/N).  The value should be < 1.0 in all cases.

 
.ti -4
2 METHOD

  Method used for the deconvolution. Can be HOGBOM, MULTI, MRC,
  SDI or CLARK.
  
  
.ti -4
2 Old__Names:

  Some of the CLEAN parameters have kept their old names:
MAJOR, MINOR, ANGLE (which are also used by command FIT)
BLC, TRC and BEAM__PATCH (which are seldom used)
  
  Others have equivalent short names: ARES, FRES, GAIN, NITER
for which the CLEAN__ prefix may be omitted.

.ti -4
2 BLC

These are the (pixel) coordinates of the Bottom Left Corner of the cleaning
box.  The default (0,0) means the bottom left quarter (Nx/4,Ny/4).
If a SUPPORT is defined, BLC is ignored.

.ti -4
2 TRC

These are the (pixel) coordinates of the Top Right Corner of the cleaning
box.  The default (0,0) means the top right quarter (3*Nx/4,3*Ny/4).
If a SUPPORT is defined, TRC is ignored.

.ti -4
2 MAJOR

This is the major axis (FWHP) in user coordinates of the Gaussian restoring
beam. If 0, the program will fit a Gaussian to the dirty beam. We strongly
discourage to change the default value of 0.

.ti -4
2 MINOR

This is the minor axis (FWHP) in user coordinates of the Gaussian restoring
beam. If 0, the program will fit a Gaussian to the dirty beam. We strongly
discourage to change the default value of 0.

.ti -4
2 ANGLE

This is the position angle (from North towards East, i.e. anticlockwise) of
the major axis of the Gaussian restoring beam (in degrees).  If 0, the
program will fit a Gaussian to the dirty beam. We strongly discourage to
change the default value of 0.

.ti -4
2 BEAM__PATCH

The dirty beam patch to be used for the minor cycles in CLARK and MRC
method.  It should be large enough to avoid doing too many major cycles,
but has practically no influence on the result.  This size should be
specified in pixel units.  Reasonable values are between N/8 and N/4, where
N is the number of map pixels in the same dimension.  If set to N, the
CLARK algorithm becomes identical to the HOGBOM algorithm.


