POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Referencia de plugins

Corrientes marinas

POSIM genera corrientes en el mundo, calcula el flujo en cada robot y permite ajustarlo mediante ROS. La corriente uniforme y el perfil que varía con la profundidad tienen configuraciones y tópicos distintos.

Ejecutar el ejemplo

Prepara los terminales A y B en tu entorno POSIM: Ubuntu nativo, WSL, Docker o el escritorio remoto de macOS. Inicia el ejemplo en A:

ros2 launch posim_demos posim_robot.launch.py \
  namespace:=rexrov world_name:=ocean_current_plugin z:=-5 paused:=false \
  gui:=true headless:=false use_teleop:=false use_web_joystick:=false

En B, consulta primero Gazebo y después ROS. Pulsa Ctrl+C para detener el primer visor antes de ejecutar el segundo comando:

gz topic -e -t /ocean_current
ros2 topic echo /hydrodynamics/currentVelocityTopic --once

Configurar la corriente del mundo

Coloca ambos plugins directamente en <world>, primero el de corriente y después el de ROS. El mundo de ejemplo muestra la configuración completa.

<plugin filename="OceanCurrentWorldPlugin"
        name="posim_gz_world_plugins::OceanCurrentWorldPlugin">
  <namespace>hydrodynamics</namespace>
  <constant_current>
    <use_constant_current>true</use_constant_current>
    <topic>ocean_current</topic>
    <velocity><mean>0.3</mean><min>0</min><max>0.6</max><mu>0</mu><noiseAmp>0</noiseAmp></velocity>
    <horizontal_angle><mean>0</mean><min>-3.14</min><max>3.14</max><mu>0</mu><noiseAmp>0</noiseAmp></horizontal_angle>
    <vertical_angle><mean>0</mean><min>-1.57</min><max>1.57</max><mu>0</mu><noiseAmp>0</noiseAmp></vertical_angle>
  </constant_current>
  <transient_current>
    <topic_stratified>stratified_current_velocity</topic_stratified>
    <databasefileName>transientOceanCurrentDatabase.csv</databasefileName>
  </transient_current>
</plugin>
<plugin filename="OceanCurrentPlugin" name="posim_ros_gz_plugins::OceanCurrentPlugin">
  <namespace>hydrodynamics</namespace>
</plugin>

Ambos necesitan el mismo namespace, no vacío. Incluye los bloques constant_current y transient_current; si falta una configuración obligatoria, se desactiva la publicación y se informa del error. La corriente uniforme tiene modelos de Gauss–Markov separados para la velocidad y los ángulos horizontal y vertical.

Parámetro Función y valor predeterminado
namespace en ambos plugins Espacio de nombres compartido; hydrodynamics en el ejemplo
constant_current/use_constant_current Publicar corriente uniforme; false
constant_current/topic Tópico Gazebo uniforme; ocean_current
transient_current/topic_stratified Tópico Gazebo por capas dentro del espacio de nombres; stratified_current_velocity
transient_current/databasefileName CSV instalado en posim_worlds/worlds; transientOceanCurrentDatabase.csv
transient_current/databasefilePath Ruta CSV opcional; tiene prioridad sobre el nombre de archivo
mean de cada modelo estocástico Media inicial de velocidad (m/s) o ángulo (rad); 0
min, max Límites; −1 y 1. Mantén min < max y la media dentro del intervalo
noiseAmp Amplitud del incremento aleatorio; 0
mu Coeficiente de decaimiento de Gauss–Markov; 0
tidal_oscillation Bloque opcional de datos de marea

Preparar un perfil de profundidad

El CSV de ejemplo contiene velocidad en el eje X del mundo (m/s), velocidad en el eje Y del mundo (m/s) y profundidad (m), en ese orden. Los nombres heredados velocity_north, velocity_east y velocity_down corresponden directamente a los ejes X, Y y Z del mundo.

El plugin ROS del mundo transmite la base de datos completa. El plugin del modelo interpola la velocidad a la profundidad del vehículo; la hidrodinámica usa el flujo relativo al movimiento del robot.

