Version 18 (modified by 16 years ago) (diff) | ,
---|
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:
- 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.
Obtaining the Source
- Either download and extract the following
.zip
files. - Or check out it with Mercurial. The development repository URL is
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 startcmake-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 areDebug
,Release
,MinSizeRel
andRelWithDebInfo
.CMAKE_CXX_FLAGS*
sets the compiler flags used by the different build modes.GLPK_INCLUDE_DIR
,GLPK_LIBRARY
,DOXYGEN_*
andGHOSTSCRIPT_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).