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.
- Kameras teilen dieselben Weltpositionen der Teilchen. Diese driften gleichmäßig mit der Simulationszeit, unabhängig von der Strömung.
- Undurchsichtige Flächen verdecken sie. Der Sichtbereich beträgt 0.05–3 m, begrenzt durch Szene und mittleren Wasserspiegel.
- Numerische Tiefe und akustische Strahlen bleiben unverändert.
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




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