e05ja is the AD Library version of the primal routine e05jaf. Based (in the C++ interface) on overload resolution, e05ja can be used for primal, tangent and adjoint evaluation. It supports tangents and adjoints of first order.

2 Specification

C++ Interface

#include <dco.hpp>
#include <nagad.h>
namespace nag {
namespace ad {

void e05ja (

handle_t &ad_handle, Integer &n_r, ADTYPE comm[], const Integer &lcomm, Integer &ifail)

}
}

The function is overloaded on ADTYPE which represents the type of active arguments. ADTYPE may be any of the following types:
double,
dco::ga1s<double>::type,
dco::gt1s<double>::type

Note: this function can be used with AD tools other than dco/c++. For details, please contact NAG.

3 Description

e05ja is the AD Library version of the primal routine e05jaf.

e05jaf is used to initialize communication data for the suite of multi-level coordinate search routines: e05jbf, e05jcf, e05jdf, e05jef, e05jff, e05jgf, e05jhf, e05jjf, e05jkf or e05jlf. For further information see Section 3 in the documentation for e05jaf.

4 References

5 Arguments

In addition to the arguments present in the interface of the primal routine, e05ja includes some arguments specific to AD.

A brief summary of the AD specific arguments is given below. For the remainder, links are provided to the corresponding argument from the primal routine. A tooltip popup for all arguments can be found by hovering over the argument name in Section 2 and in this section.

1: ad_handle – nag::ad::handle_t Input/Output: On entry: a configuration object that holds information on the differentiation strategy. Details on setting the AD strategy are described in AD handle object in the NAG AD Library Introduction.
2: n_r – Integer Dummy
3: comm(lcomm) – ADTYPE array Communication Array
4: lcomm – Integer Input
5: ifail – Integer Input/Output

6 Error Indicators and Warnings

e05ja preserves all error codes from e05jaf and in addition can return:

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

$ifail = - 199$: The routine was called using a strategy that has not yet been implemented.
See AD Strategies in the NAG AD Library Introduction for further information.

$ifail = - 444$: A C++ exception was thrown.
The error message will show the details of the C++ exception text.

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

7 Accuracy

Not applicable.

8 Parallelism and Performance

e05ja is not threaded in any implementation.

9 Further Comments

None.

10 Example

See Section 10 in e05jb and e05jc.

NAG Library Manual, Mark 27.3

Interfaces: FL CL CPP AD

NAG AD Library Introduction

E05 (Glopt) Chapter Contents

E05 (Glopt) Chapter Introduction (FL)

e05ja: FL CL CPP AD

when ADTYPE is	Real(kind=nag_wp)	then AD is p0w
when ADTYPE is	Type(nagad_a1w_w_rtype)	then AD is a1w
when ADTYPE is	Type(nagad_t1w_w_rtype)	then AD is t1w

NAG AD Librarye05ja (bnd_mcs_init)

▸▿ Contents

1 Purpose