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

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:

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

  1. Detén la simulación en la terminal A con Ctrl+C.
  2. Cambia la pose de la estación de 0 0 -2 0 0 0 a 0 0 -4 0 0 0.
  3. Valida y vuelve a iniciar el mundo.
  4. 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

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.