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

Welten anpassen

Das Welt-SDF legt die Simulationsumgebung fest. Verwenden Sie den Export des ausgewählten Geländes: Er enthält Ressourcenverweise, geografischen Ursprung und erforderliche Motorsysteme.

Eine Weltdatei herunterladen und anwenden

  1. Wählen Sie ein vorbereitetes festes Gelände und ein Fahrzeug und öffnen Sie die Startprüfung.
  2. Öffnen Sie SDF-Dateien bearbeiten → Welt-SDF herunterladen und sichern Sie eine Kopie von world.sdf.
  3. Ändern Sie unterstützte Physik- und Lichtwerte. Geländemodelle, Pfade, Weltname und geografischer Ursprung bleiben erhalten.
  4. Wählen Sie Bearbeitetes Welt-SDF hochladen. Die geprüfte Revision erscheint unter Weltkonfiguration und wird ausgewählt.
  5. Starten Sie die Welt. Die Einstellungen gelten nach der Gelände- und Fahrzeugvorbereitung. Prüfen Sie Physikzeitschritt, gemessene Geschwindigkeit und Beleuchtung.

Die Datei ist an ihre Geländerevision gebunden. Laden Sie für ein anderes Gelände dessen Datei herunter und übertragen Sie Ihre Einstellungen. Standardkonfiguration des Geländes stellt die Ausgangswerte wieder her. .world- und .sdf-Dateien dürfen höchstens 1 MB groß sein. Unterstützt sind feste Welten ohne Bewertung; bedarfsgeladenes Gelände und bewertete Aufgaben nutzen ihre vorgegebenen Einstellungen.

Unterstützte Einstellungen

SDF-Abschnitt Parameter und Einheiten
physics / max_step_size Integrationsintervall: 0.001–0.03 s. Kleinere Werte benötigen mehr Rechenleistung.
physics / real_time_factor Angefordertes Verhältnis von Simulations- zu Echtzeit: größer als 0, höchstens 10. Das Ergebnis hängt von CPU und GPU ab.
gravity Beschleunigungsvektor in m/s²; Standard 0 0 -9.81.
magnetic_field Magnetfeldvektor in Tesla.
scene Umgebungslicht, Hintergrundfarbe, Schatten, Raster und Ursprungsanzeige. Farben verwenden RGBA.
light Bis zu 32 benannte Richtungs-, Punkt- oder Spotlichter: Pose, Richtung, Farbe, Abschwächung und Spotwinkel in Radiant.
wind / linear_velocity SDF-Windgeschwindigkeit in m/s. Meereswellen und Strömung haben eigene Bedienung und physikalische Bedeutung.

Die SDFormat-Spezifikation beschreibt das gesamte Schema. Der Import erhält Gelände und erforderliche Systeme und übernimmt unterstützte Einstellungen. Er installiert keine Plugins, lädt keine externen Modelle und ersetzt kein geografisches Gelände. Wellen und Strömung stellen Sie im Szenenbereich ein; ihre Wirkung steht unter Meeresdynamik und Rendering.

Vorlage mit vorbereitetem Gelände

KMOU world.sdf herunterladen. Das vollständige Beispiel nutzt KMOU-Gelände und zeigt die unterstützten Abschnitte. Meshes und Bilder verbleiben im Geländepaket, das Sie im Arbeitsbereich herunterladen können.

