IPC 开源项目使用教程

1. 项目的目录结构及介绍

IPC 项目的目录结构如下：

IPC/
├── cmake/
├── Format/
├── input/
├── output/
├── src/
├── tests/
├── tools/
├── wiki/
├── .clang-format
├── .gitignore
├── CMakeLists.txt
├── IPCOptions.cmake.sample
├── LICENSE
├── README.md
├── batch.py
├── batch_tetgen.py
├── build.py
├── build.sh
└── run.sh

目录介绍

• cmake/: 包含 CMake 配置文件。
• Format/: 包含代码格式化配置文件（需要 clang-format）。
• input/: 包含输入数据和脚本，用于重新运行论文中的所有示例以及一些教程示例。
• output/: 输出数据目录（将在运行时创建）。
• src/: 源代码目录。
• tests/: 单元测试目录。
• tools/: 包含 Python 和 Bash 脚本，用于生成和处理结果。
• wiki/: 包含 Github Wiki 页面使用的图片。
• .clang-format: 代码格式化配置文件。
• .gitignore: Git 忽略文件配置。
• CMakeLists.txt: CMake 主配置文件。
• IPCOptions.cmake.sample: CMake 配置示例文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• batch.py: 用于自动运行一批示例的 Python 脚本。
• batch_tetgen.py: 用于自动使用 Tetgen 对一批封闭表面网格进行四面体化的 Python 脚本。
• build.py: 用于自动构建 IPC 的 Python 脚本。
• build.sh: 用于构建 IPC 的 Bash 脚本。
• run.sh: 用于运行 IPC 的 Bash 脚本。

2. 项目的启动文件介绍

启动文件

• run.sh: 这是 IPC 项目的启动脚本。它用于处理输入文件并生成输出结果。

使用方法

./run.sh

该脚本会处理 input/ 目录中的所有输入文件，并使用 12 个 CPU 核心进行处理。所有输入场景将按顺序处理。

3. 项目的配置文件介绍

配置文件

• CMakeLists.txt: 这是 CMake 的主配置文件，用于配置项目的构建选项。
• IPCOptions.cmake.sample: 这是一个 CMake 配置示例文件，展示了如何配置 IPC 项目。

配置选项

• IPC_WITH_CHOLMOD: 是否启用 CHOLMOD 线性系统求解器（默认启用）。
• IPC_WITH_AMGCL: 是否启用 AMGCL 线性系统求解器（默认启用）。
• IPC_WITH_OPENGL: 是否启用 OpenGL 查看器（默认启用）。

示例配置

# 启用 CHOLMOD 线性系统求解器
set(IPC_WITH_CHOLMOD ON)

# 启用 AMGCL 线性系统求解器
set(IPC_WITH_AMGCL ON)

# 禁用 OpenGL 查看器
set(IPC_WITH_OPENGL OFF)

通过修改 CMakeLists.txt 文件中的这些选项，可以自定义 IPC 项目的构建配置。