V = var(A)
V = var(A,w)
V = var(A,w,dim)
V = var(___,nanflag)
A is a vector of observations,
the variance is a scalar.
A is a matrix whose columns
are random variables and whose rows are observations,
a row vector containing the variances corresponding to each column.
A is a multidimensional array,
var(A) treats the values along the first array
dimension whose size does not equal 1 as vectors. The size of this
1 while the sizes of all other
dimensions remain the same.
The variance is normalized by the number of observations
A is a scalar,
A is a
V = var( specifies
a weighting scheme. When
w = 0 (default),
normalized by the number of observations
= 1, it is normalized by the number of observations.
also be a weight vector containing nonnegative elements. In this case,
the length of
w must equal the length of the dimension
var is operating.
Create a matrix and compute its variance.
A = [4 -7 3; 1 4 -2; 10 7 9]; var(A)
ans = 1×3 21.0000 54.3333 30.3333
Create a 3-D array and compute its variance.
A(:,:,1) = [1 3; 8 4]; A(:,:,2) = [3 -4; 1 2]; var(A)
ans = ans(:,:,1) = 24.5000 0.5000 ans(:,:,2) = 2 18
Create a matrix and compute its variance according to a weight vector
A = [5 -4 6; 2 3 9; -1 1 2]; w = [0.5 0.25 0.25]; var(A,w)
ans = 1×3 6.1875 9.5000 6.1875
Create a matrix and compute its variance along the first dimension.
A = [4 -2 1; 9 5 7]; var(A,0,1)
ans = 1×3 12.5000 24.5000 18.0000
Compute the variance of
A along the second dimension.
ans = 2×1 9 4
Create a vector and compute its variance, excluding
A = [1.77 -0.005 3.98 -2.95 NaN 0.34 NaN 0.19]; V = var(A,'omitnan')
V = 5.1970
A— Input array
Input array, specified as a vector, matrix, or multidimensional array.
Complex Number Support: Yes
Weight, specified as one of:
0 — normalizes by the number
-1. If there is only one observation,
the weight is 1.
1 — normalizes by the number
a vector made up of nonnegative scalar weights corresponding
to the dimension of
A along which the variance
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 variance of the elements in each column.
dim = 2, then
a column vector containing the variance of the elements in each row.
var returns an array of zeros the same size
dim is greater than
NaN condition, specified as one of these
'includenan' — the variance
of input containing
NaN values is also
'omitnan' — all
appearing in either the input array or weight vector are ignored.
For a random variable vector A made up of N scalar observations, the variance is defined as
1. In either case, the mean is assumed to have the usual normalization factor N.
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:
dim must be a constant.
See Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder).