naginterfaces.library.ode.ivp_stiff_bandjac_setup¶
- naginterfaces.library.ode.ivp_stiff_bandjac_setup(neq, neqmax, jceval, ml, mu, nwkjac, njcpvt, comm)[source]¶
ivp_stiff_bandjac_setup
is a setup function which you must call prior to an integrator in submoduleode
, if banded matrix linear algebra is required.For full information please refer to the NAG Library document for d02nt
https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/d02/d02ntf.html
- Parameters
- neqint
The number of differential equations.
- neqmaxint
A bound on the maximum number of differential equations to be solved during the integration.
- jcevalstr, length 1
Specifies the technique to be used to compute the Jacobian as follows:
The Jacobian is to be evaluated numerically by the integrator. If this option is used, the actual argument corresponding to in the call to
ivp_stiff_exp_bandjac()
orivp_stiff_imp_bandjac()
must be specified as None.You must supply a (sub)program to evaluate the Jacobian on a call to the integrator.
The default choice is to be made. In this case ‘D’ is interpreted as ‘N’.
Only the first character of the actual argument is passed to
ivp_stiff_bandjac_setup
; hence it is permissible for the actual argument to be more descriptive, e.g., ‘Numerical’, ‘Analytical’ or ‘Default’, on a call toivp_stiff_bandjac_setup
.- mlint
, the number of subdiagonals in the band.
- muint
, the number of superdiagonals in the band.
- nwkjacint
The size of the workspace array , which you are supplying to the integrator, as declared in the (sub)program from which
ivp_stiff_bandjac_setup
is called.- njcpvtint
The size of the workspace array , which you are supplying to the integrator, as declared in the (sub)program from which
ivp_stiff_bandjac_setup
is called.- commdict, communication object, modified in place
Communication structure.
This argument must have been initialized by a prior call to
ivp_stiff_bdf()
orivp_stiff_blend()
.
- Raises
- NagValueError
- (errno )
On entry, .
Constraint: , or .
- (errno )
On entry, and .
Constraint: .
- (errno )
On entry, .
Constraint: .
- (errno )
On entry, and .
Constraint: .
- (errno )
On entry, .
Constraint: .
- (errno )
On entry, , , and .
Constraint: .
- (errno )
On entry, and .
Constraint: .
- (errno )
On entry, and .
Constraint: .
- (errno )
On entry, .
Constraint: .
- (errno )
On entry, .
Constraint: .
- Notes
No equivalent traditional C interface for this routine exists in the NAG Library.
ivp_stiff_bandjac_setup
defines the linear algebra to be used as banded matrix linear algebra, permits you to specify the method for calculating the Jacobian and checks the validity of certain input values.