POSIM v1.0.1Platform for Ocean Simulation · Documentation
Menu de la documentation
POSIM / Référence des plugins

Courants marins

POSIM génère les courants du monde, calcule l'écoulement au niveau de chaque robot et expose des réglages ROS. Le courant uniforme et le profil qui varie avec la profondeur utilisent des topics et des paramètres distincts.

Lancer l'exemple

Préparez les terminaux A et B dans votre environnement POSIM : Ubuntu natif, WSL, Docker ou le bureau distant de macOS. Lancez l'exemple dans A :

ros2 launch posim_demos posim_robot.launch.py \
  namespace:=rexrov world_name:=ocean_current_plugin z:=-5 paused:=false \
  gui:=true headless:=false use_teleop:=false use_web_joystick:=false

Dans B, consultez Gazebo, puis ROS. Arrêtez le premier affichage avec Ctrl+C avant d'exécuter la seconde commande :

gz topic -e -t /ocean_current
ros2 topic echo /hydrodynamics/currentVelocityTopic --once

Configurer le courant du monde

Placez les deux plugins directement dans <world>, celui du courant avant celui de ROS. Le monde d'exemple fournit la configuration complète.

<plugin filename="OceanCurrentWorldPlugin"
        name="posim_gz_world_plugins::OceanCurrentWorldPlugin">
  <namespace>hydrodynamics</namespace>
  <constant_current>
    <use_constant_current>true</use_constant_current>
    <topic>ocean_current</topic>
    <velocity><mean>0.3</mean><min>0</min><max>0.6</max><mu>0</mu><noiseAmp>0</noiseAmp></velocity>
    <horizontal_angle><mean>0</mean><min>-3.14</min><max>3.14</max><mu>0</mu><noiseAmp>0</noiseAmp></horizontal_angle>
    <vertical_angle><mean>0</mean><min>-1.57</min><max>1.57</max><mu>0</mu><noiseAmp>0</noiseAmp></vertical_angle>
  </constant_current>
  <transient_current>
    <topic_stratified>stratified_current_velocity</topic_stratified>
    <databasefileName>transientOceanCurrentDatabase.csv</databasefileName>
  </transient_current>
</plugin>
<plugin filename="OceanCurrentPlugin" name="posim_ros_gz_plugins::OceanCurrentPlugin">
  <namespace>hydrodynamics</namespace>
</plugin>

Utilisez le même namespace, non vide, dans les deux plugins. Les blocs constant_current et transient_current sont obligatoires ; une configuration manquante désactive la publication et produit une erreur. Des modèles de Gauss–Markov distincts décrivent la vitesse et les angles horizontal et vertical du courant uniforme.

Paramètre Rôle et valeur par défaut
namespace des deux plugins Espace de noms commun ; hydrodynamics dans l'exemple
constant_current/use_constant_current Publier le courant uniforme ; false
constant_current/topic Topic Gazebo du courant uniforme ; ocean_current
transient_current/topic_stratified Topic Gazebo des couches dans cet espace de noms ; stratified_current_velocity
transient_current/databasefileName CSV installé dans posim_worlds/worlds ; transientOceanCurrentDatabase.csv
transient_current/databasefilePath Chemin CSV facultatif, prioritaire sur le nom de fichier
mean de chaque modèle stochastique Moyenne initiale de vitesse (m/s) ou d'angle (rad) ; 0
min, max Bornes ; −1 et 1. Garder min < max et la moyenne dans l'intervalle
noiseAmp Amplitude de l'incrément aléatoire ; 0
mu Coefficient de décroissance de Gauss–Markov ; 0
tidal_oscillation Bloc facultatif des données de marée

Préparer un profil selon la profondeur

Le CSV d'exemple contient, dans cet ordre, la vitesse selon l'axe X du monde (m/s), la vitesse selon l'axe Y du monde (m/s) et la profondeur (m). Les noms historiques velocity_north, velocity_east et velocity_down correspondent directement aux axes X, Y et Z du monde.

