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

Simulation, Rendering und Sensoren

WWW-POSIM koordiniert den Arbeitsbereich. POSIM und Gazebo berechnen Physik und Sensoren; Browser und Betrachter stellen die Ergebnisse dar.

Verarbeitung

  1. 1. Gelände prüfen und Sitzung vorbereiten

    Prüft Schema, Engine-/Bibliothekskompatibilität und Ressourcen. Transformiert und validiert die Startpose und erstellt sitzungseigene Welt-/Fahrzeug-SDF. Ein Nonce kennzeichnet den Lauf.

  2. 2. Gazebo und Regler starten

    Lädt Masse, Trägheit, Kollisionen, Gelenke und Umweltsysteme. Wählt ArduPilot, ROS 2 direkt oder die automatische Reisesteuerung.

  3. 3. Befehle → Physikintegration

    Wendet Aktuatorkräfte, Auftrieb, Hydrodynamik, Wellen und Kontakte an. Gazebo berechnet Zeitfortschritt, Pose und Geschwindigkeit. Bildanimation treibt keine Physik an.

  4. 4. Zustand → Sensoren und ROS 2

    Erzeugt konfigurierte Nachrichten und stellt Zustand über Brücken und Dienste bereit. Kameras und GPU-LiDAR benötigen weiter Gazebo samt Grafikumgebung.

  5. 5. Arbeitsbereich und RViz

    Browser zeichnet empfangenen Zustand und Gelände, Gazebo liefert Engine-Bilder. RViz Web öffnet Lichtblick mit Sitzungsverbindung und Layout; die App startet mitgeliefertes natives RViz.

  6. 6. Überwachen, Abdeckung erweitern oder wiederherstellen

    Verfolgt Start, Topics/TF, Bilder und Fortschritt getrennt. Lädt geprüftes Gelände voraus. Ursprungverschiebungen transformieren Navigation und Folgespuren unter Erhalt physischer Geschwindigkeiten.

Technologieübersicht

Komponente Verantwortung Katalog
POSIM-Terrain und Geobibliotheken WGS 84, projiziertes Zahlengelände, Raster/Küsten, Netze und Herkunft. Algorithmen zur Geländeerzeugung
Gazebo und Wave Sim Starrkörper, Kontakte, Aktuatoren, Auftrieb, Widerstand und periodische Wellen. Meeresdynamik und Rendering
POSIM-/Gazebo-Sensoren Rendering, Kinematik, Akustik, Rahmen und Gültigkeit. Sensormodelle und Parameter
POSIM-Routing und POSIM-Control Geländeabstand, begrenzte Planung und native Reisepropulsion. Routenplanung und Regelung
ArduPilot SITL und MAVROS Modi, Navigationsschätzung, MAVLink-/ROS-Konvertierung und Aktuierung. GNSS und Navigation · Einen lokalen Arbeitsbereich steuern
Ogre2 und Three.js Engine-/Sensorrendering beziehungsweise Browserszene. Gleicher Zustand, unterschiedliche Bildwege. Meeresdynamik und Rendering
POSIM-SLAM Schätzung/Kartierung mit passenden Eingaben, Extrinsiken und Anbieter. Sensormodelle und Parameter · POSIM-SLAM
WWW-POSIM Konten, Sitzungen, Zusammenbau, temporäre Freigaben, Kachelzyklus, Betrachter und App-Auslieferung. Komponenten und Bibliotheken

Bibliotheken beschreiben wiederverwendbare Implementierungen. Eine lauffähige Konfiguration braucht außerdem Plugin-Binärdateien, kompatibles SDK, Modellzusammenbau und Nachrichtenverbindungen. Sensorauswahl oder eine SLAM-Aufzeichnung belegen keinen aktiven Schätzer in jedem Installationspaket.

Uhren, Rahmen und Identität

