MCPcopy Index your code
hub / github.com/IRMVLab/SemGauss-SLAM

github.com/IRMVLab/SemGauss-SLAM @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
578 symbols 1,767 edges 91 files 102 documented · 18%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

SemGauss-SLAM: Dense Semantic Gaussian Splatting SLAM

IROS 2025

<strong>Siting Zhu</strong></a>
·
<strong>Renjie Qin</strong></a>
·
<strong>Guangming Wang</strong></a>
·
<strong>Jiuming Liu</strong></a>
·
<strong>Hesheng Wang</strong></a>

Paper

Logo

Table of Contents

  1. Installation
  2. Usage
  3. Downloads
  4. Acknowledgement
  5. Citation
  6. Developers

Installation

sem_guass_slam has been benchmarked with Python 3.10, Pytorch 1.12.1 & CUDA=11.6. The simplest way to install all dependences is to use anaconda and pip in the following steps:

conda create -n sem_gauss python=3.10
conda activate sem_gauss
conda install -c "nvidia/label/cuda-11.6.0" cuda-toolkit
conda install pytorch==1.12.1 torchvision==0.13.1 torchaudio==0.12.1 cudatoolkit=11.6 -c pytorch -c conda-forge
pip install -r requirements.txt

Usage

We will use the replica dataset as an example to show how to use sem_guass_slam. The following steps are similar for other datasets.

To run sem_guass_slam, please use the following command:

python sem_gauss.py configs/replica/replica.py

You should download the corresponding pth file of the dinov2 in here before running the command above.

To see the evaluation of the reconstructed mesh, please use the following command:

python eval_mesh/mesh_eval.py

You should rewrite the path of the reconstructed mesh flie and true mesh file in eval_mesh/mesh_eval.py. And you can download the true mesh file in here.

Downloads

Dataroot is ./data0/replica by default. Please change the input_folder path in the scene-specific config files if datasets are stored somewhere else on your machine.

Replica

Download the replica data on this website:replica. Note that the Replica data is generated by the authors of iMAP (but hosted by the authors of NICE-SLAM). Please cite iMAP if you use the data.

ScanNet

Please follow the data downloading procedure on the ScanNet website, and extract color/depth frames from the .sens file using this code.

Acknowledgement

We thank the authors of the following repositories for their open-source code:

Citation

If you find our paper and code useful, please cite us:

@INPROCEEDINGS{zhu2024semgauss,
  author={Zhu, Siting and Qin, Renjie and Wang, Guangming and Liu, Jiuming and Wang, Hesheng},
  booktitle={IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS)}, 
  title={SemGauss-SLAM: Dense Semantic Gaussian Splatting SLAM}, 
  year={2025},
  pages={21174-21181}
}

Core symbols most depended-on inside this repo

print
called by 42
segmentation/facebookresearch_dinov2_main/dinov2/distributed/__init__.py
update
called by 18
segmentation/facebookresearch_dinov2_main/dinov2/logging/helpers.py
split
called by 18
segmentation/facebookresearch_dinov2_main/dinov2/data/datasets/image_net.py
max
called by 17
segmentation/facebookresearch_dinov2_main/dinov2/logging/helpers.py
load
called by 15
segmentation/facebookresearch_dinov2_main/dinov2/fsdp/__init__.py
get
called by 12
utils/segmentationMetric.py
build_rotation
called by 10
utils/slam_external.py
update
called by 8
utils/segmentationMetric.py

Shape

Method 264
Function 242
Class 72

Languages

Python97%
C++3%

Modules by API surface

segmentation/facebookresearch_dinov2_main/dinov2/data/datasets/image_net_22k.py29 symbols
segmentation/facebookresearch_dinov2_main/dinov2/data/datasets/image_net.py29 symbols
segmentation/facebookresearch_dinov2_main/dinov2/eval/linear.py23 symbols
segmentation/facebookresearch_dinov2_main/dinov2/distributed/__init__.py21 symbols
segmentation/facebookresearch_dinov2_main/dinov2/data/samplers.py21 symbols
segmentation/facebookresearch_dinov2_main/dinov2/models/vision_transformer.py20 symbols
segmentation/facebookresearch_dinov2_main/dinov2/logging/helpers.py19 symbols
segmentation/facebookresearch_dinov2_main/dinov2/eval/knn.py19 symbols
datasets/gradslam_datasets/geometryutils.py19 symbols
segmentation/facebookresearch_dinov2_main/hubconf.py15 symbols
segmentation/facebookresearch_dinov2_main/dinov2/layers/block.py15 symbols
datasets/gradslam_datasets/basedataset.py15 symbols

For agents

$ claude mcp add SemGauss-SLAM \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact