Qisen Wang · Yifan Zhao* · Jia Li
International Journal of Computer Vision (IJCV), 2026
git clone https://github.com/iCVTEAM/Morpheus3D.git
cd Morpheus3D
export CUDA_HOME=/usr/local/cuda-11.3
export PATH="$CUDA_HOME/bin:$PATH"
export TORCH_CUDA_ARCH_LIST=8.6
export TCNN_CUDA_ARCHITECTURES=86
conda env create -f environment.yaml
conda activate morpheus3dDownload and configure all weights required by the three training stages and metrics with:
./download_weights.shThe two evaluation datasets are included under load/data:
| Dataset | Directory | Scenes |
|---|---|---|
| RealFusion15 | load/data/realfusion15 |
15 |
| MorpheusObj30 | load/data/morpheusobj30 |
30 |
Run the complete pipeline and evaluate both datasets:
./run_reproduction.sh --gpu 0By default, this processes every scene in RealFusion15 and MorpheusObj30 and writes to a new timestamped directory under outputs/. For a one-scene test:
./run_reproduction.sh --dataset realfusion15 --scene banana --gpu 0
./run_reproduction.sh --dataset morpheusobj30 --scene scene_00 --gpu 0Useful options include:
# Select an explicit output directory; it must be absent or empty.
./run_reproduction.sh --gpu 0 --output-root outputs/my-run
# Inspect the top-level commands without training or evaluation.
./run_reproduction.sh --dataset realfusion15 --scene banana --gpu 0 --dry-runUse ./run_reproduction.sh --help for the complete command-line interface.
Training automatically renders test views at the end of each stage. The end-to-end script evaluates the texture-stage renderings with all five metrics. To evaluate an existing RealFusion15 run manually:
python metric_utils.py \
--input-path load/data \
--pred-path outputs/my-run/realfusion15/morpheus3d-texture \
--datasets realfusion15 \
--metrics clip maniqa clipiqa psnr lpips \
--device 0 \
--iter 5000 \
--save-dir outputs/my-run/metricsIf you find this project useful, please cite:
@article{DBLP:journals/ijcv/WangZL26,
author = {Qisen Wang and
Yifan Zhao and
Jia Li},
title = {Single Image to Textured 3D Object Generation in Frequency Domain:
From Theory to Pipeline},
journal = {Int. J. Comput. Vis.},
volume = {134},
number = {8},
pages = {352},
year = {2026},
url = {https://doi.org/10.1007/s11263-026-02946-5},
doi = {10.1007/S11263-026-02946-5},
timestamp = {Sat, 08 Aug 2026 20:33:00 +0200},
biburl = {https://dblp.org/rec/journals/ijcv/WangZL26.bib},
bibsource = {dblp computer science bibliography, https://dblp.org}
}This project builds on ThreeStudio, Zero-1-to-3, Prompt-Free Diffusion, Magic123, RealFusion. We thank the authors for releasing their work.
The Morpheus3D code developed for this repository is released under the MIT License. Bundled third-party components remain subject to their respective licenses; see the third-party license notices.

