POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Plugin-Referenz

Meeresströmungen

POSIM erzeugt Strömungen für die Welt, berechnet die Strömung am jeweiligen Roboter und stellt ROS-Dienste zur Einstellung bereit. Eine gleichförmige Strömung und ein tiefenabhängiges Profil verwenden unterschiedliche Topics und Einstellungen.

Das Beispiel starten

Bereiten Sie die Terminals A und B in Ihrer POSIM-Umgebung vor: natives Ubuntu, WSL, Docker oder der macOS-Remotedesktop. Starten Sie in A:

ros2 launch posim_demos posim_robot.launch.py \
  namespace:=rexrov world_name:=ocean_current_plugin z:=-5 paused:=false \
  gui:=true headless:=false use_teleop:=false use_web_joystick:=false

Prüfen Sie in B zuerst Gazebo und danach ROS. Beenden Sie die erste Ausgabe mit Ctrl+C, bevor Sie den zweiten Befehl ausführen:

gz topic -e -t /ocean_current
ros2 topic echo /hydrodynamics/currentVelocityTopic --once

Die Strömung der Welt konfigurieren

Beide Plugins gehören direkt unter <world>, das Weltströmungs-Plugin vor das ROS-Plugin. Die vollständige Konfiguration zeigt die Beispielwelt.

<plugin filename="OceanCurrentWorldPlugin"
        name="posim_gz_world_plugins::OceanCurrentWorldPlugin">
  <namespace>hydrodynamics</namespace>
  <constant_current>
    <use_constant_current>true</use_constant_current>
    <topic>ocean_current</topic>
    <velocity><mean>0.3</mean><min>0</min><max>0.6</max><mu>0</mu><noiseAmp>0</noiseAmp></velocity>
    <horizontal_angle><mean>0</mean><min>-3.14</min><max>3.14</max><mu>0</mu><noiseAmp>0</noiseAmp></horizontal_angle>
    <vertical_angle><mean>0</mean><min>-1.57</min><max>1.57</max><mu>0</mu><noiseAmp>0</noiseAmp></vertical_angle>
  </constant_current>
  <transient_current>
    <topic_stratified>stratified_current_velocity</topic_stratified>
    <databasefileName>transientOceanCurrentDatabase.csv</databasefileName>
  </transient_current>
</plugin>
<plugin filename="OceanCurrentPlugin" name="posim_ros_gz_plugins::OceanCurrentPlugin">
  <namespace>hydrodynamics</namespace>
</plugin>

Verwenden Sie in beiden Plugins denselben, nicht leeren namespace. Die Blöcke constant_current und transient_current sind erforderlich. Fehlt eine Pflichtangabe, wird die Veröffentlichung mit einer Fehlermeldung deaktiviert. Separate Gauß-Markow-Modelle beschreiben Geschwindigkeit, Horizontalwinkel und Vertikalwinkel der gleichförmigen Strömung.

Parameter Bedeutung und Standardwert
namespace beider Plugins Gemeinsamer Namensraum; im Beispiel hydrodynamics
constant_current/use_constant_current Gleichförmige Strömung veröffentlichen; false
constant_current/topic Gazebo-Topic der gleichförmigen Strömung; ocean_current
transient_current/topic_stratified Gazebo-Schichtdaten im Namensraum; stratified_current_velocity
transient_current/databasefileName CSV im installierten posim_worlds/worlds; transientOceanCurrentDatabase.csv
transient_current/databasefilePath Optionaler CSV-Pfad; hat Vorrang vor dem Dateinamen
mean jedes stochastischen Modells Anfangsmittelwert der Geschwindigkeit (m/s) oder des Winkels (rad); 0
min, max Grenzen; −1 und 1. min < max einhalten und den Mittelwert dazwischen wählen
noiseAmp Amplitude des Zufallsinkrements; 0
mu Abklingkoeffizient des Gauß-Markow-Modells; 0
tidal_oscillation Optionaler Block für Gezeitendaten

Ein Tiefenprofil vorbereiten

Die Beispiel-CSV enthält in dieser Reihenfolge die Geschwindigkeit entlang der Welt-X-Achse (m/s), der Welt-Y-Achse (m/s) und die Tiefe (m). Die bisherigen Schlüssel velocity_north, velocity_east und velocity_down entsprechen direkt den Weltachsen X, Y und Z.

Das ROS-Plugin der Welt überträgt die vollständige Datenbank. Das Modell-Plugin interpoliert die Strömung in der Tiefe des Fahrzeugs. Für die hydrodynamische Reaktion zählt die Strömung relativ zur Fahrzeuggeschwindigkeit.

