# abu2005g/arkit_to_3dgsformat architecture

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

- Interactive diagram: https://gitdiagram.com/abu2005g/arkit_to_3dgsformat
- Repository: https://github.com/abu2005g/arkit_to_3dgsformat

## Overview

This framework turns ARKit ZIP captures into metrically scaled 3D outputs. Its main workflow extracts and loads synchronized RGB-D frames, checks calibration and tracking, then produces point clouds, TSDF reconstructions, meshes, and COLMAP-compatible 3D Gaussian Splatting initializations. Geometry, refinement, and configuration are shared internal layers. The README documents the available modes; sampled excerpts show only parts of their orchestration, so some documented links use the README as evidence.

Main entry points: [`preprocessing/main.py`](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/main.py) (Pipeline CLI), [`preprocessing/pointcloud.py`](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/pointcloud.py) (Point Cloud Builder), [`preprocessing/fusion.py`](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/fusion.py) (Cloud Fusion), [`preprocessing/gaussian_init.py`](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/gaussian_init.py) (3DGS Initialization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Capture Ingestion"]
  node_cli["Pipeline CLI<br/>[main.py]"]
  node_io["Archive I/O<br/>[io_utils.py]"]
  node_dataset["Frame Dataset<br/>[dataset.py]"]
  node_builder["RGB-D Builder<br/>[rgbd_builder.py]"]
end

subgraph group_quality["Frame Quality"]
  node_validation["Capture Validation<br/>[validation.py]"]
  node_multiview["Multiview Filtering"]
end

subgraph group_geometry["3D Processing"]
  node_pointcloud["Point Cloud Builder<br/>[pointcloud.py]"]
  node_geometry_ops["Coordinate Geometry<br/>[geometry.py]"]
  node_fusion["Cloud Fusion<br/>[fusion.py]"]
  node_refinement["Cloud Refinement<br/>[refinement.py]"]
end

subgraph group_outputs["Reconstruction Outputs"]
  node_tsdf["TSDF Integration<br/>[tsdf.py]"]
  node_mesh["Mesh Reconstruction<br/>[mesh.py]"]
  node_gaussian["3DGS Initialization<br/>[gaussian_init.py]"]
end

subgraph group_shared["Shared Foundations"]
  node_frame["RGB-D Frame Types<br/>[rgbd_types.py]"]
  node_config["Processing Settings<br/>[config.py]"]
end

node_user(("Dataset User"))
node_archive["ARKit ZIP"]
node_output_files["3D Export Files"]

node_user -->|"selects mode"| node_cli
node_archive -->|"extracts from"| node_io
node_cli -->|"extracts archive"| node_io
node_cli -->|"loads frames"| node_dataset
node_dataset -->|"builds frames"| node_builder
node_builder -->|"creates"| node_frame
node_cli -->|"checks frames"| node_validation
node_cli -->|"runs filtering"| node_multiview
node_cli -->|"builds clouds"| node_pointcloud
node_pointcloud -->|"backprojects depth"| node_geometry_ops
node_cli -->|"fuses frames"| node_fusion
node_fusion -->|"builds frame clouds"| node_pointcloud
node_fusion -->|"refines cloud"| node_refinement
node_cli -->|"integrates frames"| node_tsdf
node_cli -->|"reconstructs surfaces"| node_mesh
node_cli -->|"exports initialization"| node_gaussian
node_gaussian -->|"reads frame metadata"| node_dataset
node_cli -->|"uses defaults"| node_config
node_pointcloud -->|"reads thresholds"| node_config
node_refinement -->|"reads settings"| node_config
node_tsdf -->|"writes volume outputs"| node_output_files
node_mesh -->|"exports meshes"| node_output_files
node_gaussian -->|"writes COLMAP files"| node_output_files
node_cli -->|"saves results"| node_output_files

click node_cli "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/main.py"
click node_io "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/io_utils.py"
click node_dataset "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/dataset.py"
click node_builder "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/rgbd_builder.py"
click node_frame "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/rgbd_types.py"
click node_validation "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/validation.py"
click node_multiview "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/multiview_filter.py"
click node_pointcloud "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/pointcloud.py"
click node_geometry_ops "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/geometry.py"
click node_fusion "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/fusion.py"
click node_refinement "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/refinement.py"
click node_tsdf "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/tsdf.py"
click node_mesh "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/mesh.py"
click node_gaussian "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/gaussian_init.py"
click node_config "https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/config.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_cli,node_io,node_dataset,node_builder,node_user toneBlue
class node_validation,node_multiview toneAmber
class node_pointcloud,node_geometry_ops,node_fusion,node_refinement toneMint
class node_tsdf,node_mesh,node_gaussian toneRose
class node_frame,node_config,node_archive,node_output_files toneIndigo
```

## Components

### Capture Ingestion

- [Pipeline CLI](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/main.py): `preprocessing/main.py`
- [Archive I/O](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/io_utils.py): `preprocessing/io_utils.py`
- [Frame Dataset](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/dataset.py): `preprocessing/dataset.py`
- [RGB-D Builder](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/rgbd_builder.py): `preprocessing/rgbd_builder.py`

### Frame Quality

- [Capture Validation](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/validation.py): `preprocessing/validation.py`
- [Multiview Filtering](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/multiview_filter.py): `preprocessing/multiview_filter.py`

### 3D Processing

- [Point Cloud Builder](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/pointcloud.py): `preprocessing/pointcloud.py`
- [Coordinate Geometry](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/geometry.py): `preprocessing/geometry.py`
- [Cloud Fusion](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/fusion.py): `preprocessing/fusion.py`
- [Cloud Refinement](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/refinement.py): `preprocessing/refinement.py`

### Reconstruction Outputs

- [TSDF Integration](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/tsdf.py): `preprocessing/tsdf.py`
- [Mesh Reconstruction](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/mesh.py): `preprocessing/mesh.py`
- [3DGS Initialization](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/gaussian_init.py): `preprocessing/gaussian_init.py`

### Shared Foundations

- [RGB-D Frame Types](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/rgbd_types.py): `preprocessing/rgbd_types.py`
- [Processing Settings](https://github.com/abu2005g/arkit_to_3dgsformat/blob/main/preprocessing/config.py): `preprocessing/config.py`

### Other components

- **Dataset User**
- **ARKit ZIP**
- **3D Export Files**

## Connections

- Dataset User → Pipeline CLI: selects mode (evidence: `README.md`)
- ARKit ZIP → Archive I/O: extracts from (evidence: `preprocessing/io_utils.py`)
- Pipeline CLI → Archive I/O: extracts archive (evidence: `README.md`)
- Pipeline CLI → Frame Dataset: loads frames (evidence: `README.md`)
- Frame Dataset → RGB-D Builder: builds frames (evidence: `preprocessing/dataset.py`)
- RGB-D Builder → RGB-D Frame Types: creates (evidence: `preprocessing/rgbd_builder.py`)
- Pipeline CLI → Capture Validation: checks frames (evidence: `preprocessing/main.py`)
- Pipeline CLI → Multiview Filtering: runs filtering (evidence: `README.md`)
- Pipeline CLI → Point Cloud Builder: builds clouds (evidence: `README.md`)
- Point Cloud Builder → Coordinate Geometry: backprojects depth (evidence: `preprocessing/pointcloud.py`)
- Pipeline CLI → Cloud Fusion: fuses frames (evidence: `README.md`)
- Cloud Fusion → Point Cloud Builder: builds frame clouds (evidence: `preprocessing/fusion.py`)
- Cloud Fusion → Cloud Refinement: refines cloud (evidence: `preprocessing/fusion.py`)
- Pipeline CLI → TSDF Integration: integrates frames (evidence: `README.md`)
- Pipeline CLI → Mesh Reconstruction: reconstructs surfaces (evidence: `README.md`)
- Pipeline CLI → 3DGS Initialization: exports initialization (evidence: `README.md`)
- 3DGS Initialization → Frame Dataset: reads frame metadata (evidence: `preprocessing/gaussian_init.py`)
- Pipeline CLI → Processing Settings: uses defaults (evidence: `preprocessing/main.py`)
- Point Cloud Builder → Processing Settings: reads thresholds (evidence: `preprocessing/pointcloud.py`)
- Cloud Refinement → Processing Settings: reads settings (evidence: `preprocessing/refinement.py`)
- TSDF Integration → 3D Export Files: writes volume outputs (evidence: `README.md`)
- Mesh Reconstruction → 3D Export Files: exports meshes (evidence: `README.md`)
- 3DGS Initialization → 3D Export Files: writes COLMAP files (evidence: `preprocessing/gaussian_init.py`)
- Pipeline CLI → 3D Export Files: saves results (evidence: `README.md`)
