跳到主要内容

当前参考 distribution

CartPole-v1

通过左右推动小车来保持杆竖直。这是公开 Benchmark authoring surface 的最小完整参考。

01

Policy 可见契约

Policy.act() 接收一个严格包含四个有限浮点数的有序列表,并返回一个精确整数 Action。

索引分量含义范围
0cart_position小车水平位置[-4.8, 4.8]
1cart_velocity小车水平速度unbounded
2pole_angle杆的弧度角≈ [-0.418, 0.418]
3pole_angular_velocity杆的角速度unbounded
0向左推动
1向右推动
严格 Action 处理

非法 Action 不会被截断、修复、转换或替换。

02

Episode 生命周期

  1. 派生按 split 隔离的 Environment seed。
  2. 创建新的 Environment 与 Policy process。
  3. 只允许状态在同一 Episode 的 act() 调用间保留。
  4. 在终止、500 步或 Policy failure 时停止。
03

Reward 与评分

每次合法 Environment step 贡献 +1。Benchmark score 是各 Episode 计分的算术平均值;Policy failure 贡献 0。

04

安装与评估

uv sync --project environments/gymnasium/classic_control/cartpole --extra dev
uv build environments/gymnasium/classic_control/cartpole