WWW-POSIM v0.6.16Simulator-Dokumentation
Dokumentationsmenü
WWW-POSIM / Simulator-Dokumentation

Sensormodelle und Parameter

Dieser Katalog beschreibt Messungen aus Gazebo-Rendering, kinematischen Sensoren, akustischen POSIM-Plugins und Anwendungsadaptern. Mitgeliefert bezeichnet das eingebaute Robotermodell, Editor ein neu erzeugtes Fahrzeug, Anbieter eine Funktion mit passendem installiertem Plugin. Maßgeblich sind die endgültige SDF-Datei und sensor-manifest.json.

Von der Simulation zum Messwert

  1. Physikalischer Zustand oder gerenderte Geometrie

    Gazebo liefert Bewegung, Weltfelder oder Strahlschnittpunkte. Jeder Sensor besitzt eine Einbautransformation und einen Erfassungstakt.

  2. Messmodell

    Das Plugin projiziert Bilder, bildet Trägheitsmessungen, löst Strahlgeschwindigkeiten oder berechnet akustische Echos. Rauschen und Gültigkeit entstehen hier.

  3. Nachrichten und Koordinatensysteme

    ROS–Gazebo-Brücken und POSIM-Adapter erhalten Messwerte, benennen Bezugssysteme, wandeln Einheiten um und melden fehlende Daten.

  4. Algorithmus oder Anzeige

    Regler und Schätzer verwenden zeitgestempelte Messungen. Bilder können für die Oberfläche komprimiert, gepuffert oder seltener übertragen werden.

Gemeinsame Konfiguration und Zeit

Parameter Bedeutung
sensor/@type, gz:type Wählen camera, rgbd_camera, gpu_lidar, imu, magnetometer oder eigene GNSS-/DVL-/Mehrstrahlsensoren. Die Welt muss das zugehörige System laden.
pose x/y/z in Metern, Roll/Nick/Gier in Radiant relativ zum übergeordneten Link. Editor: Positionen ±10 m, Winkel jeweils ±2π.
update_rate Angeforderte Erfassungen je Simulationssekunde; Editor 0,1–30 Hz. Physikschritte, Rendering und Übertragung können die beobachtete Rate begrenzen. Eine höhere Rate erzeugt keine zusätzlichen Zustände zwischen Physikschritten.
always_on, Verbindungen Aktivierung. Mitgelieferte Kameras werden bei Bedarf angefordert; Editor-Sensoren setzen always_on=true. Ein nicht startender Anbieter oder Renderer kann trotzdem Daten verhindern.
topic, frame_id, TF Editor: /vehicle/sensors/{id}, Einbau relativ zu vehicle/base_link. Optische Achsen rechts/unten/vorn, Körperachsen vorn/links/oben.
Erfassungszeitstempel Simulationszeit der Messung, bei Aufzeichnung und Fusion beibehalten. HLS-Wiedergabe und Browserempfang beschreiben die Übertragung.
noise Pluginabhängig. IMU: weißes Rauschen, Bias und dynamischer Bias je Achse. Kamera: Mittelwert und Standardabweichung. Gleichnamige XML-Tags garantieren kein gleiches Fehlermodell.

Die Gazebo-Sensoren definieren die Grundmodelle. Der Editor stellt nicht alle Engine-Parameter bereit. WWW-POSIM-SDF-Uploads ändern unterstützte Werte vorhandener Blöcke und erhalten deren Struktur. Verfügbare Sensoren fügen Sie über den Editor hinzu. Die hier genannten optionalen Gazebo-Blöcke beschreiben Engine-Fähigkeiten; beliebige XML-Erweiterungen werden nicht automatisch angenommen.

RGB-Kameras: nach vorn und unten

CameraSensor projiziert Geometrie mit einem Lochkameramodell in ein Ogre2-Renderziel und veröffentlicht Bild sowie Kalibrierung. Materialien, Beleuchtung, Verdeckung und Meeresdynamik und Rendering bestimmen die Farbe. Die Kameras modellieren weder Rolling Shutter noch Belichtungselektronik oder verschmutzte Linsen.

