WWW-POSIM v0.6.15课程与挑战
文档菜单
WWW-POSIM / 课程与挑战

提交挑战程序

在 VS Code 编辑代码,上传网站后通过邮件接收结果。服务器运行程序与仿真,提交被接受后即可关闭网页。

1. 准备账户和 VS Code

  1. 在 www-posim.vercel.app 注册,点击验证邮件中的按钮,再登录。
  2. 账户需要服务器访问权限。页面提示权限不足时请联系课程组织者。
  3. 安装 VS Code 和 Microsoft 的 Python 扩展。
  4. 在“文档”创建 posim-competition,通过文件 → 打开文件夹打开。

网站提交不要求本地安装 ROS 或 Docker。服务器准备 Python 和连接。不要在代码中放密码。当前排行榜采用现行规则下已完成的提交。

2. 创建 main.py

从下表下载与任务对应的注释版。首次提交请选择 surface_station。将文件保存为 main.py,然后在 VS Code 中打开。评分原始文件使用相同的程序逻辑。参阅理解实测挑战示例了解代码如何运行。

任务 代码 五次实测分数 总分 记录
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 ↗

3. 上传代码

  1. 打开自主航行挑战,选择与示例对应的任务。
  2. 输入公开队名,例如 MyTeam。
  3. 选择 main.py,点击提交并评估。
  4. 等待接受编号,在我的提交查看状态。

多文件程序使用 ZIP,将 main.py 放在根目录,并包含辅助 Python 文件。只打包源代码,不要包含 .venv、已下载软件包或结果目录。上传限制为 1 MiB。

每个版本有独立编号和结果。同一页面重复发送未修改的表单会复用请求。连接错误或重新加载后,先检查我的提交,再重新选择文件。提交修改版时,重新选择已保存文件。

4. 等待服务器和邮件

接受后可退出登录,电脑无需继续联网。服务器容量有限,评估需要排队。一次提交在所有人共同的目标、风和海流条件下,运行同一任务五次,每个路线之间与其他排队者轮换。网站画质较低,分数来自实测仿真状态。

每个账户每项任务每天可提交两次,在韩国时间 00:00(UTC+9)重置。页面显示当前任务剩余额度。任何路线评分前取消不计数;已有评分路线的失败或取消计数。重试已接受请求不额外消耗次数。本地练习不使用服务器额度。

页面显示队列位置和 2 / 5 等进度。120–300 秒是仿真时间:速度 0.15× 时,300 秒约需实际 33 分钟。每个路线最多允许 60 分钟评分,加上有界准备和保存时间。五次路线加排队可能持续数小时。完成邮件含分数和链接,需登录查看;也可检查垃圾邮件或网站保存结果。

服务器故障会自动将同一提交放回队列,保留已保存路线,从中断路线重试,无需重新上传或额外消耗每日次数。重试从 30 秒后开始,持续故障时退避最多 15 分钟。结果显示下次可重试时间、最近错误及时间、重试次数和支持邮箱,恢复后仍保留。联系时提供提交编号。Python 错误或无效控制命令需要修改代码后重新提交。

5. 查看结果并改进

  1. 在我的提交点击查看结果。
  2. 选择一次评估,用播放记录和时间滑块检查路径、目标、距离、时间、误差、状态和五次总分。程序输出显示 print() 和错误。
  3. 下载结果保存 JSON,在 VS Code 查看 report 中的 completion、position_rms_m、heading_rms_rad、collision_proxies。
  4. 修改一处,保存后提交新版本。

完成五次的提交可进入对应规则版本的排行榜。其他规则的结果链接仍可访问,但不进入当前排名。若排队或运行时规则变化,提交会停止,并在结果和邮件解释原因。保留已有记录,请按现行规则重新提交。

失败和取消保留诊断,不替换已完成排名。取消停止排队或运行中的提交。替换适用于尚无评分的排队提交;新提交被接受前,旧提交继续排队。若取消在最终分数保存前被接受,已完成路线仍保存,但整次提交不计入排名。

出错时

ZIP 文件名

