Lethe Open-Source Library version 1.2.0
Developer Guide
Loading...
Searching...
No Matches
lagrangian_post_processing.cc
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) 2021-2026 The Lethe Authors
2// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception OR LGPL-2.1-or-later
3
6
8
9#include <deal.II/dofs/dof_handler.h>
10
11#include <deal.II/numerics/data_out.h>
12
13using namespace dealii;
14
15template <int dim, typename PropertiesIndex>
16void
18 const parallel::distributed::Triangulation<dim> &triangulation,
19 const Particles::ParticleHandler<dim> &particle_handler,
20 Vector<double> &velocity_average_x,
21 Vector<double> &velocity_average_y,
22 Vector<double> &velocity_average_z,
23 Vector<double> &velocity_average_magnitude)
24{
25 // Iterating through the active cells in the triangulation
26 for (const auto &cell : triangulation.active_cell_iterators())
27 {
28 if (cell->is_locally_owned())
29 {
30 Tensor<1, dim> cell_velocity_average =
32 cell, particle_handler);
33
34 velocity_average_x[cell->active_cell_index()] =
35 cell_velocity_average[0];
36 velocity_average_y[cell->active_cell_index()] =
37 cell_velocity_average[1];
38
39 if constexpr (dim == 3)
40 {
41 velocity_average_z[cell->active_cell_index()] =
42 cell_velocity_average[2];
43 velocity_average_magnitude[cell->active_cell_index()] =
44 sqrt(pow(cell_velocity_average[0], 2) +
45 pow(cell_velocity_average[1], 2) +
46 pow(cell_velocity_average[2], 2));
47 }
48
49 if constexpr (dim == 2)
50 velocity_average_magnitude[cell->active_cell_index()] =
51 sqrt(pow(cell_velocity_average[0], 2) +
52 pow(cell_velocity_average[1], 2));
53 }
54 }
55}
56
57template <int dim, typename PropertiesIndex>
58void
60 const parallel::distributed::Triangulation<dim> &triangulation,
61 const Particles::ParticleHandler<dim> &particle_handler,
62 Vector<double> &granular_temperature_average)
63{
64 // Iterating through the active cells in the triangulation
65 for (const auto &cell : triangulation.active_cell_iterators())
66 {
67 if (cell->is_locally_owned())
68 {
69 double granular_temperature_cell(0);
70 unsigned int particles_cell_number(0);
71
72 // Looping through all the particles in the cell
73 // Particles in the cell
74 typename Particles::ParticleHandler<dim>::particle_iterator_range
75 particles_in_cell = particle_handler.particles_in_cell(cell);
76
77 const bool particles_exist_in_main_cell = !particles_in_cell.empty();
78 // Check to see if the cell has any particles
79 if (particles_exist_in_main_cell)
80 {
81 Tensor<1, dim> velocity_in_cell_average =
83 cell, particle_handler);
84
85 // Initializing velocity fluctuations
86 Tensor<1, dim> cell_velocity_fluctuation_squared_sum =
87 Tensor<1, dim>();
88 Tensor<1, dim> cell_velocity_fluctuation_squared_average =
89 Tensor<1, dim>();
90
91 for (typename Particles::ParticleHandler<
92 dim>::particle_iterator_range::iterator
93 particles_in_cell_iterator = particles_in_cell.begin();
94 particles_in_cell_iterator != particles_in_cell.end();
95 ++particles_in_cell_iterator)
96 {
97 auto particle_properties =
98 particles_in_cell_iterator->get_properties();
99
100 for (int d = 0; d < dim; ++d)
101 {
102 cell_velocity_fluctuation_squared_sum[d] +=
103 (particle_properties[PropertiesIndex::v_x + d] -
104 velocity_in_cell_average[d]) *
105 (particle_properties[PropertiesIndex::v_x + d] -
106 velocity_in_cell_average[d]);
107 }
108
109 particles_cell_number++;
110 }
111 // Calculate average granular temperature in the cell
112 for (int d = 0; d < dim; ++d)
113 {
114 cell_velocity_fluctuation_squared_average[d] =
115 cell_velocity_fluctuation_squared_sum[d] /
116 particles_cell_number;
117 granular_temperature_cell +=
118 (1.0 / dim) * cell_velocity_fluctuation_squared_average[d];
119 }
120 }
121 granular_temperature_average[cell->active_cell_index()] =
122 granular_temperature_cell;
123 }
124 }
125}
126
127template <int dim, typename PropertiesIndex>
128Tensor<1, dim>
130 const typename parallel::distributed::Triangulation<dim>::cell_iterator &cell,
131 const Particles::ParticleHandler<dim> &particle_handler)
132{
133 Tensor<1, dim> velocity_cell_sum = Tensor<1, dim>();
134 Tensor<1, dim> velocity_cell_average = Tensor<1, dim>();
135 unsigned int particles_cell_number(0);
136
137 // Looping through all the particles in the cell
138 // Particles in the cell
139 typename Particles::ParticleHandler<dim>::particle_iterator_range
140 particles_in_cell = particle_handler.particles_in_cell(cell);
141
142 const bool particles_exist_in_main_cell = !particles_in_cell.empty();
143
144 // Check to see if the cell has any particles
145 if (particles_exist_in_main_cell)
146 {
147 for (typename Particles::ParticleHandler<dim>::particle_iterator_range::
148 iterator particles_in_cell_iterator = particles_in_cell.begin();
149 particles_in_cell_iterator != particles_in_cell.end();
150 ++particles_in_cell_iterator)
151 {
152 auto particle_properties =
153 particles_in_cell_iterator->get_properties();
154
155 for (int d = 0; d < dim; ++d)
156 {
157 velocity_cell_sum[d] +=
158 particle_properties[PropertiesIndex::v_x + d];
159 }
160
161 particles_cell_number++;
162 }
163 // Calculate average velocity in the cell
164 for (int d = 0; d < dim; ++d)
165 velocity_cell_average[d] = velocity_cell_sum[d] / particles_cell_number;
166 }
167 return velocity_cell_average;
168}
169
170template <int dim, typename PropertiesIndex>
171void
173 const parallel::distributed::Triangulation<dim> &triangulation,
174 PVDHandler &grid_pvdhandler,
175 const DoFHandler<dim> &background_dh,
176 const Particles::ParticleHandler<dim> &particle_handler,
177 const DEMSolverParameters<dim> &dem_parameters,
178 const double current_time,
179 const unsigned int step_number,
180 const MPI_Comm &mpi_communicator,
181 AdaptiveSparseContacts<dim, PropertiesIndex> &sparse_contacts_object)
182{
183 const std::string folder = dem_parameters.simulation_control.output_folder;
184 const std::string particles_solution_name =
185 dem_parameters.simulation_control.output_name;
186 const unsigned int group_files =
187 dem_parameters.simulation_control.group_files;
188
189 DataOut<dim> data_out;
190 data_out.attach_dof_handler(background_dh);
191
192 // Write particles' average velocity
193 Vector<double> velocity_average_x(triangulation.n_active_cells());
194 Vector<double> velocity_average_y(triangulation.n_active_cells());
195 Vector<double> velocity_average_z(triangulation.n_active_cells());
196 Vector<double> velocity_average_magnitude(triangulation.n_active_cells());
198 triangulation,
199 particle_handler,
200 velocity_average_x,
201 velocity_average_y,
202 velocity_average_z,
203 velocity_average_magnitude);
204
205 data_out.add_data_vector(velocity_average_x,
206 "average_velocity_x",
207 DataOut<dim>::type_cell_data);
208 data_out.add_data_vector(velocity_average_y,
209 "average_velocity_y",
210 DataOut<dim>::type_cell_data);
211
212 if constexpr (dim == 3)
213 data_out.add_data_vector(velocity_average_z,
214 "average_velocity_z",
215 DataOut<dim>::type_cell_data);
216
217 data_out.add_data_vector(velocity_average_magnitude,
218 "average_velocity_magnitude",
219 DataOut<dim>::type_cell_data);
220
221 // Write particles' granular temperature
222 Vector<double> granular_temperature_average(triangulation.n_active_cells());
224 triangulation, particle_handler, granular_temperature_average);
225
226
227 data_out.add_data_vector(granular_temperature_average,
228 "granular_temperature",
229 DataOut<dim>::type_cell_data);
230
231 // Write mobility status of cells
232 Vector<float> mobility_status(triangulation.n_active_cells());
233 sparse_contacts_object.get_mobility_status_vector(mobility_status);
234 data_out.add_data_vector(mobility_status,
235 "mobility_status",
236 DataOut<dim>::type_cell_data);
237
238 // Attach the solution data to data_out object
239 Vector<float> subdomain(triangulation.n_active_cells());
240 for (unsigned int i = 0; i < subdomain.size(); ++i)
241 subdomain(i) = triangulation.locally_owned_subdomain();
242 data_out.add_data_vector(subdomain, "subdomain");
243
244 const std::string postprocess_file_name =
245 dem_parameters.simulation_control.output_name +
246 "_lagrangian_postprocessing";
247
248 data_out.build_patches();
249
250 write_vtu_and_pvd<dim>(grid_pvdhandler,
251 data_out,
252 folder,
253 postprocess_file_name,
254 current_time,
255 step_number,
256 group_files,
257 mpi_communicator);
258}
259
260template void
262 const parallel::distributed::Triangulation<2> &triangulation,
263 PVDHandler &grid_pvdhandler,
264 const DoFHandler<2> &background_dh,
265 const Particles::ParticleHandler<2> &particle_handler,
266 const DEMSolverParameters<2> &dem_parameters,
267 const double current_time,
268 const unsigned int step_number,
269 const MPI_Comm &mpi_communicator,
271 &sparse_contacts_object);
272
273template void
275 const parallel::distributed::Triangulation<2> &triangulation,
276 PVDHandler &grid_pvdhandler,
277 const DoFHandler<2> &background_dh,
278 const Particles::ParticleHandler<2> &particle_handler,
279 const DEMSolverParameters<2> &dem_parameters,
280 const double current_time,
281 const unsigned int step_number,
282 const MPI_Comm &mpi_communicator,
284 &sparse_contacts_object);
285
286template void
288 const parallel::distributed::Triangulation<2> &triangulation,
289 PVDHandler &grid_pvdhandler,
290 const DoFHandler<2> &background_dh,
291 const Particles::ParticleHandler<2> &particle_handler,
292 const DEMSolverParameters<2> &dem_parameters,
293 const double current_time,
294 const unsigned int step_number,
295 const MPI_Comm &mpi_communicator,
297 &sparse_contacts_object);
298
299template void
301 const parallel::distributed::Triangulation<2> &triangulation,
302 PVDHandler &grid_pvdhandler,
303 const DoFHandler<2> &background_dh,
304 const Particles::ParticleHandler<2> &particle_handler,
305 const DEMSolverParameters<2> &dem_parameters,
306 const double current_time,
307 const unsigned int step_number,
308 const MPI_Comm &mpi_communicator,
310 &sparse_contacts_object);
311
312template void
314 const parallel::distributed::Triangulation<3> &triangulation,
315 PVDHandler &grid_pvdhandler,
316 const DoFHandler<3> &background_dh,
317 const Particles::ParticleHandler<3> &particle_handler,
318 const DEMSolverParameters<3> &dem_parameters,
319 const double current_time,
320 const unsigned int step_number,
321 const MPI_Comm &mpi_communicator,
323 &sparse_contacts_object);
324
325template void
327 const parallel::distributed::Triangulation<3> &triangulation,
328 PVDHandler &grid_pvdhandler,
329 const DoFHandler<3> &background_dh,
330 const Particles::ParticleHandler<3> &particle_handler,
331 const DEMSolverParameters<3> &dem_parameters,
332 const double current_time,
333 const unsigned int step_number,
334 const MPI_Comm &mpi_communicator,
336 &sparse_contacts_object);
337
338template void
340 const parallel::distributed::Triangulation<3> &triangulation,
341 PVDHandler &grid_pvdhandler,
342 const DoFHandler<3> &background_dh,
343 const Particles::ParticleHandler<3> &particle_handler,
344 const DEMSolverParameters<3> &dem_parameters,
345 const double current_time,
346 const unsigned int step_number,
347 const MPI_Comm &mpi_communicator,
349 &sparse_contacts_object);
350
351template void
353 const parallel::distributed::Triangulation<3> &triangulation,
354 PVDHandler &grid_pvdhandler,
355 const DoFHandler<3> &background_dh,
356 const Particles::ParticleHandler<3> &particle_handler,
357 const DEMSolverParameters<3> &dem_parameters,
358 const double current_time,
359 const unsigned int step_number,
360 const MPI_Comm &mpi_communicator,
362 &sparse_contacts_object);
363
364template Tensor<1, 2>
367 const parallel::distributed::Triangulation<2>::cell_iterator &cell,
368 const Particles::ParticleHandler<2> &particle_handler);
369
370template Tensor<1, 2>
372 2,
374 const parallel::distributed::Triangulation<2>::cell_iterator &cell,
375 const Particles::ParticleHandler<2> &particle_handler);
376
377template Tensor<1, 2>
379 2,
381 const parallel::distributed::Triangulation<2>::cell_iterator &cell,
382 const Particles::ParticleHandler<2> &particle_handler);
383
384template Tensor<1, 2>
386 2,
388 const parallel::distributed::Triangulation<2>::cell_iterator &cell,
389 const Particles::ParticleHandler<2> &particle_handler);
390
391template Tensor<1, 3>
394 const parallel::distributed::Triangulation<3>::cell_iterator &cell,
395 const Particles::ParticleHandler<3> &particle_handler);
396
397template Tensor<1, 3>
399 3,
401 const parallel::distributed::Triangulation<3>::cell_iterator &cell,
402 const Particles::ParticleHandler<3> &particle_handler);
403
404template Tensor<1, 3>
406 3,
408 const parallel::distributed::Triangulation<3>::cell_iterator &cell,
409 const Particles::ParticleHandler<3> &particle_handler);
410
411template Tensor<1, 3>
413 3,
415 const parallel::distributed::Triangulation<3>::cell_iterator &cell,
416 const Particles::ParticleHandler<3> &particle_handler);
Mechanism that disables contacts computation through mobility status of cells based on granular tempe...
void get_mobility_status_vector(Vector< float > &status)
Convert the map of mobility status to a vector of mobility status because map cannot be used as is in...
Handles all the parameters declared in the parameter handler file.
Parameters::SimulationControl simulation_control
The PVDHandler class manages the storage of the information required to write pvd file....
Definition pvd_handler.h:17
DEM particle property definitions and output name management.
template void write_post_processing_results< 3, DEM::DEMProperties::PropertiesIndex >(const parallel::distributed::Triangulation< 3 > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< 3 > &background_dh, const Particles::ParticleHandler< 3 > &particle_handler, const DEMSolverParameters< 3 > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< 3, DEM::DEMProperties::PropertiesIndex > &sparse_contacts_object)
template void write_post_processing_results< 2, DEM::CFDDEMMPProperties::PropertiesIndex >(const parallel::distributed::Triangulation< 2 > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< 2 > &background_dh, const Particles::ParticleHandler< 2 > &particle_handler, const DEMSolverParameters< 2 > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< 2, DEM::CFDDEMMPProperties::PropertiesIndex > &sparse_contacts_object)
Tensor< 1, dim > calculate_cell_average_particles_velocity(const typename parallel::distributed::Triangulation< dim >::cell_iterator &cell, const Particles::ParticleHandler< dim > &particle_handler)
Carries out the calculation of average particles velocity for a single cell. It is defined as a separ...
void calculate_average_particles_velocity(const parallel::distributed::Triangulation< dim > &triangulation, const Particles::ParticleHandler< dim > &particle_handler, Vector< double > &velocity_average_x, Vector< double > &velocity_average_y, Vector< double > &velocity_average_z, Vector< double > &velocity_average_magnitude)
Carries out the calculation of the average particles velocity in each local cell. These values are su...
template void write_post_processing_results< 2, DEM::DEMProperties::PropertiesIndex >(const parallel::distributed::Triangulation< 2 > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< 2 > &background_dh, const Particles::ParticleHandler< 2 > &particle_handler, const DEMSolverParameters< 2 > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< 2, DEM::DEMProperties::PropertiesIndex > &sparse_contacts_object)
template void write_post_processing_results< 3, DEM::CFDDEMProperties::PropertiesIndex >(const parallel::distributed::Triangulation< 3 > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< 3 > &background_dh, const Particles::ParticleHandler< 3 > &particle_handler, const DEMSolverParameters< 3 > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< 3, DEM::CFDDEMProperties::PropertiesIndex > &sparse_contacts_object)
template void write_post_processing_results< 3, DEM::CFDDEMMPProperties::PropertiesIndex >(const parallel::distributed::Triangulation< 3 > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< 3 > &background_dh, const Particles::ParticleHandler< 3 > &particle_handler, const DEMSolverParameters< 3 > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< 3, DEM::CFDDEMMPProperties::PropertiesIndex > &sparse_contacts_object)
template void write_post_processing_results< 2, DEM::CFDDEMProperties::PropertiesIndex >(const parallel::distributed::Triangulation< 2 > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< 2 > &background_dh, const Particles::ParticleHandler< 2 > &particle_handler, const DEMSolverParameters< 2 > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< 2, DEM::CFDDEMProperties::PropertiesIndex > &sparse_contacts_object)
template void write_post_processing_results< 3, DEM::DEMMPProperties::PropertiesIndex >(const parallel::distributed::Triangulation< 3 > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< 3 > &background_dh, const Particles::ParticleHandler< 3 > &particle_handler, const DEMSolverParameters< 3 > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< 3, DEM::DEMMPProperties::PropertiesIndex > &sparse_contacts_object)
void calculate_average_granular_temperature(const parallel::distributed::Triangulation< dim > &triangulation, const Particles::ParticleHandler< dim > &particle_handler, Vector< double > &granular_temperature_average)
Carries out the calculation of the granular temperature in each local cell. These values are summed u...
void write_post_processing_results(const parallel::distributed::Triangulation< dim > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< dim > &background_dh, const Particles::ParticleHandler< dim > &particle_handler, const DEMSolverParameters< dim > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< dim, PropertiesIndex > &sparse_contacts_object)
Carries out writing the cell data of the domain.
template void write_post_processing_results< 2, DEM::DEMMPProperties::PropertiesIndex >(const parallel::distributed::Triangulation< 2 > &triangulation, PVDHandler &grid_pvdhandler, const DoFHandler< 2 > &background_dh, const Particles::ParticleHandler< 2 > &particle_handler, const DEMSolverParameters< 2 > &dem_parameters, const double current_time, const unsigned int step_number, const MPI_Comm &mpi_communicator, AdaptiveSparseContacts< 2, DEM::DEMMPProperties::PropertiesIndex > &sparse_contacts_object)
Tensor< 1, dim > calculate_cell_average_particles_velocity(const typename parallel::distributed::Triangulation< dim >::cell_iterator &cell, const Particles::ParticleHandler< dim > &particle_handler)
Carries out the calculation of average particles velocity for a single cell. It is defined as a separ...
PropertiesIndex
Particle property indices for CFD-DEM multiphysics simulations.
PropertiesIndex
Particle property indices for CFD-DEM simulations.
PropertiesIndex
Particle property indices for DEM multiphysics simulations.
PropertiesIndex
Particle property indices for pure DEM simulations.
void write_vtu_and_pvd(PVDHandler &pvd_handler, const DataOutInterface< dim, spacedim > &data_out, const std::string &folder, const std::string &file_prefix, const double time, const unsigned int iter, const unsigned int group_files, const MPI_Comm &mpi_communicator, const unsigned int digits=5)
Output the data out to "group_files" vtu files, with a pvtu file and a pvd to store the timing This f...
unsigned int group_files
Number of vtu files written at an output step.
Definition parameters.h:234