DEM model

Inputs for the discrete element method (DEM), used when solids.model = dem (see particle options). Every type listed in solids is a DEM type.

Contact model

The following input is defined with the prefix dem:

Description

Type

Default

contact_model

Contact model for particle-particle and particle-wall collisions.

Options:

  • lsd : Linear spring-dashpot.

  • hertz : Hertz-Mindlin.

String

lsd

The linear spring-dashpot model takes the following inputs, defined with the prefix dem.lsd:

Description

Type

Default

spring_const.pp

Normal spring constant :: particle to particle collisions [required]

Real

0

spring_const.pw

Normal spring constant :: particle to wall collisions [required]

Real

0

spring_tang_fac.pp

Tangential-to-normal spring constant factor :: particle to particle collisions

Real

0.2857

spring_tang_fac.pw

Tangential-to-normal spring constant factor :: particle to wall collisions

Real

0.2857

damping_tang_fac.pp

Factor relating the tangential damping coefficient to the normal damping coefficient :: particle to particle collisions

Real

0.5

damping_tang_fac.pw

Factor relating the tangential damping coefficient to the normal damping coefficient :: particle to wall collisions

Real

0.5

The Hertz-Mindlin model [TTI92] stiffens as particles overlap. For a contact with effective radius \(R^*\), effective mass \(m^*\) and overlap \(\delta\), the normal force is \(\frac{4}{3} E^* \sqrt{R^*} \delta^{3/2}\) and the tangential stiffness is \(8 G^* \sqrt{R^* \delta}\), where \(E^*\) and \(G^*\) are the effective Young’s and shear moduli of the two materials. The normal damping is set from the restitution coefficient so that it holds at every impact velocity. The tangential stiffness and damping act only with dem.tan_history. Each contact uses its own particles’ radii and masses, so particles of different sizes within a type are handled exactly. The model takes the following inputs, defined with the prefix dem.hertz:

Description

Type

Default

youngs_modulus.[dem_solid]

Young’s modulus of the type’s particles (Pa) [required]

Real

None

youngs_modulus.wall

Young’s modulus of the walls (Pa) [required]

Real

None

poisson_ratio.[dem_solid]

Poisson ratio of the type’s particles, greater than -1 and at most 0.5 [required]

Real

None

poisson_ratio.wall

Poisson ratio of the walls, greater than -1 and at most 0.5 [required]

Real

None

damping_tang_fac.pp

Factor relating the tangential damping coefficient to the normal damping coefficient :: particle to particle collisions

Real

0.5

damping_tang_fac.pw

Factor relating the tangential damping coefficient to the normal damping coefficient :: particle to wall collisions

Real

0.5

The solids time step is set differently by the two models: from the collision time with lsd, and from the Rayleigh time with hertz (see DEM time step).

Restitution coefficients

The following inputs use the solids type names from solids to define restitution coefficients and are defined with the prefix dem.restitution_coeff. They are required for every solid-solid and solid-wall combination, whatever the contact model, and also when the domain has no walls. Each is between 0 and 1.

Description

Type

Default

[dem_solid].[dem_solid2]

Restitution coefficient between two DEM solids types. Order is not important: it can also be given as [dem_solid2].[dem_solid]. If both are given they must be equal.

Real

None

[dem_solid].wall

Restitution coefficient between a DEM solids type and the walls. It can also be given as wall.[dem_solid]. If both are given they must be equal.

Real

None

Friction and tangential history

The following inputs apply to every contact model and are defined with the prefix dem:

Description

Type

Default

friction_coeff.pp

Friction coefficient :: particle to particle collisions [required]

Real

0

friction_coeff.pw

Friction coefficient :: particle to wall collisions [required]

Real

0

rolling_friction

Rolling friction model [ACRO11, BVB+19, WK12, ZWY+99]

Options:

  • None

  • ModelA

    \(\boldsymbol{\tau}_{ij}^{(r)} = -\mu_{r}\hat{r}_{ij} \left| f_{ij}^{(n)} \right| \frac{\omega_{ij}}{\left|\omega_{ij}\right|}\)

  • ModelB

    \(\boldsymbol{\tau}_{ij}^{(r)} = -\mu_{r}\hat{r}_{ij} \left| f_{ij}^{(n)} \right| \boldsymbol{u}_{ij}^{\omega}\)

String

None

rolling_friction.coefficient

