![]() |
Lethe Open-Source Library version 1.2.0
Developer Guide
|
#include <cfd_dem_coupling.h>
Public Member Functions | |
| CFDDEMSolver (CFDDEMSimulationParameters< dim > &nsparam) | |
| ~CFDDEMSolver () override | |
| virtual void | solve () override |
| Public Member Functions inherited from FluidDynamicsVANS< dim, PropertiesIndex > | |
| FluidDynamicsVANS (CFDDEMSimulationParameters< dim > &nsparam) | |
| ~FluidDynamicsVANS () | |
| Public Member Functions inherited from FluidDynamicsMatrixBased< dim > | |
| FluidDynamicsMatrixBased (SimulationParameters< dim > &nsparam, const FluidDynamicsFormulation fluid_dynamics_formulation=FluidDynamicsFormulation::standard) | |
| ~FluidDynamicsMatrixBased () | |
| Public Member Functions inherited from PhysicsSolver< GlobalVectorType > | |
| PhysicsSolver (const Parameters::NonLinearSolver non_linear_solver_parameters) | |
| virtual | ~PhysicsSolver () |
| void | solve_governing_system () |
| virtual void | apply_constraints () |
| virtual double | get_current_residual () |
| virtual bool | allow_skip_linear_solve_when_residual_is_below_tolerance () const |
| unsigned int | get_current_newton_iteration () const |
Protected Member Functions | |
| void | dem_setup_parameters () |
| void | setup_distribution_type () |
| std::shared_ptr< Integrator< dim, PropertiesIndex > > | set_integrator_type () |
| void | initialize_dem_parameters () |
| void | read_dem () override |
| void | set_initial_condition (const Parameters::FluidDynamicsInitialConditionType initial_condition_type, const bool restart=false) override |
| std::vector< OutputStructTableHandler > | gather_tables () override |
| void | write_checkpoint () override |
| void | read_checkpoint () override |
| void | check_contact_detection_method (unsigned int counter) |
| void | load_balance () |
| void | insert_particles () |
| void | add_fluid_particle_interaction_force () |
| void | add_fluid_particle_interaction_torque () |
| void | particle_wall_contact_force () |
| void | write_dem_output_results () |
| void | report_particle_statistics () |
| void | print_particles_summary () |
| void | postprocess_fd (bool first_iteration) override |
| void | postprocess_cfd_dem () |
| void | dynamic_flow_control () override |
| void | sort_particles_into_subdomains_and_cells () |
| void | dem_iterator () |
| void | synchronize_particle_velocities () |
| void | report_rayleigh_time_ratio () |
| void | dem_contact_build () |
| Protected Member Functions inherited from FluidDynamicsVANS< dim, PropertiesIndex > | |
| virtual void | setup_dofs () override |
| virtual void | iterate () override |
| void | calculate_void_fraction (const double time) |
| void | vertices_cell_mapping () |
| virtual void | monitor_mass_conservation () |
| virtual void | finish_time_step_fd () |
| void | assemble_system_matrix () override |
| void | assemble_system_rhs () override |
| void | assemble_local_system_matrix (const typename DoFHandler< dim >::active_cell_iterator &cell, NavierStokesScratchData< dim > &scratch_data, StabilizedMethodsTensorCopyData< dim > ©_data) override |
| void | assemble_local_system_rhs (const typename DoFHandler< dim >::active_cell_iterator &cell, NavierStokesScratchData< dim > &scratch_data, StabilizedMethodsTensorCopyData< dim > ©_data) override |
| void | setup_assemblers () override |
| void | copy_local_matrix_to_global_matrix (const StabilizedMethodsTensorCopyData< dim > ©_data) override |
| void | copy_local_rhs_to_global_rhs (const StabilizedMethodsTensorCopyData< dim > ©_data) override |
| virtual std::vector< OutputStruct< dim, GlobalVectorType > > | gather_output_hook () override |
| Protected Member Functions inherited from FluidDynamicsMatrixBased< dim > | |
| virtual void | setup_dofs_fd () override |
| void | multi_stage_preresolution (unsigned int stage, Parameters::SimulationControl::TimeSteppingMethod method) override |
| virtual void | multi_stage_postresolution (unsigned int stage, Parameters::SimulationControl::TimeSteppingMethod method, double time_step) override |
| virtual void | update_multi_stage_solution (double time_step) override |
| virtual void | set_initial_condition_fd (Parameters::FluidDynamicsInitialConditionType initial_condition_type, bool restart=false) override |
| virtual void | update_multiphysics_time_average_solution () override |
| void | setup_preconditioner () override |
| void | define_dynamic_zero_constraints () |
| void | define_pressure_constraints () |
| virtual void | update_mortar_configuration () override |
| void | solve_linear_system () override |
| Protected Member Functions inherited from NavierStokesBase< dim, GlobalVectorType, IndexSet > | |
| NavierStokesBase (SimulationParameters< dim > &nsparam, const FluidDynamicsFormulation fluid_dynamics_formulation=FluidDynamicsFormulation::standard) | |
| virtual | ~NavierStokesBase ()=default |
| virtual GlobalVectorType & | get_evaluation_point () override |
| virtual GlobalVectorType & | get_local_evaluation_point () override |
| virtual GlobalVectorType & | get_newton_update () override |
| virtual GlobalVectorType & | get_present_solution () override |
| virtual GlobalVectorType & | get_system_rhs () override |
| virtual AffineConstraints< double > & | get_nonzero_constraints () override |
| virtual void | output_newton_update_norms () override |
| double | get_residual_rescale_metric () const override |
| void | finish_simulation () |
| virtual void | postprocess (bool first_iteration) |
| virtual void | finish_time_step () |
| virtual void | percolate_time_vectors_fd () |
| void | finish_simulation_fd () |
| virtual void | update_solutions_for_multiphysics () |
| virtual void | update_solutions_for_fluid_dynamics () |
| void | postprocessing_forces (const GlobalVectorType &evaluation_point) |
| void | postprocessing_torques (const GlobalVectorType &evaluation_point) |
| virtual void | set_specified_fluid_dynamics_solution () |
| virtual void | enable_dynamic_zero_constraints_fd () |
| void | box_refine_mesh (const bool restart) |
| virtual void | refine_mesh () |
| void | refine_mesh_adaptive () |
| void | refine_mesh_uniform () |
| void | transfer_solution (SolutionTransfer< dim, GlobalVectorType > &solution_transfer, std::vector< SolutionTransfer< dim, GlobalVectorType > > &previous_solutions_transfer) |
| bool | average_velocities_are_enabled () const |
| void | restore_average_velocities_after_checkpoint () |
| virtual void | set_solution_from_checkpoint (const std::string &checkpoint_file_prefix) |
| void | set_nodal_values () |
| void | define_non_zero_constraints () |
| void | define_zero_constraints () |
| void | reinit_mortar_operators () |
| std::shared_ptr< Mapping< dim > > | get_mapping () |
| void | rotate_rotor_mapping (const bool is_first) |
| void | connect_mortar_weight_signals () |
| void | update_boundary_conditions () |
| virtual void | update_forcing_and_boundary_conditions () |
| bool | check_existance_of_bc (BoundaryConditions::FluidDynamicsBoundaryType bc) |
| void | make_solid_domain (const DoFHandler< dim > &dof_handler, const bool non_zero_constraints, AffineConstraints< double > &constraints) |
| bool | cell_in_constraining_domain (const typename DoFHandler< dim >::active_cell_iterator &cell, const Point< dim > &plane_point, const Tensor< 1, dim > &plane_normal_vector) |
| void | get_cell_temperature_values (const typename DoFHandler< dim >::active_cell_iterator &cell, const DoFHandler< dim > *dof_handler_ht, const GlobalVectorType &temperature_solution, std::vector< double > &local_temperature_values) |
| void | get_cell_filtered_phase_indicator_values (const typename DoFHandler< dim >::active_cell_iterator &cell, const DoFHandler< dim > *dof_handler_cls, const GlobalVectorType &filtered_phase_indicator_solution, std::vector< double > &local_filtered_phase_indicator_values) |
| void | identify_cell_and_constrain_velocity (const std::vector< types::global_dof_index > &local_dof_indices, const std::vector< double > &local_temperature_values, StasisConstraintWithTemperature &stasis_constraint_struct) |
| void | constrain_stasis_with_temperature (const DoFHandler< dim > *dof_handler_ht) |
| void | constrain_stasis_with_temperature_cls (const DoFHandler< dim > *dof_handler_cls, const DoFHandler< dim > *dof_handler_ht) |
| void | gather_output_results (const GlobalVectorType &solution, std::vector< OutputStruct< dim, GlobalVectorType > > &solution_output_structs) |
| void | write_output_results (const GlobalVectorType &solution) |
| void | write_output_forces () |
| void | write_output_torques () |
| void | rescale_pressure_dofs_in_newton_update () |
| GlobalVectorType | init_temporary_vector () |
| void | verify_consistency_of_boundary_conditions () |
Additional Inherited Members | |
| Public Attributes inherited from PhysicsSolver< GlobalVectorType > | |
| ConditionalOStream | pcout |
| Parameters::SimulationControl::TimeSteppingMethod | time_stepping_method |
Solver class for coupled Computational Fluid Dynamics and Discrete Element Method (CFD-DEM) simulations.
This class implements a two-way coupled CFD-DEM solver that combines the Volume-averaged Navier-Stokes (VANS) equations for fluid flow with the soft-sphere Discrete Element Method for particle dynamics. The solver enables simulation of fluid-particle interactions in systems containing dense particle suspensions.
The CFD component uses Galerkin Least Squares (GLS) stabilization for the VANS equations, while the DEM component handles particle-particle and particle-wall collisions using the soft-sphere contact model.
| dim | Spatial dimension of the simulation (2 or 3) |
| PropertiesIndex | Index of the properties used within the ParticleHandler |
Definition at line 46 of file cfd_dem_coupling.h.
| CFDDEMSolver< dim, PropertiesIndex >::CFDDEMSolver | ( | CFDDEMSimulationParameters< dim > & | nsparam | ) |
Constructor for the CFD-DEM solver.
| [in] | nsparam | Simulation parameters containing all CFD-DEM configuration options |
Definition at line 32 of file cfd_dem_coupling.cc.
References FluidDynamicsVANS< dim, PropertiesIndex >::FluidDynamicsVANS(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, n_mpi_processes, and this_mpi_process.
|
overridedefault |
Destructor for the CFD-DEM solver.
|
protected |
Calculate and add fluid-particle interaction forces.
Computes the hydrodynamic forces acting on particles due to fluid motion and adds them to the particle force container for use in DEM integration.
Definition at line 910 of file cfd_dem_coupling.cc.
References force, and FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler.
|
protected |
Calculate and add fluid-particle interaction torques.
Computes the hydrodynamic torques acting on particles due to fluid motion and adds them to the particle torque container for use in DEM integration.
Definition at line 937 of file cfd_dem_coupling.cc.
References FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, and torque.
|
protected |
Check if contact detection is required and execute it if necessary.
Determines whether a contact detection step should be performed based on the contact detection frequency and executes the appropriate contact detection algorithm.
| [in] | counter | Current DEM iteration number |
Definition at line 681 of file cfd_dem_coupling.cc.
References FluidDynamicsVANS< dim, PropertiesIndex >::cfd_dem_simulation_parameters, Parameters::Lagrangian::ModelParameters< dim >::contact_detection_frequency, Parameters::Lagrangian::ModelParameters< dim >::contact_detection_method, dem_action_manager, dem_parameters, displacement, find_particle_contact_detection_step(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, and smallest_contact_search_criterion.
|
protected |
Perform contact detection and build contact lists.
Checks if a contact search should be performed based on the contact detection frequency and executes the appropriate contact detection algorithm to identify particle-particle and particle-wall contacts.
Definition at line 1565 of file cfd_dem_coupling.cc.
References boundary_cell_object, check_contact_detection_method(), contact_manager, contact_search_counter, dem_action_manager, dem_parameters, dem_simulation_control, neighborhood_threshold_squared, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANS< dim, PropertiesIndex >::particle_projector, PhysicsSolver< GlobalVectorType >::pcout, periodic_boundaries_cells_information, periodic_boundaries_object, solid_surfaces_mesh_info, sort_particles_into_subdomains_and_cells(), and sparse_contacts_object.
|
protected |
Execute a complete DEM iteration step.
Performs a full DEM time step including particle-particle and particle-wall contact force calculations, time integration of particle motion, and updates the particles positions and velocities.
Definition at line 1397 of file cfd_dem_coupling.cc.
References add_fluid_particle_interaction_force(), add_fluid_particle_interaction_torque(), FluidDynamicsVANS< dim, PropertiesIndex >::cfd_dem_simulation_parameters, collision_event_log, contact_manager, contact_outcome, dem_action_manager, dem_contact_build(), dem_parameters, dem_simulation_control, force, g, DEM::has_thermal_properties, integrate_temperature(), integrator_object, log_collision_data(), MOI, ongoing_collision_log, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, particle_particle_contact_force_object, particle_wall_contact_force(), set_wall_temperature_time(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, sparse_contacts_object, torque, and NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation.
|
protected |
Set up the various parameters related to the DEM simulation.
Initializes DEM-specific parameters including contact detection methods, integration schemes, and material properties based on the simulation parameters provided during construction.
Definition at line 44 of file cfd_dem_coupling.cc.
References FluidDynamicsVANS< dim, PropertiesIndex >::cfd_dem_simulation_parameters, contact_search_total_number, dem_action_manager, dem_parameters, dem_simulation_control, g, DEMActionManager::get_action_manager(), insertion_object, integrator_object, load_balancing, maximum_particle_diameter, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, particle_particle_contact_force_object, periodic_boundaries_object, rayleigh_time_step, report_rayleigh_time_ratio(), set_insertion_type(), set_integrator_type(), set_particle_particle_contact_force_model(), setup_distribution_type(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, size_distribution_object_container, sparse_contacts_object, and NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation.
|
overrideprotectedvirtual |
Calculate dynamic flow control accounting for void fraction.
Performs dynamic flow control calculations that incorporate the local void fraction (porosity) field in the average velocity computation, enabling proper flow control in particle-laden flows.
Reimplemented from NavierStokesBase< dim, GlobalVectorType, IndexSet >.
Definition at line 1294 of file cfd_dem_coupling.cc.
References announce_string(), calculate_average_velocity(), dem_parameters, NavierStokesBase< dim, GlobalVectorType, IndexSet >::dof_handler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::flow_control, g, FluidDynamicsVANS< dim, PropertiesIndex >::particle_projector, PhysicsSolver< GlobalVectorType >::pcout, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_parameters, Parameters::SimulationControl::steady, and Parameters::verbose.
|
overrideprotectedvirtual |
Gather TableHandler objects for serialization during checkpointing.
Collects all TableHandler objects that need to be serialized and deserialized during checkpoint operations, including their associated file names for proper storage and retrieval.
Reimplemented from NavierStokesBase< dim, GlobalVectorType, IndexSet >.
Definition at line 376 of file cfd_dem_coupling.cc.
References Parameters::PostProcessing< dim >::calculate_phase_volumes, Parameters::PostProcessing< dim >::phase_volumes_output_name, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_parameters, and table_phase_volumes.
|
protected |
Initialize fundamental DEM simulation parameters.
Sets up basic DEM parameters including time stepping, contact detection frequency, and other core simulation settings.
Definition at line 200 of file cfd_dem_coupling.cc.
References boundary_cell_object, FluidDynamicsVANS< dim, PropertiesIndex >::cfd_dem_simulation_parameters, contact_manager, dem_action_manager, dem_parameters, dem_simulation_control, DEM::has_thermal_properties, maximum_particle_diameter, particle_particle_contact_force_object, FluidDynamicsVANS< dim, PropertiesIndex >::particle_projector, particle_wall_contact_force_object, PhysicsSolver< GlobalVectorType >::pcout, periodic_boundaries_cells_information, periodic_boundaries_object, set_particle_wall_contact_force_model(), set_wall_temperature_time(), smallest_contact_search_criterion, sort_particles_into_subdomains_and_cells(), sparse_contacts_object, and NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation.
|
protected |
Check if particles need to be inserted and perform insertion.
Determines if new particles should be inserted into the simulation domain based on the insertion parameters and executes particle insertion using the configured insertion method.
Definition at line 958 of file cfd_dem_coupling.cc.
References dem_action_manager, dem_parameters, insertion_object, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, sort_particles_into_subdomains_and_cells(), and NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation.
|
protected |
Check if load balancing is required and perform it if necessary.
Evaluates the current load distribution across MPI processes and performs load balancing to maintain computational efficiency when particle distribution becomes uneven.
Definition at line 718 of file cfd_dem_coupling.cc.
References NavierStokesBase< dim, GlobalVectorType, IndexSet >::average_velocities, NavierStokesBase< dim, GlobalVectorType, IndexSet >::average_velocities_are_enabled(), boundary_cell_object, contact_manager, dem_action_manager, dem_parameters, NavierStokesBase< dim, GlobalVectorType, IndexSet >::dof_handler, load_balancing, NavierStokesBase< dim, GlobalVectorType, IndexSet >::locally_owned_dofs, NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANS< dim, PropertiesIndex >::particle_projector, PhysicsSolver< GlobalVectorType >::pcout, periodic_boundaries_cells_information, periodic_boundaries_object, NavierStokesBase< dim, GlobalVectorType, IndexSet >::present_solution, NavierStokesBase< dim, GlobalVectorType, IndexSet >::previous_solutions, FluidDynamicsVANS< dim, PropertiesIndex >::setup_dofs(), sparse_contacts_object, NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation, and FluidDynamicsVANS< dim, PropertiesIndex >::vertices_cell_mapping().
|
protected |
Calculate contact forces between particles and walls.
Computes collision forces and torques resulting from particle-wall interactions using the soft-sphere contact model.
Definition at line 985 of file cfd_dem_coupling.cc.
References contact_manager, contact_outcome, dem_parameters, dem_simulation_control, force, particle_point_line_contact_force_object, and particle_wall_contact_force_object.
|
protected |
Perform CFD-DEM coupled post-processing after each iteration.
Executes post-processing operations specific to the coupled CFD-DEM simulation including coupled field analysis and specialized output generation.
Definition at line 1238 of file cfd_dem_coupling.cc.
References calculate_fluid_and_particle_volumes(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::computing_timer, FluidDynamicsVANS< dim, PropertiesIndex >::particle_projector, PhysicsSolver< GlobalVectorType >::pcout, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_parameters, table_phase_volumes, and Parameters::verbose.
|
overrideprotectedvirtual |
Perform fluid dynamics post-processing after each iteration.
Executes post-processing operations specific to the fluid dynamics component including output writing and monitoring.
| [in] | first_iteration | Flag indicating if this is the first iteration |
Reimplemented from NavierStokesBase< dim, GlobalVectorType, IndexSet >.
Definition at line 1219 of file cfd_dem_coupling.cc.
References PhysicsSolver< GlobalVectorType >::pcout, NavierStokesBase< dim, GlobalVectorType, IndexSet >::postprocess_fd(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, and write_dem_output_results().
|
protected |
Print final summary of particle simulation results.
Outputs a comprehensive summary of the particle simulation including final particle positions, velocities, and other relevant information at the end of the simulation.
Definition at line 1142 of file cfd_dem_coupling.cc.
References DEM::has_thermal_properties, NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, PhysicsSolver< GlobalVectorType >::pcout, and NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control.
|
overrideprotectedvirtual |
Read CFD-DEM simulation checkpoint files.
Loads the complete simulation state from previously written checkpoint files to restart a CFD-DEM simulation from a specific time step.
Reimplemented from NavierStokesBase< dim, GlobalVectorType, IndexSet >.
Definition at line 502 of file cfd_dem_coupling.cc.
References NavierStokesBase< dim, GlobalVectorType, IndexSet >::average_velocities, NavierStokesBase< dim, GlobalVectorType, IndexSet >::average_velocities_are_enabled(), check_file_exists(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::computing_timer, dem_action_manager, dem_parameters, deserialize_tables_vector(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::dof_handler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::flow_control, gather_tables(), NavierStokesBase< dim, VectorType, DofsType >::gather_tables(), grid_pvdhandler, insertion_object, NavierStokesBase< dim, GlobalVectorType, IndexSet >::locally_owned_dofs, NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, NavierStokesBase< dim, GlobalVectorType, IndexSet >::multiphysics, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANS< dim, PropertiesIndex >::particle_projector, particles_pvdhandler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::present_solution, NavierStokesBase< dim, GlobalVectorType, IndexSet >::previous_solutions, NavierStokesBase< dim, GlobalVectorType, IndexSet >::pvdhandler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::restore_average_velocities_after_checkpoint(), FluidDynamicsVANS< dim, PropertiesIndex >::setup_dofs(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_parameters, sparse_contacts_object, and NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation.
|
overrideprotectedvirtual |
Read DEM restart files from a previous simulation.
Loads particle data, contact information, and other DEM state variables from checkpoint files to continue a previously interrupted simulation.
Reimplemented from FluidDynamicsVANS< dim, PropertiesIndex >.
Definition at line 282 of file cfd_dem_coupling.cc.
References FluidDynamicsVANS< dim, PropertiesIndex >::cfd_dem_simulation_parameters, check_file_exists(), convert_particle_handler(), FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANS< dim, PropertiesIndex >::particle_mapping, PhysicsSolver< GlobalVectorType >::pcout, NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation, and write_dem_output_results().
|
protected |
Calculate and report particle statistics to the terminal.
Computes and displays comprehensive statistics about particle behavior including minimum, maximum, and average values for linear velocity, angular velocity, kinetic energies, and contact search performance metrics.
Definition at line 1048 of file cfd_dem_coupling.cc.
References add_statistics_to_table_handler(), announce_string(), DEM::calculate_granular_statistics(), contact_list, contact_search_total_number, dem_parameters, NavierStokesBase< dim, GlobalVectorType, IndexSet >::dof_handler, grid_pvdhandler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, DEM::omega, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, PhysicsSolver< GlobalVectorType >::pcout, DEM::rotational_kinetic_energy, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, sparse_contacts_object, this_mpi_process, DEM::translational_kinetic_energy, NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation, DEM::velocity, and write_post_processing_results().
|
inlineprotected |
Reports the ratio between the DEM time step and the Rayleigh time.
Definition at line 351 of file cfd_dem_coupling.h.
References dem_simulation_control, PhysicsSolver< GlobalVectorType >::pcout, and rayleigh_time_step.
|
inlineoverrideprotectedvirtual |
Set the initial condition. The version in this class does not output the solution, since the void fraction is not initialized yet.
| [in] | initial_condition_type | Type of method used to impose initial condition. |
| [in] | restart | Indicator if the simulation is being restarted or not. |
Reimplemented from NavierStokesBase< dim, GlobalVectorType, IndexSet >.
Definition at line 135 of file cfd_dem_coupling.h.
References NavierStokesBase< dim, GlobalVectorType, IndexSet >::multiphysics, NavierStokesBase< dim, GlobalVectorType, IndexSet >::refine_mesh(), FluidDynamicsMatrixBased< dim >::set_initial_condition_fd(), and NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_parameters.
|
protected |
Set up the time integration method for particle motion.
Creates and configures the appropriate integration scheme for solving particle equations of motion (e.g., velocity Verlet, explicit Euler).
Definition at line 179 of file cfd_dem_coupling.cc.
References dem_parameters.
|
protected |
Initialize the particle size distribution and related parameters.
Sets up the particle size distribution type for the simulation and calculates the maximum particle diameter and neighborhood threshold squared values required for contact detection algorithms.
Definition at line 162 of file cfd_dem_coupling.cc.
References dem_parameters, maximum_particle_diameter, neighborhood_threshold_squared, setup_distributions(), size_distribution_object_container, and this_mpi_process.
|
overridevirtual |
Engine of the CFD-DEM solver. Calls all the necessary functions to set parameters, solve the simulation, and finish the simulation.
Reimplemented from FluidDynamicsVANS< dim, PropertiesIndex >.
Definition at line 1644 of file cfd_dem_coupling.cc.
References announce_string(), FluidDynamicsVANS< dim, PropertiesIndex >::calculate_void_fraction(), FluidDynamicsVANS< dim, PropertiesIndex >::cfd_dem_simulation_parameters, collision_event_log, NavierStokesBase< dim, GlobalVectorType, IndexSet >::computing_timer, contact_search_counter, contact_search_total_number, dem_action_manager, dem_iterator(), dem_parameters, dem_setup_parameters(), dem_simulation_control, dynamic_flow_control(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::finish_simulation(), FluidDynamicsVANS< dim, PropertiesIndex >::finish_time_step_fd(), initialize_dem_parameters(), insert_particles(), FluidDynamicsVANS< dim, PropertiesIndex >::iterate(), load_balance(), maximum_particle_diameter, Parameters::Testing::mobility_status, NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, NavierStokesBase< dim, GlobalVectorType, IndexSet >::multiphysics, FluidDynamicsVANS< dim, PropertiesIndex >::particle_projector, Parameters::Testing::particles, PhysicsSolver< GlobalVectorType >::pcout, NavierStokesBase< dim, GlobalVectorType, IndexSet >::postprocess(), postprocess_cfd_dem(), postprocess_fd(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::present_solution, print_particles_summary(), rayleigh_time_step, read_dem(), read_mesh_and_manifolds(), NavierStokesBase< dim, VectorType, DofsType >::refine_mesh(), report_cell_size_to_particle_diameter_ratio(), report_particle_statistics(), report_rayleigh_time_ratio(), set_initial_condition(), FluidDynamicsVANS< dim, PropertiesIndex >::setup_dofs(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_parameters, sparse_contacts_object, Parameters::SimulationControl::steady, synchronize_particle_velocities(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation, NavierStokesBase< dim, GlobalVectorType, IndexSet >::update_boundary_conditions(), FluidDynamicsMatrixBased< dim >::update_multiphysics_time_average_solution(), FluidDynamicsVANS< dim, PropertiesIndex >::vertices_cell_mapping(), visualization_object, write_collision_stats(), and NavierStokesBase< dim, GlobalVectorType, IndexSet >::write_output_results().
|
inlineprotected |
Sort particles into subdomains and cells for efficient processing.
Redistributes particles among computational subdomains and associates them with their containing cells, then reinitialize containers that depend on local particle identifiers.
Definition at line 1359 of file cfd_dem_coupling.cc.
References contact_outcome, dem_action_manager, displacement, MOI, and FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler.
|
protected |
Carry out the closing half velocity step of a staggered integration scheme at the end of the DEM sub-iterations of a CFD time step.
The contact and the fluid-particle interaction forces are re-evaluated at the final position of the particles so that their velocities can be synchronized with their positions. Consequently, n + 1 integration operations are carried out to complete the n DEM sub-iterations, and the CFD-DEM coupling of the next CFD time step sees synchronized velocities.
Definition at line 1505 of file cfd_dem_coupling.cc.
References add_fluid_particle_interaction_force(), add_fluid_particle_interaction_torque(), FluidDynamicsVANS< dim, PropertiesIndex >::cfd_dem_simulation_parameters, contact_manager, contact_outcome, dem_action_manager, dem_simulation_control, force, g, DEM::has_thermal_properties, integrator_object, MOI, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, particle_particle_contact_force_object, particle_wall_contact_force(), sparse_contacts_object, torque, and NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation.
|
overrideprotectedvirtual |
Write CFD-DEM simulation checkpoint files.
Saves the complete state of the CFD-DEM simulation including fluid variables, particle data, and auxiliary information to enable simulation restart from the current time step.
Reimplemented from NavierStokesBase< dim, GlobalVectorType, IndexSet >.
Definition at line 394 of file cfd_dem_coupling.cc.
References NavierStokesBase< dim, GlobalVectorType, IndexSet >::average_velocities, NavierStokesBase< dim, GlobalVectorType, IndexSet >::average_velocities_are_enabled(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::computing_timer, dem_parameters, NavierStokesBase< dim, GlobalVectorType, IndexSet >::dof_handler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::flow_control, gather_tables(), NavierStokesBase< dim, VectorType, DofsType >::gather_tables(), grid_pvdhandler, insertion_object, NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, NavierStokesBase< dim, GlobalVectorType, IndexSet >::multiphysics, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANS< dim, PropertiesIndex >::particle_projector, particles_pvdhandler, NavierStokesBase< dim, GlobalVectorType, IndexSet >::present_solution, NavierStokesBase< dim, GlobalVectorType, IndexSet >::previous_solutions, NavierStokesBase< dim, GlobalVectorType, IndexSet >::pvdhandler, serialize_tables_vector(), NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_parameters, and NavierStokesBase< dim, GlobalVectorType, IndexSet >::triangulation.
|
protected |
Write DEM simulation results to output files.
Generates visualization output files containing particle positions, velocities, forces, and other relevant DEM variables in parallel VTU format for post-processing.
Definition at line 1021 of file cfd_dem_coupling.cc.
References Visualization< dim, PropertiesIndex >::build_patches(), dem_parameters, NavierStokesBase< dim, GlobalVectorType, IndexSet >::mpi_communicator, FluidDynamicsVANS< dim, PropertiesIndex >::particle_handler, particles_pvdhandler, properties_class, NavierStokesBase< dim, GlobalVectorType, IndexSet >::simulation_control, and write_vtu_and_pvd().
|
protected |
Information about boundary cells for contact detection.
Definition at line 454 of file cfd_dem_coupling.h.
|
protected |
Object to store completed collision events.
Stores complete collision event data including start and end information for post-processing and analysis purposes.
Definition at line 423 of file cfd_dem_coupling.h.
|
protected |
Statistics container for timing and contact list information.
Definition at line 489 of file cfd_dem_coupling.h.
|
protected |
Manager for particle-particle and particle-wall contact detection and handling
Definition at line 427 of file cfd_dem_coupling.h.
|
protected |
Container for particle interaction outcomes (forces and torques).
Definition at line 383 of file cfd_dem_coupling.h.
|
protected |
Counter for contact searches performed in the current CFD iteration.
Definition at line 483 of file cfd_dem_coupling.h.
|
protected |
Total number of contact searches since simulation start.
Definition at line 486 of file cfd_dem_coupling.h.
|
protected |
Pointer to DEM action manager for handling DEM-specific operations.
Definition at line 517 of file cfd_dem_coupling.h.
|
protected |
DEM simulation parameters container.
Definition at line 501 of file cfd_dem_coupling.h.
|
protected |
Sub simulation control object used to control the DEM sub iterations for each CFD time step.
Definition at line 377 of file cfd_dem_coupling.h.
|
protected |
Displacement vector for particle motion calculations.
Definition at line 392 of file cfd_dem_coupling.h.
|
protected |
Reference to force vector from contact outcomes.
Definition at line 389 of file cfd_dem_coupling.h.
|
protected |
Force information stored on boundary elements.
Definition at line 466 of file cfd_dem_coupling.h.
|
protected |
Gravitational acceleration vector.
Definition at line 380 of file cfd_dem_coupling.h.
|
protected |
PVD handler for grid visualization output.
Definition at line 495 of file cfd_dem_coupling.h.
|
protected |
Particle insertion method handler.
Definition at line 440 of file cfd_dem_coupling.h.
|
protected |
Time integration scheme for particle motion equations.
Definition at line 437 of file cfd_dem_coupling.h.
|
protected |
Load balancing handler for distributing particles across MPI processes.
Definition at line 430 of file cfd_dem_coupling.h.
|
protected |
Maximum diameter among all particles in the simulation.
Definition at line 404 of file cfd_dem_coupling.h.
|
protected |
Moment of inertia values for all particles.
Definition at line 395 of file cfd_dem_coupling.h.
|
protected |
Total number of MPI processes.
Definition at line 510 of file cfd_dem_coupling.h.
|
protected |
Squared threshold distance for neighborhood particle detection.
Definition at line 398 of file cfd_dem_coupling.h.
|
protected |
Object to store ongoing collision information.
Stores particle ID, boundary ID, velocity tensor, angular velocity tensor, and collision time for collisions currently in progress.
Definition at line 415 of file cfd_dem_coupling.h.
|
protected |
Contact force model for particle-particle interactions.
Definition at line 444 of file cfd_dem_coupling.h.
|
protected |
Handler for point and line contact forces between particles.
Definition at line 434 of file cfd_dem_coupling.h.
|
protected |
Contact force model for particle-wall interactions.
Definition at line 448 of file cfd_dem_coupling.h.
|
protected |
PVD handler for particle visualization output.
Definition at line 498 of file cfd_dem_coupling.h.
|
protected |
Information about cells involved in periodic boundary conditions.
Definition at line 474 of file cfd_dem_coupling.h.
|
protected |
Handler for periodic boundary condition manipulations.
Definition at line 477 of file cfd_dem_coupling.h.
|
protected |
Particle properties handler for DEM simulation.
Definition at line 492 of file cfd_dem_coupling.h.
|
protected |
Rayleigh time step.
Definition at line 504 of file cfd_dem_coupling.h.
|
protected |
Container for particle size distribution objects.
Definition at line 401 of file cfd_dem_coupling.h.
|
protected |
Smallest criterion used for contact search algorithms.
Definition at line 407 of file cfd_dem_coupling.h.
|
protected |
Mesh information for solid surfaces in contact with particles.
Definition at line 458 of file cfd_dem_coupling.h.
|
protected |
Object for handling adaptive sparse contact detection algorithms.
Definition at line 480 of file cfd_dem_coupling.h.
|
protected |
TableHandler for post-processing phase volume calculations Stores total fluid volume and total particle volume data
Definition at line 514 of file cfd_dem_coupling.h.
|
protected |
Current MPI process identifier.
Definition at line 507 of file cfd_dem_coupling.h.
|
protected |
Reference to torque vector from contact outcomes.
Definition at line 386 of file cfd_dem_coupling.h.
|
protected |
Torque information stored on boundary elements.
Definition at line 470 of file cfd_dem_coupling.h.
|
protected |
Updated boundary points and their corresponding normal vectors.
Definition at line 462 of file cfd_dem_coupling.h.
|
protected |
Visualization handler for DEM output generation.
Definition at line 451 of file cfd_dem_coupling.h.