Index

API Documentation

Aerosol.ATM_TO_PA — Constant

Standard atmosphere in Pa, used for converting Henry's law constants from M/atm to M/Pa.

source
Aerosol.DAHNEKE_TABLE3 — Constant

Eigenvalues ωi² and coefficients Bi from Table 3 of Dahneke (1983) for γ = 0 (free-molecule / plug flow) with δ = 1. Keys are KnD values; values are vectors of (ωi², B_i) tuples for i = 1..6.

source
Aerosol.DAHNEKE_TABLE4 — Constant

Eigenvalues ωi² and coefficients Bi from Table 4 of Dahneke (1983) for γ = 0.5 (transition / slip flow) with δ = 1. Keys are KnD values; values are vectors of (ωi², B_i) tuples for i = 1..6.

source
Aerosol.DAHNEKE_TABLE5 — Constant

Eigenvalues ωi² and coefficients Bi from Table 5 of Dahneke (1983) for γ = 1.0 (continuum / Poiseuille flow) with δ = 1. Keys are KnD values; values are vectors of (ωi², B_i) tuples for i = 1..6.

source
Aerosol.R_GAS_PA — Constant

Gas constant in Pa L mol^-1 K^-1 for Henry's law calculations. R = 8.314 J/(mol·K) = 8.314 Pa·m³/(mol·K) = 8314.0 Pa·L/(mol·K) / 1000 Actually R in L·atm/(mol·K) = 0.08205; in L·Pa/(mol·K) = 0.08205 * 101325 = 8314.46

source
Aerosol.AbsorptivePartitioning — Method
AbsorptivePartitioning(; name=:AbsorptivePartitioning)

Gas-particle partitioning model for SOA formation by absorption into a preexisting organic aerosol phase, assuming an ideal solution. There is no threshold for SOA formation; secondary aerosol forms as soon as the ROG starts reacting.

From Seinfeld and Pandis (2006), Chapter 14, Section 14.5.2, Equations 14.19-14.26.

Uses the dilute approximation c_{aer,i} << m_0 (Eq. 14.23), valid when no single compound dominates the organic aerosol composition.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 14. John Wiley & Sons, Inc.

source
Aerosol.AerodynamicDiameter — Method
AerodynamicDiameter(; name=:AerodynamicDiameter)

Component for calculating equivalent particle diameters.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9, Eqs. 9.102, 9.106, 9.108, 9.110, 9.114.

The volume equivalent diameter is the diameter of a sphere with the same volume:

\[D_{ve} = \left(\frac{6 V_p}{\pi}\right)^{1/3}\]

The aerodynamic diameter is defined for a sphere of unit density (1000 kg/m³) with the same settling velocity:

\[D_{ca} = D_p \sqrt{\frac{\rho_p}{\rho_p^\circ}} \sqrt{\frac{C_c(D_p)}{C_c(D_{ca})}}\]

In the continuum regime (large particles), this simplifies to:

\[D_{ca} \approx D_p \sqrt{\frac{\rho_p}{\rho_p^\circ}}\]

The electrical mobility equivalent diameter relates to mobility measurement:

\[D_{em} = D_{ve} \chi \frac{C_c(D_{em})}{C_c(D_{ve})}\]

source
Aerosol.AerosolDistribution — Function
AerosolDistribution(n_modes=3; name=:AerosolDistribution)

Multi-modal lognormal aerosol size distribution following the parameterization of Seinfeld and Pandis (2006), Chapter 8, "Properties of the Atmospheric Aerosol", in Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, John Wiley & Sons.

The model represents the aerosol number, surface area, and volume distributions as a sum of n_modes lognormal modes (Eq. 8.54). Each mode i is characterized by three parameters:

  • N[i]: total number concentration of mode i
  • D_g[i]: geometric median diameter of mode i
  • logσ[i]: log10 of the geometric standard deviation of mode i

The implementation also includes the vertical mass profile (Eq. 8.55).

Default parameter values correspond to the "Urban" distribution from Table 8.3.

source
Aerosol.AerosolDynamics — Method
AerosolDynamics(; name=:AerosolDynamics)

A combined system for modeling aerosol population dynamics including condensation growth and coagulation processes.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 13.

This system provides:

  • Condensation growth rate calculation
  • Brownian coagulation coefficient (Fuchs form)
  • Monodisperse coagulation dynamics

The General Dynamic Equation (Eq. 13.86) combines these processes:

$\frac{\partial n(v,t)}{\partial t} = \left(\frac{\partial n}{\partial t}\right)_{coag} + \left(\frac{\partial n}{\partial t}\right)_{cond} + J_0\delta(v-v_0) + S(v) - R(v)$

source
Aerosol.AerosolExtinction — Method
AerosolExtinction(; name=:AerosolExtinction)

Extinction coefficient calculation for an aerosol population.

Computes the extinction, scattering, and absorption coefficients (bext, bscat, b_abs) for an ensemble of particles. For a monodisperse population, these are related to the single-particle cross sections by multiplication with the number concentration.

Reference

Seinfeld & Pandis (2006), Chapter 15, Equations 15.24-15.30, 15.37-15.40.

source
Aerosol.AerosolLayerRadiativeForcing — Method
AerosolLayerRadiativeForcing(; name=:AerosolLayerRadiativeForcing)

Aerosol layer radiative forcing model from Seinfeld & Pandis (2006) Chapter 24.

This component calculates the change in outgoing radiative flux due to an aerosol layer using the scattering-absorbing model from Section 24.1. It computes the reflection and transmission coefficients, the total reflectance of the aerosol-surface system, and the change in planetary albedo.

Reference: Seinfeld, J. H., and Pandis, S. N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 24, Equations 24.1-24.10.

Parameters

  • F_0: Incident solar flux (W m⁻²)
  • τ: Aerosol optical depth (dimensionless)
  • ω: Single-scattering albedo (dimensionless)
  • β: Upscatter fraction (dimensionless)
  • R_s: Surface albedo (dimensionless)
  • A_c: Cloud fraction (dimensionless)
  • T_a: Atmospheric transmittance (dimensionless)

Variables (computed)

  • r_aer: Fraction of light reflected upward by aerosol (dimensionless)
  • t_aer: Fraction of light transmitted through aerosol (dimensionless)
  • R_as: Total reflectance of aerosol-surface system (dimensionless)
  • ΔR_p: Change in planetary albedo (dimensionless)
  • ΔF: Change in outgoing radiative flux (W m⁻²)
source
Aerosol.AerosolScavenging — Method
AerosolScavenging(; name=:AerosolScavenging)

Aerosol scavenging by cloud droplets, including mass and number scavenging ratios and scavenging coefficients.

Based on Equations 17.84-17.92 from Seinfeld & Pandis (2006).

Key Equations

  • Eq. 17.84: Fi = (C{i,0} - C{i,int})/C{i,0} (mass scavenging ratio)
  • Eq. 17.85: FN = (N0 - Nint)/N0 (number scavenging ratio)
  • Eq. 17.91: Λ(Dp,t) = ∫K(Dp,x)n_d(x,t)dx (scavenging coefficient)
  • Eq. 17.92: Λ(Dp) = Nd K(D_p, 10µm) (monodisperse approximation)
source
Aerosol.AqueousDiffusionReaction — Method
AqueousDiffusionReaction(; name=:AqueousDiffusionReaction)

Calculate the correction factor Q for aqueous-phase reaction rate when diffusion within the droplet limits the reaction.

The factor Q accounts for concentration gradients within the droplet due to fast reactions near the surface depleting reactants.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.110

source
Aerosol.AqueousDiffusionTimescale — Method
AqueousDiffusionTimescale(; name=:AqueousDiffusionTimescale)

Characteristic timescale for aqueous-phase diffusion within a droplet.

This is the time for a dissolved species to diffuse throughout the droplet interior.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.75

source
Aerosol.AqueousEquilibrationTimescale — Method
AqueousEquilibrationTimescale(; name=:AqueousEquilibrationTimescale)

Characteristic timescale for a gas to equilibrate with aqueous aerosol particles.

This accounts for the additional buffering effect of Henry's law dissolution.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.147

source
Aerosol.AqueousEquilibria — Method
AqueousEquilibria(; name=:AqEquilibria)

Combined aqueous equilibria system for atmospheric cloud droplet chemistry.

This component combines all individual equilibrium systems into a single comprehensive system that can be used for cloud chemistry calculations.

Subsystems:

  • water_eq: Water autoionization
  • co2_eq: CO2/bicarbonate/carbonate equilibria
  • so2_eq: SO2/bisulfite/sulfite (S(IV)) equilibria
  • nh3_eq: NH3/ammonium equilibria
  • hno3_eq: HNO3/nitrate equilibria
  • h2o2_eq: H2O2 equilibria
  • o3_eq: O3 dissolution
source
Aerosol.BETAdsorption — Method
BETAdsorption(; name=:BETAdsorption)

BET (Brunauer-Emmett-Teller) adsorption isotherm for multilayer adsorption. Extends the Langmuir model to include formation of additional molecular layers, assuming each adsorbed molecule can serve as an adsorption site for the next layer.

From Seinfeld and Pandis (2006), Chapter 14, Section 14.5.3, Equation 14.45.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 14. John Wiley & Sons, Inc.

source
Aerosol.BrownianCoagulationCoefficient — Method
BrownianCoagulationCoefficient(; name=:BrownianCoagulationCoefficient)

Compute the Brownian coagulation coefficient using the Fuchs form, which is valid across the continuum, transition, and free-molecular regimes.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 13, Table 13.1.

The Fuchs form of the coagulation coefficient is:

$K_{12} = 2\pi(D_1 + D_2)(D_{p1} + D_{p2}) \left( \frac{D_{p1} + D_{p2}}{D_{p1} + D_{p2} + 2\sqrt{g_1^2 + g_2^2}} + \frac{8(D_1 + D_2)}{\sqrt{\bar{c}_1^2 + \bar{c}_2^2}(D_{p1} + D_{p2})} \right)^{-1}$

where:

  • $D_i = \frac{k T C_c}{3\pi\mu D_{pi}}$ is the Brownian diffusion coefficient
  • $\bar{c}_i = \sqrt{\frac{8 k T}{\pi m_i}}$ is the mean thermal velocity
  • $\ell_i = \frac{8 D_i}{\pi \bar{c}_i}$ is the particle mean free path
  • $g_i = \frac{1}{3 D_{pi} \ell_i}\left[(D_{pi} + \ell_i)^3 - (D_{pi}^2 + \ell_i^2)^{3/2}\right] - D_{pi}$
source
Aerosol.BrownianDiffusion — Method
BrownianDiffusion(; name=:BrownianDiffusion)

Component for calculating Brownian diffusion properties of aerosol particles.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9, Eqs. 9.73, 9.78, 9.87, 9.89.

The Stokes-Einstein-Sutherland relation gives the diffusion coefficient:

