MCPcopy Create free account
hub / github.com/YunzeMan/Situation3D

github.com/YunzeMan/Situation3D @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
1,411 symbols 3,749 edges 129 files ⚖ MIT 331 documented · 23% updated 21mo ago★ 445 open issues

Browse by type

Functions 1,152 Types & classes 257 Endpoints 2
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Situational Awareness Matters in 3D Vision Language Reasoning

Yunze Man · Liang-Yan Gui · Yu-Xiong Wang

[CVPR 2024] [Project Page] [arXiv] [pdf] [BibTeX]

Framework: PyTorch arXiv Project YouTube GitHub License

This repository contains the official PyTorch implementation of the paper "Situational Awareness Matters in 3D Vision Language Reasoning" (CVPR 2024). The paper is available on arXiv. The project page is online at here.

About

Previous methods perform direct 3D vision language reasoning without modeling the situation of an embodied agent in the 3D environment. Our method, SIG3D, grounds the situational description in the 3D space, and then re-encodes the visual tokens from the agent's intended perspective before vision-language fusion, resulting in a more comprehensive and generalized 3D vision language (3DVL) representation and reasoning pipeline.

Environmet Setup and Dataset Preparation

Please install the required packages and dependencies according to the environment.yml.

In addition, - in order to use the SQA3D dataset, please follow this repo to download the dataset and necessary toolsets. - in order to use the ScanQA dataset, please follow this repo to download the dataset and necessary toolsets. - in order to use the 3D-LLM backbone model, please follow this repo to install necessary dependencies and download the pre-trained model.

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.

The latest code implementation and models will be out recently. Please stay tuned.

BibTeX

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

@inproceedings{man2024situation3d,
      title={Situational Awareness Matters in 3D Vision Language Reasoning},
      author={Man, Yunze and Gui, Liang-Yan and Wang, Yu-Xiong},
      booktitle={CVPR},
      year={2024} 
      }

Acknowledgements

This repo is built based on the fantastic work SQA3D, ScanQA, and 3D-LLM. We thank the authors for their great work and open-sourcing their codebase.

Core symbols most depended-on inside this repo

browse all functions →

Shape

Method 780
Function 372
Class 257
Route 2

Languages

Python99%
C++1%

Modules by API surface

3DLLM_BLIP2-base/lavis/models/blip2_models/modeling_t5.py79 symbols
3DLLM_BLIP2-base/lavis/models/med.py74 symbols
3DLLM_BLIP2-base/lavis/models/blip2_models/Qformer.py67 symbols
3DLLM_BLIP2-base/lavis/models/blip2_models/modeling_opt.py41 symbols
3DLLM_BLIP2-base/lavis/runners/runner_base.py35 symbols
3DLLM_BLIP2-base/lavis/processors/randaugment.py34 symbols
3DLLM_BLIP2-base/lavis/models/eva_vit.py34 symbols
lib/openscene/augmentation.py30 symbols
situation3d/utils/pc_utils.py29 symbols
3DLLM_BLIP2-base/lavis/common/config.py29 symbols
situation3d/models/mcan_sqa_module.py28 symbols
lib/pointnet2/pointnet2_utils.py27 symbols

For agents

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

⬇ download graph artifact

Ask about this repo answers extend the page