# kratosmultiphysics/kratos architecture

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

- Interactive diagram: https://gitdiagram.com/kratosmultiphysics/kratos
- Repository: https://github.com/kratosmultiphysics/kratos

## Overview

Kratos is a C++ multiphysics framework with an extensive Python interface; application packages extend its shared simulation core. The typical user workflow is to prepare model/input data, select a domain application and solving strategy, run a simulation, and inspect output. The README documents this workflow broadly, not a single runtime entry point, so the workflow links below are documented at the framework level. The sampled source supports the controller and Python-binding details; unsampled application internals are represented only at their tree paths.

Main entry points: [`kratos/includes/kratos_application.h`](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/kratos_application.h) (Kratos core), [`applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/buffer.hpp`](https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/buffer.hpp) (Asio buffers), [`applications/WindEngineeringApplication/custom_python/wind_engineering_python_application.cpp`](https://github.com/kratosmultiphysics/kratos/blob/master/applications/WindEngineeringApplication/custom_python/wind_engineering_python_application.cpp) (Wind Python bindings), [`kratos/controllers/controller.h`](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/controllers/controller.h) (Controller API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Simulation core"]
  node_core_framework["Kratos core"]
  node_model["Model data<br/>[model_part.h]"]
  node_solver["Solving strategies<br/>[element.h]"]
  node_parallel["Parallel runtime<br/>[mpi_manager.cpp]"]
  node_variables["Variable definitions<br/>[variables.h]"]
  node_node["Mesh nodes<br/>[node.h]"]
  node_parameters["Runtime parameters"]
  node_define["Core definitions<br/>[define.h]"]
  node_variable_utils["Variable utilities<br/>[variable_utils.h]"]
end

subgraph group_apps["Domain applications"]
  node_dem["Particle simulation"]
  node_fluid["Fluid dynamics"]
  node_fsi["Fluid-structure interaction"]
  node_structural["Structural mechanics"]
  node_constitutive["Material models"]
  node_contact["Contact mechanics"]
  node_wind["Wind engineering"]
  node_wind_python["Wind Python bindings"]
end

subgraph group_workflow["Workflow and control"]
  node_inputs["Model and input"]
  node_python["Python interface"]
  node_controller["Controller API<br/>[controller.h]"]
  node_output_controller["Output controller"]
  node_output_process["Controlled output"]
end

subgraph group_cosim["Co-simulation"]
  node_cosim["Co-simulation services"]
  node_cosimio["CoSimIO transport"]
  node_asio_buffer["Asio buffers<br/>[buffer.hpp]"]
  node_asio_config["Asio configuration<br/>[config.hpp]"]
  node_asio_options["Compiler options<br/>[push_options.hpp]"]
  node_asio_pop["Restore options<br/>[pop_options.hpp]"]
end

node_analyst(("Simulation user"))

node_analyst -.->|"prepares model"| node_inputs
node_analyst -->|"uses interface"| node_python
node_inputs -.->|"configures simulation"| node_core_framework
node_python -->|"accesses framework"| node_core_framework
node_core_framework -.->|"provides model data"| node_model
node_core_framework -->|"provides solving"| node_solver
node_core_framework -->|"supports parallelism"| node_parallel
node_core_framework -->|"hosts plug-in"| node_dem
node_core_framework -->|"hosts plug-in"| node_fluid
node_core_framework -->|"hosts plug-in"| node_fsi
node_core_framework -->|"hosts plug-in"| node_structural
node_core_framework -->|"hosts plug-in"| node_constitutive
node_core_framework -->|"hosts plug-in"| node_contact
node_python -->|"binds application"| node_wind_python
node_wind_python -->|"registers application"| node_wind
node_python -->|"exposes controllers"| node_controller
node_controller -->|"specializes as"| node_output_controller
node_output_process -.->|"evaluates control"| node_output_controller
node_cosim -.->|"includes communication"| node_cosimio
node_asio_buffer -->|"uses definitions"| node_asio_config
node_asio_buffer -->|"pushes options"| node_asio_options
node_asio_buffer -->|"restores options"| node_asio_pop

click node_core_framework "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/kratos_application.h"
click node_model "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/model_part.h"
click node_solver "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/element.h"
click node_parallel "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/mpi/sources/mpi_manager.cpp"
click node_controller "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/controllers/controller.h"
click node_output_controller "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/controllers/output_controller.cpp"
click node_output_process "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/python_scripts/output_process_with_controller.py"
click node_dem "https://github.com/kratosmultiphysics/kratos/tree/master/applications/DEMApplication"
click node_fluid "https://github.com/kratosmultiphysics/kratos/tree/master/applications/FluidDynamicsApplication"
click node_fsi "https://github.com/kratosmultiphysics/kratos/tree/master/applications/FSIApplication"
click node_structural "https://github.com/kratosmultiphysics/kratos/tree/master/applications/StructuralMechanicsApplication"
click node_constitutive "https://github.com/kratosmultiphysics/kratos/tree/master/applications/ConstitutiveLawsApplication"
click node_contact "https://github.com/kratosmultiphysics/kratos/tree/master/applications/ContactStructuralMechanicsApplication"
click node_wind "https://github.com/kratosmultiphysics/kratos/blob/master/applications/WindEngineeringApplication/wind_engineering_application.h"
click node_wind_python "https://github.com/kratosmultiphysics/kratos/blob/master/applications/WindEngineeringApplication/custom_python/wind_engineering_python_application.cpp"
click node_cosim "https://github.com/kratosmultiphysics/kratos/tree/master/applications/CoSimulationApplication"
click node_cosimio "https://github.com/kratosmultiphysics/kratos/tree/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/co_sim_io"
click node_asio_buffer "https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/buffer.hpp"
click node_asio_config "https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/config.hpp"
click node_asio_options "https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/push_options.hpp"
click node_asio_pop "https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/pop_options.hpp"
click node_variables "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/variables.h"
click node_node "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/node.h"
click node_parameters "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/kratos_parameters.h"
click node_define "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/define.h"
click node_variable_utils "https://github.com/kratosmultiphysics/kratos/blob/master/kratos/utilities/variable_utils.h"

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_core_framework,node_model,node_solver,node_parallel,node_variables,node_node,node_parameters,node_define,node_variable_utils,node_analyst toneBlue
class node_dem,node_fluid,node_fsi,node_structural,node_constitutive,node_contact,node_wind,node_wind_python toneAmber
class node_inputs,node_python,node_controller,node_output_controller,node_output_process toneMint
class node_cosim,node_cosimio,node_asio_buffer,node_asio_config,node_asio_options,node_asio_pop toneRose
```

## Components

### Simulation core

- [Kratos core](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/kratos_application.h): `kratos/includes/kratos_application.h`
- [Model data](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/model_part.h): `kratos/includes/model_part.h`
- [Solving strategies](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/element.h): `kratos/includes/element.h`
- [Parallel runtime](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/mpi/sources/mpi_manager.cpp): `kratos/mpi/sources/mpi_manager.cpp`
- [Variable definitions](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/variables.h): `kratos/includes/variables.h`
- [Mesh nodes](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/node.h): `kratos/includes/node.h`
- [Runtime parameters](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/kratos_parameters.h): `kratos/includes/kratos_parameters.h`
- [Core definitions](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/includes/define.h): `kratos/includes/define.h`
- [Variable utilities](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/utilities/variable_utils.h): `kratos/utilities/variable_utils.h`

### Domain applications

- [Particle simulation](https://github.com/kratosmultiphysics/kratos/tree/master/applications/DEMApplication): `applications/DEMApplication`
- [Fluid dynamics](https://github.com/kratosmultiphysics/kratos/tree/master/applications/FluidDynamicsApplication): `applications/FluidDynamicsApplication`
- [Fluid-structure interaction](https://github.com/kratosmultiphysics/kratos/tree/master/applications/FSIApplication): `applications/FSIApplication`
- [Structural mechanics](https://github.com/kratosmultiphysics/kratos/tree/master/applications/StructuralMechanicsApplication): `applications/StructuralMechanicsApplication`
- [Material models](https://github.com/kratosmultiphysics/kratos/tree/master/applications/ConstitutiveLawsApplication): `applications/ConstitutiveLawsApplication`
- [Contact mechanics](https://github.com/kratosmultiphysics/kratos/tree/master/applications/ContactStructuralMechanicsApplication): `applications/ContactStructuralMechanicsApplication`
- [Wind engineering](https://github.com/kratosmultiphysics/kratos/blob/master/applications/WindEngineeringApplication/wind_engineering_application.h): `applications/WindEngineeringApplication/wind_engineering_application.h`
- [Wind Python bindings](https://github.com/kratosmultiphysics/kratos/blob/master/applications/WindEngineeringApplication/custom_python/wind_engineering_python_application.cpp): `applications/WindEngineeringApplication/custom_python/wind_engineering_python_application.cpp`

### Workflow and control

- **Model and input**
- **Python interface**
- [Controller API](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/controllers/controller.h): `kratos/controllers/controller.h`
- [Output controller](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/controllers/output_controller.cpp): `kratos/controllers/output_controller.cpp`
- [Controlled output](https://github.com/kratosmultiphysics/kratos/blob/master/kratos/python_scripts/output_process_with_controller.py): `kratos/python_scripts/output_process_with_controller.py`

### Co-simulation

- [Co-simulation services](https://github.com/kratosmultiphysics/kratos/tree/master/applications/CoSimulationApplication): `applications/CoSimulationApplication`
- [CoSimIO transport](https://github.com/kratosmultiphysics/kratos/tree/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/co_sim_io): `applications/CoSimulationApplication/custom_external_libraries/CoSimIO/co_sim_io`
- [Asio buffers](https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/buffer.hpp): `applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/buffer.hpp`
- [Asio configuration](https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/config.hpp): `applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/config.hpp`
- [Compiler options](https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/push_options.hpp): `applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/push_options.hpp`
- [Restore options](https://github.com/kratosmultiphysics/kratos/blob/master/applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/pop_options.hpp): `applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/detail/pop_options.hpp`

### Other components

- **Simulation user**

## Connections

- Simulation user → Model and input: prepares model
- Simulation user → Python interface: uses interface (evidence: `README.md`)
- Model and input → Kratos core: configures simulation
- Python interface → Kratos core: accesses framework (evidence: `README.md`)
- Kratos core → Model data: provides model data
- Kratos core → Solving strategies: provides solving (evidence: `README.md`)
- Kratos core → Parallel runtime: supports parallelism (evidence: `README.md`)
- Kratos core → Particle simulation: hosts plug-in (evidence: `README.md`)
- Kratos core → Fluid dynamics: hosts plug-in (evidence: `README.md`)
- Kratos core → Fluid-structure interaction: hosts plug-in (evidence: `README.md`)
- Kratos core → Structural mechanics: hosts plug-in (evidence: `README.md`)
- Kratos core → Material models: hosts plug-in (evidence: `README.md`)
- Kratos core → Contact mechanics: hosts plug-in (evidence: `README.md`)
- Python interface → Wind Python bindings: binds application (evidence: `applications/WindEngineeringApplication/custom_python/wind_engineering_python_application.cpp`)
- Wind Python bindings → Wind engineering: registers application (evidence: `applications/WindEngineeringApplication/custom_python/wind_engineering_python_application.cpp`)
- Python interface → Controller API: exposes controllers
- Controller API → Output controller: specializes as
- Controlled output → Output controller: evaluates control
- Co-simulation services → CoSimIO transport: includes communication
- Asio buffers → Asio configuration: uses definitions (evidence: `applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/buffer.hpp`)
- Asio buffers → Compiler options: pushes options (evidence: `applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/buffer.hpp`)
- Asio buffers → Restore options: restores options (evidence: `applications/CoSimulationApplication/custom_external_libraries/CoSimIO/external_libraries/asio/include/asio/buffer.hpp`)
