Lethe Open-Source Library version 1.2.0
Developer Guide
Loading...
Searching...
No Matches
rolling_resistance_torque_models.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) 2021-2024 The Lethe Authors
2// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception OR LGPL-2.1-or-later
3
4#ifndef lethe_rolling_resistance_torque_models_h
5#define lethe_rolling_resistance_torque_models_h
6
7/**
8 * @brief No rolling resistance torque model. No calculation is being done with
9 * this model.
10 */
11
12inline Tensor<1, 3>
14{
15 // No rolling resistance torque model. When this model is use, the rolling
16 // friction is zero.
17 Tensor<1, 3> rolling_resistance_torque({0.0, 0.0, 0.0});
18
19 return rolling_resistance_torque;
20}
21
22/**
23 * @brief Calculation of the constant rolling resistance torque model using the
24 * information obtained from the fine search and physical properties.
25 *
26 * The model woks as follows:
27 * M_r = - mu_r * R_eff * |F_n| * omega_hat
28 * omega_hat = (omega_i - omega_j) / (|omega_i - omega_j|)
29 *
30 * @tparam PropertiesIndex Index of the properties used within the ParticleHandler.
31 *
32 * @param[in] effective_r Effective radius.
33 * @param[in] particle_one_properties Properties of particle one in contact.
34 * @param[in] particle_two_properties Properties of particle two in contact.
35 * @param[in] effective_rolling_friction_coefficient Effective_rolling friction
36 * @param[in] effective_rolling_friction_coefficient Effective_rolling friction
37 * coefficient
38 * @param[in] normal_force_norm Norm of the normal force.
39 *
40 */
41template <typename PropertiesIndex>
42inline Tensor<1, 3>
44 const double effective_r,
45 const ArrayView<const double> &particle_one_properties,
46 const ArrayView<const double> &particle_two_properties,
47 const double effective_rolling_friction_coefficient,
48 const double normal_force_norm)
49
50{
51 // For calculation of rolling resistance torque, we need to obtain
52 // omega_ij using rotational velocities of particles one and two
53 Tensor<1, 3> particle_one_angular_velocity, particle_two_angular_velocity;
54 for (int d = 0; d < 3; ++d)
55 {
56 particle_one_angular_velocity[d] =
57 particle_one_properties[PropertiesIndex::omega_x + d];
58 particle_two_angular_velocity[d] =
59 particle_two_properties[PropertiesIndex::omega_x + d];
60 }
61
62 Tensor<1, 3> omega_ij =
63 particle_one_angular_velocity - particle_two_angular_velocity;
64 Tensor<1, 3> omega_ij_direction = omega_ij / (omega_ij.norm() + DBL_MIN);
65
66 // Calculation of rolling resistance torque
67 return (-effective_rolling_friction_coefficient * effective_r *
68 normal_force_norm * omega_ij_direction);
69}
70
71/**
72 * @brief Calculation of the viscous rolling resistance torque model using the
73 * information obtained from the fine search and physical properties.
74 *
75 * The model woks as follows:
76 * M_r = - mu_r * R_eff * |F_n| * |V_omega| * omega_hat
77 * omega_hat = (omega_i - omega_j) / (|omega_i - omega_j|)
78 * V_omega = omega_i × (R_i * n_ij) - omega_j × (R_j * n_ji)
79 *
80 * @tparam PropertiesIndex Index of the properties used within the ParticleHandler.
81 *
82 * @param[in] effective_r Effective radius.
83 * @param[in] particle_one_properties Properties of particle one in contact.
84 * @param[in] particle_two_properties Properties of particle two in contact.
85 * @param[in] effective_rolling_friction_coefficient Effective_rolling friction
86 * coefficient
87 * @param[in] normal_force_norm Norm of the normal force.
88 * @param[in] normal_unit_vector Normal unit vector.
89 */
90
91template <typename PropertiesIndex>
92inline Tensor<1, 3>
94 const double effective_r,
95 const ArrayView<const double> &particle_one_properties,
96 const ArrayView<const double> &particle_two_properties,
97 const double effective_rolling_friction_coefficient,
98 const double normal_force_norm,
99 const Tensor<1, 3> &normal_unit_vector)
100
101{
102 // For calculation of rolling resistance torque, we need to obtain
103 // omega_ij using rotational velocities of particles one and two
104 Tensor<1, 3> particle_one_angular_velocity, particle_two_angular_velocity;
105 for (int d = 0; d < 3; ++d)
106 {
107 particle_one_angular_velocity[d] =
108 particle_one_properties[PropertiesIndex::omega_x + d];
109 particle_two_angular_velocity[d] =
110 particle_two_properties[PropertiesIndex::omega_x + d];
111 }
112
113 Tensor<1, 3> omega_ij =
114 particle_one_angular_velocity - particle_two_angular_velocity;
115 Tensor<1, 3> omega_ij_direction = omega_ij / (omega_ij.norm() + DBL_MIN);
116
117 Tensor<1, 3> v_omega =
118 cross_product_3d(particle_one_angular_velocity,
119 particle_one_properties[PropertiesIndex::dp] * 0.5 *
120 normal_unit_vector) -
121 cross_product_3d(particle_two_angular_velocity,
122 particle_two_properties[PropertiesIndex::dp] * 0.5 *
123 -normal_unit_vector);
124
125 // Calculation of rolling resistance torque
126 return (-effective_rolling_friction_coefficient * effective_r *
127 normal_force_norm * v_omega.norm() * omega_ij_direction);
128}
129
130/**
131 * @brief
132 *
133 * @tparam dim An integer that denotes the dimension of the space in which
134 * the problem is solved.
135 * @tparam PropertiesIndex Index of the properties used within the ParticleHandler.
136 *
137 * @param[in] effective_r Effective radius.
138 * @param[in] particle_one_properties Properties of particle one in contact.
139 * @param[in] particle_two_properties Properties of particle two in contact.
140 * @param[in] effective_rolling_viscous_damping_coefficient
141 * Effective rolling viscous damping
142 * @param[in] effective_rolling_friction_coefficient Effective_rolling friction
143 * coefficient
144 * @param[in] f_coefficient Model parameter for the viscous damping.
145 * @param[in] normal_force_norm Norm of the normal force.
146 * @param[in] dt DEM time step.
147 * @param[in] normal_spring_constant normal contact stiffness constant.
148 * @param[in] normal_unit_vector Normal unit vector between particles in
149 * contact.
150 * @param[in,out] cumulative_rolling_resistance_spring_torque Cumulative
151 * rolling resistance torque for the EPSD rolling resistance model.
152 */
153
154template <int dim, typename PropertiesIndex>
155inline Tensor<1, 3>
157 const double effective_r,
158 const ArrayView<const double> &particle_one_properties,
159 const ArrayView<const double> &particle_two_properties,
160 const double effective_rolling_friction_coefficient,
161 const double effective_rolling_viscous_damping_coefficient,
162 const double f_coefficient,
163 const double normal_force_norm,
164 const double dt,
165 const double normal_spring_constant,
166 const Tensor<1, 3> &normal_unit_vector,
167 Tensor<1, 3> &cumulative_rolling_resistance_spring_torque)
168
169{
170 // Useful value used more than once:
171 // mu_r * R_e
172 const double mu_r_times_R_e =
173 effective_rolling_friction_coefficient * effective_r;
174
175
176 // For calculation of rolling resistance torque, we need to obtain
177 // omega_ij using rotational velocities of particles one and two
178 // omega_ij is the relative angular velocity
179 Tensor<1, 3> omega_ij;
180 for (int d = 0; d < 3; ++d)
181 // particle_one - particle_two
182 omega_ij[d] = particle_one_properties[PropertiesIndex::omega_x + d] -
183 particle_two_properties[PropertiesIndex::omega_x + d];
184
185 // Non-collinear component of the relative velocity.
186 const Tensor<1, 3> omega_ij_perpendicular =
187 omega_ij -
188 scalar_product(omega_ij, normal_unit_vector) * normal_unit_vector;
189
190 // Delta theta : incremental relative rotation between i and j
191 const Tensor<1, 3> delta_theta = dt * omega_ij_perpendicular;
192
193 // Rolling stiffness
194 const double K_r = [&]() {
195 if constexpr (dim == 3)
196 return 2.25 * normal_spring_constant *
197 Utilities::fixed_power<2>(mu_r_times_R_e);
198 else
199 return 3. * normal_spring_constant *
200 Utilities::fixed_power<2>(mu_r_times_R_e);
201 }();
202
203 // Update the spring torque
204 cumulative_rolling_resistance_spring_torque -= K_r * delta_theta;
205
206 // Limiting spring torque
207 const double M_r_max = mu_r_times_R_e * normal_force_norm;
208
209 const double rolling_resistance_spring_torque_norm =
210 cumulative_rolling_resistance_spring_torque.norm();
211
212 // 1.4 * m_i * (R_i)^2
213 // Total inertia of particle i evaluated at the contact point.
214 const double I_i = 1.4 * particle_one_properties[PropertiesIndex::mass] *
215 Utilities::fixed_power<2>(
216 0.5 * particle_one_properties[PropertiesIndex::dp]);
217
218 // 1.4 * m_j * (R_j)^2
219 // Total inertia of particle evaluated at the contact point.
220 const double I_j = 1.4 * particle_two_properties[PropertiesIndex::mass] *
221 Utilities::fixed_power<2>(
222 0.5 * particle_two_properties[PropertiesIndex::dp]);
223
224 // Harmonic mean of the inertia at the point of contact. (Effective
225 // inertia)
226 const double I_e = I_i * I_j / (I_i + I_j);
227
228 // C_r_crit = 2. * sqrt(I_r * K_r)
229 // C_r = eta_r * C_r_crit
230 const double C_r =
231 effective_rolling_viscous_damping_coefficient * 2. * sqrt(I_e * K_r);
232
233 // Similarly to the coulomb limit, the spring torque must be decrease to the
234 // limit value if it exceeds the limiting spring toque.
235 if (rolling_resistance_spring_torque_norm > M_r_max)
236 {
237 cumulative_rolling_resistance_spring_torque =
238 cumulative_rolling_resistance_spring_torque *
239 (M_r_max / rolling_resistance_spring_torque_norm);
240
241 // If the limiting spring torque is exceeded, the damping is multiplied by
242 // the f_coefficient which should be between 0 and 1.
243
244 return cumulative_rolling_resistance_spring_torque -
245 f_coefficient * C_r * omega_ij_perpendicular;
246 }
247 // Minus sign has been verified
248 return cumulative_rolling_resistance_spring_torque -
249 C_r * omega_ij_perpendicular;
250}
251#endif
Tensor< 1, 3 > viscous_rolling_resistance_torque(const double effective_r, const ArrayView< const double > &particle_one_properties, const ArrayView< const double > &particle_two_properties, const double effective_rolling_friction_coefficient, const double normal_force_norm, const Tensor< 1, 3 > &normal_unit_vector)
Calculation of the viscous rolling resistance torque model using the information obtained from the fi...
Tensor< 1, 3 > epsd_rolling_resistance_torque(const double effective_r, const ArrayView< const double > &particle_one_properties, const ArrayView< const double > &particle_two_properties, const double effective_rolling_friction_coefficient, const double effective_rolling_viscous_damping_coefficient, const double f_coefficient, const double normal_force_norm, const double dt, const double normal_spring_constant, const Tensor< 1, 3 > &normal_unit_vector, Tensor< 1, 3 > &cumulative_rolling_resistance_spring_torque)
Tensor< 1, 3 > constant_rolling_resistance_torque(const double effective_r, const ArrayView< const double > &particle_one_properties, const ArrayView< const double > &particle_two_properties, const double effective_rolling_friction_coefficient, const double normal_force_norm)
Calculation of the constant rolling resistance torque model using the information obtained from the f...
Tensor< 1, 3 > no_rolling_resistance_torque()
No rolling resistance torque model. No calculation is being done with this model.