G-DEMPack manual

From KratosWiki
Revision as of 13:59, 26 August 2015 by Maceli (Talk | contribs)
Jump to: navigation, search

This manual explains how to run a DEM simulation with D-DEMPack on GiD.


Loading D-DEMPack

If you did not install GiD or D-DEMPack yet, follow the installation instructions here: D-DEMPack installation

Once you have finished the installation, open GiD and load the D-DEMPack Problemtype by clicking:

Data -> D-DEMPack

Note that a toolbar with 7 buttons has been added to the left side of the GiD working window. This toolbar is called "Model definition toolbar" and can be hidden and shown through the GiD utilities:

Utilities -> Tools -> Toolbars

The buttons in the Model definition toolbar do the following actions:

  • Button 1 - Link to the GiD Groups Management Window
  • Button 2 - Model Definition Tree
  • Button 3 - Materials Tree
  • Button 4 - Running Processes Management Window
  • Button 5 - Run this case
  • Button 6 - Show information about how this case is running
  • Button 7 - Stop this case

The GiD philosophy

GiD is a Pre and Post Processor, it is not an actual CAD tool. However, it can be used to draw geometries and mesh them. For complicated geometries, we recommend using a CAD tool and importing them into GiD for meshing (or import mesh and apply conditions directly). In case of drawing geometries with GiD, one must be aware that it uses a Hierarchical Structure: Volumes are created with a set of watertight Surfaces, Surfaces are created with a set of watertight Lines and Lines are created starting and ending in Points. If there are no Points, a Line cannot be created, and the same dependence holds for all levels. For more information about how to use GiD, visit GiD's home page or follow some tutorials

The Kratos philosophy

The way Kratos applies materials and conditions to the geometry or the mesh is using the Groups. A Group is a set of entities (either in Geometry or in Mesh). A Group can contain any Volume, Surface, Line, Point, Element or Node, no matter whether it is already belonging to other Groups.

The D-DEMPack philosophy

Since DEMPack is based in Kratos and programmed for GiD, it inherits the philosophy of both. The Groups will be the essential tool for assigning materials and conditions.

OPTION 1: Use the Groups Management Window to create Groups and move entities into the corresponding Groups. Go to the Model Definition Tree, fill in all the fields and assign conditions to existing Groups (the ones you just created).

OPTION 2: Fill in all the fields of the Model Definition Tree and when asked for any Group to assign the condition to, use the button for automatic creation of Groups (included in the mini window for condition assignation)

Model Definition Tree

The Model Definition Tree contains all the options that must be filled in order to run a DEM computation.

Some of the options are edited directly on the Tree, while others (like the assignation of conditions to Groups) open a Mini Window to create new branches of the Tree. No matter what options are chosen in the Mini Window when you click OK, the data will be still editable on the new Tree branch.

DEM General Options

General options that affect the computation.

Bounding Box

Creates a Box for the computation and every DEM element that gets outside of this Box is deleted.

Bounding Box: Choose Active to activate it.

Bounding Box type: If 'Automatic' is chosen, the Bounding Box will be created taking into account the initial disposition of elements and walls. It will be created containing the existing entities.

Enlargement factor: only for 'Automatic' Box. Enlarges the Box by a factor.

Max X: Max corner X coordinate

Max Y: Max corner Y coordinate

Max Z: Max corner Z coordinate

Min X: Min corner X coordinate

Min Y: Min corner Y coordinate

Min Z: Min corner Z coordinate

Physical Options

Gravity value: Enter the value of the acceleration of Gravity (default value: 9.81 m/s2)

Gx: X component of the versor of the Gravity. The versor has not to be necessarily unitary.

Gy: Y component of the versor of the Gravity. The versor has not to be necessarily unitary.

Gz: Z component of the versor of the Gravity. The versor has not to be necessarily unitary.

Advanced Options

Clean initial indentations: If activated, initial indentations between spheres and between spheres and walls are eliminated to avoid explosions (reducing the radius of the spheres accordigly)

Virtual mass coefficient: This coefficient will multiply the mass of the DEM elements when calculating the accelerations of it. It is the same as saying that the accelerations of the DEM elements will be reduced by this factor.

