WWW-POSIM v0.6.16Documentación del simulador
Menú de documentación
WWW-POSIM / Documentación del simulador

Especificaciones

Especificaciones predeterminadas del entorno, los datos, la física y las interfaces. Las diferencias por plataforma o mundo se indican por separado.

Software

Elemento Especificación
ROS ROS 2 Lyrical
Gazebo Jetty · Gazebo Sim 10; macOS: 10.5.0
Piloto automático de superficie ArduRover 4.7.2 · SITL
Piloto automático submarino ArduSub 4.7.2 · SITL
Código ArduPilot fb773567896014da007bca58358704d4a0d8516f
Gráficos del navegador Three.js 0.186.1 · React Three Fiber 9.8.1

Tiempo de simulación

Elemento Especificación
Velocidad objetivo predeterminada 1×
Paso físico macOS 10 ms
Paso físico Windows/Linux 20 ms
Paso de evaluación 10 ms
Paso del servidor web Configuración del servidor

Las frecuencias usan tiempo simulado. El factor de tiempo real (RTF), la tasa de actualización física, la frecuencia del sensor y los FPS de pantalla son medidas diferentes.

Física y renderizado

Elemento Especificación
Cuerpos rígidos y contactos Gazebo Physics; DART por defecto
Dinámica marina Campo de olas, flotabilidad e hidrodinámica Wave Sim
Hidrodinámica BlueROV2 Flotabilidad con olas y amortiguamiento lineal/angular
Vistas y sensores Gazebo Ogre2 en el motor; Metal en macOS
Escena del navegador Three.js/WebGL: terreno, vehículos y agua a partir del estado simulado
Geometría de olas del navegador Muestras del solucionador físico

Extensión del terreno, agua y fondo

Elemento Especificación
Terreno de la demo WAM-V Hong Kong preparado: centro 2 × 2 km, entorno 6 × 6 km; elevación/profundidad e imágenes aéreas
Mundo personalizado predeterminado Área fija 1 × 1 km; terreno bajo demanda opcional
Región inicial bajo demanda 1 000 × 1 000 m · 129 × 129
Espaciado numérico bajo demanda 7,8125 m
Tesela predeterminada 1 000 × 1 000 m
Fondo necesario en espacio personal 5 × 5 teselas · 5 × 5 km
Fondo necesario en LIVE 7 × 7 teselas · 7 × 7 km
Región fija sin transmisión 1 × 1 km · 513 × 513 · 1,953125 m
Tesela física periódica de olas 256 × 256 m · 64 × 64 celdas
Agua detallada personal en Gazebo 3 × 3 teselas · 768 × 768 m
Teselas visibles de olas LIVE 15 × 15 teselas · 3 840 × 3 840 m

La tesela de cálculo de olas, el agua visible, el terreno numérico y el fondo de colisión cargado cubren áreas diferentes. Las teselas repetidas comparten un campo periódico, no simulaciones independientes. Los tamaños de cuadrícula indican muestras; el campo FFT indica celdas. La demo usa Hong Kong; los ejercicios, una arena propia con fondo plano a 20 m. Consulta Algoritmos de generación del terreno.

Generación de terreno bajo demanda

Elemento Especificación
Preparación Descarga elevación/profundidad e imágenes terrestres disponibles; proyección métrica local
Construcción de teselas Mallas visuales y de colisión comparten muestras; halo de dos celdas para continuidad
Inserción en Gazebo Entidades SDF reales en coordenadas locales
Comprobación Presencia de entidades, profundidad RGBD y contacto mediante una esfera de 0.25 m de radio y 10 kg; distancia a la malla que tiene en cuenta la pendiente · Comprobación física del terreno
Precarga Fila exterior según posición/velocidad: 120 s de anticipación, mínimo 250 m, máximo 40 % de una tesela
Espera y reanudación Espera si falta cobertura; reanuda al validar todo el cuadrado actual
Caché y residencia Reutiliza muestras y teselas recientes; retira entidades lejanas con presupuesto limitado

Conjuntos de datos

Elemento Especificación
GEBCO 2026 Elevación y batimetría global; cuadrícula nativa de 15 segundos de arco
Copernicus GLO-30 Elevación terrestre; 30 m nominales
Copernicus Marine 202511 Batimetría costera regional, donde esté disponible
EMODnet DTM 2024 Batimetría regional, principalmente aguas europeas
KHOA BADA2024 Batimetría coreana opcional
Cesium World Bathymetry Preferente con acceso numérico autorizado configurado
OpenStreetMap Refinamiento de costa y límite tierra/agua
Sentinel-2 RGB Imágenes terrestres; 10 m nominales

El mundo registra las fuentes realmente usadas. Reducir el espaciado de la malla no aumenta la precisión de los datos originales.

Modelos de vehículos