Aplicar el perfil al robot

El ejemplo de REXROV usa inicialmente /ocean_current, uniforme. Para aplicar el perfil, activa una sola vez el bloque comentado del modelo REXROV, directamente en <model>:

<plugin filename="OceanCurrentModelPlugin"
        name="posim_gz_model_plugins::OceanCurrentModelPlugin">
  <namespace>rexrov</namespace>
  <flow_velocity_topic>ocean_current</flow_velocity_topic>
  <transient_current>
    <topic_stratified>/hydrodynamics/stratified_current_velocity_topic_database</topic_stratified>
    <velocity_north><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_north>
    <velocity_east><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_east>
    <velocity_down><mean>0</mean><mu>0</mu><noiseAmp>0</noiseAmp><noiseFreq>0</noiseFreq></velocity_down>
  </transient_current>
  <tide_oscillation>false</tide_oscillation>
</plugin>

Añade también <namespace>rexrov</namespace> al plugin existente gz-sim-hydrodynamics-system, conservando su enlace, densidad y coeficientes de arrastre. Vuelve a compilar el espacio de trabajo y carga su entorno.

Parámetro del modelo Función y valor predeterminado
namespace Obligatorio; debe coincidir con el de hidrodinámica, aquí rexrov
flow_velocity_topic Sufijo bajo /model/<namespace>/; ocean_current
transient_current/topic_stratified Entrada ROS de la base de datos; hydrodynamics/stratified_current_velocity_topic_database
velocity_north, velocity_east, velocity_down Ajustes estocásticos opcionales por componente; las componentes omitidas no añaden ruido
mean de cada componente Velocidad inicial, m/s; 0. Al recibir datos se sustituye por el perfil interpolado
mu Decaimiento de 0 a 1, aplicado según los segundos de simulación transcurridos; 0
noiseAmp Desviación permitida respecto a la velocidad interpolada, m/s; 0
noiseFreq Amplitud del incremento aleatorio por actualización; 0. No es una frecuencia en Hz
tide_oscillation Aplicar los datos de marea al modelo; false

El resultado se publica en /model/rexrov/ocean_current: gz.msgs.Vector3d en Gazebo y geometry_msgs/msg/TwistStamped en ROS. Comprueba tanto este dato como la respuesta del vehículo.

La profundidad se obtiene de la posición del modelo en el mundo; por encima del agua se usa cero. El flujo se interpola entre capas y, fuera del intervalo, toma la capa más cercana. Las marcas de tiempo repetidas o la pausa no hacen avanzar el modelo. Un mensaje de base de datos inválido se rechaza completo y se conserva el último perfil válido.

Sistemas y tópicos

Sistema Responsabilidad
posim_gz_world_plugins::OceanCurrentWorldPlugin Generar la corriente del mundo y los datos por profundidad
Plugin de corriente del modelo Interpolar la corriente en la posición del robot
posim_ros_gz_plugins::OceanCurrentPlugin Publicar datos ROS y ofrecer servicios de configuración
Tópico del ejemplo Transporte y tipo
/ocean_current Gazebo, gz.msgs.Vector3d
/hydrodynamics/stratified_current_velocity Gazebo, datos por capas
/hydrodynamics/stratifiedCurrentVelocityTopic ROS, posim_interfaces/msg/StratifiedCurrentVelocity
/hydrodynamics/currentVelocityTopic ROS, geometry_msgs/msg/TwistStamped
/hydrodynamics/stratified_current_velocity_topic_database ROS, posim_interfaces/msg/StratifiedCurrentDatabase

Comprueba los nombres del SDF y conecta la hidrodinámica a la fuente de corriente prevista.

Ajustar la corriente con servicios ROS

En B, consulta los servicios y solicita una corriente horizontal de 0.3 m/s:

ros2 service list -t
ros2 service call /hydrodynamics/set_current_velocity posim_interfaces/srv/SetCurrentVelocity \
  '{velocity: 0.3, horizontal_angle: 0.0, vertical_angle: 0.0}'

