Procedure GMP::Row::Generate(GMP, row, autoAddColumn)

GMP::Row::Generate

The procedure GMP::Row::Generate generates a row and adds it to the matrix of a generated mathematical program. The row is generated according to the definition of its associated symbolic constraint, or to the definition of its associated symbolic variable in case the row refers to the definition of a variable.

GMP::Row::Generate(
     GMP,            ! (input) a generated mathematical program
     row,            ! (input) a scalar reference
     [autoAddColumn] ! (optional) a binary scalar
     )

Arguments

GMP

An element in AllGeneratedMathematicalPrograms.

row

A scalar reference to a row.

autoAddColumn

A binary scalar indicating whether this procedure should automatically add columns that are not in the GMP. The default is 0 meaning that no columns are added.

Return Value

The procedure returns 1 on success, or 0 otherwise.

Note

  • Use GMP::Row::GenerateMulti if many rows corresponding to some constraint have to be generated, because that will be more efficient.

  • Before generating the row all existing matrix coefficients for this row are removed.

  • The row type and the right-hand-side value (and, if the row type is 'ranged', the left-hand-side value) are set according to the constraint definition.

  • This procedure cannot be used if the row contains the objective variable, and the row was added or generated before using a different coefficient for the objective variable.

  • If the value of autoAddColumn equals 0, then this procedure will generate an error if it encounters a column that is not in the GMP. You then have to add that column before calling this procedure by using the procedure GMP::Column::Add.

  • Setting the value of autoAddColumn to 1 should only be done if you know exactly which columns are automatically added by this procedure. Otherwise you might end up with a model in which some columns only appear in this row, possibly making this row redundant.

  • This procedure will never add columns that were deleted before with the procedure GMP::Column::Delete.

Example

To generate the row corresponding to constraint c(i) for element '1', we can use:

GMP::Row::Generate( myGMP, c('1') );

If the row refers to the definition of a variable then we have to place ‘_definition’ behind the name of the variable. For example, if v(j) is a variable with a definition and we want to generate a row according to its definition for element '2' then we have to use:

GMP::Row::Generate( myGMP, v_definition('2') );

See also

The routines GMP::Instance::Generate, GMP::Column::Add, GMP::Column::Delete, GMP::Row::Add, GMP::Row::Delete and GMP::Row::GenerateMulti.