Discrete Optimization is a python library to ease the definition and re-use of discrete optimization problems and solvers. It has been initially developed in the frame of scikit-decide for scheduling. The code base starting to be big, the repository has now been splitted in two separate ones.

The library contains a range of existing solvers already implemented such as:

• greedy methods
• local search (Hill Climber, Simulated Annealing)
• metaheuristics (Genetic Algorithms, NSGA)
• linear programming
• constraint programming
• hybrid methods (LNS)

The library also contains implementation of several classic discrete optimization problems:

• Travelling Salesman Problem (TSP)
• Knapsack Problem (KP)
• Vehicle Routing Problem (VRP)
• Facility Location Problem (FLP)
• Resource Constrained Project Scheduling Problem (RCPSP). Several variants of RCPSP are available
• Graph Colouring Problem (GCP)

In addition, the library contains functionalities to enable robust optimization through different scenario handling mechanisms) and multi-objective optimization (aggregation of objectives, Pareto optimization, MO post-processing).

Quick version:

pip install discrete-optimization

For more details, see the online documentation.

The latest documentation is available online.

Some educational notebooks are available in notebooks/ folder. Links to launch them online with binder are provided in the Notebooks section of the online documentation.

More examples can be found as Python scripts in the examples/ folder, using the different features of the library and showing how to instantiate different problem instances and solvers.

See more about how to contribute in the online documentation.

This software is under the MIT License that can be found in the LICENSE file at the root of the repository.

Some minzinc models have been adapted from files coming from

• https://github.com/MiniZinc/minizinc-benchmarks under the same license,
• https://github.com/youngkd/MSPSP-InstLib for which we have the written authorization of the author.