CImCombine:MmClip

CImCombine:MmClip

The MmClip method merges the pixel values after clipping the maximum and minimum values from the distribution at each point.

Syntax

CImage = CImCombine:MmClip( CImageSet )

CImageSet contains the collection of images to be combined.
CImage is a new image created by this method.
On success, this method returns a new CImage.
On failure, this method returns nil.

Remarks

Each pixel in the output image is the mean value of all images after rejection of the 1 highest and 1 lowest values at each location. This is equivalent to the AlphaClip method with nHigh=1 and nLow=1. To work properly, the images must be normalized as part of the combining.

Example

Suppose a CImageSet named S exists. The following script fragment combines the images by the MmClip method. The images are normalized by the Median statistic computed inside the central 10% of the image:

C = CImCombine:new()	-- create a CImCombine object
R = CRect:new(10,50,10,50)	-- central 10% of the image
C:SetRelRect( R )	-- specify CImage and CRect to measure
C:SetNormStat("median")	-- use the MmClip as the normalization statistic
C:SetNormMethod("scale")	-- scale to normalize the image set
I = C:MmClip( S )	-- combine the image set and return a new image
I:Display()	-- show the new image
C:delete()	-- when done with S, remove it from memory