Fast, flexible particle simulations — An introduction to MercuryDPM

Published: 16 Jan 2020 | Version 1 | DOI: 10.17632/n7jmdrdc52.1

Description of this data

We introduce the open-source package MercuryDPM, which we have been developing over the last few years. MercuryDPM is a code for discrete particle simulations. It simulates the motion of particles by applying forces and torques that stem either from external body forces, (gravity, magnetic fields, etc.) or particle interactions. The code has been developed extensively for granular applications, and in this case these are typically (elastic, plastic, viscous, frictional) contact forces or (adhesive) short-range forces. However, it could be adapted to include long-range (molecular, self-gravity) interactions as well.

MercuryDPM is an object-oriented algorithm with an easy-to-use user interface and a flexible core, allowing developers to quickly add new features. It is parallelised using MPI and released under the BSD 3-clause licence. Its open-source developers’ community has developed many features, including moving and curved walls; state-of-the-art granular contact models; specialised classes for common geometries; non-spherical particles; general interfaces; restarting; visualisation; a large self-test suite; extensive documentation; and numerous tutorials and demos. In addition, MercuryDPM has three major components that were originally invented and developed by its team: an advanced contact detection method, which allows for the first time large simulations with wide size distributions; curved (non-triangulated) walls; and multicomponent, spatial and temporal coarse-graining, a novel way to extract continuum fields from discrete particle systems. We illustrate these tools and a selection of other MercuryDPM features via various applications, including size-driven segregation down inclined planes, rotating drums, and dosing silos.

Experiment data files

This data is associated with the following publication:

Fast, flexible particle simulations — An introduction to MercuryDPM

Published in: Computer Physics Communications

Latest version

  • Version 1


    Published: 2020-01-16

    DOI: 10.17632/n7jmdrdc52.1

    Cite this dataset

    Weinhart, Thomas; Orefice, Luca; Post, Mitchel; van Schrojenstein Lantman, Marnix P.; Denissen, Irana F.C.; Tunuguntla, Deepak R.; Tsang, J.M.F.; Cheng, Hongyang; Shaheen, Mohamad Yousef; Shi, Hao; Rapino, Paolo; Grannonio, Elena; Losacco, Nunzio; Barbosa, Joao; Jing, Lu; Alvarez Naranjo, Juan E.; Roy, Sudeshna; den Otter, Wouter K.; Thornton, Anthony R. (2020), “Fast, flexible particle simulations — An introduction to MercuryDPM”, Mendeley Data, v1


Views: 8
Downloads: 0


Computational Physics, Granular Material


BSD 3-clause Learn more

The files associated with this dataset are licensed under a BSD 3-Clause ("Revised") License licence.

What does this mean?
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice,this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.