You can download the latest version of the repository from the GitHub page and then you can install the package with pip:
pip install dropletevapmodel
You can install the package with:
pip install -e .
The model requires input data organized into three main sections: "fluid_properties," "gas_properties," and "simulation_config" Under "fluid_properties," parameters such as density (rho_d), boiling temperature (boiling_t), specific heat capacity (cp_l), molecular mass (mm_d), surface tension (sigma_d), and various coefficients related to heat capacity and thermal conductivity need to be specified. Similarly, the "gas_properties" section requires information on molecular mass (mm_g), surface tension (sigma_g), gas constant (r), speed (speed_g), and coefficients for heat capacity and thermal conductivity.
The "simulation_config" section encompasses various configurations for the simulation. The simulation of droplet evaporation involves several configuration parameters that define the modeling, environmental conditions, initial states, and output preferences. Below is a description of each parameter within the simulation_config
section:
- Modelling Configuration
-
Timestep (
timestep
): The time increment used in each iteration of the simulation. It represents the duration between consecutive time steps during the model's execution. -
Maximum Iterations (
max_iteration
): The maximum number of iterations the simulation will run. This parameter controls the overall duration of the simulation.
- Environment Configuration
-
Pressure (
pressure
): The pressure within the environment, specified in Pascals (Pa). It influences various thermodynamic properties of the system. -
Atmospheric Pressure (
pressure_atm
): The atmospheric pressure in Pascals (Pa) is the pressure exerted by the Earth's atmosphere at sea level. -
Boltzmann Constant (
kb
): The Boltzmann constant, a fundamental constant of nature, used in thermodynamic calculations. It is specified in joules per kelvin (J/K). -
Droplet Concentration (
drop_conc
): The initial concentration of droplets in the environment, typically given in droplets per unit volume.
- Initial Conditions (
t_zero
)
-
Initial Droplet Diameter (
d_zero
): The initial diameter of the droplet at the start of the simulation, specified in meters (m). -
Initial Droplet Temperature (
t_d_zero
): The initial temperature of the droplet at the beginning of the simulation, specified in Kelvin (K). -
Initial Gas Temperature (
t_g_zero
): The initial temperature of the surrounding gas at the start of the simulation, specified in Kelvin (K). -
Initial Water Content in Gas (
water_content_g_zero
): The initial water content in the gas phase, specified in the form of mass fraction or other suitable units.
- Output Configuration
-
CSV Output (
csv
): A boolean flag indicating whether to enable CSV output. If set totrue
, the simulation results will be exported to a CSV file. -
Plotting Output (
plotting
): A boolean flag indicating whether to enable plotting of simulation results. If set totrue
, the model will generate plots to visualize key variables and trends.
These configuration parameters collectively define the settings and conditions under which the droplet evaporation simulation will be conducted. Adjusting these parameters allows users to tailor the simulation to their specific scenarios and study the behavior of droplet evaporation under different conditions.
This structured data will be used as input to instantiate the "DropletEvapModel" Pydantic model, ensuring that all necessary parameters are defined and adhere to their respective constraints.
This guide explains how to use the EvapModel
class for simulating droplet evaporation based on the DropletEvapModel
Pydantic model. The provided Python code includes a simulation model, constants evaluation, and initialization parameters. Follow the steps below to utilize the EvapModel
class effectively.
import tqdm
import numpy as np
from typing import Dict
from dropletevapmodel import EvapModel, DropletEvapModel
model_config = {
'simulation_config': {
'modelling': {
'timestep': 2e-05, # seconds
'max_iteration': 100000.0 # number of iteration
},
'environment': {
'pressure': 101325, # Pa
'pressure_atm': 101325, # Pa
'kb': 1.380649e-23, # J⋅K−1⋅mol−1
'drop_conc': 1000000000.0 # number/cm3
},
't_zero': {
'd_zero': 2.33315e-05, # Droplet diameter at t0 in m
't_d_zero': 293, # Droplet temperature at t0 in K
't_g_zero': 293, # Gas temperature at t0 in K
'water_content_g_zero': 0 # Water content at t0 in ppm
},
'output': {
'csv': True,
'plotting': True
}
}
}
Liquid and gas properties can be added using the available database or loading custom data. Gas information can be added updating the model config dict.
model_config.update(
{
'gas_propeties':
{
'mm_g': 39.948, # g/mol
'sigma_g': 3.542, # Angstrom
'eps_fact': 93.3, # K
'r': 8.314, # J/(mol*K)
'speed_g': 32.0, # m/s
'viscosity_a': 6.1e-08, # m^2/s
'viscosity_b': 3.33e-06, # K
'cp_a': 20.786, # J/mol
'cp_b': 2.83e-07, # J/(mol*K)
'cp_c': -1.46e-07, # J/(mol*K^2)
'cp_d': 1.09e-08, # J/(mol*K^3)
'cp_e': -3.66e-09, # J/(mol*K^4)
'k_a': -2.91e-05, # W/(m*K)
'k_b': 0.068089, # W/(m*K^2)
'k_c': -0.15 # W/(m*K^3)
}
}
)
In the same way, liquid information can be added
model_config.update(
{
'fluid_properties':
{
'rho_d': 1000000.0, # kg/m^3
'boiling_t': 373.0, # K
'cp_l': 4.186, # J/(g*K)
'mm_d': 18.0, # g/mol
'sigma_d': 2.641, # N/m
'eps_fact': 809.1, # K
'speed_d': 32.0, # m/s
'viscosity_a': 4.7e-08, # m^2/s
'viscosity_b': 3.53e-06, # K
'cp_a': 30.092, # J/mol
'cp_b': 6.832514, # J/(mol*K)
'cp_c': 6.793435, # J/(mol*K^2)
'cp_d': -2.53448, # J/(mol*K^3)
'cp_e': 0.082139, # J/(mol*K^4)
'k_a': 7.75e-05, # W/(m*K)
'k_b': 0.02255, # W/(m*K^2)
'k_c': 4.815 # W/(m*K^3)
}
}
)
model_config = {...} # Your data
model_instance = DropletEvapModel(**model_config)
evap_model = EvapModel(model=model_instance)
evap_model.run()
results = evap_model.run()
final_state = results[max(results.keys())]
Available data for liquid and gas materials are contained in liq.csv and gas.csv databased that can be found is configs folder.
The 0-D model used for the simulation of a single droplet evaporation was developed according to a diffusion model based on mass and energy balance well reported in literature [1] [2], following the classical evaporation model (CEM) proposed by Spalding [3] and Godsave [4]. This model was further improved following Abramzon-Sirignano approach [5] [6], that enabled a better account for advective mass and energy transport. A detailed description of the governing equations and limitations of this model was recently reviewed by Pinheiro et al. [7]. Mass and energy balances can be described according to following equations, respectively:
where
Balance can be rewritten as a function of droplet diameter
According to the CEM model, widely discussed and applied in different fields of research to study droplet evaporation, based on mass and energy balance evaporation flow rate can be described according to the following equation:
where
The Spalding mass transfer number can be calculated using Equation (5):
where
where
Sherwood number (
where
and
The mass and energy transfer between gas and droplets at the interface is usually taken into account using a correction factor
Where Nusselt number (
The correction factor
As detailed in several publications by Abramzon and Sirignano [5] [6], a more realistic approach can be used taking more precisely into account mass and energy transport. In this perspective, modification to the CEM model was carried out using two different correction factors (
Where
where
As mentioned above, the physical properties of the gas, liquid, and gas-vapor mixtures and their temperature dependence were calculated using different approaches reported in the published literature.
In the droplet proximity, gas-vapor properties can be described according to the film theory. A brief schematic representation of the droplet-gas environment and the “film region” is reported in Figure 4.3, where
Vapor diffusion coefficient (
where
The fitting of experimental data on liquid enthalpy of vaporization (
As a consequence of the droplet evaporation, the water vapor content of the environment increases during droplet shrinking. Since the model was developed to study droplet evaporation in a close-not infinite environment (because of the plasma source relatively low volume dimension with respect to droplet diameter), an increase of vapor content affects the driving force of liquid evaporation (mass concentration gradients) and should be considered.
In this perspective, droplet concentration can be obtained using scanning mobility particle sizer (SMPS) data under the hypothesis of one droplet-one particle conversion, as widely discussed in literature [17] [18] [19]. Under the assumption that droplets are equally distributed in the space, each droplet can be considered at the center of a control volume whose dimension is the reciprocal of particle concentration. Following this hypothesis, the hypothetical control volume in which each droplet is contained is much larger than the droplet volume: for a droplet density of
Under the hypothesis, the gas mass for each volume unit (
It's important to note that the model presented here is characterized by certain assumptions and limitations. According to the literature, these factors may marginally affect the obtained results. However, since the model's output will be compared to experimental results, it's essential to highlight the main hypotheses on which the model is based.
Firstly, the gas temperature during evaporation and droplet transport inside the control volume (e.g. reactor) is assumed to be constant. This assumption is valid if the heating up of the gas is fast inside the reactor, and the droplet temperature reaches a constant value within a time period much lower than the evaporation time. This way, possible effects of localized streamers and inhomogeneities in the temperature field are not taken into account. Gas temperature was estimated using different techniques described in the previous paragraphs.
According to literature, the heat transfer resistance inside an evaporating droplet is usually assumed to be negligible. To support this point, we compare the heat transfer resistance inside and outside the evaporating droplet using the Biot number (
where $ L_0 $ is the characteristic length (r/3 for a sphere), $ h $ is the film heat transfer coefficient (W/m²K), and $ k_l $ is the thermal conductivity of the droplet. Even if all terms are temperature-dependent, the value of the Bi number is slightly affected by small thermal gradients. Indeed, at 293 K, the
A comprehensive discussion of a possible application of the model can be found in T. Gallingani 2020 [20]
[1] Lefebvre A H and McDonell V G 2017 Atomization and sprays (CRC press)
[2] Zhifu Z, Guoxiang W, Bin C, Liejin G and Yueshe W 2013 Evaluation of Evaporation Models for Single Moving Droplet with a High Evaporation Rate Powder Technol. 240 95–102
[3] Spalding D B 1953 The combustion of liquid fuels Symposium (International) on Combustion vol 4 pp 847–64
[4] Godsave G 1953 Studies of the combustion of drops in a fuel spray—the burning of single drops of fuel Symposium (International) on Combustion vol 818 pp 818–30
[5] Abramzon B and Sirignano W A 1989 Droplet vaporization model for spray combustion calculations 32 1605–18
[6] Sirignano W A 1999 Fluid Dynamics and Transport of Droplets and Sprays (Cambridge University Press)
[7] Pinheiro A P and Vedovoto J M 2019 Evaluation of Droplet Evaporation Models and the Incorporation of Natural Convection Effects Flow, Turbul. Combust. 102 537–58
[8] Ranz W E, Marshall W R and Myers P 1952 Evaporation from drops Chem. eng. prog 48 141–6
[9] El Wakil M M, Uyehara O A and Myers P S 1954 A theoretical investigation of the heating-up period of injected fuel droplets vaporizing in air
[10] Hubbard G L, Denny V E and Mills A F 1975 Droplet evaporation: effects of transients and variable properties Int. J. Heat Mass Transf. 18 1003–8
[11] Yuen M C and Chen L W 1976 On drag of evaporating liquid droplets (Taylor & Francis)
[12] Cussler E L and Cussler E L 2009 Diffusion: mass transfer in fluid systems (Cambridge university press)
[13] Wilke C R 1972 A Viscosity Equation for Gas Mixtures 517 6–9
[14] Huber M L and Harvey A H 2011 Tables of recommended values for the viscosity and thermal conductivity of common gases as a function of temperature ed CRC-Press
[15] NIST Water - Gas phase thermochemistry data
[16] NIST Argon - Gas phase thermochemistry data
[17] Stabile L, Trassierra C V, Agli G D and Buonanno G 2013 Ultrafine Particle Generation through Atomization Technique : The Influence of the Solution 1667–77
[18] Chen T M and Chein H M 2017 Generation and Evaluation of Mono
[19] Hinds W C 1999 Aerosol technology: properties, behavior, and measurement of airborne particles (John Wiley & Sons)
[20] Gallingani T 2020 (Alma Mater Studiorum)