Lethe Open-Source Library version 1.2.0
Developer Guide
Loading...
Searching...
No Matches
dem.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) 2020-2026 The Lethe Authors
2// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception OR LGPL-2.1-or-later
3
4#ifndef lethe_dem_h
5#define lethe_dem_h
6
9#include <core/pvd_handler.h>
10#include <core/serial_solid.h>
11
13#include <dem/data_containers.h>
19#include <dem/grid_motion.h>
20#include <dem/insertion.h>
21#include <dem/integrator.h>
22#include <dem/load_balancing.h>
28#include <dem/visualization.h>
29
30#include <deal.II/base/tensor.h>
31#include <deal.II/base/timer.h>
32
33#include <deal.II/distributed/tria.h>
34
35#include <deal.II/fe/mapping_q.h>
36
37#include <deal.II/particles/particle_handler.h>
38
39using namespace DEM;
40
41/**
42 * @brief Solver using the soft-sphere model of the discrete element method
43 * (DEM) to simulate granular systems.
44 * @tparam dim An integer that denotes the number of spatial dimensions.
45 * @tparam PropertiesIndex Index of the properties used within the ParticleHandler.
46 */
47template <int dim, typename PropertiesIndex>
49{
50public:
51 DEMSolver(DEMSolverParameters<dim> dem_parameters);
52
53 /**
54 * @brief Engine of the DEM solver. Calls all the necessary functions to set
55 * parameters, solve the simulation, and finish the simulation.
56 */
57 void
58 solve();
59
60private:
61 /**
62 * @brief Set the parameters for the DEM simulation
63 */
64 void
66
67 /**
68 * @brief Initialize the distribution type for the particles, and sets the
69 * maximum particle diameter and the neighborhood threshold squared in the
70 * process.
71 */
72 void
74
75 /**
76 * @brief Set up the solid object containers with serial objects.
77 * TODO: Modify this set up once the solid volumes are fully implemented.
78 */
79 void
81
82 /**
83 * @brief Set up the pointers to the functions and classes according to the
84 * parameters.
85 */
86 void
88
89 /**
90 * @brief Set the iteration check function according to the chosen
91 * contact detection method.
92 *
93 * @return Contact detection method function.
94 */
95 inline std::function<void()>
97
98 /**
99 * @brief Set the integration method.
100 *
101 * @return The pointer to the integration object
102 */
103 std::shared_ptr<Integrator<dim, PropertiesIndex>>
105
106 /**
107 * @brief Refine the triangulation within the user-specified refinement boxes.
108 *
109 * Each box is described by its own mesh; every cell of the background
110 * triangulation that lies within a box is refined the number of times
111 * requested for that box. Nothing is done when restarting, since the
112 * triangulation stored in the checkpoint already carries its refinement.
113 *
114 * @param[in] restart Flag indicating whether this is a restart.
115 */
116 void
117 box_refine_mesh(const bool restart);
118
119 /**
120 * @brief Set up the triangulation dependent parameters after the reading of
121 * the mesh and/or the simulation restart.
122 */
123 void
125
126 /**
127 * @brief Set up the background degree of freedom used for parallel grid
128 * output or mapping of periodic dofs when using periodic boundaries.
129 */
130 void
132
133 /**
134 * @brief Check if a load balancing is required according to the load
135 * balancing method and perform it if necessary.
136 */
137 void
138 load_balance();
139
140 /**
141 * @brief Establish if this is a contact detection iteration using the
142 * constant contact detection frequency.
143 * If the iteration number is a multiple of the frequency, this iteration is
144 * considered to be a contact detection iteration.
145 */
146 inline void
148
149 /**
150 * @brief Establish if this is a contact detection iteration using the
151 * maximal displacement of the particles. If this particle displacement
152 * surpasses a threshold, this iteration is a contact detection iteration.
153 */
154 inline void
156
157 /**
158 * @brief Check if particles have to be inserted at this iteration and
159 * perform it if necessary.
160 */
161 void
163
164 /**
165 * @brief Calculates particles-wall contact forces.
166 */
167 void
169
170 /**
171 * @brief Move all solid objects.
172 */
173 void
175
176 /**
177 * @brief Update solid objects temperatures.
178 */
179 void
181
182 /**
183 * @brief Update the temperatures of the walls of the grid.
184 */
185 void
187
188 /**
189 * @brief Check if a contact detection is required at the current iteration and,
190 * if it is, map the solid objects in the background triangulation, sort the
191 * particles into subdomains and cells and execute the particle-particle and
192 * particle-wall broad and fine searches. Otherwise, only update the ghost
193 * particles.
194 */
195 void
197
198 /**
199 * @brief Calculate the particle-particle and the particle-wall contact forces
200 * and torques at the current position of the particles.
201 */
202 void
204
205 /**
206 * @brief Carry out the closing half velocity step of a staggered integration
207 * scheme, which synchronizes the velocities of the particles with their
208 * positions at the final time. The contact forces are re-evaluated at the
209 * final position of the particles, hence n + 1 integration operations are
210 * carried out to complete n time steps.
211 */
212 void
214
215 /**
216 * @brief Execute the last post-processing at the end of the simulation and
217 * output test results if necessary.
218 */
219 void
221
222 /**
223 * @brief Generate VTU file with particles information for visualization.
224 */
225 void
227
228 /**
229 * @brief Calculate average velocity and other post-processed quantities that
230 * need to be outputted to files.
231 */
232 void
234
235 /**
236 * @brief Calculate statistics on the particles and report them to the
237 * terminal. This function is notably used to monitor the time min, max and
238 * total performed contact searches, and the instant min, max, avg and total
239 * values of the linear velocity, angular velocity, linear kinetic energy and
240 * angular kinetic.
241 */
242 void
244
245 /**
246 * @brief Execute the sorting of particle into subdomains and cells, and
247 * reinitialize the containers dependent on the local particle ids.
248 */
249 void
251
252
253 /**
254 * @brief Hook for particular operations that are related to the packed insertion.
255 *
256 * @return Boolean that indicates if the simulation should finish or not.
257 */
258 bool
260
261 /**
262 * @brief The MPI communicator used for the parallel simulation.
263 */
265
266 /**
267 * @brief The number of MPI processes used for the parallel simulation.
268 */
269 const unsigned int n_mpi_processes;
270
271 /**
272 * @brief The rank of the current MPI process.
273 */
274 const unsigned int this_mpi_process;
275
276 /**
277 * @brief The output stream used for the parallel simulation, only used by
278 * the process 0.
279 */
280 ConditionalOStream pcout;
281
282 /**
283 * @brief The parameters of the DEM simulation.
284 */
286
287 /**
288 * @brief The checkpoint controller of the DEM simulation.
289 */
291
292 /**
293 * @brief The distributed triangulation used for the DEM simulation.
294 */
295 parallel::distributed::Triangulation<dim> triangulation;
296
297 /**
298 * @brief The polynomial mapping. The mapping is first order in DEM
299 * simulations.
300 */
301 MappingQGeneric<dim> mapping;
302
303 /**
304 * @brief The particle handler that manages the particles.
305 */
306 Particles::ParticleHandler<dim, dim> particle_handler;
307
308 /**
309 * @brief The action manager that manages the actions triggered by events.
310 */
312
313 /**
314 * @brief The timer that keeps track of the time spent in some functions.
315 * Currently theses functions are: load balancing and VTU output.
316 */
317 TimerOutput computing_timer;
318
319 /**
320 * @brief The properties of the DEM simulation.
321 * @tparam dim An integer that denotes the number of spatial dimensions.
322 * @tparam PropertiesIndex Index of the properties used within the ParticleHandler.
323 */
325
326 /**
327 * @brief The acceleration acting on the particles.
328 */
329 Tensor<1, 3> g;
330
331 /**
332 * @brief The contact search frequency criterion for the dynamic contact
333 * detection method.
334 * The value is the smallest value between those two quantities:
335 * - The diameter of the smallest active cell of a triangulation minus the
336 * largest particle radius.
337 * \f$D_{c,min} - D_{p,max} / 2\f$
338 * - A security factor on the neighboring threshold times the largest particle
339 * radius.
340 * \f$factor * (neighborhood_threshold - 1) * D_{p,max} / 2\f$
341 */
343
344 /**
345 * @brief The smallest solid object mapping criterion.
346 * The value is \f$2^-0.5 * D_{c,min}\f$
347 */
349
350 /**
351 * @brief The neighborhood threshold squared.
352 * \f$(\text{neighborhood_threshold} * D_{p,max})^2\f$
353 */
355
356 /**
357 * @brief The maximum particle diameter.
358 */
360
361 /**
362 * @brief The counter to keep track of the number of contact search.
363 */
365
366 /**
367 * @brief The manager of all the contact search operations.
368 */
370
371 /**
372 * @brief The load balancing handler.
373 */
375
376 /**
377 * @brief The simulation control (DEM Transient).
378 */
379 std::shared_ptr<SimulationControl> simulation_control;
380
381 /**
382 * @brief The boundary cells object.
383 */
385
386 /**
387 * @brief The grid motion object.
388 */
389 std::shared_ptr<::GridMotionBase<dim>> grid_motion_object;
390
391 /**
392 * @brief The particle-particle contact force object.
393 */
394 std::shared_ptr<ParticleParticleContactForceBase<dim, PropertiesIndex>>
396
397 /**
398 * @brief The particle-wall contact force object.
399 */
400 std::shared_ptr<ParticleWallContactForceBase<dim, PropertiesIndex>>
402
403 /**
404 * @brief The particle-point-line contact force object.
405 */
408
409 /**
410 * @brief The particle force chains post-processing object.
411 */
412 std::shared_ptr<ParticlesForceChainsBase<dim, PropertiesIndex>>
414
415 /**
416 * @brief The integrator object.
417 */
418 std::shared_ptr<Integrator<dim, PropertiesIndex>> integrator_object;
419
420 /**
421 * @brief The insertion object.
422 */
423 std::shared_ptr<Insertion<dim, PropertiesIndex>> insertion_object;
424
425 /**
426 * @brief The visualization object.
427 */
429
430 /**
431 * @brief The particle PVD handler.
432 */
434
435 /**
436 * @brief The force chains PVD handler.
437 */
439
440 /**
441 * @brief Class object to store the vectors of force, torque and heat transfer rate applied to particles.
442 */
444
445 /**
446 * @brief The vector of torque of particles.
447 */
448 std::vector<Tensor<1, 3>> &torque = contact_outcome.torque;
449
450 /**
451 * @brief The vector of force of particles.
452 */
453 std::vector<Tensor<1, 3>> &force = contact_outcome.force;
454
455 /**
456 * @brief Class object to store the particle id, boundary id, velocity tensor, omega tensor and time of ongoing collisions.
457 */
459
460 /**
461 * @brief Class object to store the complete collision events (start and end).
462 */
464
465 /**
466 * @brief The displacement tracking of particles for the dynamic contact
467 * detection.
468 */
469 std::vector<double> displacement;
470
471 /**
472 * @brief The moment of inertia of particles.
473 */
474 std::vector<double> MOI;
475
476 /**
477 * @brief The vector of vector of pairs of the mapping of the background mesh
478 * to the solid surface.
479 */
482
483 /**
484 * @brief The vector of vector of pairs of the mapping of the background mesh
485 * to the solid volume.
486 */
489
490 /**
491 * @brief The map of the point and normal vector of grid.
492 * Only used with grid motion.
493 */
496
497 /**
498 * @brief The boundary information of the forces.
499 */
502
503 /**
504 * @brief The torques boundary information.
505 */
508
509 /**
510 * @brief The periodic boundaries cells information map.
511 * Only used with a simulation with periodic boundaries.
512 */
515
516 /**
517 * @brief The periodic boundaries manipulator.
518 * Only used with a simulation with periodic boundaries.
519 */
521
522 /**
523 * @brief The background degree of freedom handler uses for parallel grid
524 * processing.
525 */
526 DoFHandler<dim> background_dh;
527
528 /**
529 * @brief The grid PVD handler.
530 */
532
533 /**
534 * @brief The storage of statistics about time and contact lists
535 */
537
538 /**
539 * @brief The container of the solid surfaces.
540 */
541 std::vector<std::shared_ptr<SerialSolid<dim - 1, dim>>> solid_surfaces;
542
543 /**
544 * @brief The container of the solid volumes.
545 */
546 std::vector<std::shared_ptr<SerialSolid<dim, dim>>> solid_volumes;
547
548 /**
549 * @brief The container of the distribution objects.
550 */
551 std::vector<std::shared_ptr<Distribution>> size_distribution_object_container;
552
553 /**
554 * @brief The object handling the adaptive sparse contacts (ASC).
555 * Only used with the ASC method.
556 */
558
559 /**
560 * @brief The constraints for the background grid needed for the adaptive sparse.
561 */
562 AffineConstraints<double> background_constraints;
563
564 /**
565 * @brief The pointer to the function that checks if a load balancing is
566 * required.
567 */
569
570 /**
571 * @brief The pointer to the contact detection function that checks if a
572 * contact search is required.
573 */
575
576 /**
577 * @brief Disable position integration, useful for multiphysic simulations
578 * with a packed bed, loaded with another prm.
579 */
581};
582
583#endif
Mechanism that disables contacts computation through mobility status of cells based on granular tempe...
Finds all the boundary cells and faces in the triangulation, for each cell the boundary face is speci...
Class that stores all the completed collision events.
Manage the actions to be performed in the DEM solver and on the DEM part of the coupling CFD-DEM solv...
Manage the numerous of contact detection search operations in the DEM.
Handles all the parameters declared in the parameter handler file.
void setup_triangulation_dependent_parameters()
Set up the triangulation dependent parameters after the reading of the mesh and/or the simulation res...
Definition dem.cc:340
dem_data_structures< dim >::boundary_points_and_normal_vectors updated_boundary_points_and_normal_vectors
The map of the point and normal vector of grid. Only used with grid motion.
Definition dem.h:495
void particle_wall_contact_force()
Calculates particles-wall contact forces.
Definition dem.cc:561
void setup_functions_and_pointers()
Set up the pointers to the functions and classes according to the parameters.
Definition dem.cc:209
Tensor< 1, 3 > g
The acceleration acting on the particles.
Definition dem.h:329
dem_data_structures< dim >::vector_on_boundary forces_boundary_information
The boundary information of the forces.
Definition dem.h:501
std::vector< double > MOI
The moment of inertia of particles.
Definition dem.h:474
DEM::ParticleProperties< dim, PropertiesIndex > properties_class
The properties of the DEM simulation.
Definition dem.h:324
void compute_contact_forces()
Calculate the particle-particle and the particle-wall contact forces and torques at the current posit...
Definition dem.cc:776
ConditionalOStream pcout
The output stream used for the parallel simulation, only used by the process 0.
Definition dem.h:280
std::shared_ptr< Integrator< dim, PropertiesIndex > > set_integrator_type()
Set the integration method.
Definition dem.cc:275
void setup_solid_objects()
Set up the solid object containers with serial objects. TODO: Modify this set up once the solid volum...
Definition dem.cc:177
Particles::ParticleHandler< dim, dim > particle_handler
The particle handler that manages the particles.
Definition dem.h:306
dem_data_structures< dim >::vector_on_boundary torques_boundary_information
The torques boundary information.
Definition dem.h:507
void execute_contact_detection_and_search()
Check if a contact detection is required at the current iteration and, if it is, map the solid object...
Definition dem.cc:684
void box_refine_mesh(const bool restart)
Refine the triangulation within the user-specified refinement boxes.
Definition dem.cc:296
statistics contact_list
The storage of statistics about time and contact lists.
Definition dem.h:536
OngoingCollisionLog< dim > ongoing_collision_log
Class object to store the particle id, boundary id, velocity tensor, omega tensor and time of ongoing...
Definition dem.h:458
void solve()
Engine of the DEM solver. Calls all the necessary functions to set parameters, solve the simulation,...
Definition dem.cc:1158
ParticleInteractionOutcomes< PropertiesIndex > contact_outcome
Class object to store the vectors of force, torque and heat transfer rate applied to particles.
Definition dem.h:443
void setup_distribution_type()
Initialize the distribution type for the particles, and sets the maximum particle diameter and the ne...
Definition dem.cc:160
PVDHandler particles_pvdhandler
The particle PVD handler.
Definition dem.h:433
AffineConstraints< double > background_constraints
The constraints for the background grid needed for the adaptive sparse.
Definition dem.h:562
const unsigned int this_mpi_process
The rank of the current MPI process.
Definition dem.h:274
DoFHandler< dim > background_dh
The background degree of freedom handler uses for parallel grid processing.
Definition dem.h:526
DEM::dem_data_structures< dim >::periodic_boundaries_cells_info periodic_boundaries_cells_information
The periodic boundaries cells information map. Only used with a simulation with periodic boundaries.
Definition dem.h:514
double smallest_solid_object_mapping_criterion
The smallest solid object mapping criterion. The value is .
Definition dem.h:348
AdaptiveSparseContacts< dim, PropertiesIndex > sparse_contacts_object
The object handling the adaptive sparse contacts (ASC). Only used with the ASC method.
Definition dem.h:557
BoundaryCellsInformation< dim > boundary_cell_object
The boundary cells object.
Definition dem.h:384
std::shared_ptr< ParticleWallContactForceBase< dim, PropertiesIndex > > particle_wall_contact_force_object
The particle-wall contact force object.
Definition dem.h:401
const unsigned int n_mpi_processes
The number of MPI processes used for the parallel simulation.
Definition dem.h:269
void synchronize_velocities()
Carry out the closing half velocity step of a staggered integration scheme, which synchronizes the ve...
Definition dem.cc:805
double neighborhood_threshold_squared
The neighborhood threshold squared. .
Definition dem.h:354
std::function< void()> set_contact_search_iteration_function()
Set the iteration check function according to the chosen contact detection method.
Definition dem.cc:255
std::shared_ptr< SimulationControl > simulation_control
The simulation control (DEM Transient).
Definition dem.h:379
void check_contact_search_iteration_constant()
Establish if this is a contact detection iteration using the constant contact detection frequency....
Definition dem.cc:533
std::shared_ptr<::GridMotionBase< dim > > grid_motion_object
The grid motion object.
Definition dem.h:389
DEMSolverParameters< dim > parameters
The parameters of the DEM simulation.
Definition dem.h:285
Visualization< dim, PropertiesIndex > visualization_object
The visualization object.
Definition dem.h:428
std::shared_ptr< ParticleParticleContactForceBase< dim, PropertiesIndex > > particle_particle_contact_force_object
The particle-particle contact force object.
Definition dem.h:395
std::shared_ptr< ParticlesForceChainsBase< dim, PropertiesIndex > > particles_force_chains_object
The particle force chains post-processing object.
Definition dem.h:413
std::shared_ptr< Integrator< dim, PropertiesIndex > > integrator_object
The integrator object.
Definition dem.h:418
LagrangianLoadBalancing< dim, PropertiesIndex > load_balancing
The load balancing handler.
Definition dem.h:374
CompletedCollisionLog< dim > collision_event_log
Class object to store the complete collision events (start and end).
Definition dem.h:463
std::vector< std::shared_ptr< SerialSolid< dim - 1, dim > > > solid_surfaces
The container of the solid surfaces.
Definition dem.h:541
PVDHandler particles_pvdhandler_force_chains
The force chains PVD handler.
Definition dem.h:438
std::vector< Tensor< 1, 3 > > & torque
The vector of torque of particles.
Definition dem.h:448
DEMSolver(DEMSolverParameters< dim > dem_parameters)
Definition dem.cc:39
void setup_parameters()
Set the parameters for the DEM simulation.
Definition dem.cc:63
MappingQGeneric< dim > mapping
The polynomial mapping. The mapping is first order in DEM simulations.
Definition dem.h:301
void report_statistics()
Calculate statistics on the particles and report them to the terminal. This function is notably used ...
Definition dem.cc:990
MPI_Comm mpi_communicator
The MPI communicator used for the parallel simulation.
Definition dem.h:264
void check_contact_search_iteration_dynamic()
Establish if this is a contact detection iteration using the maximal displacement of the particles....
Definition dem.cc:517
std::vector< double > displacement
The displacement tracking of particles for the dynamic contact detection.
Definition dem.h:469
void insert_particles()
Check if particles have to be inserted at this iteration and perform it if necessary.
Definition dem.cc:542
void setup_background_dofs()
Set up the background degree of freedom used for parallel grid output or mapping of periodic dofs whe...
Definition dem.cc:394
CheckpointControl checkpoint_controller
The checkpoint controller of the DEM simulation.
Definition dem.h:290
void load_balance()
Check if a load balancing is required according to the load balancing method and perform it if necess...
Definition dem.cc:441
double maximum_particle_diameter
The maximum particle diameter.
Definition dem.h:359
void update_temperature_solid_objects()
Update solid objects temperatures.
Definition dem.cc:648
void move_solid_objects()
Move all solid objects.
Definition dem.cc:628
std::vector< std::shared_ptr< SerialSolid< dim, dim > > > solid_volumes
The container of the solid volumes.
Definition dem.h:546
std::function< bool()> load_balance_iteration_check_function
The pointer to the function that checks if a load balancing is required.
Definition dem.h:568
bool disable_position_integration
Disable position integration, useful for multiphysic simulations with a packed bed,...
Definition dem.h:580
std::vector< Tensor< 1, 3 > > & force
The vector of force of particles.
Definition dem.h:453
std::shared_ptr< Insertion< dim, PropertiesIndex > > insertion_object
The insertion object.
Definition dem.h:423
double smallest_contact_search_criterion
The contact search frequency criterion for the dynamic contact detection method. The value is the sma...
Definition dem.h:342
void write_output_results()
Generate VTU file with particles information for visualization.
Definition dem.cc:903
DEMActionManager * action_manager
The action manager that manages the actions triggered by events.
Definition dem.h:311
std::function< void()> contact_detection_iteration_check_function
The pointer to the contact detection function that checks if a contact search is required.
Definition dem.h:574
dem_data_structures< dim >::solid_volumes_mesh_info solid_volumes_mesh_info
The vector of vector of pairs of the mapping of the background mesh to the solid volume.
Definition dem.h:488
std::vector< std::shared_ptr< Distribution > > size_distribution_object_container
The container of the distribution objects.
Definition dem.h:551
PeriodicBoundariesManipulator< dim > periodic_boundaries_object
The periodic boundaries manipulator. Only used with a simulation with periodic boundaries.
Definition dem.h:520
void finish_simulation()
Execute the last post-processing at the end of the simulation and output test results if necessary.
Definition dem.cc:833
dem_data_structures< dim >::solid_surfaces_mesh_information solid_surfaces_mesh_info
The vector of vector of pairs of the mapping of the background mesh to the solid surface.
Definition dem.h:481
PVDHandler grid_pvdhandler
The grid PVD handler.
Definition dem.h:531
ParticlePointLineForce< dim, PropertiesIndex > particle_point_line_contact_force_object
The particle-point-line contact force object.
Definition dem.h:407
bool packed_insertion_report_and_status()
Hook for particular operations that are related to the packed insertion.
Definition dem.cc:1106
parallel::distributed::Triangulation< dim > triangulation
The distributed triangulation used for the DEM simulation.
Definition dem.h:295
void update_temperature_walls()
Update the temperatures of the walls of the grid.
Definition dem.cc:672
void sort_particles_into_subdomains_and_cells()
Execute the sorting of particle into subdomains and cells, and reinitialize the containers dependent ...
Definition dem.cc:1070
TimerOutput computing_timer
The timer that keeps track of the time spent in some functions. Currently theses functions are: load ...
Definition dem.h:317
unsigned int contact_build_number
The counter to keep track of the number of contact search.
Definition dem.h:364
DEMContactManager< dim, PropertiesIndex > contact_manager
The manager of all the contact search operations.
Definition dem.h:369
void post_process_results()
Calculate average velocity and other post-processed quantities that need to be outputted to files.
Definition dem.cc:970
Controls the name of output variables for the vtu.
Manages the load balancing (repartitioning), of the domain according to the computational load of the...
Class managing the ongoing collisions.
The PVDHandler class manages the storage of the information required to write pvd file....
Definition pvd_handler.h:17
Class where the outcomes of particle-particle interactions are stored.
Calculate the non-linear particle-point and particle-line contact force using the information obtaine...
Building patches of particle properties for visualization. This function is taken from Aspect and dea...
A simple container for storing basic statistical values.
Definition utilities.h:56
DEM particle property definitions and output name management.
This namespace defines all the data containers and required operations on these containers for the DE...
std::vector< std::vector< std::pair< typename Triangulation< dim >::active_cell_iterator, typename Triangulation< dim - 1, dim >::active_cell_iterator > > > solid_surfaces_mesh_information
ankerl::unordered_dense::map< unsigned int, std::map< types::boundary_id, Tensor< 1, 3 > > > vector_on_boundary
ankerl::unordered_dense::map< global_face_id, std::pair< Tensor< 1, 3 >, Point< 3 > > > boundary_points_and_normal_vectors
std::unordered_multimap< types::global_cell_index, periodic_boundaries_cells_info_struct< dim > > periodic_boundaries_cells_info
std::vector< std::vector< std::pair< typename Triangulation< dim >::active_cell_iterator, typename Triangulation< dim, dim >::active_cell_iterator > > > solid_volumes_mesh_info