Parameter Auswahl
camera/image/width, height Mitgelieferte und Editor-Frontkamera: 640×480; Editor-Unterkamera: 800×600. Einstellbar 64–1920 je Dimension; Breite × Höhe × Rate ≤30 Millionen Pixel/s pro Kamera.
camera/horizontal_fov Mitgeliefert vorn: 1,05 rad; Editor: 1,4 rad, Bereich 0,1–3. Auflösung und Sichtfeld bestimmen Winkelabtastung und Kalibrierung.
camera/clip/near, far Mitgeliefert vorn: 0,1–5000 m; Editor: 0,1–100 m. Geometrische Schnittebenen, keine garantierte Unterwassersichtweite.
update_rate Anfangs 5 Hz; Übertragung hat eigene Grenzen.
camera/noise, distortion, lens/intrinsics Gazebo unterstützt Gaußsches Bildrauschen, radiale/tangentiale Brown-Verzeichnung (k1, k2, k3, p1, p2) und vorgegebene intrinsische Parameter. Erzeugte Definitionen ergänzen keine Rausch- oder Verzeichnungsblöcke. SDF und CameraInfo aufzeichnen.

Ausgaben: sensor_msgs/Image und sensor_msgs/CameraInfo. JPEG ist eine Übertragungsdarstellung. Die Beobachteransichten Welt/Fahrzeug sind keine Robotersensoren. Implementierung.

Der Anzeigeadapter abonniert Bilder, solange ein Betrachter oder Verbraucher sie benötigt. Ein akzeptiertes Abonnement bestätigt noch keinen Empfang. Nach 10 s Echtzeit ohne Bild erneuert er es bei weiterem Bedarf. Für den Live-Zustand muss ein neues Bild dekodiert werden. Erfassungsrate, Zeitstempel und Aktualitätsprüfungen der Navigation bleiben unverändert.

RGB-D-Inspektionskamera

RgbdCameraSensor erzeugt Farbe, Fließkomma-Tiefenbild und Punktwolke aus derselben Kamerageometrie über den Tiefenpuffer. Es modelliert weder Stereoabgleich noch ein physisches Streifenlicht-/ToF-Gerät. Farbabschwächung im Wasser fügt dem numerischen Tiefenkanal keine Unsicherheit hinzu.

Parameter Mitgelieferter BlueROV2
pose (0.4, 0, −0.25) m an base_link, Nickwinkel π/4; separate nach unten gerichtete Linse.
Bild und Sichtfeld 640×480, horizontal 1,05 rad.
Schnittebenen 0,1–80 m. Gazebo unterstützt getrennte depth_camera/clip-Grenzen; hier werden sie nicht gesondert überschrieben.
Rate und Aktivierung 5 Hz angefordert, bei Bedarf.

ROS-Brücken liefern je nach Konfiguration Image, CameraInfo und PointCloud2. Ungültige Tiefen und Werte außerhalb des Bereichs beibehalten. Eine Farbkarte ersetzt keine Tiefendaten. Die Wolke ist eine einzelne Beobachtung, keine akkumulierte SLAM-Karte. Implementierung.

Planarer LiDAR

GpuLidarSensor verwendet GPU-Strahlen gegen sichtbare Geometrie und wendet konfigurierte Entfernungs- und Rauschregeln an. Die Entfernung ist geometrisch; optische Empfangsleistung und Unterwasser-Laserausbreitung werden nicht berechnet. Objekte außerhalb von Einbauhöhe und Scanebene können unentdeckt bleiben.

Parameter Mitgelieferter WAM-V / Editor
lidar/scan/horizontal/samples 360, Winkel-resolution=1.
min_angle, max_angle −π bis +π rad, eine horizontale Ebene.
lidar/range/min, max, resolution Mitgeliefert: 0,2 / 50 / 0,02 m; Editor: 0,1 / 50 / 0,01 m. Maximale Reichweite 1–100 m einstellbar. Modellauflösung ist keine garantierte Messgenauigkeit.
Rate und Einbau Üblicherweise 5 Hz. Mitgeliefert: 2,5 m über der Basis; gemeinsame Demo: Bug (3.5, 0, 1.0) m zum Erfassen der Bojen. Editor-Posen werden gespeichert.
lidar/noise Kein zusätzlicher Rauschblock im erzeugten Scanner. Gazebo unterstützt Entfernungsrauschen.

