POSIM v1.0.1Platform for Ocean Simulation · ドキュメント
ドキュメントメニュー
POSIM / はじめに

Windows:WSLとDocker

Docker Desktop で POSIM を動かし、WSLg を通じて Windows デスクトップに Gazebo を表示します。このページの Docker コマンドは、すべて WSL 内の Ubuntu ターミナルで実行してください。

1. WSL とグラフィックスを準備する

Windows へのインストールの手順 1、2 に従い、WSL2 に Ubuntu 26.04 をインストールして、WSL と Windows 側のグラフィックスドライバーを更新します。NVIDIA 製 GPU も同様です。WSL 内に Linux 用ディスプレイドライバーをインストールしないでください。

WSL2 バックエンドの Docker Desktop をインストールし、Settings → Resources → WSL Integration → Ubuntu-26.04 を有効にします。Docker Desktop のエンジンを使用するため、Ubuntu 内に別の Docker Engine は不要です。

サーバーと画面表示用ソケットを確認します。

docker version --format '{{.Server.Version}}'
test -S /mnt/wslg/.X11-unix/X0
printf '%s\n' "$DISPLAY"

ソケットが存在しない場合は、先に WSLg の設定を完了してください。

2. POSIM をダウンロードする

docker pull ioeslab/posim:latest

タグとソースからのビルドは Docker 環境で説明しています。以下の設定はソフトウェアレンダリングを使用します。対応する NVIDIA GPU を使う場合は、GPU 利用の前提条件も確認してください。

3. コンテナを作成する

docker run -d --name posim --init --shm-size=1g \
  -e DISPLAY -e QT_QPA_PLATFORM=xcb -e LIBGL_ALWAYS_SOFTWARE=1 \
  --mount type=bind,source=/mnt/wslg/.X11-unix,target=/tmp/.X11-unix,readonly \
  --mount type=volume,source=posim-data,target=/work \
  --entrypoint bash ioeslab/posim:latest -lc 'exec sleep infinity'

自分のファイルは posim-data ボリュームに対応する /work に保存します。docker stop posim で停止し、docker start posim で再開できます。

続く例では Ubuntu ターミナルを 2 つ開き、両方を同じコンテナに接続します。Gazebo は Windows のウィンドウとして表示されます。

4. デモワールドを起動する

コンテナに入ります。

docker exec -it posim bash

次のコマンドでインストール結果を確認します。

source /opt/ros/lyrical/setup.bash
source /opt/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
  world_name:=posim_ocean_waves headless:=false

Gazebo に海のワールドが表示されれば準備完了です。実行中はターミナルを開いたままにし、停止するには Ctrl+C を押します。次は最初のロボットを動かします。

同じPOSIMコンテナー内でLinux版QGCを実行してください。Windowsホストや、コンテナー外のWSLではQGCを起動しないでください。QGCの設定に従ってください。