Linux:Dockerでのインストール
Ubuntuのバージョンが異なる場合や、別のLinuxディストリビューションを使う場合は、配布済みのPOSIMイメージを利用できます。この手順はx86-64デスクトップのAMD64版を対象とし、X11またはXWaylandで表示します。Ubuntu 26.04ではネイティブインストールを推奨します。
1. Dockerと画面表示を準備する
使用するディストリビューションに合わせてDocker Engineをインストールします。Ubuntu向けの手順もあります。自分のアカウントでdockerを実行できない場合は、インストール後の設定を行ってください。
デスクトップのターミナルを開き、xauthをインストールします。Ubuntuでは次のように実行します。
sudo apt update
sudo apt install -y xauth
ディスプレイのアドレスとDockerサーバーのバージョンを確認します。
printf '%s\n' "$DISPLAY"
docker version --format '{{.Server.Version}}'
2. POSIMを取得する
docker pull ioeslab/posim:latest
リビジョンの選択やソースビルドはDocker環境を参照してください。最初の起動はソフトウェアレンダリングを使うため、GPUを使ったネイティブ環境より遅くなることがあります。
3. コンテナからの表示を許可する
現在のセッションのX11認証情報を、自分のアカウントだけが読めるファイルにコピーします。
mkdir -p "$HOME/.cache/posim"
export POSIM_XAUTH="$HOME/.cache/posim/xauthority"
touch "$POSIM_XAUTH"
chmod 600 "$POSIM_XAUTH"
xauth nlist "$DISPLAY" | sed -e 's/^..../ffff/' | xauth -f "$POSIM_XAUTH" nmerge -
test -s "$POSIM_XAUTH"
最後のコマンドはファイルにデータがあることを確認します。失敗した場合は、現在のデスクトップセッションのターミナルを使っていることと、XWaylandが利用できることを確認してください。認証情報を用意してから次へ進みます。
4. コンテナを作成する
docker run -d --name posim --init --shm-size=1g \
-e DISPLAY -e QT_QPA_PLATFORM=xcb -e LIBGL_ALWAYS_SOFTWARE=1 \
-e XAUTHORITY=/tmp/posim.xauth \
--mount type=bind,source=/tmp/.X11-unix,target=/tmp/.X11-unix,readonly \
--mount "type=bind,source=$POSIM_XAUTH,target=/tmp/posim.xauth,readonly" \
--mount type=volume,source=posim-data,target=/work \
--entrypoint bash ioeslab/posim:latest -lc 'exec sleep infinity'
自作モデルと記録データは/workのposim-dataボリュームに保存します。停止はdocker stop posim、再開はdocker start posimです。Linuxに再ログインした後で表示できなくなった場合は、認証ファイルを更新してください。
各例を実行するときは、同じコンテナにつながる2つのターミナルを準備します。ハードウェアアクセラレーションやCUDAソナーを使う前に、GPU設定を確認してください。
5. デモワールドを起動する
コンテナ内のターミナルを開きます。
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を押します。続いて最初のシミュレーションへ進んでください。