Ausgabe sensor_msgs/LaserScan. Winkelmetadaten und nicht endliche Werte beibehalten; fehlendes Echo bedeutet nicht Entfernung null. Implementierung.

Einzel-Ping nach unten

Der Ping-Adapter reduziert 5×5 GPU-Strahlen auf den nächsten gültigen Treffer und veröffentlicht sensor_msgs/Range. Er beschreibt Strahlfläche und Reichweitengültigkeit, ohne akustische Echointensität, Wellenformen oder Mehrwegeausbreitung zu berechnen.

Parameter Editor
Strahlen und Winkel 5×5, je Achse ±0,00872665 rad (±0,5°). Sensoren gesonderter Demos können einen anderen Fächer verwenden.
Minimum / Maximum / Auflösung 0,1 / 30 / 0,01 m; Maximum 1–100 m einstellbar.
Rate und Pose Anfangs 5 Hz, gespeicherter Einbau nach unten.
Veröffentlichtes field_of_view Aus den Halbwinkeln berechneter Kegel um das quadratische Strahlenbündel. Jeder Strahl kann den Rückgabewert liefern.

Zu nahe Eingaben werden −∞, fehlende Rückgaben +∞, unbekannte NaN, sofern kein gültiger Treffer vorhanden ist. Der Erfassungszeitstempel bleibt erhalten. Ping und DVL sind alternative Unterwassernutzlasten im Editor. Ein Abstand innerhalb der Strahlfläche bestimmt keinen eindeutigen Bodenpunkt.

Doppler-Geschwindigkeitslog (DVL)

DopplerVelocityLog findet Bodenziele in gerenderten Strahlkegeln, projiziert die relative kinematische Geschwindigkeit auf die Strahlrichtungen, addiert Rauschen und löst die Geschwindigkeit durch kleinste Quadrate mit SVD. Akustische Träger und Dopplerspektren werden nicht synthetisiert beziehungsweise geschätzt.

<gz:dvl>-Parameter Ausgewähltes Profil
type, arrangement phased_array; vier Strahlen bei 45°, 135°, −45°, −135°, Neigung 30°, Öffnung 2°.
tracking/bottom_mode/when best, Bodenverfolgung. Wassermassenverfolgung ist eine hier nicht aktivierte Gazebo-Fähigkeit.
tracking/bottom_mode/noise/stddev Gaußsche Standardabweichung je Strahl: 0,002 m/s. Die gelöste Kovarianz hängt von der Geometrie ab.
minimum_range, maximum_range, resolution 0,1 / 20 / 0,01 m; Maximum 1–100 m einstellbar.
update_rate, reference_frame Anfangs 1 Hz; Referenzpose 0 0 0 0 0 0. Einbaurotation und Hebelarm gehören zur Kalibrierung.

Der Adapter verlangt mindestens drei Strahlen mit Bodenkontakt, gültige Kovarianz, erwartetes Bezugssystem und fortschreitende Zeitstempel. Er liefert geometry_msgs/Vector3Stamped und JSON-Status in std_msgs/String. Kontaktverlust erzeugt keine Nullgeschwindigkeit. Status enthält Bodenabstände je Strahl: Minima im Kegel, nicht zwingend zentrale Strahlschnittpunkte. Ohne Entfernungsvarianz ist die Unsicherheit unbekannt. Implementierung.

Bildgebendes Mehrstrahlsonar

Der POSIM-Anbieter wandelt Strahlgeometrie in akustische Rückstreuung, strahlkorrigierte Frequenzantworten und Intensitäten je Entfernungszelle um. Vorschau des physikalischen Sonarmodells erläutert Rust/WGPU, CUDA und CPU sowie akustische Messung gegenüber geometrischer Punktwolke.

Gruppe Konfiguration
Horizontale Strahlen 256 von −π/3 bis +π/3 rad, 120°.
Vertikale Strahlen 256 von −π/18 bis +π/18 rad, 20°.
sonarFreq, maxDistance, Strahlenbereich 700 kHz; Verarbeitung bis 15 m; Strahlen 0,2–15 m.
update_rate, raySkips Anfangs 2 Hz, Überspringfaktor 1.
soundSpeed, bandwidth, sourceLevel, sensorGain Anbieter-SDF für Ausbreitung, Verarbeitung und Anzeigeskalierung. Nicht alle sind Editorregler; zusammen mit Rohdaten speichern.

