===== Quick Start Guide for USER-MESO =====
If you have any question/problem regarding the setup process, feel free to contact [[yuhang_tang@brown.edu|Yu-Hang]].

----
==== Download ====

You can either download the source code as a tar ball or (preferably) use [[https://subversion.apache.org/|subversion]]:

**Tar ball:**

<code bash>
wget http://www.cfm.brown.edu/repo/release/USER-MESO.tgz
tar xzf USER-MESO.tgz
</code>

**Subversion:**

<code bash>
svn co http://www.cfm.brown.edu/repo/release/USER-MESO/ USER-MESO
</code>

----
==== Compilation ====

=== Prerequisites ===
  * A MPI compiler, e.g. OpenMPI or MPICH.
  * CUDA Toolkit

=== Compilation ===

Short version:

<code bash>
$ cd USER-MESO
$ make clean-all     # delete temporary files if any was left from last compilation
$ make yes-molecule  # dependency
$ make yes-user-meso # configure the USER-MESO package
$ make meso
</code>

Long Version:

First, make sure that mpic++ and nvcc are available by
<code bash>
$ which mpic++
$ which nvcc
</code>
You should be expecting output that looks like
<code bash>
$ which mpic++
/usr/lib64/mpich/bin/mpic++
$ which nvcc
/usr/local/cuda/bin/nvcc
</code>
If you are sure that MPI and CUDA are present, but still get messages like
<code bash>
/usr/bin/which: no mpic++ in (/usr/local/bin:/bin:/usr/bin)
</code>
Then adjust **''Makefile.meso''** located in **''USER-MESO/MAKE''** by setting the **''CC''** and **''MPICXX''** environment variables to be the absolute path to nvcc and mpic++, respectively.

----

==== Creating Input Script ====