scipy.interpolate.SmoothBivariateSpline#

class scipy.interpolate.SmoothBivariateSpline(x, y, z, w=None, bbox=[None, None, None, None], kx=3, ky=3, s=None, eps=1e-16)[source]#

Smooth bivariate spline approximation.

Parameters:
x, y, zarray_like

1-D sequences of data points (order is not important).

warray_like, optional

Positive 1-D sequence of weights, of same length as x, y and z.

bboxarray_like, optional

Sequence of length 4 specifying the boundary of the rectangular approximation domain. By default, bbox=[min(x), max(x), min(y), max(y)].

kx, kyints, optional

Degrees of the bivariate spline. Default is 3.

sfloat, optional

Positive smoothing factor defined for estimation condition: sum((w[i]*(z[i]-s(x[i], y[i])))**2, axis=0) <= s Default s=len(w) which should be a good value if 1/w[i] is an estimate of the standard deviation of z[i].

epsfloat, optional

A threshold for determining the effective rank of an over-determined linear system of equations. eps should have a value within the open interval (0, 1), the default is 1e-16.

See also

BivariateSpline

a base class for bivariate splines.

UnivariateSpline

a smooth univariate spline to fit a given set of data points.

LSQBivariateSpline

a bivariate spline using weighted least-squares fitting

RectSphereBivariateSpline

a bivariate spline over a rectangular mesh on a sphere

SmoothSphereBivariateSpline

a smoothing bivariate spline in spherical coordinates

LSQSphereBivariateSpline

a bivariate spline in spherical coordinates using weighted least-squares fitting

RectBivariateSpline

a bivariate spline over a rectangular mesh

bisplrep

a function to find a bivariate B-spline representation of a surface

bisplev

a function to evaluate a bivariate B-spline and its derivatives

Notes

The length of x, y and z should be at least (kx+1) * (ky+1).

If the input data is such that input dimensions have incommensurate units and differ by many orders of magnitude, the interpolant may have numerical artifacts. Consider rescaling the data before interpolating.

This routine constructs spline knot vectors automatically via the FITPACK algorithm. The spline knots may be placed away from the data points. For some data sets, this routine may fail to construct an interpolating spline, even if one is requested via s=0 parameter. In such situations, it is recommended to use bisplrep / bisplev directly instead of this routine and, if needed, increase the values of nxest and nyest parameters of bisplrep.

For linear interpolation, prefer LinearNDInterpolator. See https://gist.github.com/ev-br/8544371b40f414b7eaf3fe6217209bff for discussion.

Methods

__call__(x, y[, dx, dy, grid])

Evaluate the spline or its derivatives at given positions.

ev(xi, yi[, dx, dy])

Evaluate the spline at points

get_coeffs()

Return spline coefficients.

get_knots()

Return a tuple (tx,ty) where tx,ty contain knots positions of the spline with respect to x-, y-variable, respectively.

get_residual()

Return weighted sum of squared residuals of the spline approximation: sum ((w[i]*(z[i]-s(x[i],y[i])))**2,axis=0)

integral(xa, xb, ya, yb)

Evaluate the integral of the spline over area [xa,xb] x [ya,yb].

partial_derivative(dx, dy)

Construct a new spline representing a partial derivative of this spline.