Lethe Open-Source Library version 1.2.0
Developer Guide
Loading...
Searching...
No Matches
grid_birmingham_fluidized_bed.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) 2026 The Lethe Authors
2// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception OR LGPL-2.1-or-later
3
4#ifndef lethe_grid_birmingham_fluidized_bed_h
5#define lethe_grid_birmingham_fluidized_bed_h
6
7#include <deal.II/base/utilities.h>
8
9#include <deal.II/grid/manifold_lib.h>
10
11#include <array>
12#include <sstream>
13
14using namespace dealii;
15
16/**
17 * @brief Generates a 3D mesh for the Birmingham fluidized bed geometry.
18 *
19 * The geometry is taken from:
20 * P. Fede, O. Simonin, and A. Ingram, "3D numerical simulation of a
21 * lab-scale pressurized dense fluidized bed focussing on the effect of
22 * the particle-particle restitution coefficient and particle-wall boundary
23 * conditions," Chemical Engineering Science, vol. 142, pp. 215-235, 2016.
24 * DOI: 10.1016/j.ces.2015.11.016
25 *
26 * The geometry consists of three or four sections joined along the x-axis:
27 * - A bottom cylinder of small radius (0.077 m),
28 * - A truncated cone expanding from the small to a larger radius (0.127 m),
29 * - A top cylinder of the larger radius,
30 * - (optional) A rectangular chimney pipe extending from an off-center cell
31 * of the top end cap, serving as the outlet.
32 *
33 * The chimney is controlled by the @p enable_chimney constructor argument.
34 *
35 * Boundary IDs are assigned as follows:
36 * - 0: wall surfaces (curved cylinder/cone laterals; when the chimney is
37 * enabled this also includes the chimney walls and the annular top wall
38 * around the chimney opening),
39 * - 1: inlet end cap (x = -inlet_offset),
40 * - 2: outlet end cap (x = total length), or chimney top face when the
41 * chimney is enabled.
42 *
43 * A CylindricalManifold is attached to the curved lateral surfaces so that
44 * mesh refinement preserves the circular cross-sections and the cone taper.
45 * When the chimney is enabled, its walls and the annular top wall remain
46 * flat.
47 *
48 * @tparam dim The dimension of the mesh, must be 3.
49 * @tparam spacedim The dimension of the space, must be 3.
50 */
51template <int dim, int spacedim>
53{
54public:
55 /**
56 * @brief Constructor that parses grid parameters from a colon-separated
57 * string.
58 *
59 * @param[in] grid_arguments A string with the following format:
60 * @code "enable_chimney : inlet_offset" @endcode
61 *
62 * | # | Field | Format | Required | Description |
63 * |----|----------------|------------|----------|----------------------------------------------|
64 * | 0 | enable_chimney | true/false | no | Add chimney outlet (default: true) |
65 * | 1 | inlet_offset | double | no | Extend bottom cylinder into -x (default: 0.0) |
66 *
67 * Example: @code "true : 0.1" @endcode
68 */
70
71 /**
72 * @brief Generate the Birmingham fluidized bed mesh.
73 *
74 * The cylindrical geometry (bottom cylinder, truncated cone, top cylinder)
75 * is first merged and refined with a CylindricalManifold to obtain a
76 * finer mesh on the top end cap. The refined mesh is then flattened and
77 * an off-center face on the top end cap is selected for the chimney
78 * attachment. A hexahedral chimney pipe is built from that face's exact
79 * vertices and merged with the flattened mesh. The number of pre-chimney
80 * refinements is controlled by the hardcoded parameter
81 * @p n_chimney_refinements.
82 *
83 * @param[out] triangulation The triangulation to fill with the mesh.
84 */
85 void
86 make_grid(Triangulation<dim, spacedim> &triangulation);
87
88private:
89 /// Arguments used to generate the grid
90 std::string grid_arguments;
91
92 /// Flag used to indicate if the chimney is added or not to the mesh
94
95 /// Length by which the bottom cylinder extends into negative x
97};
98
99
100#endif
GridBirminghamFluidizedBed(const std::string &grid_arguments)
Constructor that parses grid parameters from a colon-separated string.
double inlet_offset
Length by which the bottom cylinder extends into negative x.
std::string grid_arguments
Arguments used to generate the grid.
void make_grid(Triangulation< dim, spacedim > &triangulation)
Generate the Birmingham fluidized bed mesh.
bool enable_chimney
Flag used to indicate if the chimney is added or not to the mesh.