MeshAnything 项目使用教程

MeshAnything 项目使用教程

MeshAnything From anything to mesh like human artists 项目地址: https://gitcode.com/gh_mirrors/me/MeshAnything

1. 项目介绍

MeshAnything 是一个基于自回归变换器的艺术家创建网格生成项目。该项目旨在通过自动回归变换器生成类似于人类艺术家创作的网格。MeshAnything 的官方实现基于 "MeshAnything: Artist-Created Mesh Generation with Autoregressive Transformers" 论文。

项目的主要功能包括：

• 从任何输入生成类似于人类艺术家创作的网格。
• 支持多种输入类型，如网格和点云。
• 提供本地 Gradio 演示和命令行推理功能。

2. 项目快速启动

环境准备

MeshAnything 项目已经在 Ubuntu 22, CUDA 11.8 环境下测试通过，推荐使用 A100, A800 或 A6000 显卡。

安装步骤

1. 克隆项目仓库并进入项目目录：

   git clone https://github.com/buaacyw/MeshAnything.git && cd MeshAnything
   

2. 创建并激活 Conda 环境：

   conda create -n MeshAnything python==3.10.13 -y
   conda activate MeshAnything
   

3. 安装 PyTorch 和其他依赖：

   pip install torch==2.1.1 torchvision==0.16.1 torchaudio==2.1.1 --index-url https://download.pytorch.org/whl/cu118
   pip install -r requirements.txt
   pip install flash-attn --no-build-isolation
   

使用示例

本地 Gradio 演示

运行以下命令启动本地 Gradio 演示：

python app.py

命令行推理

1. 文件夹输入：

   python main.py --input_dir examples --out_dir mesh_output --input_type mesh
   

2. 单文件输入：

   python main.py --input_path examples/wand.obj --out_dir mesh_output --input_type mesh
   

3. 使用 Marching Cubes 预处理：

   python main.py --input_dir examples --out_dir mesh_output --input_type mesh --mc
   

点云推理

1. 文件夹输入：

   python main.py --input_dir pc_examples --out_dir pc_output --input_type pc_normal
   

2. 单文件输入：

   python main.py --input_path pc_examples/mouse.npy --out_dir pc_output --input_type pc_normal
   

3. 应用案例和最佳实践

应用案例

MeshAnything 可以应用于以下场景：

• 3D 模型生成：从简单的输入生成复杂的 3D 网格模型。
• 艺术创作：帮助艺术家快速生成复杂的 3D 艺术作品。
• 虚拟现实：用于生成虚拟现实环境中的 3D 模型。

最佳实践

• 输入质量：确保输入的网格或点云质量较高，以获得更好的生成结果。
• 硬件要求：推荐使用高性能 GPU（如 A100, A800 或 A6000）以加快生成速度。
• 参数调整：根据具体需求调整命令行参数，以获得最佳的生成效果。

4. 典型生态项目

MeshAnything 可以与其他 3D 生成和处理项目结合使用，例如：

• DreamCraft3D：用于生成高质量的 3D 模型。
• MeshGPT：基于 GPT 的网格生成项目。
• Michelangelo：用于 3D 模型的生成和编辑。

通过结合这些项目，可以进一步提升 MeshAnything 的生成效果和应用范围。

MeshAnything From anything to mesh like human artists 项目地址: https://gitcode.com/gh_mirrors/me/MeshAnything