CImCombine:MaxClip

CImCombine:MaxClip

The MaxClip method merges the pixel values after clipping the maximum value 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 single highest value at each location. This is equivalent to the AlphaClip method with nHigh=1 and nLow=0. 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 MaxClip 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:MaxClip( 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