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:
|
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 |
Real |
None |
[dem_solid].wall |
Restitution coefficient between a DEM solids type and the walls. It can
also be given as |
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:
|
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,
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.
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 underdem.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 Options:
|
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: acentralbond is a spring along the line between the centers. Abeambond also resists shear, bending and twisting, as a cemented (parallel) bond does, so that an assembly of bonded spheres holds its shape.normal: atension_onlybond 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. Atension_compressionbond 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:
|
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 |
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
Options:
|
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:
|
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:
|
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 + |
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:
clumptypes, 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