Class FieldPolynomialSplineFunction<T extends CalculusFieldElement<T>>

  • Type Parameters:
    T - the type of the field elements
    All Implemented Interfaces:
    CalculusFieldUnivariateFunction<T>

    public class FieldPolynomialSplineFunction<T extends CalculusFieldElement<T>>
    extends Object
    implements CalculusFieldUnivariateFunction<T>
    Represents a polynomial spline function.

    A polynomial spline function consists of a set of interpolating polynomials and an ascending array of domain knot points, determining the intervals over which the spline function is defined by the constituent polynomials. The polynomials are assumed to have been computed to match the values of another function at the knot points. The value consistency constraints are not currently enforced by PolynomialSplineFunction itself, but are assumed to hold among the polynomials and knot points passed to the constructor.

    N.B.: The polynomials in the polynomials property must be centered on the knot points to compute the spline function values. See below.

    The domain of the polynomial spline function is [smallest knot, largest knot]. Attempts to evaluate the function at values outside of this range generate IllegalArgumentExceptions.

    The value of the polynomial spline function for an argument x is computed as follows:

    1. The knot array is searched to find the segment to which x belongs. If x is less than the smallest knot point or greater than the largest one, an IllegalArgumentException is thrown.
    2. Let j be the index of the largest knot point that is less than or equal to x. The value returned is polynomials[j](x - knot[j])
    Since:
    1.5
    • Method Detail

      • getField

        public Field<T> getField()
        Get the Field to which the instance belongs.
        Returns:
        Field to which the instance belongs
      • value

        public T value​(double v)
        Compute the value for the function. See FieldPolynomialSplineFunction for details on the algorithm for computing the value of the function.
        Parameters:
        v - Point for which the function value should be computed.
        Returns:
        the value.
        Throws:
        MathIllegalArgumentException - if v is outside of the domain of the spline function (smaller than the smallest knot point or larger than the largest knot point).
      • getN

        public int getN()
        Get the number of spline segments. It is also the number of polynomials and the number of knot points - 1.
        Returns:
        the number of spline segments.
      • getPolynomials

        public FieldPolynomialFunction<T>[] getPolynomials()
        Get a copy of the interpolating polynomials array. It returns a fresh copy of the array. Changes made to the copy will not affect the polynomials property.
        Returns:
        the interpolating polynomials.
      • getKnots

        public T[] getKnots()
        Get an array copy of the knot points. It returns a fresh copy of the array. Changes made to the copy will not affect the knots property.
        Returns:
        the knot points.
      • isValidPoint

        public boolean isValidPoint​(T x)
        Indicates whether a point is within the interpolation range.
        Parameters:
        x - Point.
        Returns:
        true if x is a valid point.
      • polynomialSplineDerivative

        public FieldPolynomialSplineFunction<T> polynomialSplineDerivative()
        Get the derivative of the polynomial spline function.
        Returns:
        the derivative function.