# suacayipkisi/anafinen architecture

> Architecture diagram of the GitHub repository suacayipkisi/anafinen, 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/suacayipkisi/anafinen
- Repository: https://github.com/suacayipkisi/anafinen

## Overview

ANAFINEN is a 3D finite-element analysis engine with GUI and CLI front ends. Users create or load truss and beam/frame models, assign materials, sections, supports and loads, run linear-static solves, inspect results and diagrams, and import or export model files. The GUI and CLI share model state through a bridge; the calculation layer contains distinct truss and beam solvers, with solver backends and libraries supporting those workflows. The README documents major capabilities; unsampled subsystem links are shown only where it describes the relationship, while source-level links reflect the excerpts.

Main entry points: [`src/gui/gui.cpp`](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/gui.cpp) (GUI workspace), [`src/bridge/generalStatus.cpp`](https://github.com/suacayipkisi/anafinen/blob/main/src/bridge/generalStatus.cpp) (Shared model bridge), [`src/gui/panels/modelTree.cpp`](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/modelTree.cpp) (Model editors), [`src/cli/commands/commandTable.cpp`](https://github.com/suacayipkisi/anafinen/blob/main/src/cli/commands/commandTable.cpp) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontends["User interfaces"]
  node_gui["GUI workspace<br/>[gui.cpp]"]
  node_cli["CLI commands<br/>[commandTable.cpp]"]
  node_session["CLI session<br/>[session.hpp]"]
  node_model_ui["Model editors<br/>[modelTree.cpp]"]
  node_result_ui["Result views"]
  node_terminal["GUI log terminal<br/>[logTerminal.hpp]"]
end

subgraph group_modeling["Modeling and data"]
  node_bridge["Shared model bridge<br/>[generalStatus.cpp]"]
  node_materials_ui["Material editor"]
  node_sections_ui["Section editor<br/>[sectionHandler.cpp]"]
  node_material_library["Material library"]
  node_beam_library["Beam model library<br/>[beamLibrary.cpp]"]
  node_model_io["Mesh model<br/>[meshModel.hpp]"]
end

subgraph group_analysis["Analysis engine"]
  node_truss_worker["Truss solve worker<br/>[trussWorker.cpp]"]
  node_truss_solver["Truss solver<br/>[trussSolver.cpp]"]
  node_beam_solver["Beam solver<br/>[beamSolver.cpp]"]
  node_solver_backends["Solver backends<br/>[solver_referee.cpp]"]
  node_beam_results["Beam diagrams<br/>[beamDiagrams.cpp]"]
end

subgraph group_io["File exchange"]
  node_io_service["Async I/O service<br/>[ioService.cpp]"]
  node_mesh_io["Mesh format I/O<br/>[meshIo.hpp]"]
end

subgraph group_support["Shared services"]
  node_logger["Logging<br/>[anaf_info.hpp]"]
  node_numerics["Numerical methods"]
  node_gpu["GPU selection<br/>[gpuSelection.cpp]"]
end

node_user(("Engineer"))

node_user -->|"uses"| node_gui
node_user -->|"uses"| node_cli
node_gui -->|"initializes"| node_bridge
node_gui -.->|"edits models"| node_model_ui
node_gui -.->|"shows results"| node_result_ui
node_gui -->|"displays logs"| node_terminal
node_cli -->|"uses state"| node_session
node_cli -->|"shares models"| node_bridge
node_model_ui -.->|"edits state"| node_bridge
node_materials_ui -->|"adds materials"| node_bridge
node_sections_ui -->|"adds sections"| node_bridge
node_bridge -.->|"loads materials"| node_material_library
node_beam_library -.->|"provides models"| node_model_ui
node_model_ui -.->|"starts solve"| node_truss_worker
node_truss_worker -->|"calls solver"| node_truss_solver
node_truss_worker -->|"publishes results"| node_bridge
node_model_ui -.->|"runs analysis"| node_beam_solver
node_beam_solver -.->|"uses solvers"| node_solver_backends
node_beam_solver -.->|"computes diagrams"| node_beam_results
node_result_ui -.->|"reads results"| node_bridge
node_cli -.->|"imports exports"| node_io_service
node_io_service -->|"calls read write"| node_mesh_io
node_mesh_io -.->|"reads writes"| node_model_io
node_gui -->|"sets log sink"| node_logger
node_beam_solver -.->|"uses methods"| node_numerics
node_gui -.->|"selects graphics GPU"| node_gpu

click node_gui "https://github.com/suacayipkisi/anafinen/blob/main/src/gui/gui.cpp"
click node_cli "https://github.com/suacayipkisi/anafinen/blob/main/src/cli/commands/commandTable.cpp"
click node_session "https://github.com/suacayipkisi/anafinen/blob/main/src/cli/session.hpp"
click node_model_ui "https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/modelTree.cpp"
click node_result_ui "https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/beam/beamDiagramPanel.cpp"
click node_terminal "https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/logTerminal.hpp"
click node_bridge "https://github.com/suacayipkisi/anafinen/blob/main/src/bridge/generalStatus.cpp"
click node_materials_ui "https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/materialHandler.cpp"
click node_sections_ui "https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/beam/sectionHandler.cpp"
click node_material_library "https://github.com/suacayipkisi/anafinen/blob/main/src/material/materialLibrary.cpp"
click node_beam_library "https://github.com/suacayipkisi/anafinen/blob/main/src/objectCalcs/beam/beamTypes/beamLibrary.cpp"
click node_model_io "https://github.com/suacayipkisi/anafinen/blob/main/src/io/model/meshModel.hpp"
click node_truss_worker "https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/truss/trussWorker.cpp"
click node_truss_solver "https://github.com/suacayipkisi/anafinen/blob/main/src/objectCalcs/truss_1D/trussEngine/trussSolver.cpp"
click node_beam_solver "https://github.com/suacayipkisi/anafinen/blob/main/src/objectCalcs/beam/beamEngine/beamSolver.cpp"
click node_solver_backends "https://github.com/suacayipkisi/anafinen/blob/main/src/solvers/solver_referee.cpp"
click node_beam_results "https://github.com/suacayipkisi/anafinen/blob/main/src/objectCalcs/beam/beamEngine/beamDiagrams.cpp"
click node_io_service "https://github.com/suacayipkisi/anafinen/blob/main/src/io/service/ioService.cpp"
click node_mesh_io "https://github.com/suacayipkisi/anafinen/blob/main/src/io/meshIo.hpp"
click node_logger "https://github.com/suacayipkisi/anafinen/blob/main/src/log/anaf_info.hpp"
click node_numerics "https://github.com/suacayipkisi/anafinen/blob/main/src/common/numericalMethods/rootsOfEquation.cpp"
click node_gpu "https://github.com/suacayipkisi/anafinen/blob/main/src/platform/gpuSelection.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_gui,node_cli,node_session,node_model_ui,node_result_ui,node_terminal toneBlue
class node_bridge,node_materials_ui,node_sections_ui,node_material_library,node_beam_library,node_model_io toneAmber
class node_truss_worker,node_truss_solver,node_beam_solver,node_solver_backends,node_beam_results toneMint
class node_io_service,node_mesh_io toneRose
class node_logger,node_numerics,node_gpu,node_user toneIndigo
```

## Components

### User interfaces

- [GUI workspace](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/gui.cpp): `src/gui/gui.cpp`
- [CLI commands](https://github.com/suacayipkisi/anafinen/blob/main/src/cli/commands/commandTable.cpp): `src/cli/commands/commandTable.cpp`
- [CLI session](https://github.com/suacayipkisi/anafinen/blob/main/src/cli/session.hpp): `src/cli/session.hpp`
- [Model editors](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/modelTree.cpp): `src/gui/panels/modelTree.cpp`
- [Result views](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/beam/beamDiagramPanel.cpp): `src/gui/panels/beam/beamDiagramPanel.cpp`
- [GUI log terminal](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/logTerminal.hpp): `src/gui/panels/logTerminal.hpp`

### Modeling and data

- [Shared model bridge](https://github.com/suacayipkisi/anafinen/blob/main/src/bridge/generalStatus.cpp): `src/bridge/generalStatus.cpp`
- [Material editor](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/materialHandler.cpp): `src/gui/panels/materialHandler.cpp`
- [Section editor](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/beam/sectionHandler.cpp): `src/gui/panels/beam/sectionHandler.cpp`
- [Material library](https://github.com/suacayipkisi/anafinen/blob/main/src/material/materialLibrary.cpp): `src/material/materialLibrary.cpp`
- [Beam model library](https://github.com/suacayipkisi/anafinen/blob/main/src/objectCalcs/beam/beamTypes/beamLibrary.cpp): `src/objectCalcs/beam/beamTypes/beamLibrary.cpp`
- [Mesh model](https://github.com/suacayipkisi/anafinen/blob/main/src/io/model/meshModel.hpp): `src/io/model/meshModel.hpp`

### Analysis engine

- [Truss solve worker](https://github.com/suacayipkisi/anafinen/blob/main/src/gui/panels/truss/trussWorker.cpp): `src/gui/panels/truss/trussWorker.cpp`
- [Truss solver](https://github.com/suacayipkisi/anafinen/blob/main/src/objectCalcs/truss_1D/trussEngine/trussSolver.cpp): `src/objectCalcs/truss_1D/trussEngine/trussSolver.cpp`
- [Beam solver](https://github.com/suacayipkisi/anafinen/blob/main/src/objectCalcs/beam/beamEngine/beamSolver.cpp): `src/objectCalcs/beam/beamEngine/beamSolver.cpp`
- [Solver backends](https://github.com/suacayipkisi/anafinen/blob/main/src/solvers/solver_referee.cpp): `src/solvers/solver_referee.cpp`
- [Beam diagrams](https://github.com/suacayipkisi/anafinen/blob/main/src/objectCalcs/beam/beamEngine/beamDiagrams.cpp): `src/objectCalcs/beam/beamEngine/beamDiagrams.cpp`

### File exchange

- [Async I/O service](https://github.com/suacayipkisi/anafinen/blob/main/src/io/service/ioService.cpp): `src/io/service/ioService.cpp`
- [Mesh format I/O](https://github.com/suacayipkisi/anafinen/blob/main/src/io/meshIo.hpp): `src/io/meshIo.hpp`

### Shared services

- [Logging](https://github.com/suacayipkisi/anafinen/blob/main/src/log/anaf_info.hpp): `src/log/anaf_info.hpp`
- [Numerical methods](https://github.com/suacayipkisi/anafinen/blob/main/src/common/numericalMethods/rootsOfEquation.cpp): `src/common/numericalMethods/rootsOfEquation.cpp`
- [GPU selection](https://github.com/suacayipkisi/anafinen/blob/main/src/platform/gpuSelection.cpp): `src/platform/gpuSelection.cpp`

### Other components

- **Engineer**

## Connections

- Engineer → GUI workspace: uses (evidence: `README.md`)
- Engineer → CLI commands: uses (evidence: `README.md`)
- GUI workspace → Shared model bridge: initializes
- GUI workspace → Model editors: edits models (evidence: `README.md`)
- GUI workspace → Result views: shows results (evidence: `README.md`)
- GUI workspace → GUI log terminal: displays logs
- CLI commands → CLI session: uses state (evidence: `src/cli/session.hpp`)
- CLI commands → Shared model bridge: shares models (evidence: `README.md`)
- Model editors → Shared model bridge: edits state (evidence: `README.md`)
- Material editor → Shared model bridge: adds materials (evidence: `src/gui/panels/materialHandler.cpp`)
- Section editor → Shared model bridge: adds sections (evidence: `src/gui/panels/beam/sectionHandler.cpp`)
- Shared model bridge → Material library: loads materials
- Beam model library → Model editors: provides models (evidence: `README.md`)
- Model editors → Truss solve worker: starts solve (evidence: `README.md`)
- Truss solve worker → Truss solver: calls solver (evidence: `src/gui/panels/truss/trussWorker.cpp`)
- Truss solve worker → Shared model bridge: publishes results (evidence: `src/gui/panels/truss/trussWorker.cpp`)
- Model editors → Beam solver: runs analysis (evidence: `README.md`)
- Beam solver → Solver backends: uses solvers (evidence: `README.md`)
- Beam solver → Beam diagrams: computes diagrams (evidence: `README.md`)
- Result views → Shared model bridge: reads results (evidence: `README.md`)
- CLI commands → Async I/O service: imports exports (evidence: `README.md`)
- Async I/O service → Mesh format I/O: calls read write (evidence: `src/io/service/ioService.cpp`)
- Mesh format I/O → Mesh model: reads writes (evidence: `README.md`)
- GUI workspace → Logging: sets log sink
- Beam solver → Numerical methods: uses methods (evidence: `README.md`)
- GUI workspace → GPU selection: selects graphics GPU