kmou.world
<?xml version='1.0' encoding='utf-8'?>
<sdf version="1.4">
  <!--
    Weltkonfiguration für diese Geländerevision. Weltname, Gelände-Ressourcen,
    geografischer Ursprung und benötigte Systeme müssen erhalten bleiben. Unterstützte
    Umgebungseinstellungen in der Startübersicht hochladen.
  -->
  <world name="wwos_gebco">
    <!--
      Szenendarstellung: ambient und background sind RGBA-Farben. shadows, grid und
      origin_visual steuern die Anzeige. Welche exportierten Einstellungen einschließlich
      Himmel hochgeladen werden können, zeigt die Tabelle der Welteinstellungen.
    -->
    <scene>
      <ambient>0.01 0.01 0.01 1.0</ambient>
      <sky>
        <clouds>
          <speed>12</speed>
        </clouds>
      </sky>
      <shadows>1</shadows>
      <background>0.7 0.8 0.9 1</background>
      <grid>false</grid>
      <origin_visual>false</origin_visual>
    </scene>
    <!--
      Physik-Zeitsteuerung: max_step_size ist der Integrationsschritt in Sekunden;
      real_time_factor das gewünschte Verhältnis von Simulations- zu Echtzeit. name ist nur
      eine Bezeichnung. Die erreichte Geschwindigkeit hängt von CPU/GPU ab.
    -->
    <physics name="1ms" type="ignored">
      <max_step_size>.02</max_step_size>
      <real_time_factor>1.0</real_time_factor>
    </physics>
    <!--
      Engine-Plugin. filename verweist auf eine installierte Bibliothek, name auf deren
      Implementierung. Bei numerischen Änderungen beide beibehalten; eine SDF-Datei
      installiert keine Plugins.
    -->
    <!--
      Berechnet Starrkörperdynamik und Kontakte. Dieses benötigte Weltsystem aktiviert
      lassen.
    -->
    <plugin filename="gz-sim-physics-system" name="gz::sim::systems::Physics">
    </plugin>
    <!--
      Engine-Plugin. filename verweist auf eine installierte Bibliothek, name auf deren
      Implementierung. Bei numerischen Änderungen beide beibehalten; eine SDF-Datei
      installiert keine Plugins.
    -->
    <!--
      Stellt Gazebo-Transport-Befehle für die laufende Szene bereit. Für Szenenaktionen im
      Arbeitsbereich beibehalten.
    -->
    <plugin filename="gz-sim-user-commands-system" name="gz::sim::systems::UserCommands">
    </plugin>
    <!--
      Engine-Plugin. filename verweist auf eine installierte Bibliothek, name auf deren
      Implementierung. Bei numerischen Änderungen beide beibehalten; eine SDF-Datei
      installiert keine Plugins.
    -->
    <!--
      Publiziert Szenenstruktur und Posen für die Simulationsansichten.
    -->
    <plugin filename="gz-sim-scene-broadcaster-system" name="gz::sim::systems::SceneBroadcaster">
    </plugin>
    <!--
      Engine-Plugin. filename verweist auf eine installierte Bibliothek, name auf deren
      Implementierung. Bei numerischen Änderungen beide beibehalten; eine SDF-Datei
      installiert keine Plugins.
    -->
    <!--
      Erzeugt Kamera- und GPU-Strahlsensordaten. render_engine wählt das installierte
      Rendering-Backend; den exportierten Wert beibehalten.
    -->
    <plugin filename="gz-sim-sensors-system" name="gz::sim::systems::Sensors">
      <render_engine>ogre2</render_engine>
    </plugin>
    <!--
      Engine-Plugin. filename verweist auf eine installierte Bibliothek, name auf deren
      Implementierung. Bei numerischen Änderungen beide beibehalten; eine SDF-Datei
      installiert keine Plugins.
    -->
    <!--
      Weltsystem für benutzerdefinierte DVL-Sensoren. Strahl- und Tracking-Einstellungen
      stehen in der Fahrzeug-SDF.
    -->
    <plugin filename="gz-sim-dvl-system" name="gz::sim::systems::DopplerVelocityLogSystem">
    </plugin>
    <!--
      Geografischer Geländeursprung. Breite, Länge und Kurs in Grad, Höhe in Metern. ENU
      bedeutet Ost, Nord, oben. Werte für die gemeinsame Ausrichtung von Karte, Gelände und
      GNSS beibehalten.
    -->
    <spherical_coordinates>
      <surface_model>EARTH_WGS84</surface_model>
      <world_frame_orientation>ENU</world_frame_orientation>
      <latitude_deg>35.077175</latitude_deg>
      <longitude_deg>129.085815</longitude_deg>
      <elevation>0</elevation>
      <heading_deg>0</heading_deg>
    </spherical_coordinates>
    <!--
      Lichtquelle. type wählt Richtungs-, Punkt- oder Spotlicht; pose legt den Bezug fest,
      direction die Strahlrichtung. diffuse/specular sind RGBA-Farben, cast_shadows steuert
      den Schattenwurf.
    -->
    <light type="directional" name="sun1">
      <!--
        Pose: x y z in Metern, danach Roll-, Nick- und Gierwinkel in Radiant. Ohne relative_to
        gilt das übergeordnete Koordinatensystem.
      -->
      <pose>50 0 150 0 0 0</pose>
      <diffuse>1 1 1 1</diffuse>
      <specular>.1 .1 .1 1</specular>
      <direction>0.3 0.3 -1</direction>
      <cast_shadows>false</cast_shadows>
    </light>
    <!--
      Lichtquelle. type wählt Richtungs-, Punkt- oder Spotlicht; pose legt den Bezug fest,
      direction die Strahlrichtung. diffuse/specular sind RGBA-Farben, cast_shadows steuert
      den Schattenwurf.
    -->
    <light type="directional" name="sun_diffuse">
      <!--
        Pose: x y z in Metern, danach Roll-, Nick- und Gierwinkel in Radiant. Ohne relative_to
        gilt das übergeordnete Koordinatensystem.
      -->
      <pose>-50 0 -150 0 0 0</pose>
      <diffuse>0.6 0.6 0.6 1</diffuse>
      <specular>0 0 0 1</specular>
      <direction>-0.3 -0.3 -1</direction>
      <cast_shadows>false</cast_shadows>
    </light>
    <!--
      Lichtquelle. type wählt Richtungs-, Punkt- oder Spotlicht; pose legt den Bezug fest,
      direction die Strahlrichtung. diffuse/specular sind RGBA-Farben, cast_shadows steuert
      den Schattenwurf.
    -->
    <light type="directional" name="sun_diffuse_1">
      <!--
        Pose: x y z in Metern, danach Roll-, Nick- und Gierwinkel in Radiant. Ohne relative_to
        gilt das übergeordnete Koordinatensystem.
      -->
      <pose>-100 500 -20 0 0 0</pose>
      <diffuse>0.8 0.8 0.8 1</diffuse>
      <specular>1 1 1 1</specular>
      <direction>-1 -1 0</direction>
      <cast_shadows>false</cast_shadows>
    </light>
    <!--
      Lichtquelle. type wählt Richtungs-, Punkt- oder Spotlicht; pose legt den Bezug fest,
      direction die Strahlrichtung. diffuse/specular sind RGBA-Farben, cast_shadows steuert
      den Schattenwurf.
    -->
    <light type="directional" name="sun_diffuse_2">
      <!--
        Pose: x y z in Metern, danach Roll-, Nick- und Gierwinkel in Radiant. Ohne relative_to
        gilt das übergeordnete Koordinatensystem.
      -->
      <pose>-150 -130 50 0 0 0</pose>
      <diffuse>0.6 0.6 0.6 1</diffuse>
      <specular>0.2 0.2 0.2 1</specular>
      <direction>0.5 0.5 -1</direction>
      <cast_shadows>false</cast_shadows>
    </light>
    <!--
      Engine-Plugin. filename verweist auf eine installierte Bibliothek, name auf deren
      Implementierung. Bei numerischen Änderungen beide beibehalten; eine SDF-Datei
      installiert keine Plugins.
    -->
    <plugin filename="gz-sim-buoyancy-system" name="gz::sim::systems::Buoyancy">
      <!--
        Geschichtete Fluiddichte für Auftrieb in kg/m^3. default_density gilt unterhalb des
        Übergangs; above_depth gibt dessen Höhe an. Hier liegt die Grenze bei z=0.
      -->
      <graded_buoyancy>
        <default_density>1025</default_density>
        <density_change>
          <above_depth>0</above_depth>
          <density>1</density>
        </density_change>
      </graded_buoyancy>
    </plugin>
    <!--
      Modellaufbau: Links beschreiben starre Körper, Gelenke verbinden sie und Plugins
      ergänzen das Simulationsverhalten. Modell-, Link- und Gelenknamen müssen zu den
      exportierten Reglern passen.
    -->
    <model name="gebco_terrain">
      <!--
        Statische Modelle bewegen sich weder durch Schwerkraft noch durch Kontaktkräfte. Das
        Gelände ist statisch, Fahrzeug-Links sind dynamisch.
      -->
      <static>true</static>
      <!--
        Starrer Körper mit lokalem Koordinatensystem. Geometrie, Masseneigenschaften und
        Sensoren dieses Links bewegen sich gemeinsam.
      -->
      <link name="terrain">
        <!--
          Kontaktgeometrie für die Physiksimulation. Abmessungen und Lage müssen zum Rumpf
          passen; einfache Formen verringern den Rechenaufwand.
        -->
        <collision name="gebco_collision">
          <geometry>
            <!--
              Mesh-Ressource mit optionaler Skalierung je Achse. Exportierten Pfad und Ressourcen
              zusammen aufbewahren; scale multipliziert die Mesh-Koordinaten.
            -->
            <mesh>
              <uri>terrain.dae</uri>
            </mesh>
          </geometry>
        </collision>
        <!--
          Sichtbare Oberfläche für Darstellung und Kameras. Änderungen passen weder die
          Kollisionsform noch die Masse automatisch an.
        -->
        <visual name="seabed">
          <geometry>
            <!--
              Mesh-Ressource mit optionaler Skalierung je Achse. Exportierten Pfad und Ressourcen
              zusammen aufbewahren; scale multipliziert die Mesh-Koordinaten.
            -->
            <mesh>
              <uri>terrain-visual.dae</uri>
            </mesh>
          </geometry>
          <!--
            Oberflächendarstellung. RGBA-Farben und PBR-Texturen beeinflussen das Rendering.
            Geländetexturen mit den exportierten Ressourcen behalten; Materialeinstellungen ändern
            Masse und Reibung nicht automatisch.
          -->
          <material>
            <ambient>0.6 0.6 0.6 1</ambient>
            <diffuse>1 1 1 1</diffuse>
            <specular>0.03 0.03 0.03 1</specular>
            <pbr>
              <metal>
                <albedo_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-diff-1803d7e2861b304b.jpg</albedo_map>
                <roughness>1</roughness>
                <normal_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-nor_gl-0f35185b7225fe20.jpg</normal_map>
                <roughness_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-rough-318b440c109de741.jpg</roughness_map>
                <metalness>0</metalness>
              </metal>
            </pbr>
          </material>
        </visual>
        <!--
          Sichtbare Oberfläche für Darstellung und Kameras. Änderungen passen weder die
          Kollisionsform noch die Masse automatisch an.
        -->
        <visual name="land">
          <geometry>
            <!--
              Mesh-Ressource mit optionaler Skalierung je Achse. Exportierten Pfad und Ressourcen
              zusammen aufbewahren; scale multipliziert die Mesh-Koordinaten.
            -->
            <mesh>
              <uri>terrain-visual-land.dae</uri>
            </mesh>
          </geometry>
          <!--
            Oberflächendarstellung. RGBA-Farben und PBR-Texturen beeinflussen das Rendering.
            Geländetexturen mit den exportierten Ressourcen behalten; Materialeinstellungen ändern
            Masse und Reibung nicht automatisch.
          -->
          <material>
            <ambient>0.6 0.6 0.6 1</ambient>
            <diffuse>1 1 1 1</diffuse>
            <specular>0.03 0.03 0.03 1</specular>
            <pbr>
              <metal>
                <albedo_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/land-satellite-eb6fd1423859d847a276a4db49db6db51a61fe8965171639c94f8d3df66e0199.png</albedo_map>
                <roughness>1</roughness>
                <metalness>0</metalness>
              </metal>
            </pbr>
          </material>
        </visual>
      </link>
    </model>
    <!--
      Engine-Plugin. filename verweist auf eine installierte Bibliothek, name auf deren
      Implementierung. Bei numerischen Änderungen beide beibehalten; eine SDF-Datei
      installiert keine Plugins.
    -->
    <plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu" />
    <!--
      Engine-Plugin. filename verweist auf eine installierte Bibliothek, name auf deren
      Implementierung. Bei numerischen Änderungen beide beibehalten; eine SDF-Datei
      installiert keine Plugins.
    -->
    <plugin filename="gz-sim-magnetometer-system" name="gz::sim::systems::Magnetometer" />
    <!--
      Gravitationsvektor x y z der Welt in m/s^2. Negatives z zeigt in dieser ENU-Welt nach
      unten.
    -->
    <gravity>0 0 -9.81</gravity>
    <!--
      Magnetfeldvektor x y z der Welt in Tesla für die Magnetometersimulation.
    -->
    <magnetic_field>5.64e-6 2.29e-5 -4.2e-5</magnetic_field>
    <!--
      Standard-SDF-Windgeschwindigkeit in m/s. Ein Kraftmodell muss diesen Wert verwenden,
      damit er Bewegung beeinflusst. Wellen und Strömungen über die jeweiligen Szenenregler
      einstellen.
    -->
    <wind>
      <linear_velocity>0 0 0</linear_velocity>
    </wind>
  </world>
