.. _chapCustom: Developing Customized Branch-&-Cut algorithms ============================================= This chapter discusses some features of Python-MIP that allow the development of improved Branch-&-Cut algorithms by linking application specific routines to the generic algorithm included in the solver engine. We start providing an introduction to cutting planes and cut separation routines in the next section, following with a section describing how these routines can be embedded in the Branch-&-Cut solver engine using the generic cut callbacks of Python-MIP. Cutting Planes ~~~~~~~~~~~~~~ In many applications there are `strong formulations `_ that may include an exponential number of constraints. These formulations cannot be direct handled by the MIP Solver: entering all these constraints at once is usually not practical, except for very small instances. In the `Cutting Planes `_ [Dantz54]_ method the LP relaxation is solved and only constraints which are *violated* are inserted. The model is re-optimized and at each iteration a stronger formulation is obtained until no more violated inequalities are found. The problem of discovering which are the missing violated constraints is also an optimization problem (finding *the most* violated inequality) and it is called the *Separation Problem*. As an example, consider the Traveling Salesman Problem. The compact formulation (:numref:`tsp-label`) is a *weak* formulation: dual bounds produced at the root node of the search tree are distant from the optimal solution cost and improving these bounds requires a potentially intractable number of branchings. In this case, the culprit are the sub-tour elimination constraints linking variables :math:`x` and :math:`y`. A much stronger TSP formulation can be written as follows: consider a graph :math:`G=(N,A)` where :math:`N` is the set of nodes and :math:`A` is the set of directed edges with associated traveling costs :math:`c_a \in A`. Selection of arcs is done with binary variables :math:`x_a \,\,\, \forall a \in A`. Consider also that edges arriving and leaving a node :math:`n` are indicated in :math:`A^+_n` and :math:`A^-_n`, respectively. The complete formulation follows: .. math:: \textrm{Minimize:} & \\ & \sum_{a \in A} c_a\ldotp x_a \\ \textrm{Subject to:} & \\ & \sum_{a \in A^+_n} x_a = 1 \,\,\, \forall n \in N \\ & \sum_{a \in A^-_n} x_a = 1 \,\,\, \forall n \in N \\ & \sum_{(i,j) \in A : i\in S \land j \in S} x_{(i,j)} \leq |S|-1 \,\,\, \forall \,\, S \subset I \\ & x_a \in \{0,1\} \,\,\, \forall a \in A The third constraints are sub-tour elimination constraints. Since these constraints are stated for *every subset* of nodes, the number of these constraints is :math:`O(2^{|N|})`. These are the constraints that will be separated by our cutting pane algorithm. As an example, consider the following graph: .. image:: ./images/tspG.* :width: 60% :align: center The optimal LP relaxation of the previous formulation without the sub-tour elimination constraints has cost 237: .. image:: ./images/tspRoot.* :width: 60% :align: center As it can be seen, there are tree disconnected sub-tours. Two of these include only two nodes. Forbidding sub-tours of size 2 is quite easy: in this case we only need to include the additional constraints: :math:`x_{(d,e)}+x_{(e,d)}\leq 1` and :math:`x_{(c,f)}+x_{(f,c)}\leq 1`. Optimizing with these two additional constraints the objective value increases to 244 and the following new solution is generated: .. image:: ./images/tspNo2Sub.* :width: 60% :align: center Now there are sub-tours of size 3 and 4. Let's consider the sub-tour defined by nodes :math:`S=\{a,b,g\}`. The valid inequality for :math:`S` is: :math:`x_{(a,g)} + x_{(g,a)} + x_{(a,b)} + x_{(b,a)} + x_{(b,g)} + x_{(g,b)} \leq 2`. Adding this cut to our model increases the objective value to 261, a significant improvement. In our example, the visual identification of the isolated subset is easy, but how to automatically identify these subsets efficiently in the general case ? Isolated subsets can be identified when a *cut* is found in the graph defined by arcs active in the unfeasible solution. To identify the most isolated subsets we just have to solve the `Minimum cut problem in graphs `_. In python you can use the `networkx min-cut module `_. The following code implements a cutting plane algorithm for the asymmetric traveling salesman problem: .. literalinclude:: ../examples/cutting_planes.py :caption: A pure cutting-planes approach for the Traveling Salesman Problem (examples/cutting_planes.py) :linenos: :lines: 3-49 Lines 6-13 are the input data. Nodes are labeled with letters in a list :code:`N` and a dictionary :code:`A` is used to store the weighted directed graph. Lines 14 and 15 store output and input arcs per node. The mapping of binary variables :math:`x_a` to arcs is made also using a dictionary in line 18. Line 20 sets the objective function and the following tree lines include constraints enforcing one entering and one leaving arc to be selected for each node. Line 29 will only solve the LP relaxation and the separation routine can be executed. Our separation routine is executed for each pair or nodes at line 38 and whenever a disconnected subset is found the violated inequality is generated and included at line 40. The process repeats while new violated inequalities are generated. Python-MIP also supports the automatic generation of cutting planes, i.e., cutting planes that can be generated for any model just considering integrality constraints. Line 43 triggers the generation of these cutting planes with the method :meth:`~mip.Model.generate_cuts` when our sub-tour elimination procedure does not finds violated sub-tour elimination inequalities anymore. .. _cut-generation-label: Cut Callback ~~~~~~~~~~~~ The cutting plane method has some limitations: even though the first rounds of cuts improve significantly the lower bound, the overall number of iterations needed to obtain the optimal integer solution may be too large. Better results can be obtained with the `Branch-&-Cut algorithm `_, where cut generation is *combined* with branching. If you have an algorithm like the one included in the previous Section to separate inequalities for your application you can combine it with the complete BC algorithm implemented in the solver engine using *callbacks*. Cut generation callbacks (CGC) are called at each node of the search tree where a fractional solution is found. Cuts are generated in the callback and returned to the MIP solver engine which adds these cuts to the *Cut Pool*. These cuts are merged with the cuts generated with the solver builtin cut generators and a *subset* of these cuts is included to the LP relaxation model. Please note that in the Branch-&-Cut algorithm context cuts are *optional* components and only those that are classified as *good* cuts by the solver engine will be accepted, i.e., cuts that are too dense and/or have a small violation could be discarded, since the cost of solving a much larger linear program may not be worth the resulting bound improvement. When using cut callbacks be sure that cuts are used only to *improve* the LP relaxation but not to *define* feasible solutions, which need to be defined by the initial formulation. In other words, the initial model without cuts may be *weak* but needs to be *complete* [#f1]_. In the case of TSP, we can include the weak sub-tour elimination constraints presented in :numref:`tsp-label` in the initial model and then add the stronger sub-tour elimination constraints presented in the previous section as cuts. In Python-MIP, CGC are implemented extending the :class:`~mip.ConstrsGenerator` class. The following example implements the previous cut separation algorithm as a :class:`~mip.ConstrsGenerator` class and includes it as a cut generator for the branch-and-cut solver engine. The method that needs to be implemented in this class is the :meth:`~mip.ConstrsGenerator.generate_constrs` procedure. This method receives as parameter the object :code:`model` of type :class:`~mip.Model`. This object must be used to query the fractional values of the model :attr:`~mip.Model.vars`, using the :attr:`~mip.Var.x` property. Other model properties can be queried, such as the problem constraints (:attr:`~mip.Model.constrs`). Please note that, depending on which solver engine you use, some variables/constraints from the original model may have been removed in the pre-processing phase. Thus, direct references to the original problem variables may be invalid. The method :meth:`~mip.Model.translate` (line 15) translates references of variables from the original model to references of variables in the model received in the callback procedure. Whenever a violated inequality is discovered, it can be added to the model using the :code:`+=` operator (line 31). In our example, we temporarily store the generated cuts in a :class:`~mip.CutPool` object (line 25) to discard repeated cuts that eventually are found. .. literalinclude:: ../examples/tsp-cuts.py :caption: Branch-and-cut for the traveling salesman problem (examples/tsp-cuts.py) :linenos: :lines: 8-95 .. _lazy-constraints-label: Lazy Constraints ~~~~~~~~~~~~~~~~ Python-MIP also supports the use of constraint generators to produce *lazy constraints*. Lazy constraints are dynamically generated, just as cutting planes, with the difference that lazy constraints are also applied to *integer solutions*. They should be used when the initial formulation is *incomplete*. In the case of our previous TSP example, this approach allow us to use in the initial formulation only the degree constraints and add all required sub-tour elimination constraints on demand. Auxiliary variables :math:`y` would also not be necessary. The lazy constraints TSP example is exactly as the cut generator callback example with the difference that, besides starting with a smaller formulation, we have to inform that the constraint generator will be used to generate lazy constraints using the model property :attr:`~mip.Model.lazy_constrs_generator`. .. code-block:: python ... model.cuts_generator = SubTourCutGenerator(F, x, V) model.lazy_constrs_generator = SubTourCutGenerator(F, x, V) model.optimize() ... .. _mipstart-label: Providing initial feasible solutions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The Branch-&-Cut algorithm usually executes faster with the availability of an integer feasible solution: an upper bound for the solution cost improves its ability of pruning branches in the search tree and this solution is also used in local search MIP heuristics. MIP solvers employ several heuristics for the automatically production of these solutions but they do not always succeed. If you have some problem specific heuristic which can produce an initial feasible solution for your application then you can inform this solution to the MIP solver using the :attr:`~mip.Model.start` model property. Let's consider our TSP application (:numref:`tsp-label`). If the graph is complete, i.e. distances are available for each pair of cities, then *any* permutation :math:`\Pi=(\pi_1,\ldots,\pi_n)` of the cities :math:`N` can be used as an initial feasible solution. This solution has exactly :math:`|N|` :math:`x` variables equal to one indicating the selected arcs: :math:`((\pi_1,\pi_2), (\pi_2,\pi_3), \ldots, (\pi_{n-1},\pi_{n}), (\pi_{n},\pi_{1}))`. Even though this solution is obvious for the modeler, which knows that binary variables of this model refer to arcs in a TSP graph, this solution is not obvious for the MIP solver, which only sees variables and a constraint matrix. The following example enters an initial random permutation of cities as initial feasible solution for our TSP example, considering an instance with :code:`n` cities, and a model :code:`model` with references to variables stored in a matrix :code:`x[0,...,n-1][0,..,n-1]`: .. code-block:: python :linenos: from random import shuffle S=[i for i in range(n)] shuffle(S) model.start = [(x[S[k-1]][S[k]], 1.0) for k in range(n)] The previous example can be integrated in our TSP example (:numref:`tsp-label`) by inserting these lines before the :code:`model.optimize()` call. Initial feasible solutions are informed in a list (line 4) of :code:`(var, value)` pairs. Please note that only the original non-zero problem variables need to be informed, i.e., the solver will automatically compute the values of the auxiliary :math:`y` variables which are used only to eliminate sub-tours. .. rubric:: Footnotes .. [#f1] If you want to initally enter an incomplete formulation than see the next sub-section on Lazy-Constraints.