Der explorative Vergleich verwendet einen breiteren geneigten Fächer, dessen Einstellungen an den Abbildungen stehen. Rohdatenformat des Editors: marine_acoustic_msgs/ProjectedSonarImage. Der farbige Fächer ist eine Darstellung dieser Beobachtung. Der Anbieter muss die Kompatibilitätsprüfungen des Hosts bestehen.

IMU: Beschleunigung und Winkelgeschwindigkeit

ImuSensor erhält Kinematik, zieht die im Sensorrahmen ausgedrückte Gravitation für die spezifische Kraft ab und wendet achsweises Rauschen an. Die Orientierung stammt aus der Simulatororientierung relativ zur konfigurierten Referenz; sie ist keine geschätzte Bordlage.

Parameter Auswahl
update_rate WAM-V: 200 Hz; BlueROV2: 1000 Hz angefordert. Physikschritte begrenzen beide.
pose, orientation_reference_frame Einbau und Referenz bestimmen Achsen. BlueROV2 mit direkter ROS-Steuerung setzt die Einbaurotation auf null; das ArduPilot-Modell behält die schnittstellenspezifische Orientierung. Ausgabeframes und TF beachten.
imu/linear_acceleration/{x,y,z}/noise mean/stddev in m/s²; bias_mean/bias_stddev für Bias; dynamic_bias_stddev/dynamic_bias_correlation_time für dessen Entwicklung. Die Basis-IMUs konfigurieren diese Blöcke nicht.
imu/angular_velocity/{x,y,z}/noise Entsprechende Gyroskopparameter in rad/s. Aktivierter dynamischer Bias ist zeitlich korreliert.

Ausgabe sensor_msgs/Imu. Rohe IMU und fusionierte MAVROS-Lage sind unterschiedliche Signale. Bei VIO- oder Reglerbewertung müssen Rauschfreiheit und Orientierung aus dem Simulator-Referenzzustand angegeben werden. IMU, Gaußsches Rauschen.

Die JSON-Schnittstelle von ArduPilot interpoliert bereits berechnete physikalische Zustände zu zusätzlichen SITL-Abtastwerten. Der Routenplanung und Regelung beschreibt die Abtastraten und das Verhalten bei geänderter Zeitschrittweite. Die ROS-IMU-Erfassung bleibt durch die Physikschritte begrenzt; interpolierte SITL-Werte liefern keine zusätzlichen physikalischen Details.

Magnetometer

MagnetometerSensor dreht den Weltfeldvektor in das Sensorkoordinatensystem und addiert konfiguriertes Rauschen je Achse. BlueROV2 erhält ein 20-Hz-Magnetometer am base_link-Ursprung. Welten verwenden Tesla und ENU: use_units_gauss=false, use_earth_frame_ned=false.

Parameter Bedeutung
Welt-magnetic_field Verwendeter Feldvektor; Weltdefinition aufbewahren.
pose, update_rate Einbau und angeforderte Rate.
magnetometer/{x,y,z}/noise Gaußscher Mittelwert/Standardabweichung in Tesla. Kein zusätzlicher Rauschblock beim ergänzten Sensor.

Ausgabe sensor_msgs/MagneticField. Hart-/Weicheisenstörungen des Fahrzeugs und lokale Anomalien werden nicht modelliert. Der WAM-V-ArduPilot-Kompass nutzt das SITL-Feldmodell. Ein ROS-Topic belegt nicht, welche Messung die FCU fusioniert. Implementierung.

GNSS-Empfänger

posim::Gnss transformiert die Antennenposition in geografische Koordinaten, addiert reproduzierbares Positions-/Geschwindigkeitsrauschen, verzögert Nachrichten und prüft Eintauchen sowie Abschattung. Ausgaben sind NavSatFix/Status und im GNSS-Navigationsmodus MAVLink-GPS_INPUT.

Parameter Aufgabe
update_rate, latency, reacquire_seconds Rate, Verzögerung und durchgehende trockene Erfassungszeit in Simulationszeit.
horizontal_stddev, vertical_stddev, velocity_stddev, seed Gaußsche Fehlergrößen und Reproduzierbarkeit.
link_name, pose, water_level, wave_topic, dry_margin Hebelarm und wellenabhängige Eintauchprüfung.
enabled, Abschattungs-Topic Auswahl und vorgegebene Empfangsblockade.