Rolling friction: If activated, the rolling friction parameter of the Material will be taken into account. Otherwise, it will be ignored.

Rotations: If activated, the DEM elements will rotate. Otherwise, they will only suffer translations. By default rotations are activated.

Solution Strategy

Parallel Type

Parallel type: locked to OpenMP (MPI will be available in the future)

Number of threads: set the number of threads you want to use for this computation. Do not choose more than the available threads on your computer or the computation will be slower.

Time parameters

Delta time: Specify the time increment for the calculation. Take into account that a Delta Time too big will make the calculation instable, and a very small Delta Time can slow down the computation a lot.

Total time:Specify total amount of seconds you want to simulate. The simulation will start at time = 0 seconds and will finish at time = Total time seconds.

Info screen output: Specify the wall time increment (reality time) between updates on the Info Screen

Neighbour search frequency: choose how often the neighbours are searched. 1 means every time step, 10 means 1 out of 10 steps. Take into account that searching at every time step can penalize a lot the computation time, but searching with low frequency can lead to inaccurate results.


DEM element: double click on this item and a Mini Window will open. Choose an existing Material and assign it to an existing Group (or create the Group on-the-go)

Boundary conditions

Prescribed velocitites It allows the imposition of velocities to sets of DEM elements. Double click on this item and a Mini Window will open. It will impose initial velocities or fixed velocities for all time to the Groups of spheres you choose.

Inlet It allows the insertion of new DEM elements into the domain. Double click on this item and a Mini Window will open. Every Mesh Node will insert Elements. Mesh Nodes come usually from the meshing of Points, Lines, Surfaces(recommended) or Volumes. Assign this condition to a Group containing a Surface and the inner and boundary Nodes of this Surface will be generating new DEM elements with the parameters chosen.

DEM-FEM wall It marks a Surface as a Rigid Body which cannot be crossed by the DEM elements. Double click on this item and a Mini Window will open. Choose the options and assign it to a Group containg Surfaces (avoid Groups containing Spheres)


Output time step: Specify the time increment between prints. Every print will write down the necessary files to see the results on the Post-Process of GiD.

Print in Post-process

From all the options, choose those that you want to see in Post-process. Keep in mind that activating some of these options can slow down the computation noticeably, by adding function calls and allocating extra memory.


Force evolution with time: Choose Yes to activate it. It will print a file with the Integral of Forces and Torques on the whole chosen Group.

Printing delta time: Choose the time increment between prints of this type of graphs

Force integration group: Double click on this item and a Mini Window will open. Choose what Groups where you want to integrate the Forces and Torques.

Velocity Trap

Creates a Box in which measurements are done: average velocity, entering flux of particles, entering flux of mass.

Active velocity trap: choose Active to activate it.

Max X: Max corner X coordinate

Max Y: Max corner Y coordinate

Max Z: Max corner Z coordinate

Min X: Min corner X coordinate

Min Y: Min corner Y coordinate

Min Z: Min corner Z coordinate


Result format: Choose Binary or Ascii. Ascii takes more hard disk space, but is human readable.

Result file: Choose whether you want a Single file for all time steps or Multiple files (one for each time step). If an Inlet is present, Single option will not be able to print the results for the inserted DEM elements.

Materials Tree

Right click on 'DEM' to create a new material.

Materials have the following fields to be filled:

  • Density: that of the material, not bulk density
  • Young's Modulus: that of the material, not bulk stiffness
  • Poisson's Ratio: that of the material, not bulk ratio
  • Cohesion: JKR parameter
  • Friction angle: Particle friction angle (for Coulomb's friction). The tangent of this angle will be used to evaluate the begining of slip.
  • Coefficient of restitution: Desired quotient of exit velocity over incident velocity for collisions.
  • Rolling friction: Rolling friction parameter
  • Color: just a color for post-process
  • Discontinuum Contact Law: Choose Linear or Hertz. The implementation of the contact laws is based on the ones compiled and arranged by Thornton, Cummins, Cleary, 2013: models LSD and HMD" The paper is: C.Thornton, S.J. Cummins, P.W. Cleary, An investigation of the comparative behaviour of alternative contact force models during inelastic collisions. Powder Technology. Volume 233, January 2013, Pages 30–46
Personal tools