SDFusion开源项目下载与安装教程

1. 项目介绍

SDFusion 是一个基于扩散模型的3D形状生成器，它支持多种输入模态，包括部分形状、图像和文本。该项目能够处理多种条件模态，并控制每种模态的强度。此外，它还支持将预训练的2D模型用于3D形状的纹理处理，并可以使用3D打印机打印生成的形状。

2. 项目下载位置

项目托管在 GitHub 上，您可以访问以下位置进行下载：

https://github.com/yccyenchicheng/SDFusion.git

3. 项目安装环境配置

配置环境

首先，您需要配置Python环境。推荐使用Conda进行环境管理。

conda create -n sdfusion python=3.8 -y && conda activate sdfusion

接下来，安装所需的Python包：

conda install pytorch==1.9.0 torchvision==0.10.0 torchaudio==0.9.0 cudatoolkit=11.3 -c pytorch -c conda-forge -y
conda install -c fvcore -c iopath -c conda-forge fvcore iopath -y
conda install pytorch3d -c pytorch3d
pip install h5py joblib termcolor scipy einops tqdm matplotlib opencv-python PyMCubes imageio trimesh omegaconf tensorboard notebook

图片示例

以下是Conda环境创建和激活的示例：

4. 项目安装方式

下载项目

从GitHub克隆项目到本地：

git clone https://github.com/yccyenchicheng/SDFusion.git

下载预训练权重

创建一个文件夹用于保存预训练权重：

mkdir saved_ckpt

然后下载预训练权重到该文件夹：

# VQVAE's checkpoint
wget https://uofi.box.com/shared/static/zdb9pm9wmxaupzclc7m8gzluj20ja0b6.pth -O saved_ckpt/vqvae-snet-all.pth

# SDFusion
wget https://uofi.box.com/shared/static/ueo01ctnlzobp2dmvd8iexy1bdsquuc1.pth -O saved_ckpt/sdfusion-snet-all.pth

# SDFusion: single-view reconstruction (img2shape)
wget https://uofi.box.com/shared/static/01hnf7pbewft4115qkvv9zhh22v4d8ma.pth -O saved_ckpt/sdfusion-img2shape.pth

# SDFusion: text-guided shape generation (txt2shape)
wget https://uofi.box.com/shared/static/vyqs6aex3rwbgxweyl3qh21c8p6vu33f.pth -O saved_ckpt/sdfusion-txt2shape.pth

# SDFusion: multi-modal conditional shape generation (partial shape + [ img [and/or] txt] -> shape)
wget https://uofi.box.com/shared/static/d95l3465arc0ffley5vwmz8bscaubmhc.pth -O saved_ckpt/sdfusion-mm2shape.pth

5. 项目处理脚本

根据项目官方文档，您可以通过运行以下命令来预处理数据和使用预训练模型：

# 示例：预处理ShapeNet数据集
mkdir -p data/ShapeNet && cd data/ShapeNet
wget [url for downloading ShapeNetV1]
unzip ShapeNetCore_v1.zip
/launchers/unzip_snet_zipfiles.sh
cd preprocess
/launchers/launch_create_sdf_shapenet.sh

请注意，上述命令中的 [url for downloading ShapeNetV1] 应替换为ShapeNet官方提供的下载链接。

以上步骤将帮助您成功下载并安装SDFusion项目。您可以参考官方文档中的其他脚本和命令来进行更详细的操作。