d01pa_ad_f : NAG AD Library Routine Document, Mark 26

Fortran Interface

Subroutine d01pa_a1w_f (

ad_handle, ndim, vert, ldvert, sdvert, functn, minord, maxord, finvls, esterr, iuser, ruser, ifail)

Integer, Intent (In)	::	ndim, ldvert, sdvert, maxord
Integer, Intent (Inout)	::	minord, iuser(*), ifail
External	::	functn
Type (nagad_a1w_w_rtype), Intent (Inout)	::	vert(ldvert,sdvert), finvls(maxord), ruser(*)
Type (nagad_a1w_w_rtype), Intent (Out)	::	esterr
Type (c_ptr), Intent (In)	::	ad_handle

Subroutine functn (

ad_handle, ndim, x, ret, iuser, ruser)

Integer, Intent (In)	::	ndim
Integer, Intent (Inout)	::	iuser(*)
Type (nagad_a1w_w_rtype), Intent (Inout)	::	x(ndim), ruser(*)
Type (nagad_a1w_w_rtype), Intent (Out)	::	ret
Type (c_ptr), Intent (In)	::	ad_handle

C++ Header Interface

#include <nagad.h>

void d01pa_a1w_f_ (

void *&ad_handle, const Integer &ndim, nagad_a1w_w_rtype vert[], const Integer &ldvert, const Integer &sdvert,
void (NAG_CALL functn)(void *&ad_handle, const Integer &ndim, nagad_a1w_w_rtype x[], nagad_a1w_w_rtype &ret, Integer iuser[], nagad_a1w_w_rtype ruser[]),
Integer &minord, const Integer &maxord, nagad_a1w_w_rtype finvls[], nagad_a1w_w_rtype &esterr, Integer iuser[], nagad_a1w_w_rtype ruser[], Integer &ifail)

Description

d01paf returns a sequence of approximations to the integral of a function over a multidimensional simplex, together with an error estimate for the last approximation. For further information see Section 3 in the documentation for d01paf .

References

Arguments

d01pa_a1w_f provides access to all the arguments available in the primal routine. There are also additional arguments specific to AD. A tooltip popup for each argument can be found by hovering over the argument name in Section 2 and a summary of the arguments are provided below:

ad_handle – a handle to the AD configuration data object, as created by x10aa_a1w_f.
ndim – $n$ , the number of dimensions of the integral.
vert – on entry: $vert (i, j)$ must be set to the $j$ th component of the $i$ th vertex for the simplex integration region, for $j = 1, 2, \dots, n$ , for $i = 1, 2, \dots, n + 1$ . on exit: these values are unchanged.
ldvert – the first dimension of the array vert.
sdvert – the second dimension of the array vert.
functn – functn must return the value of the integrand $f$ at a given point.
minord – on entry: must specify the highest order of the approximations currently available in the array finvls. on exit: $minord = maxord$ .
maxord – the highest order of approximation to the integral to be computed.
finvls – on entry: if $minord > 0$ , $finvls (1), finvls (2), \dots, finvls (minord)$ must contain approximations to the integral previously computed by routine. on exit: contains these values unchanged, and the newly computed values $finvls (minord + 1), finvls (minord + 2), \dots, finvls (maxord)$ .
esterr – on exit: an absolute error estimate for $finvls (maxord)$ .
iuser – may be used to pass information to user-supplied argument(s).
ruser – may be used to pass information to user-supplied argument(s).
ifail – on entry: ifail must be set to $0$ , $- 1 or 1$ . on exit: ifail = 0 unless the routine detects an error or a warning has been flagged (see Section 6).

Error Indicators and Warnings

d01pa_a1w_f preserves all error codes from d01paf and in addition can return:

$ifail = - 89$: An unexpected AD error has been triggered by this routine. Please contact NAG.
See Section 5.2 in the NAG AD Library Introduction for further information.

$ifail = - 899$: Dynamic memory allocation failed for AD.
See Section 5.1 in the NAG AD Library Introduction for further information.

Language	Source File	Data	Results
Fortan	d01pa_a1w_fe.f90	None	d01pa_a1w_fe.r
C++	d01pa_a1w_hcppe.cpp	None	d01pa_a1w_hcppe.r

NAG AD Library Routine Document

d01pa_a1w_f (md_simplex_a1w)

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

NAG AD Library Routine Document

d01pa_a1w_f (md_simplex_a1w)

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