Lethe Open-Source Library version 1.2.0
Developer Guide
Loading...
Searching...
No Matches
Parameters::Lagrangian::ModelParameters< dim > Class Template Reference

#include <parameters_lagrangian.h>

Public Types

enum class  LoadBalanceMethod {
  none , once , frequent , dynamic ,
  dynamic_with_sparse_contacts
}
enum class  ContactDetectionMethod { constant , dynamic }
enum class  IntegrationMethod { velocity_verlet , explicit_euler }

Public Member Functions

void parse_parameters (ParameterHandler &prm)

Static Public Member Functions

static void declare_parameters (ParameterHandler &prm)

Public Attributes

enum Parameters::Lagrangian::ModelParameters::LoadBalanceMethod load_balance_method
unsigned int load_balance_step = 100000
unsigned int load_balance_frequency = 100000
double load_balance_threshold = 0.5
unsigned int dynamic_load_balance_check_frequency = 10000
unsigned int contact_detection_frequency = 1
std::shared_ptr< Function< dim > > cell_weight_function
unsigned int load_balance_particle_weight = 2000
double active_load_balancing_factor = 1.0
double inactive_load_balancing_factor = 1.0
double dynamic_contact_search_factor = 0.8
enum Parameters::Lagrangian::ModelParameters::ContactDetectionMethod contact_detection_method
double neighborhood_threshold = 1.3
double dmt_cut_off_threshold = 0.1
ParticleParticleContactForceModel particle_particle_contact_force_model
ParticleWallContactForceModel particle_wall_contact_force_method
RollingResistanceMethod rolling_resistance_method
double f_coefficient_epsd = 0.
enum Parameters::Lagrangian::ModelParameters::IntegrationMethod integration_method
DEM::SolverType solver_type = DEM::SolverType::dem
bool sparse_particle_contacts = false
bool advect_particles = false
double granular_temperature_threshold = 1e-4
double solid_fraction_threshold = 0.4
bool disable_position_integration = false

Detailed Description

template<int dim>
class Parameters::Lagrangian::ModelParameters< dim >

Numerical model parameters for DEM simulations.

This class stores the contact detection, load balancing, force model selection, time integration, and sparse contact optimization parameters.

Template Parameters
dimNumber of spatial dimensions.

Definition at line 538 of file parameters_lagrangian.h.

Member Enumeration Documentation

◆ ContactDetectionMethod

Contact detection method used in the simulation.

Enumerator
constant 

Carry-out contact detection at a constant frequency.

dynamic 

Carry-out contact detection when the maximum displacement of a particle exceeds the smallest contact search criterion.

Definition at line 599 of file parameters_lagrangian.h.

◆ IntegrationMethod

Time integration method for particle motion.

Enumerator
velocity_verlet 

Velocity Verlet second-order time integration scheme.

explicit_euler 

Explicit Euler first-order time integration scheme.

Definition at line 635 of file parameters_lagrangian.h.

◆ LoadBalanceMethod

Load balancing strategy for parallel DEM simulations.

Enumerator
none 

No load-balancing will be performed.

once 

Perform load-balancing once.

frequent 

Perform load-balancing at a given frequency.

dynamic 

Perform load-balancing when the computational load among processes becomes too uneven.

dynamic_with_sparse_contacts 

Perform load-balancing in a similar manner to LoadBalanceMethod::dynamic but considering also the mobility status of the cells.

Definition at line 544 of file parameters_lagrangian.h.

Member Function Documentation

◆ declare_parameters()

◆ parse_parameters()

Member Data Documentation

◆ active_load_balancing_factor

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::active_load_balancing_factor = 1.0

Factor applied to particle weight for active cells in load balancing (only used with adaptive sparse contacts).

Definition at line 587 of file parameters_lagrangian.h.

◆ advect_particles

template<int dim>
bool Parameters::Lagrangian::ModelParameters< dim >::advect_particles = false

Enable advection of particles using cell-averaged fluid velocity and acceleration.

Definition at line 653 of file parameters_lagrangian.h.

◆ cell_weight_function

template<int dim>
std::shared_ptr<Function<dim> > Parameters::Lagrangian::ModelParameters< dim >::cell_weight_function

Function returning the weight of a cell based on its barycenter position.

Definition at line 580 of file parameters_lagrangian.h.

◆ contact_detection_frequency

template<int dim>
unsigned int Parameters::Lagrangian::ModelParameters< dim >::contact_detection_frequency = 1

