NemoMath

h1. Dependencies

{{>toc}}

NemoMath depends of the following tools and libraries, which are by default installed on all recent Ubuntu Linux configurations:

* Build system: "CMake":http://www.cmake.org/ (if you install NemoMath from source)

* Libraries:

 # "Boost":http://www.boost.org/ (header-only parts) (on ubuntu: _libboost-dev_, _libboost-test-dev_)

 # "Eigen 2":http://eigen.tuxfamily.org/index.php?title=Main_Page (on ubuntu:  _libeigen2-dev_) *or* "Eigen 3":http://eigen.tuxfamily.org/index.php?title=Main_Page

h1. Supported Platforms and Compilers

NemoMath is a cross-platform, cross-compiler library which is tested and maintained for the most frequently used system configurations:

h3. Operating System Support

* Supported: 

 # Linux, Ubuntu 10.04 and newer

 # Mac OS 10.7 and newer

 # Windows 7 and newer

h3. Compiler Support

* Supported: 

 # GCC from version 4.3, 32/64bit (tested on Ubuntu Linux)

 # CLang3.0 (tested on MacOS)

 # MSVC 2010 or newer (tested on Windows 7)

* Not supported (and known not to work): 

 # GCC version 4.2, or older 

 # MSVC 2008 or older

h3. Test configurations 

These configurations are permanently tested and known to work:

* Windows 7, Microsoft Visual Studio 2010, Boost 1.44.0, Eigen 2

* Mac OS 10.7 "Lion" 64bit, Clang 2.1.0, Boost 1.47.0, Eigen 3.1.0

* Ubuntu Linux 10.04 "Lucid Lynx" 32bit+64bit, GCC 4.4.3, Boost 1.40.0, Eigen 3.0.0

* Ubuntu Linux 12.04 "Precise Pangolin" 32bit+64bit, GCC 4.6.3, Boost 1.46.1, Eigen 3.0.5

* Ubuntu Linux 12.10 "Quantal Quetzal" 32bit+64bit, GCC 4.7.2, Boost 1.49.0, Eigen 3.0.93

h1. Pre-Configured Installation 

h3. Debian packages

+This is the recommended installation procedure for NemoMath on Ubuntu Systems+.

Packages for Ubuntu Linux are constantly built on our continuous integration server for

* Ubuntu Linux 10.04 "Lucid Lynx" 32bit + 64bit

* Ubuntu Linux 12.04 "Precise Pangolin" 32bit + 64bit

* Ubuntu Linux 12.10 "Quantal Quetzal" 32bit + 64bit

They can easily be downlaoded from out "Package Server":http://packages.cor-lab.org/. Follow the link to get further instructions.

h3. Gar System Installer

# Check out CITEC Gar System Installer from https://projects.cit-ec.uni-bielefeld.de/svn/gar-installer/trunk/

# Go into sub-folder @cor-lab/NemoMath@

# On your console type

#* @make install@

h1. Install from Source

h3. A "header only" library

h3. Getting and installing the course

# Check out SVN https://code.cor-lab.org/svn/nemomath/trunk/nemomath

# On your console type

<pre>

cd nemomath/build && cmake .. -DCMAKE_INSTALL_PREFIX=$prefix && make && make install

</pre>

h3. Install and Compile Options

The following options manipulate the way NemoMath works during compilation time:

* CMake option: @USE_CPP_0X@ (default: @true@)

  * Enables NemoMath to use C++ features from the latest standard. This option is mandatory except on GCC 4.3, where fallbacks for critical features (declared type of expressions) are available.

  * If enabled, @MathVector@ and @Matrix@ instances can be constructed by @C++11@ initialization lists.

  * The option can be steered on compiler level by defining the C++ macro @NEMO_HAS_CPP0x@, or not.

* CMake option: @ABORT_ON_ERROR@ (default: @false@)

  * By default, NemoMath throws C++ exceptions in case of runtime errors. This option allows to disable exceptions and call @abort()@ in case of an error.

  * In particular on older compilers (e.g. GCC 4.4), this can have a tremendeously positive impact on performance (see Benchmarks in #821). 

h1. Using NemoMath