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 clump type is a rigid clump: its members move as one body.

  • A grain of a sphere type is a bonded agglomerate: its members are free spheres joined by initial bonds, which can break. This needs dem.bonds.solid.model other than none, dem.bonds.initialization = contact and dem.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:

  • grain - the members share the grain’s mass

  • members - each member has the grain density

String

grain

drag

Which drag data rigid clumps take when they are coupled to the fluid as bodies (dem.clump.coupling = body): the volume-equivalent diameter, sphericity, creeping-flow resistance and orientation tables. Not used otherwise.

Options:

  • grain - those of the grain the template was designed from

  • members - those of the union of the member spheres

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:

  • members - each member sphere takes drag from mfix.drag.model as a free sphere would

  • body - each clump takes drag as one body, from its template’s drag data (dem.templates.[template_name].drag), and its members share it; needs mfix.drag.model = Gidaspow or WenYu

String

members

drag.model

Drag law of clumps coupled as bodies; used only with coupling = body.

Options:

  • hoelzer_sommerfeld - Hölzer and Sommerfeld (2008): the drag depends on the clump’s orientation to the flow, through its crosswise and lengthwise sphericities and its creeping-flow resistance

  • haider_levenspiel - Haider and Levenspiel (1989): from the clump’s sphericity alone

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