NAG C Library Function Document

nag_opt_nlp_revcomm_init (e04wbc)

1

Purpose

2

Specification

3

Description

4

References

5

Arguments

1:    $\mathbf{rname}$ – const char *Input

On entry: the name of the function to be initialized.

Constraint: rname must be called with $\mathbf{rname}='\mathrm{e04ufc}'$.

2:    $\mathbf{cwsav}\left[\mathbf{lcwsav}\times 80\right]$ – char Communication Array

3:    $\mathbf{lcwsav}$ – IntegerInput

On entry: the dimension of the array cwsav.

Constraint: $\mathbf{lcwsav}\ge 5$.

4:    $\mathbf{lwsav}\left[\mathbf{llwsav}\right]$ – Nag_BooleanCommunication Array

5:    $\mathbf{llwsav}$ – IntegerInput

On entry: the dimension of the array lwsav.

Constraint: $\mathbf{llwsav}\ge 120$.

6:    $\mathbf{iwsav}\left[\mathbf{liwsav}\right]$ – IntegerCommunication Array

7:    $\mathbf{liwsav}$ – IntegerInput

On entry: the dimension of the array iwsav.

Constraint: $\mathbf{liwsav}\ge 610$.

8:    $\mathbf{rwsav}\left[\mathbf{lrwsav}\right]$ – doubleCommunication Array

9:    $\mathbf{lrwsav}$ – IntegerInput

On entry: the dimension of the array rwsav.

Constraint: $\mathbf{lrwsav}\ge 475$.

10:  $\mathbf{fail}$ – NagError *Input/Output

The NAG error argument (see Section 3.7 in How to Use the NAG Library and its Documentation).

6

Error Indicators and Warnings

NE_ALLOC_FAIL

Dynamic memory allocation failed.

NE_BAD_PARAM

On entry, argument value had an illegal value.

NE_CHARACTER

On entry, $\mathbf{rname}=〈\mathit{\text{value}}〉$.
Constraint: rname must be called with $\mathbf{rname}='\mathrm{e04ufc}'$.

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.

NE_TOO_SMALL

One or more of the save array lengths is too small. Supplied values are: $\mathbf{lcwsav}=〈\mathit{\text{value}}〉$, $\mathbf{llwsav}=〈\mathit{\text{value}}〉$, $\mathbf{liwsav}=〈\mathit{\text{value}}〉$ and $\mathbf{lrwsav}=〈\mathit{\text{value}}〉$.

7

Accuracy

8

Parallelism and Performance

9

Further Comments

10

Example