Le plugin ROS du monde transmet toute la base de données. Le plugin du modèle interpole le courant à la profondeur du véhicule. L'hydrodynamique tient compte de l'écoulement relatif à la vitesse du robot.

Appliquer le profil au robot

L'exemple REXROV utilise d'abord le courant uniforme /ocean_current. Pour utiliser le profil, activez une seule fois le bloc commenté du modèle REXROV, directement dans <model> :

<plugin filename="OceanCurrentModelPlugin"
        name="posim_gz_model_plugins::OceanCurrentModelPlugin">
  <namespace>rexrov</namespace>
  <flow_velocity_topic>ocean_current</flow_velocity_topic>
  <transient_current>
    <topic_stratified>/hydrodynamics/stratified_current_velocity_topic_database</topic_stratified>
    <velocity_north><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_north>
    <velocity_east><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_east>
    <velocity_down><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_down>
  </transient_current>
  <tide_oscillation>false</tide_oscillation>
</plugin>

Ajoutez aussi <namespace>rexrov</namespace> dans le plugin existant gz-sim-hydrodynamics-system, en conservant son lien, sa masse volumique et ses coefficients de traînée. Recompilez l'espace de travail, puis chargez son environnement.

Paramètre du modèle Rôle et valeur par défaut
namespace Obligatoire ; doit correspondre à celui de l'hydrodynamique, ici rexrov
flow_velocity_topic Suffixe sous /model/<namespace>/ ; ocean_current
transient_current/topic_stratified Entrée ROS de la base de données ; hydrodynamics/stratified_current_velocity_topic_database
velocity_north, velocity_east, velocity_down Réglages stochastiques facultatifs par composante ; sans réglage, aucun bruit ajouté
mean de chaque composante Vitesse initiale, m/s ; 0. Remplacée par le profil interpolé à réception des données
mu Décroissance entre 0 et 1, appliquée selon les secondes de simulation écoulées ; 0
noiseAmp Écart autorisé autour de la vitesse interpolée, m/s ; 0
noiseFreq Amplitude de l'incrément aléatoire par mise à jour ; 0. Ce n'est pas une fréquence en Hz
tide_oscillation Appliquer les données de marée au modèle ; false

La sortie /model/rexrov/ocean_current existe dans Gazebo (gz.msgs.Vector3d) et ROS (geometry_msgs/msg/TwistStamped). Contrôlez cette sortie et la réponse du véhicule.

La profondeur vient de la position du modèle dans le monde ; elle vaut zéro au-dessus de l'eau. Le courant est interpolé entre les couches et prend la valeur de la couche la plus proche hors du profil. La pause ou un horodatage de simulation répété ne fait pas avancer le calcul. Un message de base de données invalide est rejeté entièrement ; le dernier profil valide reste actif.

Systèmes et topics

Système Rôle
posim_gz_world_plugins::OceanCurrentWorldPlugin Générer le courant du monde et les données par profondeur
Plugin de courant du modèle Interpoler le courant à la position du robot
posim_ros_gz_plugins::OceanCurrentPlugin Publier les données ROS et fournir les services de réglage
Topic de l'exemple Transport et type
/ocean_current Gazebo, gz.msgs.Vector3d
/hydrodynamics/stratified_current_velocity Gazebo, données par couche
/hydrodynamics/stratifiedCurrentVelocityTopic ROS, posim_interfaces/msg/StratifiedCurrentVelocity
/hydrodynamics/currentVelocityTopic ROS, geometry_msgs/msg/TwistStamped
/hydrodynamics/stratified_current_velocity_topic_database ROS, posim_interfaces/msg/StratifiedCurrentDatabase

Vérifiez les noms dans le SDF et reliez l'hydrodynamique à la source de courant voulue.

Régler le courant avec ROS

Dans B, listez les services et demandez un courant horizontal de 0.3 m/s :

