安装与编译¶

系统要求¶

编译环境¶

组件	最低版本	推荐版本
C++编译器	C++17	GCC 11+, Clang 14+
CMake	3.15	3.25+
MPI	3.0	OpenMPI 4.1+
OpenMP	4.5	5.0+

可选组件¶

组件	版本	说明
CUDA	11.0+	GPU加速
HIP	5.0+	AMD GPU加速
MKL/OpenBLAS	-	高性能线性代数

操作系统¶

Linux (Ubuntu 20.04+, CentOS 8+)
macOS (Monterey 12+)
Windows (WSL2 recommended)

依赖安装¶

Ubuntu/Debian¶

sudo apt update
sudo apt install -y \
    build-essential \
    cmake \
    libopenmpi-dev \
    openmpi-bin \
    libomp-dev \
    libblas-dev \
    liblapack-dev

macOS (Homebrew)¶

brew install \
    cmake \
    open-mpi \
    libomp \
    openblas \
    lapack

Windows (WSL2)¶

# 在WSL2 Ubuntu中执行上述Ubuntu命令

编译步骤¶

# 1. 克隆仓库
git clone https://github.com/yourusername/PhysEngine.git
cd PhysEngine

# 2. 创建构建目录
mkdir build && cd build

# 3. 配置CMake
cmake .. \
    -DCMAKE_BUILD_TYPE=Release \
    -DAMREX_SPACEDIM=3 \
    -DENABLE_MPI=ON \
    -DENABLE_OPENMP=ON

# 4. 编译
cmake --build . -j $(nproc)

# 5. 安装（可选）
cmake --install .

CMake选项¶

选项	默认值	说明
CMAKE_BUILD_TYPE	Release	编译类型（Debug/Release）
AMREX_SPACEDIM	3	空间维度（2或3）
ENABLE_MPI	ON	启用MPI并行
ENABLE_OPENMP	ON	启用OpenMP并行
ENABLE_CUDA	OFF	启用CUDA GPU支持
ENABLE_HIP	OFF	启用HIP GPU支持

GPU编译¶

CUDA¶

cmake .. \
    -DCMAKE_BUILD_TYPE=Release \
    -DENABLE_CUDA=ON \
    -DCUDA_ARCH=80

HIP¶

cmake .. \
    -DCMAKE_BUILD_TYPE=Release \
    -DENABLE_HIP=ON \
    -DAMDGPU_TARGETS=gfx908

验证安装¶

# 运行测试
ctest --output-on-failure

# 查看帮助
./PhysEngine --help