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.

• Set the environment variables XERCESROOT and ACEROOT. For instance, in .bash_profile, add

 XERCESROOT=/your-path/splot-build/xerces-c-src_2_7_0
 export XERCESROOT
 ACEROOT=/your-path/splot-build/ACE_wrappers
 export ACEROOT

• Add xerces library path to LD_LIBRARY_PATH to build the middleware executable (we don't really need this), e.g.

 LD_LIBRARY_PATH=$XERCESROOT/lib:$LD_LIBRARY_PATH

• Run scons in the OpenTracker root directory

 scons

Build newmat

• Download newmat (e.g. newmat11.tar.gz) from http://www.robertnz.net/download.html
• Make a directory newmat in "splot-build" and unzip the code into "newmat"
• Compile newmat by running

 make -f nm_gnu.mak

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

• Modify CMakeLists.txt to compile: add splot-build/opentracker/include to INCLUDE_DIRECTORIES

• Compile

 make