int GRBaddgenconstrIndicator ( GRBmodel *model,
    const char *name,
    int binvar,
    int binval,
    int nvars,
    const int *ind,
    const double *val,
    char sense,
    double rhs )

Add a new general constraint of type GRB_GENCONSTR_INDICATOR to a model. Note that, due to our lazy update approach, the new constraint won't actually be added until you update the model (using GRBupdatemodel), optimize the model (using GRBoptimize), or write the model to disk (using GRBwrite).

An INDICATOR constraint <span>$</span>z = f \rightarrow a^Tx \leq b<span>$</span> states that if the binary indicator variable <span>$</span>z<span>$</span> is equal to <span>$</span>f<span>$</span>, where <span>$</span>f \in \{0,1\}<span>$</span>, then the linear constraint <span>$</span>a^Tx \leq b<span>$</span> should hold. On the other hand, if <span>$</span>z = 1-f<span>$</span>, the linear constraint may be violated. The sense of the linear constraint can also be specified to be “<span>$</span>=<span>$</span>” or “<span>$</span>\geq<span>$</span>”.

Note that the indicator variable <span>$</span>z<span>$</span> of a constraint will be forced to be binary, independent of how it was created.


model: The model to which the new general constraint should be added.

name: Name for the new general constraint. This argument can be NULL, in which case the constraint is given a default name.

binvar: The index of the binary indicator variable <span>$</span>z<span>$</span>.

binval: The value <span>$</span>f<span>$</span> for the binary indicator variable that would force the linear constraint to be satisfied (<span>$</span>0<span>$</span> or <span>$</span>1<span>$</span>).

nvars: The number <span>$</span>n<span>$</span> of non-zero coefficients in the linear constraint triggered by the indicator.

ind: Indices for the variables <span>$</span>x_j<span>$</span> with non-zero values in the linear constraint.

val: Numerical values for non-zero values <span>$</span>a_j<span>$</span> in the linear constraint.

sense: Sense for the linear constraint. Options are GRB_LESS_EQUAL, GRB_EQUAL, or GRB_GREATER_EQUAL.

rhs: Right-hand side value for the linear constraint.

Return value:

A non-zero return value indicates that a problem occurred while adding the general constraint. Refer to the Error Code table for a list of possible return values. Details on the error can be obtained by calling GRBgeterrormsg.

Example usage:

  /* x7 = 1 -> x1 + 2 x3 + x4 = 1 */
  int    ind[] = {1, 3, 4};
  double val[] = {1.0, 2.0, 1.0};
  error = GRBaddgenconstrIndicator(model, NULL, 7, 1,
                                   3, ind, val, GRB_EQUAL, 1.0);