# 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

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