pycolab 游戏引擎。

一个高度可定制的网格世界游戏引擎，自带一些实用工具。你可以创建自己的网格世界游戏来测试强化学习智能体！

玩玩几个游戏吧！

如果你是新手，不妨先试试玩几个游戏？为了在大多数类 UNIX 系统上获得完整的彩色体验：

1. 打开一个不错的现代终端（Mac 上可以使用 iTerm2，Linux 上可以使用 GNOME 终端或 xterm）。暂时避免使用 screen 或 tmux——请直接使用终端。
2. 将终端类型设置为 xterm-256color（通常可以通过在命令行中输入 export TERM=xterm-256color 来完成）。
3. 运行示例游戏！一种简单的方法是：进入 pycolab/ 库目录的上一级目录（即 Git 仓库的根目录或分发 tarball 的根目录，如果你使用的是这些方式之一），然后在设置了适当的 PYTHONPATH 环境变量的情况下运行 Python。以下是一个适用于 bash 类 shell 的示例命令： PYTHONPATH=. python -B pycolab/examples/scrolly_maze.py。

好吧，先安装一些依赖项。

如果上述步骤没有成功，你可能需要获取 pycolab 所依赖的以下软件包：

1. Python 2.7，或者 Python 3.4 及以上版本。我们曾在 2.7.6、3.4.3 和 3.6.3 版本上取得成功；其他版本也可能适用。
2. Numpy。我们使用的版本是 1.13.3，但 1.9 版本似乎也具备所需的功能。
3. Scipy，不过仅用于运行其中一个示例。我们使用的是 0.13.3 版本。

概述

pycolab 具有详尽的文档和注释，因此理解如何使用它的最佳方式是：

• 查看 examples/ 子目录中的示例；
• 阅读 .py 文件中的文档字符串。

对于阅读文档字符串，推荐的顺序如下（可以根据需要随时停止，文档不会消失）：

1. engine.py 中 Engine 类的文档字符串；
2. things.py 中各类的文档字符串。

这两部分可能是了解 examples/ 目录中内容所需的“必读”部分。在此之后，以下内容也可能对你有所帮助：

3. plot.py：游戏组件之间如何交互？我该如何给智能体奖励并结束回合？
4. human_ui.py：我如何亲自试玩我的游戏？
5. prefab_parts/sprites.py：一些有用的 Sprite 子类，包括 MazeWalker——一个可以在迷宫中行走但无法穿过墙壁和障碍物的像素。
6. cropping.py：如何通过巧妙地裁剪观察结果，围绕某个移动的游戏元素来营造俯视滚动的视觉效果？（这是在游戏中引入部分可观测性的一种常见方法。）

别忘了，你也可以随时阅读测试代码。这些测试代码可以通过实例演示各个组件的具体功能。

免责声明

这不是 Google 的官方产品。

我们只是觉得你应该知道这一点。

pycolab 快速上手指南

pycolab 是一个高度可定制的网格世界（gridworld）游戏引擎，专为测试强化学习智能体而设计。它内置了丰富的基础组件，帮助开发者快速构建自定义游戏环境。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：推荐 UNIX 兼容系统（Linux 或 macOS），以获得完整的彩色终端体验。
• Python 版本：Python 2.7 或 Python 3.4+（已在 2.7.6, 3.4.3, 3.6.3 上验证通过）。
• 核心依赖：
  • numpy (推荐 1.9+)
  • scipy (仅运行部分示例时需要，推荐 0.13.3+)

提示：国内用户建议使用清华源或阿里源加速安装依赖： pip install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy scipy

安装步骤

pycolab 无需复杂的编译安装过程，只需克隆代码库并配置环境变量即可使用。

1. 获取源码 克隆仓库或下载分发包到本地：

   git clone https://github.com/deepmind/pycolab.git
   cd pycolab
   

2. 安装依赖 在项目根目录下安装必要的 Python 包：

   pip install numpy scipy
   

基本使用

1. 运行示例游戏

最直接的上手方式是运行官方提供的示例游戏。请确保在包含 pycolab/ 目录的根目录下执行以下命令。

步骤：

1. 打开现代终端（如 Mac 的 iTerm2 或 Linux 的 gnome-terminal）。
2. 设置终端类型以支持 256 色：

   export TERM=xterm-256color
   

3. 运行示例脚本（以 scrolly_maze.py 为例）：

   PYTHONPATH=. python -B pycolab/examples/scrolly_maze.py
   

   注意：暂时避免在 screen 或 tmux 会话中运行，直接使用终端以获得最佳视觉效果。

2. 开发自定义游戏

要开始编写自己的游戏逻辑，建议按以下顺序阅读源码文档（Docstrings）：

1. 核心引擎：阅读 engine.py 中的 Engine 类文档，理解游戏循环机制。
2. 游戏对象：阅读 things.py 中的各类定义，了解如何创建玩家、墙壁等实体。
3. 进阶功能（可选）：
   • plot.py：学习如何处理奖励信号和回合终止。
   • human_ui.py：了解如何集成人工交互界面。
   • prefab_parts/sprites.py：使用预制的精灵子类（如 MazeWalker 实现可移动但不能穿墙的角色）。
   • cropping.py：学习如何通过裁剪观测视野来模拟局部可观察性（Partial Observability）。

此外，直接阅读 tests/ 目录下的测试代码也是理解各组件用法的绝佳途径。