CImCombine:SdevClip

The SdevClip method creates an image who's pixel values are the clipped standard deviation at each point of a CImageSet. At each pixel location, the images with the nHigh highest pixel values and nLow lowest pixel values are rejected from the sample before computing the standard deviation for the output image. For the SdevClip method to work properly, the images must be normalized; this can be done by the combining process..

Syntax

CImage = CImCombine:SdevClip( CImageSet, nHigh, nLow )

bullet.gif    CImageSet contains the collection of images to be combined.

bullet.gif    nHigh is the number of high pixel values to clip.

bullet.gif    nLow is the number of low pixel values to clip.

bullet.gif    CImage is a new image created by this method.

bullet.gif    On success, this method returns a new CImage.

bullet.gif    On failure, this method returns nil.

Example

Suppose a CImageSet named S exists. The following script combines the images by the SdevClip method by excluding the 4 highest and 1 lowest pixel values at each point. This statistic is computed after normalizing their luminance by the median statistic computed inside the central 10% of the image:

C = new_imcombine()

-- create a CImCombine object

R = new_rect(10,50,10,50)

-- central 10% of the image

C:SetRelRect( R )

-- specify CImage and CRect to measure

C:SetNormStat("median")

-- use the median as the normalization statistic

C:SetNormMethod("scale")

-- scale to normalize the image set

I = C:SdevClip( S, 40, 10 )

-- 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

Related Topics

CImCombine class

CImageSet class

CImage class

CRect class

Sdev

AlphaClip


Mira Pro x64 Script User's Guide, v.8.80 Copyright Ⓒ 2025 Mirametrics, Inc. All Rights Reserved.