Installation

The JOYCE package runs on any Linux platform. The go.joyce script, which is devised for easily handling the program, is intended to work under tcsh shell. Notwithstanding bash users can find in the source directory an equivalent go.joyce.sh script, in the following all examples will be referred to the original go.joyce.

The only requirement for JOYCE  installation is a Fortran compiler, such as gfortran, ifort or any other.
Please note that the currently implemented compilers are:
gfortran - free GNU compiler (default)
ifort - Intel compiler, available for academic use
pgf90 - Portland compiler

To install the program you should follow the next steps:

1. Download the tarball Joyce.v3.0.tgz
2. Unzip and untar the JOYCE package tarball, Joyce.v3.0.tgz, with the command:
   $>$ tar -xzvf Joyce.v3.0.tgz

3. Set the environmental variable JOYCE to where the program was unpacked, e.g. if the program was unpacked in the user home directly write (in $tcsh$ shell):
   $>$ setenv JOYCE /home/username/Joyce.v3.0
   Alternatively, you can add the aforementioned variable definition in your login script.

4. Copy the Joyce main script executable (go.joyce in your bin directory (/home/$USER/bin) or in any other directory contained in your PATH:
   $>$ cp $JOYCE/bin/go.joyce /home/$USER/bin/.

5. Compile the program with the command
   $>$ go.joyce -f
   to use gfortran default compiler. Just type
   $>$ go.joyce
   to see other compiling options.