CStats:Sdev


The Sdev method computes the standard deviation of a data sample. The array and list parameters must contain a mixture of numbers and strings that can be converted to numbers.

Syntax

nSdev = CStats:Sdev( CImage, CRect )

nSdev = CStats:Sdev( CImage )

nSdev = CStats:Sdev( table )

nSdev = CStats:Sdev( n1,n2, n3, ... )

bullet.gif    CRect is a bounding rectangle for the CImage objec.

bullet.gif    table is a 1-dimensional array containing numbers.

bullet.gif    n1, n2, n3, ... are numbers or string values that can be converted to numbers.

bullet.gif    On success, returns the standard deviation.

bullet.gif    On failure, returns 0.

Example

Suppose a CImage I and a CRect R exist. The following script returns the standard deviation relative to the simple arithmetic mean value inside a rectangle on the image:

S = new_stats()

-- create a CStats object

-- specify CImage and CRect to measure

 

nSdev = S:Sdev(I, R)

-- return the standard deviation

Printf("Sdev=%lg\n", nSdev)

-- list the results

S:delete()

-- when done with S, remove it from memory

Related Topics

CStats class, SDevValue, CImage class, CRect class


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