MCPcopy Index your code
hub / github.com/W-Ted/F3D-Gaus

github.com/W-Ted/F3D-Gaus @main

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

F3D-Gaus: Feed-forward 3D-aware Generation on ImageNet with Cycle-Aggregative Gaussian Splatting

<a href="https://w-ted.github.io/">Yuxin Wang</a><sup>1</sup>,</span>
<a href="https://wuqianyi.top/">Qianyi Wu</a><sup>2</sup>,
<a href="https://www.danxurgb.net/">Dan Xu</a><sup>1✉️</sup>



    <sup>1</sup>Hong Kong University of Science and Technology,
    <sup>2</sup>Monash University








<a href='https://arxiv.org/abs/2501.06714' target="_blank"><img src='https://img.shields.io/badge/arXiv-2501.06714-b31b1b.svg'></a>  
<a href='https://w-ted.github.io/publications/F3D-Gaus/' target="_blank"><img src='https://img.shields.io/badge/Project-Page-Green'></a>

Demo

https://github.com/user-attachments/assets/db5c783c-1d1f-489e-8040-95353a4bb396

Updates

  • 2025/01/12: We released this repo with the pre-trained model and inference code.

Installation

git clone https://github.com/W-Ted/F3D-Gaus.git

cd F3D-Gaus
conda create -n f3d_gaus python=3.10.14 -y
conda activate f3d_gaus
pip install torch==2.0.1 torchvision==0.15.2 torchaudio==2.0.2 # pytorch=2.0.1=py3.10_cuda11.7_cudnn8.5.0_0
pip install -r requirements.txt

# GOF
cd src/gaussian-splatting
pip install submodules/diff-gof-rasterization
pip install submodules/simple-knn/

# tetra-nerf for triangulation (mesh extraction)
cd submodules/tetra-triangulation
conda install cmake -y
conda install conda-forge::gmp
conda install conda-forge::cgal
cmake .
# you can specify your own cuda path
# export CPATH=/usr/local/cuda-11.3/targets/x86_64-linux/include:$CPATH
make 
pip install -e .

Pre-trained model

We provide the pre-trained model here(~720MB). You could download it to the ''pretrained_models'' directory.

cd pretrained_models
pip install gdown && gdown 'https://drive.google.com/uc?id=1Uar3kyI5Oi5f3cZytUl5YKBkcg4HNALz'
cd ..

Inference

We provide two scripts for inference of F3D-Gaus: one for novel view synthesis and the other for subsequent mesh extraction.

# single-image novel view synthesis
bash scripts/test_nvs.sh 

# single-image mesh extraction
bash scripts/test_mesh.sh

Acknowledgements

This project is built upon G3DR and Splatter-Image. The 3DGS representation is borrowed from GOF. Kudos to these researchers.

Citation

@article{wang2025f3dgaus,
    title={F3D-Gaus: Feed-forward 3D-aware Generation on ImageNet with Cycle-Aggregative Gaussian Splatting},
    author={Wang, Yuxin and Wu, Qianyi and Xu, Dan},
    journal={arXiv preprint arXiv:2501.06714},
    year={2025}
}

Core symbols most depended-on inside this repo

to
called by 48
src/utils.py
cpu
called by 39
src/utils.py
cat
called by 39
src/utils.py
items
called by 38
src/utils.py
permute
called by 24
src/utils.py
repeat
called by 21
src/utils.py
mean
called by 18
src/utils.py
split
called by 17
src/utils.py

Shape

Function 163
Method 154
Class 50

Languages

Python93%
C++7%

Modules by API surface

src/utils.py79 symbols
src/gaussian_predictor.py55 symbols
src/gaussian-splatting/scene/gaussian_model.py29 symbols
src/gaussian_renderer/__init__.py14 symbols
src/gaussian-splatting/lpipsPyTorch/modules/networks.py14 symbols
src/gaussian-splatting/utils/general_utils.py13 symbols
src/gaussian-splatting/submodules/diff-gof-rasterization/cuda_rasterizer/auxiliary.h12 symbols
src/gaussian-splatting/scene/colmap_loader.py12 symbols
src/gaussian-splatting/arguments/__init__.py12 symbols
src/gaussian-splatting/submodules/diff-gof-rasterization/diff_gof_rasterization/__init__.py11 symbols
src/gaussian-splatting/scene/dataset_readers.py10 symbols
visualize.py9 symbols

For agents

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

⬇ download graph artifact