Rolling friction coefficient when using a rolling friction model

Real

0

tan_history

Include tangential history force in the collision model.

Bool

false

tan_history.max_contacts

Maximum number of contacts per particle tracked at any point when tangential history is enabled.

Int

10

Example

Below is an example for specifying the inputs for two DEM solids.

solids       = sand  char
solids.model = dem

dem.contact_model = lsd

dem.lsd.spring_const.pp     =   100.0
dem.lsd.spring_const.pw     =   100.0

dem.lsd.spring_tang_fac.pp  =     0.2857
dem.lsd.spring_tang_fac.pw  =     0.2857

dem.lsd.damping_tang_fac.pp =     0.5
dem.lsd.damping_tang_fac.pw =     0.5

dem.friction_coeff.pp       =     0.25
dem.friction_coeff.pw       =     0.15

dem.restitution_coeff.sand.sand =  0.85
dem.restitution_coeff.sand.char =  0.88
dem.restitution_coeff.char.char =  0.90

dem.restitution_coeff.sand.wall =  0.85
dem.restitution_coeff.char.wall =  0.89

The same solids with the Hertz-Mindlin model:

dem.contact_model = hertz

dem.hertz.youngs_modulus.sand =  7.0e10
dem.hertz.youngs_modulus.char =  5.0e9
dem.hertz.youngs_modulus.wall =  2.0e11

dem.hertz.poisson_ratio.sand  =  0.25
dem.hertz.poisson_ratio.char  =  0.3
dem.hertz.poisson_ratio.wall  =  0.3

The friction and restitution coefficients are given as for lsd.

Implicit drag

By default (solids.momentum.update = explicit), the fluid-particle drag force is applied explicitly to particles,

\[u_p^{n^{\prime}+1} = u_p^{n^\prime} + dt_{\mathrm{DEM}}\left(\beta^n (u_f^{n+1} - u_p^{n}) + \mathcal{F}_p^{n^\prime}\right)/m_p\]

where \(u_p\) is the p-th particle velocity at the indicated time level, \(\beta^n\) is the drag coefficient, \(u_f^{n+1}\) is the fluid velocity, \(\mathcal{F}_p\) are all non-drag forces (e.g., gravitational, buoyancy, collision etc.), and \(m_p\) is particle mass. Terms exist at different time levels due in part to how the fluid and particle models are coupled and partly because particles typically sub-step in time. Specifically, a time step advances the fluid from \(t^n\) to \(t^{n+1}\), then particles take multiple smaller time steps to traverse the same total time. In the above equation, prime markers differentiate quantities updated at each DEM sub-step.

The updated particle velocity, \(u_p^{n^{\prime}+1}\), is substituted into the drag expression when solids.momentum.update = implicit.

\[u_p^{n^{\prime}+1} = \frac{u_p^{n^\prime} + dt_{\mathrm{DEM}}\left( \beta^n u_f^{n+1} + \mathcal{F}_p^{n^\prime} \right)/m_p}{1 + dt_{\mathrm{DEM}} \beta^n / m_p}\]

By using the updated velocity, the drag force computed for the fluid and particles is inconsistent, and interphase momentum is not conserved. However, implicit drag may be needed for numerical stability when the particle density is much less than the fluid (such as bubbles). The implicit update is required when virtual mass is included, and the virtual mass coefficient is added to the particle mass in the denominator.

Bonds

Bonds join pairs of touching DEM particles. The inputs follow a bond’s life:

  • what a bond is: the solid bond physics, under dem.bonds.solid;

  • how bonds are made: once at the start (initialization), during the run (formation), or both, each option with its own settings under dem.bonds.[option];

  • when a bond breaks: dem.bonds.solid.breakage.

Bonds are set by the type pair: a pair of types bonds only when dem.bonds.solid.spring_const is given for that pair, so a run can bond some types and not others.

dem.bonds.solid.model turns bonds on and chooses what they carry (see solid bonds). dem.bonds.max_bonds limits the bonds a particle records, however they are made.

The following input is defined with the prefix dem.bonds.solid:

Description

Type

Default

model

Solid bond model. Bonds are on when it is not none.

Options:

  • none - no bonds

  • central - a spring between the particle centers

  • beam - also resists shear, bending and twisting

String

none

The following input is defined with the prefix dem.bonds:

Description

Type

Default

max_bonds

