Building Vaango

Instructions for building Vaango on Ubuntu are given below.

Prerequisites
Building the executables
Compiling the code:

Prerequisites

Cmake:

You will probably need to install Cmake to control the software compilation process. To do that:

     sudo apt-get install cmake

Compilers:

You also need to have gfortran:

     sudo apt-get install gfortran

and a C Compiler known as gcc:

     sudo apt-get install gcc

You will need boost for parts of the code (and also the unit tests) to compile.

     sudo apt-get install libboost-all-dev

MPI and XML libraries:

the OpenMPI libraries:

     sudo apt-get install mpi-default-dev

and libxml2:

     sudo apt-get install libxml2
     sudo apt-get install libxml2-dev

Other libraries:

You will also need to install the development version of zlib.

     sudo apt-get install zlib1g zlib1g-dev

The Peridynamics code uses parts of the Eigen3 library. You will have to install this library if you don’t have it in your system:

     sudo apt-get install libeigen3-dev

In order for related code like MPM3D_xx etc. to work, you will also need the VTK libraries. Use

     sudo apt-get install libvtk5-dev
     sudo apt-get install python-vtk tcl-vtk libvtk-java libvtk5-qt4-dev

In some older versions of Vaango, libpcl is used read point data file. In order to get PCL(The Point Cloud Library) you need to run these three commands:

    sudo add-apt-repository ppa:v-launchpad-jochen-sprickerhof-de/pcl
    sudo apt-get update
    sudo apt-get install libpcl-all

Building the executables

The Vaango repository

After you get the code from GitHub, follow these steps:

Go to the Vaango directory:

     cd ParSim/Vaango

The source code is in the directory src.

Out-of-source optimized build

For the optimized build, create a new directory called opt under Vaango:

    mkdir opt

followed by:

    cd opt

To create the make files do:

    cmake ../src

Out-of-source debug build

For the debug build, create a directory dbg under Vaango:

    mkdir dbg
    cd dbg

To create the makefiles for the debug build, use

    cmake -DCMAKE_BUILD_TYPE=Debug ../src

Unit tests

If you want the units tests to be compiled, use the alternative command

    cmake ../src -DBUILD_UNITS_TESTS=1

Clang compiler:

If you want to used the clang compiler instead of gcc:

    cmake ../src -DUSE_CLANG=1

Visit build:

Older versions of Visit required the following extra step if you want to make sure that Visit is able to read Uintah output format files (also called UDA files) you will need to use

   cmake ../src -DVISIT_DIR=/path/to/Visit

Compiling the code:

Next you need to compile the needed files from src. So enter your opt directory and then type :

...:~/ParSim/Vaango/opt$ make -j4

After this compilation you have all the executable files in your opt directory.
The same process can also be used for the debug build.

Biswajit Banerjee