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

Den Arbeitsbereich kennenlernen

Beginnen Sie mit einem vorbereiteten Gelände. Lernen Sie die Anzeigen kennen, bevor Sie Befehle an das Fahrzeug senden.

Anmelden und die erste Welt starten

  1. Registrieren Sie sich auf WWW-POSIM, bestätigen Sie Ihre E-Mail-Adresse und melden Sie sich an. Prüfen Sie gegebenenfalls den Spamordner oder fordern Sie eine neue Nachricht an. Die Bestätigung gilt auch für die installierte App.
  2. Wählen Sie in der App Simulator starten. Öffnen Sie auf der Website Ihren persönlichen Arbeitsbereich; ein Serverplatz kann Wartezeit erfordern.
  3. Öffnen Sie Arbeitsbereich, wählen Sie Vorgeneriertes Gelände und KMOU waterfront · 1 × 1 km.
  4. Wählen Sie unter Regionales Gelände → Fahrzeug den WAM-V, Tiefe 0 m und Autopilot.
  5. Wählen Sie Erzeugte Welt starten. Warten Sie auf das Fahrzeug und aktuelle Positionsdaten. Das erste Einrichtungsfenster der App bleibt bis zum erfolgreichen Weltstart geöffnet.
Startfenster mit Demos, vorbereitetem Gelände, Übungsbereich und eigener Welt
Startfenster mit Demos, vorbereitetem Gelände, Übungsbereich und eigener Welt.
Einstieg Zweck
Demo-Welten Startet WAM-V oder BlueROV2; andere Vorschauen zeigen ihre Verfügbarkeit.
Vorgeneriertes Gelände Zeigt fertige, herunterladbare und bereits erzeugte Gelände.
Übungsbereich Bereitet die Übung vor, sofern verfügbar.
Eigene Welt Öffnet regionales Gelände, Fahrzeugeditor, RViz-Werkzeuge und Speicherverwaltung.
Ort → Fahrzeug → Prüfen Legt Gelände, Fahrzeug und Startpose fest und prüft die Einstellungen vor dem Start.

Wählen Sie Autopilot oder ROS 2 direkt vor dem Weltstart. Für einen anderen Steuerungstyp starten Sie eine Welt mit der anderen Auswahl. Ein ArduPilot-Moduswechsel ist davon getrennt. Beachten Sie die Grenzen für Koordinaten und Tiefe. Der Übungs-Seed ist eine ganze Zahl von 0 bis 1 000 000; ohne Wert wird die Anordnung automatisch gewählt. Freie Erkundung und Administrator-Referenzläufe ignorieren diesen Seed.

Auf dem Mac wird vorbereitetes Gelände bei der ersten Auswahl mit Fortschrittsanzeige heruntergeladen. Anschließend bleibt es mit seiner festgelegten Inhaltsrevision offline verfügbar. Bei einem Fehler prüfen Sie die Verbindung und wählen es erneut. Die WAM-V-Demo nutzt Hongkong: eine korallfarbene Boje liegt 16 m voraus und 5 m links, eine limettengrüne 30 m voraus und 8 m rechts. Prüfen Sie beide mit Frontkamera und LiDAR.

Demo-Welten

Aufbau der Oberfläche

Laufender Arbeitsbereich mit Szene, Sensoren, Fahrzeugsteuerung und Karte
Laufender Arbeitsbereich mit Szene, Sensoren, Fahrzeugsteuerung und Karte.
Bereich Inhalt
Obere Leiste Fahrzeug, Gelände, Live-Status, Arbeitsbereich, Sprache sowie Szenenvergrößerung und Panelanzeige. Bei erfasster Nutzungszeit erscheint auch die Sitzung.
Mitte Fahrzeug-, Welt- und Kartenansicht.
Links Umgebung und Anzeige unter Szene, Messungen unter Sensoren sowie ROS-Topics.
Rechts ArduPilot- oder ROS-2-Steuerung, darunter Fahrzeuginstrumente und Diagramme.
Untere Karte Geografische Position, Wegpunkte und Missionsbefehle unter Bodenstation.

