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

Aggiungere e configurare sensori

Un sensore richiede la definizione nel modello, il sistema che lo aggiorna e un collegamento all'applicazione ricevente. Aggiungine uno alla volta e verifica le misure.

Ambiente di lavoro

Usa i terminali Linux preparati su Ubuntu nativo, WSL o Docker. Su macOS lavora nel desktop RDP. Modifica e compila in quell'ambiente; POSIM_WS ne indica lo spazio di lavoro.

Scegliere il punto d'integrazione

Misura Posizione nel modello Sistema del mondo / collegamento ROS
IMU link/sensor type="imu" Sistema IMU; bridge da gz.msgs.IMU a ROS Imu
Telecamera subacquea Sensore RGBD e plugin degli effetti Sistema Sensors con renderer e topic della telecamera
DVL Sensore DVL e configurazione dei fasci Sistema DVL e bridge dei messaggi acustici incluso
Pressione Plugin direttamente sotto model Pubblicazione ROS diretta di pressione e profondità
GNSS marino Plugin del ricevitore sul modello Messaggi Gazebo gz.msgs.Double_V; per ROS serve un adattatore separato
USBL Plugin di ricetrasmettitore e transponder Identificativi acustici corrispondenti e interfacce ROS
Sonar multibeam Sensore personalizzato sotto un link Renderer Sensors, sistema multibeam del mondo e CPU/WGPU/CUDA

Consulta l'SDF e la tabella dei parametri di ogni riferimento. Rispetta la posizione: i sistemi del mondo vanno nel mondo, mentre i plugin di modello richiedono l'entità su cui agiscono.

Aggiungere un'IMU al mondo di esempio

Apri calm_water.sdf da Creare un mondo. Aggiungi questo sistema direttamente in <world>, accanto al sistema fisico:

<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu"/>

Dentro <link name="base_link"> del modello pressure_station, aggiungi:

<sensor name="imu" type="imu">
  <pose>0 0 0.1 0 0 0</pose>
  <always_on>true</always_on>
  <update_rate>20</update_rate>
  <topic>/tutorial/imu</topic>
  <imu/>
</sensor>

La posa è relativa al link, in metri e radianti. La frequenza usa il tempo simulato. La stazione è fissa: la velocità angolare dovrebbe restare vicina a zero, mentre l'accelerazione include la risposta alla gravità.

Collegare e osservare

Ferma il mondo precedente. Nel terminale A, valida e riavvia:

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

Nel terminale B, con l'ambiente caricato, avvia il bridge e lascialo in esecuzione:

ros2 run ros_gz_bridge parameter_bridge \
  '/tutorial/imu@sensor_msgs/msg/Imu[gz.msgs.IMU'

Nel terminale C, preparato nello stesso modo, leggi una misura:

ros2 topic echo --no-daemon /tutorial/imu sensor_msgs/msg/Imu --once

Controlla timestamp, identificativo del sistema di riferimento, velocità angolare e accelerazione. Togli --once per leggere continuamente; Ctrl+C ferma la visualizzazione. Alla fine arresta bridge e simulatore. Terminali e topic ROS spiega come condividono l'ambiente.

Cambiare la frequenza

Modifica update_rate da 20 a 5 e riavvia mondo e bridge. Gli intervalli tra timestamp dovrebbero passare da circa 0,05 s a 0,2 s di tempo simulato. La frequenza ricevuta nel tempo reale dipende anche dal fattore di tempo reale e dal trasporto.

Per le telecamere, controlla insieme risoluzione, campo visivo e limiti vicino e lontano. Per i sensori a scansione, verifica fasci e portata. Prima di spostare un sensore, conferma sistema di riferimento e orientamento.

Verificare l'integrazione

Verifica il fondale con Terreni. Per confrontare configurazioni sonar, usa Configurazione e prestazioni insieme al riferimento dei parametri.