explaingit

toruhashimoto/3dgs-floater-cleaner

Analysis updated 2026-05-18

2PythonAudience · generalComplexity · 4/5Setup · hard

TLDR

A Windows desktop tool that reduces floating stray points in 3D Gaussian Splatting reconstructions by applying a geometry regularizer during training, rather than cleaning the input point cloud.

Mindmap

mindmap
  root((3dgs-floater-cleaner))
    What it does
      Reduces 3DGS floaters
      Uses scale_reg regularizer
      One click Windows tool
    Tech stack
      Python
      Tkinter
      CUDA
      LichtFeld Studio
    Use cases
      Clean photogrammetry scans
      Compare detail presets
      Export via SuperSplat
    Requirements
      Windows and NVIDIA GPU
      RealityScan COLMAP export

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Clean up floater artifacts in a 3D Gaussian Splatting scene reconstructed from RealityScan photo data.

USE CASE 2

Choose between five detail level presets to balance reconstruction quality against processing time.

USE CASE 3

Open a cleaned reconstruction directly in SuperSplat for further editing and export.

What is it built with?

PythonTkinterCUDALichtFeld StudioSuperSplat

How does it compare?

toruhashimoto/3dgs-floater-cleaner0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity4/52/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a Windows PC with an NVIDIA GPU and the separate LichtFeld Studio training engine installed.

License not stated in the README, underlying engines have their own separate licenses.

In plain English

3DGS Floater Cleaner is a Windows desktop tool for cleaning up 3D Gaussian Splatting reconstructions. 3D Gaussian Splatting, often shortened to 3DGS, is a technique for turning a set of photos into a 3D scene made of many small blob shaped points. A common problem with these reconstructions is floaters, stray points that hang in midair and only become visible when you view the scene from certain angles. This tool takes photo data that has already been aligned with the RealityScan app and exported in COLMAP format, then trains a 3DGS scene with far fewer floaters, producing a cleaned up .ply output file with one click. The key finding behind the tool, described in its included FINDINGS document, is that cleaning up the point cloud before training does not actually reduce floaters, because the training process rebuilds background structure regardless of the starting points. What does work is a geometry regularizer called scale_reg, applied during training itself, which shrinks or removes floating points while leaving image quality mostly unchanged. The tool offers five detail level presets, from lower detail and faster processing up to a high detail default setting, and lets the user choose how strongly scale_reg is applied. After training finishes, the tool automatically counts remaining floaters and can open the result directly in SuperSplat, a separate viewer and editor, for further editing or export. An optional before and after comparison mode can show the floater reduction against an unprocessed baseline, though this roughly doubles processing time. Running the tool requires a Windows computer with an NVIDIA GPU, the LichtFeld Studio training engine which the tool can auto detect, and a standard Python 3 installation. The project bundles its own launcher script that sets up a virtual environment on first run, so no manual Python package installation is required to get started.

Copy-paste prompts

Prompt 1
Explain what causes floaters in 3D Gaussian Splatting and how scale_reg reduces them.
Prompt 2
Walk me through running 3dgs-floater-cleaner on a RealityScan to COLMAP export.
Prompt 3
What GPU and software do I need installed before using 3dgs-floater-cleaner?
Prompt 4
Summarize the FINDINGS.md conclusions about point cloud cleanup versus training time regularization.

Frequently asked questions

What is 3dgs-floater-cleaner?

A Windows desktop tool that reduces floating stray points in 3D Gaussian Splatting reconstructions by applying a geometry regularizer during training, rather than cleaning the input point cloud.

What language is 3dgs-floater-cleaner written in?

Mainly Python. The stack also includes Python, Tkinter, CUDA.

What license does 3dgs-floater-cleaner use?

License not stated in the README, underlying engines have their own separate licenses.

How hard is 3dgs-floater-cleaner to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is 3dgs-floater-cleaner for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.