WWW-POSIM v0.6.16仿真器文档
文档菜单
WWW-POSIM / 仿真器文档

控制网页工作区

在自己的计算机上运行 Python,向网站中的个人仿真发送指令。

准备 Python 和 VS Code

  1. 打开 WWW-POSIM 并登录,以 ROS 2 直接控制模式创建 WAM-V 世界,等待世界运行。
  2. 安装 VS Code 和 Microsoft 的 Python 扩展。
  3. 只需执行对应操作系统的命令。.venv 文件夹保存此项目所需的 Python 包。

Windows:PowerShell

安装 Python 安装管理器。从开始菜单打开新的 PowerShell 窗口,运行:

py install 3.14
mkdir "$HOME\posim-controller"
cd "$HOME\posim-controller"
py -3.14 -m venv .venv
.\.venv\Scripts\python.exe -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl

Mac:终端

使用 Python.org 的安装程序安装 Python 3.14。打开应用程序 → 实用工具 → 终端,运行:

mkdir -p ~/posim-controller
cd ~/posim-controller
python3.14 -m venv .venv
.venv/bin/python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl

Ubuntu:终端

按 Ctrl+Alt+T 打开终端,运行:

sudo apt update
sudo apt install -y python3-venv python3-pip
mkdir -p ~/posim-controller
cd ~/posim-controller
python3 -m venv .venv
.venv/bin/python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl

sudo 可能要求输入计算机密码。输入时不会显示字符,完成后按回车。

在 VS Code 中运行程序

  1. 在 VS Code 中,通过文件 → 打开文件夹打开个人目录下的 posim-controller。
  2. 如果尚未安装,请安装 Microsoft 的 Python 扩展。
  3. Windows/Linux 按 Ctrl+Shift+P,Mac 按 Cmd+Shift+P 打开命令面板。搜索 Python: Select Interpreter,选择 .venv 中的解释器。
  4. 创建 controller.py,粘贴以下代码,将 YOU@example.com 替换为账号邮箱并保存。
from www_posim_ros import Session

with Session.remote(email="YOU@example.com", control=True) as sim:
    topic = next(name for name, kind in sim.topics.items()
                 if kind == "nav_msgs/msg/Odometry")
    print(sim.latest(topic)["pose"]["pose"]["position"])
    sim.set_velocity(forward=0.3, yaw_rate=0.0, duration=2.0)
  1. 打开集成终端,运行对应系统的命令。

Windows:

.\.venv\Scripts\python.exe controller.py

Mac/Ubuntu:

.venv/bin/python controller.py
  1. 出现 Password: 时输入 WWW-POSIM 密码并按回车。输入内容不可见。观察网站中 WAM-V 的运动。

程序在自己的计算机上运行,控制服务器上的个人工作区。导入软件包不会登录或连接;进入 with 代码块时才建立连接。

排查问题

从其他环境使用 ROS 话题的方法见 ROS 终端与连接。

搜索文档