OP2-Common 的安装和配置教程

项目基础介绍

OP2-Common 是一个开源项目，它是 OP2 框架的一部分。OP2 是一个用于编写在多核和多众核架构上自动并行化的非结构网格算法的高级嵌入式领域特定语言。该语言嵌入在 C/C++ 和 Fortran 中，使得开发者能够利用现有的编程知识和工具来开发高效的并行计算应用。

主要编程语言

• Python：用于编写代码转换器。
• C++：OP2 的运行时库主要使用 C++ 开发。
• Fortran：提供了 Fortran 的绑定支持。

项目使用的关键技术和框架

• 并行计算：利用多核和多众核架构进行自动并行化。
• 嵌入式领域特定语言（DSL）：允许开发者使用熟悉的语言结构来描述算法，而无需关注底层的并行化细节。
• MPI（Message Passing Interface）：用于在多节点上实现进程间的通信。
• Scotch 和 ParMETIS：用于网格划分的库。
• HDF5：用于支持高效的数据存储和访问。

准备工作

在开始安装之前，确保您的系统已安装以下依赖项：

1. GNU Make 版本大于 4.2
2. C/C++ 编译器：支持的编译器有 GCC、Clang、Cray、Intel、IBM XL 和 NVHPC。
3. （可选）Fortran 编译器：支持的编译器有 GFortran、Cray、Intel、IBM XL 和 NVHPC。
4. （可选）MPI 实现：支持带有 mpicc、mpicxx 和 mpif90 包装器的任何实现。
5. （可选）NVIDIA CUDA 版本大于 9.2

此外，以下库可能需要手动构建：

• （可选）(PT-)Scotch：用于 MPI 网格划分。
• （可选）ParMETIS：用于 MPI 网格划分，构建时需要 32 位索引并禁用 -DSCOTCH_PTHREAD。
• （可选）HDF5：用于 HDF5 I/O，可以构建支持或不支持 MPI 的版本。

安装步骤

1. 克隆仓库到本地环境：

git clone https://github.com/OP-DSL/OP2-Common.git

2. 根据您的编译器和系统环境，设置相应的环境变量。例如：

export OP2_COMPILER=gnu # 或者 cray, intel, xl, nvhpc
# 或者
export OP2_C_COMPILER=gnu
export OP2_C_CUDA_COMPILER=nvhpc
export OP2_F_COMPILER=gfortran

3. 设置依赖库的安装路径（如果需要的话）：

export PTSCOTCH_INSTALL_PATH=/path/to/ptscotch
export PARMETIS_INSTALL_PATH=/path/to/parmetis
export HDF5_SEQ_INSTALL_PATH=/path/to/hdf5-sequential
export HDF5_PAR_INSTALL_PATH=/path/to/hdf5-parallel
export CUDA_INSTALL_PATH=/path/to/cuda-toolkit
export NV_ARCH="Fermi,Kepler,Ampere"

4. 在 op2 目录下运行 make config 来验证编译器、库和编译标志：

cd OP2-Common/op2
make config

5. 构建运行时库：

make -j$(nproc)

6. 如果需要，构建示例应用程序：

cd ../apps/app-name
make -j$(nproc)

按照上述步骤操作，您应该能够成功安装和配置 OP2-Common 项目。如果在安装过程中遇到任何问题，请查阅项目文档或向项目维护者寻求帮助。