Lethe Open-Source Library version 1.2.0
Developer Guide
Loading...
Searching...
No Matches
CFDDEMSolver< dim, PropertiesIndex > Class Template Reference

#include <cfd_dem_coupling.h>

Inheritance diagram for CFDDEMSolver< dim, PropertiesIndex >:
[legend]

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 > &copy_data) override
void assemble_local_system_rhs (const typename DoFHandler< dim >::active_cell_iterator &cell, NavierStokesScratchData< dim > &scratch_data, StabilizedMethodsTensorCopyData< dim > &copy_data) override
void setup_assemblers () override
void copy_local_matrix_to_global_matrix (const StabilizedMethodsTensorCopyData< dim > &copy_data) override
void copy_local_rhs_to_global_rhs (const StabilizedMethodsTensorCopyData< dim > &copy_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 ()

Protected Attributes

std::shared_ptr< SubSimulationControlDEM > dem_simulation_control
Tensor< 1, 3 > g
ParticleInteractionOutcomes< PropertiesIndex > contact_outcome
std::vector< Tensor< 1, 3 > > & torque = contact_outcome.torque
std::vector< Tensor< 1, 3 > > & force = contact_outcome.force
std::vector< double > displacement
std::vector< double > MOI
double neighborhood_threshold_squared
std::vector< std::shared_ptr< Distribution > > size_distribution_object_container
double maximum_particle_diameter
double smallest_contact_search_criterion
OngoingCollisionLog< dim > ongoing_collision_log
CompletedCollisionLog< dim > collision_event_log
DEMContactManager< dim, PropertiesIndex > contact_manager
LagrangianLoadBalancing< dim, PropertiesIndex > load_balancing
ParticlePointLineForce< dim, PropertiesIndex > particle_point_line_contact_force_object
std::shared_ptr< Integrator< dim, PropertiesIndex > > integrator_object
std::shared_ptr< Insertion< dim, PropertiesIndex > > insertion_object
std::shared_ptr< ParticleParticleContactForceBase< dim, PropertiesIndex > > particle_particle_contact_force_object
std::shared_ptr< ParticleWallContactForceBase< dim, PropertiesIndex > > particle_wall_contact_force_object
Visualization< dim, PropertiesIndex > visualization_object
BoundaryCellsInformation< dim > boundary_cell_object
dem_data_structures< dim >::solid_surfaces_mesh_information solid_surfaces_mesh_info
dem_data_structures< dim >::boundary_points_and_normal_vectors updated_boundary_points_and_normal_vectors
dem_data_structures< dim >::vector_on_boundary forces_boundary_information
dem_data_structures< dim >::vector_on_boundary torques_boundary_information
DEM::dem_data_structures< dim >::periodic_boundaries_cells_info periodic_boundaries_cells_information
PeriodicBoundariesManipulator< dim > periodic_boundaries_object
AdaptiveSparseContacts< dim, PropertiesIndex > sparse_contacts_object
unsigned int contact_search_counter
unsigned int contact_search_total_number
statistics contact_list
DEM::ParticleProperties< dim, PropertiesIndex > properties_class
PVDHandler grid_pvdhandler
PVDHandler particles_pvdhandler
DEMSolverParameters< dim > dem_parameters
double rayleigh_time_step
const unsigned int this_mpi_process
const unsigned int n_mpi_processes
TableHandler table_phase_volumes
DEMActionManager * dem_action_manager
Protected Attributes inherited from FluidDynamicsVANS< dim, PropertiesIndex >
CFDDEMSimulationParameters< dim > cfd_dem_simulation_parameters
MappingQGeneric< dim > particle_mapping
std::vector< std::shared_ptr< ParticleFluidAssemblerBase< dim, PropertiesIndex > > > particle_fluid_assemblers
const bool PSPG = true
const bool SUPG = true
const double GLS_u_scale = 1
double pressure_drop
std::map< unsigned int, std::set< typename DoFHandler< dim >::active_cell_iterator > > vertices_to_cell
std::map< unsigned int, std::set< typename DoFHandler< dim >::active_cell_iterator > > vertices_to_periodic_cell
Particles::ParticleHandler< dim, dim > particle_handler
ParticleProjector< dim, PropertiesIndex > particle_projector
bool has_periodic_boundaries
std::map< types::boundary_id, Tensor< 1, dim > > cfd_periodic_offsets
std::map< types::boundary_id, unsigned int > cfd_periodic_directions
Protected Attributes inherited from FluidDynamicsMatrixBased< dim >
TrilinosWrappers::SparseMatrix system_matrix
Protected Attributes inherited from NavierStokesBase< dim, GlobalVectorType, IndexSet >
IndexSet locally_owned_dofs
IndexSet locally_relevant_dofs
MPI_Comm mpi_communicator
const unsigned int n_mpi_processes
const unsigned int this_mpi_process
std::shared_ptr< parallel::DistributedTriangulationBase< dim > > triangulation
std::shared_ptr< DoFHandler< dim > > dof_handler
std::shared_ptr< FESystem< dim > > fe
TimerOutput computing_timer
SimulationParameters< dim > simulation_parameters
PVDHandler pvdhandler
PVDHandler pvdhandler_boundary
Function< dim > * exact_solution
std::shared_ptr< Function< dim > > forcing_function
FlowControl< dim > flow_control
AffineConstraints< double > zero_constraints
AffineConstraints< double > nonzero_constraints
bool use_manifold_for_normal
GlobalVectorType evaluation_point
GlobalVectorType local_evaluation_point
GlobalVectorType newton_update
std::shared_ptr< GlobalVectorType > present_solution
GlobalVectorType system_rhs
std::shared_ptr< std::vector< GlobalVectorType > > previous_solutions
SDIRKVectors sdirk_vectors
const unsigned int velocity_fem_degree
const unsigned int pressure_fem_degree
unsigned int number_quadrature_points
std::shared_ptr< Mapping< dim > > mapping
std::shared_ptr< Quadrature< dim > > cell_quadrature
std::shared_ptr< Quadrature< dim - 1 > > face_quadrature
std::shared_ptr< MortarManagerBase< dim > > mortar_manager
std::shared_ptr< CouplingOperator< dim, double > > mortar_coupling_operator
std::shared_ptr< NavierStokesCouplingEvaluationSIPG< dim, double > > mortar_coupling_evaluator
std::shared_ptr< MappingQCache< dim > > mapping_cache
std::vector< std::shared_ptr< NavierStokesAssemblerBase< dim > > > assemblers
std::shared_ptr< MultiphysicsInterface< dim > > multiphysics
std::shared_ptr< SimulationControl > simulation_control
TableHandler enstrophy_table
TableHandler pressure_power_table
TableHandler viscous_dissipation_table
TableHandler kinetic_energy_table
TableHandler apparent_viscosity_table
TableHandler pressure_drop_table
TableHandler flow_rate_table
std::shared_ptr< AverageVelocities< dim, GlobalVectorType, IndexSet > > average_velocities
GlobalVectorType average_solution
MeshController mesh_controller
ConvergenceTable error_table
std::vector< std::map< types::boundary_id, Tensor< 1, dim > > > forces_on_boundaries
std::map< types::boundary_id, TableHandler > forces_tables
std::map< types::boundary_id, TableHandler > torques_tables
std::shared_ptr< FEValues< dim > > fe_values_temperature
std::shared_ptr< FEValues< dim > > fe_values_cls
std::vector< StasisConstraintWithTemperature > stasis_constraint_structs
AffineConstraints< double > dynamic_zero_constraints

Additional Inherited Members

Public Attributes inherited from PhysicsSolver< GlobalVectorType >
ConditionalOStream pcout
Parameters::SimulationControl::TimeSteppingMethod time_stepping_method

Detailed Description

template<int dim, typename PropertiesIndex>
class CFDDEMSolver< dim, PropertiesIndex >

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.

Template Parameters
dimSpatial dimension of the simulation (2 or 3)
PropertiesIndexIndex of the properties used within the ParticleHandler

Definition at line 46 of file cfd_dem_coupling.h.

Constructor & Destructor Documentation

◆ CFDDEMSolver()

template<int dim, typename PropertiesIndex>
CFDDEMSolver< dim, PropertiesIndex >::CFDDEMSolver ( CFDDEMSimulationParameters< dim > & nsparam)

Constructor for the CFD-DEM solver.

Parameters
[in]nsparamSimulation 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.

◆ ~CFDDEMSolver()

template<int dim, typename PropertiesIndex>
CFDDEMSolver< dim, PropertiesIndex >::~CFDDEMSolver ( )
overridedefault

Destructor for the CFD-DEM solver.

Member Function Documentation

◆ add_fluid_particle_interaction_force()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::add_fluid_particle_interaction_force ( )
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.

◆ add_fluid_particle_interaction_torque()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::add_fluid_particle_interaction_torque ( )
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.

◆ check_contact_detection_method()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::check_contact_detection_method ( unsigned int counter)
protected

◆ dem_contact_build()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::dem_contact_build ( )
protected

◆ dem_iterator()

◆ dem_setup_parameters()

◆ dynamic_flow_control()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::dynamic_flow_control ( )
overrideprotectedvirtual

◆ gather_tables()

template<int dim, typename PropertiesIndex>
std::vector< OutputStructTableHandler > CFDDEMSolver< dim, PropertiesIndex >::gather_tables ( )
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.

Returns
Vector of OutputStructTableHandler containing references to TableHandler objects and their corresponding file names

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.

◆ initialize_dem_parameters()

◆ insert_particles()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::insert_particles ( )
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.

◆ load_balance()

◆ particle_wall_contact_force()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::particle_wall_contact_force ( )
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.

◆ postprocess_cfd_dem()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::postprocess_cfd_dem ( )
protected

◆ postprocess_fd()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::postprocess_fd ( bool first_iteration)
overrideprotectedvirtual

Perform fluid dynamics post-processing after each iteration.

Executes post-processing operations specific to the fluid dynamics component including output writing and monitoring.

Parameters
[in]first_iterationFlag 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().

◆ print_particles_summary()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::print_particles_summary ( )
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.

◆ read_checkpoint()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::read_checkpoint ( )
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.

◆ read_dem()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::read_dem ( )
overrideprotectedvirtual

◆ report_particle_statistics()

◆ report_rayleigh_time_ratio()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::report_rayleigh_time_ratio ( )
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.

◆ set_initial_condition()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::set_initial_condition ( const Parameters::FluidDynamicsInitialConditionType initial_condition_type,
const bool restart = false )
inlineoverrideprotectedvirtual

Set the initial condition. The version in this class does not output the solution, since the void fraction is not initialized yet.

Parameters
[in]initial_condition_typeType of method used to impose initial condition.
[in]restartIndicator 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.

◆ set_integrator_type()

template<int dim, typename PropertiesIndex>
std::shared_ptr< Integrator< dim, PropertiesIndex > > CFDDEMSolver< dim, PropertiesIndex >::set_integrator_type ( )
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).

