View source for Instructions to Build SPLOT with opentracker 1.3

== Create directory "splot-build" ==

* Make this directory anywhere you want
* This is the place all splot stuff and its dependent libs will sit

== Build ACE ==

* Download ACE source code, e.g. ACE-5.5.tar.gz, from this site: http://download.dre.vanderbilt.edu/

* Move the compressed source code (e.g. ACE-5.5.tar.gz) to the directory "splot-build"

* Unzip the source code and you will have this directory: ACE_wrappers
  gunzip ACE-5.5.tar.gz
  tar xvf ACE-5.5.tar

* Set environment variable: '''ACE_ROOT'''. For instance, in '''.bash_profile''', add
  ACE_ROOT=/your-path/splot-build/ACE_wrappers
  export ACE_ROOT

* Add ACE lib to environment variable: '''LD_LIBRARY_PATH'''. For instance, in '''.bash_profile''', add
  LD_LIBRARY_PATH=$ACE_ROOT/lib:$LD_LIBRARY_PATH
  export LD_LIBRARY_PATH

* Create a configuration file, '''config.h''', in $ACE_ROOT/ace. Config.h will contain only the following line:

  #include "ace/config-linux.h"

This file includes the appropriate platform/compiler-specific header configurations from the ACE source directory.

* Create a build configuration file, '''platform_macros.GNU''', in $ACE_ROOT/include/makeinclude. Platform_macros.GNU will contain only the following line:

  include $(ACE_ROOT)/include/makeinclude/platform_linux.GNU

This file contains the compiler and Makefile directives that are platform/compiler-specific.

* Run "make" in the ACE_ROOT directory
The compiling failed in building $ACE_ROOT/ACEXML/examples/SAXPrint. But the ACE libraries are already built in $ACE_ROOT/lib.

== Build xerces ==

* Download "xerces-c-src_2_7_0.tar.gz" from: http://archive.apache.org/dist/xml/xerces-c/source/ into the directory "splot-build"
* Unzip the source code and you will have this directory: xerces-c-src_2_7_0
  gunzip xerces-c-src_2_7_0.tar.gz
  tar xvf xerces-c-src_2_7_0.tar
* Set environmental variable: '''XERCESCROOT'''. For instance, in '''.bash_profile''', add:
  XERCESCROOT=/home/your-path/splot-build/xerces-c-src_2_7_0
  export XERCESCROOT

* Run autoconf
  cd $XERCESCROOT/src/xercesc
  autoconf

* In the same directory,
  ./configure
  make

* You will see libraries built in $XERCESCROOT/lib

== Build opentracker == 

* In "splot-build,", check out opentracker 1.3 from
  svn co --username otreader https://svn.icg.tu-graz.ac.at/svn/opentracker/tags/OPENTRACKER_1_3_FINAL opentracker 
Press "t" to temporarily accept the certificate. Input '''OPEN4read''' when prompted for password.

* To build opentracker, do the following:
  cd opentracker
  ./bootstrap
  ./configure --with-ace=your_ace_dir --with-xerces=your_xerces_dir
  make

== Build CMake ==

Assume Slicer3 has been built, set PATH for CMake bin.

== Build SPLOT ==

* Check out SPLOT code into "splot-build" from
  svn co http://www.na-mic.org:8000/svn/Sign/SPLOT/trunk SPLOT

* Configure the build by running this command in SPLOT root directory
  ccmake .

ACE: path/libACE.so; ACE_DIR: path/ACE_wrappers; OPENTRACKER: path/libopentracker.so; OT_INC: directory containing OpenTracker.h; XERCES: path/libxerces-c.so

* Compile
  make