\[D = \frac{k T C_c}{3 \pi \mu D_p}\]

The particle mobility is:

\[B = \frac{C_c}{3 \pi \mu D_p}\]

The mean thermal speed of the particle is:

\[\bar{c}_p = \sqrt{\frac{8 k T}{\pi m_p}}\]

The particle mean free path is derived from D = ½ c̄p λp (Eq. 9.88):

\[\lambda_p = \frac{2D}{\bar{c}_p}\]

source
Aerosol.CO2Equilibria — Method
CO2Equilibria(; name=:CO2Eq)

CO2 dissolution and dissociation equilibria with temperature dependence.

Implements:

  • Eq 7.14-7.16: CO2(g) <-> CO2.H2O <-> H+ + HCO3- <-> H+ + CO3^2-
  • Eq 7.17: HCO2 = [CO2.H2O] / pCO2
  • Eq 7.18: K_c1 = [H+][HCO3-] / [CO2.H2O]
  • Eq 7.19: K_c2 = [H+][CO3^2-] / [HCO3-]
  • Eq 7.20-7.22: Species concentrations
  • Eq 7.24: HCO2 = HCO2 * (1 + Kc1/[H+] + Kc1K_c2/[H+]^2)

Variables:

  • T: Temperature (K)
  • H_plus: Hydrogen ion concentration (mol/m³)
  • p_CO2: Partial pressure of CO2 (Pa)
  • CO2_aq: [CO2.H2O] concentration (mol/m³)
  • HCO3_minus: Bicarbonate concentration (mol/m³)
  • CO3_2minus: Carbonate concentration (mol/m³)
  • C_total: Total dissolved inorganic carbon (mol/m³)
  • HCO2eff: Effective Henry's law constant (mol/m³/Pa)
source
Aerosol.ClassicalNucleationRate — Method
ClassicalNucleationRate(; name=:ClassicalNucleationRate)

A simplified component that computes only the classical nucleation rate (Eq. 11.47) from Seinfeld & Pandis (2006). This is a minimal component for use when critical cluster properties are not needed.

Variables

  • J: Nucleation rate (molecules/(m³·s))

Parameters

  • T: Temperature (K)
  • S: Saturation ratio
  • N_1: Monomer number concentration (molecules/m³)
  • σ: Surface tension (N/m)
  • v_1: Molecular volume (m³/molecule)
  • m_1: Molecular mass (kg/molecule)
source
Aerosol.CloudAlbedo — Method
CloudAlbedo(; name=:CloudAlbedo)

Component to calculate cloud albedo from optical depth using the two-stream approximation.

From Seinfeld & Pandis (2006) Chapter 24, Section 24.8.1: Rc = τc / (τ_c + γ) (Eq. 24.38, simplified form for g = 0.85)

where γ = 7.7 for an asymmetry factor g = 0.85 (typical for cloud droplets).

The general two-stream approximation (Eq. 24.37) is: Rc = √3(1-g)τc / (2 + √3(1-g)τ_c)

Reference: Seinfeld, J. H., and Pandis, S. N. (2006). Atmospheric Chemistry and Physics, Chapter 24, Section 24.8.1, Equations 24.37-24.38.

Parameters

  • τ_c: Cloud optical depth (dimensionless)
  • g: Asymmetry factor (dimensionless, default 0.85)

Variables (computed)

  • R_c: Cloud albedo (dimensionless)
  • γ: Denominator coefficient for two-stream approximation (dimensionless)
source
Aerosol.CloudAlbedoSensitivity — Method
CloudAlbedoSensitivity(; name=:CloudAlbedoSensitivity)

Component to calculate the sensitivity of cloud albedo to cloud droplet number concentration (Twomey susceptibility).

From Seinfeld & Pandis (2006) Chapter 24, Section 24.8.2: dRc/dN = Rc(1-Rc)/(3N) (Eq. 24.40) dRc/d(ln N) = R_c(1-R_c)/3 (Eq. 24.41, Twomey susceptibility)

The maximum susceptibility occurs at R_c = 0.5.

Reference: Seinfeld, J. H., and Pandis, S. N. (2006). Atmospheric Chemistry and Physics, Chapter 24, Section 24.8.2, Equations 24.39-24.42.

Parameters

  • R_c: Cloud albedo (dimensionless)
  • N: Cloud droplet number concentration (m⁻³)

Variables (computed)

  • dRc_dN: Sensitivity of cloud albedo to CDNC (m³)
  • S: Twomey susceptibility dR_c/d(ln N) (dimensionless)
source
Aerosol.CloudChemistry — Method
CloudChemistry(; name=:CloudChem)

Comprehensive cloud droplet chemistry system combining all equilibria and S(IV) oxidation kinetics.

This is the main component for modeling atmospheric aqueous-phase chemistry. It combines:

  1. Water autoionization equilibrium
  2. CO2/bicarbonate/carbonate equilibria
  3. SO2/bisulfite/sulfite (S(IV)) equilibria
  4. NH3/ammonium equilibria
  5. HNO3/nitrate equilibria
  6. H2O2 equilibria
  7. O3 dissolution
  8. S(IV) oxidation kinetics (O3, H2O2, Fe, Mn pathways)

The pH is determined from the electroneutrality condition (Eq 7.114): [H+] + [NH4+] = [OH-] + [HCO3-] + 2[CO3^2-] + [HSO3-] + 2[SO3^2-] + [NO3-] + [Cl-] + 2[SO4^2-]

Parameters:

  • L: Liquid water content (g/m³)
  • xi_SO2: SO2 mixing ratio for lifetime calculations (dimensionless)

Input Variables (partial pressures and metal concentrations):

  • T: Temperature (K)
  • p_CO2: CO2 partial pressure (Pa)
  • p_SO2: SO2 partial pressure (Pa)
  • p_NH3: NH3 partial pressure (Pa)
  • p_HNO3: HNO3 partial pressure (Pa)
  • p_H2O2: H2O2 partial pressure (Pa)
  • p_O3: O3 partial pressure (Pa)
  • Fe_III: Fe(III) concentration in droplet (mol/m³)
  • Mn_II: Mn(II) concentration in droplet (mol/m³)
  • Cl_minus: Chloride concentration (mol/m³)
  • SO4_2minus: Sulfate concentration (mol/m³)

Output Variables:

  • pH: Droplet pH (dimensionless)
  • H_plus: H+ concentration (mol/m³)
  • All aqueous species concentrations
  • S(IV) oxidation rates # Create subsystems for equilibria
  • Sulfate production rate
source
Aerosol.CloudChemistryFixedpH — Method
CloudChemistryFixedpH(; name=:CloudChemFixedpH)

Simplified cloud chemistry system with pH as an input parameter.

This variant takes pH as an input rather than calculating it from electroneutrality. This is useful for:

  • Sensitivity studies varying pH
  • Cases where additional ions (not modeled) affect pH
  • Quick calculations without solving the full equilibrium

Parameters:

  • L: Liquid water content (g m^-3)
  • xi_SO2: SO2 mixing ratio for lifetime calculations (dimensionless)

Input Variables:

  • T: Temperature (K)
  • pH_input: Input pH value (dimensionless)
  • All partial pressures and metal concentrations # Create subsystems for equilibria
source
Aerosol.CloudChemistryODE — Method
CloudChemistryODE(; name=:CloudChemODE)

Dynamic cloud chemistry system with time evolution of sulfate.

This system tracks the time evolution of sulfate concentration as S(IV) is oxidized to S(VI). It can be integrated using OrdinaryDiffEq.

The system includes:

  • All equilibria (assumed fast, instantaneous)
  • S(IV) oxidation kinetics (rate-limiting)
  • Sulfate accumulation

State Variable:

  • SO4_2minus: Sulfate concentration (mol/m³), evolves with time

Parameters and other variables same as CloudChemistryFixedpH.

source
Aerosol.CloudDynamics — Method
CloudDynamics(; name=:CloudDynamics)

Adiabatic cooling, cloud formation, and supersaturation dynamics. Includes dry adiabatic lapse rate, lifting condensation level (LCL), dew point temperature, and saturation mixing ratio.

Based on Equations 17.43-17.49 from Seinfeld & Pandis (2006).

Key Equations

  • Eq. 17.43: Td ≈ T0 + (RT0²/ΔHv M_w)ln(RH) (dew point temperature)
  • Eq. 17.44: Γd = g/cp ≈ 9.76 K/km (dry adiabatic lapse rate)
  • Eq. 17.46: wv = Mw pw / (Ma p_a) (water vapor mixing ratio)
  • Eq. 17.49: hLCL = (T0 - T_L)/Γ (lifting condensation level)
source
Aerosol.CloudKelvinEffect — Method
CloudKelvinEffect(; name=:CloudKelvinEffect)

Kelvin (curvature) effect on vapor pressure over curved cloud droplet surfaces. The vapor pressure over a curved surface is enhanced relative to a flat surface due to surface energy effects.

Based on Equations 17.9 and 17.28 from Seinfeld & Pandis (2006) Chapter 17.

Equations

  • Eq. 17.9: pw(Dp)/p° = exp(4Mw σw / (R T ρw Dp))
  • Eq. 17.28: A = 4Mw σw / (R T ρ_w) ≈ 0.66/T µm (for T in K)
source
Aerosol.CloudOpticalDepth — Method
CloudOpticalDepth(; name=:CloudOpticalDepth)

Component to calculate cloud optical depth from liquid water content and droplet number concentration.

From Seinfeld & Pandis (2006) Chapter 24, Section 24.8.1: τc = h * (9πL²N / 2ρw²)^(1/3) (Eq. 24.36)

This relates cloud optical depth to cloud thickness (h), liquid water content (L), and cloud droplet number concentration (N).

Reference: Seinfeld, J. H., and Pandis, S. N. (2006). Atmospheric Chemistry and Physics, Chapter 24, Section 24.8.1, Equations 24.34-24.36.

Parameters

  • h: Cloud thickness (m)
  • L: Liquid water content (kg m⁻³)
  • N: Cloud droplet number concentration (m⁻³)

Constants

  • ρ_w: Density of water (kg m⁻³)

Variables (computed)

  • τ_c: Cloud optical depth (dimensionless)
source
Aerosol.CloudPhysics — Method
CloudPhysics(; name=:CloudPhysics)

Complete cloud physics system composing all subsystems: water properties, Kelvin effect, Köhler theory, droplet growth, cloud dynamics, ice physics, rain formation, and aerosol scavenging.

Based on Chapter 17 of Seinfeld & Pandis (2006) "Atmospheric Chemistry and Physics: From Air Pollution to Climate Change", 2nd Edition, John Wiley & Sons.

source
Aerosol.CloudWaterProperties — Method
CloudWaterProperties(; name=:CloudWaterProperties)

