Jive3D release 1.1 - Installation instructions

Copyright (C) J.W.D. Hobro 1997, 2000

To install Jive3D, first obtain the archive Jive3D1.1.tar.gz, decompress it
with:

  gunzip Jive3D1.1.tar.gz

and expand the archive:

  tar xvf Jive3D1.1.tar

Go into the src directory:

  cd Jive3D1.1/src

and edit the Makefile. You will need to set the three flags at the top of this
file for your system.

F90 is the name of the Fortran 90 compiler to use

FLAGS contains any compilation flags required (e.g. for optimisation).
Optimisation compilation flags can improve run times by a factor of 2 or more.
If compiling with optimisation options, however, check that the optimised
executables do not generate unstable results by comparing them with results
generated by unoptimised executables.

LINK_LAPACK is the compilation flag used to link in the LAPACK routines, which
may vary from system to system (check the LAPACK documentation for your system)

Typical values of the flags are as follows:

F90 = f90
FLAGS = -O3
LINK_LAPACK = -llapack

Once you have set these flags in the Makefile, compile the executables:

  make all

This makes each utility in turn and places the executables in the directory
"Jive3D1.1/bin". The only utility that requires LAPACK during linking
("calcerr") is last in the list, so if this fails to link properly, all the
other executables will be generated successfully.

Copy the executables from Jive3D1.1/bin to a directory somewhere in the
default system path (e.g. /usr/local/bin ).

Finally, clean up the temporary files produced during compilation with

  make clean

The scripts provided for plotting the output from Jive3D are in the directory
Jive3D1.1/scripts . These scripts contain flags that may be edited during
use, so they must be copied into the working directory when Jive3D is being
used.

Jive3D has been compiled and tested in the folowing environments:

Linux: Pacific-Sierra Research vf90 Version 3.4
SunOS: WorkShop F90 Compiler 4.2 10/22/96 FORTRAN 90 1.2
IRIX:  MIPSpro F90 compiler (Ragnarok Compilers): Version 6.2
IRIX:  MIPSpro 7 F90 Compiler: Version 7.3.1.1m