manhattan_sdf

zju3dv活跃维护

基于曼哈顿世界假设的神经隐式三维重建方法,利用场景中互相垂直的平面结构约束,从多视角图像重建室内房间的稠密几何。

Code for "Neural 3D Scene Reconstruction with the Manhattan-world Assumption" CVPR 2022 Oral

暂无版本533star32fork同步于 2026-11-07 07:30 UTC

怎么上手

由 README 提炼,执行前请确认
conda env create -f environment.yml
conda activate manhattan
硬件要求按 README 说明

README 未说明具体显存与 GPU 型号要求,仅示例命令使用 gpus 0 指定单卡

支持 Apple Silicon
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

基于曼哈顿世界假设的神经隐式三维场景重建,从多视角图像重建室内场景

基于曼哈顿世界假设的神经隐式三维重建方法,利用场景中互相垂直的平面结构约束,从多视角图像重建室内房间的稠密几何。

核心能力

  • 利用曼哈顿世界假设约束室内场景的平面结构
  • 基于 VolSDF 的神经隐式表面重建流程
  • 提供 ScanNet 场景的训练、网格提取与评估脚本
  • 附带论文基线方法与训练模型的定量定性结果
  • 支持在自定义数据上运行并提供说明文档

容易踩的坑

需先从 Google Drive 下载 ScanNet 场景数据并解压到 data/,且路径要与配置文件一致;运行前需按 configs/scannet/0050.yaml 中的路径核对数据位置;自定义数据需参考 docs/CUSTOM.md 另行准备

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

0 个版本

暂无 release 数据(可能没有发版,或尚未同步)。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    News

    • 06/03/2022 We provide the instruction to run on custom data here.
    • 05/10/2022 To make the comparison on ScanNet easier, we provide all quantitative and qualitative results of baselines here, including COLMAP, COLMAP*, ACMP, NeRF, UNISURF, NeuS, and VolSDF.
    • 05/10/2022 To make the following works easier to compare with our model, we provide our quantitative and qualitative results, as well as the trained models on ScanNet here.
    • 05/10/2022 We upload our processed ScanNet scene data to Google Drive.

    Neural 3D Scene Reconstruction with the Manhattan-world Assumption

    Project Page | Video | Paper

    introduction

    Neural 3D Scene Reconstruction with the Manhattan-world Assumption
    Haoyu Guo*, Sida Peng*, Haotong Lin, Qianqian Wang, Guofeng Zhang, Hujun Bao, Xiaowei Zhou
    CVPR 2022 (Oral Presentation)

    Setup

    Installation

    conda env create -f environment.yml
    conda activate manhattan
    

    Data preparation

    Download ScanNet scene data evaluated in the paper from Google Drive and extract them into data/. Make sure that the path is consistent with config file.

    We provide the instruction to run on custom data here.

    Usage

    Training

    python train_net.py --cfg_file configs/scannet/0050.yaml gpus 0, exp_name scannet_0050
    

    Mesh extraction

    python run.py --type mesh_extract --output_mesh result.obj --cfg_file configs/scannet/0050.yaml gpus 0, exp_name scannet_0050
    

    Evaluation

    python run.py --type evaluate --cfg_file configs/scannet/0050.yaml gpus 0, exp_name scannet_0050
    

    Citation

    If you find this code useful for your research, please use the following BibTeX entry.

    @inproceedings{guo2022manhattan,
      title={Neural 3D Scene Reconstruction with the Manhattan-world Assumption},
      author={Guo, Haoyu and Peng, Sida and Lin, Haotong and Wang, Qianqian and Zhang, Guofeng and Bao, Hujun and Zhou, Xiaowei},
      booktitle={CVPR},
      year={2022}
    }
    

    Acknowledgement

    • Thanks to Lior Yariv for her excellent work VolSDF.
    • Thanks to Jianfei Guo for his implementation of VolSDF neurecon.
    • Thanks to Johannes Schönberger for his excellent work COLMAP.
    • Thanks to Shaohui Liu for his customized implementation of COLMAP as a submodule of NerfingMVS.