Installation (Windows)

• Download the OGDF package from here and unpack in the directory, where you want to install OGDF.
• Build OGDF (Visual C++ 8.0 Compiler):
  1. Execute the python script makeVCProj.py to generate a Visual Studio 2005 project file ogdf.vcproj.
  2. Open this project with Visual Studio 2005 and call build.

If you want to compile OGDF with another version of Visual Studio, you can specify a different project template file in the GENERAL section of MakeVCProject.config, which sets by default the ogdf.vcproj.vs2005.template:

[GENERAL]
templateFile = ogdf.vcproj.vs2005.template  # File name of project template file
projectFile = ogdf.vcproj                   # File name of created project file

At the moment, you also have the choice to choose ogdf.vcproj.vs2003.template for Visual Studio 2003 (Visual C++ 7.1). If you are using Visual Studio 2008, you may also try this template not yet contained in the package:

ogdf.vcproj.vs2008.template

Some algorithms in OGDF require additional LP-solver libraries. These algorithms will not be compiled by default. If you want to use them, you need to install

• the Coin Open Solver Interface (Osi)
• a further LP solver like CPLEX used as LP-solver by Coin (optional).

and switch compiling on by editing makeVCProject.config and setting the variable useCoin to true. The [COIN] section of your config file should look like this:

[COIN]
useCoin = true                  # turn Coin-support on
coinIncl = C:/???/COIN/include  # path to Coin include-directory (adapt)
solver_name = COIN_OSI_???      # which LP-solver shall Coin use: use any of
                                #    COIN_OSI_CLP = Coin's own LP-solver
                                #    COIN_OSI_CPX = CPLEX solver
                                #    COIN_OSI_SYM = Coin's Symphony framework
solver_incl = C:/???/include    # path to the LP-solver's include-directory (adapt)

The compilation of OGDF does not require the actual libraries. Anyhow, for compiling your own program against OGDF, you have to give Visual C++ the according paths and specifications:

1. Add the path to the OGDF header files to the include path (project properties → C++ → Additional include directories). This is the directory of the OGDF installation which contains the directory ogdf.
2. If you want to link against the Debug version of OGDF, add the preprocessor definition OGDF_DEBUG (project properties → C++ → Preprocessor → Preprocessor definitions).
3. Make your project depending on the OGDF project to link against OGDF. Alternatively, you can also add the path to ogdf.lib to the library path (project properties → Linker → Additional library directories) and add ogdf.lib as additional library for the linker (project properties → Linker → Input → Additional dependencies).

For linking OGDF with the COIN libraries, you need to compile the COIN libraries with the Multithreaded DLL threading model and for the same target platform as your project (win32/x64, Debug/Release). The .zip archive below contains the precompiled COIN libraries and header files that can be used with OGDF.

To build a program that shall link against OGDF and COIN do the following steps:

1. Add the path to the OGDF and the COIN header files to the include path (project properties → C++ → Additional include directories).
2. Add USE_COIN;COIN_OSI_CLP to the preprocessor definitions (project properties → C++ → Preprocessor → Preprocessor definitions).
3. Add the path to the COIN libraries to the library path (project properties → Linker → Additional library directories). Make sure that you use the path to the libraries compiled for the same configuration and platform as your project.
4. Add libClp.lib libCoinUtils.lib libOsi.lib libOsiClp.lib as additional libraries for the linker (project properties → Linker → Input → Additional dependencies).
5. Make your project depending on the OGDF project to link against OGDF. Alternatively, you can also add ogdf.lib in a similar way as the COIN libraries.
6. Build your project.

Precompiled COIN libraries for Visual Studio 2005: osi-0.96.1-vc8.zip [23.7 MB]

It is also possible to create the documentation directly from the source files if you have Doxygen installed. You will also need to have LaTeX and Ghostscript installed so that Doxygen can create images from formulas. To build the OGDF HTML documentation, call

build-ogdf-docs.bat

in the doc subdirectory of the OGDF installation (or simply double-click on the file). The documentation will then be written to doc/html.