Essential Information on Using ODEMx

Requirements

All Platforms

Linux, Unix, Mac OS X, Gygwin, MinGW

Known Developers by Build Environment

You can try to contact one of the developers below if you encounter problems when building or using ODEMx.

Build Environment Known Developers
Linux Magnus Mueller, Toralf Niebuhr
Mac OS X Andreas Blunk, Ingmar Eveslage
MinGW/MSYS Andreas Blunk, Ingmar Eveslage
Cygwin -
Visual Studio -

Build Guide

Preliminary Notes

Additional Notes

Building External Libraries

Linux, Unix, Mac OS X, MinGW, Cygwin

  1. Download (optional)
    • NOTE: you only need to download if the directory ODEMX_HOME/external/contrib does not already contain the following sub-directories:
      • gsl-1.13
      • poco
      • UnitTest++
    • automatic downloading requires (wget or curl) and a SVN command line client
    • cd to ODEMX_HOME/external/contrib
    • run download_contrib.sh
  2. Build
    • create an install directory (location where all the binaries, libs, header files and docs will be placed) (e.g. ODEMX_HOME/install)
    • cd to external/contrib
    • run install_contrib.sh with the install directory (e.g. ./install_contrib.sh ../../install)
      • look into install_contrib.sh for details - e.g. if you want to build shared libraries or with ODBC support)

Building ODEMx

Getting MinGW and CMake (if not already installed)

  1. Install MinGW …
    • Download MinGW from http://sourceforge.net/projects/mingw/
    • Run the installer and select …
      • MinGW C++ Compiler,
      • MinGW Developer Toolkit
      • MSYS Basic System
    • Add <MinGW_HOME>/bin to your PATH environment variable
  2. Install CMake …
    • Download CMake from http://www.cmake.org
    • Run the installer and let CMake add itself to the PATH environment variable (in installer dialog)

Known Problems per Build Environment

Building on Linux, Unix, Mac OS X, MinGW, Cygwin

Customizing Library Paths (optional)

If you want to use custom paths, edit the following variables (NOTE: you can also pass them as command line arguments):

You can pass command line arguments to CMake with -D like this: -D GSL_INSTALL_PREFIX=/your_install_dir

Building the ODEMx Documentation (optional)

Building and Running Tests for ODEMx (optional)

Using ODEMx

Getting Started - Your First ODEMx Project

You can create your first ODEMx project by using files from a sample project in ODEMX_HOME/SampleProject. The sample project includes a simple ODEMx program (main.cpp) and a CMakeLists.txt.

Troubleshooting

Memory Exhaustion

If you experience memory exhaustion errors, you have to set the size of the process stacks explicitly.

  1. Open CMakeLists.txt
  2. Adapt the line at the end of the file and specify the size of the stack used by the linker. 32Kb should be sufficient in most cases.
if(USING_MINGW)
    set_target_properties(main PROPERTIES LINK_FLAGS "-Wl,--enable-auto-import -Wl,--enable-stdcall-fixup -Wl,--stack=32768")
endif()

Using your Project in Eclipse

Using the ODEMx Debugger

Compatibility Notes

Installation Notes

Preparation of ODEMx-based Projects

Debugging a Binary with the ODEMx Debugger

GUI Usage

See TODO: insert link.

Additional Information

See TODO: insert link to diplomarbeit.