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

Docker環境

POSIMイメージにはUbuntu、ROS 2 Lyrical、Gazebo Jetty、POSIM、ArduSub、ArduRover、MAVROS、QGroundControlが含まれています。画面表示とドライバの準備は、実行環境の選択から各OSの手順を確認してください。

配布済みイメージを取得する

Docker Hubから取得します。DockerがCPUに合ったAMD64版またはARM64版を選びます。

docker pull ioeslab/posim:latest
export POSIM_IMAGE=ioeslab/posim:latest
タグ 用途
latest メインブランチから公開されたビルド。AMD64とARM64に対応
sha-<12-character-commit> 特定のソースリビジョン。Docker Hubに存在するタグをコピーして使用
SHAタグの末尾が-amd64または-arm64 アーキテクチャを明示して選択
公開されているリリース番号 リリースタグに対応するバージョン

イメージのラベルには完全なソースリビジョンが記録されています。同じイメージで実験を再現する場合は、ダイジェストも保存します。

docker image inspect "$POSIM_IMAGE" \
  --format '{{index .Config.Labels "org.opencontainers.image.revision"}}'
docker image inspect "$POSIM_IMAGE" --format '{{json .RepoDigests}}'

選択したリビジョンに対応するドキュメントを参照してください。新しいイメージを取得しても、既存のコンテナは更新されません。

ソースからビルドする

ホスト側で実行します。

git clone https://github.com/IOES-Lab/POSIM.git
cd POSIM
git rev-parse HEAD

AMD64の場合:

docker build --platform linux/amd64 \
  -f .docker/lyrical.amd64.dockerfile -t posim:dev-amd64 .

ARM64の場合:

docker build --platform linux/arm64 \
  -f .docker/lyrical.arm64v8.dockerfile -t posim:dev-arm64-rdp .

OS別のインストール手順では、ioeslab/posim:latestを作成したローカルタグに置き換えます。どちらも手元のソースと固定リビジョンの波浪ライブラリをビルドします。ARM64版にはXFCEデスクトップとRDPサーバーも含まれます。

OSに合った方法で起動する

各手順でposimという名前のコンテナを作成します。コマンドを入力する場所とワークスペースの読み込み方は、ターミナルの準備を参照してください。

ファイルを保存する

ワークスペースはAMD64版では/opt/posim_ws、ARM64版では/home/docker/posim_wsにあります。POSIM_WSまたはPOSIM_UNDERLAYで場所を確認できます。

自作のSDFや記録データは/workに保存します。この場所はposim-dataボリュームに対応します。それ以外のファイルも停止・再起動では残りますが、コンテナを削除すると消えます。ソースの変更はGitに記録するか、交換前に外部へコピーしてください。ボリュームは明示的に削除するまで残ります。

停止・再開・更新

まずシミュレーションのターミナルでCtrl+Cを押します。その後、ホスト側で実行します。

docker stop posim
docker start posim

更新する場合は作業内容を保存し、コンテナを停止してから新しいイメージを取得します。停止中のコンテナを削除し、OS別の作成コマンドをもう一度実行してください。posim-dataを再利用すれば/workのファイルを引き継げます。

グラフィックスとGPU

LinuxではホストのドライバとNVIDIA Container Toolkitを設定します。WindowsではDocker DesktopとWSL2のGPU設定に従います。CUDAソナーにはイメージ内のライブラリも必要です。ソナーの設定を参照してください。最初の表示確認はソフトウェアレンダリングを使うため、GPU利用時より遅くなることがあります。