Elemento Especificación
Propulsión WAM-V 2: izquierda y derecha
Propulsión BlueROV2 6
Masa WAM-V Casco 180 kg; total 211,151 kg
Masa BlueROV2 Casco 10 kg; total ≈10,0132 kg
Límites de colisión WAM-V 5,006 × 2,487 × 1,291 m
Caja de colisión BlueROV2 0,457 × 0,338 × 0,065 m
Luces delanteras BlueROV2 Dos focos delanteros; ON por defecto; rango de atenuación del modelo 25 m
Dimensiones generales BlueROV2 del fabricante 0,457 × 0,338 × 0,254 m

Las dimensiones de colisión describen la geometría simulada, no todo el producto físico. Las masas totales suman los enlaces SDF.

Sensores y estados predeterminados

Elemento Especificación
GNSS WAM-V Predeterminado; 5 Hz; latencia 0,2 s; GPS_INPUT → EKF
GNSS satelital BlueROV2 Activado por defecto; desactivación explícita; inmersión de antena; readquisición 3 s
IMU WAM-V 200 Hz
IMU BlueROV2 1 000 Hz configurados; limitada por el paso físico
RGB frontal, ambos vehículos 640 × 480 px · 5 Hz · HFOV 1,05 rad (60,2°)
RGB-D de inspección BlueROV2 640 × 480 px · 5 Hz · HFOV 60,2°; 45° hacia abajo
LiDAR 2D WAM-V 5 Hz; 360 muestras en 360°; 0,2–50 m; resolución 0,02 m
Magnetómetro BlueROV2 20 Hz · Gazebo
Odometría WAM-V 20 Hz
Odometría BlueROV2 100 Hz

Las cámaras se activan bajo demanda. El conector ROS estándar entrega JPEG a un máximo de 1 Hz de tiempo simulado. La odometría es estado del simulador, no un sensor físico de posición con error. La frecuencia publicada puede ser menor que la configurada. HFOV es el campo de visión horizontal.

GNSS y navegación define calidad, marcos de antena y recuperación. El editor puede cambiar sensores, montajes y ajustes. Los temas generados usan /vehicle/sensors/{sensor_id} y sufijos según salida; consulta la lista activa y sensor-manifest.json. Personalizar los sensores distingue DVL, Ping y multihaz. Los métodos, parámetros SDF, ruido y validez están en Modelos y parámetros de sensores.

Recorte y visibilidad de cámaras

Elemento Especificación
RGB frontal WAM-V integrado near 0,1 m · far 5 000 m
RGB frontal BlueROV2 integrado near 0,1 m · far 5 000 m
RGB-D de inspección BlueROV2 near 0,1 m · far 80 m
Cámaras del editor Ajustes guardados; independientes de las cámaras integradas
Cámara de escena personal Gazebo near 0,1 m; far = max(5 000 m, 16 × diagonal 3D del terreno)
Cámaras de escena LIVE Gazebo near 0,1 m · far 5 000 m · 1280 × 720 px
Cámara World/Vehicle del navegador near adaptativo 0,03–40 m; far ≥8 000 m, ampliado según mundo y distancia

near y far delimitan el dibujo geométrico. Atenuación submarina, oclusión, terreno cargado y cobertura de imágenes pueden reducir la visibilidad útil. Las cámaras de escena y los sensores del robot son independientes.

Temas y mensajes ROS

Elemento Especificación
/clock rosgraph_msgs/msg/Clock
/model/{robot}/odometry nav_msgs/msg/Odometry
/model/{robot}/imu sensor_msgs/msg/Imu
/model/{robot}/camera/compressed sensor_msgs/msg/CompressedImage · JPEG ≤1 Hz
/model/wamv/scan sensor_msgs/msg/LaserScan
/model/bluerov2/inspection/image/compressed sensor_msgs/msg/CompressedImage · RGB
/tf, /tf_static tf2_msgs/msg/TFMessage
/mavros/battery sensor_msgs/msg/BatteryState · Autopilot
/wwos/cmd_vel geometry_msgs/msg/TwistStamped · WAM-V · ROS 2
/wwos/thrusters std_msgs/msg/Float64MultiArray · ROS 2 · N

{robot} es wamv o bluerov2. El conector expone el RGB de inspección; la profundidad RGBD es otra salida nativa. Una vigilancia de 0,75 s lleva las órdenes a neutro si dejan de actualizarse.

Coordenadas, unidades y supuestos

Elemento Especificación
Coordenadas geográficas WGS 84; latitud/longitud en grados
Ejes locales ENU: este/norte/arriba
Ejes corporales Gazebo FLU: delante/izquierda/arriba
Ejes corporales ArduPilot FRD: delante/derecha/abajo
Ejes de navegación ArduPilot NED: norte/este/abajo
Unidades ROS m · s · m/s · rad/s · m/s² · N

La conversión de marcos se realiza en la interfaz del piloto automático. Estos parámetros describen un modelo; no implican autonomía de batería, profundidad nominal o precisión del producto real.

Referencias

Buscar en la documentación