Maximum number of bonds a particle records. A bond is recorded by one of its two particles, so a particle can take part in more bonds than this.

Int

6

Solid bonds

Two settings describe what a solid bond carries:

  • model: a central bond is a spring along the line between the centers. A beam bond also resists shear, bending and twisting, as a cemented (parallel) bond does, so that an assembly of bonded spheres holds its shape.

  • normal: a tension_only bond pulls but does not push. Its rest length is the touching distance, so it is slack while the particles are in contact and the contact force handles compression. A tension_compression bond keeps the separation it was made at, pushes as well as pulls, and replaces the contact force between the two particles.

The following input is defined with the prefix dem.bonds.solid:

Description

Type

Default

normal

Whether a bond pushes as well as pulls along the line between the particle centers.

Options:

  • tension_only - pulls only; slack in contact

  • tension_compression - keeps its rest length and replaces contact

String

tension_only

The following inputs use the solids type names from solids. Order is not important: spring_const.[dem_solid].[dem_solid2] can also be given as spring_const.[dem_solid2].[dem_solid], and if both are given they must be equal.

The following inputs are defined with the prefix dem.bonds.solid:

Description

Type

Default

spring_const.[dem_solid].[dem_solid2]

Bond spring constant between the two types. A pair without it never bonds; a model other than none needs it for at least one pair.

Real

None

damping.[dem_solid].[dem_solid2]

Bond damping coefficient along the line between the centers.

Real

0

The following inputs apply to model = beam and are defined with the prefix dem.bonds.solid.beam:

Description

Type

Default

radius_factor.[dem_solid].[dem_solid2]

Bond radius as a fraction of the smaller particle radius, greater than 0 and at most 1. Required for every bonding pair.

Real

None

poisson.[dem_solid].[dem_solid2]

Poisson ratio of the bond material, which sets the shear and twisting stiffness from the spring constant. At least -0.5.

Real

0.3

Bond initialization

Bonds can be made once at the start, during the run (see bond formation), or both.

initialization = contact bonds every pair of bonding types that is within dem.bonds.contact.tolerance of touching, once, before the first step. The particles must be read from particle_input.dat or placed from templates (see initial condition templates), so that the touching pairs are the ones intended; it cannot be used with spheres generated from the initial conditions. It does not run again on a restart.

The following input is defined with the prefix dem.bonds:

Description

Type

Default

initialization

Bonds made once, before the first step, for particles read from particle_input.dat or placed from templates; not on a restart.

Options:

  • none - no bonds at the start

  • contact - bond every touching pair of bonding types

String

none

The following input applies to initialization = contact and is defined with the prefix dem.bonds.contact:

Description

Type

Default

tolerance

A pair is bonded when the distance between the centers is at most (1 + tolerance) times the touching distance.

Real

1.0e-3

Bond formation

formation = stochastic may form a bond during the run when two particles first touch. Each particle has a bond probability (see bond_probability in the initial and boundary condition inputs), the chance that it makes a bond on contact, and the pair bonds unless neither particle does: with probabilities p1 and p2, the pair bonds with probability 1 - (1 - p1)(1 - p2). The draw is made once per contact, on its first sub-step, and only when the particles close at less than the pair’s dem.bonds.stochastic.max_impact_velocity. A pair that already holds a bond is not drawn again.

This is a sampled agglomeration rule, not a model of what holds the particles together: the bond it makes is the same solid bond as any other, set by the pair’s dem.bonds.solid inputs. It does not model capillary or viscous liquid-bridge forces.

The following input is defined with the prefix dem.bonds:

Description

Type

Default

formation

Bonds formed during the run.

Options:

  • none - no bonds are formed during the run

  • stochastic - contacts bond at random, by the bond probabilities

String

none

The following inputs apply to formation = stochastic and are defined with the prefix dem.bonds.stochastic:

Description

Type

Default

random_seed

Seed for the random draw that decides whether a contact bonds.

Int

1

max_impact_velocity.[dem_solid].[dem_solid2]

A contact can form a bond only when the particles close at less than this normal velocity (m/s) at first touch.

Real

no limit

Bond breakage

Every bond breaks when it stretches past max_stretch_ratio times its rest length. With breakage = strength, a beam bond also breaks when its tensile or shear stress exceeds the pair’s strength, whichever comes first.

The following input is defined with the prefix dem.bonds.solid:

Description

Type

Default

breakage

When a bond breaks.