Das Profil am Roboter anwenden

Das REXROV-Beispiel nutzt zunächst die gleichförmige Strömung /ocean_current. Aktivieren Sie für das Tiefenprofil den auskommentierten Block im REXROV-Modell genau einmal, direkt unter <model>:

<plugin filename="OceanCurrentModelPlugin"
        name="posim_gz_model_plugins::OceanCurrentModelPlugin">
  <namespace>rexrov</namespace>
  <flow_velocity_topic>ocean_current</flow_velocity_topic>
  <transient_current>
    <topic_stratified>/hydrodynamics/stratified_current_velocity_topic_database</topic_stratified>
    <velocity_north><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_north>
    <velocity_east><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_east>
    <velocity_down><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_down>
  </transient_current>
  <tide_oscillation>false</tide_oscillation>
</plugin>

Ergänzen Sie außerdem <namespace>rexrov</namespace> im bestehenden Plugin gz-sim-hydrodynamics-system. Behalten Sie dessen Link, Dichte und Widerstandskoeffizienten bei. Bauen Sie den Workspace neu und laden Sie seine Umgebung.

Modellparameter Bedeutung und Standardwert
namespace Erforderlich; muss zum Hydrodynamik-Namensraum passen, hier rexrov
flow_velocity_topic Suffix unter /model/<namespace>/; ocean_current
transient_current/topic_stratified ROS-Eingang der Datenbank; hydrodynamics/stratified_current_velocity_topic_database
velocity_north, velocity_east, velocity_down Optionale stochastische Einstellungen je Komponente; ausgelassene Komponenten verwenden kein Rauschen
mean jeder Komponente Anfangsgeschwindigkeit, m/s; 0. Nach Datenempfang durch das interpolierte Profil ersetzt
mu Abklingkoeffizient von 0 bis 1, angewandt mit der verstrichenen Simulationszeit in Sekunden; 0
noiseAmp Zulässige Abweichung von der interpolierten Geschwindigkeit, m/s; 0
noiseFreq Amplitude des Zufallsinkrements je Aktualisierung; 0. Keine Frequenz in Hz
tide_oscillation Gelieferte Gezeitendaten am Modell anwenden; false

Das Modell veröffentlicht /model/rexrov/ocean_current in Gazebo als gz.msgs.Vector3d und in ROS als geometry_msgs/msg/TwistStamped. Prüfen Sie die Ausgabe und die Fahrzeugreaktion.

Die Tiefe folgt aus der Weltposition des Modells; oberhalb der Oberfläche beträgt sie null. Zwischen den Schichten wird interpoliert, außerhalb des Profils die nächstgelegene Schicht verwendet. Bei Pause oder wiederholtem Zeitstempel wird die Strömung nicht weiterentwickelt. Eine ungültige Datenbanknachricht wird vollständig verworfen; das letzte gültige Profil bleibt bestehen.

Systeme und Topics

System Aufgabe
posim_gz_world_plugins::OceanCurrentWorldPlugin Weltströmung und Daten der Tiefenschichten erzeugen
Strömungs-Plugin des Modells Strömung an der Roboterposition interpolieren
posim_ros_gz_plugins::OceanCurrentPlugin ROS-Daten veröffentlichen und Einstelldienste anbieten
Beispiel-Topic Transport und Typ
/ocean_current Gazebo, gz.msgs.Vector3d
/hydrodynamics/stratified_current_velocity Gazebo, Schichtdaten
/hydrodynamics/stratifiedCurrentVelocityTopic ROS, posim_interfaces/msg/StratifiedCurrentVelocity
/hydrodynamics/currentVelocityTopic ROS, geometry_msgs/msg/TwistStamped
/hydrodynamics/stratified_current_velocity_topic_database ROS, posim_interfaces/msg/StratifiedCurrentDatabase

Prüfen Sie die Namen in der SDF-Datei und verbinden Sie die Hydrodynamik mit der gewünschten Strömungsquelle.

Strömungen über ROS-Dienste einstellen

Listen Sie in B die Dienste auf und fordern Sie eine horizontale Strömung mit 0.3 m/s an:

ros2 service list -t
ros2 service call /hydrodynamics/set_current_velocity posim_interfaces/srv/SetCurrentVelocity \
  '{velocity: 0.3, horizontal_angle: 0.0, vertical_angle: 0.0}'

