Editing Advanced Installation (section)

=Prerequisites=
Basic prerequisites are described in the [[Installation|short Installation guide]]. Here are some additional details. 
==Compilers==
Madagascar has been built successfully with the following compilers, and possibly with others:
* gcc
* Intel (icc/ifort)
* open64
* clang
* cc (Solaris)

==Python and SCons==
As described below under [[Advanced Installation#Platform-specific installation advice | Platform-specific installation advice]], Madagascar supports the oldest non-deprecated Python version currently supported by the latest stable version of [http://scons.org/ SCons].  If your version of Python is older and you experience problems you should probably [http://www.python.org/ upgrade].

Madagascar includes the latest stable version of SCons and the configure scripts will try to install it for you in RSFROOT if you don't have it already.  However, if you have an older version of SCons the configure scripts will not try to install the newer version. Your older version might work fine, but Madagascar attempts to support only the latest stable version of SCons, so if you have problems you should upgrade.

To install the SCons bundled with Madagascar go to <tt>RSFSRC/scons</tt>, unpack the tar file, and type

<syntaxhighlight lang="bash">
python setup.py install
</syntaxhighlight>

This will install SCons in the standard location. You might need root privileges. If you don't have root privileges, or you don't want to interfere with the system SCons you can install it somewhere else with a --prefix option. A logical choice is to put it in RSFROOT like this:
 
<syntaxhighlight lang="bash">
python setup.py install --prefix=$RSFROOT
</syntaxhighlight>

==Location==
As long as you set the environment variables and directory permissions correctly, it does not matter in what part of your filesystem you place the install. If you have the luxury of installing anywhere, it is good practice to follow the [http://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard Filesystem Hierarchy Standard] and either:
# Install everything (including <tt>figs</tt> if you do testing) under <tt>/usr/local/rsf</tt>, with the source tree in <tt>/usr/local/rsf/src</tt>, OR 
# Put the source tree in <tt>/usr/local/src/rsf</tt>, and specify <tt>RSFROOT=/usr/local</tt>, so that header files and binaries go in <tt>/usr/local/bin</tt> and <tt>/usr/local/include</tt>. To follow the standard, before installing set <tt>RSFDOC=/usr/local/share/rsf/doc</tt> and create the appropriate directories. The auto-generated HTML documentation will get put there. Also, if installed, the figs directory for testing should be <tt>/usr/local/share/rsf/figs/</tt>.
# Package Madagascar (i.e. build a RPM, etc) and install it in the default locations. For RPMs, those are as like the ones from the previous option, just directly in the <tt>/usr/</tt> hierarchy, instead of in the <tt>/usr/local/</tt> one.

==Disk space==
At present (Feb 2007, r2530), the source directory containing the build tree from the development version was approx. 200Mb, the full installation (<tt>bin/</tt>, <tt>doc/</tt>, <tt>include/</tt> and <tt>lib</tt>) is 31Mb, and <tt>figs/</tt> (the optional directory if you want to do testing) is about 10 Gb. The stable version is significantly smaller.

The only Madagascar-related directory where disk space can be an issue is <tt>$DATAPATH</tt>. Real 3-D seismic datasets can be measured in Terabytes. Buggy programs/processing flows can fill up <tt>$DATAPATH</tt>. A real problem are "disk memory leaks" -- removing header files with anything else than <tt>sfrm</tt> will leave the binaries intact. Crashed jobs which start to write to binary but never get to write the header also produce "leaks". Experience has shown that over time <tt>$DATAPATH</tt> inexorably fills up. You may need to 
# keep irreplaceable data and expensive results in a separate place;
# remove the oldest files in <tt>$DATAPATH</tt> whenever the amount of free space declines under a preset threshold.

==Dependencies==
Some platforms feature complete lists of dependencies. See [[Advanced Installation#Platform-specific installation advice | Platform-specific installation advice]] for details.
===C++ API===
A C++ compiler. SCons is smart and will try to find it for you. If it does not work specify the path to your compiler in the <tt>CXX</tt> environment variable (can be passed as an option to the configuration script, like the <tt>API</tt> one).
===F77 API===
A Fortran 77 compiler. If SCons does not find one, then you can either specify its path through the <tt>F77</tt> variable, or if the executable is in your path, add its name to the list of F77 compilers in <tt>RSFSRC/configure.py</tt> .
===F90 API===
Same as for Fortran 77 &ndash; just substitute <tt>F90</tt>. If using the <tt>gfortran</tt> compiler, make sure to get [http://gcc.gnu.org/wiki/GFortranBinaries the latest version]. If you have more than one compiler installed on your system, specify the desired one at configuration time:
<bash>
./configure API=f90 F90=/path/to/preferred/compiler
</bash>

===Java API===
There are two styles of API, old (1.0 release and previous) and new. The two APIs are not compatible with each other.

The "old" interface requires the Mines Java Toolkit for fast Java file IO. The Mines JTK, is an open-source Java package that can be downloaded from [http://inside.mines.edu/~dhale/jtk/ Mines JTK]. Currently, the "old" interface will also build alongside the new one if the MINESJTK environment variable exists, and can be used as was previously.

To install the new API, you need the (Oracle) JDK. Set your JAVA_HOME environment variable to the location of the jdk (on Ubuntu 10.04 this is: /usr/lib/jvm/java-6-openjdk), then reconfigure (./configure API=java ...) and reinstall.  

Ignore the SWIG warnings (there are lots). 

Make sure to set your LD_LIBRARY_PATH to $RSFROOT/lib .

If you want to include additional Java packages, you can set them using your shell's CLASSPATH variable.  This environment variable is now automatically passed onto all Java classes in SCons.

The installation can be tested using the example demonstrating the new API in api/java/test .

===Matlab API===
Besides Matlab itself, you need Mex, which compiles C code into regular Matlab functions. Use the <tt>MATLAB</tt> and <tt>MEX</tt> environment variables to specify their paths if they are installed, but not found.
===Octave API===
The Octave function compiler (<tt>mkoctfile</tt>) is sometimes bundled in a separate package, so it may be missing from the Octave installation.

===Python API===
This API requires [http://www.swig.org/ SWIG], [http://numpy.scipy.org/ numpy] and the Python development kit. Numpy requires Python 2.4 or newer (i.e. RHEL 5 or newer). However, these dependencies are unnecessary for the common case when Python is just used as [http://en.wikipedia.org/wiki/Glue_language glue] to create chains of programs, and it only needs to read the RSF header, and not the binary. To allow Python [http://en.wikipedia.org/wiki/Meta-programs metaprograms] in madagascar to function, and programming in this style to be done, a fallback development kit implementing only the header-related functionality will be installed in the lack of these dependencies.

===Python modules in user space===
Python is an evolving language. Many large systems have old versions for stability reasons, and administrators of such large systems tend to not install all software users may wish, and to not allow access to rpm either. To install a module in your user space, download the tarball, unzip it, cd into the directory and run: 

<pre>python setup.py install --prefix=/path/to/your/place</pre>

The installer will create a subdirectory named <tt>lib</tt>, or <tt>lib64</tt> under the directory above. These <tt>lib*</tt> dirs will have a directory named <tt>python</tt>, or <tt>python2.3</tt> for example, and those will have a subdirectory named <tt>site-packages</tt>. Add all paths to these <tt>site-packages</tt> subdirectories in your <tt>PYTHONPATH</tt> environment variable. Some (<tt>numpy</tt>) may create a <tt>bin</tt> directory that needs to be added to <tt>PATH</tt>.