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

Windows:WSLへのインストール

Windows Subsystem for Linux 2(WSL2)上のUbuntu 26.04にPOSIMをインストールします。GazeboのウィンドウはWSLgによってWindowsデスクトップに表示されます。構築済みイメージを使う場合はWSLとDockerを選んでください。

1. WSLとUbuntuをインストールする

管理者としてPowerShellを開き、次を実行します。

wsl --install -d Ubuntu-26.04

再起動を求められたらWindowsを再起動します。Ubuntuを開き、Linuxのユーザー名とパスワードを設定してください。PowerShellで、UbuntuがWSL 2を使用していることを確認します。

wsl --list --verbose

既存のWSLを利用する場合やインストールに失敗する場合は、Microsoftの手順を参照してください。

2. グラフィックスドライバーとWSLgを準備する

Intel・AMD・NVIDIA GPUのWindows用ドライバーをインストールまたは更新します。NVIDIAの場合も必要です。WSLgはWindows側のドライバーでLinuxのGUIを描画します。GUIアプリの設定手順を確認してください。

NVIDIA では CUDA on WSL に従い、Windows 用ドライバーを導入します。WSL 内に Linux 用ディスプレイドライバーをインストールしないでください。 CUDA Toolkit が必要なのは、ソナーの CUDA バックエンドをビルドする場合です。

PowerShellでWSLを更新します。

wsl --update

再起動が必要な場合は、WSL内で作業を保存してから実施し、その後Ubuntuを開き直します。

3. UbuntuのターミナルでPOSIMをインストールする

LinuxのコマンドはWindows TerminalのUbuntuプロファイルで実行します。ディストリビューションを確認してください。

cat /etc/os-release

Ubuntuへのネイティブインストールのソース取得からビルドまでを実行します。ワークスペースはLinuxのホームディレクトリ内の~/posim_wsに作成してください。インストーラーはsudoを使い、Ubuntu内のパッケージを更新します。

画像トピックは見えるのに画像が届かない場合はトラブルシューティングを参照してください。以降の例で使う2つのウィンドウは、ターミナルの準備で説明しています。

4. デモワールドを起動する

Ubuntuのターミナルで実行します。Windowsデスクトップに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

POSIMと同じUbuntuディストリビューション内でLinux版QGCを実行してください。この構成では、WindowsにインストールしたQGCは起動しません。QGCの設定に従ってください。