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

#include <particle_point_line_contact_force.h>

Public Member Functions

 ParticlePointLineForce ()
void calculate_particle_point_contact_force (const typename DEM::dem_data_structures< dim >::particle_point_in_contact *particle_point_pairs_in_contact, const Parameters::Lagrangian::LagrangianPhysicalProperties &physical_properties, std::vector< Tensor< 1, 3 > > &force)
void calculate_particle_line_contact_force (const typename DEM::dem_data_structures< dim >::particle_line_in_contact *particle_line_pairs_in_contact, const Parameters::Lagrangian::LagrangianPhysicalProperties &physical_properties, std::vector< Tensor< 1, 3 > > &force)
void calculate_particle_point_shift_displacement (const typename DEM::dem_data_structures< dim >::particle_point_in_contact &particle_point_pairs_in_contact, std::vector< Tensor< 1, 3 > > &displacement)
void calculate_particle_line_shift_displacement (const typename DEM::dem_data_structures< dim >::particle_line_in_contact &particle_line_pairs_in_contact, std::vector< Tensor< 1, 3 > > &displacement)
unsigned int get_number_of_contacts () const
void reset_number_of_contacts ()

Private Member Functions

void add_shift_displacement (const Particles::ParticleIterator< dim > &particle, const Point< 3 > &particle_location, const Point< 3 > &contact_point, std::vector< Tensor< 1, 3 > > &displacement)
Point< 3 > find_projection_point (const Point< 3 > &point_p, const Point< 3 > &point_a, const Point< 3 > &point_b)

Private Attributes

unsigned int n_contacts = 0

Detailed Description

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

Calculate the non-linear particle-point and particle-line contact force using the information obtained from the fine search and physical properties of particles and walls. Since the inputs and the calculation method of particle-point and particle-line contact forces are similar, we only used one function for both tasks.

Template Parameters
dimAn integer that denotes the number of spatial dimensions.
PropertiesIndexIndex of the properties used within the ParticleHandler.

Definition at line 30 of file particle_point_line_contact_force.h.

Constructor & Destructor Documentation

◆ ParticlePointLineForce()

template<int dim, typename PropertiesIndex>
ParticlePointLineForce< dim, PropertiesIndex >::ParticlePointLineForce ( )
default

Member Function Documentation

◆ add_shift_displacement()

template<int dim, typename PropertiesIndex>
void ParticlePointLineForce< dim, PropertiesIndex >::add_shift_displacement ( const Particles::ParticleIterator< dim > & particle,
const Point< 3 > & particle_location,
const Point< 3 > & contact_point,
std::vector< Tensor< 1, 3 > > & displacement )
private

Add the displacement that separates a particle from the boundary point or line it overlaps to the displacement of the particle. The displacement is along the normal from the closest point of the boundary to the particle center and is slightly larger than the normal overlap, as in the particle-wall shift model.

Parameters
[in]particleIterator of the particle in contact.
[in]particle_locationLocation of the particle center in 3D.
[in]contact_pointPoint of the boundary point or line that is the closest to the particle center.
[in,out]displacementDisplacement of each local particle.

Definition at line 319 of file particle_point_line_contact_force.cc.

References n_contacts.

◆ calculate_particle_line_contact_force()

template<int dim, typename PropertiesIndex>
void ParticlePointLineForce< dim, PropertiesIndex >::calculate_particle_line_contact_force ( const typename DEM::dem_data_structures< dim >::particle_line_in_contact * particle_line_pairs_in_contact,
const Parameters::Lagrangian::LagrangianPhysicalProperties & physical_properties,
std::vector< Tensor< 1, 3 > > & force )

Calculate of the particle-line contact force using non-linear (Hertzian) model.

Parameters
particle_line_pairs_in_contactRequired information for calculation of the particle-line contact force
physical_propertiesDEM physical_properties declared in the .prm file
forceForce acting on particles

Definition at line 133 of file particle_point_line_contact_force.cc.

References find_projection_point(), point_nd_to_3d(), Parameters::Lagrangian::LagrangianPhysicalProperties::poisson_ratio_wall, Parameters::Lagrangian::LagrangianPhysicalProperties::restitution_coefficient_wall, and Parameters::Lagrangian::LagrangianPhysicalProperties::youngs_modulus_wall.

◆ calculate_particle_line_shift_displacement()

