# rrivess/single-bubble-rise-in-liquid-metals architecture

> Architecture diagram of the GitHub repository rrivess/single-bubble-rise-in-liquid-metals, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rrivess/single-bubble-rise-in-liquid-metals
- Repository: https://github.com/rrivess/single-bubble-rise-in-liquid-metals

## Overview

This is a reproducible OpenFOAM v2012 validation case for a nitrogen bubble rising in stagnant liquid mercury. The user launches the case workflow, which runs the documented interIsoFoam simulation using initial fields, physical-model settings, and mesh and numerical controls. The README identifies the adaptive-mesh-refinement library as a runtime requirement. No source excerpts or script contents were provided, so links between individual case files and the solver are shown as unverified rather than inferred as confirmed calls.

Main entry points: [`Allrun`](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/Allrun) (Run workflow), [`0.orig`](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/tree/main/0.orig) (Initial fields), [`constant/transportProperties`](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/constant/transportProperties) (Transport properties), [`constant/turbulenceProperties`](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/constant/turbulenceProperties) (Turbulence settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_run["Case execution"]
  node_allrun["Run workflow"]
  node_solver["interIsoFoam"]
end

subgraph group_initial["Initial fields"]
  node_initial_fields["Initial fields<br/>[0.orig]"]
end

subgraph group_physics["Physical models"]
  node_transport["Transport properties"]
  node_turbulence["Turbulence settings"]
end

subgraph group_setup["Mesh and numerics"]
  node_dynamic_mesh["Dynamic mesh"]
  node_mesh_controls["Mesh generation"]
  node_block_mesh["Block mesh"]
  node_solver_controls["Numerical controls"]
  node_schemes["Finite-volume schemes"]
  node_solution["Solution settings"]
end

node_user(("Case user"))
node_amr["AMR library"]

node_user -->|"runs"| node_allrun
node_allrun -->|"executes workflow"| node_solver
node_solver -.->|"uses fields"| node_initial_fields
node_solver -.->|"uses properties"| node_transport
node_solver -.->|"uses model settings"| node_turbulence
node_solver -.->|"uses mesh settings"| node_dynamic_mesh
node_solver -.->|"uses mesh configuration"| node_mesh_controls
node_solver -.->|"uses mesh configuration"| node_block_mesh
node_solver -.->|"uses controls"| node_solver_controls
node_solver -.->|"uses schemes"| node_schemes
node_solver -.->|"uses settings"| node_solution
node_solver -.->|"requires library"| node_amr

click node_allrun "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/Allrun"
click node_initial_fields "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/tree/main/0.orig"
click node_transport "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/constant/transportProperties"
click node_turbulence "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/constant/turbulenceProperties"
click node_dynamic_mesh "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/constant/dynamicMeshDict"
click node_mesh_controls "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/snappyHexMeshDict"
click node_block_mesh "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/blockMeshDict"
click node_solver_controls "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/controlDict"
click node_schemes "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/fvSchemes"
click node_solution "https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/fvSolution"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_allrun,node_solver,node_user toneBlue
class node_initial_fields toneAmber
class node_transport,node_turbulence toneMint
class node_dynamic_mesh,node_mesh_controls,node_block_mesh,node_solver_controls,node_schemes,node_solution toneRose
class node_amr toneIndigo
```

## Components

### Case execution

- [Run workflow](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/Allrun): `Allrun`
- **interIsoFoam**

### Initial fields

- [Initial fields](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/tree/main/0.orig): `0.orig`

### Physical models

- [Transport properties](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/constant/transportProperties): `constant/transportProperties`
- [Turbulence settings](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/constant/turbulenceProperties): `constant/turbulenceProperties`

### Mesh and numerics

- [Dynamic mesh](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/constant/dynamicMeshDict): `constant/dynamicMeshDict`
- [Mesh generation](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/snappyHexMeshDict): `system/snappyHexMeshDict`
- [Block mesh](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/blockMeshDict): `system/blockMeshDict`
- [Numerical controls](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/controlDict): `system/controlDict`
- [Finite-volume schemes](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/fvSchemes): `system/fvSchemes`
- [Solution settings](https://github.com/rrivess/single-bubble-rise-in-liquid-metals/blob/main/system/fvSolution): `system/fvSolution`

### Other components

- **Case user**
- **AMR library**

## Connections

- Case user → Run workflow: runs (evidence: `README.md`)
- Run workflow → interIsoFoam: executes workflow (evidence: `README.md`)
- interIsoFoam → Initial fields: uses fields
- interIsoFoam → Transport properties: uses properties
- interIsoFoam → Turbulence settings: uses model settings
- interIsoFoam → Dynamic mesh: uses mesh settings
- interIsoFoam → Mesh generation: uses mesh configuration
- interIsoFoam → Block mesh: uses mesh configuration
- interIsoFoam → Numerical controls: uses controls
- interIsoFoam → Finite-volume schemes: uses schemes
- interIsoFoam → Solution settings: uses settings
- interIsoFoam → AMR library: requires library (evidence: `README.md`)