Öffnen Sie Überschriften oder + / −. Der Inhalt scrollt innerhalb des verfügbaren Platzes; andere Bereiche können sich dafür einklappen. Panels blendet die Panels ein oder aus. Szene fokussieren vergrößert die Szene und lässt die Karte erreichbar. Die Simulation läuft weiter. Der Einstiegsbildschirm bietet außerdem Rückkehr zur Hauptseite und Abmeldung.

Ansicht oder Aktion Wirkung
Fahrzeug Folgt dem Fahrzeug; erlaubt Umkreisen und Zoomen.
Welt Schräge Nahübersicht mit begrenztem Zoom und Schwenkbereich.
Karte Nach Norden ausgerichtete Karte mit simulierter Position; Ziehen verschiebt die Karte.
Ziehen, rechte Maustaste, Mausrad Verschieben, Umkreisen oder Zoomen gemäß den Hinweisen der Ansicht.
Spur löschen Entfernt geplante Route und gemessene Spur aus der Ansicht. Die Aufzeichnung läuft ab der aktuellen Position weiter; der Missionsbericht bleibt erhalten.

Der untere Kompass beschreibt die Beobachterkamera, nicht den Fahrzeugkurs. Der feste Pfeil zeigt nach vorn, die Buchstaben drehen sich mit der Nordrichtung. Die Zeitanzeige zeigt Simulationszeit. 1,00× bedeutet Fortschritt in Echtzeit.

Gelb kennzeichnet die geplante Route, Blaugrün die gemessene Spur. Bis zu 1 024 Segmente bleiben sichtbar. Eine neue geführte Mission löscht die Gazebo-Spur. Die 5 mm breiten Szenenlinien erscheinen nicht in Sensorbildern.

Szene, Wellen und Strömung

Szenenpanel mit Umgebungs- und Renderereinstellungen
Szenenpanel mit Umgebungs- und Renderereinstellungen.
Abschnitt Bedienung
Wellen Seegang 0 bis 4 wählen und anwenden. Erweiterte Einstellungen bieten Wind, Richtung und Steilheit.
Meeresströmung Strömung einschalten, gleichförmige Strömung oder Tiefenprofil wählen und Strömung anwenden ausführen. Bestätigung des Solvers abwarten.
Schiffsverkehr Zeigt Schiffe aus aktuellen AIS-Meldungen; abhängig von Abdeckung und Simulationsgeschwindigkeit.
Szenenrenderer Wählt Browser oder Gazebo, sofern verfügbar, und öffnet Unterwassereffekte.
Anzeige Meeresboden, Oberfläche, Gitter und Achsen; je nach Ansicht Beleuchtung und Wasser-/Kartenopazität.
Grafikleistung Gemessene Renderstatistik des Browsers.

Freie Arbeitsbereiche beginnen mit Seegang 2. Die Vorgaben verwenden Windgeschwindigkeiten von 0, 1, 3, 6 und 8 m/s bei Steilheit 1. Sie sind Näherungen, keine garantierten Wellenhöhen. Die Info-Schaltfläche zeigt WMO-Bereiche. Übungen behalten ihre vorgegebenen Bedingungen.

Beenden Sie Mission oder direkte ROS-Steuerung vor Strömungsänderungen. Das Profil beginnt bei 0 m Tiefe und erlaubt bis zu acht Knoten mit 0–1 m/s. Horizontales Ziehen ändert die Geschwindigkeit; die Tabelle bearbeitet Tiefe und Richtung. 0° zeigt nach Osten, 90° nach Norden, jeweils in Fließrichtung. In jedem Physikschritt werden die Vektoren an der tatsächlichen Tiefe jedes Links linear interpoliert. Unterhalb des tiefsten Knotens bleibt dessen Strömung bestehen. Sie verändert den wasserrelativen Widerstand; Wellen behalten ihr eigenes Modell.