Options:

  • stretch - past breakage.max_stretch_ratio alone

  • strength - also at the tensile or shear strength; model = beam only

String

stretch

The following inputs are defined with the prefix dem.bonds.solid.breakage:

Description

Type

Default

max_stretch_ratio.[dem_solid].[dem_solid2]

A bond breaks when stretched past this multiple of its rest length. At least 1, and (1 + dem.bonds.contact.tolerance) times it must not exceed 1.5, the reach of the neighbor search.

Real

1.2

The following inputs apply to breakage = strength and are defined with the prefix dem.bonds.solid.breakage.strength. Each is required, greater than 0, for every bonding pair.

Description

Type

Default

tensile.[dem_solid].[dem_solid2]

A bond breaks when the tensile stress from its normal force and bending moment exceeds this (Pa).

Real

None

shear.[dem_solid].[dem_solid2]

A bond breaks when the shear stress from its shear force and twisting moment exceeds this (Pa).

Real

None

Below is an example of beam bonds made between touching particles at the start of the run, between the grain type and itself only.

solids       = grain  fines
solids.model = dem

dem.bonds.initialization = contact

dem.bonds.solid.model  = beam
dem.bonds.solid.normal = tension_compression
dem.bonds.solid.spring_const.grain.grain       = 1.0e4
dem.bonds.solid.beam.radius_factor.grain.grain = 0.5
dem.bonds.solid.breakage = strength
dem.bonds.solid.breakage.strength.tensile.grain.grain = 1.0e6
dem.bonds.solid.breakage.strength.shear.grain.grain   = 1.0e6

Superquadrics

A type with [solid_name].shape = superquadric has superquadric particles: ellipsoids, rounded boxes and cylinders, and shapes in between. The type’s semi-axes and exponents ([solid_name].superquadric, see solids model) give each particle’s shape and size. A superquadric type’s initial and boundary conditions take no diameter inputs; it is an error to give them. Particles generated from an initial or boundary condition take random orientations. They are placed with their bounding spheres, so an elongated shape cannot reach volume fractions as high as spheres can.

Contacts are found between the particle surfaces, at the points of deepest overlap [GYP+22], and use the contact model of the spheres (dem.contact_model, with dem.lsd or dem.hertz); with hertz, the radius in the contact force is the surface’s local radius of curvature at the contact. When the deepest-point search does not converge, the contact falls back to the midway point [PPK17] for that step. Rotation uses the particle’s full inertia tensor.

Conduction uses the sphere models (see solids model). Contact conduction, between particles and with walls that have a temperature, uses the contact the forces find: each particle is replaced by the sphere that matches its surface curvature at the contact point, with the overlap of the two surfaces. A sphere-shaped superquadric conducts exactly as a sphere does. Particle-fluid-particle conduction is taken between the volume-equivalent spheres at the particle centres, and with superquadrics solids.flpc can be at most 0.5. Convection and radiation use the particle’s true surface area, and a quarter of it as the mean projected area.

The other types in a run with superquadrics must be sphere types. The following cannot be used with superquadrics:

  • clump types, templates and bonds (dem.bonds)

  • rolling friction

  • the polydisperse neighbor search

  • reacting solids

  • moving walls in a rotating reference frame

dem.tan_history must be enabled. mfix.drag.model = DiFeliceHoelzerSommerfeld accounts for the particles’ shape and orientation (see fluid-particle coupling); drag laws for spheres act on the volume-equivalent sphere.

In particle_input.dat (mfix.particle_init_type = ASCIIFile), the line of a superquadric has no radius and ends with the particle’s orientation as a unit quaternion:

phase  x  y  z  density  u  v  w  qw  qx  qy  qz

The lines of sphere types are unchanged. The particle variables orientation and superquadric_shape write the orientation and shape to plotfiles (see plotting).

Below is an example of a superquadric type, a rounded cube 10 mm across, filling a region.

solids       = cube
solids.model = dem

dem.tan_history = 1

cube.shape                  = superquadric
cube.superquadric.semi_axes = 0.005 0.005 0.005
cube.superquadric.exponents = 4 4

ic.bed.solids        = cube
ic.bed.packing       = pseudo_random
ic.bed.cube.volfrac  = 0.2
ic.bed.cube.velocity = 0.0 0.0 0.0
ic.bed.cube.density.distribution = constant
ic.bed.cube.density.constant     = 2500