Ubuntu: native Installation
Bauen Sie POSIM unter Ubuntu 26.04. Öffnen Sie die Anwendung Terminal und führen Sie die Befehlsblöcke einzeln aus. Warten Sie jeweils, bis der Schritt beendet ist. Für ein vorbereitetes Image gibt es die Docker-Anleitung für Linux.
1. Quellcode herunterladen
mkdir -p ~/posim_ws/src
git clone https://github.com/IOES-Lab/POSIM.git ~/posim_ws/src/posim
cd ~/posim_ws
Behalten Sie den Verzeichnisnamen posim bei. Das Repository-Manifest verwendet diesen Namen.
2. Software installieren
Lesen Sie zuerst src/posim/extras/ros-lyrical-gz-jetty-install.sh. Das Skript richtet Paketquellen ein, verwendet sudo und führt apt-get full-upgrade -y aus. Eine eigene Ubuntu-Umgebung wird empfohlen.
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"
Das Skript installiert ROS 2 Lyrical, Gazebo Jetty, ArduSub, ArduRover, MAVROS und die Wellenbibliotheken. Wave Sim wird als externe Abhängigkeit aus einer festgelegten Revision gebaut. Ein rekursiver POSIM-Klon ist nicht nötig.
3. Abhängigkeiten des Arbeitsbereichs auflösen
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 erhält den bereits geklonten POSIM-Quellcode. Beheben Sie gemeldete Abhängigkeitsfehler vor dem Build.
Das Manifest importiert auch eine festgelegte ros_gz-Revision mit Korrekturen an Bridge-Lebensdauer und POSIX-Prozessstart. Ein vorhandenes src/ros_gz wird nicht ersetzt: Vergleichen Sie Herkunft und Revision mit dem Manifest oder verwenden Sie einen neuen Arbeitsbereich.
4. Bauen und Umgebung laden
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
Beide ros_gz-Pfade müssen zum install/-Verzeichnis dieses Arbeitsbereichs gehören. Zeigt ein Pfad auf /opt/ros/lyrical, ist weiterhin das Systempaket ausgewählt. Laden Sie ROS und den Arbeitsbereich in jedem neuen Terminal gemäß Terminals vorbereiten.
Bei Speichermangel
--executor sequential baut Pakete nacheinander, begrenzt aber nicht die Compilerprozesse. Beides lässt sich so begrenzen:
MAKEFLAGS="-j1" CMAKE_BUILD_PARALLEL_LEVEL=1 colcon build --merge-install --executor sequential --symlink-install
Arbeitsbereich aktualisieren
Sichern Sie eigene Änderungen zuerst als Git-Commit. Notieren Sie die Revision, laden Sie die Änderungen und wiederholen Sie anschließend Abhängigkeitsauflösung und Build:
git -C ~/posim_ws/src/posim rev-parse HEAD
git -C ~/posim_ws/src/posim pull --ff-only
Fahren Sie mit der ersten Simulation fort. Für Sonar gilt die Build- und Einrichtungsanleitung für CPU/WGPU/CUDA.
5. Demowelt starten
Die abschließende Prüfung öffnet die Meereswelt in Gazebo. Beim ersten Start können Fuel-Modelle heruntergeladen werden. Beenden Sie die Simulation mit Strg+C, bevor Sie mit den Terminals fortfahren.
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