Komponenten und Bibliotheken
WWW-POSIM verbindet offene Simulations- und Algorithmusbibliotheken mit privatem Anwendungscode. Daraus entstehen Web-Arbeitsbereich, installierte Anwendung und Dienst-APIs.
Aufbau von WWW-POSIM
Offene Komponenten
- POSIMMotor, Meeresmodelle und Sensoren
- POSIM-TerrainGeografisches Gelände, Meshes und Bilder
- POSIM-RoutingNavigation und geprüfte Routenplanung
- POSIM-ControlAntrieb und Bewegungsstrategien
- POSIM-SLAMSensorbasierte Schätzung und Kartierung
Private Anwendungskomponenten
- Arbeitsbereich und BereitstellungOberfläche, Ansichten und Video
- Konten und SitzungenAnmeldung, Rechte, Kontingente und Warteschlangen
- Welten und gespeicherte RessourcenVorbereitung, Fahrzeugbibliothek und Speicher
- ReisekoordinationRoute, Wiederaufnahmepunkte und Wiederherstellung
- Desktop-IntegrationStarter, Motorvorbereitung und Pakete
POSIM
POSIMPOSIM-Terrain
POSIM-TerrainPOSIM-Routing
POSIM-RoutingPOSIM-Control
POSIM-ControlPOSIM-SLAM
POSIM-SLAMWWW-POSIM
WWW-POSIM — Privates Repository; Zugriff erforderlich
Die Anwendung verknüpft Bibliotheken mit Konten, dauerhaften Arbeitsbereichen und Bedienoberflächen. Verfügbare Sensoren und Schätzverfahren hängen vom installierten Motor und seinen Anbietern ab.
Dokumentation nach Komponenten
| Komponente | Verwendung | Technische Referenz |
|---|---|---|
| Gelände | Gelände für einen Standort erzeugen | Algorithmen zur Geländeerzeugung |
| Planung und Steuerung | Weltreise LIVE, Einen lokalen Arbeitsbereich steuern | Routenplanung und Regelung |
| Motor und Anwendung | Den Arbeitsbereich kennenlernen, Welten anpassen | Simulation, Rendering und Sensoren |
Die Geländebibliothek erzeugt Zahlenfelder, Bilder und Meshes. WWW-POSIM verwaltet geladene Kacheln, Detailstufen, Kollisionsbereitschaft und Sitzungscaches. Eine öffentlich verfügbare Bibliothek bedeutet nicht, dass ihr ausführbarer Sensor oder SLAM-Schätzer auf dem Rechner installiert ist.
Der technische Katalog für maritime Forschung umfasst Meeresdynamik und Rendering, Sensormodelle und Parameter, Algorithmen zur Geländeerzeugung, Routenplanung und Regelung, Simulation, Rendering und Sensoren, Vorschau des physikalischen Sonarmodells und GNSS und Navigation. Jeder Abschnitt trennt Modell, Konfiguration, Ausgaben und Aussagegrenzen.
Öffentliche Bibliotheken
| Bibliothek | Aufgabe |
|---|---|
| POSIM | Simulationsmotor, Meeresumgebungen, Fahrzeuge und Sensoren auf Gazebo |
| POSIM-Terrain | Geografische Python-Abtastung, Land-/Meeresquellenwahl, Mesh-/SDF-Export und Texturen |
| POSIM-Routing | Globale, küstennahe und lokale Python-Routenplaner; benötigt POSIM-Terrain |
| POSIM-Control | Python-Bewegungsstrategien und C++-Gazebo-Antriebsplugins für Führungs-/Folgefahrzeuge |
| POSIM-SLAM | Eigenständige visuelle, akustische und inertiale Schätzbibliotheken; Anwendungsfunktionen benötigen passende Sensoren und Anbieter |
POSIM-Terrain
Verfügbare Höhen- und Bathymetriedaten werden zu Land- und Meeresbodengeometrie zusammengeführt. Das Zahlenfeld dient als Grundlage für Mesh und Kollisionsprüfungen der Route; Sentinel-2 liefert die Landtextur.
- Eingaben: Breite, Länge, Regionsgröße und Rasterabtastung.
- Ausgaben: Höhenfelder, Meshes, SDF, Texturen und Quellenmanifeste.
- Direkte Nutzung: Region erzeugen oder Stadtgeländepaket laden.
Das POSIM-Terrain-README erklärt Installation, Satellitentexturen und Export.
POSIM-Routing
Die Bibliothek plant Hafenreihenfolge und Routen zu den Ankunftsgebieten. OSM-Landpolygone führen die Hafenverbindungen. Küsten- und Lokalplaner prüfen das dargestellte Gelände. Katalogposition des Hafens und Ankunftsziel im Wasser sind getrennte Eingaben.
- Eingaben: Start, Ziel, Durchfahrtstore und numerisches Gelände.
- Ausgaben: globale Routen, Küstenkorridore und lokale Wegpunkte.
- Direkte Nutzung: Seeroute exportieren oder auf erzeugtem Gelände planen.
Das POSIM-Routing-README enthält Befehle und APIs. Eine globale Route allein bestätigt keine Wassertiefe.
POSIM-Control
Die Bibliothek wirkt über Antriebskräfte auf Gazebo-Fahrzeuge. Das Führungsfahrzeug folgt Wegpunkten; das Folgefahrzeug folgt gemessenen Führungsposen. Python-Strategien beobachten Bewegungen, begrenzen Geschwindigkeiten und bewerten Stabilität, Fortschritt und Wiederherstellung.
- Eingaben: geprüfte Wegpunkte, Geschwindigkeitsanforderungen und gemessener Zustand.
- Ausgaben: Antriebsbefehle, Reglerstatus und Bewegungsentscheidungen.
- Direkte Nutzung: Python-Strategien verwenden oder native Führungs-/Folgeplugins bauen.
Das POSIM-Control-README beschreibt Modellanforderungen, Build und Steuerungstopics. Native Plugins benötigen Gazebo-Entwicklungspakete in einer eingerichteten POSIM-Umgebung.
Jede Bibliothek enthält englische und koreanische Anleitungen, Quellstruktur, Installation und Tests. WWW-POSIM bindet feste Revisionen als Git-Submodule ein. Laufzeitadapter importieren deren Implementierungen; Pakete enthalten diese ausgewählten Quellen.
git submodule update --init --recursive
Zusammenspiel und Stadtbeispiele
POSIM-Terrain erzeugt Daten, POSIM-Routing plant und prüft Wege, POSIM-Control folgt freigegebenen Wegpunkten, während Gazebo die Bewegung berechnet. WWW-POSIM beobachtet das Ergebnis und koordiniert weitere Gelände-, Routen- und Steuerungsaktualisierungen. Konten, Sitzungseigentum, Video, Reise-Wiederaufnahmepunkte und AIS-Anzeige gehören zur Anwendung.
Web und installierte Anwendung verwenden dieselben Revisionen. Der POSIM-Bibliotheksleitfaden behandelt Modelle, Sensoren und Motor.
Die POSIM-Terrain-Beispiele enthalten New York, Busan und Tokio mit Land und Meer:
- Region: 20 × 20 km.
- Raster: 257 × 257 Eckpunkte, Abstand 78.125 m.
- Quellen: GEBCO 2026, Copernicus GLO-30 und verfügbare regionale Bathymetrie.
- Dateien: Meshes, SDF, Zahlenarrays, Sentinel-2-Landtexturen und Manifeste.
- Jede Stadt enthält Gazebo-Aufnahmen und ein README zur Neuerzeugung.
Ein engeres Ausgaberaster erhöht nicht die Genauigkeit der Quelldaten. Siehe Algorithmen zur Geländeerzeugung.
Der native Mac-Motor enthält eine lokal angepasste Gazebo-Sim-Sensors-Komponente unter Apache-2.0. Geänderte Quellen, Build-Rezept, Patch, Hinweise und Lizenz liegen im Motor unter www-posim/sources/gz-sim-sensors-stop. Der POSIM-GNSS-Sensor besitzt eine eigene MIT-Lizenz und einen Lizenzhinweis.