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

Einen Roboter hinzufügen

Verwenden Sie einen ähnlich aufgebauten POSIM-Roboter als Ausgangspunkt. SDF beschreibt Mechanik und Systeme; die ROS-Konfiguration verbindet Messungen und Befehle.

Arbeitsumgebung

Nutzen Sie die vorbereiteten Linux-Terminals unter nativem Ubuntu, WSL oder Docker. Auf macOS arbeiten Sie im Terminal des RDP-Desktops. Bearbeiten und bauen Sie dort; POSIM_WS ist der Pfad dieses Arbeitsbereichs.

1. Referenzmodell kopieren

REXROV verwendet Gazebo-Thruster. BlueROV2 bindet ArduSub/MAVROS ein. Slocum zeigt einen weiteren Fahrzeugaufbau.

Kopieren Sie REXROV ausgehend von $POSIM_WS vollständig, damit Meshes, Bridge-Konfiguration und Topic-Namen zusammenbleiben:

cd "$POSIM_WS"

Speichern Sie das folgende Programm als copy_robot.py und führen Sie python3 copy_robot.py aus. Existiert my_robot bereits, bricht es ab.

from pathlib import Path
import shutil

root = Path('src/posim/models/posim_robot_models')
directories = ('description', 'config', 'meshes')
if any((root / directory / 'my_robot').exists() for directory in directories):
    raise SystemExit('my_robot already exists; choose another model name.')
for directory in directories:
    shutil.copytree(root / directory / 'rexrov', root / directory / 'my_robot')
for relative in ('description/my_robot/model.sdf',
                 'description/my_robot/model.config',
                 'config/my_robot/robot_config.py'):
    target = root / relative
    target.write_text(target.read_text().replace('rexrov', 'my_robot'))

Die erzeugte Struktur enthält:

models/posim_robot_models/
  description/my_robot/model.sdf
  description/my_robot/model.config
  meshes/my_robot/RexROV_no_props.dae
  config/my_robot/robot_config.py

my_robot ist die gewählte Kennung. Der Start sucht description/<namespace>/model.sdf und die passende Konfiguration.

2. Mechanik und Ressourcen festlegen

Behalten Sie die kopierte Mechanik beim ersten Start bei. Prüfen Sie bei Rumpfänderungen gemeinsam:

SDF-Pfad Einheit Prüfung
model/@name, Link- und Gelenknamen Kennung Übereinstimmung mit Plugins und ROS-Konfiguration
link/inertial/mass kg Positive Masse jedes beweglichen Links
link/inertial/pose m, rad Schwerpunkt und Orientierung des Trägheitsrahmens
link/inertial/inertia/ixx, iyy, izz kg·m² Momente um dessen Achsen
link/inertial/inertia/ixy, ixz, iyz kg·m² Nebendiagonalelemente; physikalisch gültiger Gesamttensor
link/visual, link/collision m, rad Maßstab und Ausrichtung beider Geometrien
joint/axis, Thruster-Einstellungen pluginspezifisch Antriebsrichtung und Kraftverteilung

STL liefert Geometrie. Masse und Dynamik gehören in die SDF; prüfen Sie Mesh-Einheiten und Maßstab. Folgen Sie den installierten Ressourcen-URIs der Beispiele. Vereinfachen Sie die Kollisionsform, wenn visuelle Details die Kontaktberechnung unnötig aufwendig machen.

3. Systeme und ROS verbinden

Passen Sie Hydrodynamik, Auftrieb, Schubachsen und Sensorposen an das Fahrzeug an. Die Koeffizienten müssen zu seinen physikalischen Eigenschaften passen.

Verwenden Sie Strömungen, Sensoren hinzufügen und die dort verlinkten Plugin-Referenzen. Für Breiten- und Längengrade legen Sie den Ursprung über sphärische Koordinaten fest.

Passen Sie config/<namespace>/robot_config.py an: Ändern Sie Entitäts- und Gelenknamen, Topics, Koordinatenrahmen und Ports gemeinsam. Das Paket installiert bereits description, meshes, config und die Ressourcenpfade. Bearbeiten Sie Quellen, keine erzeugten Dateien unter install/.

4. Bauen und ausprobieren

Im Arbeitsbereich mit geladener Umgebung:

colcon build --merge-install --executor sequential --symlink-install
source install/setup.bash
ros2 launch posim_demos posim_robot.launch.py --show-args
ros2 launch posim_demos posim_robot.launch.py \
  namespace:=my_robot world_name:=posim_ocean_waves z:=-2 paused:=false \
  gui:=true headless:=false use_teleop:=false use_web_joystick:=false

Prüfen Sie jede Achse mit kleinen Befehlen und starten Sie auch einmal außerhalb des Quellverzeichnisses:

Fragen Sie das umbenannte Modell in einem weiteren vorbereiteten Terminal ab:

ros2 topic echo --no-daemon /model/my_robot/odometry nav_msgs/msg/Odometry --once

Sie sollten Position und Geschwindigkeit empfangen. Bringen Sie zuerst die Kopie zum Laufen, ändern Sie danach die Mechanik und anschließend Sensoren oder Antrieb. Vergleichen Sie Versuche über Sensordaten; fehlende Ressourcen behandelt die Fehlerbehebung.