</sdf>

Das Beispiel stammt aus dem Linux-Motor. Verwenden Sie für Ihren Rechner, insbesondere macOS, dessen eigenen Export, damit die Plugin-Bibliotheken zur Installation passen.

Selbst erzeugtes Gelände verwenden

Erzeugen und wählen Sie Ihr Gelände und laden Sie sein SDF bei der Startprüfung herunter. Damit erhalten Sie korrekte Ressourcenpfade und den geografischen Ursprung. Übertragen Sie Ihre Physik- oder Lichtänderungen auf diese Datei.

Für eine übertragbare Kopie laden Sie das Gelände-ZIP herunter und speichern die Welt bei ihren relativ referenzierten Ressourcen. Der SDF-Upload überträgt Einstellungen auf das passende gespeicherte Gelände; er importiert kein Gelände-ZIP. Erzeugen oder stellen Sie das Gelände zuerst über dessen Vorbereitung wieder her.

Vor einem längeren Lauf vergleichen

Halten Sie Fahrzeug, Startposition und Sensoren zwischen Tests gleich. Prüfen Sie Zeitschritt, Echtzeitverhältnis, Lichtrichtung, Kameras und Bewegung. Ein höherer Sollfaktor garantiert weder schnelleres Rendering noch schnelleren Sensorempfang. Bewahren Sie das Original zur Rückkehr auf Standardwerte oder zum erneuten Hochladen auf.

