images/capri_pic_01.jpg images/capri_pic_02.jpg images/capri_pic_03.jpg

STAR - Stable Releases of CAPRI

Starting 2016, the CAPRI model shall be made more accessible to the scientific community by the provision of supported stable releases, a.k.a. Stars. The first Star was published at the end of November. The idea behind the Star is to provide a well tested version of the model, that does not change over time save for maintenance releases addressing critical issues. The release notes are updated in a cumulative fashion.

How to obtain a copy

For users without a login to the CAPRI SVN system

In order to obtain a copy, send an e-mail to and use “Get Capri” in the subject line. We have no restrictions on the distribution of CAPRI. However, we would appreciate if you would at least let us know your institutional affiliation, if any, and a word or two about your interest in CAPRI. You will then receive the model as a zipped archive.

For registered users of the CAPRI SVN system

Users that have participated in the CAPRI training courses will have access to the code base and the model via the Subversion Numbering system (SVN), and the instructions here do not apply to such users. They should point their SVN client to the tags “STAR_N.N” on the SVN server to obtain the release versions (N.N) of CAPRI.

Please refer to the release notes for more information about each release.

System requirements

CAPRI requires that you have a windows computer with Java runtime environment (64-bit) and GAMS (distribution 24.7 or later, installed. You need a license for the CONOPT solver.

Installation instructions

Using CAPRI requires extensive knowledge of how the system works. Please look out for CAPRI training courses on the page of upcoming events. The following bare-bone instructions may nevertheless be sufficient to get the system up and technically running.

  1. Create an installation folder to hold model source files on your local hard drive such that the path does not contain spaces. Thus, it will not work to install the model in “My Documents” (path containing space) or on a network drive (the access will be too slow).
  2. Extract the files of the compressed archive into the folder you just created.
  3. Go to the subfolder GUI, double-click “start_capri.bat”. That should open the graphical user interface (GUI). If not, something is wrong with your Java-installation.
  4. In the menu settings, choose Edit settings.
    1. In the first tab: enter your name
    2. In the second tab: verify that the paths to result and restart folders are set to ..\output\results and ..\output\restart. The GAMS directory should read ..\gams and the data directory should read ..\dat.
    3. In the third tab: enter the complete path to the GAMS executable. Probably it is c:\gams\win64\24.7\gams.exe. Also verify that the path to the Scratch directory is ..\output\temp. Click the button to “get number of processors”.
    4. In the fourth tab: do nothing.
    5. In the final tab: do nothing.
  5. Click “Save in caprinew.ini” and accept the file name suggested for your settings.
  6. Close the GUI, then start it again (using start_capri.bat), to make it process your settings.

Build databases and baselines

Now you need to build all databases of CAPRI. This takes a very long time. Depending on the hardware you use, it can take up to several days.

  1. In the GUI, choose the workstep “Installation” and then execute the GAMS program. It will create the necessary sub-directories to hold result and restart files.
  2. In the GUI, choose the menu GUI –> Batch execution
  3. In the dialogue, choose the file ”<gamsdir>\GUI\batchfiles\build_database_and_baseline.txt”
  4. Uncheck the option “Only compile the GAMS programs”
  5. Click “Start batch execution”.
  6. Wait for the program to finish (hours, days).
  7. Click “Open HTML report” and verify that all steps were completed without errors (RC=0).
Last modified: 2017/01/27 13:35
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 3.0 Unported