nag_glopt_bnd_mcs_init (e05jac) (PDF version)

e05 Chapter Contents

e05 Chapter Introduction

NAG Library Manual

NAG Library Function Document

nag_glopt_bnd_mcs_init (e05jac)

+− 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

1 Purpose

nag_glopt_bnd_mcs_init (e05jac) is used to initialize communication data for the suite of multi-level coordinate search functions: nag_glopt_bnd_mcs_solve (e05jbc), nag_glopt_bnd_mcs_optset_file (e05jcc), nag_glopt_bnd_mcs_optset_string (e05jdc), nag_glopt_bnd_mcs_optset_char (e05jec), nag_glopt_bnd_mcs_optset_int (e05jfc), nag_glopt_bnd_mcs_optset_real (e05jgc), nag_glopt_bnd_mcs_option_check (e05jhc), nag_glopt_bnd_mcs_optget_int (e05jkc) and nag_glopt_bnd_mcs_optget_real (e05jlc).

2 Specification

#include <nag.h>

#include <nage05.h>

void	nag_glopt_bnd_mcs_init (Integer n_r, Nag_E05State state, NagError fail)

3 Description

nag_glopt_bnd_mcs_init (e05jac) initializes the structure state for the solver nag_glopt_bnd_mcs_solve (e05jbc) and the optional-argument handlers nag_glopt_bnd_mcs_optset_file (e05jcc), nag_glopt_bnd_mcs_optset_string (e05jdc), nag_glopt_bnd_mcs_optset_char (e05jec), nag_glopt_bnd_mcs_optset_int (e05jfc), nag_glopt_bnd_mcs_optset_real (e05jgc), nag_glopt_bnd_mcs_option_check (e05jhc), nag_glopt_bnd_mcs_optget_int (e05jkc) and nag_glopt_bnd_mcs_optget_real (e05jlc).

4 References

None.

5 Arguments

1: n_r – Integer: This argument is no longer accessed by nag_glopt_bnd_mcs_init (e05jac).
2: state – Nag_E05State *Communication Structure: state contains information required by other functions in this suite. You must not modify it directly in any way.
3: fail – NagError *Input/Output: The NAG error argument (see Section 3.6 in the Essential Introduction).

6 Error Indicators and Warnings

NE_ALLOC_FAIL: Dynamic memory allocation failed.
NE_BAD_PARAM: On entry, argument $⟨value⟩$ had an illegal value.
NE_INTERNAL_ERROR: An internal error has occurred in this function. Check the function call and any array sizes. If the call is correct then please contact NAG for assistance.

7 Accuracy

Not applicable.

8 Parallelism and Performance

Not applicable.

9 Further Comments

The time taken by nag_glopt_bnd_mcs_init (e05jac) is negligible.

10 Example

See Section 10 in nag_glopt_bnd_mcs_solve (e05jbc) and nag_glopt_bnd_mcs_optset_file (e05jcc).

nag_glopt_bnd_mcs_init (e05jac) (PDF version)

e05 Chapter Contents

e05 Chapter Introduction

NAG Library Manual

© The Numerical Algorithms Group Ltd, Oxford, UK. 2014