--------------------------------------------------------------------------------
DOUAR-WSMP v0.1 - 23/03/2011
--------------------------------------------------------------------------------

Installation instructions
--------------------------------------------------------------------------------
There are several sets needed to build DOUAR-WSMP, the number of which varies
depending on the compiler selected and libraries used.

In general, the process is:
1.  Select an appropriate Makefile.inc from the available options (or create
    your own) and copy that file to Makefile.inc in the base DOUAR directory.
2.  Edit the Makefile.inc to ensure the compiler and library locations are
    correct.
3.  Copy your desired boundary condition file to define_bc.f90 in the DOUAR base
    directory.
4.  Build DOUAR by running 'make all'. If successful, this will create a binary
    called 'douar_wsmp'. If unsuccessful, consult the *.compile files in the
    base directory and subdirectories, or the douar_wsmp.link.std* files.
5.  Build the post-processing program by changing to the VTK directory and
    running 'make all'. If successful, this will create a binary called 'post'.
6.  The following environment variables should be set prior to running a
    DOUAR-WSMP calculation:
        MALLOC_TRIM_THRESHOLD_=100000000    (for WSMP)
        MALLOC_MMAP_MAX_=0                  (for WSMP)
        MKL_NUM_THREADS=1                   (if using the Intel MKL)
        ulimit -s 131072                    (sets stack size, larger values may
                                            resolve crashes in DOUAR-WSMP)
--------------------------------------------------------------------------------

Makefile.inc.* - Makefile include files
                 Known working combinations of compilers and libraries
                 (<compiler; MPI; additional libraries>)
--------------------------------------------------------------------------------
Makefile.inc.geodyncomp.intel.mpich2 (ifort/icc v12; MPICH2; WSMP, Intel MKL)
Makefile.inc.geodyncomp.intel.openmpi (ifort/icc v12; Open MPI; WSMP, Intel MKL)
Makefile.inc.gpc.intel.intelmpi (ifort/icc v11/12; IntelMPI; WSMP, Intel MKL)
Makefile.inc.gpc.intel.mvapich2 (ifort/icc v11/12; MVAPICH2; WSMP, Intel MKL)
Makefile.inc.gpc.intel.openmpi (ifort/icc v11; Open MPI; WSMP, Intel MKL)
Makefile.inc.mahone.pgi.openmpi (PGI v8; Open MPI; WSMP, ScaLAPACK, BLACS)
Makefile.inc.placentia.intel.mvapich2 (ifort/icc v12; MVAPICH2; WSMP, Intel MKL)
Makefile.inc.placentia.intel.openmpi (ifort/icc v12; Open MPI; WSMP, Intel MKL)
Makefile.inc.placentia.pgi.openmpi (PGI v8; Open MPI; WSMP, ScaLAPACK, BLACS)

Obsolete Makefile.* from previous code versions (Available for reference)
                 (<compiler; MPI; additional libraries>), when known
--------------------------------------------------------------------------------
Makefile.inc.mahone.orig (similar to Makefile.inc.mahone.pgi.openmpi)
Makefile.inc.p690 (DOUAR-WSMP for IBM p690 running AIX)
Makefile.cray (DOUAR-WSMP for Cray)
Makefile.ifort (DOUAR-MUMPS for Linux; ifort/icc)
Makefile.macosx (DOUAR-MUMPS for Mac; ifort/icc)
Makefile.macosx.cedric (DOUAR-MUMPS for Mac)
Makefile.pathscale (DOUAR-WSMP for Linux; Pathscale)
--------------------------------------------------------------------------------

Makefile - List of source files to compile
--------------------------------------------------------------------------------
Makefile (For use with DOUAR-WSMP v0.1)

Obsolete Makefiles for reference
--------------------------------------------------------------------------------
Makefile_Cedric
Makefile_DavidWhipp
Makefile_Jean
--------------------------------------------------------------------------------