e01aaf (dim1_aitken) : NAG Library, Mark 27

2 Specification

Fortran Interface

Subroutine e01aaf (

Integer, Intent (In)	::	n1, n2, n
Real (Kind=nag_wp), Intent (In)	::	x
Real (Kind=nag_wp), Intent (Inout)	::	a(n+1), b(n+1)
Real (Kind=nag_wp), Intent (Out)	::	c(n*(n+1)/2)

C Header Interface

#include <nag.h>

void	e01aaf_ (double a[], double b[], double c[], const Integer n1, const Integer n2, const Integer n, const double x)

The routine may be called by the names e01aaf or nagf_interp_dim1_aitken.

e01aaf interpolates a function of one variable at a given point

x

from a table of values

x_{i}

and

y_{i}

, for

i = 1, 2, \dots, n + 1

using Aitken's method (see Fröberg (1970)). The intermediate values of linear interpolations are stored to enable an estimate of the accuracy of the results to be made.

5 Arguments

a (n + 1)

– Real (Kind=nag_wp) array Input/Output

On entry:

a (i)

must contain the

x

-component of the

i

th data point,

x_{i}

, for

i = 1, 2, \dots, n + 1

On exit:

a (i)

contains the value

x_{i} - x

, for

i = 1, 2, \dots, n + 1

b (n + 1)

– Real (Kind=nag_wp) array Input/Output

On entry:

b (i)

must contain the

y

-component (function value) of the

i

th data point,

y_{i}

, for

i = 1, 2, \dots, n + 1

On exit: the contents of b are unspecified.

c (n \times (n + 1) / 2)

– Real (Kind=nag_wp) array Output

On exit:

$c (1), \dots, c (n)$ contain the first set of linear interpolations,
$c (n + 1), \dots, c (2 \times n - 1)$ contain the second set of linear interpolations,
$c (2 n), \dots, c (3 \times n - 3)$ contain the third set of linear interpolations,
$⋮$
$c (n \times (n + 1) / 2)$ contains the interpolated function value at the point $x$ .

n1

– Integer Input

n2

– Integer Input

On entry: n1 and n2 are no longer referenced, but are included for backwards compatability.

n

– Integer Input

On entry: the number of intervals which are to be used in interpolating the value at

x

; that is, there are

n + 1

data points

(x_{i}, y_{i})

Constraint:

n > 0

x

– Real (Kind=nag_wp) Input

On entry: the point

x

at which the interpolation is required. Note that x may lie outside the interval defined by the minimum and maximum values in a, in which case an extrapolated value will be computed; extrapolated results should be treated with considerable caution since there is no information on the behaviour of the function outside the defined interval.

7 Accuracy

An estimate of the accuracy of the result can be made from a comparison of the final result and the previous interpolates, given in the array c. In particular, the first interpolate in the

i

th set, for

i = 1, 2, \dots, n

, is the value at

x

of the polynomial interpolating the first

(i + 1)

data points. It is given in position

(i - 1) (2 n - i + 2) / 2

of the array c. Ideally, providing

n

is large enough, this set of

n

interpolates should exhibit convergence to the final value, the difference between one interpolate and the next settling down to a roughly constant magnitude (but with varying sign). This magnitude indicates the size of the error (any subsequent increase meaning that the value of

n

is too high). Better convergence will be obtained if the data points are supplied, not in their natural order, but ordered so that the first

i

data points give good coverage of the neighbourhood of

x

, for all

i

. To this end, the following ordering is recommended as widely suitable: first the point nearest to

x

, then the nearest point on the opposite side of

x

, followed by the remaining points in increasing order of their distance from

x

, that is of

| x_{r} - x |

. With this modification the Aitken method will generally perform better than the related method of Neville, which is often given in the literature as superior to that of Aitken.

NAG FL Interface
e01aaf (dim1_aitken)

▸▿ Contents

1 Purpose

2 Specification

3 Description

4 References

5 Arguments

6 Error Indicators and Warnings

7 Accuracy

8 Parallelism and Performance

9 Further Comments

10 Example

10.1 Program Text

10.2 Program Data

10.3 Program Results

NAG FL Interfacee01aaf (dim1_​aitken)

▸▿ Contents

1 Purpose

2 Specification

3 Description

4 References

5 Arguments

6 Error Indicators and Warnings

7 Accuracy

8 Parallelism and Performance

9 Further Comments

10 Example

10.1 Program Text

10.2 Program Data

10.3 Program Results

NAG FL Interface
e01aaf (dim1_aitken)