Vertrag Bedeutung
Simulationszeit / Echtzeit Physik und Erfassung verwenden Simulationszeit. Zulassung, Verbindungsablauf und manche Watchdogs nutzen Echtzeit. Für Durchsatz- und Verzögerungsmessung beide erfassen.
Gelände map / Körper FLU Geografisches Gelände wird metrisch projiziert; Körperachsen vorne/links/oben. Extrinsiken ordnen die Sensormontage zu.
Kamera / FCU Optische Achsen rechts/unten/vorne. ArduPilot wandelt ENU/FLU in NED/FRD; GNSS nutzt einen eigenen FCU-Ursprung. Transformationen erhalten, nicht nur Achsen umbenennen.
Sitzung und Konfiguration Nonces unterscheiden Läufe, Sensormanifeste/Geländeidentität/Bibliotheksstände die Konfiguration. Ein neuer Lauf braucht aktuelle Topics und Freigaben.
Reset / schwebender Ursprung Reset verändert die Messzeitlinie. Ursprungtranslation verändert Koordinaten, erhält aber physische Geschwindigkeit. Beide Ereignisse müssen in Logs erkennbar sein.
Wahrheit / Beobachtung / Schätzung Gazebo-Pose ist Referenz; Kamera/GNSS/DVL sind Messungen; FCU/SLAM sind Schätzungen. Herkunft getrennt halten und keinen Schätzer gegen eine Wahrheit bewerten, die er direkt als Eingang nutzt.

Rendering und Messung

Three.js zeichnet die Browser-Szene. Diese Auswahl verlagert Kamera- und GPU-LiDAR-Erzeugung nicht aus Gazebo. Ogre2 rendert Engine-Ansicht und renderingbasierte Sensoren. Sicht-LOD, Masken, Linsenposition, Wassermaterialien und Clipping können daher Beobachtungen ändern, obwohl Kollisionsgeometrie gleich bleibt.

Sonar-Strahlgeometrie, RGB-Farbe und Tiefe sind getrennte Ausgaben. Reine RGB-Überlagerungen können aus akustischer Geometrie ausgeschlossen werden. Eine sichtbare Punktwolke kann nur eine einzelne Strahl-/Tiefenbeobachtung sein; Akkumulation und Posekorrektur brauchen einen laufenden Kartierungsprozess. Siehe Vorschau des physikalischen Sonarmodells.

Video- und Sensortransport

  1. Gazebo → Messungen und Bilder

    Der Engine-Host erzeugt Zustand, Nachrichten und Pixel. Browser rendert den empfangenen Zustand separat.

  2. App → Freigabe → Gateway

    Die Website bereitet Konto-/Sitzungszugriff und Adressen vor. Öffentliche Daten kommen direkt von einem getrennten Simulator-Ursprung. Private Bilder und RViz nutzen begrenzte temporäre Freigaben, wenn der Host direkten Transport anbietet.

  3. Betrachter → Puffer und Alter → Anzeige

    Video nutzt einen Wiedergabepuffer; Nachrichten behalten Zeitstempel und Empfangsstatus. Verbinden und Veraltet unterscheiden und Sensorzeit sowie physisches RTF prüfen.

Schnittstelle Format und Verhalten
Gazebo-Szenen von LIVE und Hongkong-Demo Gemeinsames H.264-HLS mit kurzen Segmenten direkt vom Medienserver und Wiedergabepuffer.
Hongkong-Demo-RGB Gemeinsames H.264-HLS; Verbindungsanzeige bis zum Startpuffer.
Persönliche Szene/Kameras JPEG-Einzelbildanfragen. Geeignete Hosts bieten begrenzten Direktzugriff, die App ihren lokalen Dienst.
Komprimierte ROS-Kamera JPEG CompressedImage, im Standardkonnektor bis 1 Hz Simulationszeit, getrennt von HLS.
RViz Web und externe ROS-Betrachter ROS-Nachrichten über WebSocket. RViz Web ist lesend mit Topicgrenzen gemäß Visualisierung mit RViz und Foxglove.

Vercel kann Oberfläche und kurze Verbindungsanfragen bedienen. Dauerhafte öffentliche Videos und Topicstreams umgehen seine Funktionen. Privater Direkttransport folgt den Hostfähigkeiten. Temporäre Verbindungsadressen privat halten. Ein sichtbarer Frame allein misst keine Regelungsverzögerung.

Gemeinsame Kodierung und Bedarf

LIVE ist eine lesende Übertragung. Jede angeforderte Ansicht hat einen gemeinsamen Encoderprozess. Anfragen erneuern eine 5-s-Lease. Ohne Zuschauer stoppt der Encoder nach Ablauf. Unbeobachtete Szenenkameras lösen ihre Gazebo-Abonnements; geplante Ankunftsfotos können separat kurze Aufnahmen anfordern. Physik, Navigation und Sensoren laufen weiter.