Returns
Shared pointer to the configured integration object

Definition at line 179 of file cfd_dem_coupling.cc.

References dem_parameters.

◆ setup_distribution_type()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::setup_distribution_type ( )
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.

◆ solve()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::solve ( )
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().

◆ sort_particles_into_subdomains_and_cells()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::sort_particles_into_subdomains_and_cells ( )
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.

◆ synchronize_particle_velocities()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::synchronize_particle_velocities ( )
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.

◆ write_checkpoint()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::write_checkpoint ( )
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.

◆ write_dem_output_results()

template<int dim, typename PropertiesIndex>
void CFDDEMSolver< dim, PropertiesIndex >::write_dem_output_results ( )
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().

Member Data Documentation

◆ boundary_cell_object

template<int dim, typename PropertiesIndex>
BoundaryCellsInformation<dim> CFDDEMSolver< dim, PropertiesIndex >::boundary_cell_object
protected

Information about boundary cells for contact detection.

Definition at line 454 of file cfd_dem_coupling.h.

◆ collision_event_log

template<int dim, typename PropertiesIndex>
CompletedCollisionLog<dim> CFDDEMSolver< dim, PropertiesIndex >::collision_event_log
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.

◆ contact_list

template<int dim, typename PropertiesIndex>
statistics CFDDEMSolver< dim, PropertiesIndex >::contact_list
protected

