Gaia物理引擎项目教程

Gaia物理引擎项目教程

Gaia Gaia Physics Engine 项目地址: https://gitcode.com/gh_mirrors/gaia2/Gaia

1. 项目目录结构及介绍

Gaia物理引擎项目的目录结构如下：

Gaia/
├── Data/
│   └── mesh_models/
├── Simulator/
│   ├── VBDDynamics/
│   └── PBDDynamics/
├── .gitignore
├── .gitmodules
├── LICENSE
├── README.md
└── teaser.gif

目录结构介绍

• Data/: 包含用于模拟的网格模型数据。
• Simulator/: 包含两个主要的模拟器目录：
  • VBDDynamics/: 基于Vertex Block Descent (VBD) 的模拟器。
  • PBDDynamics/: 基于Extended Position Based Dynamics (XPBD) 的模拟器。
• .gitignore: Git忽略文件，指定哪些文件和目录不应被Git跟踪。
• .gitmodules: Git子模块配置文件，用于管理项目中的子模块。
• LICENSE: 项目许可证文件，本项目使用Apache-2.0许可证。
• README.md: 项目介绍和使用说明的Markdown文件。
• teaser.gif: 项目介绍动画文件。

2. 项目启动文件介绍

Gaia物理引擎的启动文件位于Simulator/目录下，具体分为两个模拟器的启动文件：

VBDDynamics 启动文件

• VBDDynamics/CMakeLists.txt: 用于构建VBD模拟器的CMake配置文件。

PBDDynamics 启动文件

• PBDDynamics/CMakeLists.txt: 用于构建XPBD模拟器的CMake配置文件。

启动步骤

1. 克隆项目:

   git clone git@github.com:AnkaChan/Gaia.git --recursive
   

2. 构建项目:

   • 进入Simulator/VBDDynamics/或Simulator/PBDDynamics/目录。
   • 使用CMake构建项目：

     cmake .
     make
     

3. 运行模拟器:

   • 使用生成的可执行文件运行模拟器，例如：

     ./VBDDynamics [Models.json] [Parameters.json] [output-folder] -R [PATH-to-Gaia-Repository]
     

3. 项目的配置文件介绍

Gaia物理引擎的配置文件主要包括CMake配置文件和模拟参数文件。

CMake配置文件

• CMakeLists.txt: 位于Simulator/VBDDynamics/和Simulator/PBDDynamics/目录下，用于配置项目的构建选项和依赖项。

模拟参数文件

• Models.json: 指定模拟中使用的模型细节。
• Parameters.json: 包含模拟的物理参数。

配置步骤

1. 设置环境变量:

   • 确保安装了OneTBB、Eigen3和Embree，并设置环境变量：

     export Eigen3_DIR=/path/to/Eigen3/config.cmake
     export embree_DIR=/path/to/Embree/config.cmake
     

2. 修改CMake配置:

   • 根据需要修改CMakeLists.txt文件中的选项，例如：

     set(BUILD_PBD ON)
     set(BUILD_VBD ON)
     set(BUILD_GUI ON)
     

3. 生成参数文件:

   • 使用Python脚本生成Models.json和Parameters.json文件，例如：

     python /Simulator/VBDDynamics/ParameterGen/M02_GenRunningParameters.py
     

通过以上步骤，您可以成功配置和启动Gaia物理引擎项目。

Gaia Gaia Physics Engine 项目地址: https://gitcode.com/gh_mirrors/gaia2/Gaia