Die installierte App öffnet standardmäßig Gazebo. Browser reduziert die Last der Gazebo-Szenenkamera; Physik, Kameras und GPU-LiDAR werden weiterhin in Gazebo berechnet. Die Auswahl gilt für die geöffnete Ansicht. Die BlueROV2-Verfolgerkamera glättet Bewegungen und zeigt die Oberfläche. Vertikales Ziehen in geeigneten Ansichten ermöglicht den Blick von unten.

Unterwasseransicht

Öffnen Sie Szene → Szenenrenderer → Unterwasseransicht. Änderungen wirken auf die Gazebo-Szene und Kamerafarbbilder einschließlich RGBD. Numerische Tiefenwerte und Kollisionsgeometrie bleiben erhalten.

Gazebo zeigt die vollständigen Effekte; Browser übernimmt Sanddetails und Bodenlinien. Das Bildmodell verwendet einen ebenen mittleren Meeresspiegel und PBR-Oberflächen. Unbeleuchtete Materialien und eigene Wassershader haben eine eigene Darstellung. Partikel und Lichtmuster sind visuelle Näherungen. Dunst, Dämpfung und Verdeckung begrenzen die nutzbare Sicht zusätzlich zum geometrischen Clipping. Siehe Technische Daten und Meeresdynamik und Rendering.

Sensoren und ROS-Topics

Bild einer simulierten Fahrzeugkamera mit Empfangssteuerung
Bild einer simulierten Fahrzeugkamera mit Empfangssteuerung.

Wählen Sie unter Sensoren das Fahrzeug und anschließend Kamera, LiDAR oder IMU. Die Ausstattung hängt vom Modell ab. Eine nach unten gerichtete Inspektionskamera zeigt den Boden.

Bedienelement Aktion
Stream starten/stoppen Steuert diesen Bildempfang; die Simulation läuft weiter.
Vergrößern / Bild speichern Vergrößert das Bild oder speichert das empfangene Einzelbild.
Sensorrate Fordert eine Übertragungsrate an; die gemessene Anzeige zeigt den tatsächlichen Empfang.
Digitalzoom / Zurücksetzen Vergrößert das empfangene Bild oder stellt den Maßstab zurück.
ROS-Topics → Suche → Topic Öffnet die Nachricht; Abonnieren und Abbestellen steuern ihren Empfang.
Feld / Diagramm / Rohdaten / Zeichnen Zeigt Zahlenfelder oder unterstützte räumliche Nachrichten entsprechend Typ und Koordinatenrahmen.

Die Szenenkamera ist ein äußerer Beobachter. Die Sensorkamera folgt ihrer Einbaupose am Fahrzeug. Beide können in unterschiedliche Richtungen sehen.

Streamzustände

Verbinden oder Warten bedeutet, dass Sensor oder Übertragung vorbereitet werden. Prüfen Sie die Empfangszeit. Ein beibehaltenes Bild mit Veraltet oder Neu verbinden ist keine aktuelle Messung. Prüfen Sie zuerst Weltbereitschaft und Sensorauswahl.

Die öffentliche Hongkong-Demo verwendet gemeinsames H.264-Video mit Startpuffer. Persönliche Kameras fordern JPEG-Bilder an; komprimierte ROS-Bilder haben einen getrennten Übertragungsweg. Speichern erfasst in der Demo einen Videoframe, im persönlichen Panel die empfangene Bilddatei. Sensorfrequenz, Video-FPS und Echtzeitfaktor sind verschiedene Messgrößen. Siehe Simulation, Rendering und Sensoren und Visualisierung mit RViz und Foxglove.

ArduPilot und manuelle Steuerung

