Legion 技术文档

Legion 是一种面向分布式异构机器的并行编程模型。以下为 Legion 的安装指南、使用说明以及 API 使用文档。

1. 安装指南

Legion 支持在 Linux、macOS 或其他 Unix 系统上运行。以下是安装 Legion 所需的依赖和环境：

• 操作系统：Linux、macOS 或其他 Unix
• 编译器：C++ 17 或更高版本（GCC、Clang、Intel 或 PGI）和 GNU Make
• 可选依赖：
  • CMake 3.16 或更高版本
  • Python 3.5 或更高版本（用于工具和 Python 绑定，注意：tools/legion_prof.py 需要 Python 3.8 或更高版本）
  • Rust 1.74 或更高版本（用于 Rust 分析器）
  • CUDA 10.0 或更高版本（用于 NVIDIA GPU）
  • GASNet（用于网络，请参考安装说明）
  • LLVM 7-14（用于动态代码生成）
  • HDF5（用于文件 I/O）

安装步骤如下：

git clone https://github.com/StanfordLegion/legion.git
export LG_RT_DIR="$PWD/legion/runtime"
cd legion/examples/circuit
make
./circuit

2. 项目使用说明

Legion 项目的目录结构如下：

• tutorial：教程 源代码
• examples：用于高级编程技巧的示例
• apps：几个完整的 Legion 应用程序
• language：Regent 编程语言 编译器和示例
• runtime：核心运行时组件
  • legion：Legion 运行时（见 legion.h）
  • realm：Realm 低级运行时（见 realm.h）
  • mappers：几个映射器，包括默认映射器（见 default_mapper.h）
• tools：杂项工具
  • legion_spy.py：用于任务依赖的可视化工具
  • legion_prof.py：任务级分析器

3. 项目 API 使用文档

Legion 提供了丰富的 API，包括以下内容：

• 数据结构：用于描述程序数据结构的逻辑区域
• 任务创建与调度：创建并行任务，并调度到不同的处理器执行
• 数据映射：将逻辑区域映射到物理内存
• 性能分析：获取任务和内存映射的性能数据

更多关于 Legion API 的使用，请参考官方文档。

4. 项目安装方式

Legion 的安装方式如下：

• 克隆 Legion 仓库
• 设置 LG_RT_DIR 环境变量，指向 Legion 运行时目录
• 进入示例目录，并执行 make 命令编译示例程序
• 运行编译成功的示例程序

例如：

git clone https://github.com/StanfordLegion/legion.git
export LG_RT_DIR="$PWD/legion/runtime"
cd legion/examples/circuit
make
./circuit

以上就是关于 Legion 的技术文档，希望对您有所帮助。