% -*- texinfo -*-
% @deftypefn {Loadable Function} {[@var{fi},@var{vari}] = } optiminterp3(@var{x},@var{y},@var{z},@var{f},@var{var},@var{lenx},@var{leny},@var{lenz},@var{m},@var{xi},@var{yi},@var{zi})
% Performs a local 3D-optimal interpolation (objective analysis).
%
% Every elements in @var{f} corresponds to a data point (observation)
% at location @var{x}, @var{y}, @var{z} with the error variance var
%
% @var{lenx},@var{leny} and @var{lenz} are correlation length in x-,y- and z-direction
% respectively.
% @var{m} represents the number of influential points.
%
% @var{xi},@var{yi} and @var{zi} are the data points where the field is
% interpolated. @var{fi} is the interpolated field and @var{vari} is
% its error variance.
%
%
% The background field of the optimal interpolation is zero.
% For a different background field, the background field
% must be subtracted from the observation, the difference
% is mapped by OI onto the background grid and finally the
% background is added back to the interpolated field.
%
% The error variance of the background field is assumed to
% have a error variance of one.
% @end deftypefn