fix: #921 - [M2-P7] Coagulation charge notebooks - API migration

[Gorkowski]

Target Branch: main

Fixes #921 | Workflow: d7a24969

Summary

Updates both charge coagulation notebooks to the current builder/factory APIs to keep the tutorials aligned with the public particula.dynamics namespace. Markdown calling out the learning objectives was refreshed, outputs were cleared, and the notebooks were validated via run_notebook so CI can continue to exercise them.

What Changed

Updated Notebooks

• docs/Examples/Dynamics/Coagulation/Charge/Coagulation_with_Charge_objects.ipynb - Imports particula as par, builds ChargedCoagulationStrategy via ChargedCoagulationBuilder with an explicit ChargedKernelStrategy, and narrates how the builder wires the kernel into the charged coagulation pipeline.
• docs/Examples/Dynamics/Coagulation/Charge/Coagulation_with_Charge_functional.ipynb - Uses CoagulationFactory (with the same kernel strategy) to obtain the charged coagulation strategy, cleanly replacing the previous direct kernel instantiations while preserving the functional storytelling.

Tests Added/Updated

• run_notebook({notebookPath: "docs/Examples/Dynamics/Coagulation/Charge/Coagulation_with_Charge_objects.ipynb", timeout: 300})
• run_notebook({notebookPath: "docs/Examples/Dynamics/Coagulation/Charge/Coagulation_with_Charge_functional.ipynb", timeout: 300})

How It Works

Each notebook now sources particula through the public namespace (import particula as par). The object-oriented example builds the charged coagulation strategy via ChargedCoagulationBuilder().set_distribution_type("discrete").set_charged_kernel_strategy(kernel).build(), while the functional notebook obtains the same strategy through CoagulationFactory().get_strategy("charged", parameters={...}). Kernel strategies such as CoulombGatti2008KernelStrategy are instantiated once and fed into the builder/factory, keeping the class composition explicit and the downstream calculations unchanged.

Implementation Notes

• Why this approach: Using the builder/factory surfaces the public API, aligns the notebooks with the documented patterns from M2, and keeps the kernel selection explicit for learners.
• Learning objectives: Both notebooks now mention the migration to builder/factory compositions so the narrative matches the code.
• Outputs: All output cells were cleared to keep diffs clean before committing.

Testing

• run_notebook: Coagulation_with_Charge_objects.ipynb (pass, 3.84s)
• run_notebook: Coagulation_with_Charge_functional.ipynb (pass, 3.48s)

[Copilot]

Copilot wasn't able to review any files in this pull request.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.