How iamkartik0704/fluidslab works
This repository implements a Go fluid-dynamics solver, with dam-break simulation as its clearest user-facing workflow and cavity-flow and single-phase modes also exposed by the CLI. The CLI configures a simulation, advances it, reports diagnostics, and can save alpha-field snapshots. Solver modules cover grid/state, time stepping, momentum prediction, VOF transport, pressure projection, and Poisson solving. The command directories also contain research and diagnostic programs for convergence, advection, cavity profiles, hydrostatics, and solver performance. Internal solver connections are shown as unverified where excerpts did not establish call ownership.
Main entry points: sim.go Simulation orchestration · main.go Dam-break CLI · project.go Velocity projection · poisson.go Poisson solver
Components 22
Simulation runtime
- Dam-break CLI
cmd/dambreak/main.go - Simulation orchestration
internal/solver/sim.go - Simulation configuration
internal/solver/config.go - Grid geometry
internal/solver/grid.go - Flow fields
internal/solver/fields.go
Numerical solver
- Timestep selection
internal/solver/timestep.go - Momentum predictor
internal/solver/predictor.go - VOF transport
internal/solver/vof.go - Velocity projection
internal/solver/project.go - Poisson solver
internal/solver/poisson.go - Boundary conditions
internal/solver/bc.go - Fluid properties
internal/solver/props.go
Research workflows
- Dam-break studies
cmd/b_study/main.go - Front convergence
cmd/frontconv/main.go - Advection comparison
cmd/advcompare/main.go - Cavity studies
cmd/c_study/main.go - Taylor-Green studies
cmd/c_study2/main.go
Diagnostics and output
- Hydrostatic check
cmd/hydrotest/main.go - Poisson benchmark
cmd/poissonbench/main.go - Cavity diagnosis
cmd/cavitydiag/main.go - Long-run snapshots
cmd/longrun/main.go
Other components
- CLI user
Connections 21
- CLI user → Dam-break CLI: configures and runs
cmd/dambreak/main.go - Dam-break CLI → Simulation orchestration: creates and advances
cmd/dambreak/main.go - Simulation orchestration → Simulation configuration: uses
- Simulation orchestration → Grid geometry: uses
- Simulation orchestration → Flow fields: updates
- Simulation orchestration → Timestep selection: selects timestep
- Simulation orchestration → Momentum predictor: predicts momentum
- Simulation orchestration → VOF transport: transports interface
- Simulation orchestration → Velocity projection: projects velocity
- Velocity projection → Poisson solver: solves pressure
- Simulation orchestration → Boundary conditions: applies boundaries
- Simulation orchestration → Fluid properties: updates properties
- Dam-break studies → Simulation orchestration: runs simulations
cmd/b_study/main.go - Front convergence → Simulation orchestration: runs simulations
cmd/frontconv/main.go - Advection comparison → Simulation orchestration: compares runs
cmd/advcompare/main.go - Cavity studies → Simulation orchestration: runs cavity flow
cmd/c_study/main.go - Taylor-Green studies → Simulation orchestration: runs vortex cases
cmd/c_study2/main.go - Hydrostatic check → Simulation orchestration: checks pressure
cmd/hydrotest/main.go - Poisson benchmark → Poisson solver: benchmarks solves
cmd/poissonbench/main.go - Cavity diagnosis → Simulation orchestration: measures cavity flow
cmd/cavitydiag/main.go - Long-run snapshots → Simulation orchestration: runs and samples
cmd/longrun/main.go