Awesome

Lexicon3D: Probing Visual Foundation Models for Complex 3D Scene Understanding

<a href="https://yunzeman.github.io/" style="color:blue;">Yunze Man</a> · <a href="https://zsh2000.github.io/" style="color:blue;">Shuhong Zheng</a> · <a href="https://zpbao.github.io/" style="color:blue;">Zhipeng Bao</a> · <a href="http://www.cs.cmu.edu/~hebert" style="color:blue;">Martial Hebert</a> · <a href="https://cs.illinois.edu/about/people/department-faculty/lgui" style="color:blue;">Liang-Yan Gui</a> · <a href="https://yxw.web.illinois.edu/" style="color:blue;">Yu-Xiong Wang</a>

[arXiv Preprint] [Project Page] [arXiv] [pdf] [BibTeX]

This repository contains the official PyTorch implementation of the paper "Lexicon3D: Probing Visual Foundation Models for Complex 3D Scene Understanding". The paper is available on arXiv. The project page is online at here.

About

<img src="assets/visualization.png" width="100%"/> <img src="assets/pipeline.png" width="100%"/> We design a unified framework, as shown in the Figure above, to extract features from different foundation models, construct a 3D feature embedding as scene embeddings, and evaluate them on multiple downstream tasks. For a complex indoor scene, existing work usually represents it with a combination of 2D and 3D modalities. Given a complex scene represented in posed images, videos, and 3D point clouds, we extract their feature embeddings with a collection of vision foundation models. For image- and video-based models, we project their features into 3D space for the subsequent 3D scene evaluation tasks with a multi-view 3D projection module. <br><br>

We also visualize the scene features extracted by the vision foundation models.

BibTeX

If you use our work in your research, please cite our publication:

@article{man2024lexicon3d,
      title={Lexicon3D: Probing Visual Foundation Models for Complex 3D Scene Understanding},
      author={Man, Yunze and Zheng, Shuhong and Bao, Zhipeng and Hebert, Martial and Gui, Liang-Yan and Wang, Yu-Xiong},
      journal={arXiv preprint arXiv:2409.03757},
      year={2024} 
      }

News

09/05/2024: Release the foundation model feature extraction and fusion scripts.
06/24/2024: GitHub page initialization.

TODO

Environment Setup

Please install the required packages and dependencies according to the requirements.txt file.

In addition,

in order to use the LSeg model, please follow this repo to install the necessary dependencies.
in order to use the Swin3D model, please follow this repo and this repo to install the necessary dependencies.

Finally, please download the ScanNet dataset from the official website and follow the instructions here to preprocess the ScanNet dataset and get RGB video frames and point clouds for each scannet scene.

Feature Extraction

To extract features from the foundation models, please run the corresponding scripts in the lexicon3d folder. For example, to extract features from the LSeg model, please run the following command:

python fusion_scannet_clip.py  --data_dir dataset/ScanNet/openscene/  --output_dir  dataset/lexicon3d/clip/ --split train --prefix clip

This script will extract features from the LSeg model for the ScanNet dataset. The extracted features will be saved in the output_dir folder, containing the feature embeddings, points, and voxel grids.

Acknowledgements

This repo is built based on the fantastic work OpenScene. We also thank the authors of P3DA and the authors of all relevant visual foundation models for their great work and open-sourcing their codebase.