Thermodynamic properties of water and water solutions for cloud physics calculations, including specific heat, latent heats, surface tension, and saturation vapor pressure.

Based on Chapter 17 of Seinfeld & Pandis (2006) "Atmospheric Chemistry and Physics: From Air Pollution to Climate Change", 2nd Edition, John Wiley & Sons.

Equations 17.1-17.6, Table 17.2.

source
Aerosol.CriticalCluster — Method
CriticalCluster(; name=:CriticalCluster)

A standalone component for computing critical cluster properties without the full nucleation rate calculation. Useful for parameter sensitivity studies.

This implements equations 11.35, 11.52, and 11.53 from Seinfeld & Pandis (2006).

Variables

  • i_star: Critical cluster size (molecules)
  • r_star: Critical cluster radius (m)
  • ΔG_star: Free energy barrier (J)
  • θ: Dimensionless surface tension parameter

Parameters

  • T: Temperature (K)
  • S: Saturation ratio
  • σ: Surface tension (N/m)
  • v_1: Molecular volume (m³/molecule)
source
Aerosol.CriticalSingleScatteringAlbedo — Method
CriticalSingleScatteringAlbedo(; name=:CriticalSingleScatteringAlbedo)

Component to calculate the critical single-scattering albedo (ω_crit) at which an aerosol layer transitions from cooling to heating the climate system.

From Seinfeld & Pandis (2006) Chapter 24, Equation 24.15: ωcrit = 2*Rs / (2R_s + β(1-R_s)²)

When ω > ωcrit, the aerosol causes net cooling (increased reflection). When ω < ωcrit, the aerosol causes net heating (absorption dominates).

Reference: Seinfeld, J. H., and Pandis, S. N. (2006). Atmospheric Chemistry and Physics, Chapter 24, Section 24.2.

Parameters

  • R_s: Surface albedo (dimensionless)
  • β: Upscatter fraction (dimensionless)

Variables (computed)

  • ω_crit: Critical single-scattering albedo (dimensionless)
source
Aerosol.Dahneke — Method
Dahneke(; name=:Dahneke)

Dahneke transition regime correction for mass transfer.

An alternative interpolation formula for the transition regime.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.42

source
Aerosol.DahnekeCapillaryPenetration — Method
DahnekeCapillaryPenetration(; name=:DahnekeCapillaryPenetration)

Compute parameters for aerosol penetration through a fine capillary tube.

Reference: Dahneke, B. (1983). Simple Kinetic Theory of Brownian Diffusion in Vapors and Aerosols. In Theory of Dispersed Multiphase Flow (pp. 97–133). Academic Press. Section 9, Eqs. 9.1–9.9.

The steady convective diffusion equation in a circular tube is solved by separation of variables, yielding the penetration function:

$ϕ(z) = \sum_i B_i \exp(-ω_i^2 z)$

where z = DL/(σv̄R²) is the dimensionless tube length, ωi² are eigenvalues, and Bi are coefficients that depend on the velocity profile parameter γ and the diffusion Knudsen number Kn_D.

The velocity profile is v(r) = σv̄[1 - γ(r/R)²] where:

  • γ = 0: free-molecule flow (plug flow)
  • γ = 0.5: transition flow
  • γ = 1.0: continuum flow (Poiseuille flow)
  • σ = 2/(2-γ) from the flow rate constraint (Eqs. 9.4–9.5)

The eigenvalues ωi² and coefficients Bi are tabulated in Tables 3 (γ=0), 4 (γ=0.5), and 5 (γ=1.0) of the paper for δ=1 and various KnD values. Use [`dahnekecapillary_penetration`](@ref) to compute the penetration fraction from these tables.

source
Aerosol.DahnekeCoagulationRate — Method
DahnekeCoagulationRate(; name=:DahnekeCoagulationRate)

Compute the Brownian coagulation rate constant K using the Dahneke kinetic theory, valid across all Knudsen numbers from the continuum to the free-molecular regime.

Reference: Dahneke, B. (1983). Simple Kinetic Theory of Brownian Diffusion in Vapors and Aerosols. In Theory of Dispersed Multiphase Flow (pp. 97–133). Academic Press. Eqs. 8.8, 8.13–8.15.

The coagulation rate constant is:

$K = 4π R D \frac{Kn_D + 1}{1 + \frac{2 Kn_D (Kn_D + 1)}{δ}}$

where R = r₁ + r₂ is the collision radius, D = D₁ + D₂ is the mutual diffusion coefficient, and Kn_D = 2kT/(c̄fR) is the diffusion Knudsen number based on the mutual friction coefficient f = f₁f₂/(f₁+f₂) and mean thermal speed c̄ = √(c̄₁² + c̄₂²).

The correction factor β = K/Ko (where Ko = 4πRD is the continuum value) can be decomposed as β = β₁β₂ where:

  • β₁ = C{s1}C{s2}(r₁/C{s1} + r₂/C{s2})/(r₁+r₂) corrects for non-negligible Kn
  • β₂ = (KnD+1)/[1+2KnD(KnD+1)/δ] corrects for non-negligible KnD
source
Aerosol.DahnekeCondensationEvaporation — Method
DahnekeCondensationEvaporation(; name=:DahnekeCondensationEvaporation)

Model stationary condensation or evaporation of a droplet including coupled mass and heat transfer with transition-regime corrections.

Reference: Dahneke, B. (1983). Simple Kinetic Theory of Brownian Diffusion in Vapors and Aerosols. In Theory of Dispersed Multiphase Flow (pp. 97–133). Academic Press. Eqs. 2.1–2.3, 5.4–5.8.

The corrected molecular transport rate is:

$I = 4π r D_v β (n_∞ - n_s)$

The corrected heat conduction rate is:

$Q = 4π r κ β_q (T_∞ - T_o)$

These are related through the conservation equation:

$β I_M = β_q Q_M / L$

source
Aerosol.DahnekeHeatTransportCorrection — Method
DahnekeHeatTransportCorrection(; name=:DahnekeHeatTransportCorrection)

Compute the correction factor β_q for heat conduction to a sphere, valid across all Knudsen numbers. Exactly parallel to the mass transport correction.

Reference: Dahneke, B. (1983). Simple Kinetic Theory of Brownian Diffusion in Vapors and Aerosols. In Theory of Dispersed Multiphase Flow (pp. 97–133). Academic Press. Eqs. 5.6–5.7.

$β_q = \frac{Kn_K + 1}{\frac{2 Kn_K (Kn_K + 1)}{α} + 1}$

where KnK = 2κ/(c̄' n' cv r) is the heat transfer Knudsen number and α is the thermal accommodation coefficient.

source
Aerosol.DahnekeMassTransportCorrection — Method
DahnekeMassTransportCorrection(; name=:DahnekeMassTransportCorrection)

Compute the correction factor β for diffusional mass transport to a sphere, valid across all Knudsen numbers from the continuum to the free-molecular regime.

Reference: Dahneke, B. (1983). Simple Kinetic Theory of Brownian Diffusion in Vapors and Aerosols. In Theory of Dispersed Multiphase Flow (pp. 97–133). Academic Press. Eq. 5.5.

The correction factor relates the actual transport rate I to the continuum (Maxwell) result I_M:

$I = β I_M$

where

$β = \frac{Kn_D + 1}{\frac{2 Kn_D (Kn_D + 1)}{δ} + 1}$

Here KnD = ℓD / r is the diffusion Knudsen number, ℓ_D = 2D/c̄ is the diffusional mean-free-path, and δ is the condensation-evaporation (sticking) coefficient.

