POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Erste Schritte

Docker-Umgebung

Die POSIM-Images enthalten Ubuntu, ROS 2 Lyrical, Gazebo Jetty, POSIM, ArduSub, ArduRover, MAVROS und QGroundControl. Wählen Sie zunächst die Anleitung für Ihre Umgebung, um Anzeige und Grafiktreiber einzurichten.

Ein veröffentlichtes Image herunterladen

Die Images liegen auf Docker Hub. Docker wählt automatisch die passende Variante für AMD64 oder ARM64.

docker pull ioeslab/posim:latest
export POSIM_IMAGE=ioeslab/posim:latest
Tag Verwendung
latest Veröffentlichter Build des Hauptzweigs für beide Architekturen
sha-<12-character-commit> Bestimmter Quellstand; übernehmen Sie einen vorhandenen Tag von Docker Hub
SHA-Tag mit -amd64 oder -arm64 Ausdrückliche Auswahl einer Architektur
Veröffentlichte Versionsnummer Ein mit einem Release-Tag gekennzeichneter Stand

Das Image-Label enthält die vollständige Quellrevision. Halten Sie zusätzlich den Digest fest, wenn ein Versuch genau dasselbe Image verwenden soll.

docker image inspect "$POSIM_IMAGE" \
  --format '{{index .Config.Labels "org.opencontainers.image.revision"}}'
docker image inspect "$POSIM_IMAGE" --format '{{json .RepoDigests}}'

Verwenden Sie die Dokumentation zum gewählten Stand. Ein neu heruntergeladenes Image verändert vorhandene Container nicht.

Ein Image aus dem Quellcode bauen

Führen Sie diese Befehle auf dem Host aus:

git clone https://github.com/IOES-Lab/POSIM.git
cd POSIM
git rev-parse HEAD

Für AMD64:

docker build --platform linux/amd64 \
  -f .docker/lyrical.amd64.dockerfile -t posim:dev-amd64 .

Für ARM64:

docker build --platform linux/arm64 \
  -f .docker/lyrical.arm64v8.dockerfile -t posim:dev-arm64-rdp .

Ersetzen Sie in der Installationsanleitung ioeslab/posim:latest durch den lokalen Tag. Beide Images bauen den vorhandenen Quellcode und die festgelegte Version der Wellenbibliothek. ARM64 enthält außerdem einen XFCE-Desktop und einen RDP-Server.

Die Umgebung öffnen

Alle drei Anleitungen erstellen einen Container namens posim. Unter Terminals vorbereiten erfahren Sie, wo Sie Befehle eingeben und den Arbeitsbereich laden.

Eigene Dateien aufbewahren

Der Arbeitsbereich liegt bei AMD64 unter /opt/posim_ws und bei ARM64 unter /home/docker/posim_ws. Die Variablen POSIM_WS oder POSIM_UNDERLAY geben diesen Pfad an.

Speichern Sie eigene SDF-Dateien und Aufzeichnungen in /work. Dieses Verzeichnis gehört zum Volume posim-data. Andere Dateien bleiben nach einem Stopp erhalten, werden aber zusammen mit dem Container gelöscht. Sichern Sie Quellcodeänderungen in Git oder kopieren Sie sie vor dem Austausch nach außen. Das Volume bleibt bestehen, bis es ausdrücklich entfernt wird.

Stoppen, fortsetzen und aktualisieren

Beenden Sie zuerst die Simulation mit Strg+C. Führen Sie anschließend auf dem Host aus:

docker stop posim
docker start posim

Für ein Update sichern Sie Ihre Arbeit, stoppen den Container, laden das gewünschte Image herunter und entfernen den gestoppten Container. Erstellen Sie ihn mit dem Befehl aus Ihrer Installationsanleitung erneut und verwenden Sie dabei wieder posim-data.

Grafik und GPU

Unter Linux benötigen Sie den Host-Treiber und das NVIDIA Container Toolkit. Unter Windows gilt die GPU-Konfiguration für Docker Desktop mit WSL2. CUDA-Sonar benötigt außerdem Bibliotheken im Image; siehe Sonar konfigurieren. Die ersten Schritte verwenden Software-Rendering, das langsamer sein kann.