![]() |
Lethe Open-Source Library version 1.2.0
Developer Guide
|
#include <cfd_dem_coupling_matrix_free.h>
Public Member Functions | |
| CFDDEMMatrixFree (CFDDEMSimulationParameters< dim > ¶m) | |
| void | solve () override |
| Public Member Functions inherited from FluidDynamicsVANSMatrixFree< dim, PropertiesIndex > | |
| FluidDynamicsVANSMatrixFree (CFDDEMSimulationParameters< dim > ¶m) | |
| void | solve () override |
| Public Member Functions inherited from FluidDynamicsMatrixFree< dim > | |
| FluidDynamicsMatrixFree (SimulationParameters< dim > &nsparam, const FluidDynamicsFormulation fluid_dynamics_formulation=FluidDynamicsFormulation::standard) | |
| ~FluidDynamicsMatrixFree () | |
| Public Member Functions inherited from PhysicsSolver< LinearAlgebra::distributed::Vector< double > > | |
| 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 () |
| void | particle_wall_contact_force () |
| void | write_dem_output_results () |
| void | report_particle_statistics () |
| 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 FluidDynamicsVANSMatrixFree< dim, PropertiesIndex > | |
| void | setup_dofs () override |
| void | assemble_system_rhs () override |
| virtual void | finish_time_step_fd () |
| std::vector< OutputStruct< dim, LinearAlgebra::distributed::Vector< double > > > | gather_output_hook () override |
| void | create_GMG () override |
| void | initialize_GMG () override |
| void | evaluate_time_derivative_void_fraction () |
| Protected Member Functions inherited from FluidDynamicsMatrixFree< 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 |
| void | update_forcing_and_boundary_conditions () override |
| virtual void | set_initial_condition_fd (Parameters::FluidDynamicsInitialConditionType initial_condition_type, bool restart=false) override |
| virtual void | assemble_system_matrix () override |
| virtual void | update_mortar_configuration () override |
| void | reinit_mortar_operators_mf () |
| virtual void | update_multiphysics_time_average_solution () override |
| virtual void | update_solutions_for_multiphysics () override |
| virtual void | update_solutions_for_fluid_dynamics () override |
| void | calculate_time_derivative_previous_solutions () |
| void | setup_preconditioner () override |
| void | solve_linear_system () override |
| void | print_mg_setup_times () |
| Protected Member Functions inherited from NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet > | |
| NavierStokesBase (SimulationParameters< dim > &nsparam, const FluidDynamicsFormulation fluid_dynamics_formulation=FluidDynamicsFormulation::standard) | |
| virtual | ~NavierStokesBase ()=default |
| virtual LinearAlgebra::distributed::Vector< double > & | get_evaluation_point () override |
| virtual LinearAlgebra::distributed::Vector< double > & | get_local_evaluation_point () override |
| virtual LinearAlgebra::distributed::Vector< double > & | get_newton_update () override |
| virtual LinearAlgebra::distributed::Vector< double > & | get_present_solution () override |
| virtual LinearAlgebra::distributed::Vector< double > & | 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 () |
| void | postprocessing_forces (const LinearAlgebra::distributed::Vector< double > &evaluation_point) |
| void | postprocessing_torques (const LinearAlgebra::distributed::Vector< double > &evaluation_point) |
| virtual void | set_specified_fluid_dynamics_solution () |
| virtual void | iterate () |
| 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, LinearAlgebra::distributed::Vector< double > > &solution_transfer, std::vector< SolutionTransfer< dim, LinearAlgebra::distributed::Vector< double > > > &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 () |
| 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 LinearAlgebra::distributed::Vector< double > &solution, std::vector< OutputStruct< dim, LinearAlgebra::distributed::Vector< double > > > &solution_output_structs) |
| void | write_output_results (const LinearAlgebra::distributed::Vector< double > &solution) |
| void | write_output_forces () |
| void | write_output_torques () |
| void | rescale_pressure_dofs_in_newton_update () |
| LinearAlgebra::distributed::Vector< double > | init_temporary_vector () |
| void | verify_consistency_of_boundary_conditions () |
Additional Inherited Members | |
| Public Attributes inherited from PhysicsSolver< LinearAlgebra::distributed::Vector< double > > | |
| ConditionalOStream | pcout |
| Parameters::SimulationControl::TimeSteppingMethod | time_stepping_method |
Solver class for coupled Computational Fluid Dynamics and Discrete Element Method (CFD-DEM) simulations using a matrix-free formulation.
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. A matrix-free formulation is used to solve the VANS equation.
| dim | Spatial dimension of the simulation (2 or 3). |
| PropertiesIndex | Index of the properties used within the ParticleHandler. While 2D simulation are theoretically supported, they have not been tested. |
Definition at line 43 of file cfd_dem_coupling_matrix_free.h.
| CFDDEMMatrixFree< dim, PropertiesIndex >::CFDDEMMatrixFree | ( | CFDDEMSimulationParameters< dim > & | param | ) |
Constructor for the CFD-DEM matrix-free solver.
| [in] | param | Simulation parameters containing all CFD-DEM configuration options |
Definition at line 36 of file cfd_dem_coupling_matrix_free.cc.
References FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::FluidDynamicsVANSMatrixFree().
|
protected |
Calculate and add fluid-particle interaction forces and torques.
Computes the hydrodynamic forces acting on particles due to fluid motion and adds them to the particle force container for use in DEM integration.
Reference to torque vector from contact outcomes
Reference to force vector from contact outcomes
Definition at line 1024 of file cfd_dem_coupling_matrix_free.cc.
References contact_outcome, and FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler.
|
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 742 of file cfd_dem_coupling_matrix_free.cc.
References FluidDynamicsVANSMatrixFree< 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, LinearAlgebra::distributed::Vector< double >, IndexSet >::mpi_communicator, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 1591 of file cfd_dem_coupling_matrix_free.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, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_projector, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::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 DEM time step.
Performs a full DEM time step including particle-particle and particle-wall contact force calculations, time integration of particle motion, and updates to particle positions and velocities.
Definition at line 1430 of file cfd_dem_coupling_matrix_free.cc.
References add_fluid_particle_interaction(), FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::cfd_dem_simulation_parameters, collision_event_log, contact_manager, contact_outcome, dem_action_manager, dem_contact_build(), dem_parameters, dem_simulation_control, g, DEM::has_thermal_properties, integrate_temperature(), integrator_object, log_collision_data(), MOI, ongoing_collision_log, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, particle_particle_contact_force_object, particle_wall_contact_force(), set_wall_temperature_time(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, sparse_contacts_object, and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 60 of file cfd_dem_coupling_matrix_free.cc.
References FluidDynamicsVANSMatrixFree< 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, FluidDynamicsVANSMatrixFree< 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, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, size_distribution_object_container, sparse_contacts_object, and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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, LinearAlgebra::distributed::Vector< double >, IndexSet >.
Definition at line 1327 of file cfd_dem_coupling_matrix_free.cc.
References announce_string(), calculate_average_velocity(), dem_parameters, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::dof_handler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::flow_control, g, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_projector, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::pcout, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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, LinearAlgebra::distributed::Vector< double >, IndexSet >.
Definition at line 374 of file cfd_dem_coupling_matrix_free.cc.
References Parameters::PostProcessing< dim >::calculate_phase_volumes, Parameters::PostProcessing< dim >::phase_volumes_output_name, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 194 of file cfd_dem_coupling_matrix_free.cc.
References boundary_cell_object, FluidDynamicsVANSMatrixFree< 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, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_projector, particle_wall_contact_force_object, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::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, LinearAlgebra::distributed::Vector< double >, 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 1063 of file cfd_dem_coupling_matrix_free.cc.
References dem_action_manager, dem_parameters, insertion_object, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, sort_particles_into_subdomains_and_cells(), and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 781 of file cfd_dem_coupling_matrix_free.cc.
References NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::average_velocities, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::average_velocities_are_enabled(), boundary_cell_object, contact_manager, convert_vector_dealii_to_trilinos(), dem_action_manager, dem_parameters, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::dof_handler, load_balancing, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::locally_owned_dofs, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::locally_relevant_dofs, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::mpi_communicator, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_projector, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::pcout, periodic_boundaries_cells_information, periodic_boundaries_object, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::present_solution, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::previous_solutions, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::setup_dofs(), sparse_contacts_object, and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::triangulation.
|
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 1090 of file cfd_dem_coupling_matrix_free.cc.
References contact_manager, contact_outcome, dem_parameters, dem_simulation_control, 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 1270 of file cfd_dem_coupling_matrix_free.cc.
References calculate_fluid_and_particle_volumes(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::computing_timer, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_projector, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::pcout, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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, LinearAlgebra::distributed::Vector< double >, IndexSet >.
Definition at line 1251 of file cfd_dem_coupling_matrix_free.cc.
References PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::pcout, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::postprocess_fd(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, and write_dem_output_results().
|
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, LinearAlgebra::distributed::Vector< double >, IndexSet >.
Definition at line 500 of file cfd_dem_coupling_matrix_free.cc.
References NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::average_velocities, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::average_velocities_are_enabled(), check_file_exists(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::computing_timer, convert_vector_dealii_to_trilinos(), dem_action_manager, dem_parameters, deserialize_tables_vector(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::dof_handler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::flow_control, gather_tables(), NavierStokesBase< dim, VectorType, DofsType >::gather_tables(), grid_pvdhandler, insertion_object, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::locally_owned_dofs, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::locally_relevant_dofs, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::mpi_communicator, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::multiphysics, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_projector, particles_pvdhandler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::present_solution, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::previous_solutions, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::pvdhandler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::restore_average_velocities_after_checkpoint(), FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::setup_dofs(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_parameters, sparse_contacts_object, and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >.
Definition at line 280 of file cfd_dem_coupling_matrix_free.cc.
References FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::cfd_dem_simulation_parameters, check_file_exists(), convert_particle_handler(), FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_mapping, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::pcout, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 1155 of file cfd_dem_coupling_matrix_free.cc.
References add_statistics_to_table_handler(), announce_string(), DEM::calculate_granular_statistics(), contact_list, contact_search_total_number, dem_parameters, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::dof_handler, grid_pvdhandler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::mpi_communicator, DEM::omega, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::pcout, DEM::rotational_kinetic_energy, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, sparse_contacts_object, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::this_mpi_process, DEM::translational_kinetic_energy, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 327 of file cfd_dem_coupling_matrix_free.h.
References dem_simulation_control, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::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 use to impose initial condition. |
| [in] | restart | Indicator if the simulation is being restarted or not. |
Reimplemented from NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >.
Definition at line 130 of file cfd_dem_coupling_matrix_free.h.
References NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::multiphysics, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::refine_mesh(), FluidDynamicsMatrixFree< dim >::set_initial_condition_fd(), and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 173 of file cfd_dem_coupling_matrix_free.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 43 of file cfd_dem_coupling_matrix_free.cc.
References dem_parameters, maximum_particle_diameter, neighborhood_threshold_squared, setup_distributions(), and size_distribution_object_container.
|
overridevirtual |
Engine of the CFD-DEM solver. Calls all the necessary functions to set parameters, solve the simulation, and finish the simulation.
Reimplemented from FluidDynamicsMatrixFree< dim >.
Definition at line 1669 of file cfd_dem_coupling_matrix_free.cc.
References announce_string(), FluidDynamicsMatrixFree< dim >::calculate_time_derivative_previous_solutions(), FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::cfd_dem_simulation_parameters, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::computing_timer, contact_search_counter, contact_search_total_number, dem_action_manager, dem_iterator(), dem_setup_parameters(), dem_simulation_control, dynamic_flow_control(), Parameters::Timer::end, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::evaluate_time_derivative_void_fraction(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::finish_simulation(), FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::finish_time_step_fd(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::flow_control, initialize_dem_parameters(), insert_particles(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::iterate(), load_balance(), maximum_particle_diameter, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::mpi_communicator, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::multiphysics, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_projector, PhysicsSolver< LinearAlgebra::distributed::Vector< double > >::pcout, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::postprocess(), postprocess_cfd_dem(), postprocess_fd(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::present_solution, FluidDynamicsMatrixFree< dim >::print_mg_setup_times(), rayleigh_time_step, read_dem(), read_mesh_and_manifolds(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::refine_mesh(), report_cell_size_to_particle_diameter_ratio(), report_particle_statistics(), report_rayleigh_time_ratio(), set_initial_condition(), FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::setup_dofs(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_parameters, synchronize_particle_velocities(), FluidDynamicsMatrixFree< dim >::system_operator, FluidDynamicsMatrixFree< dim >::time_derivative_previous_solutions, time_stepping_is_bdf(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::triangulation, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::update_boundary_conditions(), FluidDynamicsMatrixFree< dim >::update_multiphysics_time_average_solution(), and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 1394 of file cfd_dem_coupling_matrix_free.cc.
References contact_outcome, dem_action_manager, displacement, MOI, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, and sort_particles_into_subdomains_and_cells().
|
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 1536 of file cfd_dem_coupling_matrix_free.cc.
References add_fluid_particle_interaction(), contact_manager, contact_outcome, dem_action_manager, dem_simulation_control, g, DEM::has_thermal_properties, integrator_object, MOI, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, particle_particle_contact_force_object, particle_wall_contact_force(), sparse_contacts_object, and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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, LinearAlgebra::distributed::Vector< double >, IndexSet >.
Definition at line 392 of file cfd_dem_coupling_matrix_free.cc.
References NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::average_velocities, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::average_velocities_are_enabled(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::computing_timer, dem_parameters, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::dof_handler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::flow_control, gather_tables(), NavierStokesBase< dim, VectorType, DofsType >::gather_tables(), grid_pvdhandler, insertion_object, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::mpi_communicator, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::multiphysics, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_projector, particles_pvdhandler, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::present_solution, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::previous_solutions, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::pvdhandler, serialize_tables_vector(), NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_parameters, and NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, 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 1127 of file cfd_dem_coupling_matrix_free.cc.
References Visualization< dim, PropertiesIndex >::build_patches(), dem_parameters, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::mpi_communicator, FluidDynamicsVANSMatrixFree< dim, PropertiesIndex >::particle_handler, particles_pvdhandler, properties_class, NavierStokesBase< dim, LinearAlgebra::distributed::Vector< double >, IndexSet >::simulation_control, and write_vtu_and_pvd().
|
protected |
Information about boundary cells for contact detection.
Definition at line 425 of file cfd_dem_coupling_matrix_free.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 394 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Statistics container for timing and contact list information.
Definition at line 460 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Manager for particle-particle and particle-wall contact detection and handling
Definition at line 398 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Container for particle interaction outcomes (forces and torques).
Definition at line 360 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Counter for contact searches performed in the current CFD iteration.
Definition at line 454 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Total number of contact searches since simulation start.
Definition at line 457 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Pointer to DEM action manager for handling DEM-specific operations.
Definition at line 482 of file cfd_dem_coupling_matrix_free.h.
|
protected |
DEM simulation parameters container.
Definition at line 472 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Sub simulation control object used to control the DEM sub iterations for each CFD time step.
Definition at line 353 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Displacement vector for particle motion calculations.
Definition at line 363 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Force information stored on boundary elements.
Definition at line 437 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Gravitational acceleration vector.
Definition at line 357 of file cfd_dem_coupling_matrix_free.h.
|
protected |
PVD handler for grid visualization output.
Definition at line 466 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Particle insertion method handler.
Definition at line 411 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Time integration scheme for particle motion equations.
Definition at line 408 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Load balancing handler for distributing particles across MPI processes.
Definition at line 401 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Maximum diameter among all particles in the simulation.
Definition at line 375 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Moment of inertia values for all particles.
Definition at line 366 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Squared threshold distance for neighborhood particle detection.
Definition at line 369 of file cfd_dem_coupling_matrix_free.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 386 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Contact force model for particle-particle interactions.
Definition at line 415 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Handler for point and line contact forces between particles.
Definition at line 405 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Contact force model for particle-wall interactions.
Definition at line 419 of file cfd_dem_coupling_matrix_free.h.
|
protected |
PVD handler for particle visualization output.
Definition at line 469 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Information about cells involved in periodic boundary conditions.
Definition at line 445 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Handler for periodic boundary condition manipulations.
Definition at line 448 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Particle properties handler for DEM simulation.
Definition at line 463 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Rayleigh time step.
Definition at line 475 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Container for particle size distribution objects.
Definition at line 372 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Smallest criterion used for contact search algorithms.
Definition at line 378 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Mesh information for solid surfaces in contact with particles.
Definition at line 429 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Object for handling adaptive sparse contact detection algorithms.
Definition at line 451 of file cfd_dem_coupling_matrix_free.h.
|
protected |
TableHandler for post-processing phase volume calculations Stores total fluid volume and total particle volume data
Definition at line 479 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Torque information stored on boundary elements.
Definition at line 441 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Updated boundary points and their corresponding normal vectors.
Definition at line 433 of file cfd_dem_coupling_matrix_free.h.
|
protected |
Visualization handler for DEM output generation.
Definition at line 422 of file cfd_dem_coupling_matrix_free.h.