# pacs-course/pacs-labs architecture

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

## Overview

pacs-Labs is a collection of laboratory exercises and solutions for a scientific-computing programming course, not a single application. A learner studies exercises and example implementations across numerical methods, C++ design, and scientific-computing topics. The graph highlights recurring Runge–Kutta and Newton-solver examples, plus the dynamic-library exercise; repeated year-by-year variants remain separate where they are core modules. The README establishes the educational purpose, while source-index references support the shown code relationships. Other lab topics are represented at their exact enclosing directories because their implementations were not sampled.

Main entry points: [`Labs/2022/06-eigen-newton/src-solution-2/main.cpp`](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2022/06-eigen-newton/src-solution-2/main.cpp) (Newton examples), [`Labs/2020/10-traits-rkf/src-solution/RKF.hpp`](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/RKF.hpp) (RKF solver 2020), [`Labs/2020/11-traits-rkf-part2/src-solution5/RKF.hpp`](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src-solution5/RKF.hpp) (RKF solver variants), [`Labs`](https://github.com/pacs-course/pacs-labs/tree/main/Labs) (Course lab materials)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ode["ODE integration"]
  node_rkf20["RKF solver 2020<br/>[RKF.hpp]"]
  node_rkf20table["RKF coefficients<br/>[ButcherRKF.hpp]"]
  node_rkf20traits["RKF traits<br/>[RKFTraits.hpp]"]
  node_rkf20main["RKF example<br/>[main.cpp]"]
  node_rkf20p2["RKF solver variants<br/>[RKF.hpp]"]
  node_rkf20p2table["RKF scheme variants<br/>[ButcherRKF.hpp]"]
  node_rkf20p2main["Adaptive RKF examples<br/>[main.cpp]"]
  node_rkf20p2base["RKF solver baseline<br/>[RKF.hpp]"]
  node_rkf21["RKF solver 2021<br/>[RKF.hpp]"]
  node_rkf23["RKF solver 2023<br/>[RKF.hpp]"]
  node_rkf24["RKF solver 2024<br/>[RKF.hpp]"]
  node_rkf25["RKF solver 2025<br/>[RKF.hpp]"]
end

subgraph group_newton["Nonlinear solvers"]
  node_newton21jac["Jacobian methods<br/>[Jacobian.hpp]"]
  node_newton21traits["Newton traits<br/>[NewtonTraits.hpp]"]
  node_newton21["Newton iteration<br/>[Newton.hpp]"]
  node_newton22["Newton solver variant<br/>[Newton.hpp]"]
  node_newton22main["Newton examples<br/>[main.cpp]"]
  node_newton23["Newton solver variant<br/>[Newton.hpp]"]
  node_newton24["Newton solver variant<br/>[Newton.hpp]"]
  node_newton25["Class Newton solver<br/>[main.cpp]"]
end

subgraph group_design["C++ design"]
  node_dynamic["Dynamic library factory<br/>[main.cpp]"]
end

subgraph group_labs["Other lab topics"]
  node_materials["Course lab materials"]
  node_otherlabs["Other exercises"]
end

node_learner(("Course learner"))

node_learner -->|"studies"| node_materials
node_rkf20main -->|"uses solver"| node_rkf20
node_rkf20 -->|"uses schemes"| node_rkf20table
node_rkf20 -->|"uses traits"| node_rkf20traits
node_rkf20p2main -->|"uses solver"| node_rkf20p2
node_rkf20p2 -->|"uses schemes"| node_rkf20p2table
node_newton22main -->|"runs solver"| node_newton22
node_newton22main -.->|"builds Jacobians"| node_newton21jac
node_newton22main -.->|"uses traits"| node_newton21traits
node_materials -.->|"includes exercises"| node_otherlabs

click node_materials "https://github.com/pacs-course/pacs-labs/tree/main/Labs"
click node_rkf20 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/RKF.hpp"
click node_rkf20table "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/ButcherRKF.hpp"
click node_rkf20traits "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/RKFTraits.hpp"
click node_rkf20main "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/main.cpp"
click node_rkf20p2 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src-solution5/RKF.hpp"
click node_rkf20p2table "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src-solution5/ButcherRKF.hpp"
click node_rkf20p2main "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src-solution5/main.cpp"
click node_rkf20p2base "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src/RKF.hpp"
click node_rkf21 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2021/08-traits-rkf/src-solution/RKF.hpp"
click node_rkf23 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2023/07-traits-rkf/src-solution/RKF.hpp"
click node_rkf24 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2024/07-traits-rkf/src-solution/RKF.hpp"
click node_rkf25 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2025/10-rkf-2/src-solution5/RKF.hpp"
click node_newton21jac "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2021/07-eigen-newton/src-solution-1/Jacobian.hpp"
click node_newton21traits "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2021/07-eigen-newton/src-solution-1/NewtonTraits.hpp"
click node_newton21 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2021/07-eigen-newton/src-solution-2/Newton.hpp"
click node_newton22 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2022/06-eigen-newton/src-solution-2/Newton.hpp"
click node_newton22main "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2022/06-eigen-newton/src-solution-2/main.cpp"
click node_newton23 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2023/06-eigen-newton/src-solution-2/Newton.hpp"
click node_newton24 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2024/06-eigen-newton/src-solution-2/Newton.hpp"
click node_newton25 "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2025/07-eigen/src-class-solution/main.cpp"
click node_dynamic "https://github.com/pacs-course/pacs-labs/blob/main/Labs/2019/09-dld/step3/main.cpp"
click node_otherlabs "https://github.com/pacs-course/pacs-labs/tree/main/Labs/2020"

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_rkf20,node_rkf20table,node_rkf20traits,node_rkf20main,node_rkf20p2,node_rkf20p2table,node_rkf20p2main,node_rkf20p2base,node_rkf21,node_rkf23,node_rkf24,node_rkf25 toneBlue
class node_newton21jac,node_newton21traits,node_newton21,node_newton22,node_newton22main,node_newton23,node_newton24,node_newton25 toneAmber
class node_dynamic toneMint
class node_materials,node_otherlabs toneRose
class node_learner toneIndigo
```

## Components

### ODE integration

- [RKF solver 2020](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/RKF.hpp): `Labs/2020/10-traits-rkf/src-solution/RKF.hpp`
- [RKF coefficients](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/ButcherRKF.hpp): `Labs/2020/10-traits-rkf/src-solution/ButcherRKF.hpp`
- [RKF traits](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/RKFTraits.hpp): `Labs/2020/10-traits-rkf/src-solution/RKFTraits.hpp`
- [RKF example](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/10-traits-rkf/src-solution/main.cpp): `Labs/2020/10-traits-rkf/src-solution/main.cpp`
- [RKF solver variants](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src-solution5/RKF.hpp): `Labs/2020/11-traits-rkf-part2/src-solution5/RKF.hpp`
- [RKF scheme variants](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src-solution5/ButcherRKF.hpp): `Labs/2020/11-traits-rkf-part2/src-solution5/ButcherRKF.hpp`
- [Adaptive RKF examples](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src-solution5/main.cpp): `Labs/2020/11-traits-rkf-part2/src-solution5/main.cpp`
- [RKF solver baseline](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2020/11-traits-rkf-part2/src/RKF.hpp): `Labs/2020/11-traits-rkf-part2/src/RKF.hpp`
- [RKF solver 2021](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2021/08-traits-rkf/src-solution/RKF.hpp): `Labs/2021/08-traits-rkf/src-solution/RKF.hpp`
- [RKF solver 2023](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2023/07-traits-rkf/src-solution/RKF.hpp): `Labs/2023/07-traits-rkf/src-solution/RKF.hpp`
- [RKF solver 2024](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2024/07-traits-rkf/src-solution/RKF.hpp): `Labs/2024/07-traits-rkf/src-solution/RKF.hpp`
- [RKF solver 2025](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2025/10-rkf-2/src-solution5/RKF.hpp): `Labs/2025/10-rkf-2/src-solution5/RKF.hpp`

### Nonlinear solvers

- [Jacobian methods](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2021/07-eigen-newton/src-solution-1/Jacobian.hpp): `Labs/2021/07-eigen-newton/src-solution-1/Jacobian.hpp`
- [Newton traits](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2021/07-eigen-newton/src-solution-1/NewtonTraits.hpp): `Labs/2021/07-eigen-newton/src-solution-1/NewtonTraits.hpp`
- [Newton iteration](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2021/07-eigen-newton/src-solution-2/Newton.hpp): `Labs/2021/07-eigen-newton/src-solution-2/Newton.hpp`
- [Newton solver variant](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2022/06-eigen-newton/src-solution-2/Newton.hpp): `Labs/2022/06-eigen-newton/src-solution-2/Newton.hpp`
- [Newton examples](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2022/06-eigen-newton/src-solution-2/main.cpp): `Labs/2022/06-eigen-newton/src-solution-2/main.cpp`
- [Newton solver variant](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2023/06-eigen-newton/src-solution-2/Newton.hpp): `Labs/2023/06-eigen-newton/src-solution-2/Newton.hpp`
- [Newton solver variant](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2024/06-eigen-newton/src-solution-2/Newton.hpp): `Labs/2024/06-eigen-newton/src-solution-2/Newton.hpp`
- [Class Newton solver](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2025/07-eigen/src-class-solution/main.cpp): `Labs/2025/07-eigen/src-class-solution/main.cpp`

### C++ design

- [Dynamic library factory](https://github.com/pacs-course/pacs-labs/blob/main/Labs/2019/09-dld/step3/main.cpp): `Labs/2019/09-dld/step3/main.cpp`

### Other lab topics

- [Course lab materials](https://github.com/pacs-course/pacs-labs/tree/main/Labs): `Labs`
- [Other exercises](https://github.com/pacs-course/pacs-labs/tree/main/Labs/2020): `Labs/2020`

### Other components

- **Course learner**

## Connections

- Course learner → Course lab materials: studies
- RKF example → RKF solver 2020: uses solver (evidence: `Labs/2020/10-traits-rkf/src-solution/main.cpp`)
- RKF solver 2020 → RKF coefficients: uses schemes (evidence: `Labs/2020/10-traits-rkf/src-solution/RKF.hpp`)
- RKF solver 2020 → RKF traits: uses traits (evidence: `Labs/2020/10-traits-rkf/src-solution/RKF.hpp`)
- Adaptive RKF examples → RKF solver variants: uses solver (evidence: `Labs/2020/11-traits-rkf-part2/src-solution5/main.cpp`)
- RKF solver variants → RKF scheme variants: uses schemes (evidence: `Labs/2020/11-traits-rkf-part2/src-solution5/RKF.hpp`)
- Newton examples → Newton solver variant: runs solver (evidence: `Labs/2022/06-eigen-newton/src-solution-2/main.cpp`)
- Newton examples → Jacobian methods: builds Jacobians
- Newton examples → Newton traits: uses traits
- Course lab materials → Other exercises: includes exercises (evidence: `Labs/2020/11-traits-rkf-part2/src-solution5/main.cpp`)