文件和目录名称须保持大小写一致:main.py 与 MAIN.py 不能共存,同一路径不能同时是文件和目录。避免 Windows 设备名(如 CON.py)、保留字符,以及以点或空格结尾的目录名。每个文件或目录名称须在 255 个 UTF-8 字节以内,非 ASCII 字符可能占多个字节。缩短或更名后更新 import,再创建 ZIP。被拒绝的上传不消耗额度,也不修改待替换提交。

在安装版练习同一任务

  1. 按安装打开应用,以已验证账户登录。
  2. 在工作区 → 练习场 → 准备竞赛场地创建共同场地,无需下载地图。
  3. 在车辆 → 自主航行挑战·可选选择任务和评估条件 1–5,自动选取对应布局种子。
  4. 保持 ROS 2 直接控制,进入确认 → 启动生成世界,等待机器人就绪。
  5. 从启动器创建 Python 项目,按控制桌面版工作区在 VS Code 打开,保存 main.py。
  6. 在车辆面板任务卡先点击开始评分,再运行代码。海流与评分计时同时启动。
  7. 在准备好的终端执行:
python main.py

用 Ctrl+C 停止,导出分数和路径,下次试验前重启世界。尝试五个条件后再正式上传。练习 JSON 包含 seed、执行的 course(目标、障碍、容差和海流启用时刻)、测量 trace 和评分 report。

如果显示启动状态未确认,先检查世界和进度再重试;请求可能已被接受。一个世界同一时间只能启动一个评估;其他标签已请求评分时,先查看任务卡。

场地、起点、布局、风、海流和规则与网站对应条件一致。本地分数仅用于练习,实际速度和浮点结果可能随电脑变化。物理目标 1×,步长 10 ms。普通应用的停止输入在运行中记录原因并中断,评分结束后则等待保存并保留完成分数。导出后用新世界再试。Dev 应用提供不计分的开发练习;正式分数通过网站提交获得。

用 ROS 读取 WAM-V LiDAR 和相机

准备场地,选择 WAM-V → 避开浮标并靠泊 (surface_slalom) → 条件 1。启用前向相机与 2D LiDAR,保持 ROS 2 直接控制并启动世界。等待实时数据,检查传感器时不要开始评分。此任务有四个黑色障碍浮标;surface_gates 使用红绿门浮标。自由探索的两个浮标示例是另一种布局。

使用 CLI 准备项目

CLI 是用文字命令操作同一应用。使用普通终端和新项目目录;ros init 不会覆盖已有文件。

Windows — PowerShell:

$app = Join-Path $env:LOCALAPPDATA "Programs/WWW-POSIM/WWW-POSIM.exe"
$project = Join-Path ([Environment]::GetFolderPath('MyDocuments')) "wamv-sensors"
& $app ros init $project
& $app ros connect --workspace $project
& $app ros shell --workspace $project

Mac — 终端:

app=/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM
project="$HOME/Documents/wamv-sensors"
"$app" ros init "$project"
"$app" ros connect --workspace "$project"
"$app" ros shell --workspace "$project"

Ubuntu — 终端:

project="$HOME/wamv-sensors"
www-posim ros init "$project"
www-posim ros connect --workspace "$project"
www-posim ros shell --workspace "$project"

应用准备共享 ROS 中继:Windows/Linux 使用控制容器,Mac 使用附带原生环境。在打开的 shell 执行:

ros2 topic list -t
ros2 topic echo /vehicle/sensors/lidar_2d --once --field header
ros2 topic echo /vehicle/sensors/camera/compressed --once --field format

生成世界发布 /vehicle/sensors/lidar_2d 和 /vehicle/sensors/camera/compressed。其他世界可能使用 /model/wamv/scan、/model/wamv/camera/compressed 等名称。按 sensor_msgs/msg/LaserScan 和 sensor_msgs/msg/CompressedImage 类型选择。第二条命令输出时间和坐标系,第三条输出 jpeg;--once 收到一条消息后结束。列出话题不代表已收到数据。输入 exit 返回原终端。

保存和绘制实测数据

