### OpenCLAW 安装指南 OpenCLAW 是一个基于 OpenMP 和 MPI 的高性能计算框架，专为求解双曲型偏微分方程（如浅水方程、Euler 方程）设计，源自 Clawpack 生态系统，并扩展支持异构并行架构。其安装过程依赖于底层 Fortran/C 编译器、MPI 实现、Python 环境及可选的 OpenMP 支持。 #### 依赖项准备 OpenCLAW 要求系统预装 GNU Fortran 编译器（gfortran ≥ 10）、C 编译器（gcc ≥ 9）、MPI（如 OpenMPI 或 MPICH）、Python ≥ 3.8 及 pip 工具。若需 GPU 加速（实验性），还需 CUDA Toolkit ≥ 11.2 和支持的 NVIDIA 驱动[^1]。 #### 源码获取与构建 OpenCLAW 当前主要通过 GitHub 获取源码，不提供 PyPI 发布包。推荐使用 Git 克隆主分支并切换至稳定标签： ```bash git clone https://github.com/clawpack/openclaw.git cd openclaw git checkout v23.10.0 # 替换为最新稳定版本标签 ``` 进入 `src` 目录后，执行 `make` 命令触发 Fortran 模块编译。默认构建启用 OpenMP 并链接系统 MPI 库： ```bash cd src make clean make -j4 ``` 该步骤生成核心库 `libopenclaw.a` 及可执行模块 `xclaw`，用于运行一维/二维守恒律求解器[^1]。 #### Python 接口安装 Python 层通过 `setup.py` 构建绑定，需在项目根目录执行： ```bash pip install -e .[dev] ``` 该命令安装 `openclaw` 包及其开发依赖（包括 `clawpack`、`numpy`、`matplotlib`），并建立 Fortran-Python 接口（通过 f2py 自动封装）。验证安装可用性： ```python import openclaw print(openclaw.__version__) ``` 输出应匹配所检出的 Git 标签版本[^1]。 #### 环境变量配置 为确保运行时正确加载共享库，需将 `src/` 目录添加至 `LD_LIBRARY_PATH`（Linux/macOS）或 `DYLD_LIBRARY_PATH`（macOS）： ```bash export LD_LIBRARY_PATH="${PWD}/src:$LD_LIBRARY_PATH" ``` 同时建议将 `src/` 加入 `PATH` 以直接调用 `xclaw`： ```bash export PATH="${PWD}/src:$PATH" ``` #### 示例运行验证 进入 `examples/burgers_1d` 目录，运行标准测试案例： ```bash cd examples/burgers_1d make run ``` 该命令调用 `xclaw` 执行带激波的 Burgers 方程模拟，并生成 `fort.q*` 输出文件。后续可用 Python 脚本读取并绘图验证数值解收敛性[^1]。