POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Weiterführende Anleitungen

Gelände aus Höhenkarten

Eine Höhenkarte beschreibt Gelände als regelmäßiges Raster von Höhenwerten. Stimmen Sie visuelle und Kollisionsgeometrie aufeinander ab, damit der sichtbare Meeresboden mit der Kontaktfläche übereinstimmt.

Arbeitsumgebung

Nutzen Sie die vorbereiteten Linux-Terminals unter nativem Ubuntu, WSL oder Docker. Auf macOS arbeiten Sie im RDP-Desktop. Bearbeiten und bauen Sie dort; POSIM_WS bezeichnet diesen Arbeitsbereich.

Beispiele ansehen

Santorini zeigt eine geografische Szene mit dem Fuel-Modell Santorini Scaled. Der abgestufte Meeresboden ist ein weiteres Beispiel für die Weltzusammenstellung.

Für die Höhenkartengeometrie selbst verwenden Sie die Gazebo-Anleitung und die SDFormat-Referenz.

Ressourcen im Paket speichern

Legen Sie die Welt unter models/posim_worlds/worlds und Daten unter models/posim_worlds/media ab. Prüfen Sie CMake-Installationsregeln und Ressourcenpfade des Pakets. Verwenden Sie portable URIs installierter Ressourcen.

Innerhalb einer visuellen oder Kollisionsgeometrie sieht die Grundstruktur so aus:

<geometry>
  <heightmap>
    <uri>model://media/meshes/my_heightmap.png</uri>
    <size>1000 1000 80</size>
    <pos>0 0 -80</pos>
  </heightmap>
</geometry>

Ersetzen Sie die URI durch Ihre eigene Ressource. Rasterformat und Abtastung müssen zum Renderer und Physik-Backend passen. Prüfen Sie die Höhenkodierung, bevor Sie vertikale Größe und Versatz festlegen.

Maßstab und Koordinaten erhalten

size beschreibt horizontale Ausdehnung und Höhenskalierung in Metern; pos fügt einen Versatz hinzu. Ein normiertes Bild ist nicht automatisch georeferenziert. Notieren Sie Quellausdehnung, Höhenbereich, Meeresspiegelbezug sowie Umprojektion oder Neuabtastung.

Bei geografischen Positionen setzen Sie <spherical_coordinates> in der Welt. Die Koordinatenreferenz erläutert die Umrechnung zwischen Breiten-/Längengraden und lokalen Koordinaten.

Bauen und prüfen

Bauen und laden Sie den Arbeitsbereich nach neuen Ressourcen erneut. Starten Sie außerhalb des Repositorys und prüfen Sie:

Unter Jetty kann ein von null verschiedenes <heightmap><pos> die Darstellung verschieben, ohne die Kollision gleich zu versetzen. Auch nach einer Verschiebung über die Modellpose können Abweichungen bestehen bleiben. Prüfen Sie beides mit Ihrem Renderer und Physik-Backend. Bleiben Unterschiede, wählen Sie vor Navigationsversuchen eine Geometrie oder ein Backend, das Kontakt- und Darstellungsprüfung besteht.