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

GNSS y navegación

Las sesiones WAM-V y BlueROV2 activan por defecto el receptor GNSS satelital simulado de POSIM. En BlueROV2 puede desactivarse explícitamente. Comparten contrato de sensor, antena y temas. El estado GNSS se distingue de la estimación de posición FCU.

Implementación

Etapa Método Parámetros y salida
Cinemática de antena El plugin nativo Gazebo posim::Gnss observa el enlace real, incluida rotación y brazo de palanca. link_name, pose; posición geográfica y velocidad por diferencias finitas.
Error de medición Perturbaciones gaussianas independientes de posición y velocidad, con semilla. horizontal_stddev, vertical_stddev, velocity_stddev, seed; covarianza diagonal.
Disponibilidad Prueba de inmersión con olas, histéresis, readquisición continua y obstrucción explícita. water_level, wave_topic, dry_margin, reacquire_seconds, enabled; posición válida, adquiriendo, sumergido, bloqueado o no disponible.
Tiempo Cadencia y cola de mediciones retrasadas en tiempo simulado. update_rate, latency; conserva el instante original de adquisición.
ROS y FCU Valida época, marca temporal y valores finitos; publica medición/estado y convierte medidas aceptadas a MAVLink GPS_INPUT. Alias del sensor, GPS bruto FCU y estimaciones fusionadas permanecen diferenciados.
Interfaz y misión Frescura y estado EKF determinan disponibilidad y restricciones de misión. El indicador de fusión interpreta estados; no expone todas las innovaciones del filtro.

La implementación y los perfiles del receptor definen el sensor. WWW-POSIM añade conversión ROS, selección de fuente de navegación e integración de misiones. Véase Modelos y parámetros de sensores.

Mediciones y estimaciones

Salida Significado
/model/{robot}/gnss/fix NavSatFix del sensor: posición de antena con ruido configurado.
/model/{robot}/gnss/status Estado e instante original; JSON en std_msgs/String.
/vehicle/gnss/fix, /vehicle/gnss/status Alias del vehículo activo de esos mismos mensajes, no otro inyector GPS.
/mavros/global_position/raw/fix GPS recibido por ArduPilot y convertido por MAVROS.
/mavros/global_position/global Posición fusionada de la FCU.
/mavros/local_position/pose Pose local fusionada, ENU.
/model/{robot}/odometry Referencia del simulador para vista 3D, seguridad del terreno y validación; no proporciona las coordenadas del mapa

Gazebo genera las mediciones. El adaptador convierte las aceptadas a GPS_INPUT, receptor 0. El perfil ArduPilot selecciona ese receptor MAV, desactiva el segundo y el GPS sintético SITL, y usa posición/velocidad horizontal GPS con guiñada de brújula. No se inyectan pose ni velocidad de referencia del simulador como visión en la FCU, incluso con GNSS desactivado. Una sola antena no mide rumbo estacionario; el curso GPS en movimiento tampoco equivale al rumbo del casco.

El perfil GNSS fija el mínimo de ruido de velocidad horizontal EK3_VELNE_M_NSE a partir de receiver.velocity_stddev, limitado al intervalo documentado de 0.05–5 m/s (valor predeterminado: 0.1 m/s). La precisión de velocidad declarada por el receptor puede elevar el mínimo efectivo. Esto configura la ponderación del EKF; el ruido de medición simulado no cambia.

La IMU Gazebo del WAM-V envía aceleración y velocidad angular por la interfaz JSON ArduPilot. La brújula usa el campo magnético de SITL. Es una dependencia idealizada de simulación, no un rumbo estacionario deducido de GNSS.

Los objetivos usan el origen geográfico del EKF de la FCU y las llegadas se deciden con la posición estimada. El estado del simulador sirve para evaluar trayectorias y comprobar terreno, sin eliminar por alineación el error horizontal GNSS. Una posición GNSS reciente no garantiza un filtro sano: la interfaz separa validez EKF y fusión observada. El indicador combina fuente configurada, estado reciente y banderas EKF; no es un registro de innovaciones por medición.

En misiones con GNSS configurado, tras armar, la misión exige 2 segundos reales continuos de pose local reciente y fusión observada de GNSS o navegación externa aceptada antes de solicitar GUIDED. La pérdida reinicia el intervalo; sin estabilización en 35 segundos, la misión se detiene. La readquisición usa otro temporizador en tiempo simulado.

