Crear un mundo
Empieza con un mundo pequeño y un sensor de presión a profundidad conocida. Así podrás modificar el entorno y medir el resultado antes de añadir terreno y un robot móvil.
Preparar el entorno de trabajo
Usa las terminales Linux preparadas en Ubuntu nativo, WSL o Docker. En macOS, abre la terminal del escritorio RDP. Edita y compila dentro de ese entorno; POSIM_WS indica su espacio de trabajo.
Guardar el mundo completo
Guarda este contenido como calm_water.sdf. Utiliza geometría básica y plugins instalados; no necesita descargar mallas.
<?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>
El mundo contiene:
- Física: paso máximo de 0,001 s, factor de tiempo real objetivo de 1 y gravedad descendente.
- Iluminación y escena: luz solar direccional, luz ambiente y color de fondo.
- Fondo marino: caja fija en z = −20 m, con geometrías visual y de colisión coincidentes.
- Estación de presión: marcador fijo en z = −2 m. Su plugin de presión, asociado al modelo, publica presión y profundidad estimada.
La referencia de presión es el plano z = 0 del mundo. Añade oleaje, flotabilidad y movimiento después de comprobar este caso básico.
Validar y ejecutar
En la terminal A, desde el directorio del archivo:
gz sdf -k calm_water.sdf
gz sim -r calm_water.sdf
La validación debe completarse correctamente; después se abre Gazebo. -r inicia el tiempo simulado. Selecciona pressure_station en el árbol de entidades y centra la vista en ella.
En otra terminal con el mismo entorno cargado:
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
Espera aproximadamente 120 938 Pa y 2 m. El plugin publica directamente en ROS; este ejemplo no requiere un puente adicional.
Cambiar la profundidad
- Detén la simulación en la terminal A con Ctrl+C.
- Cambia la pose de la estación de
0 0 -2 0 0 0a0 0 -4 0 0 0. - Valida y vuelve a iniciar el mundo.
- Repite las dos consultas. Debes obtener unos 140 551 Pa y 4 m.
Mantén los coeficientes de presión. El incremento esperado es 19 612,76 Pa. Conserva ambos archivos junto con tus observaciones.
Ubicar cada ajuste
| Ruta SDF | Unidad | Función |
|---|---|---|
world/physics/max_step_size |
s | Paso máximo: 0.001 |
world/physics/real_time_factor |
— | Relación objetivo entre tiempo simulado y real: 1.0 |
world/gravity |
m/s² | Vector de gravedad |
world/scene, world/light |
RGBA / dirección | Fondo e iluminación |
model/pose |
m, rad | Posición y orientación |
model/static |
booleano | Mantener fijos estación y fondo |
model/plugin |
según el plugin | Parámetros de presión |
La velocidad real depende de la carga. La definición de un sensor y su sistema del mundo tienen ámbitos distintos; Añadir sensores incorpora una IMU y su puente ROS a este archivo.
Ampliar el mundo
- Terrenos: sustituir el fondo y comprobar colisiones.
- Añadir un robot: mecánica, propulsión y ROS.
- Corrientes: flujo del mundo y respuesta del modelo.
- Coordenadas esféricas: origen geográfico.
- Efectos submarinos: representación visual.
Guarda los mundos distribuibles en models/posim_worlds/worlds y sus recursos en el mismo paquete. Recompila, carga el entorno y usa URI de recursos instalados al compartirlos.