POSIM v1.0.1Platform for Ocean Simulation · Documentation
Menu de la documentation
POSIM / Guides avancés

Ajouter un robot

Partez d'un robot POSIM de disposition similaire. Le SDF décrit la mécanique et les systèmes ; la configuration ROS relie mesures et commandes.

Environnement de travail

Utilisez les terminaux Linux préparés sous Ubuntu natif, WSL ou Docker. Sur macOS, travaillez dans le terminal du bureau RDP. Modifiez et compilez dans cet environnement ; POSIM_WS est le chemin de son espace de travail.

1. Copier un modèle de référence

REXROV utilise des propulseurs Gazebo. BlueROV2 intègre ArduSub/MAVROS. Slocum présente une autre disposition.

Depuis $POSIM_WS, copiez entièrement REXROV pour conserver maillages, configuration du pont et noms des topics :

cd "$POSIM_WS"

Enregistrez le programme suivant dans copy_robot.py, puis exécutez python3 copy_robot.py. Il s'arrête si my_robot existe déjà.

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'))

La structure obtenue comprend :

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 est l'identifiant choisi. Le lancement recherche description/<namespace>/model.sdf et la configuration correspondante.

2. Définir mécanique et ressources

Conservez la mécanique copiée pour le premier lancement. Lors d'une modification de coque, vérifiez ensemble :

Chemin SDF Unité Vérification
model/@name, noms des liens et articulations identifiant Concordance avec plugins et configuration ROS
link/inertial/mass kg Masse positive de chaque corps mobile
link/inertial/pose m, rad Centre de masse et orientation du repère d'inertie
link/inertial/inertia/ixx, iyy, izz kg·m² Moments autour des axes de ce repère
link/inertial/inertia/ixy, ixz, iyz kg·m² Termes croisés ; tenseur complet physiquement valide
link/visual, link/collision m, rad Échelle et alignement des géométries
joint/axis, paramètres des propulseurs selon le plugin Sens d'actionnement et répartition des forces

STL fournit la géométrie. Définissez masse et dynamique dans le SDF ; vérifiez unités et échelle du maillage. Reprenez les URI installées des exemples. Préférez une collision simple si le détail visuel rend le calcul du contact inutilement coûteux.

3. Relier systèmes et ROS

Adaptez hydrodynamique, flottabilité, axes de propulsion et poses des capteurs au véhicule. Les coefficients doivent correspondre à ses propriétés physiques.

Consultez Courants, Ajouter des capteurs et les références de plugins associées. Pour latitude et longitude, définissez l'origine avec les coordonnées sphériques.

Adaptez config/<namespace>/robot_config.py en mettant à jour ensemble noms d'entités et d'articulations, topics, repères et ports. Le paquet installe déjà description, meshes, config et les réglages de recherche des ressources. Modifiez les sources, pas les fichiers générés dans install/.

4. Compiler et essayer

Depuis l'espace de travail dont l'environnement est chargé :

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

Essayez chaque axe avec de petites commandes. Vérifiez aussi un lancement hors du répertoire source :

Dans un autre terminal préparé, lisez le modèle renommé :

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

Vous devez recevoir position et vitesse. Faites fonctionner la copie, puis modifiez la mécanique, enfin les capteurs ou la propulsion. Comparez les essais avec Données des capteurs et consultez le dépannage pour les ressources manquantes.