Statistics container for timing and contact list information.

Definition at line 489 of file cfd_dem_coupling.h.

◆ contact_manager

template<int dim, typename PropertiesIndex>
DEMContactManager<dim, PropertiesIndex> CFDDEMSolver< dim, PropertiesIndex >::contact_manager
protected

Manager for particle-particle and particle-wall contact detection and handling

Definition at line 427 of file cfd_dem_coupling.h.

◆ contact_outcome

template<int dim, typename PropertiesIndex>
ParticleInteractionOutcomes<PropertiesIndex> CFDDEMSolver< dim, PropertiesIndex >::contact_outcome
protected

Container for particle interaction outcomes (forces and torques).

Definition at line 383 of file cfd_dem_coupling.h.

◆ contact_search_counter

template<int dim, typename PropertiesIndex>
unsigned int CFDDEMSolver< dim, PropertiesIndex >::contact_search_counter
protected

Counter for contact searches performed in the current CFD iteration.

Definition at line 483 of file cfd_dem_coupling.h.

◆ contact_search_total_number

template<int dim, typename PropertiesIndex>
unsigned int CFDDEMSolver< dim, PropertiesIndex >::contact_search_total_number
protected

Total number of contact searches since simulation start.

Definition at line 486 of file cfd_dem_coupling.h.

