linmsg_n

Linearly interpolates to fill in missing values, given the dimension to do the interpolation across.

Prototype

	function linmsg_n (
		x       : numeric,  
		opt     : integer,  
		dim [1] : integer   
	)

	return_val [dimsizes(x)] :  float or double

Arguments

An array of any dimensionality. Missing values should be indicated by x@_FillValue. If x@_FillValue is not set, then the NCL default appropriate to the type of x will be assumed. The dim-th dimension is the dimension upon which the linear interpolation will be performed.

A scalar or an array with two elements. The scalar or the first element of the array specifies how missing beginning and end points will be returned. If this value is greater than or equal to 0, then the beginning and end points will be returned as missing (most common option). If this value is less than 0, then they will be set to the nearest non-missing value.

If opt has two elements, then the second value specifies the maximum number of consecutive missing values to be interpolated. If opt is a scalar then the routine will try to interpolate as many values as it can.

A scalar integer indicating which dimension of x to do the interpolation across. Dimension numbering starts at 0.

Description

linmsg_n uses piecewise linear interpolation to fill in any missing values, given the dimension to interpolate across. End points which are missing on input may be returned as missing or set to the nearest non-missing value.

See Also

linmsg, linint1_n, linint2

Examples

Example 1

This example returns the interpolated values to the original one-dimensional array. (The default missing value for the input type will be used if no missing value is attached to the input array). The end points will be left as missing. Because the opt argument is a scalar, the routine will interpolate across all missing values:

begin

; Note: in Version 6.0.0, default missing will be 9.96921e+36, not -999.
  x = (/ 1190.,1455.,1550.,-999.,1745.,1770., \
         1900.,-999.,-999.,-999.,2335.,2490., \
         2720.,2710.,2530.,2900.,2760.,-999. /)

  x = linmsg_n(x,0,0)   ; endPoint= 0 missing end point(s) unaltered

end

After interpolation, x contains:

     (/ 1190.,1455.  ,1550. ,1647.5 ,1745.,1770., \
        1900.,2008.75,2117.5,2226.25,2335.,2490., \
        2720.,2710.  ,2530. ,2900.  ,2760.,-999. /)

Example 2

This example returns the interpolated values to a new 1D array. The missing value has been specified by the user. The end points with missing values will be set to the nearest non-missing value. Because the opt argument is a scalar, the routine will interpolate across all missing values:

begin

 ymsg = 1.e10
 y = (/ 1115.,ymsg ,1515.,1794.,ymsg ,1710., \
        1830.,1920.,1970.,2300.,2280.,2520., \
        2630.,ymsg ,ymsg ,2800.,ymsg ,ymsg  /)
 y@_FillValue = ymsg

 ynew = linmsg_n(y,-1,0)  ; endPoint= -1 missing end point(s)
                        ;              set to nearest non-missing value
end

After interpolation ynew contains:

     (/ 1115.,1315.,1515.,1795.,1752.,1710., \
        1830.,1920.,1970.,2300.,2280.,2520., \
        2630.,2686.67 ,2743.33 ,2800.,2800.,2800. /)

Example 3

Assume x is a 4-dimensional array with named dimensions "time", "lev", "lat", "lon", and sizes ntim x klev nlat x mlon. Assume that at random times all data are missing and x@_FillValue has been set to the missing value. Linearly interpolate in time to fill in the values.

Make opt a two element array. The first element is set to 0 so that missing values at the beginning and end will be returned as missing. The second element is set to 5 meaning that the routine will not interpolate segments of the series where more than 5 consecutive values are encountered:

 opt = (/0, 5/)

 x = linmsg_n(x, opt,0) ; y(ntim,klev,nlat,mlon)