Examples¶
Welcome to the Particula Examples Gallery! Here you’ll find a curated collection of notebooks and step‑by‑step tutorials designed to help you explore, learn, and extend the core functionality of Particula. Whether you’re looking for a full end‑to‑end simulation, a focused how‑to guide, or a deep dive into individual components, each card below links to a ready‑to‑run example with contextual explanations and code snippets.
Use the End‑to‑End Simulations to see complete workflows in action, then explore the How‑To Guides for targeted recipes that tackle specific processes (e.g., chamber wall losses, thermodynamic equilibria, or nucleation events). Finally, the Tutorials section breaks down the building blocks of Particula’s architecture—Aerosol objects, Dynamics modules, Gas Phase definitions, and Particle Phase representations—so you can customize and combine them in your own research.
Jump in by selecting any card below and follow along in your browser or local environment. Happy modeling!
End-to-End Simulations¶
-
Biomass burning aerosols that activate into cloud droplets, simulating the interactions between aerosols and clouds.
-
Organic Partitioning and Coagulation
Simulation of organic partitioning on to seed particles and coagulation.
-
Simulates the evaporation of cough droplets, tracking size distribution and composition changes over time.
-
Simulates soot formation in a cooling combustion plume, tracking particle growth and chemical speciation.
How-To Guides¶
-
How to setup python and install
Particulavia pip. -
How to simulate experiments for the loss of particles to the chamber walls, including the new strategy-based wall loss API (
WallLossStrategyandSphericalWallLossStrategy). -
How to simulate aerosol thermodynamic equilibria using the Binary Activity Thermodynamic
BATModel. Useful for water uptake and cloud droplet activation. -
How to simulate aerosol nucleation by adding particles during simulations. Showing how to add a nucleation event.
Tutorials¶
-
Learn what goes into the Aerosol object and why it is used.
-
Dynamics is a collection of classes that processes
Aerosolobjects, to perform coagulation, condensation, and other processes. -
Learn how to represent the Gas Phase, including vapor pressures and atmospheric properties.
-
Learn about how to represent the Particle Phase, including different particle representations; radius bins, speciated mass bins, and particle resolved.