comphy-lab/BurstingBubble_Herschel-Bulkley: Release: Herschel–Bulkley Worthington Jets & Droplets (v1.0)

We are excited to present v1.0 of our Herschel–Bulkley Worthington Jets & Droplets repository. This release offers a one-stop solution for simulating bubble bursting in complex non-Newtonian media, capturing how shear-thinning, shear-thickening, and yield stress modify Worthington jet formation and droplet ejection.

Highlights:

• Easy Basilisk Setup<br> Automate your Basilisk setup using reset_install_requirements.sh, so you can quickly get to running 2D or axisymmetric simulations of non-Newtonian bubble bursting.

• Herschel–Bulkley Formulation<br> Model fluids spanning from shear-thinning to shear-thickening, including the Bingham model as a special case. This covers yield-stress effects and accommodates Newtonian flow in the limiting scenario.

• Dimensionless Exploration<br> Investigate the interplay between plasto-capillary number, effective Ohnesorge number, and power-law index. Understand how each parameter shapes jet speed, droplet pinch-off, and overall bubble cavity collapse dynamics.

• Flexible Compilation & Run Options<br> Use our Makefile-driven approach for easy interactive visualization or direct qcc compilation for HPC clusters and local machines.

What's in This Release?

Simulation Code

• burstingBubbleVE.c and supporting modules in src-local for running Herschel–Bulkley (HB) bubble-bursting simulations.
• Example input files and scripts in testCases.

Installation Scripts

• reset_install_requirements.sh automates Basilisk fetching and configuration.
• project_config sets environment variables upon each run.

Analysis & Post-Processing

Utilities for data extraction, Python scripts for visualization.

Documentation

• Detailed instructions on HPC cluster usage, environment setup, and advanced features (like MPI/OpenMP) in this release's README.
• The documentation at Herschel–Bulkley formulation notes clarify how yield stress and power-law dependence are implemented.

Quick Start

1. Clone the Repository

git clone https://github.com/comphy-lab/BurstingBubble_Herschel-Bulkley.git
cd BurstingBubble_Herschel-Bulkley

1. Install Requirements

./reset_install_requirements.sh

1. Test a Simulation

cd testCases
CFLAGS=-DDISPLAY=-1 make burstingBubbleVE.tst

This runs an interactive simulation in your browser. To run in batch mode instead, just invoke make burstingBubbleVE.tst without the DISPLAY flag.

Running on HPC Clusters

• Copy the contents of the src-local to your work directory for robust compilation. • Use mpicc with the Basilisk-based code to run on multiple MPI ranks. • Adapt the sample SLURM script for your cluster environment.

Stay in Touch • Issues & Contributions: Please file bug reports, feature requests, or pull requests on GitHub. • Questions? Post an issue or email Vatsal Sanjay vatsalsy@comphy-lab.org.

Thanks for using our code—have fun exploring bubble dynamics in Herschel–Bulkley fluids! If you find this work useful, consider giving us a star on GitHub.

Happy Simulating!