3D GAUSSIAN SPLATTING TUTORIAL (ONE CLICK INSTALL)
For those looking for a one click (almost solution) there’s this nifty little tool called pinokio that auto installs dependencies and environments (yeah including conda) for running web apps and python based scripts with one click install and run.
Summary:
- Install Pinokio:
https://docs.pinokio.computer/download/windows.html - Install NVIDIA CUDA 11.8:
https://developer.download.nvidia.com/compute/cuda/11.8.0/local_installers/cuda_11.8.0_522.06_windows.exe
(Or newer)
https://developer.nvidia.com/cuda-11-8-0-download-archive?target_os=Windows&target_arch=x86_64&target_version=10&target_type=exe_local - Open Pinokio and click on DISCOVER
- Paste the Gaussian Splatting GIT URL:
https://github.com/bycloud-AI/gaussian-splatting-Windows.git - Click on “One click Install with Pinokio”
- After Downloading everything, click on “INSTALL”, this will run the python scripts, setup the conda environment, and install almost everything needed for it.
- Once its done, it will pop a Command Window, before you can use it you need to run the next two commands
pip install submodules\diff-gaussian-rasterization
pip install submodules\simple-knn
- Once they are installed, you can run the normal python commands for COLMAP, Training and Viewing
There are 3 steps to follow in order to get a gaussian splat:
- Place your image sequence on input_data/YOURPROJECT then run the following python command:
python convert.py -s input_data/YOURPROJECT --colmap_executable COLMAP-3.8-windows-cuda\COLMAP.bat
- After the COLMAP has been extracted, you gotta create the Gaussian Splat by training it with the following command:
python train.py -s input_data/YOURPROJECT
- Once the training is finished, the Gaussian Splat will be located at the folder “Output”, from there you gotta rename the last created folder to the name of YOURPROJECT, eg.
Created folder was named “de225777-e” at “output”, so you gotta rename it to “YOURPROJECT” - Once you renamed the folder, you can view your Gaussian Splat by running this python command:
start viewers/bin/SIBR_GaussianViewer_app.exe . -m output\YOURPROJECT
TUTORIAL
Gaussian Splatting GITHUB PINOKIO
https://github.com/bycloud-AI/gaussian-splatting-Windows
GAUSSIAN SPLATTING
Notes:
Remember to install CUDA 11.8 onwards
IF you get a “ModuleNotFoundError: No module named ‘diff_gaussian_rasterization'” Error
Download CUDA 11.8. https://developer.nvidia.com/cuda-11-8-0-download-archive
It should be installed according to your system, and to get whether if you have installed correctly, you can double check with this method: https://github.com/bycloudai/SwapCudaVersionWindows
Common ERRORS:
I’m getting the following error, can anyone help beyond this point (gaussian_splatting) C:\Windows\System32\gaussian-splatting>python train.py -s data/MetalContainer
Traceback (most recent call last):
File “train.py”, line 16, in
from gaussian_renderer import render, network_gui
File “C:\Windows\System32\gaussian-splatting\gaussian_renderer_init_.py”, line 14, in
from diff_gaussian_rasterization import GaussianRasterizationSettings, GaussianRasterizer
ModuleNotFoundError: No module named ‘diff_gaussian_rasterization’
You need to run the PIP commands within the CMD window of the pinokio after you’ve installed CUDA 11.8
Hi, you need to install the submodules in cli navigate to the root folder of this repo.pip install submodules\diff-gaussian-rasterization
pip install submodules\simple-knn
If running these produces an error then you might need to re-clone the repo with the –recursive flag
Then re-install