ArduPilot-Panel des WAM-V mit Freigabezustand und bestätigtem Modus
ArduPilot-Panel des WAM-V mit Freigabezustand und bestätigtem Modus.
ArduPilot-Panel des BlueROV2 mit dessen Betriebsarten
ArduPilot-Panel des BlueROV2 mit dessen Betriebsarten.

Prüfen Sie Telemetrie, Freigabezustand und gemeldeten Modus in der Überschrift. Zentrieren Sie manuelle Eingaben und beenden oder brechen Sie die Mission vor einem Moduswechsel ab. Wählen Sie Flugmodus, wenden Sie ihn an und prüfen Sie die Rückmeldung: Das Auswahlfeld formuliert zunächst eine Anforderung.

Scharf gibt den Antrieb nach den Bereitschaftsprüfungen frei. Sichern sperrt ihn und beendet die Mission. Die Modusauswahl allein gibt das Fahrzeug nicht frei. Lesen Sie bei Ablehnung Fehler und Verbindungsdetails. Ein Kamerabild belegt keine Steuerungsbereitschaft.

Fahrzeug Menümodi
WAM-V · ArduRover MANUAL: direkte Gas-/Lenkeingaben. HOLD: neutraler Antrieb, weiterhin mögliche Bewegung durch Trägheit, Wellen und Strömung. STEERING: geregelte Geschwindigkeits- und Kurvenunterstützung.
BlueROV2 · ArduSub MANUAL: direkte Bedienung. STABILIZE: stabilisierte Lage, manuelle Tiefe. ALT_HOLD: zusätzliche Tiefenhaltung, keine horizontale Positionshaltung.

Geprüfte Missionen fordern beim Start GUIDED und die Antriebsfreigabe an. Die Mission verwaltet diesen Modus; er steht nicht im manuellen Menü. Siehe Autopilot-Missionen.

Manuelle Eingabe per Maus, Touch oder Gamepad
Manuelle Eingabe per Maus, Touch oder Gamepad.

Aktivieren Sie Joystick-Eingabe und wählen Sie Maus/Touch oder Gamepad. WAM-V bietet Gas und Lenkung; BlueROV2 zusätzlich seitliche und vertikale Bewegung. Beginnen Sie zentriert mit niedrigem Eingabefaktor. Eingabe stoppen beendet das aktuelle Drücken; zum Fortsetzen loslassen und neu drücken. Fokusverlust, Sperren des Antriebs, Quellenwechsel oder abgelehnte Befehle beenden den Druck ebenfalls.

Halten Sie am Gamepad LB/L1 während der Steuerung. Loslassen sendet Neutralwerte, sperrt aber nicht den Antrieb und stoppt Bewegung nicht sofort. Bei BlueROV2 fordert Y/Dreieck ALT_HOLD und A/Kreuz STABILIZE an. Prüfen Sie die Modusrückmeldung. Alle Belegungen stehen in Manuelle Steuerung und Gamepad.

Karte und Missionen

Neue Unterwasserwegpunkte beginnen bei 2 m. Der normale Bereich ist 0–10 m; bei unterstützten Inspektionsszenen gilt die vom Server angezeigte Tiefengrenzen für Missionen.

Bodenstationskarte mit Wegpunkten und Missionsbefehlen
Bodenstationskarte mit Wegpunkten und Missionsbefehlen.

Vervollständigen Sie Koordinaten und Tiefe vor der Routenprüfung. Oberflächenpunkte verwenden 0 m; Kartenwegpunkte warten jeweils eine Sekunde. Leere Eingabefelder bleiben beim Bearbeiten leer.

Aktion Wirkung
Klick / Rechtsklick Fügt einen Punkt hinzu / entfernt einen nahen Punkt. Ziehen, Mausrad oder Pinch verschieben und zoomen.
Zum Start zurückkehren / Löschen Legt Rückkehr fest / entfernt bearbeitbare Punkte.
Route prüfen Erstellt eine geländegeprüfte Vorschau. Prüfen Sie Verlauf, Abstand und Hindernisgründe.
Route starten Startet die geprüfte Route und gibt den Antrieb nach den Prüfungen frei.
Stoppen / Weiter / Abbrechen Hält an einem Warteziel / setzt fort / bricht ab und sperrt den Antrieb.

