Getting and Compiling bamps

Getting the source code

The bamps source code is hosted on the SVN server of the TPI, reachable at svn.tpi.uni-jena.de. You will need an SVN client to get the code (most linux distributions come with svn preinstalled).

Before you download the code, it is recommended to set a few SVN options to let SVN know about a few file types and to prevent unnecessary recompilation of certain files. To do this, edit the file .subversion/config in your home directory:

.subversion/config
[miscellany]
use-commit-times = yes
enable-auto-props = yes

[auto-props]
*.pdf = svn:mime-type=application/pdf
*.nb  = svn:mime-type=application/mathematica
*.eps = svn:mime-type=application/postscript
*.ps  = svn:mime-type=application/postscript

To check out the most recent version, use

svn checkout https://svn.tpi.uni-jena.de/svn/numrel_group/projects/bamps --username <your username>

You should then have a fresh bamps checkout.

Compiling

You can compile bamps with default options by navigating into src and running make. This will create the bamps executable in the exe directory. A complete compilation might take upwards of 45 minutes, so be patient. To speed up the process, you can specify the -j option for make to use multiple processes for compiling files in parallel. Be aware that splitting the compilation across too many processes may result in dependencies not being met in time. If this happens, simply run make again. You can also run something like

make -j10 || make -j10

to automatically restart if make reports an error.

To modify the compilation options, you can edit hosts.mk to change the default options (be mindful not to commit such changes), or you can add a set of options for a specific machine.

After compiling you are ready to run bamps.