Installation:Linux

Distribution packages

(not yet available)

The easiest and fastest way to install geopsy, dinver and other applications is to use the packaging system specific to your Linux distribution, if available. This binary distribution has been introduced at the end of year 2008. Currently only a few distributions are supported:

• ubuntu
• Fedora
• openSUSE
• gentoo

Compilation from sources

This is the primary distribution method always available as a backup if the binary method fails or is not available for your Linux system.

gcc

A decent gcc version is required primarily for Qt. The recommended versions are listed here. To check the version of your compiler:

 g++ --version
 #  g++ (GCC) 4.1.2 (Gentoo 4.1.2 p1.1)

Fortran support is required. Some codes written in Fortran are included (less than 0.1% of the total).

 gfortran --version
 #  GNU Fortran 95 (GCC) 4.1.2 (Gentoo 4.1.2 p1.1)
 #  Copyright (C) 2006 Free Software Foundation, Inc.

Qt

Qt libraries and development tools must be available. Only Qt releases posterior or equal to 4.5.0 are supported. To test if Qt is already installed:

 qmake -version
 #  QMake version 2.01a
 #  Using Qt version 4.5.0 in /usr/lib64/qt4
 lupdate -version
 #  lupdate version 4.5.0

If Qt 4.5.0 (or a more recent version) is installed, you can jump directly to Lapack. If not you must first install Qt.

• Installing Qt binary packages, if they are available for your distribution
• Compiling Qt from source

Lapack

Linear Algebra PACKage.

Lapack >= 3.0 is required. The best option is to install the package shipped with your distribution.

• ubuntu: liblapack-dev

 apt-get install liblapack-dev

• Fedora: lapack-devel

 yum install lapack-devel

• openSUSE: YaST graphical interface
• gentoo: sci-libs/lapack

 emerge -av lapack

Note: this external dependency is required for all releases >= 2.1.0. For all previous releases, 'Lapack' libraries were shipped with Geopsy packages.

FFTW

Fastest Fourier Transform of the West.

fftw >= 3.0.1 is required. The best option is to install the package shipped with your distribution.

• ubuntu: libfftw3-dev

 apt-get install libfftw3-dev

• Fedora: fftw3-devel

 yum install fftw3-devel

• openSUSE: YaST graphical interface fftw3-devel
• gentoo: sci-libs/fftw

 emerge -av fftw

Note: this external dependency is required for all releases >= 2.1.0. For all previous releases, 'FFTW' libraries were shipped with Geopsy packages.

Download

Your platform is now ready for the compilation Geopsy packages themselves. First download the correct archive.

Compilation

Extract files from dowloaded archive.

 tar xvfpz geopsypack-XXitems-src.tar.gz

Enter the source directory and configure. '-prefix' option defines the installation directory.

 cd geopsypack-XXitems-src
 ./configure -prefix /usr/local/Geopsy.org

Other options are documented with option '-h' or '-help'.

 ./configure -h

If successful, you can compile. In case of failure, see Installation:Troubleshooting for common errors and their solutions.

 make

It takes from a few minutes up to 20 minutes if the full list of packages are included. It also depends on your computer performances. Finally, you can install the packages, usually reauiring root permissions (through su or sudo)

 sudo make install

Variable environment

To finish the installation, make sure that the destination directory is listed in your PATH

 echo $PATH

In ~/.profile (if your shell is bash, ksh, zsh or sh), add the following lines:

 export PATH=/usr/local/Geopsy.org/bin:$PATH

For bash, ~/.bashrc is also of common usage

In ~/.login (in case your shell is csh or tcsh), add the following line:

 setenv PATH /usr/local/Geopsy.org/bin:$PATH

If you use a different shell, please modify your environment variables accordingly.

Errors in the make

Other packages are needed for the compilation of geopsy and may not be installed by default on your distribution. In case of errors in the make, check that the function causing the error is properly installed. For instance, for Ubuntu, g++ has to be installed additionally to gcc, as well as zlib1g-dev.