Prüfen Sie vor jedem weiteren Lauf erneut, da sich das Fahrzeug bewegt haben kann. Kartenwegpunkte haben Vorrang vor Szenariovorgaben; löschen Sie sie für ein vorgegebenes Szenario. Die Prüfung bewertet Gelände und Rumpfabstand, garantiert aber weder Ausweichen vor bewegten Schiffen noch COLREG-Konformität. Siehe Autopilot-Missionen.

Fahrzeuginstrumente

Lageinstrument, Diagramme, Simulationsgeschwindigkeit, Position und Verbindung
Lageinstrument, Diagramme, Simulationsgeschwindigkeit, Position und Verbindung.

Der feste blaue Marker stellt das Fahrzeug dar. Der bewegte Horizont zeigt Rollen und Nicken. Der Kurs verwendet 0° Nord, 90° Ost, 180° Süd, 270° West. Tiefe ist −Z relativ zum Meeresspiegelnullpunkt: darunter positiv, darüber negativ. Sie ist nicht der Abstand zum Boden.

Das Diagramm behält die letzten 100 empfangenen Posen. Wählbar sind Tiefe, Kurs, Nicken, Rollen, Geschwindigkeit und Schubanforderung. Tiefe, Lage und Geschwindigkeit stammen aus dem Simulator. Geschwindigkeit zeigt X vorwärts, Y links und Z aufwärts in m/s. Schub zeigt Befehle in Newton, keine gemessene Kraft. Fehlende oder veraltete Werte ergeben Lücken oder —. Tiefe und Lage teilen sich Messzeit und Datensatz; die Demo gleicht sie mit dem Video ab.

Geschwindigkeit und Physikschritt

Eine Auswahl wird sofort gesendet. Warten Sie auf die Bestätigung.

Einstellung Werte
Angeforderte Geschwindigkeit 0,25×, 0,5×, 1×, 2× und 4×
Physikschritt 5, 10 oder 20 ms; auch 30 ms, wenn die Welt bereits diesen Wert nutzt
Tatsächlich Simulationszeit geteilt durch Echtzeit; kann unter dem Sollwert liegen

Der Antrieb muss gesperrt, das Gelände bereit und Mission sowie manuelle/ROS-Eingaben inaktiv sein. Über 1× ist AIS nicht verfügbar. Windows und Linux beginnen bei 20 ms, der native Mac bei 10 ms. Übungen behalten ihre vorgeschriebenen 10 ms. Siehe Welten anpassen.

Position und Verbindungen

N/E/D bedeutet Nord, Ost, Unten in Metern ab lokalem Ursprung. Geografische Koordinaten sind Breite und Länge in Grad. R/P/Y · ENU zeigt Rohwinkel: Gieren 0° nach Osten, 90° nach Norden. Das Instrument zeigt Nicken −P und Kurs (90 − Y + 360) % 360.

Verbindungsdetails nennen Sequenz, Alter und ENU-Rahmen der Position. Steigende Sequenz und geringes Alter belegen neue Daten. Das Steuerungspanel hat eigene Diagnosen. RViz öffnet den passenden Betrachter: natives RViz2 in der App, Webbetrachter im Browser. Die Welt und in der App auch der RViz-Dienst müssen bereit sein. Siehe Visualisierung mit RViz und Foxglove. ArduPilot-Parameter werden im eigenen Panel gelesen, exportiert und geändert; erlaubte Änderungen werden bei gesperrtem Antrieb angewendet und zurückgelesen.

Direkte ROS-2-Steuerung

ROS-2-Panel mit Freigabe, Stopp und Diagnose
ROS-2-Panel mit Freigabe, Stopp und Diagnose.

