Here is the list of packages to install prior to Lorene for various Linux distributions:
Softwares absolutely required by LORENE:
the GNU make
tool: this is the default make on most linux
systems, it is
often called gmake on
some
other UNIXs (see also GNU
web site for 'make').
a C++ compiler: any compiler compliant to the ISO norm of
C++ should
be
able to compile LORENE. If it supports the '-M' option (e.g.
gcc precompiler does) to produce dependencies in makefiles it is
better,
otherwise you need makedepend
to create dependencies in makefiles (Note: on Linux systems, makedepend usually comes
along with the X11 development packages).
a Fortran 77 compiler: a small part of LORENE is written in Fortran 77, namely the Fast Fourier Transform used by the spectral method and the solver of Poisson equation in 2-dimensional space. In future releases of LORENE, these parts should be rewritten in C++, so that a Fortran 77 compiler will no longer be necessary to compile LORENE. Note: the Fortran 95 compiler of the GCC 4.x suite, namely gfortran, works well (no need to downgrade to the old g77).
CVS (Concurrent Versions System): The internet access to LORENE sources is performed via a CVS server. CVS is a powerful tool to manage versions and develop over the network. CVS is a free software under the GNU General Public License. It comes in standard with many Linux distributions. If you don't have it on your system, you can download it from the CVS web site.
LAPACK
(Linear Algebra PACKage): LORENE
uses the LAPACK library to perform linear
algebra
operations. LAPACK must therefore be installed on your system. LAPACK
is
a public domain software and can be downloaded from the LAPACK web site.
If you are using Linux,
note
that LAPACK comes along with many Linux distributions.
NB: the
development version of LAPACK is required (package usually named -dev or -devel), in addition to the binary
library.
GSL
(GNU Scientific Library): LORENE
uses the
GSL library to compute Bessel functions involved in some elliptic
operators.
GSL must therefore be installed on your system. GSL is a public domain
software
and can be downloaded from the GSL web site.
If you are
using Linux, note that GSL comes along with many
Linux distributions.
NB: the
development version of GSL is required (package usually named -dev or -devel), in addition to the binary
library.
Optional FFT library for LORENE:
FFTW3 (Fastest
Fourier Transform in the West):
By
default, LORENE uses a Fortran Fourier
Transform. It is possible to use a faster library written in C, namely
FFTW,
version 3 (older versions are incompatible!) that can be downloaded
from
the FFTW Web site.
If you are using Linux, note that FFTW3
comes along
with
most of distributions. To use it, you will have to set the appropriate
variable FFT_DIR
to FFTW
in the
local_settings file.
NB: the
development version of FFTW3 is required (package usually named -dev or -devel), in addition to the binary
library.
Software required only to produce graphical outputs:
PGPLOT: LORENE uses the PGPLOT library for
producing 2-D
graphical
outputs. You can use LORENE without PGPLOT provided that you
don't
perform any call to the routines Lorene/C++/Source/Non_class_members/Graphics/des_*
However,
to fully benefit from
LORENE, it is recommended to install PGPLOT on your system, from the PGPLOT
web site or from the pgplot package if it exists for your distribution (e.g. pgplot5 for Ubuntu).
Here
is some guide for a quick
installation of
PGPLOT
on a Linux computer. Note
that a
small correction must be applied to the makefile if you are using gcc
4.0 (or above)
(remplacement of g77
by gfortran,
cf. details in the above guide).
OpenDX: this powerful software is used to produce 3-D visualization of various Lorene objects. The corresponding OpenDX scripts are located in the directory Lorene/Visu/OpenDX.
OpenDX can be freely downloaded from the web page http://www.opendx.org/.
Softwares required to generate LORENE HTML documentation:
Doxygen: LORENE uses the software Doxygen to produce LaTeX and HTML documentation from the source files themselves (class declarations in Lorene/C++/Include/*.h). You can of course compile and run LORENE codes without Doxygen being installed on your system. But to write any piece of code, it is necessary to have LORENE documentation. Therefore, it is strongly recommended to install Doxygen on your system, if you do not already have it (Doxygen comes along with many Linux distributions). Doxygen is a free software under the GNU General Public License. You can download it from the Doxygen web site.
LaTeX: the text formatting system TeX/LaTeX is required by Doxygen to generate the PostScript documentation, as well as to treat the mathematical formulae in the HTML documentation.