# sophierckr/meltpooldg architecture

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

- Interactive diagram: https://gitdiagram.com/sophierckr/meltpooldg
- Repository: https://github.com/sophierckr/meltpooldg

## Overview

MeltPoolDG is research simulation software for metal additive manufacturing. Users select a simulation case and run an application that advances a coupled physical model and writes simulation output. The repository provides separate applications for advection–diffusion, heat transfer, level sets, reinitialization, melt-pool dynamics, and radiative transport, backed by reusable FEM, multiphase, phase-change, particle, and time-integration components. The map emphasizes these domain capabilities rather than build and test infrastructure. Some subsystem links are dashed because their implementation was not sampled; documented product features are retained where source-level wiring is unavailable.

Main entry points: [`applications/mp-melt-pool/melt_pool_application.cpp`](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-melt-pool/melt_pool_application.cpp) (Melt-pool runner), [`applications/mp-heat-transfer/heat_transfer_application.cpp`](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-heat-transfer/heat_transfer_application.cpp) (Heat runner), [`include/meltpooldg/level_set/level_set_operation.hpp`](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/level_set/level_set_operation.hpp) (Level-set methods), [`applications/mp-level-set/level_set_application.cpp`](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-level-set/level_set_application.cpp) (Level-set runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Simulation applications"]
  node_case["Case setup<br/>[case_factory.hpp]"]
  node_meltapp["Melt-pool runner"]
  node_heatapp["Heat runner"]
  node_lsapp["Level-set runner"]
  node_reinitapp["Reinitialization runner"]
  node_advapp["Advection runner"]
  node_radapp["Radiation runner"]
end

subgraph group_physics["Thermo-fluid physics"]
  node_flow["Flow solver"]
  node_heat["Heat solver"]
  node_phase["Phase change"]
  node_radiation["Radiative transport"]
end

subgraph group_interfaces["Interfaces and particles"]
  node_levelset["Level-set methods"]
  node_cutfem["CutFEM interfaces<br/>[cut_data.hpp]"]
  node_particles["Powder particles<br/>[particle.hpp]"]
  node_fsi["Fluid structure coupling"]
end

subgraph group_numerics["Numerical methods"]
  node_time["Time integrators"]
  node_linear["Linear solvers<br/>[linear_solver.hpp]"]
  node_fem["CG/DG FEM"]
  node_amr["Adaptive mesh<br/>[amr.hpp]"]
end

subgraph group_results["Output and analysis"]
  node_output["Post-processing<br/>[postprocessor.hpp]"]
  node_state["Simulation state"]
end

node_user(("Simulation user"))

node_user -->|"starts run"| node_meltapp
node_user -->|"starts run"| node_heatapp
node_user -->|"starts run"| node_lsapp
node_user -->|"starts run"| node_reinitapp
node_user -->|"starts run"| node_advapp
node_user -->|"starts run"| node_radapp
node_meltapp -->|"computes mass flux"| node_phase
node_meltapp -->|"sets melt front"| node_levelset
node_meltapp -->|"sets flow state"| node_flow
node_heatapp -->|"computes heat source"| node_heat
node_radapp -->|"solves transport"| node_radiation
node_meltapp -.->|"couples temperature"| node_heat
node_meltapp -.->|"models powder"| node_particles
node_flow -.->|"couples structure"| node_fsi
node_meltapp -.->|"uses interface cuts"| node_cutfem
node_lsapp -.->|"advances interface"| node_levelset
node_reinitapp -.->|"reinitializes field"| node_levelset
node_advapp -->|"applies DG operator"| node_fem
node_meltapp -.->|"advances steps"| node_time
node_heatapp -.->|"solves system"| node_linear
node_meltapp -.->|"adapts mesh"| node_amr
node_meltapp -.->|"writes results"| node_output
node_case -.->|"configures state"| node_state

click node_case "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/core/case_factory.hpp"
click node_meltapp "https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-melt-pool/melt_pool_application.cpp"
click node_heatapp "https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-heat-transfer/heat_transfer_application.cpp"
click node_lsapp "https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-level-set/level_set_application.cpp"
click node_reinitapp "https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-reinit/reinitialization_application.cpp"
click node_advapp "https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-advec-diff/advection_diffusion_application.cpp"
click node_radapp "https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-radiative-transport/radiative_transport_application.cpp"
click node_flow "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/compressible_flow/multiphase_operator.hpp"
click node_heat "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/heat/heat_operation_base.hpp"
click node_phase "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/phase_change/evaporation_operation.hpp"
click node_radiation "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/radiative_transport/radiative_transport_operation.hpp"
click node_levelset "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/level_set/level_set_operation.hpp"
click node_cutfem "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/cut/cut_data.hpp"
click node_particles "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/particles/particle.hpp"
click node_fsi "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/fluid_structure_interaction/brinkman_penalization.hpp"
click node_time "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/time_integration/time_integrator_base.hpp"
click node_linear "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/linear_algebra/linear_solver.hpp"
click node_fem "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/utilities/dg_generic_convection_diffusion_worker.hpp"
click node_amr "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/utilities/amr.hpp"
click node_output "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/post_processing/postprocessor.hpp"
click node_state "https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/core/simulation_case_base.hpp"

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_case,node_meltapp,node_heatapp,node_lsapp,node_reinitapp,node_advapp,node_radapp,node_user toneBlue
class node_flow,node_heat,node_phase,node_radiation toneAmber
class node_levelset,node_cutfem,node_particles,node_fsi toneMint
class node_time,node_linear,node_fem,node_amr toneRose
class node_output,node_state toneIndigo
```

## Components

### Simulation applications

- [Case setup](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/core/case_factory.hpp): `include/meltpooldg/core/case_factory.hpp`
- [Melt-pool runner](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-melt-pool/melt_pool_application.cpp): `applications/mp-melt-pool/melt_pool_application.cpp`
- [Heat runner](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-heat-transfer/heat_transfer_application.cpp): `applications/mp-heat-transfer/heat_transfer_application.cpp`
- [Level-set runner](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-level-set/level_set_application.cpp): `applications/mp-level-set/level_set_application.cpp`
- [Reinitialization runner](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-reinit/reinitialization_application.cpp): `applications/mp-reinit/reinitialization_application.cpp`
- [Advection runner](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-advec-diff/advection_diffusion_application.cpp): `applications/mp-advec-diff/advection_diffusion_application.cpp`
- [Radiation runner](https://github.com/sophierckr/meltpooldg/blob/main/applications/mp-radiative-transport/radiative_transport_application.cpp): `applications/mp-radiative-transport/radiative_transport_application.cpp`

### Thermo-fluid physics

- [Flow solver](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/compressible_flow/multiphase_operator.hpp): `include/meltpooldg/compressible_flow/multiphase_operator.hpp`
- [Heat solver](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/heat/heat_operation_base.hpp): `include/meltpooldg/heat/heat_operation_base.hpp`
- [Phase change](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/phase_change/evaporation_operation.hpp): `include/meltpooldg/phase_change/evaporation_operation.hpp`
- [Radiative transport](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/radiative_transport/radiative_transport_operation.hpp): `include/meltpooldg/radiative_transport/radiative_transport_operation.hpp`

### Interfaces and particles

- [Level-set methods](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/level_set/level_set_operation.hpp): `include/meltpooldg/level_set/level_set_operation.hpp`
- [CutFEM interfaces](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/cut/cut_data.hpp): `include/meltpooldg/cut/cut_data.hpp`
- [Powder particles](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/particles/particle.hpp): `include/meltpooldg/particles/particle.hpp`
- [Fluid structure coupling](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/fluid_structure_interaction/brinkman_penalization.hpp): `include/meltpooldg/fluid_structure_interaction/brinkman_penalization.hpp`

### Numerical methods

- [Time integrators](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/time_integration/time_integrator_base.hpp): `include/meltpooldg/time_integration/time_integrator_base.hpp`
- [Linear solvers](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/linear_algebra/linear_solver.hpp): `include/meltpooldg/linear_algebra/linear_solver.hpp`
- [CG/DG FEM](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/utilities/dg_generic_convection_diffusion_worker.hpp): `include/meltpooldg/utilities/dg_generic_convection_diffusion_worker.hpp`
- [Adaptive mesh](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/utilities/amr.hpp): `include/meltpooldg/utilities/amr.hpp`

### Output and analysis

- [Post-processing](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/post_processing/postprocessor.hpp): `include/meltpooldg/post_processing/postprocessor.hpp`
- [Simulation state](https://github.com/sophierckr/meltpooldg/blob/main/include/meltpooldg/core/simulation_case_base.hpp): `include/meltpooldg/core/simulation_case_base.hpp`

### Other components

- **Simulation user**

## Connections

- Simulation user → Melt-pool runner: starts run (evidence: `applications/mp-melt-pool/melt_pool_application.cpp`)
- Simulation user → Heat runner: starts run (evidence: `applications/mp-heat-transfer/heat_transfer_application.cpp`)
- Simulation user → Level-set runner: starts run (evidence: `applications/mp-level-set/level_set_application.cpp`)
- Simulation user → Reinitialization runner: starts run (evidence: `applications/mp-reinit/reinitialization_application.cpp`)
- Simulation user → Advection runner: starts run (evidence: `applications/mp-advec-diff/advection_diffusion_application.cpp`)
- Simulation user → Radiation runner: starts run (evidence: `applications/mp-radiative-transport/radiative_transport_application.cpp`)
- Melt-pool runner → Phase change: computes mass flux (evidence: `applications/mp-melt-pool/melt_pool_application.cpp`)
- Melt-pool runner → Level-set methods: sets melt front (evidence: `applications/mp-melt-pool/melt_pool_application.cpp`)
- Melt-pool runner → Flow solver: sets flow state (evidence: `applications/mp-melt-pool/melt_pool_application.cpp`)
- Heat runner → Heat solver: computes heat source (evidence: `applications/mp-heat-transfer/heat_transfer_application.cpp`)
- Radiation runner → Radiative transport: solves transport (evidence: `applications/mp-radiative-transport/radiative_transport_application.cpp`)
- Melt-pool runner → Heat solver: couples temperature
- Melt-pool runner → Powder particles: models powder
- Flow solver → Fluid structure coupling: couples structure
- Melt-pool runner → CutFEM interfaces: uses interface cuts
- Level-set runner → Level-set methods: advances interface
- Reinitialization runner → Level-set methods: reinitializes field
- Advection runner → CG/DG FEM: applies DG operator (evidence: `applications/mp-advec-diff/advection_diffusion_application.cpp`)
- Melt-pool runner → Time integrators: advances steps
- Heat runner → Linear solvers: solves system
- Melt-pool runner → Adaptive mesh: adapts mesh
- Melt-pool runner → Post-processing: writes results
- Case setup → Simulation state: configures state
