naginterfaces.library.ode.ivp_​stiff_​c1_​interp

naginterfaces.library.ode.ivp_stiff_c1_interp(xsol, m, comm, acor, x, nqu, hu, h)[source]

ivp_stiff_c1_interp interpolates components of the solution of a system of first-order ordinary differential equations from information provided by the integrators in submodule ode. It provides interpolation suitable for general use.

For full information please refer to the NAG Library document for d02xk

https://www.nag.com/numeric/nl/nagdoc_29.3/flhtml/d02/d02xkf.html

Parameters
xsolfloat

The point at which the first components of the solution are to be evaluated. should not be an extrapolation point, that is should satisfy . Extrapolation is permitted but not recommended.

mint

The number of components of the solution whose values at are required. The first components are evaluated.

commdict, communication object

Communication structure populated by a previous call to the integrator.

acorfloat, array-like, shape

The value returned in position , for , of the argument returned by the integrator. If one of the direct communication D02N functions is being employed and ivp_stiff_c1_interp is to be used in , must contain the value given in position of the argument , for (e.g., see ivp_stiff_exp_fulljac()).

xfloat

The latest value at which the solution has been computed, as provided in the argument on return from the optional output ivp_stiff_integ_diag().

nquint

The order of the method used up to the latest value at which the solution has been computed, as provided in the argument on return from the optional output ivp_stiff_integ_diag().

hufloat

The last successful step used, that is the step used in the integration to get to , as provided in the argument on return from the optional output ivp_stiff_integ_diag().

hfloat

The next step size to be attempted in the integration, as provided in the argument on return from the optional output ivp_stiff_integ_diag().

Returns
solfloat, ndarray, shape

The calculated value of the th component of the solution at , for .

Raises
NagValueError
(errno )

The Petzold error test was selected.

(errno )

The BDF integration method is not being used.

(errno )

On entry, and .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, and .

Constraint: .

(errno )

On entry, and .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

(errno )

On entry, .

Warns
NagAlgorithmicWarning
(errno )

Extrapolation has been performed.

Notes

No equivalent traditional C interface for this routine exists in the NAG Library.

ivp_stiff_c1_interp evaluates the first components of the solution of a system of ordinary differential equations at any point using polynomial interpolation based on information generated by the integrator. This information must be passed unchanged to ivp_stiff_c1_interp. ivp_stiff_c1_interp should not normally be used to extrapolate outside the range of values obtained from the above functions.

It may be used with the D02N functions only when the BDF integration method is being employed (setup function ivp_stiff_bdf()), provided the Petzold error test was not selected.