PHP Class MathPHP\NumericalAnalysis\Interpolation\ClampedCubicSpline

In numerical analysis, cubic splines are used for polynomial interpolation. A cubic spline is a spline constructed of piecewise third-order polynomials which pass through a set of m control points." In the case of the Clamped cubic spline, the first derivative of piecewise polynomial is set to equal the first derivative of our input at the endpoints. Cubic spline interpolation belongs to a collection of techniques that interpolate a function or a set of values, producing a continuous polynomial. In the case of the cubic spline, a piecewise function (polynomial) is produced. We can either directly supply a set of inputs and their corresponding outputs for said function, or if we explicitly know the function, we can define it as a callback function and then generate a set of points by evaluating that function at n points between a start and end point. We then use these values to interpolate our piecewise polynomial. https://en.wikipedia.org/wiki/Spline_interpolation http://mathworld.wolfram.com/CubicSpline.html
Inheritance: extends Interpolation
Mostra file Open project: markrogoyski/math-php Class Usage Examples

Public Methods

Method Description
getSplinePoints ( $source, array $args = [] ) : array Determine where the input $source argument is a callback function, a set of arrays, or neither. If $source is a callback function, run it through the functionToPoints() method with the input $args, and set $points to output array. If $source is a set of arrays, simply set $points to $source. If $source is neither, throw an Exception.
interpolate ( $source, $args ) : Piecewise Interpolate
validateSpline ( array $points, number $degree = 2 ) : boolean Validate that there are enough input arrays (points), that each point array has precisely three numbers, and that no two points share the same first number (x-component)

Protected Methods

Method Description
functionToSplinePoints ( callable $function, callable $derivative, number $start, number $end, number $n ) : array Evaluate our callback function and derivative at n evenly spaced points on the interval between start and end

Method Details

functionToSplinePoints() protected static method

Evaluate our callback function and derivative at n evenly spaced points on the interval between start and end
protected static functionToSplinePoints ( callable $function, callable $derivative, number $start, number $end, number $n ) : array
$function callable f(x) callback function
$derivative callable f'(x) callback function
$start number the start of the interval
$end number the end of the interval
$n number the number of function evaluations
return array

getSplinePoints() public static method

Determine where the input $source argument is a callback function, a set of arrays, or neither. If $source is a callback function, run it through the functionToPoints() method with the input $args, and set $points to output array. If $source is a set of arrays, simply set $points to $source. If $source is neither, throw an Exception.
public static getSplinePoints ( $source, array $args = [] ) : array
$source The source of our approximation. Should be either a callback function or a set of arrays.
$args array The arguments of our callback function: derivative, start, end, and n. Example: [$derivative, 0, 8, 5]. If $source is a set of arrays, $args will default to [].
return array

interpolate() public static method

Interpolate
public static interpolate ( $source, $args ) : Piecewise
$source The source of our approximation. Should be either a callback function or a set of arrays. Each array (point) contains precisely three numbers: x, y, and y' Example array: [[1,2,1], [2,3,0], [3,4,2]]. Example callback: function($x) {return $x**2;}
return MathPHP\Functions\Piecewise The interpolting (piecewise) polynomial, as an instance of Piecewise.

validateSpline() public static method

Validate that there are enough input arrays (points), that each point array has precisely three numbers, and that no two points share the same first number (x-component)
public static validateSpline ( array $points, number $degree = 2 ) : boolean
$points array Array of arrays (points)
$degree number The miminum number of input arrays
return boolean