S = std(A)
S = std(A,w)
S = std(A,w,dim)
S = std(___,nanflag)
A is a vector of observations,
then the standard deviation is a scalar.
A is a matrix whose columns
are random variables and whose rows are observations, then
a row vector containing the standard deviations corresponding to each
A is a multidimensional array,
std(A) operates along the first array dimension
whose size does not equal 1, treating the elements as vectors. The
size of this dimension becomes
1 while the sizes
of all other dimensions remain the same.
By default, the standard deviation is normalized by
N is the number of observations.
S = std( specifies
a weighting scheme for any of the previous syntaxes. When
= 0 (default),
S is normalized by
w = 1,
S is normalized
by the number of observations,
can be a weight vector containing nonnegative elements. In this case,
the length of
w must equal the length of the dimension
std is operating.
Create a matrix and compute the standard deviation of each column.
A = [4 -5 1; 2 3 5; -9 1 7]; S = std(A)
S = 1×3 7.0000 4.1633 3.0551
Create a 3-D array and compute the standard deviation along the first dimension.
A(:,:,1) = [2 4; -2 1]; A(:,:,2) = [9 13; -5 7]; A(:,:,3) = [4 4; 8 -3]; S = std(A)
S = S(:,:,1) = 2.8284 2.1213 S(:,:,2) = 9.8995 4.2426 S(:,:,3) = 2.8284 4.9497
Create a matrix and compute the standard deviation of each column according to a weight vector
A = [1 5; 3 7; -9 2]; w = [1 1 0.5]; S = std(A,w)
S = 1×2 4.4900 1.8330
Create a matrix and calculate the standard deviation along each row.
A = [6 4 23 -3; 9 -10 4 11; 2 8 -5 1]; S = std(A,0,2)
S = 3×1 11.0303 9.4692 5.3229
Create a vector and compute its standard deviation, excluding
A = [1.77 -0.005 3.98 -2.95 NaN 0.34 NaN 0.19]; S = std(A,'omitnan')
S = 2.2797
A— Input array
Input array, specified as a vector, matrix, or multidimensional
A is a scalar, then
A is a
Complex Number Support: Yes
Weight, specified as one of these values:
0 — Normalize by
N is the number of observations. If there
is only one observation, then the weight is 1.
1 — Normalize by
Vector made up of nonnegative scalar weights corresponding
to the dimension of
A along which the standard
deviation is calculated.
dim— Dimension to operate along
Dimension to operate along, specified as a positive integer scalar. If no value is specified, then the default is the first array dimension whose size does not equal 1.
dim indicates the dimension whose
length reduces to
while the sizes of all other dimensions remain the same.
Consider a two-dimensional input array,
dim = 1, then
a row vector containing the standard deviation of the elements in
dim = 2, then
a column vector containing the standard deviation of the elements
in each row.
dim is greater than
std(A) returns an array of zeros the same
NaN condition, specified as one of these
'includenan' — Include
when computing the standard deviation, resulting in
'omitnan' — Ignore
appearing in either the input array or weight vector.
datetime arrays, you can also use
omit and include
NaT values, respectively.
For a random variable vector A made up of N scalar observations, the standard deviation is defined as
This function supports tall arrays with the limitation:
The weighting scheme cannot be a vector.
For more information, see Tall Arrays.
Usage notes and limitations:
If you specify
dim, then it must
be a constant.
See Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder).