• Beta Update (Bug Fix CubeInsertionBoundaries)
    May 5th, 2017
    Read More …
  • Beta Update (New feature added)
    March 29th, 2017
    Read More …
  • Mercury @ Physics@Veldhoven
    January 18th, 2017
    Read More …


RSS Feed

Mercury Version 0.11 Release

August 12th, 2016

A new version of MercuryDPM is available, version 0.11. The new features include

1. A complete documentation of MercuryDPM’s core directory (Kernel/), previously known as src/, available at

2. Most importantly, new tests have been added to check if all the new features work.

3. MercuryDPM now supports Paraview. All your particle data can be viewed both in Paraview and XBalls. Please look into our documentation for further details

4. New tutorials have been added to showcase the features of our code, see Drivers/Tutorials. We are working on many more new tutorials for a comprehensive understanding of MercuryDPM.

5. A fully reorganised directory structure:

At the top level of the source directory you will find six main subdirectories:

  • Drivers/ This is the only directory you need to create new application codes or modify existing ones; all other directories contain either documentation or files required as input files in the codes contained in this directory.
    It has a series of subdirectories, for example Tutorials/, that contain a series of demo codes illustrating how to write applications in MercuryDPM.
  • Kernel/
    Contains the heart of the code. Users should not change the Kernel files. Instead, the classes and functions defined here are should be used (and possibly modified) in the Driver files.
  • Scripts/ Contains a script used by make test, and make fullTest to check if two output files are equal.
  • Tools/ Contains the source files required to use paraview.
  • Documentation/
    Contains the raw .dox files for creating documentation pages, like the one you are reading right now, as well as the images used in the documentation.
  • Configuration/
    These files specify how the documentation and the code is configured.

6. All source files now have the license prepended.

7. New Features

a) Complex wall geometries are now possible such as axisymmetric walls (cones, cylinders, ...), screws, coils, and many more.

b) Support for periodic boundaries, angled periodic boundaries (periodic boundaries in angular direction in a cylindrical geometry), circular periodic boundaries, Lees-Edwards boundaries (periodic boxes with shear). Also introduced a deletion and insertion boundary.

c) Multiple new types of interactions varying from elastic to adhesive to frictional, e.g. Hertzian visco-elastic, linear plastic-visco-elastic, linear visco-elastic, liquid bridges (Willet's model), reversible adhesive, sliding friction. For each of these interactions, species are defined that store the contact properties.

8. In addition to the wallHandler and particleHandler, additional handlers have been introduced, please refer to the documentation


9. A new class Files has been introduced to read and write files. The files can be accesses by the following variables:





10. New coding guidelines have been adopted. Please check the link As a result we have changed function names, such that they adhere to the new guidelines.