Groke 2.0 - Released May 15, 2007

Groke is free for educational/research purposes. For commercial or non-educational use author's written permission must be granted from the authors.
The Groke program and documentation cannot be sold, redistributed, reproduced or altered without permission of the authors.
The authors accept no liability whatsoever resulting from the use of the program.

When using Groke 2.0, the following references must be acknowledged:

• E.J. Ahn, M. Ave, M. Cavaglià and A.V. Olinto, Phys. Rev. D68, 043004 (2003) [arXiv:hep-ph/0306008]
• E.J. Ahn and M. Cavaglià, Phys. Rev. D73, 042002 (2006) [arXiv:hep-ph/0511159]
• M. Cavaglià and A. Roy, QCD and spin effects in black hole airshowers, University of Mississippi preprint (2007)

Official builds

Precompiled Linux (x86) - tar.gz format (821 KB).   Download
Precompiled Mac (OS X) - tar.gz format (1039 KB).   Download

System requirements (Linux)

1. Operating system: Red Hat Linux 8.0 or SuSE 8.0 (or later/equivalent recommended)
2. Intel pentium class processor (233 MHz or faster recommended)
3. 512 MB of RAM (or larger recommended)
4. 200 MB of free hard disk space for high-quality simulations (or larger recommended)
5. Gzip and Tar archive packages (available free at http://www.gzip.org/ and http://www.gnu.org/software/tar/tar.html)
6. AIRES 2.8.0 package (available free at http://www.fisica.unlp.edu.ar/auger/aires/)

System requirements (Mac)

1. Operating system: OS X 10.2, 10.3 or 10.4
2. 512 MB of RAM (or larger recommended)
3. 200 MB of free hard disk space for high-quality simulations (or larger recommended)
4. Gzip and Tar archive packages (available free at http://www.gzip.org/ and http://www.gnu.org/software/tar/tar.html)
5. AIRES 2.8.0 package (available free at http://www.fisica.unlp.edu.ar/auger/aires/)

Installing

To install the Groke Linux distribution follow these steps:

1. Create a directory named groke (mkdir groke) and change to that directory (cd groke)
2. Click the link to download the installer file (called groke_Linux.tar.gz)
3. Decompress the archive with the following command: tar -zxvf groke_Linux.tar.gz

To install AIRES for the x86 platform follow the AIRES instructions included in the AIRES package.

To install the Groke Mac OS X distribution follow these steps:

1. Create a directory named groke (mkdir groke) and change to that directory (cd groke)
2. Click the link to download the installer file (called groke_Mac.tar.gz)
3. Decompress the archive with the following command: tar -zxvf groke_Mac.tar.gz

Installing AIRES for the Mac OS X platform requires a few additional steps as the latter is not supported in the AIRES configuration file config:

1. Select LxAlpha as a platform
2. For OS X 10.2 and 10.3 specify g77 as the FORTRAN compiler, gcc as the C compiler and libtool -c instead of lar - cr as the archive creator. For OS X 10.4 use gcc-3.3 rather than just gcc as the C compiler

A Fortran compiler that supplies some dynamic libraries can be obtained from http://hpc.sourceforge.net

Running

1. To start groke, change to the directory where you installed it and run the ./groke.exe (linux) or ./groke.x (Mac) command.
2. The input file groke.inp contains the physical parameters of the simulation. To change the physical parameters simply edit the groke.inp file.
3. The groke.exe (groke.x) script creates a subdirectory results where the results of the simulation are stored. The name of the subdirectory can be changed by editing the groke.exe (groke.x) file.

Note: The groke.exe (groke.x) script uses the bash shell. If you're not using bash, either use the bash shell or edit the file accordingly.