next up previous
Next: Quick installation Up: swashimp Previous: Use of patch files


Installation of SWASH on your computer

The portability of the SWASH code between different platforms is guaranteed by the use of standard ANSI FORTRAN 90. Hence, virtually all Fortran compilers can be used for installing SWASH. See also the manual Programming rules (to be found on the SWAN website http://swanmodel.sourceforge.net/online_doc/swanpgr/swanpgr.html).


The SWASH code is parallelized, which enables a considerable reduction in the simulation time for relatively large CPU-demanding calculations. A message passing modelling is employed based on the Message Passing Interface (MPI) standard that enables communication between independent processors. Hence, users can optionally run SWASH on a Linux cluster.


The material on the SWASH website provides a Makefile and two Perl scripts (platform.pl and switch.pl) that enables the user to quickly install SWASH on the computer in a proper manner. For this, the following platforms, operating systems and compilers are supported:

platform OS F90 compiler
SGI Origin 3000 (Silicon Graphics) IRIX SGI
IBM SP AIX IBM
Compaq True 64 Alpha (DEC ALFA) OSF1 Compaq
Sun SPARC Solaris Sun
PA-RISC (HP 9000 series 700/800) HP-UX v11 HP
IBM Power6 (pSeries 575) Linux IBM
Intel Pentium (32-bit) PC Linux GNU (g95)
Intel Pentium (32-bit) PC Linux GNU (gfortran)
Intel Pentium (32-bit) PC Linux Intel
Intel Pentium (64-bit) PC Linux Intel
Intel Itanium (64-bit) PC Linux Intel
Intel Pentium (64-bit) PC Linux Portland Group
Intel Pentium (32-bit) PC Linux Lahey
Intel Pentium (32-bit) PC MS Windows Intel
Intel Pentium (64-bit) PC MS Windows Intel
Intel Pentium (32-bit) PC MS Windows Compaq Visual
Power Mac G4 Mac OS X IBM
MacBook macOS GNU (gfortran)
MacBook macOS Intel

If your computer and available compiler is mentioned in the table, you may consult Section 3.1 for a quick installation of SWASH. Otherwise, read Section 3.2 for a detailed description of the manual installation of SWASH.


Note that for a successful installation, a Perl package must be available on your computer. In most cases, it is available for Linux and a UNIX operating system. Check it by typing perl -v. Otherwise, you can download a free distribution for Windows called ActivePerl; see http://www.activestate.com/activeperl/downloads. The Perl version should be at least 5.0.0 or higher!


Before installation, the user may first decide how to run the SWASH program. There are two possibilities:

For a typical depth-averaged flume computation, it may be sufficient to choose the serial mode, i.e. one SWASH program running on one processor. The parallel mode is more convenient for a relatively large CPU-demanding multi-layer flume (2DV) or basin-like (2DH/3D mode) calculation.


For a proper installation of MPI on Windows (7/8.1/10), please consult Section 3.3.



Subsections
next up previous
Next: Quick installation Up: swashimp Previous: Use of patch files
The SWASH team 2017-04-06