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:
- Fisica: passo massimo di 0,001 s, fattore di tempo reale desiderato pari a 1 e gravità verso il basso.
- Luci e scena: sole direzionale, luce ambientale e colore di sfondo.
- Fondale: parallelepipedo fisso a z = −20 m, con geometrie visiva e di collisione coincidenti.
- Stazione di pressione: indicatore fisso a z = −2 m. Il plugin di pressione, inserito nel modello, pubblica pressione e profondità stimata.
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à
- Ferma la simulazione nel terminale A con Ctrl+C.
- Cambia la posa della stazione da
0 0 -2 0 0 0a0 0 -4 0 0 0. - Valida e riavvia il mondo.
- 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
- Terreni: sostituire il fondale e verificare le collisioni.
- Aggiungere un robot: meccanica, propulsione e ROS.
- Correnti: flusso del mondo e risposta del modello.
- Coordinate sferiche: origine geografica.
- Effetti subacquei: rendering.
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.