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

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を押します。続いて最初のシミュレーションへ進んでください。