# diego1401/gaussianwrapping architecture

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

- Interactive diagram: https://gitdiagram.com/diego1401/gaussianwrapping
- Repository: https://github.com/diego1401/gaussianwrapping

## Overview

Gaussian Wrapping trains 3D Gaussian scene representations from COLMAP data, then reconstructs textured meshes. The README documents both standard extraction and an alternative Primal Adaptive Meshing (PAM) route, plus Blender-authored bounding volumes. The graph follows those documented workflows and source-index references; unsampled extraction, texture, and evaluation internals are represented conservatively, with uncertain links omitted.

Main entry points: [`gaussian_wrapping/train.py`](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/train.py) (Gaussian Training), [`gaussian_wrapping/convert.py`](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/convert.py) (Standard Extraction), [`gaussian_wrapping/gaussian_renderer/__init__.py`](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/__init__.py) (Renderer Selection), [`gaussian_wrapping/scene/gaussian_model.py`](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/gaussian_model.py) (Gaussian Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_training["Scene Training"]
  node_train["Gaussian Training<br/>[train.py]"]
  node_scene_data["Scene Loading<br/>[dataset_readers.py]"]
  node_camera["Camera Model<br/>[cameras.py]"]
  node_gaussian["Gaussian Model<br/>[gaussian_model.py]"]
  node_normal["Normal Regularization<br/>[normal_field.py]"]
  node_depth_fusion["Depth Fusion<br/>[depth_fusion.py]"]
  node_regularizers["Training Regularizers"]
end

subgraph group_render["Rendering"]
  node_renderer["Renderer Selection<br/>[__init__.py]"]
  node_ours["Median Renderer<br/>[ours.py]"]
  node_radegs["RaDeGS Renderer<br/>[radegs.py]"]
  node_sof["SOF Renderer<br/>[sof.py]"]
  node_rasterizer["CUDA Rasterizers<br/>[__init__.py]"]
end

subgraph group_reconstruction["Mesh Reconstruction"]
  node_pivots["Pivot Extraction<br/>[pivots.py]"]
  node_mesh_extract["Mesh Extraction<br/>[mesh.py]"]
  node_standard_entry["Standard Extraction<br/>[convert.py]"]
  node_pam["Adaptive Meshing"]
  node_mesh["Mesh Data Model<br/>[mesh.py]"]
  node_texture["Texture Refinement<br/>[texture_mesh.py]"]
end

subgraph group_tools["Scene Tools"]
  node_blender["Blender Bounds Add-on"]
  node_evaluation["Mesh Evaluation"]
  node_geometry["Geometry Utilities<br/>[geometry_utils.py]"]
  node_general["General Utilities<br/>[general_utils.py]"]
  node_graphics["Graphics Utilities<br/>[graphics_utils.py]"]
  node_sh["Spherical Harmonics<br/>[sh_utils.py]"]
  node_tetmesh["Tetrahedral Utilities<br/>[tetmesh.py]"]
end

node_user(("Researcher"))
node_colmap["COLMAP Dataset"]

node_user -->|"starts training"| node_train
node_colmap -->|"provides data"| node_train
node_train -->|"loads scene"| node_scene_data
node_train -->|"uses cameras"| node_camera
node_train -->|"optimizes"| node_gaussian
node_train -->|"renders views"| node_renderer
node_train -->|"applies regularization"| node_normal
node_train -->|"applies regularization"| node_regularizers
node_renderer -->|"dispatches"| node_radegs
node_renderer -->|"dispatches"| node_sof
node_renderer -->|"calls rasterizer"| node_rasterizer
node_normal -->|"uses fusion"| node_depth_fusion
node_user -->|"runs extraction"| node_standard_entry
node_standard_entry -.->|"extracts pivots"| node_pivots
node_pivots -->|"reads Gaussians"| node_gaussian
node_pivots -->|"uses normals"| node_normal
node_standard_entry -.->|"builds mesh"| node_mesh_extract
node_user -->|"runs PAM"| node_pam
node_pam -.->|"reconstructs surface"| node_mesh
node_user -->|"exports bounds"| node_blender
node_blender -->|"provides bounds"| node_pam
node_standard_entry -->|"refines texture"| node_texture
node_standard_entry -.->|"evaluates mesh"| node_evaluation
node_geometry -->|"transforms points"| node_camera
node_geometry -->|"uses rotations"| node_general
node_camera -->|"builds transforms"| node_graphics
node_gaussian -->|"uses utilities"| node_general
node_gaussian -->|"uses harmonics"| node_sh
node_mesh -.->|"uses tetrahedra"| node_tetmesh

click node_train "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/train.py"
click node_scene_data "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/dataset_readers.py"
click node_camera "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/cameras.py"
click node_gaussian "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/gaussian_model.py"
click node_renderer "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/__init__.py"
click node_ours "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/ours.py"
click node_radegs "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/radegs.py"
click node_sof "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/sof.py"
click node_rasterizer "https://github.com/diego1401/gaussianwrapping/blob/main/submodules/diff-gaussian-rasterization_ms/diff_gaussian_rasterization_ms/__init__.py"
click node_normal "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/regularization/normal_field.py"
click node_depth_fusion "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/regularization/sdf/depth_fusion.py"
click node_regularizers "https://github.com/diego1401/gaussianwrapping/tree/main/gaussian_wrapping/regularization/regularizer"
click node_pivots "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/extraction/pivots.py"
click node_mesh_extract "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/extraction/mesh.py"
click node_standard_entry "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/convert.py"
click node_pam "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/primal_adaptive_meshing_extraction.py"
click node_mesh "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/mesh.py"
click node_texture "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/texture_mesh.py"
click node_blender "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/blender/bounding_volume_addon.py"
click node_evaluation "https://github.com/diego1401/gaussianwrapping/tree/main/gaussian_wrapping/eval"
click node_geometry "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/geometry_utils.py"
click node_general "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/general_utils.py"
click node_graphics "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/graphics_utils.py"
click node_sh "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/sh_utils.py"
click node_tetmesh "https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/tetmesh.py"

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_train,node_scene_data,node_camera,node_gaussian,node_normal,node_depth_fusion,node_regularizers toneBlue
class node_renderer,node_ours,node_radegs,node_sof,node_rasterizer toneAmber
class node_pivots,node_mesh_extract,node_standard_entry,node_pam,node_mesh,node_texture toneMint
class node_blender,node_evaluation,node_geometry,node_general,node_graphics,node_sh,node_tetmesh toneRose
class node_user,node_colmap toneIndigo
```

## Components

### Scene Training

- [Gaussian Training](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/train.py): `gaussian_wrapping/train.py`
- [Scene Loading](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/dataset_readers.py): `gaussian_wrapping/scene/dataset_readers.py`
- [Camera Model](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/cameras.py): `gaussian_wrapping/scene/cameras.py`
- [Gaussian Model](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/gaussian_model.py): `gaussian_wrapping/scene/gaussian_model.py`
- [Normal Regularization](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/regularization/normal_field.py): `gaussian_wrapping/regularization/normal_field.py`
- [Depth Fusion](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/regularization/sdf/depth_fusion.py): `gaussian_wrapping/regularization/sdf/depth_fusion.py`
- [Training Regularizers](https://github.com/diego1401/gaussianwrapping/tree/main/gaussian_wrapping/regularization/regularizer): `gaussian_wrapping/regularization/regularizer`

### Rendering

- [Renderer Selection](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/__init__.py): `gaussian_wrapping/gaussian_renderer/__init__.py`
- [Median Renderer](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/ours.py): `gaussian_wrapping/gaussian_renderer/ours.py`
- [RaDeGS Renderer](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/radegs.py): `gaussian_wrapping/gaussian_renderer/radegs.py`
- [SOF Renderer](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/gaussian_renderer/sof.py): `gaussian_wrapping/gaussian_renderer/sof.py`
- [CUDA Rasterizers](https://github.com/diego1401/gaussianwrapping/blob/main/submodules/diff-gaussian-rasterization_ms/diff_gaussian_rasterization_ms/__init__.py): `submodules/diff-gaussian-rasterization_ms/diff_gaussian_rasterization_ms/__init__.py`

### Mesh Reconstruction

- [Pivot Extraction](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/extraction/pivots.py): `gaussian_wrapping/extraction/pivots.py`
- [Mesh Extraction](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/extraction/mesh.py): `gaussian_wrapping/extraction/mesh.py`
- [Standard Extraction](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/convert.py): `gaussian_wrapping/convert.py`
- [Adaptive Meshing](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/primal_adaptive_meshing_extraction.py): `gaussian_wrapping/primal_adaptive_meshing_extraction.py`
- [Mesh Data Model](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/scene/mesh.py): `gaussian_wrapping/scene/mesh.py`
- [Texture Refinement](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/texture_mesh.py): `gaussian_wrapping/texture_mesh.py`

### Scene Tools

- [Blender Bounds Add-on](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/blender/bounding_volume_addon.py): `gaussian_wrapping/blender/bounding_volume_addon.py`
- [Mesh Evaluation](https://github.com/diego1401/gaussianwrapping/tree/main/gaussian_wrapping/eval): `gaussian_wrapping/eval`
- [Geometry Utilities](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/geometry_utils.py): `gaussian_wrapping/utils/geometry_utils.py`
- [General Utilities](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/general_utils.py): `gaussian_wrapping/utils/general_utils.py`
- [Graphics Utilities](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/graphics_utils.py): `gaussian_wrapping/utils/graphics_utils.py`
- [Spherical Harmonics](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/sh_utils.py): `gaussian_wrapping/utils/sh_utils.py`
- [Tetrahedral Utilities](https://github.com/diego1401/gaussianwrapping/blob/main/gaussian_wrapping/utils/tetmesh.py): `gaussian_wrapping/utils/tetmesh.py`

### Other components

- **Researcher**
- **COLMAP Dataset**

## Connections

- Researcher → Gaussian Training: starts training
- COLMAP Dataset → Gaussian Training: provides data
- Gaussian Training → Scene Loading: loads scene (evidence: `gaussian_wrapping/train.py`)
- Gaussian Training → Camera Model: uses cameras (evidence: `gaussian_wrapping/train.py`)
- Gaussian Training → Gaussian Model: optimizes (evidence: `gaussian_wrapping/train.py`)
- Gaussian Training → Renderer Selection: renders views (evidence: `gaussian_wrapping/train.py`)
- Gaussian Training → Normal Regularization: applies regularization (evidence: `gaussian_wrapping/train.py`)
- Gaussian Training → Training Regularizers: applies regularization (evidence: `gaussian_wrapping/train.py`)
- Renderer Selection → RaDeGS Renderer: dispatches (evidence: `gaussian_wrapping/gaussian_renderer/__init__.py`)
- Renderer Selection → SOF Renderer: dispatches (evidence: `gaussian_wrapping/gaussian_renderer/__init__.py`)
- Renderer Selection → CUDA Rasterizers: calls rasterizer (evidence: `gaussian_wrapping/gaussian_renderer/__init__.py`)
- Normal Regularization → Depth Fusion: uses fusion (evidence: `gaussian_wrapping/regularization/normal_field.py`)
- Researcher → Standard Extraction: runs extraction
- Standard Extraction → Pivot Extraction: extracts pivots
- Pivot Extraction → Gaussian Model: reads Gaussians (evidence: `gaussian_wrapping/extraction/pivots.py`)
- Pivot Extraction → Normal Regularization: uses normals (evidence: `gaussian_wrapping/extraction/pivots.py`)
- Standard Extraction → Mesh Extraction: builds mesh
- Researcher → Adaptive Meshing: runs PAM
- Adaptive Meshing → Mesh Data Model: reconstructs surface
- Researcher → Blender Bounds Add-on: exports bounds
- Blender Bounds Add-on → Adaptive Meshing: provides bounds
- Standard Extraction → Texture Refinement: refines texture
- Standard Extraction → Mesh Evaluation: evaluates mesh
- Geometry Utilities → Camera Model: transforms points (evidence: `gaussian_wrapping/utils/geometry_utils.py`)
- Geometry Utilities → General Utilities: uses rotations (evidence: `gaussian_wrapping/utils/geometry_utils.py`)
- Camera Model → Graphics Utilities: builds transforms (evidence: `gaussian_wrapping/scene/cameras.py`)
- Gaussian Model → General Utilities: uses utilities (evidence: `gaussian_wrapping/scene/gaussian_model.py`)
- Gaussian Model → Spherical Harmonics: uses harmonics (evidence: `gaussian_wrapping/scene/gaussian_model.py`)
- Mesh Data Model → Tetrahedral Utilities: uses tetrahedra
