# ggiraldo/openradioss architecture

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

- Interactive diagram: https://gitdiagram.com/ggiraldo/openradioss
- Repository: https://github.com/ggiraldo/openradioss

## Overview

OpenRadioss is a nonlinear dynamic finite-element simulation code. The principal workflow is to provide an input deck, have Starter read it, run the Engine, and produce results for post-processing. The tree also identifies input-model parsing, element kernels, coupling adapters, user extensions, Python integration, and H3D output as distinct capabilities. Several runtime relationships are only implied by the repository layout and README; those links are marked dashed with no evidence path because the relevant call sites were not sampled.

Main entry points: [`engine/source`](https://github.com/ggiraldo/openradioss/tree/main/engine/source) (Engine), [`starter/source`](https://github.com/ggiraldo/openradioss/tree/main/starter/source) (Starter), [`reader/source/cfgkernel/KERNEL`](https://github.com/ggiraldo/openradioss/tree/main/reader/source/cfgkernel/KERNEL) (Config kernel), [`reader/source/cfgio/MODEL_IO`](https://github.com/ggiraldo/openradioss/tree/main/reader/source/cfgio/MODEL_IO) (Model reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Input processing"]
  node_starter["Starter"]
  node_model_reader["Model reader"]
  node_config_kernel["Config kernel"]
  node_unit_manager["Units"]
  node_operator_manager["Expression operators"]
end

subgraph group_solver["Simulation"]
  node_engine["Engine"]
  node_shell_kernels["Shell kernels"]
end

subgraph group_integration["Extensions and coupling"]
  node_coupling["Coupling adapters"]
  node_rad2rad["Radioss coupling<br/>[rad2rad_c.c]"]
  node_user_hooks["User extensions<br/>[dyn_userlib.c]"]
  node_python["Python interface"]
end

subgraph group_results["Results and runtime"]
  node_file_io["Binary file I/O<br/>[write_routines.c]"]
  node_h3d_output["H3D output"]
  node_postprocessing["Post-processing tools"]
end

node_analyst(("Analyst"))

node_analyst -->|"provides deck"| node_starter
node_starter -.->|"reads models"| node_model_reader
node_model_reader -.->|"interprets configuration"| node_config_kernel
node_config_kernel -.->|"uses units"| node_unit_manager
node_config_kernel -.->|"uses operators"| node_operator_manager
node_starter -.->|"passes model"| node_engine
node_engine -.->|"uses kernels"| node_shell_kernels
node_engine -.->|"dispatches coupling"| node_coupling
node_coupling -.->|"offers adapter"| node_rad2rad
node_engine -.->|"invokes hooks"| node_user_hooks
node_engine -.->|"uses interface"| node_python
node_engine -.->|"writes data"| node_file_io
node_engine -.->|"writes results"| node_h3d_output
node_h3d_output -.->|"supplies results"| node_postprocessing

click node_starter "https://github.com/ggiraldo/openradioss/tree/main/starter/source"
click node_model_reader "https://github.com/ggiraldo/openradioss/tree/main/reader/source/cfgio/MODEL_IO"
click node_config_kernel "https://github.com/ggiraldo/openradioss/tree/main/reader/source/cfgkernel/KERNEL"
click node_unit_manager "https://github.com/ggiraldo/openradioss/blob/main/reader/source/cfgkernel/MUNITS/mu_quantity_manager.cpp"
click node_operator_manager "https://github.com/ggiraldo/openradioss/blob/main/reader/source/cfgkernel/UTILS/mv_operator_manager.cpp"
click node_engine "https://github.com/ggiraldo/openradioss/tree/main/engine/source"
click node_shell_kernels "https://github.com/ggiraldo/openradioss/tree/main/engine/source/elements/shell/coque"
click node_coupling "https://github.com/ggiraldo/openradioss/tree/main/engine/source/coupling"
click node_rad2rad "https://github.com/ggiraldo/openradioss/blob/main/engine/source/coupling/rad2rad/rad2rad_c.c"
click node_user_hooks "https://github.com/ggiraldo/openradioss/blob/main/engine/source/user_interface/dyn_userlib.c"
click node_python "https://github.com/ggiraldo/openradioss/blob/main/common_source/modules/cpp_python_funct.cpp"
click node_file_io "https://github.com/ggiraldo/openradioss/blob/main/common_source/tools/input_output/write_routines.c"
click node_h3d_output "https://github.com/ggiraldo/openradioss/tree/main/engine/source/output/h3d/h3d_build_cpp"

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_starter,node_model_reader,node_config_kernel,node_unit_manager,node_operator_manager toneBlue
class node_engine,node_shell_kernels toneAmber
class node_coupling,node_rad2rad,node_user_hooks,node_python toneMint
class node_file_io,node_h3d_output,node_postprocessing toneRose
class node_analyst toneIndigo
```

## Components

### Input processing

- [Starter](https://github.com/ggiraldo/openradioss/tree/main/starter/source): `starter/source`
- [Model reader](https://github.com/ggiraldo/openradioss/tree/main/reader/source/cfgio/MODEL_IO): `reader/source/cfgio/MODEL_IO`
- [Config kernel](https://github.com/ggiraldo/openradioss/tree/main/reader/source/cfgkernel/KERNEL): `reader/source/cfgkernel/KERNEL`
- [Units](https://github.com/ggiraldo/openradioss/blob/main/reader/source/cfgkernel/MUNITS/mu_quantity_manager.cpp): `reader/source/cfgkernel/MUNITS/mu_quantity_manager.cpp`
- [Expression operators](https://github.com/ggiraldo/openradioss/blob/main/reader/source/cfgkernel/UTILS/mv_operator_manager.cpp): `reader/source/cfgkernel/UTILS/mv_operator_manager.cpp`

### Simulation

- [Engine](https://github.com/ggiraldo/openradioss/tree/main/engine/source): `engine/source`
- [Shell kernels](https://github.com/ggiraldo/openradioss/tree/main/engine/source/elements/shell/coque): `engine/source/elements/shell/coque`

### Extensions and coupling

- [Coupling adapters](https://github.com/ggiraldo/openradioss/tree/main/engine/source/coupling): `engine/source/coupling`
- [Radioss coupling](https://github.com/ggiraldo/openradioss/blob/main/engine/source/coupling/rad2rad/rad2rad_c.c): `engine/source/coupling/rad2rad/rad2rad_c.c`
- [User extensions](https://github.com/ggiraldo/openradioss/blob/main/engine/source/user_interface/dyn_userlib.c): `engine/source/user_interface/dyn_userlib.c`
- [Python interface](https://github.com/ggiraldo/openradioss/blob/main/common_source/modules/cpp_python_funct.cpp): `common_source/modules/cpp_python_funct.cpp`

### Results and runtime

- [Binary file I/O](https://github.com/ggiraldo/openradioss/blob/main/common_source/tools/input_output/write_routines.c): `common_source/tools/input_output/write_routines.c`
- [H3D output](https://github.com/ggiraldo/openradioss/tree/main/engine/source/output/h3d/h3d_build_cpp): `engine/source/output/h3d/h3d_build_cpp`
- **Post-processing tools**

### Other components

- **Analyst**

## Connections

- Analyst → Starter: provides deck (evidence: `README.md`)
- Starter → Model reader: reads models
- Model reader → Config kernel: interprets configuration
- Config kernel → Units: uses units
- Config kernel → Expression operators: uses operators
- Starter → Engine: passes model
- Engine → Shell kernels: uses kernels
- Engine → Coupling adapters: dispatches coupling
- Coupling adapters → Radioss coupling: offers adapter
- Engine → User extensions: invokes hooks
- Engine → Python interface: uses interface
- Engine → Binary file I/O: writes data
- Engine → H3D output: writes results
- H3D output → Post-processing tools: supplies results
