20.7.13 THRESHOLD

[ADVANCED\]MASK THRESHOLD Value Unit [GUARD Guard] [SMOOTH Smooth Length] [REGIONS Nregion]

Define a Mask from thresholding the CLEAN image. If the CLEAN image is 3-D, the Mask will be 3-D.

The method involves a first thresholding, optionally followed by a smoothing and a second thresholding to extend the support. The mask is the logical OR of the Raw and Smooth masks.

The algorithm to define the mask is controlled by 5 parameters, 4 of which are optional and specified as values after their corresponding keyword. The arguments Value Unit
indicate the threshold and its unit under which the mask is set to 0. The unit can be %, SIGMA, NOISE, Jy, milliJy, microJy, K, milliK, microK, or NATIVE.

Value is not just a simple number: its interpretation depends on whether it has an explicit sigma (+ or -), in which case only values above of below are retained, of no sign at all, in which case comparisons are made on the absolute values.

The default is 6 sigma. The noise is taken from the computed Clean noise (clean%gil%rms) if defined, or from the theoretical noise (clean or dirty%gil%noise) if not.

SMOOTH Smooth Length Smooth
indicates the threshold under which the Smooth Mask is set to 0 after smoothing. There is no default. If keyword SMOOTH is not present, there is no smooth mask. This smoothed threshold is in the same units as the main one. Length
is the size of the smoothing gaussian to derive the smooth mask from the initial mask (in arcsec). If set to *, or not specified, it takes the default which is the Clean beam major axis.

GUARD Guard Guard
indicates the size of the guard band at edges where the mask is set to zero, in units of image size. The default is 0.18, i.e. the mask can extends a little more than the inner quarter. This is to avoid the edges where sidelobes aliasing occurs.

REGIONS Regions Regions
is the maximum number of separate regions retained in the mask. The regions are ordered by decreasing size, and only the first Regions ones are kept. Default is 0, which means keep all regions.