POSIM v1.0.1Platform for Ocean Simulation · ドキュメント
ドキュメントメニュー
POSIM / 基本ガイド

ターミナルの準備

ターミナルは、コマンドを入力して実行結果を確認するウィンドウです。このガイドでは、通常のターミナルを2つ開き、シミュレーションを実行する方をターミナルA、センサーデータの確認や操作に使う方をターミナルBと呼びます。AとBは役割を表す名前で、別のアプリではありません。

インストール方法に合った場所で開く

インストール方法 ターミナルA・Bの開き方
Ubuntuへのネイティブインストール Ubuntuの「端末」を2つ開く
LinuxのDocker Linuxのターミナルを2つ開き、両方から同じコンテナに入る
WindowsのWSL Windows Terminalで同じWSLディストリビューションのUbuntuタブを2つ開く
WindowsのWSLとDocker Ubuntuタブを2つ開き、両方から同じコンテナに入る
macOSのDockerとRDP RDPで接続したLinuxデスクトップ内でターミナルを2つ開く

Linux・WindowsのDocker環境では、ホスト側の各ターミナルで次を実行し、posimコンテナに入ります。

docker exec -it posim bash

macOSで利用するRDPデスクトップは、すでにコンテナ内にあります。ROSのコマンドはそのLinuxターミナルで実行してください。PowerShellやmacOSのターミナルは、コンテナの起動などホスト側の操作に使います。

ワークスペースとは

ROSワークスペースは、ソースコードとビルドしたパッケージをまとめるディレクトリです。src/にソースコード、build/にビルド途中のファイル、install/にROSが読み込むパッケージが入ります。

インストール方法 パス
Ubuntu・WSLへのネイティブインストール ~/posim_ws
AMD64 Dockerイメージ /opt/posim_ws
ARM64 RDPイメージ /home/docker/posim_ws

~はLinuxユーザーのホームディレクトリを表します。以下のPOSIM_WSは、ワークスペースのパスを保持する変数です。

AとBの両方で環境を読み込む

Ubuntu・WSLへのネイティブインストールの場合:

export POSIM_WS="$HOME/posim_ws"
source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
source "$POSIM_WS/install/setup.bash"
cd "$POSIM_WS"

Dockerの場合(RDPデスクトップ内も同じ):

export POSIM_WS="${POSIM_WS:-${POSIM_UNDERLAY:-/home/docker/posim_ws}}"
source /opt/ros/lyrical/setup.bash
source "$POSIM_WS/install/setup.bash"
cd "$POSIM_WS"

sourceは、ROSやPOSIMを見つけるためのパスと設定をターミナルに読み込むコマンドです。新しいターミナルを開くたびに実行してください。

起動前に確認する

ros2 pkg prefix posim_demos
ros2 pkg prefix ros_gz_sim

どちらもワークスペース内のinstall/を指していれば準備完了です。パッケージが見つからない場合はインストール手順を確認してください。ros_gz_simが/opt/ros/lyricalを指す場合、ワークスペース側のパッケージが読み込まれていません。

次は初めてのシミュレーションです。メッセージを出力し続けているコマンドは実行中です。そのターミナルでCtrl+Cを押して停止し、入力待ちの表示に戻ってから次のコマンドを実行します。