Créer un monde
Commencez par un petit monde avec un capteur de pression à une profondeur connue. Vous pourrez modifier l'environnement et mesurer le résultat avant d'ajouter terrain et robot mobile.
Préparer l'environnement de travail
Utilisez les terminaux Linux préparés sous Ubuntu natif, WSL ou Docker. Sur macOS, ouvrez le terminal du bureau RDP. Modifiez et compilez dans cet environnement ; POSIM_WS désigne son espace de travail.
Enregistrer le monde complet
Enregistrez ce contenu dans calm_water.sdf. Il utilise des formes simples et des plugins installés, sans maillage à télécharger.
<?xml version="1.0"?>
<sdf version="1.12">
<world name="calm_water">
<physics name="physics" type="ignored">
<max_step_size>0.001</max_step_size>
<real_time_factor>1.0</real_time_factor>
</physics>
<gravity>0 0 -9.80665</gravity>
<plugin filename="gz-sim-physics-system" name="gz::sim::systems::Physics"/>
<plugin filename="gz-sim-user-commands-system" name="gz::sim::systems::UserCommands"/>
<plugin filename="gz-sim-scene-broadcaster-system" name="gz::sim::systems::SceneBroadcaster"/>
<scene>
<ambient>0.4 0.5 0.6 1</ambient>
<background>0.05 0.15 0.25 1</background>
</scene>
<light name="sun" type="directional">
<direction>-0.5 0.2 -1</direction>
<diffuse>0.8 0.8 0.8 1</diffuse>
</light>
<model name="seabed">
<static>true</static>
<pose>0 0 -20 0 0 0</pose>
<link name="ground">
<collision name="collision">
<geometry><box><size>40 40 0.2</size></box></geometry>
</collision>
<visual name="visual">
<geometry><box><size>40 40 0.2</size></box></geometry>
<material><diffuse>0.6 0.5 0.3 1</diffuse></material>
</visual>
</link>
</model>
<model name="pressure_station">
<static>true</static>
<pose>0 0 -2 0 0 0</pose>
<link name="base_link">
<visual name="marker">
<geometry><box><size>0.2 0.2 0.2</size></box></geometry>
</visual>
</link>
<plugin filename="sea_pressure_sensor"
name="posim_gz_sensor_plugins::SubseaPressureSensorPlugin">
<namespace>pressure_station</namespace>
<topic>sea_pressure</topic>
<standard_pressure>101.325</standard_pressure>
<kPa_per_meter>9.80638</kPa_per_meter>
<estimate_depth_on>true</estimate_depth_on>
<update_rate>10</update_rate>
</plugin>
</model>
</world>
</sdf>
Ce monde contient :
- Physique : pas maximal de 0,001 s, facteur de temps réel visé de 1 et gravité vers le bas.
- Éclairage et scène : soleil directionnel, lumière ambiante et couleur de fond.
- Fond marin : boîte fixe à z = −20 m, avec géométries visuelle et de collision identiques.
- Station de pression : repère fixe à z = −2 m. Son plugin de pression, placé au niveau du modèle, publie pression et profondeur estimée.
La référence de pression est le plan z = 0 du monde. Ajoutez vagues, flottabilité et mouvement après avoir vérifié ce cas simple.
Valider et lancer
Dans le terminal A, depuis le répertoire du fichier :
gz sdf -k calm_water.sdf
gz sim -r calm_water.sdf
La validation doit réussir, puis Gazebo s'ouvre. -r démarre le temps simulé. Sélectionnez pressure_station dans l'arbre des entités et centrez la vue dessus.
Dans un autre terminal avec le même environnement chargé :
ros2 topic echo --no-daemon /model/pressure_station/sea_pressure sensor_msgs/msg/FluidPressure \
--once
ros2 topic echo --no-daemon /model/pressure_station/sea_pressure_depth geometry_msgs/msg/PointStamped \
--once
Les valeurs attendues sont environ 120 938 Pa et 2 m. Le plugin publie directement dans ROS ; cet exemple n'exige pas de pont supplémentaire.
Modifier la profondeur
- Arrêtez la simulation dans le terminal A avec Ctrl+C.
- Remplacez la pose
0 0 -2 0 0 0par0 0 -4 0 0 0. - Validez et relancez le monde.
- Répétez les deux lectures. Attendez environ 140 551 Pa et 4 m.
Gardez les coefficients de pression inchangés. L'augmentation attendue est 19 612,76 Pa. Conservez les deux fichiers avec vos observations.
Retrouver chaque réglage
| Chemin SDF | Unité | Rôle |
|---|---|---|
world/physics/max_step_size |
s | Pas maximal : 0.001 |
world/physics/real_time_factor |
— | Rapport visé entre temps simulé et réel : 1.0 |
world/gravity |
m/s² | Vecteur de gravité |
world/scene, world/light |
RGBA / direction | Fond et éclairage |
model/pose |
m, rad | Position et orientation |
model/static |
booléen | Maintenir station et fond fixes |
model/plugin |
selon le plugin | Paramètres de pression |
La vitesse obtenue dépend de la charge. La définition d'un capteur et son système dans le monde ont des portées différentes. Ajouter des capteurs ajoute une IMU et son pont ROS à ce fichier.
Enrichir le monde
- Terrains : remplacer le fond et vérifier les collisions.
- Ajouter un robot : mécanique, propulsion et ROS.
- Courants : écoulement du monde et réaction du modèle.
- Coordonnées sphériques : origine géographique.
- Effets sous-marins : rendu visuel.
Placez les mondes à distribuer dans models/posim_worlds/worlds et leurs ressources dans le même paquet. Recompilez, rechargez l'environnement et utilisez des URI de ressources installées pour les partager.