WWW-POSIM v0.6.16シミュレーターのドキュメント
ドキュメントメニュー
WWW-POSIM / シミュレーターのドキュメント

Webワークスペースを制御

手元のコンピューターでPythonを実行し、Webサイト上の自分のシミュレーションに指令を送ります。

PythonとVS Codeを用意する

  1. WWW-POSIMにログインし、ROS 2直接制御モードでWAM-Vのワールドを作成します。ワールドが実行状態になるまで待ちます。
  2. VS CodeとMicrosoftのPython拡張機能をインストールします。
  3. 使用するOSの手順だけを実行します。.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がコンピューターのパスワードを求める場合があります。入力中の文字は表示されません。入力後にEnterを押します。

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. 統合ターミナルを開き、OSに合うコマンドを実行します。

Windows:

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

Mac/Ubuntu:

.venv/bin/python controller.py
  1. Password:が表示されたらWWW-POSIMのパスワードを入力し、Enterを押します。入力内容は表示されません。WebサイトでWAM-Vの動きを確認します。

プログラムは手元のコンピューターで動き、サーバー上の自分のワークスペースを制御します。パッケージをインポートしただけではログインも接続も行われません。withブロックに入ると接続を開始します。

うまく動かないとき

別の環境からROSトピックを使う方法はROSターミナルと接続をご覧ください。

ドキュメントを検索