POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Weiterführende Anleitungen

Sensoren hinzufügen und konfigurieren

Ein Sensor benötigt seine Modelldefinition, das aktualisierende System und eine Verbindung zum Empfänger. Fügen Sie jeweils einen Sensor hinzu und prüfen Sie seine Messwerte.

Arbeitsumgebung

Nutzen Sie die vorbereiteten Linux-Terminals unter nativem Ubuntu, WSL oder Docker. Auf macOS arbeiten Sie im RDP-Desktop. Bearbeiten und bauen Sie dort; POSIM_WS bezeichnet diesen Arbeitsbereich.

Einbaupunkt wählen

Messung Platzierung im Modell Weltsystem / ROS-Verbindung
IMU link/sensor type="imu" IMU-System; Bridge von gz.msgs.IMU zu ROS Imu
Unterwasserkamera RGBD-Sensor und Effekt-Plugin Sensors-System mit Renderer und Kamera-Topics
DVL DVL-Sensor und Strahlkonfiguration DVL-System und mitgelieferte Bridge für Akustiknachrichten
Druck Plugin direkt unter model Direkte ROS-Ausgabe von Druck und Tiefe
Marine-GNSS Empfänger-Plugin am Modell Gazebo-Nachrichten vom Typ gz.msgs.Double_V; für ROS ist ein separater Adapter erforderlich
USBL Transceiver- und Transponder-Plugins Passende akustische IDs und ROS-Schnittstellen
Multibeam-Sonar Benutzerdefinierter Sensor unter einem Link Sensors-Renderer, Multibeam-Weltsystem und CPU/WGPU/CUDA

Verwenden Sie SDF-Beispiel und Parametertabelle der jeweiligen Referenz. Die Platzierung ist entscheidend: Weltsysteme gehören in die Welt; Modell-Plugins benötigen ihre zugehörige Modellentität.

IMU in die Beispielwelt einbauen

Öffnen Sie calm_water.sdf aus Welt erstellen. Ergänzen Sie dieses System direkt unter <world> neben dem Physiksystem:

<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu"/>

Fügen Sie unter <link name="base_link"> des Modells pressure_station Folgendes ein:

<sensor name="imu" type="imu">
  <pose>0 0 0.1 0 0 0</pose>
  <always_on>true</always_on>
  <update_rate>20</update_rate>
  <topic>/tutorial/imu</topic>
  <imu/>
</sensor>

Die Pose gilt relativ zum Link, in Metern und Radiant. Die Rate bezieht sich auf Simulationszeit. Da die Station feststeht, sollte die Winkelgeschwindigkeit nahe null liegen; die Beschleunigung enthält die Schwerkraftreaktion.

Verbinden und beobachten

Stoppen Sie die bisherige Welt. Prüfen und starten Sie in Terminal A neu:

gz sdf -k calm_water.sdf
gz sim -r calm_water.sdf

Starten Sie in Terminal B mit geladener Umgebung die Bridge und lassen Sie sie laufen:

ros2 run ros_gz_bridge parameter_bridge \
  '/tutorial/imu@sensor_msgs/msg/Imu[gz.msgs.IMU'

Lesen Sie in entsprechend vorbereitetem Terminal C einen Messwert:

ros2 topic echo --no-daemon /tutorial/imu sensor_msgs/msg/Imu --once

Prüfen Sie Zeitstempel, Frame-ID, Winkelgeschwindigkeit und Beschleunigung. Ohne --once werden fortlaufend Werte angezeigt; Strg+C beendet die Anzeige. Stoppen Sie abschließend Bridge und Simulator. ROS-Terminals und Topics erläutert die gemeinsame Umgebung.

Rate ändern

Ändern Sie update_rate von 20 auf 5 und starten Sie Welt und Bridge neu. Die Zeitstempelabstände sollten von etwa 0,05 s auf 0,2 s Simulationszeit steigen. Die in Echtzeit empfangene Rate hängt zusätzlich von Echtzeitfaktor und Transport ab.

Prüfen Sie bei Kameras Auflösung, Sichtfeld sowie Nah- und Ferngrenze gemeinsam. Prüfen Sie bei Scannern Strahlgeometrie und Reichweite. Bestätigen Sie Koordinatenrahmen und Orientierung, bevor Sie einen Sensor versetzen.

Integration prüfen

Prüfen Sie den Boden mit Höhenkartengelände. Für Sonarvergleiche verwenden Sie Einrichtung und Leistung zusammen mit der Parameterreferenz.