◆ dem_action_manager

template<int dim, typename PropertiesIndex>
DEMActionManager* CFDDEMSolver< dim, PropertiesIndex >::dem_action_manager
protected

Pointer to DEM action manager for handling DEM-specific operations.

Definition at line 517 of file cfd_dem_coupling.h.

◆ dem_parameters

template<int dim, typename PropertiesIndex>
DEMSolverParameters<dim> CFDDEMSolver< dim, PropertiesIndex >::dem_parameters
protected

DEM simulation parameters container.

Definition at line 501 of file cfd_dem_coupling.h.

◆ dem_simulation_control

template<int dim, typename PropertiesIndex>
std::shared_ptr<SubSimulationControlDEM> CFDDEMSolver< dim, PropertiesIndex >::dem_simulation_control
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.

◆ displacement

template<int dim, typename PropertiesIndex>
std::vector<double> CFDDEMSolver< dim, PropertiesIndex >::displacement
protected

Displacement vector for particle motion calculations.

Definition at line 392 of file cfd_dem_coupling.h.

◆ force

template<int dim, typename PropertiesIndex>
std::vector<Tensor<1, 3> >& CFDDEMSolver< dim, PropertiesIndex >::force = contact_outcome.force
protected

Reference to force vector from contact outcomes.

Definition at line 389 of file cfd_dem_coupling.h.

◆ forces_boundary_information

template<int dim, typename PropertiesIndex>
dem_data_structures<dim>::vector_on_boundary CFDDEMSolver< dim, PropertiesIndex >::forces_boundary_information
protected

Force information stored on boundary elements.

Definition at line 466 of file cfd_dem_coupling.h.

◆ g

template<int dim, typename PropertiesIndex>
Tensor<1, 3> CFDDEMSolver< dim, PropertiesIndex >::g
protected

Gravitational acceleration vector.

Definition at line 380 of file cfd_dem_coupling.h.

◆ grid_pvdhandler

template<int dim, typename PropertiesIndex>
PVDHandler CFDDEMSolver< dim, PropertiesIndex >::grid_pvdhandler
protected

PVD handler for grid visualization output.

Definition at line 495 of file cfd_dem_coupling.h.

