B3spline

Purpose

Univariate spline fit and prediction.

Synopsis

modl = b3spline(x,y,t,options);

pred = b3spline(x,modl,options);

valid = b3spline(x,y,modl,options);

Description

Curve fitting using second order splines where yi = f(xi) for i=1,...,M. See (options.algorithm) for more information.

INPUTS

• x = Mx1 vector of independent variable values.
• y = Mx1 vector of corresponding dependendent variable values.
• t = defines the number of knots or knot positions.
• '= 1x1 scalar integer defining the number of uniformly distributed INTERIOR knots. There will be t+2 knots positioned at:
• modl.t = linspace(min(x),max(x),t+2)';
• '= Kx1 vector defining manually placed knot positions,
• where modl.t = sort(t);
• Note that knot positions need not be uniform, and that t(1) can be <min(x) and t(K) can be >max(x).

Note that knot positions must be such that there are at least 3 unique data points between each knot:  tk,tk+1 for k=1,...,K.

OUTPUTS

• modl = standard model structure containing the spline model (See MODELSTRUCT).
• pred = structure array with predictions.
• valid = structure array with predictions.

Options

• options = a structure array with the following fields:
• display: [ {'on'} | 'off' ] level of display to command window.
• plots: [ {'final'} | 'none' ] governs level of plotting. If 'final' and calibrating a model, the plot shows plot(xi,yi) and plot(xi,f(xi),'-') with knots.
• algorithm: [ {'b3spline'} | 'b3_0' | 'b3_01' ] fitting algorithm

'b3spline': fits quadradic polynomials f{k,k+1} to the data between knots tk, k=1,...,K, subject to:

 f{k,k+1}(tk+1)  = f{k+1,k+2}(tk+1) and
 f'{k,k+1}(tk+1) = f'{k+1,k+2}(tk+1) for k=1,...,K-1.

'b3_0': is the same as 'b3spline' but also constrains the ends to 0: f{1,2}(t1) = 0 and f{K-1,K}(tK) = 0. 'b3_01': is 'b3_0' but also constrains the derivatives at the ends to 0: f'{1,2}(t1) = 0 and f'{K-1,K}(tK) = 0.

• order: positive integer for polynomial order {default = 1}.

The default options can be retreived using: options = baseline('options');.