# 安装与编译 ## 基本依赖 推荐环境: - CMake 3.20 或更高。 - C++20 编译器。 - Windows 下推荐 Visual Studio 2022。 - 可选:CUDA Toolkit,用于 CUDA 构建路径。 - 可选:OpenMP,用于 CPU 多线程。 - 可选:MPI,用于分布式计算与 halo 同步。 ## CUDA 构建 项目目前常用 CUDA 13.0 构建目录: ```powershell cmake -S . -B cmake-build-cuda13 cmake --build cmake-build-cuda13 --config Release --target M3Frame ``` 如果已经生成过构建目录,只需要重新编译: ```powershell cmake --build cmake-build-cuda13 --config Release --target M3Frame ``` 主程序输出位置: ```text cmake-build-cuda13/Release/M3Frame.exe ``` 如果 CUDA 编译失败,优先检查: - CUDA Toolkit 是否安装。 - Visual Studio 版本是否被 CUDA 支持。 - CMake 是否找到正确的 `nvcc`。 - 是否启用了不支持的 GPU 架构。 ## Debug 构建 ```powershell cmake -S . -B cmake-build-debug cmake --build cmake-build-debug --config Debug ``` Debug 构建便于定位 XML 解析、网格质量、接触和材料本构问题。 ## Examples 构建 案例 benchmark 通常在独立 examples 构建目录中: ```powershell cmake -S examples -B cmake-build-examples-migrated cmake --build cmake-build-examples-migrated --config Debug ``` 也可以只构建一个目标: ```powershell cmake --build cmake-build-examples-migrated --config Debug --target benchmark_sph_oscillating_droplet ``` 注意:benchmark 程序一般只读取结果并计算误差。运行 benchmark 前,应先用 `M3Frame.exe pipeline.xml` 生成结果。 ## OpenMP OpenMP 主要用于: - 粒子划分。 - 网格采样。 - 邻域搜索。 - FEM/SPH 部分循环。 是否启用由 CMake 配置和编译器能力决定。案例 XML 中通常通过 `backend="openmp"` 或并行参数控制。 Windows 运行时可以通过环境变量设置线程数: ```powershell $env:OMP_NUM_THREADS=4 .\cmake-build-cuda13\Release\M3Frame.exe examples\...\pipeline.xml ``` ## MPI MPI 当前用于: - SPH halo 同步。 - 并行邻域搜索框架。 - 部分粒子和网格生成任务。 Windows 下通常依赖 Microsoft MPI。若未安装 MPI,应关闭相关选项或使用非 MPI 构建。 ## 推荐构建矩阵 | 用途 | 构建目录 | 配置 | 说明 | |---|---|---|---| | 日常运行 | `cmake-build-cuda13` | `Release` | 主程序和较快算例。 | | 调试 | `cmake-build-debug` | `Debug` | 检查崩溃、断言和 XML 解析。 | | benchmark | `cmake-build-examples-migrated` | `Debug` | 运行案例验证程序。 | ## 运行检查 编译后可执行: ```powershell .\cmake-build-cuda13\Release\M3Frame.exe ``` 如果没有给出配置文件,程序应打印帮助信息或提示需要输入文件。之后用一个轻量案例检查完整流程: ```powershell .\cmake-build-cuda13\Release\M3Frame.exe examples\sph\benchmarks\oscillating_droplet\pipeline.xml ``` ## 常见编译问题 | 问题 | 建议 | |---|---| | 找不到 CUDA | 检查 `CUDA_PATH` 和 CMake CUDA 编译器。 | | MSBuild 访问 SDK 被拒绝 | 用普通终端或管理员权限重新构建。 | | CUDA 与 MSVC 不兼容 | 调整 Visual Studio 工具集或 CUDA 版本。 | | 链接库冲突 | 检查 Release/Debug 运行库设置。 | | 头文件找不到 | 确认从项目根目录配置 CMake。 | | benchmark 找不到结果 | 先运行对应 `pipeline.xml`。 |