next up previous contents index
Next: 3.2 MacOSX Up: 3. Installation Previous: 3. Installation   Contents   Index


3.1 Unix (SOLARIS and Linux)

Solaris: The SEISAN programs have been compiled on Solaris 7 using Sun Workshop 5, which means you have to recompile if you use an earlier version of the operating system or compiler. If you can recompile on Solaris, please do so! The programs on Solaris are compiled dynamically, which means not all system and compiler libraries are included in the executables. If you are running Solaris, the system libraries are normally installed, but the Sun system compilers might not be installed. If the compilers are not installed, you have the following options: (1) you install the Sun workshop compilers, license is not needed, since only the libraries are required; (2) you install the required libraries, which are part of the Solaris SEISAN distribution (instructions below).

Linux: The programs have been compiled under Redhat Linux7.2 using the GNU compilers gcc and g77. It is recommended to recompile the programs, since otherwise the programs might not run on your Linux distribution. In the Redhat distribution of Linux the Fortran compiler is not part of the standard distribution, it has to be installed (see your Linux manual for instructions). THE USER ACCOUNT MUST BE SET UP TO USE csh, tcsh (use SEISAN.csh) or bash (use SEISAN.bash), in order for the SEISAN scripts to work. Note that in the following SEISAN.csh stands for both SEISAN.csh and SEISAN.bash. Otherwise the scripts need to be adopted to the shell used.

Instructions

The first step is to install the distribution, the procedure is the same for all Unix platforms.

1. Get tar file

Copy the distribution file for your platform from CD or transfer it through FTP or from the web site to the SEISAN top directory, this could be a directory seismo under the home directory.

2. Decompress

gunzip seisan_version_system.tar.gz

There should now be the uncompressed file in your directory (without .gz).

3. Install SEISAN

tar xvf seisan.tar

Check that the SEISAN directories have been created.

