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

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 :

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

  1. Arrêtez la simulation dans le terminal A avec Ctrl+C.
  2. Remplacez la pose 0 0 -2 0 0 0 par 0 0 -4 0 0 0.
  3. Validez et relancez le monde.
  4. 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

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.