How abu2005g/arkit_to_3dgsformat works
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: main.py Pipeline CLI · pointcloud.py Point Cloud Builder · fusion.py Cloud Fusion · gaussian_init.py 3DGS Initialization
Components 18
Capture Ingestion
- Pipeline CLI
preprocessing/main.py - Archive I/O
preprocessing/io_utils.py - Frame Dataset
preprocessing/dataset.py - RGB-D Builder
preprocessing/rgbd_builder.py
Frame Quality
- Capture Validation
preprocessing/validation.py - Multiview Filtering
preprocessing/multiview_filter.py
3D Processing
- Point Cloud Builder
preprocessing/pointcloud.py - Coordinate Geometry
preprocessing/geometry.py - Cloud Fusion
preprocessing/fusion.py - Cloud Refinement
preprocessing/refinement.py
Reconstruction Outputs
- TSDF Integration
preprocessing/tsdf.py - Mesh Reconstruction
preprocessing/mesh.py - 3DGS Initialization
preprocessing/gaussian_init.py
Shared Foundations
- RGB-D Frame Types
preprocessing/rgbd_types.py - Processing Settings
preprocessing/config.py
Other components
- Dataset User
- ARKit ZIP
- 3D Export Files
Connections 24
- Dataset User → Pipeline CLI: selects mode
README.md - ARKit ZIP → Archive I/O: extracts from
preprocessing/io_utils.py - Pipeline CLI → Archive I/O: extracts archive
README.md - Pipeline CLI → Frame Dataset: loads frames
README.md - Frame Dataset → RGB-D Builder: builds frames
preprocessing/dataset.py - RGB-D Builder → RGB-D Frame Types: creates
preprocessing/rgbd_builder.py - Pipeline CLI → Capture Validation: checks frames
preprocessing/main.py - Pipeline CLI → Multiview Filtering: runs filtering
README.md - Pipeline CLI → Point Cloud Builder: builds clouds
README.md - Point Cloud Builder → Coordinate Geometry: backprojects depth
preprocessing/pointcloud.py - Pipeline CLI → Cloud Fusion: fuses frames
README.md - Cloud Fusion → Point Cloud Builder: builds frame clouds
preprocessing/fusion.py - Cloud Fusion → Cloud Refinement: refines cloud
preprocessing/fusion.py - Pipeline CLI → TSDF Integration: integrates frames
README.md - Pipeline CLI → Mesh Reconstruction: reconstructs surfaces
README.md - Pipeline CLI → 3DGS Initialization: exports initialization
README.md - 3DGS Initialization → Frame Dataset: reads frame metadata
preprocessing/gaussian_init.py - Pipeline CLI → Processing Settings: uses defaults
preprocessing/main.py - Point Cloud Builder → Processing Settings: reads thresholds
preprocessing/pointcloud.py - Cloud Refinement → Processing Settings: reads settings
preprocessing/refinement.py - TSDF Integration → 3D Export Files: writes volume outputs
README.md - Mesh Reconstruction → 3D Export Files: exports meshes
README.md - 3DGS Initialization → 3D Export Files: writes COLMAP files
preprocessing/gaussian_init.py - Pipeline CLI → 3D Export Files: saves results
README.md