Leistung und Darstellung

Der Echtzeitfaktor (RTF) misst simulierte Sekunden je realer Sekunde. Die angeforderte Rate ist ein Ziel; unter 1 läuft die Simulation langsamer als Echtzeit. Der Zeitschritt beeinflusst Kontakte, Wellen, Sensoren und Regelstabilität; Netzwerklatenz betrifft Befehle und Anzeige. Oberhalb von 1× wird Live-AIS ausgeblendet. Die Kamerarate begrenzt Bildaktualisierungen.

Testen Sie nach Änderungen Stillstand, Kurven, Freiraum, Tauchen und Rückkehr mit beiden mitgelieferten Fahrzeugen.

Ansicht Renderer
Sensorbilder Gazebo auf dem Motorrechner
Persönliche Fahrzeug-/Weltansicht mit Browser Browser-GPU
Persönliche Fahrzeug-/Weltansicht mit Gazebo Gazebo auf dem Motorrechner; Vorgabe der installierten Anwendung
Öffentliche LIVE-Fahrzeug-/Weltansicht Gazebo-Beobachtungskameras

Reduzieren Sie zuerst unnötige Kameras, ihre Raten und Auflösungen. Browser-Beleuchtung steuert Himmel, Reflexionen, Tonwertabbildung und Wassernormalen; Wellengeometrie verwendet Messpunkte des physikalischen Modells.