Aktivieren Sie ROS für begrenzte Befehle des verbundenen Controllers. ROS stoppen hält die Ausgabe neutral bis zur erneuten Aktivierung. Die Diagnose zeigt Grund, angewendete Sequenz, Bestätigung und Schubwerte. Ein Watchdog setzt die Ausgabe bei ausbleibenden Befehlen auf neutral. Folgen Sie ROS-Terminals und Verbindung, Einen Web-Arbeitsbereich steuern oder Einen lokalen Arbeitsbereich steuern.

Ressourcen speichern und übertragen

Unter Arbeitsbereich → Eigene Welt → Speicher sehen Sie Gelände, Fahrzeugrevisionen, Weltkonfigurationen, Caches und freien Platz. Archivieren blendet Ressourcen aus, behält Dateien und gibt keinen Platz frei. Wiederherstellen macht sie erneut auswählbar. Warten Sie auf das Ende nutzender Sitzungen.

ZIP-Export/-Import überträgt Fahrzeuge mit Ressourcen. Eine bearbeitete Kopie erzeugt eine neue Revision. Vor dem Start können Sie Fahrzeug- und Welt-SDF herunterladen, ändern und als kompatible Revision hochladen. Siehe Ein Fahrzeug vorbereiten, Fahrzeuge anpassen und Welten anpassen.

Kleine Bildschirme und Wartezustände

Am Telefon öffnen die unteren Schaltflächen jeweils ein scrollbares Panel. × oder Escape führt zur Szene zurück. Querformat platziert das Panel neben den Steuerelementen. Die Desktopansicht der öffentlichen Demo skaliert das gesamte Layout; Hochformat fordert zum Drehen auf. Vollbild hängt von Browserunterstützung und einer Benutzeraktion ab.

Deaktivierte Schaltflächen bedeuten häufig fehlende Bereitschaft, ausstehendes Gelände, eine aktive Mission oder einen laufenden Befehl. Lesen Sie den Status vor einem neuen Versuch. Panels ausblenden, Spuren löschen, Bilder stoppen und Topics abbestellen stoppen das Fahrzeug nicht. Beenden Sie zum Schluss die Sitzung. Schließen der installierten App beendet lokale Dienste und Geländeerzeugung; gespeicherte Daten bleiben erhalten.

AIS-Zugangsdaten

Demos verwenden den AISStream-Schlüssel des Servers. Ohne diesen nutzen installierte Demos den öffentlichen AIS-Datenstrom von Open Waters. Das Panel zeigt Anbieter und Status; sichtbare Schiffe hängen von aktuellen Meldungen ab.

Tragen Sie für eine eigene Welt Ihren Schlüssel unter Szene → Schiffsverkehr ein und speichern Sie ihn lokal. Er wird in diesem Browser gespeichert und an den ausgewählten Simulationsserver übermittelt. Lokales Entfernen löscht ihn aus dem Browser. Aktivieren Sie den Verkehr zum Verbinden. Siehe Simulation, Rendering und Sensoren.

Mit QGC steuern

Wählen Sie bei einem Autopilot-Fahrzeug Open QGC im Bereich ArduPilot. Lassen Sie die installierte App und den angemeldeten Arbeitsbereich geöffnet. Der Dialog bereitet das Fahrzeug vor und übergibt die Steuerung an QGroundControl. Installation, Verbindung und Freigabe beschreibt Mit QGC steuern.

BlueROV2-Frontlichter

Mit Frontlichter in der Joystick-Steuerung schalten Sie beide BlueROV2-Lampen ON/OFF. Die Rückmeldung bestätigt den tatsächlichen Zustand; fehlgeschlagene oder nicht verfügbare Befehle gelten nicht als Erfolg. Fahrzeuglicht ist unabhängig von Tag/Nacht der Szene und Kameraauswahl.

Dokumentation durchsuchen