Disorder

h1. Installation

h2. Obtaining the Source Code

h3. Release Tarballs

Release source tarballs are available on the "Files":http://oss.squalllinesoftware.com/projects/disorder/files page.  This is what you want if you are looking for stability and something ready for production use.  You'll probably want to use the most recent version found on that page.

h3. SCM

The Disorder source code is hosted in a "Bazaar":http://bazaar.canonical.com repository.  This is what you want if you are looking for the very latest bleeding edge of the code for contributing to Disorder or whatever other reason you may have.

To get a lightweight checkout of the latest version without all the history (not suitable for Disorder development):

<pre>bzr co --lightweight http://???.squalllinesoftware.com/???/disorder</pre>

To clone the repository including the full history:

<pre>bzr branch http://???.squalllinesoftware.com/???/disorder</pre>

h2. Prerequisites

The following third party things are required to use Disorder:

* "Boost":http://www.boost.org >= 1.49.0

* "Eigen":http://eigen.tuxfamily.org >= 3.0.5

* C++ version of the "SEDRIS SRM":http://www.sedris.org/srm_4.4/srm_c_cpp.htm >= 4.4.0 (optional but you will need some kind of sophisticated geospatial library)

* A "Python":http://www.python.org interpreter (needed to use the "waf":https://code.google.com/p/waf/ build system)

Build and install these things in accordance with the instructions for your operating system provided by each vendor.  Some hints for certain platforms follow.

h3. Debian Linux and Derivatives

Pat yourself on the back for using a good operating system.  All the dependencies are available via the package system.  To install the Boost and Eigen build dependencies on Debian and maybe other derivatives:

<pre>sudo apt-get install libboost-dev libboost-system-dev libboost-thread-dev libboost-date-time-dev libeigen3-dev</pre>

If you don't already have python, this will get the required bits of that:

<pre>sudo apt-get install python</pre>

h2. Configuration

If everything is setup properly, this step will be a breeze, but it is important to resolve any errors produced by the configuration step prior to attempting to compile Disorder.

h3. Linux

From inside the root of the Disorder tree do this in your favorite terminal emulator:

<pre>./waf configure --sedris-srm-root=<put the path to the SEDRIS SRM root here></pre>

For example, if your SEDRIS SRM is in /opt/sedris/srm:

<pre>./waf configure --sedris-srm-root=/opt/sedris/srm</pre>

That command will take several seconds and print a bunch of hopefully green stuff.  The output should end up looking something like this:

<pre>

Setting top to                           : /opt/disorder 

Setting out to                           : /opt/disorder/bin 

Checking for 'g++' (c++ compiler)        : /usr/bin/g++ 

Checking for program doxygen             : /usr/bin/doxygen 

Checking for program tar                 : /bin/tar 

Checking boost ABI tag                   :  

Checking boost includes                  : 1_49 

Checking boost libs                      : ok 

Checking for boost linkage               : ok 

Checking for header boost/asio.hpp       : yes 

Checking for header boost/bind.hpp       : yes 

Checking for header boost/date_time.hpp  : yes 

Checking for header boost/detail/endian.hpp : yes 

Checking for header boost/format.hpp        : yes 

Checking for header boost/function.hpp      : yes 

Checking for header boost/functional/factory.hpp : yes 

Checking for header boost/ptr_container/ptr_vector.hpp : yes 

Checking for header boost/scoped_ptr.hpp               : yes 

Checking for header boost/static_assert.hpp            : yes 

Checking for header boost/thread.hpp                   : yes 

Checking for program pkg-config                        : /usr/bin/pkg-config 

Checking for 'eigen3'                                  : yes 

Checking for header Eigen/Dense                        : yes 

Checking for SEDRIS SRM                                : /opt/sedris/srm 

Checking for SEDRIS SRM include directory              : /opt/sedris/srm/src/include 

Checking for SEDRIS SRM library directory              : /opt/sedris/srm/lib/linux-3.1.0-1-amd64-i386-gnu-/OPT 

SEDRIS SRM library                                     : /opt/sedris/srm/lib/linux-3.1.0-1-amd64-i386-gnu-/OPT/libsrm.so 

Checking for header srf_all.h                          : yes 

'configure' finished successfully (25.518s)

</pre>

If you don't see that last line saying that 'configure' finished successfully, you must fix whatever it complains about and try again.

h3. Clang

To use the Clang C++ compiler instead of GCC's, assuming you already have clang++ installed, do this:

<pre>CXX=<put the path to clang++ here> ./waf configure --sedris-srm-root=<put the path to the SEDRIS SRM root here></pre>

So, this might work for example:

<pre>CXX=/usr/bin/clang++ ./waf configure --sedris-srm-root=/opt/sedris/srm</pre>

h3. Windows

On windows, your $PATH environment variable needs to include the path to the Python interpreter.

Next, you'll want to modify the provided batch file to tell Disorder where your prerequisites live.  From inside the root of the disorder tree:

<pre>copy tools/configure.bat configure.bat</pre>

This file contains some stuff at the top you'll want to edit to match your system configuration.

h2. Compiling

h3. With GCC on Linux

h3. With Clang++ on Linux

h3. With Visual Studio 2010 (Express or Full)

h2. Building Against the Disorder Library