将 wamv_sensors.py 保存到项目。它使用已准备的 rclpy、标准消息、Matplotlib 和 Pillow,先在 10 秒内按类型发现话题,再最多等 60 秒获取新鲜数据对。缺少传感器或数据时返回含恢复说明的错误。多个传感器时添加 --camera-topic TOPIC 或 --scan-topic TOPIC;选择会打印并写入 JSON。

订阅使用中继的 Reliable QoS:

qos = QoSProfile(depth=10, reliability=ReliabilityPolicy.RELIABLE,
                 durability=DurabilityPolicy.VOLATILE)
node.create_subscription(LaserScan, topics["scan"], scan_callback, qos)
node.create_subscription(CompressedImage, topics["camera"],
                         camera_callback, qos)

LaserScan.ranges 单位为米。对索引 i 计算 angle_min + i * angle_increment,再计算 x = range * cos(angle)、y = range * sin(angle)。忽略无效和超量程点,聚合相邻近点并用圆包围小候选组。将 CompressedImage.data 解码为 JPEG,与 LiDAR 图并排显示。

在原终端运行,Windows:

& $app ros run (Join-Path $project "wamv_sensors.py")

Mac:

"$app" ros run "$project/wamv_sensors.py"

Ubuntu:

www-posim ros run "$project/wamv_sensors.py"

wamv-results 包含 wamv-lidar-camera.png、原始 wamv-camera.jpg 和记录距离、坐标系、时间、消息数量、候选圆的 wamv-sensor-data.json。Docker 路径 /workspace/wamv-results 对应宿主项目目录。直接保存图像,无需图形显示服务器。

WAM-V 相机及包围 LiDAR 实测回波的圆

左侧为收到的相机图,右侧为 LiDAR 坐标:前向 x 朝上,左向 y 朝左。传感器原点不同,圆没有投影到相机图。绘制整个量程内的有效回波;聚类范围 35 m、至少 3 点、半径最多 2 m、余量 0.1 m,这些是绘图启发式参数,不是实测浮标尺寸。遮挡、稀疏点和时间差可能漏检。图中一个候选不代表检测所有浮标,也不是避障控制器。从 使用 Python 会话接口继续设计自己的控制器。

结束练习

该脚本不发送推进命令。在原终端停止共享中继:

# Windows
& $app ros stop
# Mac
"$app" ros stop
# Ubuntu
www-posim ros stop

关闭应用结束本地世界。传感器接收失败时先停止,检查世界和中继日志,参阅 常见问题。

进阶:接口和限制

ZIP 支持包和相对 import;解压源码限 4 MiB、100 文件,UTF-8。服务器提供 Session SDK、标准 Python、NumPy、SciPy、PyYAML 和 ROS,不安装任意 requirements 依赖。禁用网络和源码目录写入,临时文件放 /tmp。控制容器限 1 CPU 核、512 MiB、进程和线程总计 64,与本地 ROS 中继共享。

最多 12 个待处理提交,每小时 10 次(不含未评分取消),每账户 50 MiB代码存储。挑战评估不消耗个人网页工作区时长;关闭个人会话不会取消已接受代码,需用取消按钮。

sim.profile['mission'] 包含 task、targets、home 和时序;sim.topics 列出车辆传感器。sim.latest(topic) 对旧数据报错,不会静默返回。中继允许同时读取四个元数据请求,传感器和命令继续传输。读取不续订控制租约,须在 0.75 秒 watchdog窗口内发送推进命令。

一次运行一个控制器。SDK 在有界命令间等待服务器释放确认。遇到 controller_busy 先停另一个控制器;参阅 控制 BlueROV 推力。WAM-V 前向 ±1.5 m/s、偏航 ±0.5 rad/s;推进力 WAM-V 2 × ±200 N,BlueROV2 6 × ±50 N。水下任务需要深度控制。ROS 节点获得 WWW_POSIM_PROFILE、临时路线 JSON 和域 76的本地中继。

服务器先开始评分再启动 main.py;打印声称的分数不能得分。参阅任务、分数与排名。

搜索文档