dim_variance

For each index of dimensions 0..n-2, this function computes the variance of the n-1 dimension.

Synopsis

	function dim_variance(
		x : numeric
	)

Arguments

x
An array of one or more numeric values of any dimensionality

Description

The dim_variance function computes the variance of all elements of the n-1 dimension for each index of the dimensions 0..n-2. dim_variance ignores missing values (x@_FillValue). The output dimensionality is the same as the first n-2 dimensions of the input. To determine the number of data points used to calculate the standard deviation use: 
   N = num(.not.ismissing(x))

Example

The following is a simplistic example that demonstrates how dim_variance works. Try running this example and print out the values to get a better idea of how dim_variance works. 
 begin ; ; Create example array ;
        a = onedtond(ispan(1,150,1),(/3,5,10/))
;
;       Assign dimension names
;
        a!0 = "time"
        a!1 = "latitude"
        a!2 = "longitude"
;
;       Compute variance of dimension "longitude" at all time and latitude points
;
        pxy = dim_variance(a)
        N = num(.not.ismissing(a))   ; compute number of values used in calculation
;
;       Compute variance of dimension "time" at all points latitude and longitude points
;       The following uses Named Subscripting to reorder the input array
;       such that time is the n-1 dimension.
;
        pyz = dim_variance( a(latitude | :, longitude | : , time | :) )

end

Reference Manual Control Panel

NG4.1 Home, Index, Examples, Glossary, Feedback, Ref Contents, Ref WhereAmI?

$Revision: 1.7 $ $Date: 1999/03/15 16:59:48 $