ros2 service list -t
ros2 service call /hydrodynamics/set_current_velocity posim_interfaces/srv/SetCurrentVelocity \
  '{velocity: 0.3, horizontal_angle: 0.0, vertical_angle: 0.0}'

La vitesse est en m/s et les angles en radians. Vérifiez success et les données publiées. Pour examiner l'interface d'une couche :

ros2 interface show posim_interfaces/srv/SetStratifiedCurrentVelocity

Lisez le modèle, modifiez ses bornes, puis réglez la première couche :

ros2 service call /hydrodynamics/get_current_velocity_model \
  posim_interfaces/srv/GetCurrentModel '{}'
ros2 service call /hydrodynamics/set_current_velocity_model \
  posim_interfaces/srv/SetCurrentModel \
  '{mean: 0.3, min: 0.0, max: 0.6, noise: 0.0, mu: 0.0}'
ros2 service call /hydrodynamics/set_stratified_current_velocity \
  posim_interfaces/srv/SetStratifiedCurrentVelocity \
  '{layer: 0, velocity: 0.2, horizontal_angle: 0.0, vertical_angle: 0.0}'
Service sous /hydrodynamics Interface Champs
get_current_velocity_model, get_current_horz_angle_model, get_current_vert_angle_model GetCurrentModel Requête vide
set_current_velocity_model, set_current_horz_angle_model, set_current_vert_angle_model SetCurrentModel mean, min, max, noise, mu
set_current_velocity SetCurrentVelocity velocity, horizontal_angle, vertical_angle
set_current_horz_angle, set_current_vert_angle SetCurrentDirection angle
set_stratified_current_velocity SetStratifiedCurrentVelocity layer, velocity, horizontal_angle, vertical_angle
set_stratified_current_horz_angle, set_stratified_current_vert_angle SetStratifiedCurrentDirection layer, angle

Contraintes des requêtes

Fournir des données de marée

Configurez <tidal_oscillation> avec un CSV ou des composantes harmoniques, par exemple M2/S2/N2, les directions du flot et du jusant et une date de départ GMT. Dans les exemples harmoniques, l'amplitude est en mètres, la phase en degrés et la vitesse angulaire en degrés/heure. Ces unités diffèrent des radians des services de courant.

En mode marée, le signal harmonique calculé, ou la vitesse du CSV divisée par 100, est multiplié par la première colonne du profil de profondeur. Les amplitudes de hauteur de l'exemple servent de facteurs numériques ; le modèle ne convertit pas la hauteur de marée en vitesse du courant. Calibrez conjointement le signal et le profil pour obtenir la vitesse voulue.

Le CSV comporte une ligne d'en-tête, puis des lignes YYYY-MM-DD HH:MM,event,speed :

Ces données sont des entrées d'expérience. Conservez leurs unités, la plage d'interpolation, l'origine du monde et la référence temporelle. Comparez le courant et la trajectoire du véhicule à partir de la même pose initiale.

Écoulement et réponse du véhicule

Courants stratifiés selon la profondeur et réponse du véhicule
Courants stratifiés selon la profondeur et réponse du véhicule
Échanges entre le monde, ROS et les plugins de courant du modèle
Échanges entre le monde, ROS et les plugins de courant du modèle
Réponse du véhicule à un courant uniforme
Réponse du véhicule à un courant stratifié
Réponse du véhicule à un courant stratifié
Sortie ROS du courant uniforme
Sortie ROS du courant uniforme
Sortie ROS du courant stratifié
Sortie ROS du courant stratifié
Sortie de la base de courants stratifiés
Sortie de la base de courants stratifiés
Application du courant à la profondeur du modèle
Vitesse du courant propre à chaque modèle
Vitesse du courant propre à chaque modèle
Topic ROS du courant du modèle
Topic ROS du courant du modèle
Topic Gazebo du courant du modèle
Topic Gazebo du courant du modèle

Images et vidéos : POSIM Notion Wiki. Consultez les références et licences pour l'attribution de DAVE. Utilisez les commandes et les topics de cette page.