Installation instructions

This page contains installation instructions for both Java and Python users. Note that it is not necessary to perform all steps listed below.

Java and Python users: install optimization software

The toolbox requires a (mixed-integer) linear programming solver for the execution of several algorithms. The toolbox provides a built-in LP solver which is suitable to get started without additional optimization software. For better performance it is recommended to install a separate solver. For this purpose the toolbox provides support for Gurobi and LPSolve. Below we provide an overview of the steps that need to be taken to install additional optimization software.

Built-in LP solver

For the built-in LP solver it is not required to install additional software. When starting the server it is sufficient to define 'simplex' as the LP solver. When running examples directly in the java source, it is sufficient to instantiate an LPSolverSimplex object as the LPSolver. The built-in solver does not provide support for integer programming, and therefore it is not possible to use the deterministic preallocation algorithm combined with this solver.

Gurobi

LPSolve

Java users: import Maven project in Eclipse

The toolbox comes as an Apache Maven project for Eclipse. In order to get started it is required to perform the following steps:

1. Install Eclipse and the Maven plugin (Help -> Install New Software)
2. Clone the repository in your Eclipse workspace
3. Create a new project with the same name as the directory created in step 2
4. Convert the project to a Maven project (right click on the project -> Configure -> Convert to Maven Project)
5. If you get compilation errors: make sure that the compiler compliance level has been set correctly in the project settings

Python users: starting the toolbox server

two options: jar or Server.java in eclipse

Python users: running the code

command line with python3