POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Guide avanzate

Creare un mondo

Parti da un mondo piccolo con un sensore di pressione a profondità nota. Potrai modificare l'ambiente e misurare il risultato prima di aggiungere terreno e robot mobile.

Preparare l'ambiente di lavoro

Usa i terminali Linux preparati su Ubuntu nativo, WSL o Docker. Su macOS apri il terminale del desktop RDP. Modifica e compila in quell'ambiente; POSIM_WS indica il suo spazio di lavoro.

Salvare il mondo completo

Salva il contenuto seguente come calm_water.sdf. Usa geometrie semplici e plugin installati, senza mesh da scaricare.

<?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>

Il mondo comprende:

Il riferimento della pressione è il piano z = 0 del mondo. Aggiungi onde, galleggiamento e movimento dopo aver verificato questo caso di base.

Validare e avviare

Nel terminale A, dalla directory del file:

gz sdf -k calm_water.sdf
gz sim -r calm_water.sdf

La validazione deve riuscire, poi si apre Gazebo. -r avvia il tempo simulato. Seleziona pressure_station nell'albero delle entità e centra la vista sul modello.

In un altro terminale con lo stesso ambiente caricato:

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

I valori attesi sono circa 120 938 Pa e 2 m. Il plugin pubblica direttamente in ROS; non serve un bridge aggiuntivo.

Cambiare la profondità

  1. Ferma la simulazione nel terminale A con Ctrl+C.
  2. Cambia la posa della stazione da 0 0 -2 0 0 0 a 0 0 -4 0 0 0.
  3. Valida e riavvia il mondo.
  4. Ripeti le due letture: dovresti ottenere circa 140 551 Pa e 4 m.

Mantieni invariati i coefficienti di pressione. L'aumento atteso è 19 612,76 Pa. Conserva entrambi i file insieme alle osservazioni.

Individuare le impostazioni

Percorso SDF Unità Funzione
world/physics/max_step_size s Passo massimo: 0.001
world/physics/real_time_factor — Rapporto desiderato fra tempo simulato e reale: 1.0
world/gravity m/s² Vettore di gravità
world/scene, world/light RGBA / direzione Sfondo e illuminazione
model/pose m, rad Posizione e orientamento
model/static booleano Mantenere fissi stazione e fondale
model/plugin secondo il plugin Parametri della pressione

La velocità effettiva dipende dal carico. La definizione del sensore e il relativo sistema del mondo hanno ambiti diversi. Aggiungere sensori integra un'IMU e il suo bridge ROS in questo file.

Ampliare il mondo

Salva i mondi distribuibili in models/posim_worlds/worlds e le risorse nello stesso pacchetto. Ricompila, carica l'ambiente e usa URI delle risorse installate quando condividi il mondo.