Lethe Open-Source Library version 1.2.0
Developer Guide
Loading...
Searching...
No Matches
particle_heat_transfer.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) 2025-2026 The Lethe Authors
2// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception OR LGPL-2.1-or-later
3
4#ifndef lethe_particle_heat_transfer_h
5#define lethe_particle_heat_transfer_h
6
8
9#include <dem/contact_type.h>
10
11
12
13/**
14 * @brief Calculate the corrected contact radius for a particle-particle or
15 * particle-wall pair in contact.
16 *
17 * @param[in] effective_radius Effective radius of the pair in contact.
18 * @param[in] effective_youngs_modulus Effective young's modulus of the pair in
19 * contact.
20 * @param[in] effective_real_youngs_modulus Effective real young's modulus of
21 * the pair in contact.
22 * @param[in] normal_force_norm Norm of the normal contact force for the pair in
23 * contact.
24 * @return Corrected contact radius of the pair in contact.
25 */
26double
27calculate_corrected_contact_radius(const double effective_radius,
28 const double effective_youngs_modulus,
29 const double effective_real_youngs_modulus,
30 const double normal_force_norm);
31
32/**
33 * @brief Calculate the macrocontact thermal resistance for a particle-particle or
34 * particle-wall pair in contact.
35 *
36 * @param[in] harmonic_conductivity Harmonic mean of the thermal
37 * conductivities for a particle-particle contact or twice the particle thermal
38 * conductivity for a particle-wall contact.
39 * @param[in] contact_radius Contact radius of the pair in contact.
40 * @return Macrocontact thermal resistance for the pair in contact.
41 */
42double
43calculate_macrocontact_resistance(const double harmonic_conductivity,
44 const double contact_radius);
45
46/**
47 * @brief Calculate the microcontact thermal resistance for a particle-particle or
48 * particle-wall pair in contact.
49 *
50 * @param[in] equivalent_surface_slope Equivalent surface slope of the pair in
51 * contact.
52 * @param[in] equivalent_surface_roughness Equivalent surface roughness of the
53 * pair in contact.
54 * @param[in] effective_microhardness Effective microhardness of the pair in
55 * contact.
56 * @param[in] contact_radius_squared Squared contact radius of the pair in
57 * contact.
58 * @param[in] harmonic_conductivity Harmonic mean of the thermal
59 * conductivities of the pair in contact.
60 * @param[in] maximum_pressure Maximum pressure for hertzian contacts.
61 * @return Microcontact thermal resistance for the pair in contact.
62 */
63double
64calculate_microcontact_resistance(const double equivalent_surface_slope,
65 const double equivalent_surface_roughness,
66 const double effective_microhardness,
67 const double contact_radius_squared,
68 const double harmonic_conductivity,
69 const double maximum_pressure);
70
71/**
72 * @brief Calculate the solid macrogap thermal resistance for one particle.
73 *
74 * @param[in] radius Radius of the particle.
75 * @param[in] thermal_conductivity Thermal conductivity of the particle.
76 * @param[in] contact_radius_squared Squared contact radius of the pair in
77 * contact.
78 * @return Solid macrogap thermal resistance for one particle.
79 */
80double
81calculate_solid_macrogap_resistance(const double radius,
82 const double thermal_conductivity,
83 const double contact_radius_squared);
84
85/**
86 * @brief Calculate the interstitial gas microgap thermal resistance for a
87 * particle-particle or particle-wall pair in contact.
88 *
89 * @param[in] equivalent_surface_roughness Equivalent surface roughness of the
90 * pair in contact.
91 * @param[in] contact_radius_squared Squared contact radius of the pair in
92 * contact.
93 * @param[in] gas_parameter_m Gas parameter.
94 * @param[in] thermal_conductivity_gas Thermal conductivity of the interstitial
95 * gas.
96 * @param[in] maximum_pressure Maximum pressure for hertzian contacts.
97 * @param[in] effective_microhardness Effective microhardness of the pair in
98 * contact.
99 *
100 * @return Interstitial gas microgap thermal resistance for the pair in contact.
101 */
102double
104 const double equivalent_surface_roughness,
105 const double contact_radius_squared,
106 const double gas_parameter_m,
107 const double thermal_conductivity_gas,
108 const double maximum_pressure,
109 const double effective_microhardness);
110
111/**
112 * @brief Calculate the interstitial gas macrogap thermal resistance for a
113 * particle-particle or particle-wall pair in contact.
114 *
115 * @param[in] harmonic_radius Harmonic mean of the particles' radii for a
116 * particle-particle contact, radius of the particle for a particle-wall
117 * contact.
118 * @param[in] thermal_conductivity_gas Thermal conductivity of the interstitial
119 * gas.
120 * @param[in] contact_radius_squared Squared contact radius of the pair in
121 * contact.
122 * @param[in] gas_parameter_m Gas parameter.
123 *
124 * @return Interstitial gas microgap thermal resistance for the pair in contact.
125 */
126double
128 const double harmonic_radius,
129 const double thermal_conductivity_gas,
130 const double contact_radius_squared,
131 const double gas_parameter_m);
132
133/**
134 * @brief Calculate the total thermal conductance for particle-particle
135 * or particle-wall contacts.
136 *
137 * The resistance_macrocontact, resistance_solid_macrogap and
138 * resistance_gas_macrogap differ from particle-particle contacts to
139 * particle-wall contacts.
140 *
141 * @tparam contact_type Type of contact.
142 *
143 * @param[in] radius_one Radius of particle one.
144 * @param[in] radius_two Radius of particle two for particle-particle contacts.
145 * Unused for particle-wall contacts.
146 * @param[in] effective_youngs_modulus Effective young's modulus of the contact
147 * pair.
148 * @param[in] effective_real_youngs_modulus Effective real young's modulus of
149 * the contact pair.
150 * @param[in] equivalent_surface_roughness Equivalent surface roughness of the
151 * contact pair.
152 * @param[in] equivalent_surface_slope Equivalent surface slope of the contact
153 * pair.
154 * @param[in] effective_microhardness Effective microhardness of the contact
155 * pair.
156 * @param[in] thermal_conductivity_one Thermal conductivity of particle one.
157 * @param[in] thermal_conductivity_two Thermal conductivity of particle two or
158 * of wall.
159 * @param[in] thermal_conductivity_gas Thermal conductivity of the interstitial
160 * gas.
161 * @param[in] gas_parameter_m Gas parameter.
162 * @param[in] normal_overlap Normal overlap of the contact pair.
163 * @param[in] normal_force_norm Norm of the normal contact force of the contact
164 * pair.
165 * @param[out] thermal_conductance Total thermal conductance for the contact
166 * pair.
167 */
168template <ContactType contact_type>
169void
171 const double radius_one,
172 [[maybe_unused]] const double radius_two,
173 const double effective_youngs_modulus,
174 const double effective_real_youngs_modulus,
175 const double equivalent_surface_roughness,
176 const double equivalent_surface_slope,
177 const double effective_microhardness,
178 const double thermal_conductivity_one,
179 const double thermal_conductivity_two,
180 const double thermal_conductivity_gas,
181 const double gas_parameter_m,
182 const double normal_overlap,
183 const double normal_force_norm,
184 double &thermal_conductance);
185
186/**
187 * @brief Apply the heat transfer to a local-local particle pair in contact.
188 *
189 * @param[in] temperature_one Temperature of particle one.
190 * @param[in] temperature_two Temperature of particle two.
191 * @param[in] thermal_conductance Total thermal conductance between the two
192 * particles.
193 * @param[in,out] particle_one_heat_transfer_rate Heat transfer rate due to
194 * contact applied to particle one.
195 * @param[in,out] particle_two_heat_transfer_rate Heat transfer rate due to
196 * contact applied to particle two.
197 */
198void
199apply_heat_transfer_on_local_particles(const double temperature_one,
200 const double temperature_two,
201 const double thermal_conductance,
202 double &particle_one_heat_transfer_rate,
203 double &particle_two_heat_transfer_rate);
204
205/**
206 * @brief Apply the heat transfer to a local particle. This function is used for
207 * local-ghost particle pairs or particle-wall pairs in contact.
208 * The heat transfer is only applied to the local particle, thus particle one
209 * should be the local particle here.
210 *
211 * @param[in] temperature_one Temperature of particle one.
212 * @param[in] temperature_two Temperature of particle two or of wall.
213 * @param[in] thermal_conductance Total thermal conductance of the pair.
214 * @param[in,out] particle_one_heat_transfer_rate Heat transfer rate due to
215 * contact applied to particle one.
216 */
217void
219 const double temperature_one,
220 const double temperature_two,
221 const double thermal_conductance,
222 double &particle_one_heat_transfer_rate);
223
224/**
225 * @brief Set the time of the temperature functions of the walls of the grid
226 * with a temperature boundary condition. It does nothing if no wall has a
227 * temperature boundary condition.
228 *
229 * @param[in] boundary_conditions DEM boundary conditions, which hold the
230 * temperature functions of the walls.
231 * @param[in] time Time at which the temperature of the walls is evaluated.
232 */
233void
235 const Parameters::Lagrangian::BCDEM &boundary_conditions,
236 const double time);
237
238#endif
Parameter structures for Lagrangian (DEM) particle simulations.
double calculate_macrocontact_resistance(const double harmonic_conductivity, const double contact_radius)
Calculate the macrocontact thermal resistance for a particle-particle or particle-wall pair in contac...
double calculate_corrected_contact_radius(const double effective_radius, const double effective_youngs_modulus, const double effective_real_youngs_modulus, const double normal_force_norm)
Calculate the corrected contact radius for a particle-particle or particle-wall pair in contact.
double calculate_interstitial_gas_microgap_resistance(const double equivalent_surface_roughness, const double contact_radius_squared, const double gas_parameter_m, const double thermal_conductivity_gas, const double maximum_pressure, const double effective_microhardness)
Calculate the interstitial gas microgap thermal resistance for a particle-particle or particle-wall p...
void apply_heat_transfer_on_local_particles(const double temperature_one, const double temperature_two, const double thermal_conductance, double &particle_one_heat_transfer_rate, double &particle_two_heat_transfer_rate)
Apply the heat transfer to a local-local particle pair in contact.
void set_wall_temperature_time(const Parameters::Lagrangian::BCDEM &boundary_conditions, const double time)
Set the time of the temperature functions of the walls of the grid with a temperature boundary condit...
double calculate_solid_macrogap_resistance(const double radius, const double thermal_conductivity, const double contact_radius_squared)
Calculate the solid macrogap thermal resistance for one particle.
double calculate_microcontact_resistance(const double equivalent_surface_slope, const double equivalent_surface_roughness, const double effective_microhardness, const double contact_radius_squared, const double harmonic_conductivity, const double maximum_pressure)
Calculate the microcontact thermal resistance for a particle-particle or particle-wall pair in contac...
void calculate_contact_thermal_conductance(const double radius_one, const double radius_two, const double effective_youngs_modulus, const double effective_real_youngs_modulus, const double equivalent_surface_roughness, const double equivalent_surface_slope, const double effective_microhardness, const double thermal_conductivity_one, const double thermal_conductivity_two, const double thermal_conductivity_gas, const double gas_parameter_m, const double normal_overlap, const double normal_force_norm, double &thermal_conductance)
Calculate the total thermal conductance for particle-particle or particle-wall contacts.
void apply_heat_transfer_on_single_local_particle(const double temperature_one, const double temperature_two, const double thermal_conductance, double &particle_one_heat_transfer_rate)
Apply the heat transfer to a local particle. This function is used for local-ghost particle pairs or ...
double calculate_interstitial_gas_macrogap_resistance(const double harmonic_radius, const double thermal_conductivity_gas, const double contact_radius_squared, const double gas_parameter_m)
Calculate the interstitial gas macrogap thermal resistance for a particle-particle or particle-wall p...
Boundary conditions for DEM simulations.