Skip to main content Link Menu Expand (external link) Document Search Copy Copied


Table of contents

  1. Getting started
    1. Installing CPLEX 12.6.3
  2. Patient data files
  3. Linking OpenKPD to CPLEX

Getting started

OpenKPD requires only two dependencies to run: Java and CPLEX. Any 64-bit installation of Java (JRE or JDK) will work with OpenKPD. OpenKPD also requires CPLEX Optimization Studio 12.6.3. CPLEX can be downloaded for free through the IBM Academic Initiative. Below we show how to do this.

Installing CPLEX 12.6.3

Use the part number CRW5CML to install CPLEX 12.6.3 through the academic initiative program.

Patient data files

OpenKPD requires two data files to function: pairs.csv and alts.csv. These files contain lists of synthetic patient data that was generated using real UNOS patient data. To protect patient privacy, we request that you email

  • Naveen (ndurvasula [at] berkeley [dot] edu) and/or
  • John (johnd [at] umd [dot] edu) and/or
  • Aravind (asriniv1 [at] umd [dot] edu)

for these files

Linking OpenKPD to CPLEX

In the same folder as OpenKPD.jar, locate the file config.txt. Besides facilitating customizations to the matching policy, this file is used to link CPLEX to OpenKPD. This can be done by modifying the key variable CPLEX_PATH. The variable should point to the directory of the CPLEX executable. For OSX users, this directory will look like /Applications/CPLEX_Studio/cplex/bin/x86_64_OSX/.