# paulo-pagliosa/ds architecture

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

- Interactive diagram: https://gitdiagram.com/paulo-pagliosa/ds
- Repository: https://github.com/paulo-pagliosa/ds

## Overview

Ds is a C++ graphics library, accompanied by Ds-Vis for scientific visualization and demo applications. The main user workflow is creating an application window, building or loading scene geometry, and rendering it; Ds-Vis adds dataset sources, filters, and rendering sinks. The graph also preserves the documented spatial, scene-graph, ray-tracing, CUDA, and particle capabilities. Several implementation details are unsampled, so their links are omitted or marked unverified rather than inferred from names alone.

Main entry points: [`cg/src/graph/SceneObject.cpp`](https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graph/SceneObject.cpp) (Scene Graph), [`cg/src/graphics/Application.cpp`](https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graphics/Application.cpp) (Application Runtime), [`apps/cgdemo/RayTracer.cpp`](https://github.com/paulo-pagliosa/ds/blob/master/apps/cgdemo/RayTracer.cpp) (Ray Tracing Demo), [`cgvis/src/TriCellMeshMapper.cpp`](https://github.com/paulo-pagliosa/ds/blob/master/cgvis/src/TriCellMeshMapper.cpp) (Mesh Mapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application Runtime"]
  node_app["Application Runtime<br/>[Application.cpp]"]
  node_window["Graphics Window<br/>[GLWindow.h]"]
  node_imgui["Dear ImGui<br/>[imgui_draw.cpp]"]
end

subgraph group_scene["Scenes and Rendering"]
  node_scenegraph["Scene Graph<br/>[SceneObject.cpp]"]
  node_sceneui["Scene Window<br/>[SceneWindow.cpp]"]
  node_glrender["OpenGL Rendering<br/>[GLRenderer.cpp]"]
end

subgraph group_data["Geometry and Data"]
  node_core["Core Containers"]
  node_math["Math Types"]
  node_spatial["Spatial Structures"]
  node_mesh["Triangle Mesh<br/>[TriangleMesh.cpp]"]
end

subgraph group_vis["Scientific Visualization"]
  node_dataset["Visualization Datasets<br/>[TriCellMesh.h]"]
  node_process["Visualization Processes<br/>[Filter.h]"]
  node_reader["Mesh Reader"]
  node_mapper["Mesh Mapper"]
  node_viswindow["Visualization Scene<br/>[SceneWindow.cpp]"]
end

subgraph group_extensions["Demos and Extensions"]
  node_raydemo["Ray Tracing Demo<br/>[RayTracer.cpp]"]
  node_sceneio["Scene File I/O<br/>[SceneWriter.cpp]"]
  node_parser["Scene Parser"]
  node_cuda["CUDA Support<br/>[CUDAHelper.h]"]
  node_particle["Particle Rendering"]
end

node_user(("Application User"))

node_user -->|"starts"| node_app
node_app -->|"runs window"| node_window
node_app -.->|"launches demo"| node_raydemo
node_user -->|"builds scene"| node_scenegraph
node_scenegraph -->|"renders scene"| node_glrender
node_math -->|"transforms objects"| node_scenegraph
node_spatial -.->|"accelerates queries"| node_mesh
node_mesh -->|"provides geometry"| node_scenegraph
node_sceneui -.->|"manages scene"| node_scenegraph
node_raydemo -.->|"reads scenes"| node_parser
node_raydemo -.->|"writes scenes"| node_sceneio
node_user -->|"loads data"| node_reader
node_reader -->|"produces dataset"| node_dataset
node_dataset -->|"feeds pipeline"| node_process
node_process -->|"transforms input"| node_mapper
node_mapper -->|"renders mesh"| node_glrender
node_viswindow -.->|"hosts actors"| node_mapper
node_core -->|"supports storage"| node_spatial
node_user -.->|"uses acceleration"| node_cuda
node_user -.->|"runs demo"| node_particle
node_window -.->|"draws interface"| node_imgui

click node_app "https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graphics/Application.cpp"
click node_window "https://github.com/paulo-pagliosa/ds/blob/master/cg/include/graphics/GLWindow.h"
click node_core "https://github.com/paulo-pagliosa/ds/tree/master/cg/include/core"
click node_math "https://github.com/paulo-pagliosa/ds/tree/master/cg/include/math"
click node_spatial "https://github.com/paulo-pagliosa/ds/tree/master/cg/include/geometry"
click node_mesh "https://github.com/paulo-pagliosa/ds/blob/master/cg/src/geometry/TriangleMesh.cpp"
click node_scenegraph "https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graph/SceneObject.cpp"
click node_sceneui "https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graph/SceneWindow.cpp"
click node_glrender "https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graphics/GLRenderer.cpp"
click node_raydemo "https://github.com/paulo-pagliosa/ds/blob/master/apps/cgdemo/RayTracer.cpp"
click node_sceneio "https://github.com/paulo-pagliosa/ds/blob/master/apps/cgdemo/SceneWriter.cpp"
click node_parser "https://github.com/paulo-pagliosa/ds/tree/master/apps/cgdemo/reader"
click node_dataset "https://github.com/paulo-pagliosa/ds/blob/master/cgvis/include/TriCellMesh.h"
click node_process "https://github.com/paulo-pagliosa/ds/blob/master/cgvis/include/Filter.h"
click node_reader "https://github.com/paulo-pagliosa/ds/blob/master/cgvis/src/TriCellMeshReader.cpp"
click node_mapper "https://github.com/paulo-pagliosa/ds/blob/master/cgvis/src/TriCellMeshMapper.cpp"
click node_viswindow "https://github.com/paulo-pagliosa/ds/blob/master/cgvis/src/SceneWindow.cpp"
click node_cuda "https://github.com/paulo-pagliosa/ds/blob/master/cgcuda/include/CUDAHelper.h"
click node_particle "https://github.com/paulo-pagliosa/ds/blob/master/apps/particles/src/graphics/GLParticleRenderer.cpp"
click node_imgui "https://github.com/paulo-pagliosa/ds/blob/master/cg/externals/src/imgui_draw.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_app,node_window,node_imgui,node_user toneBlue
class node_scenegraph,node_sceneui,node_glrender toneAmber
class node_core,node_math,node_spatial,node_mesh toneMint
class node_dataset,node_process,node_reader,node_mapper,node_viswindow toneRose
class node_raydemo,node_sceneio,node_parser,node_cuda,node_particle toneIndigo
```

## Components

### Application Runtime

- [Application Runtime](https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graphics/Application.cpp): `cg/src/graphics/Application.cpp`
- [Graphics Window](https://github.com/paulo-pagliosa/ds/blob/master/cg/include/graphics/GLWindow.h): `cg/include/graphics/GLWindow.h`
- [Dear ImGui](https://github.com/paulo-pagliosa/ds/blob/master/cg/externals/src/imgui_draw.cpp): `cg/externals/src/imgui_draw.cpp`

### Scenes and Rendering

- [Scene Graph](https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graph/SceneObject.cpp): `cg/src/graph/SceneObject.cpp`
- [Scene Window](https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graph/SceneWindow.cpp): `cg/src/graph/SceneWindow.cpp`
- [OpenGL Rendering](https://github.com/paulo-pagliosa/ds/blob/master/cg/src/graphics/GLRenderer.cpp): `cg/src/graphics/GLRenderer.cpp`

### Geometry and Data

- [Core Containers](https://github.com/paulo-pagliosa/ds/tree/master/cg/include/core): `cg/include/core`
- [Math Types](https://github.com/paulo-pagliosa/ds/tree/master/cg/include/math): `cg/include/math`
- [Spatial Structures](https://github.com/paulo-pagliosa/ds/tree/master/cg/include/geometry): `cg/include/geometry`
- [Triangle Mesh](https://github.com/paulo-pagliosa/ds/blob/master/cg/src/geometry/TriangleMesh.cpp): `cg/src/geometry/TriangleMesh.cpp`

### Scientific Visualization

- [Visualization Datasets](https://github.com/paulo-pagliosa/ds/blob/master/cgvis/include/TriCellMesh.h): `cgvis/include/TriCellMesh.h`
- [Visualization Processes](https://github.com/paulo-pagliosa/ds/blob/master/cgvis/include/Filter.h): `cgvis/include/Filter.h`
- [Mesh Reader](https://github.com/paulo-pagliosa/ds/blob/master/cgvis/src/TriCellMeshReader.cpp): `cgvis/src/TriCellMeshReader.cpp`
- [Mesh Mapper](https://github.com/paulo-pagliosa/ds/blob/master/cgvis/src/TriCellMeshMapper.cpp): `cgvis/src/TriCellMeshMapper.cpp`
- [Visualization Scene](https://github.com/paulo-pagliosa/ds/blob/master/cgvis/src/SceneWindow.cpp): `cgvis/src/SceneWindow.cpp`

### Demos and Extensions

- [Ray Tracing Demo](https://github.com/paulo-pagliosa/ds/blob/master/apps/cgdemo/RayTracer.cpp): `apps/cgdemo/RayTracer.cpp`
- [Scene File I/O](https://github.com/paulo-pagliosa/ds/blob/master/apps/cgdemo/SceneWriter.cpp): `apps/cgdemo/SceneWriter.cpp`
- [Scene Parser](https://github.com/paulo-pagliosa/ds/tree/master/apps/cgdemo/reader): `apps/cgdemo/reader`
- [CUDA Support](https://github.com/paulo-pagliosa/ds/blob/master/cgcuda/include/CUDAHelper.h): `cgcuda/include/CUDAHelper.h`
- [Particle Rendering](https://github.com/paulo-pagliosa/ds/blob/master/apps/particles/src/graphics/GLParticleRenderer.cpp): `apps/particles/src/graphics/GLParticleRenderer.cpp`

### Other components

- **Application User**

## Connections

- Application User → Application Runtime: starts (evidence: `README.md`)
- Application Runtime → Graphics Window: runs window (evidence: `cg/src/graphics/Application.cpp`)
- Application Runtime → Ray Tracing Demo: launches demo
- Application User → Scene Graph: builds scene (evidence: `README.md`)
- Scene Graph → OpenGL Rendering: renders scene (evidence: `README.md`)
- Math Types → Scene Graph: transforms objects (evidence: `README.md`)
- Spatial Structures → Triangle Mesh: accelerates queries
- Triangle Mesh → Scene Graph: provides geometry (evidence: `README.md`)
- Scene Window → Scene Graph: manages scene
- Ray Tracing Demo → Scene Parser: reads scenes
- Ray Tracing Demo → Scene File I/O: writes scenes
- Application User → Mesh Reader: loads data (evidence: `README.md`)
- Mesh Reader → Visualization Datasets: produces dataset
- Visualization Datasets → Visualization Processes: feeds pipeline (evidence: `README.md`)
- Visualization Processes → Mesh Mapper: transforms input (evidence: `README.md`)
- Mesh Mapper → OpenGL Rendering: renders mesh (evidence: `cgvis/src/TriCellMeshMapper.cpp`)
- Visualization Scene → Mesh Mapper: hosts actors
- Core Containers → Spatial Structures: supports storage (evidence: `cg/include/geometry/GridBase.h`)
- Application User → CUDA Support: uses acceleration
- Application User → Particle Rendering: runs demo
- Graphics Window → Dear ImGui: draws interface
