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
- Physikalischer Zustand oder gerenderte Geometrie
Gazebo liefert Bewegung, Weltfelder oder Strahlschnittpunkte. Jeder Sensor besitzt eine Einbautransformation und einen Erfassungstakt.
- Messmodell
Das Plugin projiziert Bilder, bildet Trägheitsmessungen, löst Strahlgeschwindigkeiten oder berechnet akustische Echos. Rauschen und Gültigkeit entstehen hier.
- Nachrichten und Koordinatensysteme
ROS–Gazebo-Brücken und POSIM-Adapter erhalten Messwerte, benennen Bezugssysteme, wandeln Einheiten um und melden fehlende Daten.
- 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