If SEISAN has been installed without executable files, they can all be generated with the command `make all' from the PRO directory. On Sun this requires that the Sun compilers be installed, on Linux/MacOSX it requires the GNU Fortran compilers (g77, only gcc before version 4.0; now gfortran). See also section on compilation (3.8).

Install Workshop libraries

In the SUP directory of the Solaris distribution the file sun_ws_lib.tar.Z includes the libraries that are needed to run SEISAN on Solaris in case the compilers are not installed. The file is a compressed tar file. The files can be extracted with uncompress sun_ws_lib.tar.Z and then tar xvf sun_ws_lib.tar. The library files can be stored in any directory in the system, but the environmental variable LD_LIBRARY_PATH has to be set accordingly. If you are using the C-shell, this can be done by adding to the .cshrc file the line setenv LD_LIBRARY_PATH /path/:$LD_LIBRARY_PATH. This would add /path/ (which is the path to where the libraries are) to LD_LIBRARY_PATH, which normally is already defined.

4. Regenreate the IASP travel time tables

On at 64 bit computer the IASP files in DAT must be regenerated if you have the files from a 32 bit computer, with the programs REMODL and SETBRN otherwise HYP will crash.

5. Set system parameters

If you are doing an update, some of the following settings can be skipped.

Activate SEISAN:
csh/tcsh shell :
In your .cshrc file, the aliases and paths used by SEISAN are defined by adding the line
source /home/seismo/COM/SEISAN.csh
where ../seismo is the directory below which SEISAN has been installed. The SEISAN.csh script file assumes that you are running either csh or tcsh as your shell.
bash shell :
If you are using the bash shell add this line to your .bashrc file :
. /home/seismo/COM/SEISAN.bash
bash might include a select program, if that is the case on your pc you also need to add this line in your .bashrc file :
alias select="/home/seismo/PRO/select"
to use the SEISAN SELECT program.
If you are using another shell you need to modify the script accordingly or change the shell. It is assumed that X-windows is installed.

SEISAN path for programs:
In order for programs and subroutines to know the path to the SEISAN program directory, this must be defined in the file .SEISAN in COM. Edit that file and set the environmental variable SEISAN_TOP to the name of the top directory, meaning the directory structure below and including seismo e.g. /top/users/seismo. This variable is then used to set the path to SEISAN directories.

Search path for libraries:
To run the NANSEI conversion program under Solaris, the SEISAN LIB directory needs to be included in the environmental variable LD_LIBRARY_PATH. The LIB directory as default is already added to the library search path in the SEISAN.csh file.

SEISAN path for databases, parameter files etc:
The SEISAN database can be under the same top directory as programs, however it can also be different. This is practical if several users have their own databases, but use the same software. Set environmental variable SEISAN_TOP to top directory e.g. /top/users/seismo.

SEISAN agency:
In SEISAN.csh also set the environmental variable AGENCY (upper case) to your 3-letter agency code (upper case). This variable is only used by program MACROIN from EEV in connection with entering macroseismic data so for most users ignore this setting.

SEISAN default database:
To locate the default database directory (here BER) set environmental variable DEF_BASE in SEISAN.csh. If not set, the name AGA is used. The data bases are found under SEISAN_TOP.

SEISAN editor used in EEV:
The default editor is vi, any other editor can be set with the environmental variable SEISAN_EDITOR.

SEISAN calibration file directory:
By default, calibration files are in CAL, but they can be in a directory set with variable LOCAL_CAL. The directory name must be complete like /home/users/calibration/

SEISARCH
Gives the architecture, can be either solaris, linux32, linux64, macosx or windows. Used in Makefile when compiling.

SACAUX
Path to SAC aux directory, required by the SAC routines for reading and writing, although not really used.

SACLIB
Specify path and filename to SAC libraries, only needed when you compile programs (Unix) and you have the libraries installed on your system.

Printer for Postscript plots:
The hard copy files from programs are sent to the printer from within the programs using the standard lpr command. In the SEISAN.csh file, define lpr using the standard environmental variable PRINTER. Remember that the printer must accept Postscript. PostScript files can also be viewed and printed on most printers outside SEISAN using GhostView, however in that cases files cannot be printed from within a program.

Scaling for Postscript plots:
By default, plots will be in A4 size. This can be changed by setting the environmental variables
SEISAN_PSSCALE_X and SEISAN_PSSCALE_Y. The default for A4 size is 1.0 for both variables. For Letter size the Y-scaling can be set to 0.9.

Seisan Extension:
User specific code can be implemented by making use of the environmental variable SEISAN_EXTENSION. The idea is that programs read this variable, if set to the user specific string, the user's source code will be used instead of the default. An example could be the computation of error ellipses. Currently used codes are: BGS.

6. Testdata The testdata set can be extracted from the file testdata_X.Y.tar.Z. Use programs uncompress and tar to extract the data in the SEISAN top directory (keep subdirectory structure). SEISAN has 2 test events always installed with the software (from June 1996) so it is always possible to test SEISAN without installing test data. See the SEISAN tutortial, which only uses the 2 test evenrts.

Dimensions

Most dimensions are set in file seidim.inc in the INC directory. In order to change dimensions, first change in the include file and then recompile the whole SEISAN distribution. The most important dimensions are:

Number of points in one trace 2 400 000
Number of points in memory buffer 30 000 000
Number of lines in NORDIC format file 10 000
Maximum number of traces in one plot 1 000
Maximum number of events in one month 200 000
Maximum number of calibration files 4 000
Maximum number of epicenters in epimap 90 000
Maximum number of lines in index file made with dirf: 99 999

SEISAN has been tested with much larger dimensions, like 10 000 000 for number of points in one trace, however large dimensions might slow down the speed due to swapping (particularly if memory is not large) so a smaller dimension has been chosen. For continuous data, SEISAN works with many files so smaller dimensions can be used. For the PC version, dimensions may be different from above, check seidim.inc.

Note: In case programs don't work, you might have to recompile, see section 3.8.
Some Ubuntu users are missing the libg2c.so.0 library file, it can be installed with the command (you might need to be online):
sudo apt-get install gcc
If this does not work, also try:
sudo apt-get install libg2c0

On at 64 bit computer the IASP files in DAT must be regenerated if you have the files from a 32 bit computer, with the programs REMODL and SETBRN otherwise HYP will crash.

Graphics problem: On Solaris, if no colors, make sure color setting is 8 bit. Can be set with command m64config -depth 8. See Solaris manual.

Multiple users on Linux/Unix

If two or more users are working with EEV at the same time with the same user, there is a risk that the S-file names are being mixed up so an event from one year suddenly gets the S-file name from another year. This is caused by both users using the same environmental variable for the S-file (should be changed !). The solution is that each users has his/her own account, which in any case is the most convenient. indexProblem: S-file changed name indexMultiple users on Linux/Unix indexWrong S-file name indexS-file changed name


next up previous contents index
Next: 3.2 MacOSX Up: 3. Installation Previous: 3. Installation   Contents   Index
Peter Voss : Mon Feb 27 10:16:12 UTC 2017