Ubuntu:ネイティブインストール
Ubuntu 26.04でPOSIMをビルドします。Ubuntuのターミナルを開き、各コードブロックを順番に実行してください。前の処理が完了してから次へ進みます。ビルド済みイメージを使う場合はLinuxのDocker手順を参照してください。
1. ソースを取得する
mkdir -p ~/posim_ws/src
git clone https://github.com/IOES-Lab/POSIM.git ~/posim_ws/src/posim
cd ~/posim_ws
取得先の名前はposimのままにしてください。後のリポジトリマニフェストがこの名前を使います。
2. ソフトウェアをインストールする
先にsrc/posim/extras/ros-lyrical-gz-jetty-install.shを確認してください。パッケージリポジトリを設定し、sudoとapt-get full-upgrade -yを実行するため、専用のUbuntu環境を推奨します。
POSIM_EXTRAS_DIR="$PWD/src/posim/extras" \
bash src/posim/extras/ros-lyrical-gz-jetty-install.sh
source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
ROS 2 Lyrical、Gazebo Jetty、ArduSub、ArduRover、MAVROS、波のライブラリをインストールします。Wave Simは固定したリビジョンを取得してビルドする外部依存です。POSIMを再帰的にクローンする必要はありません。
3. ワークスペースの依存関係を準備する
vcs import src --skip-existing \
--input src/posim/extras/repos/posim.lyrical.repos
rosdep update --rosdistro lyrical
rosdep install --rosdistro lyrical --from-paths src --ignore-src -r -y
--skip-existingは取得済みのPOSIMを保持します。依存関係のエラーが出た場合は、ビルド前に解決してください。
マニフェストは、ブリッジのライフサイクルとPOSIX起動処理を修正したros_gzも固定リビジョンで取得します。既存のsrc/ros_gzは変更されません。取得元とリビジョンをマニフェストと比較するか、新しいワークスペースを用意してください。
4. ビルドして環境を読み込む
colcon build --merge-install --executor sequential --symlink-install
source install/setup.bash
ros2 pkg prefix posim_demos
ros2 pkg prefix ros_gz_bridge
ros2 pkg prefix ros_gz_sim
2つのros_gzのパスが、このワークスペースのinstall/を指すことを確認します。/opt/ros/lyricalならシステム側のパッケージが選択されています。新しいターミナルでは毎回、ターミナルの準備に従ってROSとワークスペースを読み込んでください。
メモリ不足でビルドが止まる場合
--executor sequentialはパッケージを順番に処理しますが、コンパイラーの並列数は制限しません。両方を制限するには次を使います。
MAKEFLAGS="-j1" CMAKE_BUILD_PARALLEL_LEVEL=1 colcon build --merge-install --executor sequential --symlink-install
ワークスペースを更新する
独自の変更を先にGitへコミットしてください。現在のリビジョンを記録して更新を取得し、依存関係の解決とビルドをもう一度行います。
git -C ~/posim_ws/src/posim rev-parse HEAD
git -C ~/posim_ws/src/posim pull --ff-only
続いて最初のシミュレーションへ進みます。ソナーは CPU/WGPU/CUDA のビルドと設定を参照してください。
5. デモワールドを実行する
最後にGazeboの海洋シーンが開くことを確認します。初回はFuelモデルをダウンロードする場合があります。Ctrl+Cで終了してからターミナルの準備へ進んでください。
source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
source ~/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
world_name:=posim_ocean_waves headless:=false