Try our new documentation site (beta).


int GRBaddgenconstrIndicator ( GRBmodel *model,
    const char *name,
    int binvar,
    int binval,
    int nvars,
    int* ind,
    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 \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; independently 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.

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

int 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>).

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

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

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

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

double 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);

Try Gurobi for Free

Choose the evaluation license that fits you best, and start working with our Expert Team for technical guidance and support.

Evaluation License
Get a free, full-featured license of the Gurobi Optimizer to experience the performance, support, benchmarking and tuning services we provide as part of our product offering.
Academic License
Gurobi supports the teaching and use of optimization within academic institutions. We offer free, full-featured copies of Gurobi for use in class, and for research.
Cloud Trial

Request free trial hours, so you can see how quickly and easily a model can be solved on the cloud.