La aplicación web e instalada solicita estado EKF, estado del sistema y latidos FCU a 5 Hz de tiempo simulado. Rechaza estados con más de 3 s reales. Con una solución validada por reloj, el adaptador repite su estado cada 0,2 s reales, conservando el instante original. Cada nueva entrada GPS y medición procede de una adquisición aceptada nueva. Un reloj detenido o una medición antigua invalida el receptor.

Configuración y marcos de referencia

posim_gz_gnss/config/profiles.json define receptor y montaje. El SDF contiene base_link → gnss_link → gnss y el publicador de poses expone la jerarquía real mediante TF. La antena WAM-V está 1,8 m sobre base_link; la de BlueROV2, 0,3 m. El enlace añade 0,001 kg.

El estado de referencia usa map y los enlaces del modelo. La estimación usa fcu_map y TF map → fcu_map → fcu_base_link. El primer enlace proyecta el origen geográfico EKF al datum del terreno; no se ajusta contra el estado real. Su traslación vertical se supone cero: conserva una aproximación barométrica local, no una altitud topográfica. El TF de montaje pertenece a la jerarquía de referencia; para levantamientos, aplica los mismos extrínsecos a la pose estimada y conserva los instantes de medición.

Magnitud Valor predeterminado
Coordenadas Latitud/longitud WGS 84 en grados; datum de las coordenadas esféricas del mundo.
Marco local ENU: este, norte, arriba; orientación del mundo 0°.
Ejes del cuerpo FLU; desplazamiento de antena convertido a FRD como x, −y, −z.
Velocidad Desplazamiento de antena entre adquisiciones, rotado a ENU; GPS_INPUT usa norte, este, abajo.
Brazo de palanca Se aplica antes de medir y se proporciona a ArduPilot como el mismo desplazamiento corporal.
Desviación de posición Este y norte: 0,7 m cada uno; vertical: 1,2 m.
Desviación de velocidad 0,1 m/s por eje.
Covarianza Diagonal ENU conocida: 0,49; 0,49; 1,44 m².
Frecuencia / latencia 5 Hz / 0,2 s de tiempo simulado.
Validez Rechaza duplicados, inversión temporal, valores no finitos, futuro y antigüedad superior a 0,6 s; vigilancia del avance del reloj de 0,8 s reales.
Tiempo Conserva adquisición durante el retraso; semana GPS determinista 2296 más tiempo simulado.
Calidad nominal 12 satélites, HDOP 1,0, VDOP 1,5; no calcula una constelación.
Aleatoriedad Semilla 42; errores gaussianos independientes de posición y velocidad.

El mundo predeterminado usa elevación marina 0 m y separación geoidal sintética cero. La altitud del sensor coincide con la altitud MSL de GPS_INPUT bajo ese supuesto. MAVROS aplica su conversión EGM96 al informar altitud elipsoidal, por lo que puede diferir del tema del sensor. La geodesia vertical absoluta no está validada para levantamientos. La profundidad se refiere al agua local. Una integración GNSS+IMU+profundidad para multihaz debe conservar marcos, tiempos y datum.

Inmersión, pérdida y recuperación

El receptor compara la altura mundial de la antena, incluida la rotación, con la superficie local. Los mundos de la aplicación usan el campo local del solucionador físico de olas con interpolación bilineal. Una muestra de superficie de más de 0,6 s simulados lo vuelve no disponible. Los modelos POSIM independientes usan el plano medio configurado salvo que reciban un tema de olas.

La aplicación retransmite celdas de ola medidas con sus marcas originales, de 0,2–0,5 segundos simulados de antigüedad. Las celdas ausentes siguen siendo inválidas; se exigen muestras locales finitas y se comprueba la inmersión de la antena.

La antena en la superficie o por debajo pierde la solución inmediatamente y vacía las mediciones pendientes. La adquisición comienza por encima de un margen seco de 0,05 m y exige 3 s simulados continuos. Con solución ya adquirida, sigue siendo válida dentro del margen seco hasta tocar el límite húmedo. Esta histéresis evita alternancias rápidas con las olas.

Sin solución, las coordenadas son NaN. El adaptador envía GPS_INPUT explícito sin posición válida y nunca renueva artificialmente la fecha de una coordenada antigua. Un reinicio vacía la cola, restablece adquisición, avanza la época del receptor y revalida el reloj.

La pérdida de fix submarino permite conservar control manual de actitud, profundidad y empuje para emerger. Las misiones absolutas requieren una estimación FCU válida y reciente basada en sensores. WAM-V necesita fix GNSS reciente o fuente externa cualificada y aceptada, además de los otros controles de armado.

