# synthetik-technologies/blastfoam architecture

> Architecture diagram of the GitHub repository synthetik-technologies/blastfoam, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/synthetik-technologies/blastfoam
- Repository: https://github.com/synthetik-technologies/blastfoam

## Overview

blastFoam is an OpenFOAM-based library and solver suite for compressible, single- and multiphase flow, including detonation and airblast. The primary workflow is to run a case through a solver, which advances the flow using phase and thermodynamic models, then produces fields and diagnostics. The repository also includes interfacial closures, mesh adaptation and overset support, radiation, and solid/FSI capabilities. The README documents the product scope; source evidence is limited to the supplied excerpts and SOURCE INDEX, so uncertain solver-to-subsystem links are dashed.

Main entry points: [`applications/solvers/blastEulerFoam/blastEulerFoam.C`](https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/blastEulerFoam.C) (Euler solver), [`applications/solvers/blastEulerFoam/interfacialModels/dragModels/dragODE/dragODE.C`](https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/interfacialModels/dragModels/dragODE/dragODE.C) (Drag ODE), [`src/compressibleSystem/multiphaseCompressibleSystem/multiphaseCompressibleSystem.C`](https://github.com/synthetik-technologies/blastfoam/blob/master/src/compressibleSystem/multiphaseCompressibleSystem/multiphaseCompressibleSystem.C) (Multiphase system), [`applications/solvers/blastEulerFoam/phaseSystems/phaseSystem/phaseSystem.H`](https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/phaseSystems/phaseSystem/phaseSystem.H) (Phase system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flow["Flow solving"]
  node_blast_euler["Euler solver<br/>[blastEulerFoam.C]"]
  node_phase_system["Phase system<br/>[phaseSystem.H]"]
  node_compressible["Compressible system"]
  node_multiphase["Multiphase system"]
end

subgraph group_physics["Flow physics"]
  node_fluid_thermo["Fluid thermodynamics<br/>[fluidBlastThermo.H]"]
  node_multi_thermo["Multiphase thermo"]
  node_detonation["Detonation thermo"]
  node_interfacial["Interfacial models"]
  node_drag_ode["Drag ODE<br/>[dragODE.C]"]
  node_interfacial_pressure["Interfacial pressure"]
end

subgraph group_mesh["Mesh and numerics"]
  node_dynamic_mesh["Mesh refinement<br/>[newCellCuts.C]"]
  node_overset["Overset search<br/>[voxelMeshSearch.C]"]
  node_cell_mask["Overset cell mask<br/>[createCellMask.H]"]
end

subgraph group_coupling["Coupled capabilities"]
  node_radiation["Radiation<br/>[blastFvDOM.C]"]
  node_solid["Solid coupling<br/>[blastFluid.C]"]
  node_atmosphere["Atmosphere models<br/>[atmosphereModel.C]"]
end

subgraph group_diagnostics["Utilities and diagnostics"]
  node_probes["Blast probes<br/>[blastProbes.C]"]
  node_reconstruct["Parallel reconstruction"]
end

node_user(("Case user"))

node_user -->|"runs case"| node_blast_euler
node_blast_euler -.->|"uses phases"| node_phase_system
node_compressible -->|"specializes as"| node_multiphase
node_multiphase -->|"uses thermo"| node_multi_thermo
node_detonation -->|"extends thermo"| node_fluid_thermo
node_interfacial_pressure -->|"reads thermo"| node_fluid_thermo
node_drag_ode -->|"uses phases"| node_phase_system
node_drag_ode -->|"uses drag models"| node_interfacial
node_cell_mask -->|"queries stencil"| node_overset
node_blast_euler -.->|"may adapt mesh"| node_dynamic_mesh
node_blast_euler -.->|"may include radiation"| node_radiation
node_blast_euler -.->|"supports coupled cases"| node_solid
node_blast_euler -.->|"may use atmosphere"| node_atmosphere
node_blast_euler -.->|"may report probes"| node_probes
node_user -.->|"runs utility"| node_reconstruct

click node_blast_euler "https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/blastEulerFoam.C"
click node_phase_system "https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/phaseSystems/phaseSystem/phaseSystem.H"
click node_compressible "https://github.com/synthetik-technologies/blastfoam/blob/master/src/compressibleSystem/compressibleSystem/compressibleSystem.H"
click node_multiphase "https://github.com/synthetik-technologies/blastfoam/blob/master/src/compressibleSystem/multiphaseCompressibleSystem/multiphaseCompressibleSystem.C"
click node_fluid_thermo "https://github.com/synthetik-technologies/blastfoam/blob/master/src/thermodynamicModels/basic/fluidBlastThermo/fluidBlastThermo.H"
click node_multi_thermo "https://github.com/synthetik-technologies/blastfoam/blob/master/src/thermodynamicModels/derived/multiphaseFluidBlastThermo/multiphaseFluidBlastThermo.H"
click node_detonation "https://github.com/synthetik-technologies/blastfoam/blob/master/src/thermodynamicModels/derived/detonatingFluidBlastThermo/detonatingFluidBlastThermo.C"
click node_interfacial "https://github.com/synthetik-technologies/blastfoam/tree/master/applications/solvers/blastEulerFoam/interfacialModels"
click node_drag_ode "https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/interfacialModels/dragModels/dragODE/dragODE.C"
click node_interfacial_pressure "https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/interfacialModels/interfacialPressure/volumeAveraged/volumeAveragedInterfacialPressureModel.C"
click node_dynamic_mesh "https://github.com/synthetik-technologies/blastfoam/blob/master/src/dynamicMesh/newCellCuts/newCellCuts.C"
click node_overset "https://github.com/synthetik-technologies/blastfoam/blob/master/src/dynamicFvMesh/overset/cellCellStencil/trackingInverseDistance/voxelMeshSearch.C"
click node_cell_mask "https://github.com/synthetik-technologies/blastfoam/blob/master/src/dynamicFvMesh/overset/include/createCellMask.H"
click node_radiation "https://github.com/synthetik-technologies/blastfoam/blob/master/src/radiationModels/radiationModels/fvDOM/blastFvDOM.C"
click node_solid "https://github.com/synthetik-technologies/blastfoam/blob/master/src/solids4Foam/blastFluid.C"
click node_atmosphere "https://github.com/synthetik-technologies/blastfoam/blob/master/src/atmosphereModels/atmosphereModel/atmosphereModel.C"
click node_probes "https://github.com/synthetik-technologies/blastfoam/blob/master/src/functionObjects/blastProbes/blastProbes.C"
click node_reconstruct "https://github.com/synthetik-technologies/blastfoam/blob/master/applications/utilities/reconstructParAll/reconstructParAll.C"

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_blast_euler,node_phase_system,node_compressible,node_multiphase,node_user toneBlue
class node_fluid_thermo,node_multi_thermo,node_detonation,node_interfacial,node_drag_ode,node_interfacial_pressure toneAmber
class node_dynamic_mesh,node_overset,node_cell_mask toneMint
class node_radiation,node_solid,node_atmosphere toneRose
class node_probes,node_reconstruct toneIndigo
```

## Components

### Flow solving

- [Euler solver](https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/blastEulerFoam.C): `applications/solvers/blastEulerFoam/blastEulerFoam.C`
- [Phase system](https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/phaseSystems/phaseSystem/phaseSystem.H): `applications/solvers/blastEulerFoam/phaseSystems/phaseSystem/phaseSystem.H`
- [Compressible system](https://github.com/synthetik-technologies/blastfoam/blob/master/src/compressibleSystem/compressibleSystem/compressibleSystem.H): `src/compressibleSystem/compressibleSystem/compressibleSystem.H`
- [Multiphase system](https://github.com/synthetik-technologies/blastfoam/blob/master/src/compressibleSystem/multiphaseCompressibleSystem/multiphaseCompressibleSystem.C): `src/compressibleSystem/multiphaseCompressibleSystem/multiphaseCompressibleSystem.C`

### Flow physics

- [Fluid thermodynamics](https://github.com/synthetik-technologies/blastfoam/blob/master/src/thermodynamicModels/basic/fluidBlastThermo/fluidBlastThermo.H): `src/thermodynamicModels/basic/fluidBlastThermo/fluidBlastThermo.H`
- [Multiphase thermo](https://github.com/synthetik-technologies/blastfoam/blob/master/src/thermodynamicModels/derived/multiphaseFluidBlastThermo/multiphaseFluidBlastThermo.H): `src/thermodynamicModels/derived/multiphaseFluidBlastThermo/multiphaseFluidBlastThermo.H`
- [Detonation thermo](https://github.com/synthetik-technologies/blastfoam/blob/master/src/thermodynamicModels/derived/detonatingFluidBlastThermo/detonatingFluidBlastThermo.C): `src/thermodynamicModels/derived/detonatingFluidBlastThermo/detonatingFluidBlastThermo.C`
- [Interfacial models](https://github.com/synthetik-technologies/blastfoam/tree/master/applications/solvers/blastEulerFoam/interfacialModels): `applications/solvers/blastEulerFoam/interfacialModels`
- [Drag ODE](https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/interfacialModels/dragModels/dragODE/dragODE.C): `applications/solvers/blastEulerFoam/interfacialModels/dragModels/dragODE/dragODE.C`
- [Interfacial pressure](https://github.com/synthetik-technologies/blastfoam/blob/master/applications/solvers/blastEulerFoam/interfacialModels/interfacialPressure/volumeAveraged/volumeAveragedInterfacialPressureModel.C): `applications/solvers/blastEulerFoam/interfacialModels/interfacialPressure/volumeAveraged/volumeAveragedInterfacialPressureModel.C`

### Mesh and numerics

- [Mesh refinement](https://github.com/synthetik-technologies/blastfoam/blob/master/src/dynamicMesh/newCellCuts/newCellCuts.C): `src/dynamicMesh/newCellCuts/newCellCuts.C`
- [Overset search](https://github.com/synthetik-technologies/blastfoam/blob/master/src/dynamicFvMesh/overset/cellCellStencil/trackingInverseDistance/voxelMeshSearch.C): `src/dynamicFvMesh/overset/cellCellStencil/trackingInverseDistance/voxelMeshSearch.C`
- [Overset cell mask](https://github.com/synthetik-technologies/blastfoam/blob/master/src/dynamicFvMesh/overset/include/createCellMask.H): `src/dynamicFvMesh/overset/include/createCellMask.H`

### Coupled capabilities

- [Radiation](https://github.com/synthetik-technologies/blastfoam/blob/master/src/radiationModels/radiationModels/fvDOM/blastFvDOM.C): `src/radiationModels/radiationModels/fvDOM/blastFvDOM.C`
- [Solid coupling](https://github.com/synthetik-technologies/blastfoam/blob/master/src/solids4Foam/blastFluid.C): `src/solids4Foam/blastFluid.C`
- [Atmosphere models](https://github.com/synthetik-technologies/blastfoam/blob/master/src/atmosphereModels/atmosphereModel/atmosphereModel.C): `src/atmosphereModels/atmosphereModel/atmosphereModel.C`

### Utilities and diagnostics

- [Blast probes](https://github.com/synthetik-technologies/blastfoam/blob/master/src/functionObjects/blastProbes/blastProbes.C): `src/functionObjects/blastProbes/blastProbes.C`
- [Parallel reconstruction](https://github.com/synthetik-technologies/blastfoam/blob/master/applications/utilities/reconstructParAll/reconstructParAll.C): `applications/utilities/reconstructParAll/reconstructParAll.C`

### Other components

- **Case user**

## Connections

- Case user → Euler solver: runs case (evidence: `README.md`)
- Euler solver → Phase system: uses phases
- Compressible system → Multiphase system: specializes as
- Multiphase system → Multiphase thermo: uses thermo
- Detonation thermo → Fluid thermodynamics: extends thermo (evidence: `src/thermodynamicModels/derived/detonatingFluidBlastThermo/detonatingFluidBlastThermo.C`)
- Interfacial pressure → Fluid thermodynamics: reads thermo (evidence: `applications/solvers/blastEulerFoam/interfacialModels/interfacialPressure/volumeAveraged/volumeAveragedInterfacialPressureModel.C`)
- Drag ODE → Phase system: uses phases
- Drag ODE → Interfacial models: uses drag models (evidence: `applications/solvers/blastEulerFoam/interfacialModels/dragModels/dragODE/dragODE.C`)
- Overset cell mask → Overset search: queries stencil
- Euler solver → Mesh refinement: may adapt mesh
- Euler solver → Radiation: may include radiation
- Euler solver → Solid coupling: supports coupled cases (evidence: `README.md`)
- Euler solver → Atmosphere models: may use atmosphere
- Euler solver → Blast probes: may report probes
- Case user → Parallel reconstruction: runs utility
