Install on Windows (from source, with CMAKE)

Prerequisites

• You must have a C++ compiler. We assume ​Visual Studio 2008 in this guide. The freely available ​Express Edition is fine.
• You must also download and install ​CMake 2.6.2 (.exe installer) or later.

Optional tools

• To use the LP/MIP interface, you need ​GLPK. We suggest to use the .exe installer provided by the ​GnuWin32/GLPK project.
  • A local copy of the installer can be found here: glpk-4.34-setup.exe

• For HTML document generation, you need to install a recent version of ​Doxygen, ​Graphviz and ​Ghostscript. Local copies are here:
  • Doxygen 1.5.8 (.exe installer)
  • Graphviz 2.20.3 (.msi installer)
  • GPL Ghostscript 8.63 (.exe installer)
• If you want to keep track of the latest development of LEMON or even contribute to it, you need the ​Mercurial distributed version control system. We strongly recommend to use ​TortoiseHg, which provides a simple installer for Mercurial, a nice GUI and also an integration to the MS Windows Explorer.
  • A local copy can be found here: TortoiseHg 0.6 (.exe installer)

Obtaining the Source

• Either download and extract
  • one of the stable releases or
  • the latest development snapshot (.zip)
• Or check out it with Mercurial. The development repository URL is
  • http://lemon.cs.elte.hu/hg/lemon-main.

Configure the CMAKE

The compilation must be done in a separate folder. We suggest to create a subfolder called build in the root of the source code repository.

Then start the CMake GUI and browse the source code and the build folders.

It is even better to start the "Visual Studio 2008 Command Prompt" from the Start menu. Then, in the command prompt, step into the build folder and type

cmake-gui ..

then it will usually set the right source and build folder. (But check it!)

Now click on the "Configure" button. Here choose

• either Visual Studio 9 2008 to create project files and an .sln file usable from the Visual Studio IDE.
• or NMake Makefiles to create makefiles and compile from command line. In this case you must start cmake-gui from the "Visual Studio 2008 Command Prompt"

Now, you can review and modify several configure options (change to "Advanced" or "Grouped" view in order to see all of them). For example

• CMAKE_INSTALL_PREFIX tells where LEMON will finally be installed.
• CMAKE_BUILD_TYPE determines the build modes. The possible values are Debug, Release, MinSizeRel and RelWithDebInfo.
• CMAKE_CXX_FLAGS* sets the compiler flags used by the different build modes.
• GLPK_INCLUDE_DIR, GLPK_LIBRARY, DOXYGEN_* and GHOSTSCRIPT_EXECUTABLE set the path of the dependencies.

Then click again on "Configure" and finally on "Generate".

The configuration is done.

Build and Install

With NMake

• Start the "Visual Studio 2008 Command Prompt".
• Step into the build folder
• To compile the source and build the library, type

  nmake
  

• For executing the self tests, run

  ctest
  

• To generate the HTML documentation (see the prerequisites above), type

  nmake html
  

• Finally, to install LEMON, type

  nmake install
  

With IDE

Open the generated LEMON.sln file in Visual Studio (or just click on it in the Windows Explorer), then you will find several targets corresponding to the tasks of the previous section. They are

• ALL_BUILD
• RUN_TESTS
• HTML
• INSTALL

Simply right click and choose "Build" for each of these target (in the above order).