INSTALL GUIDE FOR HAMMURABI
---------------------------
The Hammurabi code is a C++ code for simulating 
Galactic synchrotron emission, and UHECR propagation, 
it is described in Waelkens et al. A&A 2009 and it 
is distributed under a GNU free software license 
(http://www.gnu.org/licenses/gpl.txt).

Currently the installation is manual. Please feel free 
to contact Tess Jaffe at tess.jaffe@cesr.fr if you are 
having trouble from point 2 onwards (we are not likely to 
be able to help you much with 1). Also, if you find any
bugs, please let us know!
The code release used for Waelkens et al. A&A 2009 is 
hammurabi_1.03.tar. Further updates will be made available here. 
If you have a previous version and you have been altering the code you 
might wish to fix the bugs yourself. Instructions are here.

------------------------------------------------------------------
Install Hammurabi:
1. Install the following necessary packages (if you dont have them already):
- HEALPix (the C++ version!) (http://healpix.jpl.nasa.gov/)
- FFTW (http://www.fftw.org/)
- GSL (http://www.gnu.org/software/gsl/)
This is likely to take the longest.
2. Install the fortran NE2001 altered code. NOTE the original version is 
available at: 
http://www.astro.cornell.edu/~cordes/NE2001/  or,
http://rsd-www.nrl.navy.mil/7213/lazio/ne_model/.
We changed it a bit so it can interface with 
the Hammurabi code.
(An externally generated thermal electron density file can
also be read in. See the big_parafile in the run directory
after the installation is done.)
3. Unpack the hammurabi_1.03.tar file in the desired directory.
4. Set the correct paths for all packages in the "Makefile".
5. Do "make hammurabi".
You are ready to go!! (e.g. go to the run directory and do 
./hammurabi small_parafile)
------------------------------------------------------------------
Install helical field generator (Garfields):
Appart from the Hammurabi inbuild Gaussian random field generator 
we also present a stand alone code which can not only generate a 
Gaussian random field, but also make it divergenceless and helical. 
The code is called Garfields (Kitaura&Ensslin 2007 astroph-0705.0429). 
See the instructions for installation and 
how it interfaces with Hammurabi (also useful if you plan to use your 
own field generator).
------------------------------------------------------------------
------------------------------------------------------------------
That's it! We hope it's useful!!
(and... click here for a big picture of the original code)


Tess Jaffe and Andre Waelkens