The Control Vector

Functions
int	COI_Create (coiHandle_t *cntvect)
	initializes CONOPT and creates the control vector.
int	COI_Free (coiHandle_t *cntvect)
	frees the control vector.
void	COI_Finalize (void)
	finializes the solving process for CONOPT. This must be called when using OpenMP. It will terminate the running processes cleanly.

Detailed Description

The Control Vector is the main communication region between the modeler and CONOPT.

The initialisation of the control vector is preformed by calling COI_Create(). This will create a vector that is of the appropriate size for the control vector. The memory allocated for the control vector is freed with a call to COI_Free().

Note

You can work simultaneously with multiple models by using one control vector for each model, or you can use one control vector for a sequence of models.

Function Documentation

COI_Create()

int COI_Create

(

coiHandle_t *

cntvect

)

initializes CONOPT and creates the control vector.

This method calls an initialization step for the Control Vector that places default values in the various positions. In addition, the initialization will set the parameters associated with the base and array indices, i.e. starting at 1 for Fortran and 0 for C.

If you have multiple models with multiple Control Vectors then you must call this method for each control vector. If you solve a sequence of different models then you can use the same Control Vector provided you don't need to reinitialize it. If the control vector must be reinitialized, then it is necessary to call COI_Free() followed by COI_Create() between the solves.

Parameters

cntvect

the control vector

COI_Free()

int COI_Free

(

coiHandle_t *

cntvect

)

frees the control vector.

Parameters

cntvect

the control vector

COI_Finalize()

void COI_Finalize

(

void

)

finializes the solving process for CONOPT. This must be called when using OpenMP. It will terminate the running processes cleanly.