◆ insertion_object

template<int dim, typename PropertiesIndex>
std::shared_ptr<Insertion<dim, PropertiesIndex> > CFDDEMSolver< dim, PropertiesIndex >::insertion_object
protected

Particle insertion method handler.

Definition at line 440 of file cfd_dem_coupling.h.

◆ integrator_object

template<int dim, typename PropertiesIndex>
std::shared_ptr<Integrator<dim, PropertiesIndex> > CFDDEMSolver< dim, PropertiesIndex >::integrator_object
protected

Time integration scheme for particle motion equations.

Definition at line 437 of file cfd_dem_coupling.h.

◆ load_balancing

template<int dim, typename PropertiesIndex>
LagrangianLoadBalancing<dim, PropertiesIndex> CFDDEMSolver< dim, PropertiesIndex >::load_balancing
protected

Load balancing handler for distributing particles across MPI processes.

Definition at line 430 of file cfd_dem_coupling.h.

◆ maximum_particle_diameter

template<int dim, typename PropertiesIndex>
double CFDDEMSolver< dim, PropertiesIndex >::maximum_particle_diameter
protected

Maximum diameter among all particles in the simulation.

Definition at line 404 of file cfd_dem_coupling.h.

◆ MOI

template<int dim, typename PropertiesIndex>
std::vector<double> CFDDEMSolver< dim, PropertiesIndex >::MOI
protected

Moment of inertia values for all particles.

Definition at line 395 of file cfd_dem_coupling.h.

◆ n_mpi_processes

template<int dim, typename PropertiesIndex>
const unsigned int CFDDEMSolver< dim, PropertiesIndex >::n_mpi_processes
protected

Total number of MPI processes.

Definition at line 510 of file cfd_dem_coupling.h.

◆ neighborhood_threshold_squared

template<int dim, typename PropertiesIndex>
double CFDDEMSolver< dim, PropertiesIndex >::neighborhood_threshold_squared
protected

Squared threshold distance for neighborhood particle detection.

Definition at line 398 of file cfd_dem_coupling.h.

◆ ongoing_collision_log

template<int dim, typename PropertiesIndex>
OngoingCollisionLog<dim> CFDDEMSolver< dim, PropertiesIndex >::ongoing_collision_log
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.

◆ particle_particle_contact_force_object

template<int dim, typename PropertiesIndex>
std::shared_ptr<ParticleParticleContactForceBase<dim, PropertiesIndex> > CFDDEMSolver< dim, PropertiesIndex >::particle_particle_contact_force_object
protected

Contact force model for particle-particle interactions.

Definition at line 444 of file cfd_dem_coupling.h.

◆ particle_point_line_contact_force_object

template<int dim, typename PropertiesIndex>
ParticlePointLineForce<dim, PropertiesIndex> CFDDEMSolver< dim, PropertiesIndex >::particle_point_line_contact_force_object
protected

Handler for point and line contact forces between particles.

Definition at line 434 of file cfd_dem_coupling.h.

◆ particle_wall_contact_force_object

template<int dim, typename PropertiesIndex>
std::shared_ptr<ParticleWallContactForceBase<dim, PropertiesIndex> > CFDDEMSolver< dim, PropertiesIndex >::particle_wall_contact_force_object
protected

Contact force model for particle-wall interactions.

Definition at line 448 of file cfd_dem_coupling.h.

◆ particles_pvdhandler

template<int dim, typename PropertiesIndex>
PVDHandler CFDDEMSolver< dim, PropertiesIndex >::particles_pvdhandler
protected

PVD handler for particle visualization output.

Definition at line 498 of file cfd_dem_coupling.h.

◆ periodic_boundaries_cells_information

template<int dim, typename PropertiesIndex>
DEM::dem_data_structures<dim>::periodic_boundaries_cells_info CFDDEMSolver< dim, PropertiesIndex >::periodic_boundaries_cells_information
protected

Information about cells involved in periodic boundary conditions.

Definition at line 474 of file cfd_dem_coupling.h.