Vergleichen Sie Grafikdiagnosen in derselben Szene: FPS, p95-Bildzeit, Zeichenaufrufe, Dreiecke, Texturen und Geometrie. Bewegtes Gelände vereinfacht entfernte Sichtgeometrie; siehe Algorithmen zur Geländeerzeugung. Kollisionen und Sensoren haben eigene Kosten. Auch die Browser-Szene benötigt Gazebo für Kameras und GPU-LiDAR. Vergleichen Sie Video-FPS, Sensor-Hz und RTF getrennt.

Für Hardwarevergleiche verwenden Sie dieselbe Welt, dasselbe Fahrzeug, Sensorfrequenzen und Solltempo. Beginnen Sie mit einer Sitzung, erhöhen Sie die Zahl und berücksichtigen Sie Lastspitzen der Geländeaufbereitung. Messen Sie Median und 5. Perzentil des RTF, Physikschrittzeit, Kameraempfang und Datenalter, CPU, Speicher, GPU und VRAM. Physik hängt von der Leistung einzelner Kerne ab; Gelände und Sensoren nutzen auch mehrere Kerne. Mehr Kameras und höhere Auflösung erhöhen die GPU-Last. LIVE-Zuschauer teilen sich eine Welt.

Apple Silicon verwendet Metal. Ubuntu- und Windows/WSL-Docker-Motoren benötigen zu ihren Images passende Treiber und Laufzeitumgebungen. LIVE verbraucht kein persönliches Kontingent; Modelle, Uploads und Caches unterliegen Speichergrenzen. Reservieren Sie Platz für Motor und Modelle. Siehe Konten und Sitzungsdauer.

Dokumentation durchsuchen