POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Guías avanzadas

Añadir y configurar sensores

Un sensor necesita su definición en el modelo, el sistema que lo actualiza y una ruta hasta la aplicación receptora. Añade uno cada vez y comprueba sus mediciones.

Entorno de trabajo

Usa las terminales Linux preparadas en Ubuntu nativo, WSL o Docker. En macOS, trabaja dentro del escritorio RDP. Edita y compila allí; POSIM_WS indica ese espacio de trabajo.

Elegir dónde integrarlo

Medición Ubicación en el modelo Sistema del mundo / conexión ROS
IMU link/sensor type="imu" Sistema IMU; puente de gz.msgs.IMU a ROS Imu
Cámara submarina Sensor RGBD y plugin de efectos Sistema Sensors con renderizador y tópicos de cámara
DVL Sensor DVL y configuración de haces Sistema DVL y puente de mensajes acústicos incluido
Presión Plugin directamente bajo model Publicación ROS directa de presión y profundidad
GNSS marino Plugin del receptor en el modelo Mensajes Gazebo gz.msgs.Double_V; se necesita un adaptador aparte para ROS
USBL Plugins del transceptor y transpondedor Identificadores acústicos compatibles e interfaces ROS
Sonar multihaz Sensor personalizado bajo un eslabón Renderizador Sensors, sistema multihaz del mundo y CPU/WGPU/CUDA

Consulta el SDF y los parámetros de cada referencia. Respeta su ubicación: los sistemas del mundo van en el mundo; los plugins de modelo necesitan la entidad sobre la que actúan.

Añadir una IMU al mundo de ejemplo

Abre calm_water.sdf de Crear un mundo. Añade este sistema directamente en <world>, junto al sistema de física:

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

Dentro de <link name="base_link"> del modelo pressure_station, añade:

<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 pose es relativa al eslabón, en metros y radianes. La frecuencia usa tiempo simulado. Como la estación está fija, la velocidad angular debe ser cercana a cero; la aceleración incluye la respuesta a la gravedad.

Conectar y observar

Detén el mundo anterior. En la terminal A, valida y reinicia:

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

En la terminal B, con el entorno cargado, inicia el puente y déjalo ejecutándose:

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

En la terminal C, preparada del mismo modo, consulta una medida:

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

Comprueba marca temporal, identificador del sistema de referencia, velocidad angular y aceleración. Quita --once para observar continuamente; Ctrl+C detiene la lectura. Al terminar, detén puente y simulador. Terminales y tópicos ROS explica cómo comparten el entorno.

Cambiar la frecuencia

Cambia update_rate de 20 a 5 y reinicia mundo y puente. Los intervalos entre marcas temporales deben pasar de unos 0,05 s a 0,2 s de tiempo simulado. La frecuencia recibida en tiempo real depende también del factor de tiempo real y del transporte.

En cámaras, revisa juntos resolución, campo de visión y distancias cercana y lejana. En sensores de barrido, comprueba haces y límites de alcance. Antes de mover un sensor, confirma su sistema de referencia y orientación.

Comprobar la integración

Verifica el fondo con Terrenos. Para comparar sonar, usa Configuración y rendimiento junto con sus parámetros.