Templates¶
Inputs for templates, used when solids.model = dem (see DEM model).
A template is a grain built from overlapping member spheres. Templates are designed by the
mfix-clump-design tool (see Clump templates), which writes each one as a template file
the solver reads. Initial conditions place grains from templates (see initial condition
templates), each scaled to its volume-equivalent diameter. What a grain becomes
depends on the shape of its solid ([solid_name].shape):
A grain of a
clumptype is a rigid clump: its members move as one body.A grain of a
spheretype is a bonded agglomerate: its members are free spheres joined by initial bonds, which can break. This needsdem.bonds.solid.modelother thannone,dem.bonds.initialization = contactanddem.bonds.solid.normal = tension_compression.
mass applies to every grain placed from the template: it chooses whether the members carry the
grain’s mass or each has the grain density. drag applies only to rigid clumps coupled to the
fluid as bodies (dem.clump.coupling = body; see clump coupling). A
template file holds two sets of drag data, one for the grain the template was designed from and one
for the union of its member spheres, which can differ a great deal (a union of spheres has more
surface than the grain it fills); drag chooses the set. Grains coupled member by member, which
includes every bonded agglomerate, take each member’s drag from mfix.drag.model and do not use
drag.
The following inputs are defined with the prefix dem:
Description |
Type |
Default |
|
|---|---|---|---|
templates |
Names of the templates: grains built from overlapping member spheres, which initial conditions place as rigid clumps or bonded agglomerates. |
Strings |
None |
The following inputs are defined with the prefix dem.templates:
Description |
Type |
Default |
|
|---|---|---|---|
check_cells |
Stop at start-up when a fluid cell is narrower than three times the largest member radius seeded, since neighbor pairs would be missed. 0 allows it. |
Int |
1 |
The following inputs are defined with the prefix dem.templates.[template_name]:
Description |
Type |
Default |
|
|---|---|---|---|
file |
The template file, written by mfix-clump-design (see Clump templates). |
String |
None |
mass |
How the members’ density is set, for every grain placed from the template. Options:
|
String |
grain |
drag |
Which drag data rigid clumps take when they are coupled to the fluid as
bodies ( Options:
|
String |
grain |
Below is an example of a template for a type of rigid clumps. The file flake.tpl is written by
mfix-clump-design (see the example in Clump templates).
solids = grain
solids.model = dem
grain.shape = clump
dem.templates = flake
dem.templates.flake.file = flake.tpl
Clump coupling¶
Rigid clumps (clump types) are coupled to the fluid either member by member, as free spheres, or
as whole bodies. These inputs apply only to rigid clumps, and setting them when no solid is a
clump type is an error; bonded agglomerates are always coupled member by member. With body
coupling, a clump’s drag uses its volume-equivalent diameter and shape, and how the drag grows as
the fluid gets crowded follows mfix.drag.model: Gidaspow’s blend with Ergun’s law for
Gidaspow, and Wen and Yu’s correction for WenYu. Other drag models cannot be used with body
coupling. The members share the clump’s drag and the pressure force; virtual mass, lift, heat and
species transfer and radiation cannot be used with body coupling.
The following inputs are defined with the prefix dem.clump:
Description |
Type |
Default |
|
|---|---|---|---|
coupling |
How rigid clumps are coupled to the fluid. Options:
|
String |
members |
drag.model |
Drag law of clumps coupled as bodies; used only with Options:
|
String |
hoelzer_sommerfeld |
Below is an example of rigid clumps coupled to the fluid as bodies.
mfix.drag.model = Gidaspow
grain.shape = clump
dem.clump.coupling = body
dem.clump.drag.model = hoelzer_sommerfeld