uaamg项目下载及安装教程

1. 项目介绍

uaamg（Unsmoothed Aggregation Algebraic Multigrid）是一个用于大规模不可压缩流体仿真的快速无平滑聚合代数多级框架。该框架基于OpenVDB数据结构，并通过SIMD指令集进行加速。它包含了一个FLIP模拟器、一个泊松求解器和一种变分粘度方程求解器。本项目适用于大规模流体动力学模拟，相关研究成果已发表在ACM Transaction on Graphics期刊。

2. 项目下载位置

项目托管在GitHub上，您可以通过以下地址下载项目源码：

https://github.com/kaust-csg-uaamg/uaamg.git

3. 项目安装环境配置

在安装之前，需要确保以下依赖环境已经安装：

• OpenVDB
• Eigen3
• Intel TBB
• yaml-cpp

以下为环境配置的步骤：

安装vcpkg

首先，从GitHub上克隆vcpkg仓库：

git clone https://github.com/microsoft/vcpkg

然后，进入vcpkg目录并执行安装脚本：

cd vcpkg
bootstrap-vcpkg.bat

安装依赖库

使用vcpkg安装所需的依赖库：

vcpkg install openvdb:x64-windows eigen3:x64-windows tbb:x64-windows yaml-cpp:x64-windows

示例图片

以下是vcpkg安装依赖库的示例截图：

图片描述：vcpkg安装依赖库的命令行界面

4. 项目安装方式

以下为项目的安装步骤：

1. 克隆项目仓库：

git clone https://github.com/kaust-csg-uaamg/uaamg.git

2. 使用CMake构建项目。以下以Windows平台为例：

• 打开CMake GUI，选择项目源码路径和构建目录。
• 添加CMAKE_TOOLCHAIN_FILE缓存条目，指向vcpkg目录中的buildsystems/vcpkg.cmake文件。
• 点击“Configure”按钮，选择“x64”作为生成器。
• 点击“Generate”生成Visual Studio解决方案文件。

3. 使用Visual Studio打开生成的解决方案文件，并构建项目。

5. 项目处理脚本

项目中的处理脚本主要用于配置和运行模拟。具体的使用方法请参考项目README文件中的说明。以下是一个基本的配置文件示例：

output_prefix: "simulation_result"
time_step: 0.04167
simulation_time: 10.0
init_vel_[x y z]: [0.0 0.0 0.0]
FLIP_domain_collision: true
FLIP_domain_solid: true
FLIP_solid_friction: 0.5
FLIPCFL: 0.5
FLIP_min_step_num: 2
FLIP_max_step_num: 10
pressure_acc: 1e-6
viscosity_acc: 1e-6
FLIPpool-min[x y z]: [-1.0 -1.0 -1.0]
FLIPpool-max[x y z]: [1.0 1.0 1.0]
FLIPdx: 0.02
enable_viscosity: true
viscosity_coef: 0.001
solids_vdb: "solids.vdb"
source_vdb: "source.vdb"
dynamic_obj_enabled: false
dynamic_obj_folder: "dynamic_objects"
dynamic_obj_prefix: "solid"

请根据具体需求修改配置文件中的参数。