Webワークスペースを制御
手元のコンピューターでPythonを実行し、Webサイト上の自分のシミュレーションに指令を送ります。
PythonとVS Codeを用意する
- WWW-POSIMにログインし、ROS 2直接制御モードでWAM-Vのワールドを作成します。ワールドが実行状態になるまで待ちます。
- VS CodeとMicrosoftのPython拡張機能をインストールします。
- 使用する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でプログラムを実行する
- VS Codeのファイル → フォルダーを開くで、ホームフォルダー内の
posim-controllerを開きます。 - MicrosoftのPython拡張機能が未導入の場合はインストールします。
- Windows/LinuxではCtrl+Shift+P、MacではCmd+Shift+Pでコマンドパレットを開きます。
Python: Select Interpreterを検索し、.venvのインタープリターを選びます。 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)
- 統合ターミナルを開き、OSに合うコマンドを実行します。
Windows:
.\.venv\Scripts\python.exe controller.py
Mac/Ubuntu:
.venv/bin/python controller.py
Password:が表示されたらWWW-POSIMのパスワードを入力し、Enterを押します。入力内容は表示されません。WebサイトでWAM-Vの動きを確認します。
プログラムは手元のコンピューターで動き、サーバー上の自分のワークスペースを制御します。パッケージをインポートしただけではログインも接続も行われません。withブロックに入ると接続を開始します。
うまく動かないとき
No module named www_posim_ros:プロジェクトのインタープリターを選び、.venvのPythonでパッケージのインストールをやり直します。- 新しいテレメトリが届かない:ワールドが実行中で、機体が表示されているか確認します。トピック名があっても受信できているとは限りません。
- ROS 2直接制御のワークスペースが必要と表示される:その制御モードを選んでワールドを作成します。
controller_busy:同じワールドを制御している別のプログラムを停止してから、再実行します。- ワールドや機体を変更した:現在の接続プロファイルを取得するため、プログラムを再起動します。
- アプリのROSツールが動かない:準備済み環境内の
~/.www-posim-ros/domain-76/client.logを確認します。必要に応じてROSツールを閉じ、開き直します。
別の環境からROSトピックを使う方法はROSターミナルと接続をご覧ください。