naginterfaces.library.interp.dim2_​spline_​grid

naginterfaces.library.interp.dim2_spline_grid(x, y, f)

dim2_spline_grid computes a bicubic spline interpolating surface through a set of data values, given on a rectangular grid in the $x$-$y$ plane.

For full information please refer to the NAG Library document for e01da

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/e01/e01daf.html

Parameters

xfloat, array-like, shape $\left(\text{mx}\right)$

$x[\text{q}-1]$ and $y[\text{r}-1]$ must contain $x_{\text{q}}$, for $\text{q}=1,2,\dots ,m_x$, and $y_{\text{r}}$, for $\text{r}=1,2,\dots ,m_y$, respectively.

yfloat, array-like, shape $\left(\text{my}\right)$

$x[\text{q}-1]$ and $y[\text{r}-1]$ must contain $x_{\text{q}}$, for $\text{q}=1,2,\dots ,m_x$, and $y_{\text{r}}$, for $\text{r}=1,2,\dots ,m_y$, respectively.

ffloat, array-like, shape $(\text{mx}\times \text{my})$

$f[m_y\times (\text{q}-1)+\text{r}-1]$ must contain $f_{\text{q},\text{r}}$, for $\text{r}=1,2,\dots ,m_y$, for $\text{q}=1,2,\dots ,m_x$.

Returns

pxint

$px$ and $py$ contain $m_x+4$ and $m_y+4$, the total number of knots of the computed spline with respect to the $x$ and $y$ variables, respectively.

pyint

$px$ and $py$ contain $m_x+4$ and $m_y+4$, the total number of knots of the computed spline with respect to the $x$ and $y$ variables, respectively.

lamdafloat, ndarray, shape $(\text{mx}+4)$

$lamda$ contains the complete set of knots ${\lambda }_i$ associated with the $x$ variable

mufloat, ndarray, shape $(\text{my}+4)$

$mu$ contains the complete set of knots ${\mu }_i$ associated with the $y$ variable

cfloat, ndarray, shape $(\text{mx}\times \text{my})$

The coefficients of the spline interpolant. $c[m_y\times (i-1)+j-1]$ contains the coefficient $c_{ij}$ described in Notes.

Raises

NagValueError

(errno $1$)

On entry, $\text{my}=⟨value⟩$.

Constraint: $\text{my}\ge 4$.

(errno $1$)

On entry, $\text{mx}=⟨value⟩$.

Constraint: $\text{mx}\ge 4$.

(errno $2$)

On entry, the $x$ or the $y$ mesh points are not in strictly ascending order.

(errno $3$)

An intermediate set of linear equations is singular – the data is too ill-conditioned to compute $B$-spline coefficients.

Notes

In the NAG Library the traditional C interface for this routine uses a different algorithmic base. Please contact NAG if you have any questions about compatibility.

dim2_spline_grid determines a bicubic spline interpolant to the set of data points $(x_{\text{q}},y_{\text{r}},f_{\text{q},\text{r}})$, for $\text{r}=1,2,\dots ,m_y$, for $\text{q}=1,2,\dots ,m_x$. The spline is given in the B-spline representation

$$s(x,y)=\sum _{i=1}^{m_x}\sum _{j=1}^{m_y}{c}_{ij}{M}_i\left(x\right)N_j\left(y\right)\text{,}$$

such that

$$s(x_q,y_r)=f_{q,r}\text{,}$$

where $M_i\left(x\right)$ and $N_j\left(y\right)$ denote normalized cubic B-splines, the former defined on the knots ${\lambda }_i$ to ${\lambda }_{i+4}$ and the latter on the knots ${\mu }_j$ to ${\mu }_{j+4}$, and the $c_{ij}$ are the spline coefficients. These knots, as well as the coefficients, are determined by the function, which is derived from the function B2IRE in Anthony et al. (1982). The method used is described in Further Comments.

For further information on splines, see Hayes and Halliday (1974) for bicubic splines and de Boor (1972) for normalized B-splines.

Values and derivatives of the computed spline can subsequently be computed by calling fit.dim2_spline_evalv, fit.dim2_spline_evalm or fit.dim2_spline_derivm as described in Evaluation of Computed Spline.

References

Anthony, G T, Cox, M G and Hayes, J G, 1982, DASL – Data Approximation Subroutine Library, National Physical Laboratory

Cox, M G, 1975, An algorithm for spline interpolation, J. Inst. Math. Appl. (15), 95–108

de Boor, C, 1972, On calculating with B-splines, J. Approx. Theory (6), 50–62

Hayes, J G and Halliday, J, 1974, The least squares fitting of cubic spline surfaces to general data sets, J. Inst. Math. Appl. (14), 89–103