CStats:MinClipMean

CStats:MinClipMean and CStats:MinClipMeanSdev

The MinClipMean method computes the minimum-clipped mean value for a data object after rejecting the lowest value of the set.

Syntax

nMean = CStats:MinClipMean( CImage, CRect )

nMean = CStats:MinClipMean( CImage )

nMean = CStats:MinClipMean( table )

nMean, nSdev = CStats:MinClipMeanSdev( CImage, CRect )

nMean, nSdev = CStats:MinClipMeanSdev( CImage )

nMean, nSdev = CStats:MinClipMeanSdev( table )

CRect is a bounding rectangle for the CImage object.

table is a 1-dimensional array containing numbers.

On success, returns the min-clipped mean value and standard deviation.

On failure, returns 0, 0.

Remarks

The calculated statistic excludes the lowest (minimum value) pixel inside the region. Use this method to avoid a biased result when the region is known to contain one deviant, low pixel value.

Example

Suppose a CImage named I and a CRect named R exist. The following script returns the mean value inside a rectangle on the image, discarding the 1 lowest pixel value:

S = new_stats()	-- create a CStats object
-- specify CImage and CRect to measure
nVal = S:MinClipMean(I, R)	-- returns the mean value for this CImage and CRect
Printf("mean=%lg\n", nVal)	-- list the results
S:delete()	-- when done with S, remove it from memory

Syntax

Remarks

Example

Related Topics