ContentsIndexHome
PreviousUpNext
IAimmsMathProgramInfo::GetColumnData Method

Get columns information.

virtual _LONG_T GetColumnData(
    _LONG_T is_update, 
    _LONG_T max_no, 
    _LONG_T col_no[], 
    double lb[], 
    double lev[], 
    double ub[], 
    double obj_coeff[], 
    double prior[], 
    _LONG_T no_elm[], 
    _LONG_T no_q_elm[], 
    _LONG_T type_flag[]
) = 0;
Parameters 
Description 
_LONG_T is_update 
An integer indicator for full (value 0) or update (value 1) retrieval. 
_LONG_T max_no 
The maximum number of columns to retrieve. 
_LONG_T col_no[] 
In case of a full retrieval the size of this array must be at least 1 and on output col_no[0] will contain the number of the first column that is retrieved. In case of an update retrieval the array col_no contains the column numbers of the updated columns. In the latter case the length of col_no must be at least max_no
double lb[] 
Array with the lower bounds of the columns. Length must be at least max_no. This argument may be NULL. 
double lev[] 
Array with the level values of the columns. Length must be at least max_no. This argument may be NULL. 
double ub[] 
Array with the upper bounds of the columns. Length must be at least max_no. This argument may be NULL. 
double obj_coeff[] 
Array with the objective coefficients of the columns. Length must be at least max_no. This argument may be NULL. 
double prior[] 
Array with the priorities for integer programming of the columns. Length must be at least max_no. This argument may be NULL. 
_LONG_T no_elm[] 
Array with the number of non-zero elements of the columns, excluding bounds and objective. Length must be at least max_no. This argument may be NULL. 
_LONG_T no_q_elm[] 
Array with the number of non-zero elements in the quadratic matrix for the columns. Length must be at least max_no. This argument may be NULL. 
_LONG_T type_flag[] 
Array of bit fields that specify column properties; flags are taken from the ColumnRowFlag enumeration. Length must be at least max_no. This argument may be NULL. 

The GetColumnData method returns the actual number of columns retrieved.

The GetColumnData method is used to get information about the columns from AIMMS. This method can be used for either a full or an update retrieval, and in both cases you can retrieve all data in one call or retrieve it block-wise in consecutive calls.

  1. If max_no is greater than or equal to the total number of (updated) columns in the problem, you get all column data using a single call to this method.
  2. If max_no is smaller than the total number of columns then you request for a block-wise retrieval, and you must call GetColumnData repeatedly, until all (updated) columns are retrieved.
  3. In case of a full retrieval, a consecutive number of columns is retrieved, starting from the column number that is returned in col_no[0]. Thus, the retrieved column numbers are col_no[0], col_no[0] + 1, col_no[0] + 2, etc.
  4. In case of a partial retrieval, the retrieved column numbers are given explicitly in the array col_no. Thus the retrieved column numbers are col_no[0], col_no[1], col_no[2], etc.
  5. The values in the other output arrays match with these retrieved column numbers. For example, in full retrieve mode lb[5] is the lower bound for column number col_no[0] + 5; in partial retrieve mode lb[5] is the lower bound for column number col_no[5].
  6. If you pass a NULL value for one of the output arrays, except col_no, then the corresponding data will not be retrieved.

The SetMatrixOrder method.

Copyright © 1993–2016 by AIMMS B.V. All rights reserved.