# electro-corp/grss architecture

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

## Overview

GRSS is a wxWidgets desktop application for simulating and visualizing a relativistic multi-mass environment. Users enter through the application frame, where environment controls support mass management and physics ticking, while rendering controls configure the view; the physics engine advances masses and checks collisions, and the rendering engine draws scene objects. The README documents UI, physics, and custom rendering as the product’s main capabilities. Source excerpts establish only some wiring, so uncertain UI-to-engine and universe coordination links are omitted.

Main entry points: [`GRSS/physics/source/Physics.cpp`](https://github.com/electro-corp/grss/blob/main/GRSS/physics/source/Physics.cpp) (Physics engine), [`GRSS/interface/TopPanel.cpp`](https://github.com/electro-corp/grss/blob/main/GRSS/interface/TopPanel.cpp) (Tool pages), [`GRSS/rendering/source/Rendering.cpp`](https://github.com/electro-corp/grss/blob/main/GRSS/rendering/source/Rendering.cpp) (Rendering engine), [`GRSS/interface/main.cpp`](https://github.com/electro-corp/grss/blob/main/GRSS/interface/main.cpp) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Application entry<br/>[main.cpp]"]
  node_frame["Main frame<br/>[FrameMain.cpp]"]
  node_top["Tool pages<br/>[TopPanel.cpp]"]
  node_environment["Environment controls"]
  node_render_controls["Rendering controls<br/>[RenderingPage.cpp]"]
  node_properties["Properties panel"]
  node_mass_dialog["Add mass dialog<br/>[AddMassDialog.cpp]"]
  node_system_dialog["System dialog<br/>[SystemDialog.cpp]"]
  node_sidebar["Sidebar<br/>[SideBar.cpp]"]
end

subgraph group_domain["Simulation state"]
  node_universe["Simulation state<br/>[Universe.cpp]"]
  node_connections["Connection manager<br/>[Connections.cpp]"]
  node_logger["Logging<br/>[aixlog.hpp]"]
end

subgraph group_physics["Physics computation"]
  node_mass["Mass model<br/>[Mass.cpp]"]
  node_engine["Physics engine<br/>[Physics.cpp]"]
  node_utility["File utility<br/>[Utility.h]"]
  node_newton_kernel["Newton kernel<br/>[newton.cl]"]
  node_test_kernel["Mass kernels<br/>[test.cl]"]
end

subgraph group_rendering["Scene rendering"]
  node_render_panel["OpenGL panel<br/>[OpenGLPanel.cpp]"]
  node_render_engine["Rendering engine<br/>[Rendering.cpp]"]
  node_object["Renderable object<br/>[Object.cpp]"]
end

node_user(("User"))
node_opencl["OpenCL runtime"]
node_opengl["OpenGL"]

node_user -->|"starts"| node_app
node_app -->|"creates"| node_frame
node_top -->|"hosts"| node_environment
node_top -->|"hosts"| node_render_controls
node_engine -->|"loads kernels with"| node_utility
node_engine -->|"loads"| node_newton_kernel
node_engine -->|"loads"| node_test_kernel
node_engine -->|"dispatches kernels"| node_opencl
node_render_engine -->|"renders"| node_object
node_render_engine -->|"draws with"| node_opengl

click node_app "https://github.com/electro-corp/grss/blob/main/GRSS/interface/main.cpp"
click node_frame "https://github.com/electro-corp/grss/blob/main/GRSS/interface/FrameMain.cpp"
click node_top "https://github.com/electro-corp/grss/blob/main/GRSS/interface/TopPanel.cpp"
click node_environment "https://github.com/electro-corp/grss/blob/main/GRSS/interface/EnvironmentPage.cpp"
click node_render_controls "https://github.com/electro-corp/grss/blob/main/GRSS/interface/RenderingPage.cpp"
click node_properties "https://github.com/electro-corp/grss/blob/main/GRSS/interface/PropertiesPanel.cpp"
click node_mass_dialog "https://github.com/electro-corp/grss/blob/main/GRSS/interface/AddMassDialog.cpp"
click node_system_dialog "https://github.com/electro-corp/grss/blob/main/GRSS/interface/SystemDialog.cpp"
click node_sidebar "https://github.com/electro-corp/grss/blob/main/GRSS/interface/SideBar.cpp"
click node_universe "https://github.com/electro-corp/grss/blob/main/GRSS/common/Universe.cpp"
click node_connections "https://github.com/electro-corp/grss/blob/main/GRSS/common/Connections.cpp"
click node_mass "https://github.com/electro-corp/grss/blob/main/GRSS/physics/source/Mass.cpp"
click node_engine "https://github.com/electro-corp/grss/blob/main/GRSS/physics/source/Physics.cpp"
click node_utility "https://github.com/electro-corp/grss/blob/main/GRSS/common/Utility.h"
click node_newton_kernel "https://github.com/electro-corp/grss/blob/main/GRSS/kernels/newton.cl"
click node_test_kernel "https://github.com/electro-corp/grss/blob/main/GRSS/kernels/test.cl"
click node_render_panel "https://github.com/electro-corp/grss/blob/main/GRSS/interface/OpenGLPanel.cpp"
click node_render_engine "https://github.com/electro-corp/grss/blob/main/GRSS/rendering/source/Rendering.cpp"
click node_object "https://github.com/electro-corp/grss/blob/main/GRSS/rendering/source/Object.cpp"
click node_logger "https://github.com/electro-corp/grss/blob/main/GRSS/common/aixlog.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_app,node_frame,node_top,node_environment,node_render_controls,node_properties,node_mass_dialog,node_system_dialog,node_sidebar,node_user toneBlue
class node_universe,node_connections,node_logger toneAmber
class node_mass,node_engine,node_utility,node_newton_kernel,node_test_kernel toneMint
class node_render_panel,node_render_engine,node_object toneRose
class node_opencl,node_opengl toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/electro-corp/grss/blob/main/GRSS/interface/main.cpp): `GRSS/interface/main.cpp`
- [Main frame](https://github.com/electro-corp/grss/blob/main/GRSS/interface/FrameMain.cpp): `GRSS/interface/FrameMain.cpp`
- [Tool pages](https://github.com/electro-corp/grss/blob/main/GRSS/interface/TopPanel.cpp): `GRSS/interface/TopPanel.cpp`
- [Environment controls](https://github.com/electro-corp/grss/blob/main/GRSS/interface/EnvironmentPage.cpp): `GRSS/interface/EnvironmentPage.cpp`
- [Rendering controls](https://github.com/electro-corp/grss/blob/main/GRSS/interface/RenderingPage.cpp): `GRSS/interface/RenderingPage.cpp`
- [Properties panel](https://github.com/electro-corp/grss/blob/main/GRSS/interface/PropertiesPanel.cpp): `GRSS/interface/PropertiesPanel.cpp`
- [Add mass dialog](https://github.com/electro-corp/grss/blob/main/GRSS/interface/AddMassDialog.cpp): `GRSS/interface/AddMassDialog.cpp`
- [System dialog](https://github.com/electro-corp/grss/blob/main/GRSS/interface/SystemDialog.cpp): `GRSS/interface/SystemDialog.cpp`
- [Sidebar](https://github.com/electro-corp/grss/blob/main/GRSS/interface/SideBar.cpp): `GRSS/interface/SideBar.cpp`

### Simulation state

- [Simulation state](https://github.com/electro-corp/grss/blob/main/GRSS/common/Universe.cpp): `GRSS/common/Universe.cpp`
- [Connection manager](https://github.com/electro-corp/grss/blob/main/GRSS/common/Connections.cpp): `GRSS/common/Connections.cpp`
- [Logging](https://github.com/electro-corp/grss/blob/main/GRSS/common/aixlog.hpp): `GRSS/common/aixlog.hpp`

### Physics computation

- [Mass model](https://github.com/electro-corp/grss/blob/main/GRSS/physics/source/Mass.cpp): `GRSS/physics/source/Mass.cpp`
- [Physics engine](https://github.com/electro-corp/grss/blob/main/GRSS/physics/source/Physics.cpp): `GRSS/physics/source/Physics.cpp`
- [File utility](https://github.com/electro-corp/grss/blob/main/GRSS/common/Utility.h): `GRSS/common/Utility.h`
- [Newton kernel](https://github.com/electro-corp/grss/blob/main/GRSS/kernels/newton.cl): `GRSS/kernels/newton.cl`
- [Mass kernels](https://github.com/electro-corp/grss/blob/main/GRSS/kernels/test.cl): `GRSS/kernels/test.cl`

### Scene rendering

- [OpenGL panel](https://github.com/electro-corp/grss/blob/main/GRSS/interface/OpenGLPanel.cpp): `GRSS/interface/OpenGLPanel.cpp`
- [Rendering engine](https://github.com/electro-corp/grss/blob/main/GRSS/rendering/source/Rendering.cpp): `GRSS/rendering/source/Rendering.cpp`
- [Renderable object](https://github.com/electro-corp/grss/blob/main/GRSS/rendering/source/Object.cpp): `GRSS/rendering/source/Object.cpp`

### Other components

- **User**
- **OpenCL runtime**
- **OpenGL**

## Connections

- User → Application entry: starts (evidence: `GRSS/interface/main.cpp`)
- Application entry → Main frame: creates (evidence: `GRSS/interface/main.cpp`)
- Tool pages → Environment controls: hosts
- Tool pages → Rendering controls: hosts
- Physics engine → File utility: loads kernels with (evidence: `GRSS/physics/source/Physics.cpp`)
- Physics engine → Newton kernel: loads (evidence: `GRSS/physics/source/Physics.cpp`)
- Physics engine → Mass kernels: loads (evidence: `GRSS/physics/source/Physics.cpp`)
- Physics engine → OpenCL runtime: dispatches kernels (evidence: `GRSS/physics/source/Physics.cpp`)
- Rendering engine → Renderable object: renders (evidence: `GRSS/rendering/source/Rendering.cpp`)
- Rendering engine → OpenGL: draws with (evidence: `GRSS/rendering/source/Rendering.cpp`)
