ElasticPinchOff

Axisymmetric viscoelastic pinch-off simulation using Basilisk.

Layout

Requirements

• Basilisk qcc available in PATH
• Optional for MPI runs: mpicc, mpirun
• Optional local environment bootstrap: .project_config in repo root

Single Case Run

bash runSimulation.sh default.params

Optional:

bash runSimulation.sh default.params --mpi --CPUs 8

The case is executed in simulationCases/<CaseNo>/. The log file is written as c<CaseNo>-log (for example: c1000-log).

Parameter Sweep

bash runParameterSweep.sh sweep.params

Preview generated combinations only:

bash runParameterSweep.sh sweep.params --dry-run

runParameterSweep.sh reads SWEEP_* entries, creates temporary case parameter files, injects CaseNo, then runs each case via runSimulation.sh.

Parameter File Keys

LiquidOutThinning.c currently reads these keys from a key=value file:

• CaseNo
• MAXlevel
• Oh
• Oha (optional; defaults to 1e-2*Oh if omitted)
• De
• Ec
• tmax
• dtmax

For sortable case folders, use CaseNo >= 1000 (e.g., 1000, 1001, …).

Documentation Website and CI

The repository includes CoMPhy’s docs/CI bundle under .github/.

Build documentation locally:

bash .github/scripts/build.sh

Preview generated docs locally:

bash .github/scripts/deploy.sh

This project uses the committed docs model: - generated site files live in .github/docs/, - the GitHub Pages deploy workflow triggers on changes to .github/docs/** on main.

For GitHub Pages, set: - Settings -> Pages -> Source: GitHub Actions.

Generated Documentation

Root Directory

• default-in.params
• default-out.params
• runParameterSweep.sh
• runSimulation.sh
• sweep.params

simulationCases

• simulationCases/LiquidInThinning.c
• simulationCases/LiquidOutThinning.c

src-local

• src-local/log-conform-viscoelastic-scalar-2D.h
• src-local/params.h
• src-local/parse_params.h
• src-local/two-phaseVE.h