e01raf : NAG Library, Mark 26

e01raf produces, from a set of function values and corresponding abscissae, the coefficients of an interpolating rational function expressed in continued fraction form.

Fortran Interface

Subroutine e01raf (

n, x, f, m, a, u, iw, ifail)

Integer, Intent (In)	::	n
Integer, Intent (Inout)	::	ifail
Integer, Intent (Out)	::	m, iw(n)
Real (Kind=nag_wp), Intent (In)	::	x(n), f(n)
Real (Kind=nag_wp), Intent (Out)	::	a(n), u(n)

C Header Interface

#include nagmk26.h

void	e01raf_ ( const Integer n, const double x[], const double f[], Integer m, double a[], double u[], Integer iw[], Integer *ifail)

e01raf produces the parameters of a rational function

R (x)

which assumes prescribed values

f_{i}

at prescribed values

x_{i}

of the independent variable

x

, for

i = 1, 2, \dots, n

. More specifically, e01raf determines the parameters

a_{j}

, for

j = 1, 2, \dots, m

and

u_{j}

, for

j = 1, 2, \dots, m - 1

, in the continued fraction

R (x) = a_{1} + R_{m} (x)

(1)

where

R_{i} (x) = \frac{a_{m - i + 2} (x - u_{m - i + 1})}{1 + R_{i - 1} (x)},   for ​ i = m, m - 1, \dots, 2,

and

R_{1} (x) = 0,

such that

R (x_{i}) = f_{i}

, for

i = 1, 2, \dots, n

. The value of

m

in (1) is determined by the routine; normally

m = n

. The values of

u_{j}

form a reordered subset of the values of

x_{i}

and their ordering is designed to ensure that a representation of the form (1) is determined whenever one exists.

The subsequent evaluation of (1) for given values of

x

can be carried out using e01rbf.

The computational method employed in e01raf is the modification of the Thacher–Tukey algorithm described in Graves–Morris and Hopkins (1981).

Graves–Morris P R and Hopkins T R (1981) Reliable rational interpolation Numer. Math. 36 111–128

On entry:

n

, the number of data points.

Constraint:

n > 0

On entry:

x (i)

must be set to the value of the

i

th data abscissa,

x_{i}

, for

i = 1, 2, \dots, n

Constraint: the

x (i)

must be distinct.

On entry:

f (i)

must be set to the value of the data ordinate,

f_{i}

, corresponding to

x_{i}

, for

i = 1, 2, \dots, n

On exit:

m

, the number of terms in the continued fraction representation of

R (x)

On exit:

a (j)

contains the value of the parameter

a_{j}

R (x)

, for

j = 1, 2, \dots, m

. The remaining elements of a, if any, are set to zero.

On exit:

u (j)

contains the value of the parameter

u_{j}

R (x)

, for

j = 1, 2, \dots, m - 1

. The

u_{j}

are a permuted subset of the elements of x. The remaining

n - m + 1

locations contain a permutation of the remaining

x_{i}

, which can be ignored.

On entry: ifail must be set to

0

- 1 ​ or ​ 1

. If you are unfamiliar with this argument you should refer to Section 3.4 in How to Use the NAG Library and its Documentation for details.

For environments where it might be inappropriate to halt program execution when an error is detected, the value

- 1 ​ or ​ 1

is recommended. If the output of error messages is undesirable, then the value

1

is recommended. Otherwise, if you are not familiar with this argument, the recommended value is

0

. When the value $- 1 or 1$ is used it is essential to test the value of ifail on exit.

On exit:

ifail = 0

unless the routine detects an error or a warning has been flagged (see Section 6).

If on entry

ifail = 0

- 1

, explanatory error messages are output on the current error message unit (as defined by x04aaf).

Errors or warnings detected by the routine:

At least one pair of the values

x (i)

are equal (or so nearly so that a subsequent division will inevitably cause overflow).

A continued fraction of the required form does not exist.

An unexpected error has been triggered by this routine. Please contact NAG.

See Section 3.9 in How to Use the NAG Library and its Documentation for further information.

Your licence key may have expired or may not have been installed correctly.

See Section 3.8 in How to Use the NAG Library and its Documentation for further information.

Dynamic memory allocation failed.

See Section 3.7 in How to Use the NAG Library and its Documentation for further information.

Usually, it is not the accuracy of the coefficients produced by this routine which is of prime interest, but rather the accuracy of the value of

R (x)

that is produced by the associated routine e01rbf when subsequently it evaluates the continued fraction (1) for a given value of

x

. This final accuracy will depend mainly on the nature of the interpolation being performed. If interpolation of a ‘well-behaved smooth’ function is attempted (and provided the data adequately represents the function), high accuracy will normally ensue, but, if the function is not so ‘smooth’ or extrapolation is being attempted, high accuracy is much less likely. Indeed, in extreme cases, results can be highly inaccurate.

There is no built-in test of accuracy but several courses are open to you to prevent the production or the acceptance of inaccurate results.

1.	If the origin of a variable is well outside the range of its data values, the origin should be shifted to correct this; and, if the new data values are still excessively large or small, scaling to make the largest value of the order of unity is recommended. Thus, normalization to the range $- 1.0$ to $+ 1.0$ is ideal. This applies particularly to the independent variable; for the dependent variable, the removal of leading figures which are common to all the data values will usually suffice.
2.	To check the effect of rounding errors engendered in the routines themselves, e01raf should be re-entered with $x_{1}$ interchanged with $x_{i}$ and $f_{1}$ with $f_{i}$ , $(i \neq 1)$ . This will produce a completely different vector $a$ and a reordered vector $u$ , but any change in the value of $R (x)$ subsequently produced by e01rbf will be due solely to rounding error.
3.	Even if the data consist of calculated values of a formal mathematical function, it is only in exceptional circumstances that bounds for the interpolation error (the difference between the true value of the function underlying the data and the value which would be produced by the two routines if exact arithmetic were used) can be derived that are sufficiently precise to be of practical use. Consequently, you are recommended to rely on comparison checks: if extra data points are available, the calculation may be repeated with one or more data pairs added or exchanged, or alternatively, one of the original data pairs may be omitted. If the algorithms are being used for extrapolation, the calculations should be performed repeatedly with the $2, 3, \dots$ nearest points until, hopefully, successive values of $R (x)$ for the given $x$ agree to the required accuracy.

e01raf is not threaded in any implementation.

The time taken by e01raf is approximately proportional to

n^{2}

The continued fraction (1) when expanded produces a rational function in

x

, the degree of whose numerator is either equal to or exceeds by unity that of the denominator. Only if this rather special form of interpolatory rational function is needed explicitly, would this routine be used without subsequent entry (or entries) to e01rbf.

This example reads in the abscissae and ordinates of

5

data points and prints the arguments

a_{j}

and

u_{j}

of a rational function which interpolates them.

NAG Library Routine Document

e01raf (dim1_ratnl)

▸▿ 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 Library Routine Document

e01raf (dim1_ratnl)

▸▿ 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

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