===== Madagascar at NTNU =====
Madagascar is a processing package suited for research in seismic imaging. Documentation is found
at Madagascar's home page:

  * [[http://www.reproducibility.org/wiki/Main_Page| Madagascar Home page]]



==== Madagascar source code ====

Source code for the local Madagascar is stored under version control using [[http://subversion.apache.org/docs/svn|svn]]. To check out the source code from the repository, do the following. First: On the Seis server open //.profile// in your home folder and add the following lines
<code>
newgrp msim
umask 0007
</code>
Save the file and logout of the server.

Second: Go into the folder where you want the source code to be downloaded and type
<code>
svn co svn+ssh://username@seis.ivt.ntnu.no/home/msim/svn/madagascar-1.6.3
</code>
Here //username// is your username on the Seis server. This will create a working copy under svn control in the directory where you performed the command. Now you may use standard subversions commands like //up// and //ci// for updating and committing code, respectively.
==== Compiling Source Code in a Linux Environment ====
To have all the features of Madagascar, some packages must be installed in the Linux system **before** the compiling of the source code. To install the necessary packages type the following command in the terminal (for a deb-based system):
<code>
sudo apt-get install libxaw7-dev freeglut3-dev g++ gfortran libc6-dev libnetpbm10-dev libgd2-xpm-dev libglew1.5-dev libjpeg62-dev libplplot-dev libavcodec-dev libcairo2-dev libblas-dev libx11-dev libxaw7-dev swig python-dev python-scipy python-numpy libtiff4-dev scons units 
</code>
After the installation is completed the system is ready for compliling the downloaded source code from the above repository. See the installation notes [[http://www.reproducibility.org/wiki/Installation|here]]. 

Following the abovementioned notes, the configuration file output may look like the following (where the installation path is chosen to be // /home/espenbir/programs/madagascar//):
<code>
espenbir@Riemann:~/programming/src/madagascar$ ./configure --prefix=/home/espenbir/programs/madagascar
checking for Python ... /usr/bin/python
checking Python version ... 2.7.1+
checking for RSFROOT ... /home/espenbir/programs/madagascar
checking for SCons ... no
Installing SCons ... /home/espenbir/programs/madagascar/bin/scons
checking SCons version ... v2.0.1.r5134
Running RSFROOT=/home/espenbir/programs/madagascar /home/espenbir/programs/madagascar/bin/scons  config ...
------------------------
scons: Reading SConscript files ...
checking platform ... (cached) linux [ubuntu]
checking for C compiler ... (cached) gcc
checking if gcc works ... yes
checking if gcc accepts '-std=gnu99 -Wall -pedantic' ... yes
checking for ar ... (cached) ar
checking for libraries ... ['m']
checking complex support ... yes
checking for X11 headers ... /usr/include
checking for X11 libraries ... /usr/lib/X11
checking for OpenGL ... yes
checking for sfpen ... (cached) xtpen
checking for ppm ... yes
checking for tiff ... no

  sfbyte2tif, sftif2byte, and tiffpen will not be built.
checking for GD (PNG) ... yes
checking for GD (GIF) ... yes
checking for plplot ... yes
checking for ffmpeg ... yes
checking for cairo (PNG) ... yes
checking for cairo (SVG) ... yes
checking for cairo (PDF) ... yes
checking for jpeg ... yes
checking for BLAS ... yes
checking for LAPACK ... no
checking for MPI ... (cached) no
checking for Posix threads ... yes
checking for OpenMP ... yes
checking for CUDA ... (cached) no
checking API options ... (cached) []
scons: done reading SConscript files.
scons: Building targets ...
shell_script(["env.sh"], [])
shell_script(["env.csh"], [])
scons: done building targets.

---------------------------------------------------------
To start using madagascar, source env.sh or env.csh from:
    /home/espenbir/programs/madagascar/share/madagascar/etc/
Local documentation center at:
    /home/espenbir/programs/madagascar/share/doc/madagascar/
Documentation wiki at http://www.ahay.org
---------------------------------------------------------

------------------------
Done with configuration.
</code>
As we see from the above output everything but tiff support is available. Now we compile the source code using the command
<code>make install</code>
Hopefully, Madagascar is compiled correctly, without errors. The last thing to do is mapping the Madagascar commands such that they are reachable from everywhere in the terminal. Add this line to the //.bashrc// file
<code>
source /home/espenbir/programs/madagascar/share/madagascar/etc/env.sh
</code>
Now, Madagascar is up an running, and you can try the tutorials on the web page for Madagascar.

**Note:** You may specify your own path where you install Madagascar. If so, change the paths in the --prefix command in the configure file, and the mapping directory in the .bashrc file.