Stream Videoziel
Szene, niedrige Qualität 15 FPS, bis 640 × 360, 0,6 Mbit/s
Szene, hohe Qualität 15 FPS, bis 960 × 540, 1,2 Mbit/s
Gewählte Fahrzeugkamera 5 FPS, bis 640 Pixel breit, 0,4 Mbit/s
Unbeobachtete Ansicht Encoder aus nach Ablauf der 5 s

Beide Szenenqualitäten entstehen einmal aus denselben Bildern für alle Zuschauer. Der Player wählt nach Bandbreite; niedrige Qualität behält 15 FPS als Ziel. Fahrzeugkamera und interaktive Demo haben eigene Einstellungen.

Alle können die LIVE-Fahrt auf der Anmeldeseite verfolgen. Die ausgewählte Szene bleibt verbunden, solange ein Teil der Fahrtansicht sichtbar ist. Dazu gehören Karten und Fahrzeugdaten. Beim Verlassen des Vollbilds bleibt dieselbe Szene verbunden. Beim Pausieren, Ausblenden oder Schließen des Tabs oder beim Öffnen der Live-Demo oder des Web-Arbeitsbereichs endet der Stream der Anmeldeseite. Eine geöffnete, sichtbare Sensorkamera erneuert ihre eigene Verbindung. Video und Live-Metadaten kommen direkt vom Server. LIVE hat keine Zuschauergrenze. Für die interaktive Demo gilt eine eigene Grenze von zwei Personen.

Während des ersten Puffers lädt der Browser ein bereits zwischengespeichertes Szenen-JPEG direkt vom Server. Die Anfrage prüft den nativen Welt-Nonce. Verbindungstext und animierter Balken stehen unter Reisestatus, Ziel, RTF und Geschwindigkeit. Welt-/Ansichtswechsel verwerfen die Vorschau; verborgene Szenen pausieren Anfragen. Beim ersten Abspielen verschwindet sie. Spätere Aussetzer behalten den letzten dekodierten Frame mit Wiederverbindungsanzeige.

Szenenabonnements warten auf frische native Telemetrie. Geländevorbereitung muss die großen Szenenkameras nicht aktivieren. Gemeinsame Kodierung verhindert nicht steigenden Netzwerkverkehr: 40 Zuschauer mit Szene und Kamera ergeben 40–64 Mbit/s Zielbitrate vor Protokollaufwand. Uplink und Rendering bestimmen die praktische Kapazität. Zuschauerzahl allein senkt nicht die FPS-Vorgabe.

Puffer und tatsächliche Bildrate

LIVE startet 3 s hinter der HLS-Livekante; bei Wiedergabestörungen kann das Ziel auf 12 s steigen. Ein neuer Stream ist nach zwei Segmenten zu 2 s und der Kalibrierung der Aufnahmezeit bereit: etwa 4 s plus Aufnahme- und Encoderstart. Auch die interaktive Demo startet mit 3 s. Instrumente und Kameras folgen der Videozeit; die gesamte Verzögerung umfasst Kodierung und Segmentverfügbarkeit.

Instrumente und Kameras folgen der Videopräsentationsuhr. Aufnahme-bis-Anzeige enthält außerdem Kodierung und Segmentverfügbarkeit; das Pufferziel ist keine Messung der Gesamtverzögerung.

Erfassung folgt Simulationszeit. Niedriger RTF und Aufnahmestopps senken unterschiedliche Bilder je Echtzeitsekunde. source_fps, source_frames und max_source_gap_seconds stammen aus Quelldatenübergaben. Ein 15-FPS-Decoder kann Frames wiederholen und belegt keine 15 unterschiedlichen Aufnahmen pro Sekunde.

Einordnung und Verantwortung

Fertiges Gelände, laufende Sitzung und frische Kamera sind getrennte Zustände. Hintergrundaktualisierung von Bildern schreibt keine laufenden Kollisionen um. Netzhöhen bestimmen Kontakte; Satellit, Sand, Wasser und Karten sind visuelle Schichten. RTF vergleicht Simulations- und Echtzeit.

WWW-POSIM verantwortet Sitzungen, Transport und Betrachterstart; Terrain, Routing und Control ihre jeweiligen Algorithmen. POSIM-Engine- und Bibliotheksleitfaden.

Komponenten und Bibliotheken · Algorithmen zur Geländeerzeugung · Routenplanung und Regelung · Welten anpassen · Vorschau des physikalischen Sonarmodells

Dokumentation durchsuchen