Changes between Initial Version and Version 1 of FpInstallNew

Jul 24, 2019, 4:54:49 PM (15 months ago)

First draft


  • FpInstallNew

    v1 v1  
     1== FLEXPART installation guide ==
     3We know that some people run FLEXPART on MacOS, and it may even be possible to run it under Windows, but usually  it is used under GNU/Linux nowdays.
     5=== 1. Install dependencies ===
     7If possible, install the required libraries as packages of your distribution. This will often save you a lot of hassles. On Debian, there is even a package for FLEXPART. Currently, all [ Debian FLEXPART package] contain version 9.0.2. However, you need to be able to compile the code yourself, so the run-time dependencies installed by this package will not suffice. You need the following dependencies to be fulfilled:
     9 - `gfortran`
     10     - or another Fortran compiler - however, then you need to (hand-)compile the libs with exactly the same compiler!
     11 - GNU `make` (will be installed on
     15 most systems already)
     16 - `grib_api` lib or its successor, `eccodes`
     17 - the `jasper` lib (which is needed to use grib_api and eccodes
     18 - optionally for Versions >= 9.2: `netCDF` Fortran libraries if you want to use the netCDF output feature
     19 - optionally for Versions >= 10: `openmpi` library if you want to build parallel code
     21If your distributions offers so-called developer packages for these, you need to install them (they contain the Fortran90 module files which are needed for compilation). They usually pull in the standard packages as well. Thus, on a Debian or Debian-derived system, the following packages should be installed:
     24gfortran make libgrib-api-dev libjasper-dev libnetcdf-dev libopenmpi-dev
     27=== 2. Review and adapt some parameters ===
     28Go through `par_mod.f90` and change the parameters if necessary. Typically, this includes the dimensions of the input meteorological data.
     30=== 3. Adapt makefile ===
     32The FLEXPART makefile comes with makefiles. They are inside the source directory. Usually you will need to make some adaptations to your local site.
     34=== 4. Compile and test ===
     36Compile the code with the command
     39make -f makefile
     41where `makefile` is the makefile which you want to use.
     43As a first test, you can just start the executable. It should greet you and then stop with a message about missing pathnames (here is an  example with version 8.2.3):
     46 Welcome to FLEXPART Version 8.2.3
     47 FLEXPART is free software released under the GNU General Public License.
     48  #### TRAJECTORY MODEL ERROR! FILE "pathnames"####
     50  #### DIRECTORY.                              ####
     53=== 5. Prepare and test real run ===