Features¶
Welcome to the Particula Features documentation! This section provides comprehensive guides for the major capabilities and systems within Particula. Each feature guide explains the design patterns, available APIs, and best practices for working with that component.
Feature Guides¶
-
Strategy-based activity calculations for aerosol thermodynamics, including ideal, kappa-Kohler, and BAT (non-ideal) models.
-
Strategy-based particle coagulation for chamber simulations with Brownian, charged, and turbulent coagulation models.
-
Strategy-based condensation for particle growth simulations with isothermal and coupled dynamics models.
-
Strategy-based wall loss for chamber simulations with spherical, rectangular, and charged particle deposition models.
Design Patterns¶
All feature systems in Particula follow the Strategy-Builder-Factory pattern:
- Strategy: Abstract base classes defining the interface for each physics domain
- Builder: Unit-aware configuration with validation for constructing strategies
- Factory: Dynamic strategy selection by name for runtime flexibility
This pattern provides:
- Consistent APIs across different physics modules
- Easy extensibility for new models
- Validated configuration with automatic unit conversion
- Interchangeable implementations for comparison studies
Getting Started¶
- Choose the feature guide for your use case
- Review the available strategies and their parameters
- Use builders for validated configuration or factories for dynamic selection
- Integrate with Particula's dynamics workflow using Runnable objects
Related Documentation¶
- Examples: See Examples Gallery for working code
- Theory: See Theory Documentation for scientific background
- Tutorials: See Tutorials for step-by-step learning