Skip to content

Massive-Parallel Trajectory Calculations (MPTRAC) is a Lagrangian particle dispersion model for the free troposphere and stratosphere.

License

Notifications You must be signed in to change notification settings

paul-f-baumeister/mptrac-old

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Massive-Parallel Trajectory Calculations

Massive-Parallel Trajectory Calculations (MPTRAC) is a Lagrangian particle dispersion model for the free troposphere and stratosphere. MPTRAC has been developed to support the analysis of atmospheric transport processes.

The primary task of MPTRAC is to calculate air parcel trajectories by solving the kinematic equation of motion. Turbulent diffusion and sub-grid scale wind fluctuations are simulated with a Markov chain model. Additional modules are implemented to simulate the sedimentation of air parcels and the decay of particle mass.

MPTRAC can be used on a desktop PC, but it also features an MPI/OpenMP hybrid parallelization for efficient use on supercomputers.

Further information can be found at: http://www.fz-juelich.de/ias/jsc/mptrac

Installation

This documentation describes the installation of MPTRAC on a Linux system. A number of standard tools such as the GNU Compiler Collection (gcc) and 'make' are required to install MPTRAC.

Start by downloading the source code from the github repository:

git clone https://github.com/slcs-jsc/mptrac

Change to the directory mptrac/ which holds source codes, libraries, documentation, etc:

cd mptrac

The GNU Scientific Library (https://www.gnu.org/software/gsl) is required for numerical calculations and the Unidata netCDF library (http://www.unidata.ucar.edu/software/netcdf) is needed for file-I/O. Copies of these libraries can be found in the repository, if they are not available on your system. A script is provided to build the libraries:

cd lib
./build.sh

Next, change to the source directory and edit the Makefile according to your needs. In particular, check the paths to the libraries (INCDIR and LIBDIR). Then try to compile the code:

cd ../src
emacs Makefile
make

The binaries will be linked statically, i.e., they can be copied to other machines. Sometimes static compilations causes problems, in particular in combination with MPI. In this case remove the '-static' flag from the CFLAGS in the Makefile and compile again.

By default we use rather strict compiler warnings. All warning messages will be turned into errors and no binaries will be produced. This behavior is enforced by the flag '-Werror'.

The binaries will remain in the src/ directory.

Getting started

This script illustrates how to use MPTRAC:

cd ../example
./run.sh

The example illustrates how to simulate the dispersion of volcanic ash from the eruption of the Puyehue-Cordón Caulle volcano, Chile, in June 2011.

The script generates a number of plots of the simulation output at different times after the eruption by means of 'gnuplot'. These plots should look similar to the output already provided in the repository.

More details on the control parameters, data structures, and algorithms can be found in the MPTRAC reference manual:

 evince ../doc/refman.pdf

Contact

We are interested in sharing MPTRAC for research applications.

Please do not hesitate to contact us if you have any further questions:

Dr. Lars Hoffmann
Forschungszentrum Jülich
Jülich Supercomputing Centre
52425 Jülich
Germany

e-mail: [email protected]

License

MPTRAC is distributed under the GNU GPL v3.

About

Massive-Parallel Trajectory Calculations (MPTRAC) is a Lagrangian particle dispersion model for the free troposphere and stratosphere.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published