IAimmsMathProgramMatrixManipulationInfo::GetNextChangedMatrixElements Method

Get modified matrix coefficients.

virtual _LONG_T GetNextChangedMatrixElements(
    _LONG_T max_no, 
    _LONG_T row_no[], 
    _LONG_T col_no[], 
    double val[]
) = 0;

Parameters

Parameters	Description
_LONG_T max_no	The maximum number of matrix elements to retrieve. If the value is less than 0 then minus the maximum number of objective elements to retrieve.
_LONG_T row_no[]	Array with the row numbers of the matrix elements. Length must be at least max_no.
_LONG_T col_no[]	Array with the column numbers of the matrix elements. Length must be at least max_no.
double val[]	Array with the values of the matrix coefficients. Length must be at least max_no.

Returns

The GetNextChangedMatrixElements method returns the actual number of matrix elements retrieved.

Description

The GetNextChangedMatrixElements method is used to get matrix elements from AIMMS that were changed after a solve using GMP modifications. This method should only be called if the capability flag SolverCapability::CAPAB_MATRIX_MANIP has been set in the GetInitialInfo method.

Remarks

The number of changed matrix elements is equal to the value of parameter IntegerMathProgramInfo::IPARAM_MM_CHG_E, as passed to the DoSolve method.
If max_no is greater than or equal to the number of changed matrix elements in the problem, you get all column data using a single call to this method.
If max_no is smaller than the number of changed matrix elements then you request for a block-wise retrieval, and you must call GetNextChangedMatrixElements repeatedly, until all changed matrix elements are retrieved.

Group

IAimmsMathProgramMatrixManipulationInfo Methods

Links

IAimmsMathProgramMatrixManipulationInfo Class, IAimmsMathProgramMatrixManipulationInfo Members, IAimmsMathProgramMatrixManipulationInfo Methods

Contents | Index | Home