Eine Welt erstellen
Beginnen Sie mit einer kleinen Welt und einem Drucksensor in bekannter Tiefe. So können Sie Änderungen messen, bevor Gelände und ein beweglicher Roboter hinzukommen.
Arbeitsumgebung vorbereiten
Verwenden Sie die vorbereiteten Linux-Terminals unter nativem Ubuntu, WSL oder Docker. Auf macOS öffnen Sie das Terminal im RDP-Desktop. Bearbeiten und bauen Sie in dieser Umgebung; POSIM_WS bezeichnet deren Arbeitsbereich.
Vollständige Welt speichern
Speichern Sie den folgenden Inhalt als calm_water.sdf. Einfache Geometrien und installierte Plugins machen zusätzliche Mesh-Downloads überflüssig.
<?xml version="1.0"?>
<sdf version="1.12">
<world name="calm_water">
<physics name="physics" type="ignored">
<max_step_size>0.001</max_step_size>
<real_time_factor>1.0</real_time_factor>
</physics>
<gravity>0 0 -9.80665</gravity>
<plugin filename="gz-sim-physics-system" name="gz::sim::systems::Physics"/>
<plugin filename="gz-sim-user-commands-system" name="gz::sim::systems::UserCommands"/>
<plugin filename="gz-sim-scene-broadcaster-system" name="gz::sim::systems::SceneBroadcaster"/>
<scene>
<ambient>0.4 0.5 0.6 1</ambient>
<background>0.05 0.15 0.25 1</background>
</scene>
<light name="sun" type="directional">
<direction>-0.5 0.2 -1</direction>
<diffuse>0.8 0.8 0.8 1</diffuse>
</light>
<model name="seabed">
<static>true</static>
<pose>0 0 -20 0 0 0</pose>
<link name="ground">
<collision name="collision">
<geometry><box><size>40 40 0.2</size></box></geometry>
</collision>
<visual name="visual">
<geometry><box><size>40 40 0.2</size></box></geometry>
<material><diffuse>0.6 0.5 0.3 1</diffuse></material>
</visual>
</link>
</model>
<model name="pressure_station">
<static>true</static>
<pose>0 0 -2 0 0 0</pose>
<link name="base_link">
<visual name="marker">
<geometry><box><size>0.2 0.2 0.2</size></box></geometry>
</visual>
</link>
<plugin filename="sea_pressure_sensor"
name="posim_gz_sensor_plugins::SubseaPressureSensorPlugin">
<namespace>pressure_station</namespace>
<topic>sea_pressure</topic>
<standard_pressure>101.325</standard_pressure>
<kPa_per_meter>9.80638</kPa_per_meter>
<estimate_depth_on>true</estimate_depth_on>
<update_rate>10</update_rate>
</plugin>
</model>
</world>
</sdf>
Die Welt enthält:
- Physik: maximaler Schritt 0,001 s, angestrebter Echtzeitfaktor 1 und Schwerkraft nach unten.
- Licht und Szene: gerichtetes Sonnenlicht, Umgebungslicht und Hintergrundfarbe.
- Meeresboden: feste Box bei z = −20 m mit übereinstimmender visueller und Kollisionsgeometrie.
- Druckstation: feste Markierung bei z = −2 m. Ihr Druck-Plugin auf Modellebene veröffentlicht Druck und geschätzte Tiefe.
Der Druck bezieht sich auf die Ebene z = 0 der Welt. Ergänzen Sie Wellen, Auftrieb und Fahrzeugbewegung, nachdem dieses Grundbeispiel funktioniert.
Prüfen und starten
In Terminal A, im Verzeichnis der Datei:
gz sdf -k calm_water.sdf
gz sim -r calm_water.sdf
Die Prüfung sollte erfolgreich sein; anschließend öffnet sich Gazebo. -r startet die Simulationszeit. Wählen Sie pressure_station im Objektbaum und richten Sie die Ansicht darauf aus.
In einem weiteren Terminal mit derselben geladenen Umgebung:
ros2 topic echo --no-daemon /model/pressure_station/sea_pressure sensor_msgs/msg/FluidPressure \
--once
ros2 topic echo --no-daemon /model/pressure_station/sea_pressure_depth geometry_msgs/msg/PointStamped \
--once
Erwartet werden ungefähr 120 938 Pa und 2 m. Das Plugin veröffentlicht direkt in ROS; eine zusätzliche Bridge ist hier nicht erforderlich.
Tiefe verändern
- Stoppen Sie die Simulation in Terminal A mit Strg+C.
- Ändern Sie die Stationspose von
0 0 -2 0 0 0auf0 0 -4 0 0 0. - Prüfen und starten Sie die Welt erneut.
- Wiederholen Sie beide Abfragen. Erwartet werden etwa 140 551 Pa und 4 m.
Lassen Sie die Druckkoeffizienten unverändert. Die erwartete Zunahme beträgt 19 612,76 Pa. Bewahren Sie beide Dateien zusammen mit Ihren Beobachtungen auf.
Einstellungen zuordnen
| SDF-Pfad | Einheit | Funktion |
|---|---|---|
world/physics/max_step_size |
s | Maximaler Integrationsschritt: 0.001 |
world/physics/real_time_factor |
— | Zielverhältnis von Simulations- zu Echtzeit: 1.0 |
world/gravity |
m/s² | Schwerkraftvektor |
world/scene, world/light |
RGBA / Richtung | Hintergrund und Beleuchtung |
model/pose |
m, rad | Position und Orientierung |
model/static |
boolesch | Station und Boden festhalten |
model/plugin |
pluginspezifisch | Druckparameter |
Die tatsächliche Geschwindigkeit hängt von der Last ab. Sensordefinition und zugehöriges Weltsystem haben unterschiedliche Geltungsbereiche. Sensoren hinzufügen ergänzt diese Datei um eine IMU und ROS-Bridge.
Welt erweitern
- Höhenkartengelände: Boden ersetzen und Kollision prüfen.
- Roboter hinzufügen: Mechanik, Antrieb und ROS.
- Strömungen: Strömungsfeld und Modellreaktion.
- Sphärische Koordinaten: geografischer Ursprung.
- Unterwassereffekte: Darstellung.
Legen Sie verteilbare Welten unter models/posim_worlds/worlds und ihre Ressourcen im selben Paket ab. Bauen und laden Sie den Arbeitsbereich erneut. Verwenden Sie beim Teilen URIs installierter Ressourcen.