La velocidad se expresa en m/s y los ángulos en radianes. Comprueba success y los datos publicados. Para consultar la interfaz de una capa:

ros2 interface show posim_interfaces/srv/SetStratifiedCurrentVelocity

Lee el modelo, cambia sus límites y ajusta la primera capa:

ros2 service call /hydrodynamics/get_current_velocity_model \
  posim_interfaces/srv/GetCurrentModel '{}'
ros2 service call /hydrodynamics/set_current_velocity_model \
  posim_interfaces/srv/SetCurrentModel \
  '{mean: 0.3, min: 0.0, max: 0.6, noise: 0.0, mu: 0.0}'
ros2 service call /hydrodynamics/set_stratified_current_velocity \
  posim_interfaces/srv/SetStratifiedCurrentVelocity \
  '{layer: 0, velocity: 0.2, horizontal_angle: 0.0, vertical_angle: 0.0}'
Servicio, bajo /hydrodynamics Interfaz Campos
get_current_velocity_model, get_current_horz_angle_model, get_current_vert_angle_model GetCurrentModel Solicitud vacía
set_current_velocity_model, set_current_horz_angle_model, set_current_vert_angle_model SetCurrentModel mean, min, max, noise, mu
set_current_velocity SetCurrentVelocity velocity, horizontal_angle, vertical_angle
set_current_horz_angle, set_current_vert_angle SetCurrentDirection angle
set_stratified_current_velocity SetStratifiedCurrentVelocity layer, velocity, horizontal_angle, vertical_angle
set_stratified_current_horz_angle, set_stratified_current_vert_angle SetStratifiedCurrentDirection layer, angle

Límites de las solicitudes

Incorporar datos de marea

Configura <tidal_oscillation> con un CSV o componentes armónicas, como M2/S2/N2, las direcciones de flujo y reflujo y una hora inicial GMT. Las unidades de los ejemplos armónicos son metros para la amplitud, grados para la fase y grados/hora para la velocidad angular. No las confundas con los ángulos en radianes de los servicios.

En el modo de mareas, la señal armónica calculada, o la velocidad del CSV dividida entre 100, se multiplica por la primera columna del perfil de profundidad. Las amplitudes de altura del ejemplo se usan como factores numéricos; el modelo no convierte la altura de marea en velocidad de corriente. Calibra conjuntamente la señal y el perfil para obtener la velocidad prevista.

El CSV de mareas tiene una cabecera y filas YYYY-MM-DD HH:MM,event,speed:

Estos datos son entradas del experimento. Conserva sus unidades, intervalo de interpolación, origen del mundo y referencia temporal. Compara corriente y movimiento del vehículo con la misma pose inicial.

Flujo y respuesta del vehículo

Corrientes por capas de profundidad y respuesta del vehículo
Corrientes por capas de profundidad y respuesta del vehículo
Flujo de datos entre el mundo, ROS y los plugins de corriente del modelo
Flujo de datos entre el mundo, ROS y los plugins de corriente del modelo
Respuesta del vehículo a una corriente uniforme
Respuesta del vehículo a una corriente estratificada
Respuesta del vehículo a una corriente estratificada
Datos ROS de la corriente uniforme
Datos ROS de la corriente uniforme
Datos ROS de la corriente estratificada
Datos ROS de la corriente estratificada
Datos de la base de corrientes estratificadas
Datos de la base de corrientes estratificadas
Corriente aplicada a la profundidad del modelo
Velocidad de la corriente de cada modelo
Velocidad de la corriente de cada modelo
Tópico ROS de la corriente del modelo
Tópico ROS de la corriente del modelo
Tópico Gazebo de la corriente del modelo
Tópico Gazebo de la corriente del modelo

Imágenes y vídeos: POSIM Notion Wiki. Consulta las referencias y licencias para la atribución de DAVE. Usa los comandos y tópicos de esta página.