See the prerequisites and the download instructions first.
1/ Set of the environment variable HOME_LORENE
Enter to Lorene root directory which has just been created by the CVS checkout command
cd Loreneand define HOME_LORENE to be the full path name of this directory:
setenv HOME_LORENE $PWD
setenv HOME_LORENE /??/Lorene in .cshrc or .tchsrcwhere /?? denotes the full path to the Lorene directory. This avoids to set it manually after each login.
export HOME_LORENE=/??/Lorene in .bashrc
2/ Defining the parameters specific to your system
Before to launch the compilation of Lorene, you have to specify which compilers to use, with which options, and where are located some system libraries. This information should be passed to Lorene via the file $HOME_LORENE/local_settings.
This file is the only one of the Lorene distribution which is architecture/system dependent. It will be included by all the Lorene Makefiles, which are fully architecture independent.
Some templates files are provided in the directory Local_settings_examples for
To create the file $HOME_LORENE/local_settings, you simply have to copy one of these files into local_settings by typing, e.g. under Linux
cd $HOME_LORENEYou may then edit local_settings to adapt it to some special features of your system implementation, e.g. to use FFTW instead of the standard Fortran FFT, changing the FFT_DIR variable from FFT991 to FFTW3.
cp Local_settings_examples/local_settings_linux_gcc-4.4 local_settings
The compilation of Lorene is launched via the command (in the HOME_LORENE directory)
makeThis will first create the Lorene documentation, including the HTML reference guide, provided Doxygen is installed on your system.Then the C++ part of LORENE is compiled, followed by the Fortran 77 one.
To read Lorene's reference manual, open the file $HOME_LORENE/Doc/refguide/index.html in a web browser.
4/ Testing the installation
If everything went well with the compilation, you can check the link with LAPACK and PGPLOT libraries with
make testThis will produce three executables:
: checks LAPACK and PGPLOT
$HOME_LORENE/Test/test_lapack : checks LAPACK only
$HOME_LORENE/Test/test_pgplot : checks LAPACK and PGPLOT
5/ Upgrading the installation
As a research software, LORENE is under permanent development. You should therefore run from time to time the commands
cd $HOME_LORENEto get the latest version of LORENE.
cvs update -d
The script $HOME_LORENE/lorene_up contains the above commands, so that it is equivalent to type
Back to LORENE home page