理解实测挑战示例
排行榜的示例结果将分数、下载代码和查看五次运行放在一起。选择任务即可查看;示例不计入参赛者排名。
六个示例采用 WWW-POSIM 评分规则和 Python SDK 0.4.2。每个分数来自五次已完成的正式运行。提供八种语言的注释版和实际评分原始文件;发布时检查 Python AST 相同,注释不改变执行逻辑。记录保留原提交编号、运行 ID 和布局种子。
| 任务 | 代码 | 五次实测分数 | 总分 | 记录 |
|---|---|---|---|---|
surface_station |
注释版 · 评分原始文件 | 70.03, 16.03, 6.16, 0.74, 1.18 | 15.2108 | ↗ |
surface_gates |
注释版 · 评分原始文件 | 20.35, 21.27, 20.08, 15.11, 20.17 | 18.5392 | ↗ |
surface_slalom |
注释版 · 评分原始文件 | 16.00, 16.00, 16.00, 16.00, 1.00 | 10.6000 | ↗ |
underwater_gate |
注释版 · 评分原始文件 | 13.33, 13.33, 13.33, 13.33, 13.34 | 13.3338 | ↗ |
underwater_path |
注释版 · 评分原始文件 | 15.00, 15.00, 15.00, 15.00, 10.00 | 13.2002 | ↗ |
underwater_return |
注释版 · 评分原始文件 | 13.33, 10.00, 6.67, 10.00, 10.01 | 9.3347 | ↗ |
运行示例
- 下载所选语言的注释代码,保存为
main.py并在 VS Code 打开。注释说明任务与控制模块。 - 在安装版练习场选择相同任务和条件,保持 ROS 2 直接控制,启动生成的世界。
- 先点击任务卡的开始评分,再在准备好的终端运行
python main.py。完整步骤见安装版练习。 - 用 Ctrl+C 或停止输入结束,SDK 会释放控制权。检查路径后重启世界再试。
- 正式结果请按提交挑战程序操作。服务器准备 Python 和 SDK,不要在代码中加入凭据。
各控制器的作用
| 任务 | 目标 | 控制 |
|---|---|---|
surface_station |
到达目标并连续保持其位置和指定航向。 | 使用接近/保持滞回以及前进和偏航比例命令。 |
surface_gates |
依次穿过各门,沿通道返航并在起点保持。 | 使用路线目标、逆向返航点和稳态海流补偿。 |
surface_slalom |
沿浮标路线避开障碍物,返回最终保持点。 | 使用可见性图绕行、基于航向的前进限制和海流补偿。 |
underwater_gate |
下潜并依次穿过各门,满足最终深度和航向保持要求。 | 使用门平面穿越/恢复以及六推进器深度和航向控制。 |
underwater_path |
跟随水下巡检目标并满足其深度和保持要求。 | 使用巡检移动增益和限幅漂移补偿推力;门与绕行辅助函数为共享代码。 |
underwater_return |
通过水下障碍路线后返航,完成最终上浮和保持。 | 使用小型船体绕行、速度误差积分和六推进器分配。 |
路线文件共享辅助函数,mission['task'] 选择实际分支;其他任务的函数可能不被调用。目标索引是控制器自身的导航状态,服务器独立测量车辆并评分。
按模块阅读程序
-
连接与任务:
Session.local(control=True)发现已准备的会话;sim.profile['mission']提供本次目标和条件,无需硬编码位置。 -
传感器:按类型选择
nav_msgs/msg/Odometry。sim.latest(..., max_age=0.5)要求实际 0.5 秒内收到的样本;里程计 twist 使用机体坐标轴。 -
单位:map/world x,y,z 为米;z 正方向向上,水下目标为负。四元数得到的 yaw/roll 为弧度;任务 current_angle/current_swing 为度。命令:前进 m/s、yaw_rate rad/s,推进力按原生关节顺序以 N 表示。
-
导航状态:检查接近、门平面穿越和连续保持。失去条件会重置计时器;门函数假设门平面沿 X 方向设置。
-
控制:WAM-V 使用前向 m/s 和偏航 rad/s;BlueROV2 按原生顺序发送六个力 N。分配采用 45° 水平推进器以及 0.167 m 和 0.109 m 力臂。
-
时间:ROS 时间戳、保持计时器和 dt 使用仿真秒;max_age 和 duration 使用实际秒。在 duration=0.25 内 SDK 以 10 Hz 刷新命令,返回前释放命令租约。 仿真较慢时,每次调用推进的仿真时间更少。
-
停止与错误:
control_lease_ended正常结束循环,其他错误保持可见。退出Session会关闭会话并释放控制权。
根据五次记录调整
调整增益前先读注释。每次修改一个参数:距离到速度、航向增益、速度/力限制、门间距或漂移补偿。比较五种条件的路径和误差。水下循环限制积分估计并使用模型专用固定垂直配平。
显示分数来自链接的实测结果。新运行可能因环境和时序不同而变化。这些学习控制器得分有限,不保证完整自主航行。修改可执行语句会产生新控制器,需要重新评估。