Limiting cases:

  • Kn_D → 0: β → 1 (continuum limit, Maxwell's result)
  • Kn_D → ∞: β → δc̄r/(4D) (free-molecular limit)
source
Aerosol.DesertAerosol — Method
DesertAerosol(; name=:DesertAerosol)

Desert aerosol size distribution from Table 8.3 of Seinfeld and Pandis (2006).

Three lognormal modes with parameters:

  • Mode 1: (N=726 cm⁻³, Dg=0.002 μm, log σ=0.247)
  • Mode 2: (N=114 cm⁻³, Dg=0.038 μm, log σ=0.770)
  • Mode 3: (N=0.178 cm⁻³, Dg=21.60 μm, log σ=0.438)
source
Aerosol.DiameterGrowthRate — Method
DiameterGrowthRate(; name=:DiameterGrowthRate)

Compute the diameter growth rate due to condensation in the continuum regime.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 13, Eq. 13.11-13.13.

The diameter growth rate is given by:

$I_D = \frac{dD_p}{dt} = \frac{4 D_i M_i}{R T D_p \rho_p} (p_i - p_{eq,i})$

In the continuum regime with constant supersaturation (A = constant), this simplifies to:

$I_D = \frac{A}{D_p}$

where $A = \frac{4 D_i M_i}{R T \rho_p} (p_i - p_{eq,i})$.

source
Aerosol.DiscreteCoagulation — Method
DiscreteCoagulation(n_bins::Int; name=:DiscreteCoagulation)

Model the discrete coagulation equation for a monodisperse initial distribution with constant coagulation coefficient.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 13, Eq. 13.59, 13.71.

The discrete coagulation equation for k-mers is:

$\frac{dN_k}{dt} = \frac{1}{2} \sum_{j=1}^{k-1} K_{j,k-j} N_j N_{k-j} - N_k \sum_{j=1}^{\infty} K_{kj} N_j$

For a constant coagulation coefficient K and monodisperse initial condition (all particles initially monomers), the analytical solution is:

$N_k(t) = \frac{N_0 (t/\tau_c)^{k-1}}{[1 + t/\tau_c]^{k+1}}$

Arguments:

  • n_bins::Int: Number of size bins (k-mer sizes to track)
source
Aerosol.DropletGrowth — Method
DropletGrowth(; name=:DropletGrowth)

Diffusional growth rate of cloud droplets by condensation of water vapor. Accounts for the thermal gradient between droplet surface and environment, gas-phase diffusion, and modified diffusivity for kinetic effects.

Based on Equations 17.60-17.72 from Seinfeld & Pandis (2006).

Key Equations

  • Eq. 17.61: Dv = 0.211(pref/p)(T/273)^1.94 cm²/s (water vapor diffusivity)
  • Eq. 17.62: D'v = Dv / [1 + 2Dv/(αc Dp)√(2πMw/RT)] (kinetic correction)
  • Eq. 17.70: Dp dDp/dt = [Sv,∞ - Seq] / [ρw RT/(4p° D'v Mw) + ΔHv ρw/(4k'a T)(ΔHv Mw/(TR) - 1)]
  • Eq. 17.71: k_a = 10⁻³(4.39 + 0.071T) J/(m·s·K) (thermal conductivity)
  • Eq. 17.72: k'_a correction for kinetic effects
source
Aerosol.DropletMassBalance — Method
DropletMassBalance(; name=:DropletMassBalance)

Coupled gas-phase and aqueous-phase mass balance for cloud droplet chemistry.

This model couples:

  • Gas-phase partial pressure evolution
  • Aqueous-phase concentration evolution
  • Mass transfer between phases
  • Aqueous-phase chemical reaction

Reference: Seinfeld & Pandis (2006) Chapter 12, Eqs. 12.122-12.123

source
Aerosol.ECTracerMethod — Method
ECTracerMethod(; name=:ECTracerMethod)

The elemental carbon (EC) tracer method for estimating secondary organic carbon (OC) concentrations from measurements of total OC and EC.

From Seinfeld and Pandis (2006), Chapter 14, Section 14.3.2, Equations 14.1-14.4.

Primary OC is estimated as the sum of combustion-related OC (proportional to EC via the OC_EC_ratio) and noncombustion OC (OC_NC). Secondary OC is the remainder.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 14. John Wiley & Sons, Inc.

source
Aerosol.EffectiveHenrysLaw — Method
EffectiveHenrysLaw(; name=:EffectiveHenrys)

Effective Henry's law constant accounting for aqueous dissociation.

For species that dissociate in water, the effective Henry's law constant H* is larger than the intrinsic Henry's law constant H because dissociation products contribute to the total dissolved amount.

Implements:

  • Eq 7.24: HCO2 = HCO2 * (1 + Kc1/[H+] + Kc1K_c2/[H+]^2)
  • Eq 7.41: HSO2 = HSO2 * (1 + Ks1/[H+] + Ks1K_s2/[H+]^2)
  • Eq 7.61: H*HNO3 ~ HHNO3 * K_n1 / [H+]

Parameters:

  • H_intrinsic: Intrinsic Henry's law constant (mol/m³/Pa)
  • K_1: First dissociation constant (mol/m³)
  • K_2: Second dissociation constant (mol/m³), set to 0 for monoprotic acids

Variables:

  • H_plus: Hydrogen ion concentration (mol/m³)
  • H_eff: Effective Henry's law constant (mol/m³/Pa)
source
Aerosol.ElectricalMobility — Method
ElectricalMobility(; name=:ElectricalMobility)

Component for calculating electrical mobility and migration velocity.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9, Eqs. 9.49, 9.50, 9.51.

The electrical mobility relates particle velocity to electric field strength:

\[B_e = \frac{q C_c}{3 \pi \mu D_p}\]

The migration velocity in an electric field E is:

\[v_e = B_e E\]

source
Aerosol.ElementalCarbon — Method

A holder for elemental carbon concentrations. By default it does not include any dynamics.

Default density is from: https://doi.org/10.5194/acp-23-4327-2023

source
Aerosol.FHHAdsorption — Method
FHHAdsorption(; name=:FHHAdsorption)

FHH (Frenkel-Halsey-Hill) adsorption isotherm, appropriate for conditions near saturation where the BET theory breaks down. Relates the logarithm of the supersaturation ratio to the adsorbed volume.

From Seinfeld and Pandis (2006), Chapter 14, Section 14.5.3, Equation 14.46.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 14. John Wiley & Sons, Inc.

source
Aerosol.FreeTroposphereAerosol — Method
FreeTroposphereAerosol(; name=:FreeTroposphereAerosol)

Free troposphere aerosol size distribution from Table 8.3 of Seinfeld and Pandis (2006).

Three lognormal modes with parameters:

  • Mode 1: (N=129 cm⁻³, Dg=0.007 μm, log σ=0.645)
  • Mode 2: (N=59.7 cm⁻³, Dg=0.250 μm, log σ=0.253)
  • Mode 3: (N=63.5 cm⁻³, Dg=0.520 μm, log σ=0.425)
source
Aerosol.FuchsSutugin — Method
FuchsSutugin(; name=:FuchsSutugin)

Fuchs-Sutugin transition regime correction for mass transfer.

This is the most widely used formula for transition regime mass transfer due to its simplicity and accuracy across the full Knudsen number range.

Returns the ratio J/Jc where Jc is the continuum regime flux.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.43 (with accommodation coefficient)

source
Aerosol.GasDiffusionTimescale — Method
GasDiffusionTimescale(; name=:GasDiffusionTimescale)

Characteristic timescale for gas-phase diffusion to a particle.

This is the time required for a gas-phase concentration perturbation to diffuse to the particle surface.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.49

source
Aerosol.H2O2Equilibria — Method
H2O2Equilibria(; name=:H2O2Eq)

H2O2 dissolution and (weak) dissociation equilibria.

Implements:

  • HH2O2 = [H2O2(aq)] / pH2O2 = 1e5 M/atm at 298 K
  • K_h1 = [H+][HO2-] / [H2O2(aq)] = 2.2e-12 M (very weak, usually neglected)

Note: H2O2 is a very weak acid and dissociation is typically neglected.

Variables:

  • T: Temperature (K)
  • H_plus: Hydrogen ion concentration (mol/m³)
  • p_H2O2: Partial pressure of H2O2 (Pa)
  • H2O2_aq: Aqueous H2O2 concentration (mol/m³)
  • HO2_minus: Hydroperoxide anion concentration (mol/m³)
  • H2O2_total: Total dissolved hydrogen peroxide (mol/m³)
  • HH2O2eff: Effective Henry's law constant (mol/m³/Pa)
source
Aerosol.HNO3Equilibria — Method
HNO3Equilibria(; name=:HNO3Eq)

HNO3 dissolution and dissociation equilibria.

Implements:

  • Eq 7.53-7.54: HNO3(g) <-> HNO3(aq) <-> H+ + NO3-
  • HHNO3 = [HNO3(aq)] / pHNO3 = 2.1e5 M/atm at 298 K
  • K_n1 = [H+][NO3-] / [HNO3(aq)] = 15.4 M at 298 K
  • Eq 7.58: [NO3-] ~ HHNO3 * Kn1 / [H+] * p_HNO3 (for complete dissociation)
  • Eq 7.61: H*HNO3 ~ HHNO3 * K_n1 / [H+] = 3.2e6 / [H+]

Note: HNO3 is a strong acid and essentially completely dissociates in water.

Variables:

  • T: Temperature (K)
  • H_plus: Hydrogen ion concentration (mol/m³)
  • p_HNO3: Partial pressure of HNO3 (Pa)
  • HNO3_aq: Undissociated HNO3 concentration (mol/m³)
  • NO3_minus: Nitrate concentration (mol/m³)
  • HNO3_total: Total dissolved nitric acid (mol/m³)
  • HHNO3eff: Effective Henry's law constant (mol/m³/Pa)
source
Aerosol.HenrysLaw — Method
HenrysLaw(; name=:HenrysLaw)

Basic Henry's law equilibrium at fixed temperature.

Implements Eq 7.3: [A(aq)] = HA * pA

Parameters:

  • H_A: Henry's law constant (mol/m³/Pa)

Variables:

  • p_A: Partial pressure of gas A (Pa)
  • C_aq: Aqueous concentration (mol/m³)

This component establishes the equilibrium relationship between gas-phase partial pressure and aqueous-phase concentration.

source
Aerosol.HenrysLawTemperature — Method
HenrysLawTemperature(; name=:HenrysLawTemp)

Temperature-dependent Henry's law equilibrium.

Implements:

  • Eq 7.3: [A(aq)] = HA(T) * pA
  • Eq 7.5: HA(T) = HA(Tref) * exp((ΔHA/R) * (1/T_ref - 1/T))

Parameters:

  • H_298: Henry's law constant at 298 K (mol/m³/Pa)
  • dH_diss: Heat of dissolution (J/mol)

Variables:

  • T: Temperature (K)
  • p_A: Partial pressure (Pa)
  • C_aq: Aqueous concentration (mol/m³)
  • H_T: Temperature-corrected Henry's law constant (mol/m³/Pa)

Also calculates:

  • w_L: Liquid water mixing ratio (dimensionless, vol/vol)
  • f_A: Distribution factor (dimensionless)
  • X_aq: Aqueous fraction (dimensionless)
source
Aerosol.IcePhysics — Method
IcePhysics(; name=:IcePhysics)

Ice nucleation and ice-water equilibrium thermodynamics. Includes freezing point depression for solutions, Kelvin equation for ice particles, and empirical ice nuclei concentration.

Based on Equations 17.100-17.103 from Seinfeld & Pandis (2006) "Atmospheric Chemistry and Physics: From Air Pollution to Climate Change", 2nd Edition, Chapter 17.

Key Equations

  • Eq. 17.100: T0 - Te = (RT0 Te/ΔHm)(-ln aw) (freezing point from water activity)
  • Eq. 17.101: ΔTf = (RT0² Mw)/(1000 ΔHm) m ≈ 1.86 K·kg/mol × m (freezing point depression)
  • Eq. 17.102: pi = psat,i exp(4Mw σia / (R T ρi Dp)) (Kelvin effect for ice)
  • Eq. 17.103: IN(L⁻¹) = exp[0.6(253-T)] (ice nuclei concentration)
source
Aerosol.IndirectAerosolForcing — Method
IndirectAerosolForcing(; name=:IndirectAerosolForcing)

Component to calculate the indirect radiative forcing from aerosol effects on cloud albedo (first indirect effect, or Twomey effect).

From Seinfeld & Pandis (2006) Chapter 24, Section 24.8.2: ΔFc = -F0 * Ac * Ta² * ΔRc (Eq. 24.43) ΔRc = Rc*(1-Rc)/3 * Δln(N) (Eq. 24.42)

This gives the change in shortwave forcing due to changes in cloud albedo caused by changes in cloud droplet number concentration.

Reference: Seinfeld, J. H., and Pandis, S. N. (2006). Atmospheric Chemistry and Physics, Chapter 24, Section 24.8.2, Equations 24.42-24.43.

Parameters

  • F_0: Incident solar flux (W m⁻²)
  • A_c: Cloud fraction (dimensionless)
  • T_a: Atmospheric transmittance (dimensionless)
  • R_c: Cloud albedo (dimensionless)
  • Δln_N: Fractional change in CDNC, Δln(N) = ΔN/N (dimensionless)

Variables (computed)

  • ΔR_c: Change in cloud albedo (dimensionless)
  • ΔF_c: Change in shortwave forcing (W m⁻²)
source
Aerosol.InterfacialTimescale — Method
InterfacialTimescale(; name=:InterfacialTimescale)

Characteristic timescale to achieve equilibrium at the gas-particle interface.

For very soluble gases, the timescale is controlled by interfacial transport. For low solubility gases, the timescale is controlled by aqueous diffusion.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eqs. 12.61-12.62

source
Aerosol.IsorropiaEquilibrium — Method
IsorropiaEquilibrium(; name=:IsorropiaEquilibrium)

ISORROPIA II inorganic aerosol thermodynamic equilibrium model for the K⁺–Ca²⁺–Mg²⁺–NH₄⁺–Na⁺–SO₄²⁻–NO₃⁻–Cl⁻–H₂O system.

Supports both metastable (no solids) and stable (with solid precipitation) solution modes, controlled by the stable parameter (0=metastable, 1=stable).

The model solves 51 coupled algebraic equations:

  • 8 mass balance equations (with solid stoichiometric contributions in stable mode)
  • 1 charge balance (electroneutrality)
  • 5 aqueous equilibrium expressions (HSO₄⁻, NH₃, HNO₃, HCl, H₂O)
  • 1 ZSR water content equation with MDRH cutoff (Eqs. 16-18, 22)
  • 1 ionic strength definition
  • 16 activity coefficient equations (Kusik-Meissner, Eqs. 9-13)
  • 19 solid precipitation equations (Fischer-Burmeister NCP complementarity)

In stable mode, solid salts precipitate when the solution becomes supersaturated. Each solid equilibrium uses a smooth complementarity formulation: either the solid amount is zero, or the solution is exactly at saturation.

Deliquescence: Temperature-dependent DRH values are computed for each salt using Eq. 17 and Table 4. The mutual deliquescence relative humidity (MDRH) from Table 5 is enforced in stable mode: below the MDRH, the aerosol water content is driven to zero, producing a completely dry (crystalline) aerosol. In metastable mode, the MDRH cutoff is not applied.

Activity coefficients are computed using the Kusik-Meissner binary relationship (Eqs. 9-13) with temperature correction (Eq. 14).

Reference: Fountoukis, C. and Nenes, A.: ISORROPIA II: a computationally efficient thermodynamic equilibrium model for K⁺–Ca²⁺–Mg²⁺–NH₄⁺–Na⁺–SO₄²⁻–NO₃⁻–Cl⁻–H₂O aerosols, Atmos. Chem. Phys., 7, 4639–4659, 2007.

source
Aerosol.KnudsenNumber — Method
KnudsenNumber(; name=:KnudsenNumber)

Calculate the Knudsen number, the ratio of mean free path to particle radius.

The Knudsen number determines the transport regime:

  • Kn ≪ 1: Continuum regime (Fick's law applies)
  • Kn ≫ 1: Kinetic regime (molecular kinetics applies)
  • Kn ~ 1: Transition regime (interpolation formulas needed)

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.31

source
Aerosol.KohlerTheory — Method
KohlerTheory(; name=:KohlerTheory)

Köhler theory for equilibrium vapor pressure over solution droplets, combining the Kelvin (curvature) effect and Raoult (solute) effect.

Includes standard Köhler equation, critical diameter and supersaturation, and extension for partially insoluble particles.

Based on Equations 17.26-17.40 from Seinfeld & Pandis (2006).

Key Equations

  • Eq. 17.27: ln(pw(Dp)/p°) = A/Dp - B/Dp³
  • Eq. 17.28: A = 4Mw σw / (R T ρ_w)
  • Eq. 17.29: B = 6ns Mw / (π ρ_w)
  • Eq. 17.30: D_pc = √(3B/A) (critical diameter)
  • Eq. 17.32: ln(S_c) = √(4A³/27B) (critical saturation)
  • Eq. 17.33: ns = νπds³ρs / (6Ms) (moles of solute)
  • Eq. 17.38-17.40: Extensions for insoluble material
source
Aerosol.LangmuirAdsorption — Method
LangmuirAdsorption(; name=:LangmuirAdsorption)

Langmuir adsorption isotherm for the formation of a monolayer of adsorbed molecules on particle surfaces. Assumes all adsorption sites are equivalent, no horizontal interactions, and uniform heat of adsorption.

From Seinfeld and Pandis (2006), Chapter 14, Section 14.5.3, Equation 14.44.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 14. John Wiley & Sons, Inc.

source
Aerosol.MarineAerosol — Method
MarineAerosol(; name=:MarineAerosol)

Marine aerosol size distribution from Table 8.3 of Seinfeld and Pandis (2006).

Three lognormal modes with parameters:

  • Mode 1: (N=133 cm⁻³, Dg=0.008 μm, log σ=0.657)
  • Mode 2: (N=66.6 cm⁻³, Dg=0.266 μm, log σ=0.210)
  • Mode 3: (N=3.1 cm⁻³, Dg=0.58 μm, log σ=0.396)
source
Aerosol.MassTransfer — Method
MassTransfer(; name=:MassTransfer)

Complete mass transfer model combining transition regime correction, gas-phase diffusion, and interfacial transport.

This component provides the transition-regime corrected mass flux for particle growth/evaporation, applicable across all Knudsen numbers.

Reference: Seinfeld & Pandis (2006) Chapter 12, Sections 12.1.1-12.1.4

source
Aerosol.MassTransferCoefficient — Method
MassTransferCoefficient(; name=:MassTransferCoefficient)

Calculate the combined gas-phase and interfacial mass transfer coefficient.

This coefficient accounts for both gas-phase diffusion and interfacial resistance to mass transfer.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.116

source
Aerosol.MassTransportLimitation — Method
MassTransportLimitation(; name=:MassTransportLimitation)

Evaluate mass transport limitation criteria for aqueous-phase chemistry.

Computes the limiting values of k₁H* below which mass transport does not limit the aqueous-phase reaction rate (within 10%).

Reference: Seinfeld & Pandis (2006) Chapter 12, Eqs. 12.85, 12.86, 12.93

source
Aerosol.MaxwellianFlux — Method
MaxwellianFlux(; name=:MaxwellianFlux)

Calculate the Maxwellian (continuum regime) molar flux to a particle.

This is the steady-state diffusive flux in the continuum regime (Kn ≪ 1).

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.12

source
Aerosol.MeanFreePath — Method
MeanFreePath(; name=:MeanFreePath)

Component for calculating the mean free path of air molecules.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9, Eq. 9.6.

The mean free path is calculated from:

\[\lambda = \frac{2\mu}{p\sqrt{8M/(\pi R T)}}\]

where μ is dynamic viscosity, p is pressure, M is molecular weight, R is the gas constant, and T is temperature.

source
Aerosol.MeanFreePathMassTransfer — Method
MeanFreePathMassTransfer(; name=:MeanFreePathMassTransfer)

Calculate the mean free path of gas molecules in air.

Reference: Seinfeld & Pandis (2006) Chapter 12, Section 12.1.3

source
Aerosol.MeanMolecularSpeed — Method
MeanMolecularSpeed(; name=:MeanMolecularSpeed)

Calculate the mean molecular speed of gas molecules using kinetic theory.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.24

source
Aerosol.MieScattering — Method
MieScattering(; name=:MieScattering)

Mie theory for scattering and absorption of light by spherical particles.

This implements the equations from Chapter 15 of Seinfeld & Pandis (2006) "Atmospheric Chemistry and Physics: From Air Pollution to Climate Change".

The Mie theory calculates the scattering and extinction efficiencies (Qscat, Qext) as functions of the size parameter α = πDₚ/λ and the complex refractive index m = n + ik.

Key Variables

  • Q_scat: Scattering efficiency (dimensionless)
  • Q_abs: Absorption efficiency (dimensionless)
  • Q_ext: Extinction efficiency (dimensionless)
  • ω: Single-scattering albedo (dimensionless)
  • C_scat, C_abs, C_ext: Cross sections (m²)
  • E_scat, E_abs, E_ext: Mass efficiencies (m²/kg)

Key Parameters

  • D_p: Particle diameter (m)
  • λ: Wavelength of incident radiation (m)
  • n_refr: Real part of refractive index (dimensionless)
  • k_refr: Imaginary part of refractive index (dimensionless)
  • ρ_p: Particle density (kg/m³)

Reference

Seinfeld, J. H., & Pandis, S. N. (2006). Atmospheric Chemistry and Physics (2nd ed.), Chapter 15, Equations 15.1-15.23, 15.37-15.43.

source
Aerosol.MonodisperseCoagulation — Method
MonodisperseCoagulation(; name=:MonodisperseCoagulation)

Model the evolution of total aerosol number concentration for a monodisperse aerosol undergoing Brownian coagulation with a constant coagulation coefficient.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 13, Eq. 13.65-13.67.

The governing equation is:

$\frac{dN}{dt} = -\frac{1}{2} K N^2(t)$

with analytical solution:

$N(t) = \frac{N_0}{1 + t/\tau_c}$

where $\tau_c = \frac{2}{K N_0}$ is the characteristic coagulation time.

source
Aerosol.NH3Equilibria — Method
NH3Equilibria(; name=:NH3Eq)

NH3 dissolution and dissociation equilibria with temperature dependence.

Implements:

  • Eq 7.46-7.47: NH3(g) <-> NH3.H2O <-> NH4+ + OH-
  • Eq 7.48: HNH3 = [NH3.H2O] / pNH3
  • Eq 7.49: K_a1 = [NH4+][OH-] / [NH3.H2O]
  • Eq 7.50: [NH4+] = (HNH3 * Ka1 / Kw) * pNH3 * [H+]
  • Eq 7.51: [NH3T] = HNH3 * pNH3 * (1 + Ka1*[H+]/K_w)

Variables:

  • T: Temperature (K)
  • H_plus: Hydrogen ion concentration (mol/m³)
  • OH_minus: Hydroxide ion concentration (mol/m³)
  • K_w: Water dissociation constant (mol²/m⁶)
  • p_NH3: Partial pressure of NH3 (Pa)
  • NH3_aq: [NH3.H2O] concentration (mol/m³)
  • NH4_plus: Ammonium concentration (mol/m³)
  • NH3_total: Total dissolved ammonia (mol/m³)
  • HNH3eff: Effective Henry's law constant (mol/m³/Pa)
source
Aerosol.NoninteractingSOA — Method
NoninteractingSOA(; name=:NoninteractingSOA)

Gas-particle partitioning model for a secondary organic aerosol (SOA) compound that does not interact with preexisting aerosol components. The compound exists in the aerosol phase as pure compound, so gas-aerosol equilibrium is reached when the gas-phase concentration equals the saturation concentration.

From Seinfeld and Pandis (2006), Chapter 14, Section 14.5.2, Equations 14.6-14.18.

The aerosol concentration is zero until the reacted ROG exceeds the threshold ΔROG*_i = p°_i M_ROG / (a_i R T), after which the excess condenses.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 14. John Wiley & Sons, Inc.

source
Aerosol.Nucleation — Method
Nucleation(; name=:Nucleation)

A component representing homogeneous nucleation of a single-component vapor following classical nucleation theory from Seinfeld & Pandis (2006), Chapter 11.

This component calculates the nucleation rate, critical cluster size, and critical radius based on the saturation ratio, temperature, and species properties.

Variables

  • S: Saturation ratio (dimensionless), ratio of partial pressure to saturation vapor pressure
  • J: Nucleation rate (molecules/(m³·s))
  • i_star: Critical cluster size (molecules)
  • r_star: Critical cluster radius (m)
  • ΔG_star: Free energy barrier (J)
  • θ: Dimensionless surface tension parameter

Parameters

  • T: Temperature (K)
  • p_A: Partial pressure of condensing species (Pa)
  • p_A_s: Saturation vapor pressure (Pa)
  • σ: Surface tension (N/m)
  • v_1: Molecular volume (m³/molecule)
  • m_1: Molecular mass (kg/molecule)

References

Seinfeld, J.H. and Pandis, S.N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 11, pp. 489-536.

source
Aerosol.O3Equilibria — Method
O3Equilibria(; name=:O3Eq)

O3 dissolution equilibrium with temperature dependence.

O3 does not dissociate in water, so only Henry's law applies.

Variables:

  • T: Temperature (K)
  • p_O3: Partial pressure of O3 (Pa)
  • O3_aq: Aqueous O3 concentration (mol/m³)
  • H_O3: Henry's law constant (mol/m³/Pa)
source
Aerosol.ParticleGrowthRate — Method
ParticleGrowthRate(; name=:ParticleGrowthRate)

Calculate the rate of particle radius change due to condensation/evaporation.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.14

source
Aerosol.ParticleMobility — Method
ParticleMobility(; name=:ParticleMobility)

Component for calculating particle mechanical mobility.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9, Eq. 9.78.

The particle mobility relates external force to drift velocity:

\[B = \frac{C_c}{3 \pi \mu D_p}\]

With the Einstein relation connecting mobility to diffusion:

\[D = B k T\]

source
Aerosol.PolarAerosol — Method
PolarAerosol(; name=:PolarAerosol)

Polar aerosol size distribution from Table 8.3 of Seinfeld and Pandis (2006).

Three lognormal modes with parameters:

  • Mode 1: (N=21.7 cm⁻³, Dg=0.138 μm, log σ=0.245)
  • Mode 2: (N=0.186 cm⁻³, Dg=0.75 μm, log σ=0.300)
  • Mode 3: (N=3×10⁻⁴ cm⁻³, Dg=8.6 μm, log σ=0.291)
source
Aerosol.RainFormation — Method
RainFormation(; name=:RainFormation)

Rain formation by collision and coalescence processes, plus raindrop size distributions.

Based on Equations 17.104-17.108 from Seinfeld & Pandis (2006).

Key Equations

  • Eq. 17.104: E = y²/(Dp + dp)² (collision efficiency)
  • Eq. 17.105: Ec = (Dp/(Dp + dp))² (coalescence efficiency, for D_p > 400 µm)
  • Eq. 17.106: dm/dt = (π/4)Et(Dp + dp)²wL(vD - vd) (continuous accretion)
  • Eq. 17.107: F(Dp) = 1 - exp[-(Dp/(1.3p_0^0.232 mm))^2.25] (Best CDF)
  • Eq. 17.108: n(Dp) = n0 exp(-ψD_p) (Marshall-Palmer distribution)
source
Aerosol.RayleighAtmosphere — Method
RayleighAtmosphere(; name=:RayleighAtmosphere)

Calculate the Rayleigh scattering coefficient for air molecules.

The Rayleigh scattering coefficient represents the irreducible minimum of light scattering along an atmospheric sight path due to air molecules. It varies with temperature, pressure, and wavelength according to λ⁻⁴.

At sea level (T = 293 K, p = 1 atm) and λ = 550 nm, b_sg ≈ 13.2 × 10⁻⁶ m⁻¹, limiting visibility in a clean atmosphere to approximately 296 km.

Reference

Seinfeld & Pandis (2006), Chapter 15, page 705 and Problem 15.1A.

source
Aerosol.RayleighScattering — Method
RayleighScattering(; name=:RayleighScattering)

Rayleigh scattering regime for particles much smaller than the wavelength (α << 1).

This provides closed-form solutions valid when Dp << λ (typically Dp ≤ 0.1 μm for visible light). In this regime:

  • Scattered intensity is proportional to 1/λ⁴
  • Scattering pattern is symmetric in forward/backward directions
  • Absorption dominates over scattering (Qabs >> Qscat)

Reference

Seinfeld & Pandis (2006), Chapter 15, Equations 15.17-15.21.

source
Aerosol.ReactionTimescale — Method
ReactionTimescale(; name=:ReactionTimescale)

Characteristic timescale for aqueous-phase chemical reactions.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eqs. 12.76-12.78

source
Aerosol.RemoteContinentalAerosol — Method
RemoteContinentalAerosol(; name=:RemoteContinentalAerosol)

Remote continental aerosol size distribution from Table 8.3 of Seinfeld and Pandis (2006).

Three lognormal modes with parameters:

  • Mode 1: (N=3200 cm⁻³, Dg=0.020 μm, log σ=0.161)
  • Mode 2: (N=2900 cm⁻³, Dg=0.116 μm, log σ=0.217)
  • Mode 3: (N=0.300 cm⁻³, Dg=1.800 μm, log σ=0.380)
source
Aerosol.RuralAerosol — Method
RuralAerosol(; name=:RuralAerosol)

Rural aerosol size distribution from Table 8.3 of Seinfeld and Pandis (2006).

Three lognormal modes with parameters:

  • Mode 1: (N=6.65×10³ cm⁻³, Dg=0.015 μm, log σ=0.225)
  • Mode 2: (N=147 cm⁻³, Dg=0.054 μm, log σ=0.557)
  • Mode 3: (N=1990 cm⁻³, Dg=0.084 μm, log σ=0.266)
source
Aerosol.SO2Equilibria — Method
SO2Equilibria(; name=:SO2Eq)

SO2 dissolution and dissociation equilibria with temperature dependence. This is the S(IV) system.

Implements:

  • Eq 7.30-7.32: SO2(g) <-> SO2.H2O <-> H+ + HSO3- <-> H+ + SO3^2-
  • Eq 7.33: HSO2 = [SO2.H2O] / pSO2
  • Eq 7.34: K_s1 = [H+][HSO3-] / [SO2.H2O]
  • Eq 7.35: K_s2 = [H+][SO3^2-] / [HSO3-]
  • Eq 7.36-7.38: S(IV) species concentrations
  • Eq 7.39: [S(IV)] = [SO2.H2O] + [HSO3-] + [SO3^2-]
  • Eq 7.40: [S(IV)] = HSO2 * pSO2 * (1 + Ks1/[H+] + Ks1*K_s2/[H+]^2)
  • Eq 7.41: HS(IV) = HSO2 * (1 + Ks1/[H+] + Ks1K_s2/[H+]^2)
  • Eq 7.43-7.45: S(IV) mole fractions (alpha values)

Variables:

  • T: Temperature (K)
  • H_plus: Hydrogen ion concentration (mol/m³)
  • p_SO2: Partial pressure of SO2 (Pa)
  • SO2_aq: [SO2.H2O] concentration (mol/m³)
  • HSO3_minus: Bisulfite concentration (mol/m³)
  • SO3_2minus: Sulfite concentration (mol/m³)
  • SIVtotal: Total S(IV) concentration (mol/m³)
  • HSO2eff: Effective Henry's law constant (mol/m³/Pa)
  • alpha_0: Mole fraction of SO2.H2O (dimensionless)
  • alpha_1: Mole fraction of HSO3- (dimensionless)
  • alpha_2: Mole fraction of SO3^2- (dimensionless)
source
Aerosol.SettlingVelocity — Method
SettlingVelocity(; name=:SettlingVelocity)

Component for calculating particle terminal settling velocity and relaxation time.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9, Eqs. 9.38, 9.42.

The terminal settling velocity is given by:

\[v_t = \frac{D_p^2 \rho_p g C_c}{18\mu}\]

The relaxation time (time constant for velocity adjustment) is:

\[\tau = \frac{\rho_p D_p^2 C_c}{18\mu}\]

source
Aerosol.SingleParticleDynamics — Method
SingleParticleDynamics(; name=:SingleParticleDynamics)

Comprehensive component combining all single particle dynamics equations.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9: Dynamics of Single Aerosol Particles.

This component calculates key aerosol particle properties:

  • Mean free path of air (Eq. 9.6)
  • Knudsen number (Eq. 9.1)
  • Cunningham slip correction factor (Eq. 9.34)
  • Terminal settling velocity (Eq. 9.42)
  • Relaxation time (Eq. 9.38)
  • Brownian diffusion coefficient (Eq. 9.73)
  • Particle mobility (Eq. 9.78)
  • Mean thermal speed (Eq. 9.87)
  • Particle mean free path (Eq. 9.89)
  • Aerodynamic diameter (Eq. 9.110)
source
Aerosol.SlipCorrection — Method
SlipCorrection(; name=:SlipCorrection)

Component for calculating the Cunningham slip correction factor.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9, Eq. 9.34.

The slip correction factor accounts for noncontinuum effects when the particle size approaches the mean free path of gas molecules:

\[C_c = 1 + \frac{2\lambda}{D_p}\left[A_1 + A_2 \exp\left(-\frac{A_3 D_p}{2\lambda}\right)\right]\]

where the constants A₁ = 1.257, A₂ = 0.4, A₃ = 1.1 are from Allen & Raabe (1982).

source
Aerosol.SolidEquilibrationTimescale — Method
SolidEquilibrationTimescale(; name=:SolidEquilibrationTimescale)

Characteristic timescale for a gas to equilibrate with solid aerosol particles.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eqs. 12.135, 12.139

source
Aerosol.StochasticCollectionCoalescence — Method
StochasticCollectionCoalescence(; name=:StochasticCollectionCoalescence, I=36, x1=1.6e-14, kernel_type=:constant, kernel_params=Dict(:K0 => 1e-10))

Solve the stochastic collection equation (SCE) for cloud droplet coalescence using a two-moment method in discrete mass categories with p = 2 (mass-doubling categories).

This implements the collection-only component from Tzivion et al. (1989). The breakup, evaporation, and sedimentation processes from the full paper are not included.

Reference:

  • Tzivion, S., Feingold, G., and Levin, Z. (1989) "The Evolution of Raindrop Spectra. Part II: Collisional Collection/Breakup and Evaporation in a Rainshaft", Journal of the Atmospheric Sciences, 46(21), 3312-3327.

Implementation Note: This implementation covers only the collisional collection component from the 1989 paper. The complete physical system described in the paper also includes breakup, evaporation, and sedimentation processes, which are not yet implemented. The two-moment method uses geometrically doubling mass categories and closure via the nondimensional parameter ξ_p.

The SCE describes the evolution of a drop size distribution due to gravitational coalescence (collection). The continuous spectrum is divided into I discrete mass categories with geometrically increasing boundaries ($x_{k+1} = 2 x_k$), and two moments are tracked per category: number concentration $N_k$ (m⁻³) and mass concentration $M_k$ (kg m⁻³). Closure is achieved via a nondimensional parameter $\bar{\xi}_p$ that relates higher-order moments to these two (Eq. 8a,b).

The equations for each category follow Eq. (9a,b) in the paper, with incomplete category integrals evaluated using a linear distribution function approximation (Eq. 11-13) and positivity constraints (Eq. 15a,b).

The implementation uses symbolic array operations (@arrayop and @makearray from SymbolicUtils.jl) for all computations: closure relations, linear distribution parameters, shifted arrays, and summation reductions. Rate assembly uses level-2 @arrayop with ifelse masks for variable-bound sums and the ifelse(i==1, ...) trick for per-k terms.

Kernel Types

  • :constant — $K(x,y) = K_0$. Requires kernel_params = Dict(:K0 => value) in m³ s⁻¹.
  • :golovin — $K(x,y) = C(x+y)$. Requires kernel_params = Dict(:C => value) in m³ s⁻¹ kg⁻¹.

Arguments

  • I: Number of mass categories (default 36)
  • x1: Lower mass boundary of the first category in kg (default ~1.6e-14 kg, corresponding to D≈3.125 μm)
  • kernel_type: Collection kernel type, one of :constant or :golovin
  • kernel_params: Dictionary of kernel parameters
source
Aerosol.StokesNumber — Method
StokesNumber(; name=:StokesNumber)

Component for calculating Stokes number and stop distance.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006) Atmospheric Chemistry and Physics, 2nd Edition, Chapter 9, Eqs. 9.98, 9.101.

The stop distance is the distance a particle travels before coming to rest:

\[s_p = \tau U\]

The Stokes number characterizes particle inertia relative to flow:

\[St = \frac{\tau u_0}{L} = \frac{D_p^2 \rho_p C_c u_0}{18 \mu L}\]

When St ≫ 1, particles cannot follow fluid streamlines (inertial impaction). When St ≪ 1, particles follow fluid motion closely.

source
Aerosol.SulfateFormation — Method
SulfateFormation(; name=:SulfateForm)

Combined S(IV) to S(VI) oxidation kinetics including all pathways.

Subsystems:

  • o3_ox: O3 oxidation pathway
  • h2o2_ox: H2O2 oxidation pathway
  • fe_ox: Fe(III)-catalyzed oxidation
  • mn_ox: Mn(II)-catalyzed oxidation
  • femn_ox: Fe/Mn synergistic oxidation

Variables:

  • R_total: Total S(IV) oxidation rate (mol/m^3/s)
  • SVIproduction: Sulfate production rate (mol/m^3/s)

Also calculates rate conversion factors (Section 7.4):

  • Rppbhr: Rate in ppb hr^-1 (Eq 7.75)
  • Rpercenthr: Rate in % hr^-1 (Eq 7.76)
  • tau_SO2: SO2 lifetime (s) (Eq 7.78) # Create subsystems
source
Aerosol.SulfateFormationFe — Method
SulfateFormationFe(; name=:SulfateFe)

S(IV) oxidation by O2 catalyzed by Fe(III) in aqueous phase.

The rate expression depends strongly on pH:

For pH 0-3.6 (Eq 7.92): R_Fe = k[Fe(III)][S(IV)] / [H+], k = 6 s^-1

For pH ~4.0 (Eq 7.93): R_Fe = 1e9 * [S(IV)] * [Fe(III)]^2

For pH 5.0-6.0 (Eq 7.94): R_Fe = 1e-3 * [S(IV)]

For pH 7.0 (Eq 7.95): R_Fe = 1e-4 * [S(IV)]

This implementation uses a simplified approach with the low-pH rate law, which is most relevant for typical cloud droplet conditions.

Variables:

  • H_plus: Hydrogen ion concentration (mol/m^3)
  • Fe_III: Fe(III) concentration (mol/m^3)
  • SIVtotal: Total S(IV) concentration (mol/m^3)
  • R_Fe: Oxidation rate (mol/m^3/s)
source
Aerosol.SulfateFormationFeMn — Method
SulfateFormationFeMn(; name=:SulfateFeMn)

S(IV) oxidation by O2 with Fe/Mn synergism.

Implements Eq 7.102: R = 750[Mn(II)][S(IV)] + 2600[Fe(III)][S(IV)] + 1.0e10[Mn(II)][Fe(III)]*[S(IV)]

The synergistic term (10^10 coefficient) represents the greatly enhanced oxidation rate when both Fe(III) and Mn(II) are present.

Variables:

  • Mn_II: Mn(II) concentration (mol/m^3)
  • Fe_III: Fe(III) concentration (mol/m^3)
  • SIVtotal: Total S(IV) concentration (mol/m^3)
  • RMnterm: Mn-only contribution (mol/m^3/s)
  • RFeterm: Fe-only contribution (mol/m^3/s)
  • Rsynergyterm: Synergistic contribution (mol/m^3/s)
  • R_FeMn: Total oxidation rate (mol/m^3/s)
source
Aerosol.SulfateFormationH2O2 — Method
SulfateFormationH2O2(; name=:SulfateH2O2)

S(IV) oxidation by H2O2 in aqueous phase.

Implements Eq 7.84: R_H2O2 = k[H+][H2O2][HSO3-] / (1 + K[H+])

where:

  • k = 7.5e7 M^-2 s^-1
  • K = 13 M^-1

This reaction is relatively pH-independent due to the [H+] terms canceling, making it important across a wide pH range.

Variables:

  • H_plus: Hydrogen ion concentration (mol/m^3)
  • H2O2_aq: Aqueous H2O2 concentration (mol/m^3)
  • HSO3_minus: Bisulfite concentration (mol/m^3)
  • R_H2O2: Oxidation rate (mol/m^3/s)
source
Aerosol.SulfateFormationMn — Method
SulfateFormationMn(; name=:SulfateMn)

S(IV) oxidation by O2 catalyzed by Mn(II) in aqueous phase.

The rate expression depends on S(IV) concentration:

For high S(IV) (>100 uM) (Eq 7.98): R_Mn = k0 * [Mn]^2 (zero-order in S(IV))

For low S(IV) (<1 uM) (Eq 7.101): R_Mn = k0 * [Mn] * [S(IV)], k0 = 1000 M^-1 s^-1

This implementation uses the low S(IV) rate law, which is first-order in both Mn and S(IV).

Variables:

  • Mn_II: Mn(II) concentration (mol/m^3)
  • SIVtotal: Total S(IV) concentration (mol/m^3)
  • R_Mn: Oxidation rate (mol/m^3/s)
source
Aerosol.SulfateFormationO3 — Method
SulfateFormationO3(; name=:SulfateO3)

S(IV) oxidation by O3 in aqueous phase.

Implements Eq 7.79-7.80: R_O3 = (k0[SO2.H2O] + k1[HSO3-] + k2*[SO3^2-]) * [O3(aq)]

where:

  • k0 = 2.4e4 M^-1 s^-1 (SO2.H2O + O3)
  • k1 = 3.7e5 M^-1 s^-1 (HSO3- + O3)
  • k2 = 1.5e9 M^-1 s^-1 (SO3^2- + O3)

The reaction is fast at high pH due to the large k2 value for SO3^2-.

Variables:

  • SO2_aq: [SO2.H2O] concentration (mol/m^3)
  • HSO3_minus: [HSO3-] concentration (mol/m^3)
  • SO3_2minus: [SO3^2-] concentration (mol/m^3)
  • O3_aq: [O3(aq)] concentration (mol/m^3)
  • R_O3: Oxidation rate (mol/m^3/s)
source
Aerosol.TwoProductSOA — Method
TwoProductSOA(; name=:TwoProductSOA)

The two-product model for secondary organic aerosol (SOA) formation, developed by Odum et al. (1996). This model represents the complex mixture of oxidation products from a reactive organic gas (ROG) as two lumped surrogate products that form an ideal solution.

From Seinfeld and Pandis (2006), Chapter 14, Section 14.5.2, Equations 14.27-14.43.

The key equation (14.43) gives the overall aerosol mass yield:

Y = c_aer * (a₁/(c_aer + c₁°) + a₂/(c_aer + c₂°))

where a_i are stoichiometric yields and c_i° are saturation concentrations.

Parameters from Table 14.12 are provided for multiple VOC precursors.

Reference: Seinfeld, J. H. and Pandis, S. N. (2006). Atmospheric Chemistry and Physics: From Air Pollution to Climate Change, 2nd Edition, Chapter 14. John Wiley & Sons, Inc.

See also: Odum, J. R. et al. (1996). Gas/Particle Partitioning and Secondary Organic Aerosol Yields. Environ. Sci. Technol., 30, 2580-2585.

source
Aerosol.UptakeCoefficient — Method
UptakeCoefficient(; name=:UptakeCoefficient)

Calculate the uptake coefficient γ for gas-particle mass transfer.

The uptake coefficient is the probability that a molecule striking the particle surface is taken up by the particle.

Reference: Seinfeld & Pandis (2006) Chapter 12, Eq. 12.121

source
Aerosol.UrbanAerosol — Method
UrbanAerosol(; name=:UrbanAerosol)

Urban aerosol size distribution from Table 8.3 of Seinfeld and Pandis (2006).

Three lognormal modes with parameters:

  • Mode 1: nucleation mode (N=9.93×10⁴ cm⁻³, Dg=0.013 μm, log σ=0.245)
  • Mode 2: Aitken mode (N=1.11×10³ cm⁻³, Dg=0.014 μm, log σ=0.666)
  • Mode 3: accumulation mode (N=3.64×10⁴ cm⁻³, Dg=0.050 μm, log σ=0.337)
source
Aerosol.Visibility — Method
Visibility(; name=:Visibility)

Visibility calculation from extinction coefficient.

Computes visual range using the Koschmeider equation (Eq. 15.36) and related visibility metrics. Visual range is the distance at which a black object against a white background reaches the threshold contrast of 0.02.

Reference

Seinfeld & Pandis (2006), Chapter 15, Equations 15.31-15.36.

source
Aerosol.WaterEquilibrium — Method
WaterEquilibrium(; name=:WaterEq)

Water autoionization equilibrium with temperature dependence.

Implements:

  • Eq 7.10-7.12: H2O <-> H+ + OH-
  • Eq 7.13: pH = -log10[H+]
  • Table 7.4: Kw(T) = Kw(298) * exp((-dH/R) * (1/T - 1/298))

Variables:

  • T: Temperature (K)
  • H_plus: Hydrogen ion concentration (mol/m³)
  • OH_minus: Hydroxide ion concentration (mol/m³)
  • K_w: Water dissociation constant (mol²/m⁶)
  • pH: Negative log of H+ concentration (dimensionless)
source
Aerosol.WaterProperties — Method
WaterProperties(; name=:WaterProperties)

A component providing temperature-dependent physical properties of water for nucleation calculations following the data from Seinfeld & Pandis (2006), Table 11.1 and 11.4.

Variables

  • σ: Surface tension (N/m)
  • v_1: Molecular volume (m³/molecule)
  • m_1: Molecular mass (kg/molecule)
  • p_sat: Saturation vapor pressure (Pa)

Parameters

  • T: Temperature (K)

References

Seinfeld, J.H. and Pandis, S.N. (2006). Atmospheric Chemistry and Physics, Chapter 11.

source
Aerosol._iso2_compute_mdrh — Method
_iso2_compute_mdrh(Na, SO4, NH3, NO3, Cl, Ca, K, Mg)

Compute the Mutual Deliquescence Relative Humidity (MDRH) from total composition (all in mol/m³). Uses sulfate ratio R₁ and presence of crustal/Na species to select the appropriate MDRH from Table 5.

source
Aerosol._iso2_drh_T — Method
_iso2_drh_T(drh0, coeff, T)

Compute temperature-dependent deliquescence relative humidity (Eq. 17, Table 4). DRH(T) = DRH(T₀) × exp(coeff × (1/T - 1/T₀)) Result is clamped to [0, 1].

source
Aerosol._iso2_eq_const — Method
_iso2_eq_const(K0, A, B, T)

Compute equilibrium constant at temperature T using the van't Hoff equation (Eq. 5). K(T) = K₀ × exp(A×(T₀/T - 1) + B×(1 + ln(T₀/T) - T₀/T))

source
Aerosol._iso2_fb_ncp — Method
_iso2_fb_ncp(a, b)

Fischer-Burmeister NCP (nonlinear complementarity problem) function. Returns √(a² + b² + ε) - a - b, which equals zero when either a=0 or b=0 (or both). Used for solid precipitation equilibria: either solid amount is zero, or solution is saturated.

source
Aerosol._iso2_gamma_T — Method
_iso2_gamma_T(gamma298, I, T)

Apply temperature correction to activity coefficient (Eq. 14). Returns γ(T) given γ(298K).

source
Aerosol._iso2_km_gamma — Method
_iso2_km_gamma(q, z, I)

Compute binary mean activity coefficient using the Kusik-Meissner relationship (Eqs. 9-13). Returns γ± (not log γ±).

  • q: salt-specific interaction parameter
  • z: charge product z₁×z₂
  • I: ionic strength (mol/kg)
source
Aerosol._iso2_smooth_min — Method
_iso2_smooth_min(a, b)

Smooth differentiable approximation to min(a, b). Uses the identity: min(a,b) = 0.5*(a + b - √((a-b)² + ε)).

source
Aerosol._iso2_smooth_step — Method
_iso2_smooth_step(x)

Smooth logistic step function: σ(x) = 1/(1 + exp(-clamp(x, -20, 20))). Returns ≈0 for x ≪ 0 and ≈1 for x ≫ 0, with smooth transition near x=0.

source
Aerosol._iso2_zsr_m0 — Method
_iso2_zsr_m0(table, RH)

Interpolate binary molality from ZSR lookup table at given RH. Returns molality in mol/kg water.

source
Aerosol._iso2_zsr_water — Method
_iso2_zsr_water(RH, c_Na, c_NH4, c_SO4, c_HSO4, c_NO3, c_Cl, c_Ca, c_K, c_Mg)

Compute aerosol water content using ZSR correlation (Eq. 16). Ion concentrations in mol/m³ air. Returns water content in kg/m³ air. Uses hierarchical ion pairing following ISORROPIA conventions.

source
Aerosol._m2_components — Method
_m2_components(n, k)

Compute components for (m² - 1) and (m² + 2) where m = n + ik. Returns (real(m²-1), imag(m²-1), real(m²+2), imag(m²+2)).

source
Aerosol._mie_coefficients — Method
_mie_coefficients(α, n, k)

Compute Mie extinction and scattering efficiencies together.

Based on the BHMIE algorithm from Bohren & Huffman (1983) "Absorption and Scattering of Light by Small Particles", Appendix A. This is the standard reference implementation used widely in atmospheric science.

Returns (Qext, Qscat).

source
Aerosol._rayleigh_Q_ext — Method
_rayleigh_Q_ext(α, n, k)

Rayleigh approximation for extinction efficiency (Eq. 15.18, 15.21).

Valid for α << 1 (particles much smaller than wavelength).

source
Aerosol._rayleigh_Q_scat — Method
_rayleigh_Q_scat(α, n, k)

Rayleigh approximation for scattering efficiency (Eq. 15.19).

Valid for α << 1 (particles much smaller than wavelength).

source
Aerosol.aqueous_fraction — Method
aqueous_fraction(H, R, T, w_L)

Calculate the fraction of species in aqueous phase (Eq 7.9).

Arguments:

  • H: Henry's law constant (mol/L/Pa)
  • R: Gas constant (8314.46 Pa L mol^-1 K^-1)
  • T: Temperature (K)
  • w_L: Liquid water mixing ratio (vol/vol)

Returns:

  • X_aq: Fraction in aqueous phase (dimensionless)
source
Aerosol.dahneke_capillary_penetration — Method
dahneke_capillary_penetration(z, γ, Kn_D)

Compute the aerosol penetration fraction ϕ through a capillary tube at dimensionless length z, for velocity profile parameter γ and diffusion Knudsen number Kn_D, using the eigenfunction expansion from Dahneke (1983) Section 9.

The penetration is computed as:

$ϕ(z) = \sum_{i=1}^{6} B_i \exp(-ω_i^2 z)$

where the eigenvalues ωi² and coefficients Bi are taken from Tables 3–5 of the paper for δ = 1 (perfect sticking).

Arguments

  • z: Dimensionless tube length z = DL/(σv̄R²)
  • γ: Velocity profile parameter (0=plug, 0.5=transition, 1.0=Poiseuille)
  • Kn_D: Diffusion Knudsen number (must be one of 0.0, 0.1, 0.2, 0.3, 0.4, 0.5)

Returns

  • Penetration fraction ϕ (between 0 and 1)
source
Aerosol.distribution_factor — Method
distribution_factor(H, R, T, w_L)

Calculate the distribution factor f_A (Eq 7.7).

Arguments:

  • H: Henry's law constant (mol/L/Pa)
  • R: Gas constant (8314.46 Pa L mol^-1 K^-1)
  • T: Temperature (K)
  • w_L: Liquid water mixing ratio (vol/vol)

Returns:

  • f_A: Distribution factor (dimensionless)
source
Aerosol.effective_henrys_constant — Method
effective_henrys_constant(H, K1, K2, H_plus)

Calculate effective Henry's law constant accounting for dissociation.

Arguments:

  • H: Intrinsic Henry's law constant (mol/L/Pa)
  • K1: First dissociation constant (mol/L)
  • K2: Second dissociation constant (mol/L), use 0 for monoprotic
  • H_plus: Hydrogen ion concentration (mol/L)

Returns:

  • H_eff: Effective Henry's law constant (mol/L/Pa)
source
Aerosol.henrys_constant_at_T — Method
henrys_constant_at_T(H_298, dH_diss, T)

Calculate Henry's law constant at temperature T using van't Hoff equation (Eq 7.5).

Arguments:

  • H_298: Henry's law constant at 298 K (mol/L/Pa)
  • dH_diss: Heat of dissolution (J/mol)
  • T: Temperature (K)

Returns:

  • H_T: Henry's law constant at temperature T (mol/L/Pa)
source
Aerosol.mie_Q_ext — Method
mie_Q_ext(α, n, k)

Calculate extinction efficiency Q_ext using Mie theory.

Uses the algorithm from Appendix 15 of Seinfeld & Pandis (2006), based on Bohren & Huffman (1983).

Arguments

  • α: Size parameter (= πDₚ/λ)
  • n: Real part of refractive index
  • k: Imaginary part of refractive index

Returns

  • Q_ext: Extinction efficiency (dimensionless)
source
Aerosol.mie_Q_scat — Method
mie_Q_scat(α, n, k)

Calculate scattering efficiency Q_scat using Mie theory.

Arguments

  • α: Size parameter (= πDₚ/λ)
  • n: Real part of refractive index
  • k: Imaginary part of refractive index

Returns

  • Q_scat: Scattering efficiency (dimensionless)
source
Aerosol.rate_to_percent_hr — Method
rate_to_percent_hr(R_a, L, T, xi_SO2; p_total=101325.0)

Convert aqueous-phase rate to percent conversion rate (Eq 7.76).

Arguments:

  • R_a: Aqueous reaction rate (mol/L/s)
  • L: Liquid water content (g/m³)
  • T: Temperature (K)
  • xi_SO2: SO2 mixing ratio (dimensionless)
  • p_total: Total pressure (Pa), default 101325 (1 atm)

Returns:

  • Rate in %/hr
source
Aerosol.rate_to_ppb_hr — Method
rate_to_ppb_hr(R_a, L, T; p_total=101325.0)

Convert aqueous-phase rate to atmospheric mixing ratio rate (Eq 7.75).

Arguments:

  • R_a: Aqueous reaction rate (mol/L/s)
  • L: Liquid water content (g/m³)
  • T: Temperature (K)
  • p_total: Total pressure (Pa), default 101325 (1 atm)

Returns:

  • Rate in ppb/hr
source
Aerosol.so2_lifetime — Method
so2_lifetime(R_a, L, T, xi_SO2; p_total=101325.0)

Calculate SO2 lifetime in seconds (Eq 7.78).

Arguments:

  • R_a: Aqueous reaction rate (mol/L/s)
  • L: Liquid water content (g/m³)
  • T: Temperature (K)
  • xi_SO2: SO2 mixing ratio (dimensionless)
  • p_total: Total pressure (Pa), default 101325 (1 atm)

Returns:

  • SO2 lifetime in seconds
source
Aerosol.ISORROPIA.EqConst — Method

An equilibrium constant based on Equation 5 in Fountoukis and Nenes (2007), parameterized by values from Table 2 in the same paper.

source
Aerosol.ISORROPIA.Gas — Method

A gas with the given partial pressure. From Section 2.2 in Fountoukis and Nenes (2007), the activity of a gas is its partial pressure (in atm).

source
Aerosol.ISORROPIA.Isorropia — Function
Isorropia(kwargs...)

An implementation of ISORROPIA II, a model for the thermodynamic equilibrium of gas-aerosol interactions, as described in:

Fountoukis, C. and Nenes, A., 2007. ISORROPIA II: a computationally efficient thermodynamic equilibrium model for K+–Ca 2+–Mg 2+–NH 4+–Na+–SO 4 2−–NO 3−–Cl−–H 2 O aerosols. Atmospheric Chemistry and Physics, 7(17), pp.4639-4659.

source
Aerosol.ISORROPIA.Salt — Method

An aqueous salt comprised of a cation, an anion, and an activity parameter (q). q values are given in Table 4 of Fountoukis and Nenes (2007).

source