Packing Generation 项目安装与使用教程

1. 项目目录结构及介绍

packing-generation/
├── PackingGeneration/
│   ├── _Debug/
│   ├── _DebugTests/
│   ├── _Release/
│   ├── _ReleaseTests/
│   ├── cproject/
│   ├── project/
│   ├── LICENSE.txt
│   ├── PackingGeneration.sln
│   ├── README.md
│   └── packing_generation.ipynb
├── Tests/
├── Docs/
│   ├── Architecture.txt
│   ├── Compilation.txt
│   └── ...
├── Externals/
├── Examples/
└── ...

目录结构说明

• PackingGeneration/: 项目的主要代码目录，包含源文件、调试和发布版本、项目文件等。

  • _Debug/: 调试版本的输出目录。
  • _DebugTests/: 调试版本的测试输出目录。
  • _Release/: 发布版本的输出目录。
  • _ReleaseTests/: 发布版本的测试输出目录。
  • cproject/: 项目配置文件目录。
  • project/: 项目源文件目录。
  • LICENSE.txt: 项目许可证文件。
  • PackingGeneration.sln: 项目解决方案文件。
  • README.md: 项目介绍和使用说明。
  • packing_generation.ipynb: Jupyter Notebook 文件，可能包含代码示例或文档。

• Tests/: 测试代码目录。

• Docs/: 项目文档目录，包含编译和架构说明。

• Externals/: 外部依赖或库目录。

• Examples/: 示例文件目录，包含示例配置和输出文件。

2. 项目启动文件介绍

项目的启动文件是 PackingGeneration.sln，这是一个 Visual Studio 解决方案文件。通过打开此文件，可以在 Visual Studio 中加载整个项目，并进行编译和运行。

启动步骤

1. 打开 Visual Studio。
2. 选择“文件” -> “打开” -> “项目/解决方案”。
3. 导航到 PackingGeneration.sln 文件并打开。
4. 在 Visual Studio 中，选择合适的配置（Debug 或 Release），然后点击“启动”按钮（通常是绿色的播放按钮）来运行项目。

3. 项目的配置文件介绍

项目的配置文件主要位于 PackingGeneration/ 目录下，包括 generation.conf 和 diameters.txt 等。

generation.conf 配置文件

generation.conf 文件用于配置硬球填充生成算法的参数。以下是一些关键参数的说明：

Particles count: 10000  # 粒子数量
Packing size: 20.0823593086113 20.0823593086113 20.0823593086113  # 填充盒子的尺寸
Generation start: 0  # 生成开始状态（0：使用预生成填充，1：生成新的泊松填充）
Seed: 341  # 随机数种子
Steps to write: 1000  # 写入临时状态的步数
Boundaries mode: 1  # 边界模式（1：体模式，2：椭球模式，3：矩形模式）
Contraction rate: 1.328910e-002  # 收缩率
Generation mode: 1  # 生成模式（1：泊松，2：单元泊松）

diameters.txt 配置文件

diameters.txt 文件用于指定粒子的直径。每行一个直径值，如果没有提供此文件，所有粒子的直径将默认为1.0。

1.2
1.3
1.4
...

通过这些配置文件，用户可以自定义硬球填充生成的参数，以满足不同的研究需求。