◆ periodic_boundaries_object

template<int dim, typename PropertiesIndex>
PeriodicBoundariesManipulator<dim> CFDDEMSolver< dim, PropertiesIndex >::periodic_boundaries_object
protected

Handler for periodic boundary condition manipulations.

Definition at line 477 of file cfd_dem_coupling.h.

◆ properties_class

template<int dim, typename PropertiesIndex>
DEM::ParticleProperties<dim, PropertiesIndex> CFDDEMSolver< dim, PropertiesIndex >::properties_class
protected

Particle properties handler for DEM simulation.

Definition at line 492 of file cfd_dem_coupling.h.

◆ rayleigh_time_step

template<int dim, typename PropertiesIndex>
double CFDDEMSolver< dim, PropertiesIndex >::rayleigh_time_step
protected

Rayleigh time step.

Definition at line 504 of file cfd_dem_coupling.h.

◆ size_distribution_object_container

template<int dim, typename PropertiesIndex>
std::vector<std::shared_ptr<Distribution> > CFDDEMSolver< dim, PropertiesIndex >::size_distribution_object_container
protected

Container for particle size distribution objects.

Definition at line 401 of file cfd_dem_coupling.h.

◆ smallest_contact_search_criterion

template<int dim, typename PropertiesIndex>
double CFDDEMSolver< dim, PropertiesIndex >::smallest_contact_search_criterion
protected

Smallest criterion used for contact search algorithms.

Definition at line 407 of file cfd_dem_coupling.h.

◆ solid_surfaces_mesh_info

template<int dim, typename PropertiesIndex>
dem_data_structures<dim>::solid_surfaces_mesh_information CFDDEMSolver< dim, PropertiesIndex >::solid_surfaces_mesh_info
protected

Mesh information for solid surfaces in contact with particles.

Definition at line 458 of file cfd_dem_coupling.h.

◆ sparse_contacts_object

template<int dim, typename PropertiesIndex>
AdaptiveSparseContacts<dim, PropertiesIndex> CFDDEMSolver< dim, PropertiesIndex >::sparse_contacts_object
protected

Object for handling adaptive sparse contact detection algorithms.

Definition at line 480 of file cfd_dem_coupling.h.

◆ table_phase_volumes

template<int dim, typename PropertiesIndex>
TableHandler CFDDEMSolver< dim, PropertiesIndex >::table_phase_volumes
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.

◆ this_mpi_process

template<int dim, typename PropertiesIndex>
const unsigned int CFDDEMSolver< dim, PropertiesIndex >::this_mpi_process
protected

Current MPI process identifier.

Definition at line 507 of file cfd_dem_coupling.h.

◆ torque

template<int dim, typename PropertiesIndex>
std::vector<Tensor<1, 3> >& CFDDEMSolver< dim, PropertiesIndex >::torque = contact_outcome.torque
protected

Reference to torque vector from contact outcomes.

Definition at line 386 of file cfd_dem_coupling.h.

◆ torques_boundary_information

template<int dim, typename PropertiesIndex>
dem_data_structures<dim>::vector_on_boundary CFDDEMSolver< dim, PropertiesIndex >::torques_boundary_information
protected

Torque information stored on boundary elements.

Definition at line 470 of file cfd_dem_coupling.h.

◆ updated_boundary_points_and_normal_vectors

template<int dim, typename PropertiesIndex>
dem_data_structures<dim>::boundary_points_and_normal_vectors CFDDEMSolver< dim, PropertiesIndex >::updated_boundary_points_and_normal_vectors
protected

Updated boundary points and their corresponding normal vectors.

Definition at line 462 of file cfd_dem_coupling.h.

◆ visualization_object

template<int dim, typename PropertiesIndex>
Visualization<dim, PropertiesIndex> CFDDEMSolver< dim, PropertiesIndex >::visualization_object
protected

Visualization handler for DEM output generation.

Definition at line 451 of file cfd_dem_coupling.h.


The documentation for this class was generated from the following files: