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

Unterwasserkamera

UnderwaterCamera nutzt Tiefendaten, um RGB-Farben mit zunehmender Entfernung abzuschwächen. Passen Sie Dämpfung und Hintergrundfarbe an das gewünschte Wasser an. Gemeinsame Effekte für die ganze Szene beschreibt das Unterwasser-Rendering.

Beispiel starten

Die Kamerawelt aktiviert kleine Wellen und native Unterwassereffekte. Der Sensorstart setzt POSIM_UNDERWATER_PLUGIN, damit der Kompatibilitätsausgang bereits eingefärbte RGB-Pixel ohne zweite Dämpfung weitergibt. Zum Vergleich des separaten tiefenbasierten Filters verwenden Sie eine Welt ohne Szenensystem und setzen diese Umgebungsvariable nicht.

Führen Sie das Beispiel im vorbereiteten Terminal A aus.

ros2 launch posim_demos posim_sensor.launch.py \
  namespace:=underwater_camera world_name:=camera_tutorial \
  x:=10 z:=-93.5 pitch:=0.3 yaw:=3.14 \
  paused:=false gui:=true headless:=false

Im vorbereiteten Terminal B:

ros2 topic echo /underwater_camera/simulated_image \
  sensor_msgs/msg/Image --once --no-arr
ros2 topic hz /underwater_camera/simulated_image

Fügen Sie in RViz eine Image-Anzeige hinzu. Ist das Topic sichtbar, liefert aber keine Bilder mehr, prüfen Sie die Übertragung großer Bildnachrichten.

Plugin konfigurieren

Setzen Sie diesen RGBD-Sensor in einen <link>. Die Welt braucht gz-sim-sensors-system mit <render_engine>ogre2</render_engine>, wie in der Kamerawelt. Das Plugin liest Gazebo-Farb-/Tiefenbilder und veröffentlicht direkt auf dem ROS-Topic /underwater_camera/simulated_image.

<sensor name="underwater_camera" type="rgbd_camera">
  <update_rate>10</update_rate>
  <topic>underwater_camera</topic>
  <camera>
    <horizontal_fov>1.05</horizontal_fov>
    <image><width>320</width><height>240</height></image>
    <clip><near>0.1</near><far>10.0</far></clip>
  </camera>
  <plugin filename="UnderwaterCamera"
          name="posim_gz_sensor_plugins::UnderwaterCamera">
    <attenuationR>0.8</attenuationR>
    <attenuationG>0.5</attenuationG>
    <attenuationB>0.2</attenuationB>
    <backgroundR>85</backgroundR>
    <backgroundG>107</backgroundG>
    <backgroundB>47</backgroundB>
  </plugin>
</sensor>
SDF-Parameter Bedeutung Standard
attenuationR Dämpfung im roten Kanal pro Meter, endlich und ≥ 0 1/30
attenuationG Dämpfung im grünen Kanal pro Meter, endlich und ≥ 0 1/30
attenuationB Dämpfung im blauen Kanal pro Meter, endlich und ≥ 0 1/30
backgroundR Roter Hintergrund, Ganzzahl 0–255 0
backgroundG Grüner Hintergrund, Ganzzahl 0–255 0
backgroundB Blauer Hintergrund, Ganzzahl 0–255 0

Topics und Kamerageometrie

<topic> muss einen gültigen ROS-Namen ergeben. Fehlt es, nutzt das Plugin Gazebos Pfad /world/<world>/model/<model>/link/<link>/sensor/<sensor> und hängt für ROS /simulated_image an. Verschachtelte Modelle ergänzen die Pfade ihrer übergeordneten Modelle.

Die Umrechnung von Tiefe in Entfernung entlang des Kamerastrahls nutzt zuerst eine ausdrücklich gesetzte Linsenprojektion, danach explizite intrinsische Parameter, sonst Bildgröße und horizontales Sichtfeld. Hauptpunktkoordinaten dürfen null sein. Brennweiten müssen positiv, Linsenwerte endlich und die Clipping-Abstände in Metern 0 < near < far erfüllen. Ungültige Einstellungen erzeugen einen Fehler und deaktivieren die Ausgabe.

Zeitstempel und Beispielwerte

Farb- und Tiefenbilder werden unabhängig von der Ankunftsreihenfolge anhand ihres Aufnahmezeitstempels gepaart. ROS behält Zeitstempel und Frame-ID des Farbbilds bei. Ist der Puffer voll, werden Bilder ohne Partner verworfen. Ein Zurücksetzen der Simulationszeit verwirft wartende Bilder und erlaubt einen Neustart der Zeitstempel.

Das Beispiel fordert 320 × 240 bei 10 Hz, RGB-Dämpfung 0.8/0.5/0.2 und Hintergrund 85/107/47 an. SDF-Werte überschreiben die Standardwerte des Codes.

Abstimmen und vergleichen

Platzieren Sie ein erkennbares Objekt in bekannten Abständen. Halten Sie Pose, Licht, Materialien und Kamera fest, während Sie einen Kanal ändern. Prüfen Sie auch Zeitstempel und empfangene Bildrate.

Die Dämpfung ist pro Kanal exponentiell und wird mit dem Hintergrund gemischt. Für einen ungedämpften Vergleich setzen Sie alle sechs Parameter der Tabelle auf null. Fehlende Tags verwenden die Standardwerte.

Der Szenenrenderer wendet gemeinsame Effekte auf PBR-Flächen und Kameras an. Ist dieses native System aktiv, lässt POSIM_UNDERWATER_PLUGIN bereits eingefärbte Pixel unverändert durch und verhindert eine zweite Filterung. Das Modell legt Verbindungen und Topics fest.

Schwebeteilchen

Der Renderer kann Schwebeteilchen in RGB-/RGBD-Farbbildern darstellen. Anfangs sind sie aus; aktivieren Sie sie über den Appearance-Service.

Dies sind prozedurale optische Effekte. Für kalibrierte Streuungsstudien ist ein passendes optisches Modell erforderlich. Behandeln Sie Teilchen bei visueller Navigation als bewegliche Beobachtungen und halten Sie die Einstellungen zwischen Vergleichen konstant.

Unterwasserbilder vergleichen

Unterwasserkamera in einer Gazebo-Szene
Unterwasserkamera in einer Gazebo-Szene
Bildanzeige der Unterwasserkamera
Bildanzeige der Unterwasserkamera
Bild ohne RGB-Dämpfung und mit schwarzem Hintergrund
Bild ohne RGB-Dämpfung und mit schwarzem Hintergrund
Trübes Küstenwasser: RGB-Dämpfung 0.8/0.5/0.2 und Hintergrund 85/107/47
Trübes Küstenwasser: RGB-Dämpfung 0.8/0.5/0.2 und Hintergrund 85/107/47

Bilder: POSIM Notion Wiki; DAVE-Zuordnung unter Zitation und Lizenzen. Verwenden Sie die Befehle und Topics in den Codeblöcken dieser Seite.