CoBubbles

CoBubbles stands for Collective Bubbles Simulations. It is a modular Python code for simulating bubbles on a plane (for instance, air bubbles at the surface of water).

Contents

• Installation
• Code Organization
• Simulations
• Release notes

Example

A minimal working example is demonstrated in this notebook.

Provided that Simu is defined properly, the following code instantiates a simulation with the given parameters params:

from cobubbles.main import Simu
params = dict(lifetime=10)
s = Simu(**params)
s.params # or s.params_df for a view as a pd.Series

Then run the simulation for 100 steps and display a time series of bubbles number \(n\) and mean size \(\langle d/d_1 \rangle\) (figure output may be different for one run to the next):

s.run(100)
s.plot_time_series()

References

Néel, B., and L. Deike. 2021. “Collective Bursting of Free-Surface Bubbles, and the Role of Surface Contamination.” Journal of Fluid Mechanics 917: A46. https://doi.org/10.1017/jfm.2021.272.