GNSS und Navigation enthält verbindliche Werte, Kovarianzen, ENU/NED, Höhenbezug und EKF-Unterscheidungen. Satellitengeometrie und Mehrwegeempfang sind nicht enthalten.

Druck und Tiefe

Simulatortiefe und ArduSub-Tiefenschätzung sind vom eigenständigen SubseaPressureSensorPlugin zu unterscheiden. Dieses Plugin verwenden weitere POSIM-Modelle wie RexROV und Slocum; der WWW-POSIM-Editor bietet es nicht als Nutzlast an.

Es liest die Tiefe des Modellursprungs unter der mittleren Ebene z=0, begrenzt sie über Wasser auf null und addiert linearen hydrostatischen Druck. Ausgabe: sensor_msgs/FluidPressure in Pa, optional abgeleitete Tiefe in geometry_msgs/PointStamped.

Parameter Wert oder Aufgabe
namespace, topic Modellzuordnung und Ausgabe; Standardtopic sea_pressure.
standard_pressure, kPa_per_meter 101,325 kPa und 9,80638 kPa/m; interne kPa werden in Pa umgerechnet.
estimate_depth_on, update_rate Inverse Tiefenberechnung anfangs aktiviert; Rate 0 ohne zusätzliche Pluginbegrenzung.
saturation Mit Standard 3000 eingelesen, aber nicht im Messpfad angewendet. Keine wirksame Reichweitengrenze.

Das Plugin addiert kein Druckrauschen, meldet aber eine Varianz aus 3 kPa Standardabweichung. Diese Angabe belegt kein tatsächlich erzeugtes Rauschen. Es nutzt den Modellursprung statt eines kalibrierten Druckanschlusses und erfasst keinen Wellendruck. Implementierung.

USBL-Komponenten in POSIM

UsblTransceiver und UsblTransponder tauschen simulierte Positionen und Befehle aus und erzeugen relative Positionsnachrichten. Der Transponder stört Weltkoordinaten mit Gaußschem Rauschen. Das ist eine positionsbasierte Testkomponente, kein Phasendifferenz-Empfänger und kein vollständiger akustischer Ausbreitungslöser. Sie gehört nicht zu den Standardnutzlasten des Editors.

Gruppe Aufgabe
namespace, Namen/IDs, zugeordnete Objekte Geräte, Modelle und Nachrichtenwege.
enable_ping_scheduler, ping_frequency, interrogation_mode Geplante Abfragen, gemeinsame/einzelne Adressierung.
sound_speed Anfangs 1540 m/s; Callbacks können eine Tiefen-/Temperaturnäherung einsetzen.
Transponder-mu, sigma Positionsrauschen mit Mittelwert 0 und Standardabweichung 1 m.

Die Ausbreitungswartezeit verwendet Echtzeit-sleep im Callback. Sie bildet kein präzises Laufzeitmessgerät in Simulationszeit. Siehe Transceiver und Transponder.

Odometrie, Referenzzustand und Aufzeichnungen

OdometryPublisher liefert simulierte Pose und Geschwindigkeit. Die automatische Weltreise veröffentlicht zusätzlich gemessenen nativen Zustand. Das sind Referenzsignale, keine Radodometrie oder fusionierte Schätzung. Über-/untergeordnetes Bezugssystem, Veröffentlichungsrate und Ursprungsverschiebungen aufzeichnen. FCU- und SLAM-Schätzungen getrennt kennzeichnen.

Für reproduzierbare Versuche aufbewahren: endgültiges SDF, Sensormanifest, TF-Extrinsik, Kalibrierung, Anwendungs-/Anbieterversionen, Zeitschritt, Zufallsseeds, Erfassungszeitstempel, Gültigkeitsmeldungen und Rohmessungen. Videos, Bildschirmfotos und Farbkarten ergänzen diese Daten.

Ein Fahrzeug vorbereiten · Sensoren anpassen · Simulation, Rendering und Sensoren · Meeresdynamik und Rendering

Dokumentation durchsuchen