POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Grundlagen

Erste Simulation

Erkunden Sie mit BlueROV2 eine Inspektionsszene im flachen Wasser und anschließend mit WAM-V einen Bojenparcours. Jedes Beispiel öffnet Gazebo und ein vorkonfiguriertes RViz-Fenster. Führen Sie jeweils nur eine Simulation aus.

Vorbereitungen

Schließen Sie eine Installation ab und laden Sie denselben ROS/POSIM-Arbeitsbereich in den Terminals A und B. A führt den Simulator aus; B liest Daten und startet die Videoübertragung. Docker verwendet den bei der Installation eingerichteten Linux-, WSLg- oder RDP-Desktop. Beide Beispiele gehören zur Standardinstallation; ein separates Image für Oberflächenfahrzeuge ist nicht erforderlich.

Unterwasserinspektion mit BlueROV2

In Terminal A:

ros2 launch posim_demos underwater_tutorial.launch.py

BlueROV2 startet etwa 3,1 m unter dem mittleren Wasserspiegel über einem 4 m tiefen Meeresboden. Vor dem Fahrzeug liegen Kasten, Rohr, Säule und Kugel. Kleine Wellen, Unterwassertrübung, Absorption, Kaustiken und Meeresschnee sind aktiviert. Angepasster Ballast hält das noch nicht scharfgeschaltete Fahrzeug nahe den Objekten. Gazebo zeigt neben der Szene das Live-Kamerabild.

Für Mehrstrahlsonar hängen Sie sonar:=true an diesen Befehl an. Damit wird BlueROV2 Heavy mit Sonar gewählt: Gazebo erhält ein Sonarbild, RViz ein Sonarbild und eine Punktwolke. Sonar benötigt viele Rechenressourcen und kann Bildrate und Reaktionsgeschwindigkeit der Steuerung verringern. auto versucht abhängig von Host und Sensorkonfiguration zuerst CUDA, dann WGPU und CPU. Die üblichen Rendering-Vorgaben bleiben bestehen. Anforderungen stehen unter Sonar konfigurieren.

Die folgenden Aufnahmen zeigen die Sonarvariante. RViz lädt Fahrzeugmodell, Kamera und Sensoranzeigen automatisch. Das 1-m-Raster dient als Entfernungsmaß im Fahrzeugkoordinatensystem; es ist kein gemessener Meeresboden. Move Camera ist ausgewählt: Ziehen dreht die Ansicht, die mittlere Maustaste verschiebt sie und das Rad zoomt. Die dargestellten Propeller behalten ihren Ruhewinkel; die Simulationsdynamik bleibt unverändert.

BlueROV2 und Sonarechos erscheinen gemeinsam im Fahrzeugkoordinatensystem, neben Kamera- und Sonarbild.
BlueROV2 und Sonarechos erscheinen gemeinsam im Fahrzeugkoordinatensystem, neben Kamera- und Sonarbild.

Live-Daten prüfen

In Terminal B:

ros2 topic echo --no-daemon /model/bluerov2/odometry nav_msgs/msg/Odometry --field pose.pose.position

Ersetzen Sie bei der Sonarvariante bluerov2 im Topic durch bluerov2_heavy_multibeam_sonar. Auch bei nahezu ruhendem Fahrzeug müssen weiter Positionsdaten eintreffen. Beenden Sie die Anzeige mit Strg+C und prüfen Sie, ob die Simulationszeit fortschreitet:

ros2 topic echo --no-daemon /clock rosgraph_msgs/msg/Clock

Beenden Sie diese Anzeige mit Strg+C. Bei fehlenden Nachrichten oder angehaltener Zeit hilft die Fehlersuche.

Video und Steuerung mit QGC

Starten Sie unter Windows/WSL die Linux-Version von QGC in derselben Ubuntu-Distribution wie POSIM, bei Docker im selben POSIM-Container. Verwenden Sie für diese Tutorials nicht die unter Windows installierte Anwendung.

Folgen Sie den Schritten 1–3 der QGC-Einrichtung und aktivieren Sie die virtuellen Joysticks. Wählen Sie UDP h.264 Video Stream, Adresse 127.0.0.1:5600. Aktivieren Sie Low Latency Mode und deaktivieren Sie Disable Video Stream When Disarmed. Lassen Sie das Tutorial weiterlaufen und starten Sie die Videoübertragung in Terminal B:

