nag_glopt_bnd_mcs_init (e05jac) (PDF version)
e05 Chapter Contents
e05 Chapter Introduction
NAG C Library Manual

NAG Library Function Document

nag_glopt_bnd_mcs_init (e05jac)

+ Contents

    1  Purpose
    7  Accuracy
    9  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_rInteger
This argument is no longer accessed by nag_glopt_bnd_mcs_init (e05jac).
2:     stateNag_E05State *Communication Structure
state contains information required by other functions in this suite. You must not modify it directly in any way.
3:     failNagError *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  Further Comments

The time taken by nag_glopt_bnd_mcs_init (e05jac) is negligible.

9  Example

See Section 9 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 C Library Manual

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