= Installation guide =

[wiki:FpCompileLibs]

[wiki:FpCompileRequirements]


= Hints for installing Flexpart v8.2 =
(should work for all Versions of Flexpart)

a step-by-step guidance for installing flexpart v8.2 at your local unix machine.
Please consider to consult Flexpart v8.2 documentation

1. Download Grib-API und Jasper as described in the flexpart documentation

2. Install Jasper library
{{{
 mkdir /%HOME%/lib/
 cp %JASPER%.zip /%HOME%/lib
 cd %HOME%/lib
 unzip %JASPER%.zip
 cd %JASPER%
 ./configure --prefix=/%HOME%/lib/%JASPER%
 make
 make check
 make install
}}}
3. Install Grib-API library
    * mkdir /%HOME%/lib/src/
    * cp %GRIB%.tar.gz /%HOME%/lib/
    * cp %GRIB%.tar.gz /%HOME%/lib/src/
    * cd /%HOME%/lib/src/
    * tar -xvf %GRIB%.tar.gz
    * ./configure --prefix=/%HOME%/lib/%GRIB% --with-jasper=/%HOME%/lib/%JASPER%
    * make
    * make check
    * make install

4. Add the following lines to the bash.rc-file of your home directory:

    * edit %HOME%/.bashrc (e.g. vi or emacs)
    * export GRIB_API_BIN=“/%HOME/lib/%GRIB%/bin“
    * export GRIB_API_LIB=“/%HOME/lib/%GRIB%/lib“
    * export GRIB_API_INCLUDE=“/%HOME/lib/%GRIB%/include“
    * export PATH=$GRIB_API_BIN:$PATH

5. Testing if Grib-API installation has been successful: read out Grib-file:
    * grib_ls %FILENAME%

6. Download Flexpart (%FLEXPART%.tar.gz) as described in the flexpart documentation

7. Unzip Flexpart-Archive, modify makefile und compile

    * tar -xvf %FLEXPART%.tar.gz
    * cp makefile.%(version)% makefile
    * edit makefile (e.g. vi or emacs)
    * Change lines to:
    * INCPATH=/lib/%GRIB%/include
    * LIBPATH1=/lib/%GRIB%/lib
    * LIBPATH2=/lib/%JASPER%/lib
Adjust file includepar in the Flexpart-directory to your local computing capacities (if the values of the following parameters are choosen too high, compiling via make will fail) 
    *  parameter(nxmax=721,nymax=361,nuvzmax=92,nwzmax=92,nzmax=92) (input: ECMWF windfields with resolution 0.5°)
    *  parameter(nxmax=361,nymax=181,nuvzmax=92,nwzmax=92,nzmax=92) (input: ECMWF windfields with resolution 1.0°)
    * parameter(maxpart=22000000) (Change to: 1000000 (or 500000 / according to your computer specifications))
    * parameter(maxspec=60) (Number of species. Change to 1 oder 2 (according to your computer specifications and your scientific problem)))
    * make clean
    * make

Minimum requirements to achieve results in a reasonable time: 4GB RAM