![]() |
Lethe Open-Source Library version 1.2.0
Developer Guide
|
#include <dem_contact_manager.h>
Public Member Functions | |
| void | execute_cell_neighbors_search (const parallel::distributed::Triangulation< dim > &triangulation, const typename DEM::dem_data_structures< dim >::periodic_boundaries_cells_info &periodic_boundaries_cells_information) |
| void | update_cell_neighbors (const parallel::distributed::Triangulation< dim > &triangulation, const typename DEM::dem_data_structures< dim >::periodic_boundaries_cells_info &periodic_boundaries_cells_information) |
| void | update_contacts () |
| void | update_local_particles_in_cells (const Particles::ParticleHandler< dim > &particle_handler) |
| void | execute_particle_particle_broad_search (dealii::Particles::ParticleHandler< dim > &particle_handler, const AdaptiveSparseContacts< dim, PropertiesIndex > &sparse_particle_contact_object) |
| void | execute_particle_wall_broad_search (const Particles::ParticleHandler< dim > &particle_handler, BoundaryCellsInformation< dim > &boundary_cell_object, const typename dem_data_structures< dim >::solid_surfaces_mesh_information &solid_surfaces_mesh_info, const Parameters::Lagrangian::FloatingWalls< dim > &floating_walls, const double simulation_time, const AdaptiveSparseContacts< dim, PropertiesIndex > &sparse_particle_contact_object) |
| void | execute_particle_particle_fine_search (const double neighborhood_threshold) |
| void | execute_particle_wall_fine_search (const Parameters::Lagrangian::FloatingWalls< dim > &floating_walls, const double simulation_time, const double neighborhood_threshold) |
| void | set_periodic_offset_per_direction (const std::array< double, dim > &offset_per_direction) |
| dem_data_structures< dim >::particle_floating_mesh_potentially_in_contact & | get_particle_floating_mesh_potentially_in_contact () |
| dem_data_structures< dim >::particle_wall_in_contact & | get_particle_floating_wall_in_contact () |
| dem_data_structures< dim >::particle_wall_in_contact & | get_particle_wall_in_contact () |
| dem_data_structures< dim >::particle_line_candidates & | get_particle_lines_in_contact () |
| dem_data_structures< dim >::particle_point_candidates & | get_particle_points_in_contact () |
| dem_data_structures< dim >::adjacent_particle_pairs & | get_local_adjacent_particles () |
| dem_data_structures< dim >::adjacent_particle_pairs & | get_ghost_adjacent_particles () |
| dem_data_structures< dim >::periodic_adjacent_particle_pairs & | get_local_local_periodic_adjacent_particles () |
| dem_data_structures< dim >::periodic_adjacent_particle_pairs & | get_local_ghost_periodic_adjacent_particles () |
| dem_data_structures< dim >::periodic_adjacent_particle_pairs & | get_ghost_local_periodic_adjacent_particles () |
| dem_data_structures< dim >::particle_particle_candidates & | get_local_contact_pair_candidates () |
| dem_data_structures< dim >::particle_particle_candidates & | get_ghost_contact_pair_candidates () |
Manage the numerous of contact detection search operations in the DEM.
This class mostly calls proper functions in regards the type of contacts for the contact detection and updates of data containers.
| dim | An integer that denotes the number of spatial dimensions. |
| PropertiesIndex | Index of the properties used within the ParticleHandler. |
Definition at line 29 of file dem_contact_manager.h.
| void DEMContactManager< dim, PropertiesIndex >::execute_cell_neighbors_search | ( | const parallel::distributed::Triangulation< dim > & | triangulation, |
| const typename DEM::dem_data_structures< dim >::periodic_boundaries_cells_info & | periodic_boundaries_cells_information ) |
Execute functions to find the lists of cell neighbors of the active cells in the triangulation.
For contacts of particles, the neighbor search excludes the repetitions of neighbors: B is neighbor of A but A will not be neighbor of B. For contacts of particles with floating meshes, the neighbor search includes all neighbors. These floating mesh contacts searches need all the particles located in all the neighbor cells of the main cell to detect collisions with the floating mesh.
| [in] | triangulation | The triangulation to access the information of the cells. |
| [in] | periodic_boundaries_cells_information | Information of periodic cells used if periodic boundaries are enabled (next parameter). |
Definition at line 19 of file dem_contact_manager.cc.
References cells_ghost_local_periodic_neighbor_list, cells_ghost_neighbor_list, cells_ghost_periodic_neighbor_list, cells_local_neighbor_list, cells_local_periodic_neighbor_list, find_cell_neighbors(), find_cell_periodic_neighbors(), find_full_cell_neighbors(), DEMActionManager::get_action_manager(), and total_neighbor_list.
| void DEMContactManager< dim, PropertiesIndex >::execute_particle_particle_broad_search | ( | dealii::Particles::ParticleHandler< dim > & | particle_handler, |
| const AdaptiveSparseContacts< dim, PropertiesIndex > & | sparse_particle_contact_object ) |
Execute the particle-particle broad searches with adaptive sparse contacts.
Calls proper functions to find the candidates of local and ghost particle-particle contact pairs and the periodic particle-particle contacts if required. These contact pairs will be used in the fine search step to investigate if they are in contact. It checks if the adaptive sparse contacts is enabled and use proper functions.
| [in,out] | particle_handler | Storage of particles and their accessor functions. |
| [in] | sparse_particle_contact_object | Allow to check the mobility status of cells. |
Definition at line 240 of file dem_contact_manager.cc.
References cells_ghost_local_periodic_neighbor_list, cells_ghost_neighbor_list, cells_ghost_periodic_neighbor_list, cells_local_neighbor_list, cells_local_periodic_neighbor_list, find_particle_particle_contact_pairs(), find_particle_particle_periodic_contact_pairs(), DEMActionManager::get_action_manager(), ghost_contact_pair_candidates, ghost_contact_pair_periodic_candidates, ghost_local_contact_pair_periodic_candidates, local_contact_pair_candidates, and local_contact_pair_periodic_candidates.
| void DEMContactManager< dim, PropertiesIndex >::execute_particle_particle_fine_search | ( | const double | neighborhood_threshold | ) |
Execute the particle-particles fine searches.
Executes functions that update the particle contacts pairs containers and compute the contact information of the collision pairs.
| [in] | neighborhood_threshold | Threshold value of contact detection. |
Definition at line 406 of file dem_contact_manager.cc.
References DEMActionManager::get_action_manager(), ghost_adjacent_particles, ghost_contact_pair_candidates, ghost_contact_pair_periodic_candidates, ghost_local_contact_pair_periodic_candidates, ghost_local_periodic_adjacent_particles, ghost_local_periodic_particle_particle, local_adjacent_particles, local_contact_pair_candidates, local_contact_pair_periodic_candidates, local_ghost_periodic_adjacent_particles, local_local_periodic_adjacent_particles, particle_container, particle_particle_fine_search(), and periodic_offset_per_direction.
| void DEMContactManager< dim, PropertiesIndex >::execute_particle_wall_broad_search | ( | const Particles::ParticleHandler< dim > & | particle_handler, |
| BoundaryCellsInformation< dim > & | boundary_cell_object, | ||
| const typename dem_data_structures< dim >::solid_surfaces_mesh_information & | solid_surfaces_mesh_info, | ||
| const Parameters::Lagrangian::FloatingWalls< dim > & | floating_walls, | ||
| const double | simulation_time, | ||
| const AdaptiveSparseContacts< dim, PropertiesIndex > & | sparse_particle_contact_object ) |
Execute the particle-wall broad searches with adaptive sparse contacts.
Calls proper functions to find the candidates of particle-wall contact pairs and the particle-floating wall or particle-floating mesh if required. These contact pairs will be used in the fine search step to investigate if they are in contact. It checks if the adaptive sparse contacts is enabled and use proper functions.
| [in] | particle_handler | Storage of particles and their accessor functions. |
| [in] | boundary_cell_object | Information of the boundary cells and faces. |
| [in] | solid_surfaces_mesh_info | Mapping of solid surfaces meshes. |
| [in] | floating_walls | Properties of the floating walls. |
| [in] | simulation_time | Current simulation time. |
| [in] | sparse_particle_contact_object | Allow to check the mobility status of cells. |
Definition at line 294 of file dem_contact_manager.cc.
References find_particle_floating_wall_contact_pairs(), find_particle_line_contact_pairs(), find_particle_point_contact_pairs(), find_particle_wall_contact_pairs(), Parameters::Lagrangian::FloatingWalls< dim >::floating_walls_number, DEMActionManager::get_action_manager(), BoundaryCellsInformation< dim >::get_boundary_cells_information(), BoundaryCellsInformation< dim >::get_boundary_cells_with_floating_walls(), BoundaryCellsInformation< dim >::get_boundary_cells_with_lines(), BoundaryCellsInformation< dim >::get_boundary_cells_with_points(), particle_floating_mesh_candidates, particle_floating_wall_candidates, particle_line_candidates, particle_point_candidates, particle_solid_surfaces_contact_search(), particle_wall_candidates, and total_neighbor_list.
| void DEMContactManager< dim, PropertiesIndex >::execute_particle_wall_fine_search | ( | const Parameters::Lagrangian::FloatingWalls< dim > & | floating_walls, |
| const double | simulation_time, | ||
| const double | neighborhood_threshold ) |
Execute the particle-wall fine searches.
Executes functions that update the particle-wall contacts pairs containers and compute the contact information of the collision particle-wall.
| [in] | floating_walls | Properties of the floating walls. |
| [in] | simulation_time | Current simulation time. |
| [in] | neighborhood_threshold | Threshold value of contact detection. |
Definition at line 455 of file dem_contact_manager.cc.
References Parameters::Lagrangian::FloatingWalls< dim >::floating_walls_number, DEMActionManager::get_action_manager(), particle_floating_mesh_candidates, particle_floating_mesh_fine_search(), particle_floating_mesh_potentially_in_contact, particle_floating_wall_candidates, particle_floating_wall_fine_search(), particle_floating_wall_in_contact, particle_line_candidates, particle_line_fine_search(), particle_lines_in_contact, particle_point_candidates, particle_point_fine_search(), particle_points_in_contact, particle_wall_candidates, particle_wall_fine_search(), and particle_wall_in_contact.
|
inline |
Return the local-ghost particle contact container.
Definition at line 259 of file dem_contact_manager.h.
References ghost_adjacent_particles.
|
inline |
Return the ghost particle-particle contact candidates.
Definition at line 304 of file dem_contact_manager.h.
References ghost_contact_pair_candidates.
|
inline |
Return the ghost-local periodic particle contact container.
Definition at line 286 of file dem_contact_manager.h.
References ghost_local_periodic_adjacent_particles.
|
inline |
Return the local-local particle contact container.
Definition at line 250 of file dem_contact_manager.h.
References local_adjacent_particles.
|
inline |
Return the local particle-particle contact candidates.
Definition at line 295 of file dem_contact_manager.h.
References local_contact_pair_candidates.
|
inline |
Return the local-ghost periodic particle contact container.
Definition at line 277 of file dem_contact_manager.h.
References local_ghost_periodic_adjacent_particles.
|
inline |
Return the local-local periodic particle contact container.
Definition at line 268 of file dem_contact_manager.h.
References local_local_periodic_adjacent_particles.
|
inline |
Return the particle-floating mesh contact container.
Definition at line 205 of file dem_contact_manager.h.
References particle_floating_mesh_potentially_in_contact.
|
inline |
Return the particle-floating wall contact container.
Definition at line 214 of file dem_contact_manager.h.
References particle_floating_wall_in_contact.
|
inline |
Return the particle-line contact container.
Definition at line 232 of file dem_contact_manager.h.
References particle_lines_in_contact.
|
inline |
Return the particle-point contact container.
Definition at line 241 of file dem_contact_manager.h.
References particle_points_in_contact.
|
inline |
Return the particle-wall contact container.
Definition at line 223 of file dem_contact_manager.h.
References particle_wall_in_contact.
| void DEMContactManager< dim, PropertiesIndex >::set_periodic_offset_per_direction | ( | const std::array< double, dim > & | offset_per_direction | ) |
Set the signed periodic offset for every direction.
| [in] | offset_per_direction | Signed periodic offsets of the domain along every direction, used for determining periodic contacts. |
Definition at line 398 of file dem_contact_manager.cc.
References periodic_offset_per_direction.
|
inline |
Execute functions to clear and update the neighbor lists of all the active cells in the triangulation.
| [in] | triangulation | The triangulation to access the information of the cells. |
| [in] | periodic_boundaries_cells_information | Information of periodic cells used if periodic boundaries are enabled (next parameter). |
Definition at line 64 of file dem_contact_manager.h.
References cells_ghost_local_periodic_neighbor_list, cells_ghost_neighbor_list, cells_ghost_periodic_neighbor_list, cells_local_neighbor_list, cells_local_periodic_neighbor_list, execute_cell_neighbors_search(), and total_neighbor_list.
| void DEMContactManager< dim, PropertiesIndex >::update_contacts | ( | ) |
Execute functions to update the contact data containers with the new contact pairs.
Call proper functions to remove contact repetitions and to add new contact pairs to the contact containers when particles are exchanged between processors after the fine search. Contact pairs are local particle-particle, ghost particle-particle, particle-wall, particle-floating wall contacts and particle-floating mesh contacts.
Definition at line 52 of file dem_contact_manager.cc.
References DEMActionManager::get_action_manager(), ghost_adjacent_particles, ghost_contact_pair_candidates, ghost_contact_pair_periodic_candidates, ghost_local_contact_pair_periodic_candidates, ghost_local_periodic_adjacent_particles, ghost_local_periodic_particle_particle, ghost_particle_particle, ghost_periodic_particle_particle, local_adjacent_particles, local_contact_pair_candidates, local_contact_pair_periodic_candidates, local_ghost_periodic_adjacent_particles, local_local_periodic_adjacent_particles, local_particle_particle, local_periodic_particle_particle, particle_floating_mesh, particle_floating_mesh_candidates, particle_floating_mesh_potentially_in_contact, particle_floating_wall, particle_floating_wall_candidates, particle_floating_wall_in_contact, particle_wall, particle_wall_candidates, particle_wall_in_contact, and update_fine_search_candidates().
| void DEMContactManager< dim, PropertiesIndex >::update_local_particles_in_cells | ( | const Particles::ParticleHandler< dim > & | particle_handler | ) |
Execute functions to update the particle iterators in local-local contact containers.
This is essential since sort_particles_into_subdomains_and_cells() and exchange_ghost_particles() functions change the particle iterators everytime they are called.
| [in] | particle_handler | Storage of particles and their accessor functions. |
Definition at line 148 of file dem_contact_manager.cc.
References DEMActionManager::get_action_manager(), ghost_adjacent_particles, ghost_local_periodic_adjacent_particles, ghost_local_periodic_particle_particle, ghost_particle_particle, ghost_periodic_particle_particle, local_adjacent_particles, local_ghost_periodic_adjacent_particles, local_local_periodic_adjacent_particles, local_particle_particle, local_periodic_particle_particle, particle_container, particle_floating_mesh, particle_floating_mesh_potentially_in_contact, particle_floating_wall, particle_floating_wall_in_contact, particle_line, particle_lines_in_contact, particle_point, particle_points_in_contact, particle_wall, particle_wall_in_contact, update_contact_container_iterators(), and update_particle_container().
|
private |
Definition at line 327 of file dem_contact_manager.h.
|
private |
Definition at line 321 of file dem_contact_manager.h.
|
private |
Definition at line 325 of file dem_contact_manager.h.
|
private |
Definition at line 319 of file dem_contact_manager.h.
|
private |
Definition at line 323 of file dem_contact_manager.h.
|
private |
Definition at line 373 of file dem_contact_manager.h.
|
private |
Definition at line 333 of file dem_contact_manager.h.
|
private |
Definition at line 339 of file dem_contact_manager.h.
|
private |
Definition at line 335 of file dem_contact_manager.h.
|
private |
Definition at line 341 of file dem_contact_manager.h.
|
private |
Definition at line 379 of file dem_contact_manager.h.
|
private |
Definition at line 371 of file dem_contact_manager.h.
|
private |
Definition at line 331 of file dem_contact_manager.h.
|
private |
Definition at line 337 of file dem_contact_manager.h.
|
private |
Definition at line 377 of file dem_contact_manager.h.
|
private |
Definition at line 375 of file dem_contact_manager.h.
|
private |
Definition at line 312 of file dem_contact_manager.h.
|
private |
Definition at line 343 of file dem_contact_manager.h.
|
private |
Definition at line 357 of file dem_contact_manager.h.
|
private |
Definition at line 345 of file dem_contact_manager.h.
|
private |
Definition at line 359 of file dem_contact_manager.h.
|
private |
Definition at line 349 of file dem_contact_manager.h.
|
private |
Definition at line 363 of file dem_contact_manager.h.
|
private |
Definition at line 347 of file dem_contact_manager.h.
|
private |
Definition at line 365 of file dem_contact_manager.h.
|
private |
Definition at line 351 of file dem_contact_manager.h.
|
private |
Definition at line 361 of file dem_contact_manager.h.
|
private |
Definition at line 382 of file dem_contact_manager.h.
|
private |
Signed periodic offset of the domain along every direction, used by the particle-particle fine search to find the nearest periodic image of a particle. Component d is 0 if direction d is not periodic.
Definition at line 390 of file dem_contact_manager.h.
|
private |
Definition at line 317 of file dem_contact_manager.h.