gz topic -t /tutorial/camera/enable_streaming \
  -m gz.msgs.Boolean -p 'data: true' --duration 3

Ein Klick auf das kleine Videofeld in QGC vergrößert das Bild. No GPS Lock ist normal, solange die marine GNSS-Antenne unter Wasser liegt. Telemetrie, Video und manuelle Steuerung bleiben verfügbar. Warten Sie auf Ready, wählen Sie Manual, schalten Sie mit Arm scharf und bewegen Sie den Joystick kurz. Lassen Sie ihn zur Neutralstellung zurückkehren und wählen Sie Disarm. Beachten Sie die QGC-Bedienschritte. Starten Sie keine zusätzliche Tastatur- oder Joysticksteuerung.

Unterwasserkamera in QGC. Ein verlorener GNSS-Fix unter Wasser bedeutet keinen Verbindungsabbruch zum Fahrzeug.
Unterwasserkamera in QGC. Ein verlorener GNSS-Fix unter Wasser bedeutet keinen Verbindungsabbruch zum Fahrzeug.

Sensoren an der Oberfläche mit WAM-V

Beenden Sie zuerst die Unterwassersimulation. In Terminal A:

ros2 launch posim_demos surface_tutorial.launch.py

WAM-V startet auf kleinen Wellen vor vier verankerten Bojen. RViz zeigt die Kamera sowie Fahrzeug und Lidar-Punktwolke in einer gemeinsamen Ansicht. Das 1-m-Raster und Move Camera sind voreingestellt. Der Lidar scannt horizontal: Die Punkte zeigen Bojenkonturen auf Sensorhöhe, keine vollständige 3D-Rekonstruktion.

Klicken Sie im Gazebo-Panel Lidar auf Aktualisieren und wählen Sie /tutorial/lidar. Deaktivieren Sie Show Non Hitting Rays, um nur Strahlen mit Objekttreffern zu zeigen. Das Kamerapanel bleibt neben der Szene sichtbar.

WAM-V und Lidar-Echos in derselben Ansicht, daneben die Frontkamera.
WAM-V und Lidar-Echos in derselben Ansicht, daneben die Frontkamera.

Die Kamera verwendet dasselbe Topic /tutorial/camera, denselben Startbefehl und dieselben QGC-Videoeinstellungen wie das Unterwasserbeispiel. WAM-V nutzt den Bootsmodus von ArduRover mit simulierter Position und Geschwindigkeit als externer Navigation; siehe Oberflächenfahrzeuge und Wellen. Dieser Eingang ist vom marinen GNSS-Empfänger des BlueROV2 getrennt.

Im QGC-Modus Manual steuern Sie den WAM-V-Schub mit der vertikalen Bewegung des linken Sticks. Wählen Sie Arm, bewegen Sie ihn kurz, lassen Sie ihn zur Neutralstellung zurückkehren und wählen Sie Disarm.

Die Frontkamera des WAM-V überträgt den Bojenparcours an QGC.
Die Frontkamera des WAM-V überträgt den Bojenparcours an QGC.

Lesen Sie in Terminal B einen Lidar-Scan:

ros2 topic echo --no-daemon --once /tutorial/lidar sensor_msgs/msg/LaserScan

Die Punktwolke liegt unter /tutorial/lidar/points, die Fahrzeugodometrie unter /model/wamv/odometry.

Sitzung beenden

Wählen Sie Disarm, schließen Sie RViz und QGC und drücken Sie Strg+C in Terminal A. Warten Sie, bis die gestarteten Prozesse beendet sind. Verwerfen Sie gegebenenfalls Änderungen an der RViz-Ansicht, um die gelieferte Voreinstellung zu behalten. Bei Problemen beim Beenden hilft die Viewer-Fehlersuche. Das Schließen einer Topic-Anzeige stoppt die Simulation nicht. Beenden Sie die aktuelle Sitzung, bevor Sie ein weiteres Beispiel starten.

Um zur Ausgangsposition zurückzukehren, beenden Sie die Sitzung und führen Sie den Startbefehl erneut aus. Ein vollständiger Welt-Reset in Gazebo entfernt nach dem Start hinzugefügte Modelle, einschließlich des Tutorial-Fahrzeugs, und startet dessen Autopiloten nicht neu.

Weiterlernen