|
sdev (replaces TSdev)
The sdev function returns the standard
deviation of a 1-dimensional array,
CImage
, or list of numbers. The parameters must contain
numbers or strings that can be converted to numbers. This function
is similar to the
CStat:Sdev method but does not require calling
new_stats() beforehand to create a
CStats object.
Whereas this function operates on a pure (indexed)
array, the slightly slower
sdevn function operates on a general table that may
be a multi-dimensional array or contain a mixture of numbers,
strings, named keys, and sub-tables.
The related
sdevxn function computes the standard deviation about
a specified value for a general table.
Syntax
nStdDev = sdev( Data )
Data is a
1-dimensional array, list of numbers, or a
CImage object.
n1,
n2, n3, ... are numbers or string values
that can be converted to numbers.
nStdDev is the
standard deviation of the values.
Remarks
Except for the
CImage class, the members of Data are interpreted as numbers with
pixel type "double". The
CImage class supports values ranging from
byte to double plus other pixel types.
Examples
The following script returns the standard deviation
of a table containing 1 million random numbers.
|
t = random( 1000000 )
|
|
|
sd = sdev( t )
|
|
|
Printf("Sdev= %lg\n", sd )
|
|
The next script returns the standard deviation for
pixels inside a rectangle at the corner of a
CImage.
|
V = AttachView( "CImageView"
)
|
|
|
Assert( V and V:Count() > 0
)
|
|
|
R = new_rect( 1, 20, 1, 40
)
|
|
|
sd = sdev( V:GetImage(), R
)
|
|
|
Printf("Sdev= %lg\n", sd )
|
|
The next example computes the standard deviation of
a list of numbers:
|
s = sdev( 5, 6, -2, 5.4 }
|
|
|
Printf("SDev = %lg\n",
m )
|
|
Related Topics
Table and Array Functions
mean
sdevn
sdevxn
CImageView Class
Mira Pro x64 Script User's Guide, v.8.76 Copyright Ⓒ 2024
Mirametrics, Inc. All Rights Reserved.
|