diverseBB usage

README.md

What do you need?

• IBM ILOG CPLEX (See section below on how to install CPLEX). The code works with CPLEX 12.2, but any later version should be fine.
• MPI C++ compiler.

CPLEX

The process of downloading/installing CPLEX is a bit cumbersome, you have to get an account at IBM's academic initiative in order to get the software. Follow these steps:

Download software

• Go to the IBM academic initiative site and create and account (click "Join now" at the right).
• Once you have completed this, go back to the home page of the site and go to "Get software & access".
• Search for "CPLEX". Download the proper version correspoding to your platform.

Note about license: Starting in May 2012, IBM ILOG CPLEX does not require a license key.

Install

• You'll get an script called something like cplex_studio124.macos.bin. Make it executable and run it to install CPLEX. Keep track of the path where CPLEX is installed. Let's call this path CPLEX_PATH. If you don't use root accesss to run the script it should install it in your account.
• You can run the interactive version of CPLEX by executing the file cplex located in CPLEX_PATH/cplex/bin/x86-64_darwin9_gcc4.0/ (for example).

Compiling the code

In makefile:

• Modify the variable CPLEX_PATH.
• Modify CC.
• Make!

Running the code

• Instances are available at https://bitbucket.org/rocarvaj/mcfplib.
• Create a folder named DATA in the same path where the executable file is.
• Run mpirun -np 1 ./diverseBB (no arguments) to get information about the parameters required by the code.