14#ifndef lethe_parameters_lagrangian_h
15#define lethe_parameters_lagrangian_h
20#include <deal.II/base/parameter_handler.h>
323 const ParameterHandler &prm);
377 std::vector<SizeDistributionType> &dist_types,
378 std::vector<double> &p_average_diameter,
379 std::vector<double> &p_size_std,
380 std::vector<bool> &custom_dist_read_from_file,
381 std::vector<std::string> &custom_dist_file_names,
382 std::vector<ProbabilityFunctionType> &custom_function_type,
383 std::vector<bool> &custom_interpolation,
384 std::vector<std::vector<double>> &custom_diameter_values,
385 std::vector<std::vector<double>> &custom_probabilities_values,
386 std::vector<DistributionWeightingType>
387 &distribution_weighting_basis_type,
388 std::vector<unsigned int> &seed_for_dist,
389 std::vector<double> &dia_min_cutoff,
390 std::vector<double> &dia_max_cutoff,
391 std::vector<int> &p_number,
392 std::vector<double> &p_density,
393 std::vector<double> &p_youngs_modulus,
394 std::vector<double> &p_poisson_ratio,
395 std::vector<double> &p_restitution_coefficient,
396 std::vector<double> &p_friction_coefficient,
397 std::vector<double> &p_rolling_viscous_damping_coefficient,
398 std::vector<double> &p_rolling_friction_coefficient,
399 std::vector<double> &p_surface_energy,
400 std::vector<double> &p_hamaker_constant,
401 std::vector<double> &p_thermal_conductivity,
402 std::vector<double> &p_specific_heat,
403 std::vector<double> &p_microhardness,
404 std::vector<double> &p_surface_slope,
405 std::vector<double> &p_surface_roughness,
406 std::vector<double> &p_thermal_accommodation,
407 std::vector<double> &p_real_youngs_modulus)
const;
480 (dim == 2) ? std::vector<unsigned int>{0, 1} :
481 std::vector<unsigned int>{0, 1, 2};
826 std::map<types::boundary_id, Tensor<1, 3>>
846 std::map<types::boundary_id, WallThermalBoundaryType>
852 std::map<types::boundary_id, std::shared_ptr<Function<3>>>
886 const types::boundary_id default_boundary_id);
1054 Tensor<1, 3>{{1., 0., 0.}},
1055 Tensor<1, 3>{{0., 1., 0.}},
1056 Tensor<1, 3>{{0., 0., 1.}}};
Parameters for a floating grid in DEM simulations.
Parameters::Mesh< dim > mesh
Mesh parameters for the floating grid.
void declare_parameters(ParameterHandler &prm)
Declare the parameters in the parameter handler.
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
Parameters::Lagrangian::GridMotion< dim > motion
Motion parameters for the floating grid.
double time_start
Activation time of the floating grid.
double time_end
Deactivation time of the floating grid.
Parameters for floating walls in DEM simulations.
std::vector< double > time_end
Deactivation time of each floating wall.
static void declare_default_entry(ParameterHandler &prm)
Declare default parameter entries for a single floating wall.
std::vector< Point< dim > > points_on_walls
A point on each floating wall surface.
unsigned int max_number_floating_walls
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
std::vector< Tensor< 1, dim > > floating_walls_normal_vectors
Outward normal vector of each floating wall.
void parse_floating_wall(const ParameterHandler &prm)
Parse parameters for a single floating wall.
void declare_parameters(ParameterHandler &prm) const
Declare the parameters in the parameter handler.
unsigned int floating_walls_number
Number of floating walls.
std::vector< double > time_start
Activation time of each floating wall.
ForceTorqueOnWall - Defines the parameters for the force and torques calculation on boundaries of the...
Parameters::Verbosity force_torque_verbosity
Verbosity level for force and torque output.
unsigned int output_frequency
Output frequency (in time steps).
Point< 3 > point_center_mass
Center of mass used for torque computation.
static void declare_parameters(ParameterHandler &prm)
Declare the parameters in the parameter handler.
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
std::string force_torque_output_name
File name prefix for force and torque output.
bool calculate_force_torque
Enable force and torque post-processing on wall boundaries.
Parameters for grid (mesh) motion in DEM simulations.
double grid_rotational_speed
Rotational speed of the rotating grid (rad/s).
unsigned int grid_rotational_axis
Rotational axis of the rotating grid (0=x, 1=y, 2=z).
enum Parameters::Lagrangian::GridMotion::MotionType motion_type
Type of grid motion.
MotionType
Type of grid motion.
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
Tensor< 1, dim > grid_translational_velocity
Translational velocity of the moving grid.
static void declare_parameters(ParameterHandler &prm)
Declare the parameters in the parameter handler.
Parameters controlling particle insertion in DEM simulations.
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
std::vector< double > list_vy
y-velocity for list insertion.
Point< 3 > insertion_box_point_1
First corner of the insertion box (volume method).
std::shared_ptr< Function< dim > > initial_temperature_function
std::vector< double > list_vx
x-velocity for list insertion.
std::shared_ptr< Function< dim > > insertion_acceptance_fct
Point< 3 > clear_box_point_1
First corner of the particle removal box.
std::vector< double > list_z
z-position for list insertion.
unsigned int inserted_this_step
Number of particles inserted at each insertion step.
std::vector< double > list_wz
z-angular velocity for list insertion.
Point< 3 > clear_box_point_2
Second corner of the particle removal box.
static void declare_parameters(ParameterHandler &prm)
Declare the parameters in the parameter handler.
std::vector< double > list_x
x-position for list insertion.
std::vector< double > list_T
Temperature for list insertion.
double insertion_maximum_offset
Maximum random offset applied to insertion positions.
Point< 3 > insertion_plane_point
Point on the insertion plane (plane method).
InsertionMethod
Method used to insert particles.
@ list
Insertion from a list in the prm file.
@ volume
Insertion within a volume defined by a box.
@ file
Insertion from a file listing particles.
@ plane
Insertion from a plane defined by a point and a normal.
@ packed
Insertion using the packed method.
std::vector< double > list_wy
y-angular velocity for list insertion.
std::vector< double > list_vz
z-velocity for list insertion.
int insertion_frequency
Frequency of insertion (in time steps).
double distance_threshold
Minimum distance threshold between inserted particles.
std::vector< unsigned int > direction_sequence
Direction sequence for particle insertion (1st, 2nd, 3rd).
std::vector< double > list_y
y-position for list insertion.
Tensor< 1, 3 > initial_omega
Initial angular velocity of inserted particles.
std::vector< std::string > list_of_input_files
List of input files for the file insertion method.
bool removing_particles_in_region
Enable removal of particles in a specified region.
Tensor< 1, 3 > initial_vel
Initial translational velocity of inserted particles.
int seed_for_insertion
Random seed for particle insertion.
enum Parameters::Lagrangian::InsertionInfo::InsertionMethod insertion_method
Point< 3 > insertion_box_point_2
Second corner of the insertion box (volume method).
std::vector< double > list_wx
x-angular velocity for list insertion.
std::vector< double > list_d
Diameter for list insertion.
Tensor< 1, 3 > insertion_plane_normal_vector
Normal vector of the insertion plane (plane method).
Numerical model parameters for DEM simulations.
unsigned int dynamic_load_balance_check_frequency
Check frequency for dynamic load balancing.
double granular_temperature_threshold
double f_coefficient_epsd
Model parameter for the EPSD rolling resistance model.
std::shared_ptr< Function< dim > > cell_weight_function
enum Parameters::Lagrangian::ModelParameters::ContactDetectionMethod contact_detection_method
LoadBalanceMethod
Load balancing strategy for parallel DEM simulations.
@ frequent
Perform load-balancing at a given frequency.
@ none
No load-balancing will be performed.
@ dynamic_with_sparse_contacts
@ once
Perform load-balancing once.
DEM::SolverType solver_type
Solver type (DEM, CFD-DEM, or DEM multiphysics).
RollingResistanceMethod rolling_resistance_method
Rolling resistance torque method.
double active_load_balancing_factor
unsigned int load_balance_particle_weight
Particle weight used for load balancing.
IntegrationMethod
Time integration method for particle motion.
@ velocity_verlet
Velocity Verlet second-order time integration scheme.
@ explicit_euler
Explicit Euler first-order time integration scheme.
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
ContactDetectionMethod
Contact detection method used in the simulation.
enum Parameters::Lagrangian::ModelParameters::LoadBalanceMethod load_balance_method
double dynamic_contact_search_factor
Safety factor for dynamic contact search.
unsigned int contact_detection_frequency
Frequency of particle-particle and particle-wall contact detection.
enum Parameters::Lagrangian::ModelParameters::IntegrationMethod integration_method
bool disable_position_integration
Disable position integration for particles.
double inactive_load_balancing_factor
unsigned int load_balance_frequency
Load balance frequency (in time steps).
double dmt_cut_off_threshold
Cut-off threshold beyond which Van der Waals forces are ignored.
bool sparse_particle_contacts
Enable sparse particle contacts to optimize performance.
double load_balance_threshold
Load balance threshold (for dynamic load balancing).
ParticleParticleContactForceModel particle_particle_contact_force_model
Particle-particle contact force model.
ParticleWallContactForceModel particle_wall_contact_force_method
Particle-wall contact force model.
static void declare_parameters(ParameterHandler &prm)
Declare the parameters in the parameter handler.
double solid_fraction_threshold
double neighborhood_threshold
unsigned int load_balance_step
Load balance step (for single-step load balancing).
Mesh - Parameters that control mesh reading and mesh generation.
SolverType
Identifies which physics is solved for the DEM particles.
ParticleParticleContactForceModel
Contact force model for particle-particle interactions.
@ hertz_JKR
Hertz model with Johnson-Kendall-Roberts cohesive force.
@ hertz_mindlin_limit_overlap
Hertz-Mindlin model with a limitation on tangential overlap.
@ hertz_mindlin_limit_force
Hertz-Mindlin model with a limitation on tangential force.
@ DMT
Derjaguin-Muller-Toporov model.
SizeDistributionType
Type of particle size distribution.
@ lognormal
Log-normal distribution.
@ custom
Custom distribution.
@ uniform
Uniform distribution.
@ normal
Normal distribution.
WallThermalBoundaryType
Thermal boundary type of the grid in multiphysic DEM. It is used to define the thermal boundary condi...
@ adiabatic
No heat flux through the wall.
@ temperature
Temperature imposed on the wall. It can vary in space and time.
DistributionWeightingType
Weighting basis for particle size distributions.
@ volume_based
Volume-based distribution weighting.
@ number_based
Number-based distribution weighting.
ParticleWallContactForceModel
Contact force model for particle-wall interactions.
@ JKR
Johnson-Kendall-Roberts model.
@ CDF
Cumulative density function.
@ PDF
Probability density function.
RollingResistanceMethod
Method used to compute the rolling resistance torque.
@ epsd
Elastic-plastic spring-dashpot.
@ viscous
Viscous rolling resistance.
@ constant
Constant rolling resistance.
@ none
No rolling resistance.
std::map< dealii::types::boundary_id, PeriodicBoundary > PeriodicBoundaries
The periodic boundary pairs of a simulation, keyed by the principal (first) boundary id of each pair.
Boundary conditions for DEM simulations.
void parse_boundary_conditions(ParameterHandler &prm)
Parse boundary condition parameters for a single boundary.
std::map< types::boundary_id, double > boundary_rotational_speed
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
std::map< types::boundary_id, Tensor< 1, 3 > > boundary_translational_velocity
PeriodicBoundaries periodic_boundaries
void declare_parameters(ParameterHandler &prm) const
Declare the parameters in the parameter handler.
static void declare_default_entry(ParameterHandler &prm, const types::boundary_id default_boundary_id)
Declare default parameter entries for a single boundary condition.
std::set< types::boundary_id > outlet_boundaries
std::map< types::boundary_id, std::shared_ptr< Function< 3 > > > boundary_temperature
unsigned int number_of_dem_boundary_conditions
Number of DEM boundary conditions.
std::map< types::boundary_id, WallThermalBoundaryType > thermal_boundary_type
std::map< types::boundary_id, Tensor< 1, 3 > > boundary_rotational_vector
std::map< types::boundary_id, Point< 3 > > point_on_rotation_axis
static constexpr unsigned int max_number_of_dem_boundary_conditions
Physical properties of particles, walls, and interstitial gas for Lagrangian (DEM) simulations.
double specific_heats_ratio_gas
Specific heats ratio of the interstitial gas.
double molecular_mean_free_path_gas
Molecular mean free path of the interstitial gas.
std::vector< double > friction_coefficient_particle
Friction coefficient of each particle type.
double thermal_accommodation_wall
Thermal accommodation coefficient of the wall.
double dynamic_viscosity_gas
Dynamic viscosity of the interstitial gas.
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
std::vector< ProbabilityFunctionType > custom_probability_function_type
Custom distribution function type (PDF or CDF).
void parse_particle_properties(const unsigned int &particle_type, const ParameterHandler &prm)
Parse the physical properties for a given particle type.
double surface_slope_wall
Surface slope of the wall.
std::vector< DistributionWeightingType > distribution_weighting_type
double thermal_conductivity_wall
Thermal conductivity of the wall.
Tensor< 1, 3 > g
Gravitational acceleration vector.
std::vector< double > rolling_friction_coefficient_particle
Rolling friction coefficient of each particle type.
std::vector< double > surface_energy_particle
Surface energy of each particle type.
std::vector< bool > custom_distribution_from_file
Indicate if the custom distribution is read from file.
double hamaker_constant_wall
Hamaker constant of the wall.
std::vector< double > youngs_modulus_particle
Young's modulus of each particle type.
std::vector< std::vector< double > > particle_custom_probability
std::vector< double > thermal_conductivity_particle
Thermal conductivity of each particle type.
std::vector< SizeDistributionType > distribution_type
std::vector< double > hamaker_constant_particle
Hamaker constant of each particle type.
std::vector< double > particle_size_std
Size standard deviation of each particle type.
std::vector< double > surface_roughness_particle
Surface roughness of each particle type.
void declare_parameters(ParameterHandler &prm) const
Declare the parameters in the parameter handler.
double surface_energy_wall
Surface energy of the wall.
double real_youngs_modulus_wall
Real Young's modulus of the wall.
std::vector< double > specific_heat_particle
Specific heat of each particle type.
std::vector< double > diameter_min_cutoff
Minimum diameter cutoff for lognormal distribution.
double friction_coefficient_wall
Friction coefficient of the wall.
std::vector< double > rolling_viscous_damping_coefficient_particle
Rolling viscous damping coefficient of each particle type.
std::vector< double > real_youngs_modulus_particle
Real Young's modulus of each particle type.
void initialize_containers(std::vector< SizeDistributionType > &dist_types, std::vector< double > &p_average_diameter, std::vector< double > &p_size_std, std::vector< bool > &custom_dist_read_from_file, std::vector< std::string > &custom_dist_file_names, std::vector< ProbabilityFunctionType > &custom_function_type, std::vector< bool > &custom_interpolation, std::vector< std::vector< double > > &custom_diameter_values, std::vector< std::vector< double > > &custom_probabilities_values, std::vector< DistributionWeightingType > &distribution_weighting_basis_type, std::vector< unsigned int > &seed_for_dist, std::vector< double > &dia_min_cutoff, std::vector< double > &dia_max_cutoff, std::vector< int > &p_number, std::vector< double > &p_density, std::vector< double > &p_youngs_modulus, std::vector< double > &p_poisson_ratio, std::vector< double > &p_restitution_coefficient, std::vector< double > &p_friction_coefficient, std::vector< double > &p_rolling_viscous_damping_coefficient, std::vector< double > &p_rolling_friction_coefficient, std::vector< double > &p_surface_energy, std::vector< double > &p_hamaker_constant, std::vector< double > &p_thermal_conductivity, std::vector< double > &p_specific_heat, std::vector< double > &p_microhardness, std::vector< double > &p_surface_slope, std::vector< double > &p_surface_roughness, std::vector< double > &p_thermal_accommodation, std::vector< double > &p_real_youngs_modulus) const
initialize_containers - Initialize the containers used to store the particle size distribution and ph...
std::vector< double > poisson_ratio_particle
Poisson's ratio of each particle type.
double youngs_modulus_wall
Young's modulus of the wall.
static void declare_default_entry(ParameterHandler &prm)
Declare default parameter entries for a single particle type.
std::vector< double > diameter_max_cutoff
Maximum diameter cutoff for lognormal distribution.
std::vector< std::string > custom_distribution_filenames
Filename for the custom distribution for each particle type.
std::vector< double > density_particle
Density of each particle type.
std::vector< double > surface_slope_particle
Surface slope of each particle type.
double microhardness_wall
Microhardness of the wall.
std::vector< std::vector< double > > particle_custom_diameter
List of diameters for the custom distribution for each particle type.
std::vector< double > particle_average_diameter
Average diameter of each particle type.
std::vector< double > microhardness_particle
Microhardness of each particle type.
unsigned int particle_type_maximum_number
unsigned int particle_type_number
Number of particle types.
double specific_heat_gas
Specific heat of the interstitial gas.
double rolling_friction_wall
Rolling friction coefficient of the wall.
std::vector< double > thermal_accommodation_particle
Thermal accommodation coefficient of each particle type.
double thermal_conductivity_gas
Thermal conductivity of the interstitial gas.
double rolling_viscous_damping_wall
Rolling viscous damping coefficient of the wall.
std::vector< bool > custom_distribution_interpolation
double poisson_ratio_wall
Poisson's ratio of the wall.
double restitution_coefficient_wall
Coefficient of restitution of the wall.
std::vector< unsigned int > seed_for_distributions
Random seed for the size distribution.
std::vector< double > restitution_coefficient_particle
Coefficients of restitution of each particle type.
std::vector< int > number
Number particles of each particle type.
double surface_roughness_wall
Surface roughness of the wall.
Lagrangian Postprocessing - Defines the parameters for the Lagrangian post-processing.
Parameters::Verbosity collision_verbosity
Verbosity level for collision statistics output.
static void declare_parameters(ParameterHandler &prm)
Declare the parameters in the parameter handler.
bool lagrangian_post_processing_enabled
Enable Lagrangian post-processing.
std::vector< int > particle_wall_collision_boundary_ids
Boundary IDs of the walls for which collisions are logged.
bool particle_wall_collision_statistics
Enable logging of particle-wall contact statistics.
std::string collision_stats_file_name
File name for exporting collision statistics (CSV format).
bool force_chains
Enable force chains visualization.
bool log_collisions_with_all_walls
Log collisions with all walls (if false, only selected boundaries).
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
Defines parameters used to construct particle ray tracing class.
double max_angular_offset
Maximum angular offset applied to the photon displacement direction.
unsigned int prn_seed_photon_displacement
Random seed for photon displacement angular offset.
static void declare_parameters(ParameterHandler &prm)
Declare the parameters in the parameter handler.
void parse_parameters(ParameterHandler &prm)
Parse the parameters from the parameter handler.
double max_insertion_offset
Maximum random offset applied to the photon insertion position.
std::vector< Tensor< 1, 3 > > insertion_directions_units_vector
std::vector< double > step_between_photons_each_directions
std::vector< unsigned int > n_photons_each_directions
Number of photons to insert along each direction.
Point< 3 > starting_point
Location of the first photon to be inserted.
unsigned int prn_seed_photon_insertion
Random seed for photon insertion position offset.
Tensor< 1, 3 > ref_displacement_tensor_unit
Reference unit tensor defining the photon displacement direction.