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

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:

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

  1. Stoppen Sie die Simulation in Terminal A mit Strg+C.
  2. Ändern Sie die Stationspose von 0 0 -2 0 0 0 auf 0 0 -4 0 0 0.
  3. Prüfen und starten Sie die Welt erneut.
  4. 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

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.