El booleano Gazebo /model/{robot}/gnss/blocked impone una obstrucción. El viento no apaga GNSS directamente: puede mover e inclinar el vehículo o sumergir la antena mediante olas. Geometría satelital, edificios, multitrayecto, atmósfera, interferencia RF y patrones de antena no se simulan físicamente. Ruido gaussiano, obstrucción e inmersión son modelos simplificados, no rendimiento RF medido.

Equipamiento BlueROV2

El receptor seleccionable es una carga de simulación; no afirma que el BlueROV2 de serie lleve GNSS satelital ni que exista ese kit de integración del fabricante.

La integración Water Linked combina referencia geográfica de superficie y posicionamiento acústico submarino. También documenta DVL junto con UGPS. Son dispositivos y mediciones distintos: este receptor satelital no implementa UGPS acústico.

GPS.gov explica los factores que afectan a la precisión real. Las desviaciones de esta simulación son ajustes, no una garantía del servicio GPS. Los enlaces son referencias; el receptor no incluye imágenes de producto, manuales ni código de proveedores.

Posición de mapa basada en sensores

Ground Control usa una medida GNSS reciente o una estimación externa válida aceptada por la pasarela FCU; no sustituye coordenadas del simulador. GPS fixed aparece en verde y GPS lost en rojo, con estados desconocido, obsoleto e inválido separados. Fix y disponibilidad de navegación son independientes.

Con GPS fixed, solo aparece el indicador GPS. Con GPS lost y una estimación reciente y validada, también aparece Estimación de posición ON. Si se necesita una estimación submarina pero no está disponible, aparece Estimación no disponible. El botón de información junto a ON abre el método y un enlace a la documentación mediante clic, toque o teclado; Escape lo cierra. No se muestran coordenadas numéricas. Abra Detalles de navegación debajo del mapa para consultar el soporte, la referencia inicial y la inicialización de sensores.

El estimador IMU/DVL usa velocidad angular, fuerza específica y velocidad válida respecto al fondo, conservando tiempos, montajes y covarianza. No consume orientación de Gazebo. La odometría local no determina por sí sola posición geográfica ni rumbo.

La BlueROV2 · KMOU usa una coordenada inicial declarada por el escenario y rumbo medido por magnetómetro con declinación configurada. La referencia se distingue de GPS. Un soporte temporal mantiene el vehículo durante la preparación de cámaras y la inicialización estacionaria. Tras armado normal en ALT_HOLD y aceptación de navegación, se libera el soporte y se confirma la retirada real de la unión. No se actualiza continuamente la referencia con la verdad del simulador.

Este perfil se limita a esa demo integrada, no a vehículos guardados ni mundos arbitrarios. La alineación general mediante movimiento GNSS no está cualificada para salida geográfica. El diagnóstico local mantiene navigation_ready=false; la pasarela determina por separado la disponibilidad con datos recientes, origen/covarianza válidos, confirmación de selección de fuente y telemetría EKF/global de la FCU.

Pérdida DVL, datos obsoletos, reinicio o nuevo segmento invalidan la estimación. El mapa retira las coordenadas estimadas y muestra el fallo. Recuperar DVL no reutiliza el anclaje inicial: reinicie la simulación. Un nuevo fix al emerger puede devolver posición GNSS al mapa sin reinicializar el estimador submarino.

ArduPilot, QGC y proveedores intercambiables

GNSS alimenta GPS_INPUT y la fuente EKF 1. Posición/velocidad externas aceptadas usan MAVROS vision pose/speed y fuente 2. WAM-V con GNSS por defecto no activa una entrada de odometría visual sin uso. Un proveedor externo seleccionado explícitamente habilita la misma vía protegida en ambos vehículos.

QGC recibe validez GPS mediante GPS_RAW_INT y posición fusionada mediante GLOBAL_POSITION_INT. Puede indicar sin fix y disponer de una estimación FCU válida. La estimación no modifica el fix. La Controlar con QGC exige desarmar para ceder control; la flotabilidad puede hacer ascender al vehículo submarino.

Las extensiones de la app instalada seleccionan proveedores ROS aprobados, ligados a hashes y declarados en SDF. /vehicle/navigation/estimate transporta pose ENU y velocidad corporal FLU en nav_msgs/Odometry; /vehicle/navigation/status aporta sesión, tiempo, origen, metadatos de disponibilidad y fuente correspondientes. La pasarela rechaza datos obsoletos, incompatibles y publicadores duplicados. El receptor conserva autoridad sobre GNSS. Consulte Controlar un espacio de trabajo local. Cargar un proveedor no cualifica precisión geográfica ni disponibilidad de misión.

Buscar en la documentación