Geschwindigkeiten sind in m/s, Winkel in Radiant angegeben. Prüfen Sie success und die veröffentlichten Daten. So sehen Sie die Schnittstelle für eine Tiefenschicht:

ros2 interface show posim_interfaces/srv/SetStratifiedCurrentVelocity

Lesen Sie das Modell, ändern Sie seine Grenzen und stellen Sie die erste Schicht ein:

ros2 service call /hydrodynamics/get_current_velocity_model \
  posim_interfaces/srv/GetCurrentModel '{}'
ros2 service call /hydrodynamics/set_current_velocity_model \
  posim_interfaces/srv/SetCurrentModel \
  '{mean: 0.3, min: 0.0, max: 0.6, noise: 0.0, mu: 0.0}'
ros2 service call /hydrodynamics/set_stratified_current_velocity \
  posim_interfaces/srv/SetStratifiedCurrentVelocity \
  '{layer: 0, velocity: 0.2, horizontal_angle: 0.0, vertical_angle: 0.0}'
Dienst unter /hydrodynamics Schnittstelle Felder
get_current_velocity_model, get_current_horz_angle_model, get_current_vert_angle_model GetCurrentModel Leere Anfrage
set_current_velocity_model, set_current_horz_angle_model, set_current_vert_angle_model SetCurrentModel mean, min, max, noise, mu
set_current_velocity SetCurrentVelocity velocity, horizontal_angle, vertical_angle
set_current_horz_angle, set_current_vert_angle SetCurrentDirection angle
set_stratified_current_velocity SetStratifiedCurrentVelocity layer, velocity, horizontal_angle, vertical_angle
set_stratified_current_horz_angle, set_stratified_current_vert_angle SetStratifiedCurrentDirection layer, angle

Zulässige Werte

Gezeitendaten einbinden

Konfigurieren Sie <tidal_oscillation> mit einer CSV-Datei oder harmonischen Bestandteilen wie M2/S2/N2, Flut- und Ebbstromrichtung sowie einer GMT-Startzeit. Die harmonischen Beispiele verwenden Meter für die Amplitude, Grad für die Phase und Grad/Stunde für die Winkelgeschwindigkeit. Die Winkel der Strömungsdienste bleiben dagegen in Radiant.

Im Gezeitenmodus wird das berechnete harmonische Signal oder die durch 100 geteilte CSV-Geschwindigkeit mit der ersten Spalte des Tiefenprofils multipliziert. Die Höhenamplituden des Beispiels dienen als Zahlenfaktoren; das Modell rechnet Gezeitenhöhe nicht in Strömungsgeschwindigkeit um. Kalibrieren Sie Signal und Profil gemeinsam für die gewünschte Strömungsgeschwindigkeit.

Die Gezeiten-CSV hat eine Kopfzeile, gefolgt von YYYY-MM-DD HH:MM,event,speed:

Die Daten sind Versuchseingaben. Bewahren Sie Einheiten, Interpolationsbereich, Weltursprung und Zeitbezug. Vergleichen Sie Strömung und Fahrzeugbewegung jeweils mit derselben Ausgangspose.

Strömung und Fahrzeugreaktion

Tiefenabhängige Strömungsschichten und Fahrzeugreaktion
Tiefenabhängige Strömungsschichten und Fahrzeugreaktion
Datenfluss zwischen Welt, ROS und den Strömungs-Plugins des Modells
Datenfluss zwischen Welt, ROS und den Strömungs-Plugins des Modells
Fahrzeugreaktion auf eine gleichförmige Strömung
Fahrzeugreaktion auf eine geschichtete Strömung
Fahrzeugreaktion auf eine geschichtete Strömung
ROS-Ausgabe der gleichförmigen Strömung
ROS-Ausgabe der gleichförmigen Strömung
ROS-Ausgabe der geschichteten Strömung
ROS-Ausgabe der geschichteten Strömung
Ausgabe der Strömungsschicht-Datenbank
Ausgabe der Strömungsschicht-Datenbank
Strömung auf Höhe des Modells anwenden
Strömungsgeschwindigkeit je Modell
Strömungsgeschwindigkeit je Modell
ROS-Topic für die Modellströmung
ROS-Topic für die Modellströmung
Gazebo-Topic für die Modellströmung
Gazebo-Topic für die Modellströmung

Bilder und Videos: POSIM Notion Wiki. Die DAVE-Quellen stehen unter Zitieren und Lizenzen. Verwenden Sie die Befehle und Topic-Namen dieser Seite.