Map charged collision rates with a builder
Python · section 1
"""Show how to compose a charged coagulation strategy with the builder API.
The script creates a charged log-distributed particle population, calculatessupporting transport properties, builds the charged strategy viaChargedCoagulationBuilder, and visualizes the resulting kernel on a log-loggrid.
Examples: >>> builder = par.dynamics.ChargedCoagulationBuilder() >>> builder.set_distribution_type("discrete").set_charged_kernel_strategy(kernel_strategy)"""'Show how to compose a charged coagulation strategy with the builder API.\n\nThe script creates a charged log-distributed particle population, calculates\nsupporting transport properties, builds the charged strategy via\nChargedCoagulationBuilder, and visualizes the resulting kernel on a log-log\ngrid.\n\nExamples:\n >>> builder = par.dynamics.ChargedCoagulationBuilder()\n >>> builder.set_distribution_type("discrete").set_charged_kernel_strategy(kernel_strategy)\n'
Map charged collision rates with a builder
Section titled “Map charged collision rates with a builder”Which size pairs can collide readily when their charges differ? This example constructs a two-particle collision-kernel matrix using the Coulomb Gatti 2008 strategy. It helps you connect a prescribed size–charge relation to pairwise rates before attempting a population simulation.
The companion construction uses the same physics through another configuration interface. Neither page evolves an aerosol or specifies how many particles occupy each size; a kernel in m³ s⁻¹ is not an event rate until it is combined with population abundance.
Python · section 2
import matplotlib.pyplot as pltimport numpy as npimport particula as par
plt.rcParams["figure.dpi"] = 110Specify particle sizes without inventing a population
Section titled “Specify particle sizes without inventing a population”The 250 radius nodes span 1 nm–100 µm. Spherical mass uses density 1000 kg m⁻³. This broad grid explores kernel behavior; it is not a measured size distribution or a claim that one material model is applicable over every radius. No bin concentrations are supplied.
Python · section 3
radius_bins = np.logspace(start=-9, stop=-4, num=250) # m (1 nm to 100 μm)mass_bins = 4 / 3 * np.pi * radius_bins**3 * 1e3 # kg (ρ = 1000 kg/m³)n_bins = len(radius_bins)Prescribe a size–charge relation
Section titled “Prescribe a size–charge relation”The smallest third of nodes carries negative charge, varying from −10 to −1 in elementary-charge units. The remaining nodes carry positive charge from +1 to +500. The plotted discontinuity is imposed by this assignment, not predicted by charging dynamics. Fractional values are used as a parameter sweep; individual particle charges would be quantized.
Use this first plot to locate unlike-sign and like-sign regions in the later pair matrix. It does not represent a charge distribution at a given size or an ion-balance calculation.
Python · section 4
split_index = n_bins // 3neg_charges = -np.logspace(np.log10(10), np.log10(1), num=split_index)pos_charges = np.logspace(np.log10(1), np.log10(500), num=n_bins - split_index)charge_array = np.concatenate((neg_charges, pos_charges))
fig, ax = plt.subplots()ax.plot(radius_bins, charge_array, marker="o", linestyle="none")ax.set_xscale("log")ax.set_yscale("symlog", linthresh=1)ax.set_xlabel("Particle radius (m)")ax.set_ylabel("Particle charge (elementary charges)")ax.set_title("Particle Charge vs. Radius")ax.grid(True, which="both", ls="--")plt.show()
Connect electrostatics with transport
Section titled “Connect electrostatics with transport”At 298.15 K, the Coulomb ratio compares electrostatic interaction with thermal energy. Gas viscosity, mean free path, slip correction, and friction connect radius to transport; reduced mass and friction describe a pair. The diffusive Knudsen matrix then places each pair in the kernel’s transport regime.
These calculations use the gas helpers’ defaults where arguments are omitted. A pressure-sensitivity study must explicitly set and propagate the intended gas conditions rather than changing temperature alone.
Python · section 5
temperature = 298.15 # K
coulomb_potential_ratio: np.ndarray = np.asarray( par.particles.get_coulomb_enhancement_ratio( radius_bins, charge_array, temperature=temperature ), dtype=float,)dynamic_viscosity = par.gas.get_dynamic_viscosity(temperature=temperature)mol_free_path = par.gas.get_molecule_mean_free_path( temperature=temperature, dynamic_viscosity=dynamic_viscosity)knudsen_number = par.particles.get_knudsen_number( mean_free_path=mol_free_path, particle_radius=radius_bins)slip_correction = par.particles.get_cunningham_slip_correction( knudsen_number=knudsen_number)friction_factor_value = par.particles.get_friction_factor( particle_radius=radius_bins, dynamic_viscosity=dynamic_viscosity, slip_correction=slip_correction,)diffusive_knudsen_values: np.ndarray = np.asarray( par.particles.get_diffusive_knudsen_number( particle_radius=radius_bins, particle_mass=mass_bins, friction_factor=friction_factor_value, coulomb_potential_ratio=coulomb_potential_ratio, temperature=temperature, ), dtype=float,)
sum_of_radii = radius_bins[:, np.newaxis] + radius_bins[np.newaxis, :]reduced_mass = par.util.get_reduced_self_broadcast(mass_bins.astype(float))reduced_friction_factor = par.util.get_reduced_self_broadcast( np.asarray(friction_factor_value, dtype=float))Compose the strategy explicitly
Section titled “Compose the strategy explicitly”The builder combines the discrete distribution setting and Coulomb Gatti 2008
kernel model. The subsequent calculation calls that selected model directly:
first its dimensionless expression, then its dimensional kernel. Constructing
charged_coagulation does not itself advance a population.
Python · section 6
kernel_strategy = par.dynamics.CoulombGatti2008KernelStrategy()charged_coagulation = ( par.dynamics.ChargedCoagulationBuilder() .set_distribution_type("discrete") .set_charged_kernel_strategy(kernel_strategy) .build())
# The ChargedCoagulationStrategy exposes the charged kernel strategy; call it# directly for the dimensionless and dimensional kernels.dimensionless_kernel: np.ndarray = kernel_strategy.dimensionless( diffusive_knudsen=diffusive_knudsen_values, coulomb_potential_ratio=coulomb_potential_ratio,)dimensional_kernel: np.ndarray = kernel_strategy.kernel( dimensionless_kernel=dimensionless_kernel, coulomb_potential_ratio=coulomb_potential_ratio, sum_of_radii=sum_of_radii, reduced_mass=reduced_mass, reduced_friction_factor=reduced_friction_factor,)particula/dynamics/coagulation/charged_dimensionless_kernel.py:203: RuntimeWarning: divide by zero encountered in divide
factored_term = (pi_sqrt * continuum * coulomb_potential_ratio * 1.22) / (
particula/dynamics/coagulation/charged_dimensionless_kernel.py:208: RuntimeWarning: invalid value encountered in multiply
term1 = continuum_limit * (1 - (1 + factored_term) * exponential_decay)
particula/dynamics/coagulation/charged_dimensionless_kernel.py:214: RuntimeWarning: divide by zero encountered in divide
+ (
particula/dynamics/coagulation/charged_dimensionless_kernel.py:210: RuntimeWarning: invalid value encountered in multiply
np.sqrt(8 * np.pi)
Read the pair matrix and its numerical boundaries
Section titled “Read the pair matrix and its numerical boundaries”Each location refers to a pair of radii, with charges obtained from the first plot. The color is the base-10 logarithm of the kernel’s numerical value in m³ s⁻¹. Like-sign repulsion and unlike-sign attraction influence the structure, but transport and size also vary, so this matrix alone does not isolate the charge effect from those other dependencies.
The saved run emits divide-by-zero and invalid-operation warnings in intermediate expressions over this broad range. The final assertions require finite, nonnegative, symmetric kernel values. Exact zeros are masked on the logarithmic plot; blank regions must not be interpreted as a measured positive rate. Passing final-array checks does not validate an extreme parameter regime.
Python · section 7
assert np.all(np.isfinite(dimensional_kernel))assert np.all(dimensional_kernel >= 0)np.testing.assert_allclose( dimensional_kernel, dimensional_kernel.T, rtol=1e-12, atol=0)log_kernel = np.ma.log10(np.ma.masked_less_equal(dimensional_kernel, 0))fig, ax = plt.subplots()mesh = ax.pcolormesh(radius_bins, radius_bins, log_kernel, shading="auto")ax.set_xscale("log")ax.set_yscale("log")ax.set_xlabel("Particle radius r_i (m)")ax.set_ylabel("Particle radius r_j (m)")ax.set_title("Coulomb Gatti 2008 Coagulation Kernel (Builder)")fig.colorbar(mesh, ax=ax, label="log10(Kernel) (m³/s)")plt.show()
Turn the map into a charging experiment
Section titled “Turn the map into a charging experiment”The matrix identifies which prescribed pairs have larger or smaller modeled collision coefficients. It cannot predict a population lifetime without number concentrations, nor establish how the imposed charges arise.
To isolate a charging effect, repeat the kernel calculation at the same radii and gas conditions for neutral, same-sign, and opposite-sign assignments. Compare ratios only where the reference is finite and nonzero, inspect limiting behavior, and document the model’s applicable regime. Then use an independently specified size/charge population to compute collision rates. The Brownian time-evolution example provides a neutral population baseline; coupling charging dynamics would require additional physics and validation.
Explore this topic: Charged particles and ions