template<int dim, typename PropertiesIndex>
void ParticlePointLineForce< dim, PropertiesIndex >::calculate_particle_line_shift_displacement ( const typename DEM::dem_data_structures< dim >::particle_line_in_contact & particle_line_pairs_in_contact,
std::vector< Tensor< 1, 3 > > & displacement )

Calculate the displacements that separate the particles from the boundary lines they overlap. This "contact force" model is used by the packed insertion method.

Parameters
[in]particle_line_pairs_in_contactRequired information for calculation of the particle-line contacts.
[in,out]displacementDisplacement of each local particle. The displacement of each particle-line contact is added to the entry of its particle.

Definition at line 284 of file particle_point_line_contact_force.cc.

References add_shift_displacement(), find_projection_point(), and point_nd_to_3d().

◆ calculate_particle_point_contact_force()

template<int dim, typename PropertiesIndex>
void ParticlePointLineForce< dim, PropertiesIndex >::calculate_particle_point_contact_force ( const typename DEM::dem_data_structures< dim >::particle_point_in_contact * particle_point_pairs_in_contact,
const Parameters::Lagrangian::LagrangianPhysicalProperties & physical_properties,
std::vector< Tensor< 1, 3 > > & force )

Calculate of the particle-point contact force using non-linear (Hertzian) model.

Parameters
particle_point_pairs_in_contactRequired information for calculation of the particle-point contact force
physical_propertiesDEM physical_properties declared in the .prm file
forceForce acting on particles

Definition at line 19 of file particle_point_line_contact_force.cc.

References point_nd_to_3d(), Parameters::Lagrangian::LagrangianPhysicalProperties::poisson_ratio_wall, Parameters::Lagrangian::LagrangianPhysicalProperties::restitution_coefficient_wall, and Parameters::Lagrangian::LagrangianPhysicalProperties::youngs_modulus_wall.

◆ calculate_particle_point_shift_displacement()

template<int dim, typename PropertiesIndex>
void ParticlePointLineForce< dim, PropertiesIndex >::calculate_particle_point_shift_displacement ( const typename DEM::dem_data_structures< dim >::particle_point_in_contact & particle_point_pairs_in_contact,
std::vector< Tensor< 1, 3 > > & displacement )

Calculate the displacements that separate the particles from the boundary points they overlap. This "contact force" model is used by the packed insertion method.

Parameters
[in]particle_point_pairs_in_contactRequired information for calculation of the particle-point contacts.
[in,out]displacementDisplacement of each local particle. The displacement of each particle-point contact is added to the entry of its particle.

Definition at line 256 of file particle_point_line_contact_force.cc.

References add_shift_displacement(), and point_nd_to_3d().

◆ find_projection_point()

template<int dim, typename PropertiesIndex>
Point< 3 > ParticlePointLineForce< dim, PropertiesIndex >::find_projection_point ( const Point< 3 > & point_p,
const Point< 3 > & point_a,
const Point< 3 > & point_b )
private

This private function is used to find the projection of point_p on a line with beginning and ending vertices of point_a and point_b, respectively.

Parameters
point_pA point which is going to be projected on the line
point_aBeginning point of the line
point_bEnding point of the line
Returns
The projection of point_p on the line (from point_a to point_b)

Definition at line 347 of file particle_point_line_contact_force.cc.

◆ get_number_of_contacts()

template<int dim, typename PropertiesIndex>
unsigned int ParticlePointLineForce< dim, PropertiesIndex >::get_number_of_contacts ( ) const
inline

Return the number of particle-point and particle-line contacts that occurred in the present pseudo-time step when using the packed insertion method.

Definition at line 111 of file particle_point_line_contact_force.h.

References n_contacts.

◆ reset_number_of_contacts()

template<int dim, typename PropertiesIndex>
void ParticlePointLineForce< dim, PropertiesIndex >::reset_number_of_contacts ( )
inline

Reset the counter of number of contacts for the next pseudo-time step.

Definition at line 120 of file particle_point_line_contact_force.h.

References n_contacts.

Member Data Documentation

◆ n_contacts

template<int dim, typename PropertiesIndex>
unsigned int ParticlePointLineForce< dim, PropertiesIndex >::n_contacts = 0
private

Number of particle-point and particle-line contacts in the present pseudo-time step when using the packed insertion method.

Definition at line 163 of file particle_point_line_contact_force.h.


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