Frequency of particle-particle and particle-wall contact detection.

Definition at line 576 of file parameters_lagrangian.h.

◆ contact_detection_method

◆ disable_position_integration

template<int dim>
bool Parameters::Lagrangian::ModelParameters< dim >::disable_position_integration = false

Disable position integration for particles.

Definition at line 664 of file parameters_lagrangian.h.

◆ dmt_cut_off_threshold

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::dmt_cut_off_threshold = 0.1

Cut-off threshold beyond which Van der Waals forces are ignored.

Definition at line 615 of file parameters_lagrangian.h.

◆ dynamic_contact_search_factor

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::dynamic_contact_search_factor = 0.8

Safety factor for dynamic contact search.

Definition at line 594 of file parameters_lagrangian.h.

◆ dynamic_load_balance_check_frequency

template<int dim>
unsigned int Parameters::Lagrangian::ModelParameters< dim >::dynamic_load_balance_check_frequency = 10000

Check frequency for dynamic load balancing.

Definition at line 573 of file parameters_lagrangian.h.

◆ f_coefficient_epsd

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::f_coefficient_epsd = 0.

Model parameter for the EPSD rolling resistance model.

Definition at line 630 of file parameters_lagrangian.h.

◆ granular_temperature_threshold

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::granular_temperature_threshold = 1e-4

Minimum granular temperature for cells where particle contacts are evaluated.

Definition at line 657 of file parameters_lagrangian.h.

◆ inactive_load_balancing_factor

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::inactive_load_balancing_factor = 1.0

Factor applied to particle weight for inactive cells in load balancing (only used with adaptive sparse contacts).

Definition at line 591 of file parameters_lagrangian.h.

◆ integration_method

Initial value:

Time integration method for particle motion.

◆ load_balance_frequency

template<int dim>
unsigned int Parameters::Lagrangian::ModelParameters< dim >::load_balance_frequency = 100000

Load balance frequency (in time steps).

Definition at line 567 of file parameters_lagrangian.h.

◆ load_balance_method

Initial value:

Load balancing strategy for parallel DEM simulations.

◆ load_balance_particle_weight

template<int dim>
unsigned int Parameters::Lagrangian::ModelParameters< dim >::load_balance_particle_weight = 2000

Particle weight used for load balancing.

Definition at line 583 of file parameters_lagrangian.h.

◆ load_balance_step

template<int dim>
unsigned int Parameters::Lagrangian::ModelParameters< dim >::load_balance_step = 100000

Load balance step (for single-step load balancing).

Definition at line 564 of file parameters_lagrangian.h.

◆ load_balance_threshold

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::load_balance_threshold = 0.5

Load balance threshold (for dynamic load balancing).

Definition at line 570 of file parameters_lagrangian.h.

◆ neighborhood_threshold

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::neighborhood_threshold = 1.3

Contact search neighborhood threshold (neighborhood diameter to particle diameter ratio).

Definition at line 612 of file parameters_lagrangian.h.

◆ particle_particle_contact_force_model

template<int dim>
ParticleParticleContactForceModel Parameters::Lagrangian::ModelParameters< dim >::particle_particle_contact_force_model
Initial value:

Particle-particle contact force model.

Definition at line 618 of file parameters_lagrangian.h.

◆ particle_wall_contact_force_method

template<int dim>
ParticleWallContactForceModel Parameters::Lagrangian::ModelParameters< dim >::particle_wall_contact_force_method
Initial value:

Particle-wall contact force model.

Definition at line 622 of file parameters_lagrangian.h.

◆ rolling_resistance_method

template<int dim>
RollingResistanceMethod Parameters::Lagrangian::ModelParameters< dim >::rolling_resistance_method
Initial value:

Rolling resistance torque method.

Definition at line 626 of file parameters_lagrangian.h.

◆ solid_fraction_threshold

template<int dim>
double Parameters::Lagrangian::ModelParameters< dim >::solid_fraction_threshold = 0.4

Maximum solid fraction for cells where particle contacts are always evaluated regardless of granular temperature.

Definition at line 661 of file parameters_lagrangian.h.

◆ solver_type

Solver type (DEM, CFD-DEM, or DEM multiphysics).

Definition at line 646 of file parameters_lagrangian.h.

◆ sparse_particle_contacts

template<int dim>
bool Parameters::Lagrangian::ModelParameters< dim >::sparse_particle_contacts = false

Enable sparse particle contacts to optimize performance.

Definition at line 649 of file parameters_lagrangian.h.


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