# cuiziteng/luminance-gs architecture

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

- Interactive diagram: https://gitdiagram.com/cuiziteng/luminance-gs
- Repository: https://github.com/cuiziteng/luminance-gs

## Overview

Luminance-GS is presented as research on view-adaptive curve adjustment for 3D Gaussian splatting; the visible runtime is the gsplat rendering library. Its primary workflow accepts Gaussian scene parameters and camera data, projects and rasterizes them into images, with a separate dual-rendering implementation. The package also exposes legacy rasterization interfaces and a PyTorch implementation. The README provides little operational detail, and trainer/data-preparation source was not sampled, so those research workflow stages and their connections are not inferred here.

Main entry points: [`Luminance-GS/gsplat/__init__.py`](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/__init__.py) (Public API), [`Luminance-GS/gsplat/cuda/_wrapper.py`](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/_wrapper.py) (CUDA operations), [`Luminance-GS/gsplat/rendering.py`](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/rendering.py) (Rasterization), [`Luminance-GS/gsplat/cuda/_backend.py`](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/_backend.py) (Extension loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_render["Rendering API"]
  node_api["Public API<br/>[__init__.py]"]
  node_rendering["Rasterization<br/>[rendering.py]"]
  node_dual["Dual rendering"]
  node_helper["Runtime helpers<br/>[_helper.py]"]
  node_version["Version metadata<br/>[version.py]"]
end

subgraph group_cuda["CUDA Runtime"]
  node_wrapper["CUDA operations<br/>[_wrapper.py]"]
  node_torchimpl["PyTorch fallback<br/>[_torch_impl.py]"]
  node_backend["Extension loader<br/>[_backend.py]"]
  node_bindings["Native bindings<br/>[bindings.h]"]
end

subgraph group_legacy["Legacy Runtime"]
  node_legacywrapper["Legacy operations<br/>[_wrapper.py]"]
  node_legacybackend["Legacy loader<br/>[_backend.py]"]
  node_legacybindings["Legacy bindings<br/>[bindings.h]"]
end

node_caller(("Python caller"))

node_caller -->|"calls"| node_api
node_api -->|"exports"| node_rendering
node_api -->|"exports"| node_wrapper
node_api -->|"imports"| node_torchimpl
node_api -->|"imports"| node_version
node_api -->|"delegates"| node_legacywrapper
node_rendering -->|"calls"| node_wrapper
node_dual -->|"calls"| node_wrapper
node_wrapper -->|"loads"| node_backend
node_backend -->|"loads sources"| node_bindings
node_legacywrapper -->|"loads"| node_legacybackend
node_legacybackend -->|"loads sources"| node_legacybindings

click node_api "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/__init__.py"
click node_rendering "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/rendering.py"
click node_dual "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/rendering_double.py"
click node_helper "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/_helper.py"
click node_version "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/version.py"
click node_wrapper "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/_wrapper.py"
click node_torchimpl "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/_torch_impl.py"
click node_backend "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/_backend.py"
click node_bindings "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/csrc/bindings.h"
click node_legacywrapper "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda_legacy/_wrapper.py"
click node_legacybackend "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda_legacy/_backend.py"
click node_legacybindings "https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda_legacy/csrc/bindings.h"

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_api,node_rendering,node_dual,node_helper,node_version toneBlue
class node_wrapper,node_torchimpl,node_backend,node_bindings toneAmber
class node_legacywrapper,node_legacybackend,node_legacybindings toneMint
class node_caller toneIndigo
```

## Components

### Rendering API

- [Public API](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/__init__.py): `Luminance-GS/gsplat/__init__.py`
- [Rasterization](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/rendering.py): `Luminance-GS/gsplat/rendering.py`
- [Dual rendering](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/rendering_double.py): `Luminance-GS/gsplat/rendering_double.py`
- [Runtime helpers](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/_helper.py): `Luminance-GS/gsplat/_helper.py`
- [Version metadata](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/version.py): `Luminance-GS/gsplat/version.py`

### CUDA Runtime

- [CUDA operations](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/_wrapper.py): `Luminance-GS/gsplat/cuda/_wrapper.py`
- [PyTorch fallback](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/_torch_impl.py): `Luminance-GS/gsplat/cuda/_torch_impl.py`
- [Extension loader](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/_backend.py): `Luminance-GS/gsplat/cuda/_backend.py`
- [Native bindings](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda/csrc/bindings.h): `Luminance-GS/gsplat/cuda/csrc/bindings.h`

### Legacy Runtime

- [Legacy operations](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda_legacy/_wrapper.py): `Luminance-GS/gsplat/cuda_legacy/_wrapper.py`
- [Legacy loader](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda_legacy/_backend.py): `Luminance-GS/gsplat/cuda_legacy/_backend.py`
- [Legacy bindings](https://github.com/cuiziteng/luminance-gs/blob/main/Luminance-GS/gsplat/cuda_legacy/csrc/bindings.h): `Luminance-GS/gsplat/cuda_legacy/csrc/bindings.h`

### Other components

- **Python caller**

## Connections

- Python caller → Public API: calls (evidence: `Luminance-GS/gsplat/__init__.py`)
- Public API → Rasterization: exports (evidence: `Luminance-GS/gsplat/__init__.py`)
- Public API → CUDA operations: exports (evidence: `Luminance-GS/gsplat/__init__.py`)
- Public API → PyTorch fallback: imports (evidence: `Luminance-GS/gsplat/__init__.py`)
- Public API → Version metadata: imports (evidence: `Luminance-GS/gsplat/__init__.py`)
- Public API → Legacy operations: delegates (evidence: `Luminance-GS/gsplat/__init__.py`)
- Rasterization → CUDA operations: calls (evidence: `Luminance-GS/gsplat/rendering.py`)
- Dual rendering → CUDA operations: calls (evidence: `Luminance-GS/gsplat/rendering_double.py`)
- CUDA operations → Extension loader: loads (evidence: `Luminance-GS/gsplat/cuda/_wrapper.py`)
- Extension loader → Native bindings: loads sources (evidence: `Luminance-GS/gsplat/cuda/_backend.py`)
- Legacy operations → Legacy loader: loads (evidence: `Luminance-GS/gsplat/cuda_legacy/_wrapper.py`)
- Legacy loader → Legacy bindings: loads sources (evidence: `Luminance-GS/gsplat/cuda_legacy/_backend.py`)
