2. Installation

All 3rd party libraries except Qt are included in Sesarray package (lapack, fftw, libf2c). Qt must be built before starting Sesarray installation.

Fastest method

If you are running a recent Linux distribution you have Qt 4 available as a binary package. Use the specific tools (yast, rpm, apt, emerge...) provided by your distribution to install the Qt packages: qt and qt-devel (naming can be a little different).

Once these packages are ready, you can check if Qt build tools are really available. Open a terminal:

$ qmake -version
QMake version 2.01a
Using Qt version 4.3.3 in /usr/lib64/qt4
$ lupdate -version
lupdate version 4.3.3

If you get these answers (or more recent version), you can jump directly to the installation of Sesarray. If not, you must first solve this problem (contact your system administrator) before proceeding to Sesarray installation. If the version numbers are lower than those shown above, consider compiling Qt 4 manually (see next section).

Longest method

Compile Qt 4 from scratch only if you are working with an old Linux distribution or if you have other good reasons to do it. It is time consuming and generally requires third party package installation (particularly 'devel' packages for distribution based on binary packages).

Unix like systems (Linux, Mac OS X, ...)

$ tar xvfpz sesarray-src-X.X.X.tar.gz
$ cd sesarray-src-X.X.X

A configure script creates the necessary Makefiles. Usual options for configure are available (option '-help' for details, '-prefix' to change installation directory).

$ ./configure

You will be prompted for the license agreement. You are ready to compile and to install the package:

$ make install

Building sesarray package is useless under Windows and time consuming. Prefer the binary release if you just want to use the software and do not want to loose your time. This section might be of interest for developpers or maintainers of this software.

This tutorial guides you through all steps required for building sesarray package from sources. Windows does not contain by default all necessary development tools. Hence, we first guide you through their installation before the installation of the package itself.

Contents:

• Drag the MS-DOS terminal icon from the Start menu ( usually in Programs/Accessories ) to your Desktop or anywhere else.
• Right click on it and select "Properties"
• Add " /K c:\sesarray\setenv.bat" to the target. The target must be like that:

      %SystemRoot%\system32\cmd.exe /K c:\sesarray\setenv.bat
    

• Modify the starting folder to "c:\sesarray"
• Close the dialog box
• Rename the MS-DOS terminal shortcut to "sesarray-term"
• Create folder c:\sesarray
• Create a new text file called c:\sesarray\setenv.bat containing:

     set PATH=c:\mingw\bin;c:\qt\bin;%PATH%
    

• To test the terminal, double click on "sesarray-term", you should have a terminal waiting for commands with the correct environment. Type echo %PATH% to check it. It should be something like:

       c:\mingw\bin;c:\qt\bin;c:\WINNT\system32 ...etc
    

• Change the PATH environment variable to include Qt path
• Create file ~/.profile with the following lines (e.g. with vi):

      $ vi ~/.profile
    

• Inside vi, type 'i' to start edition and insert the next line:

      export PATH=/c/qt/bin:$PATH
    

• To save and exit, hit 'ESCAPE', then type ':wq'
• Restart MSYS and check that you can start qmake for instance:

      $ qmake -v
      QMake version: 2.00a
      Using Qt version 4.1.1 in C:\qt\lib
    

With the last step, you were probably happy to see geopsy.exe ready in C:\Program Files\sesarray\bin and you double-clicked on it. Desesperated you are because of missing dlls (mingwm10.dll, QtCored4.dll or QtGuid4.dll).

To correct this, you must copy these dynamic libraries into a directory listed in your system %PATH%. Either add C:\mingw\bin and C:\qt\bin to the system path (see Start Menu/control panel/System/Advanced/Environment Variables), or copy these libraries to C:\Program Files\sesarray\bin, close to all other sesarray binaries. With the last method, you can copy the whole directory C:\Program Files\sesarray to other Windows computers without much effort

Thanks for your patience!