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

Simulación, renderizado y sensores

WWW-POSIM coordina el espacio de trabajo. POSIM y Gazebo calculan física y sensores; el navegador y los visores muestran sus resultados.

Flujo de procesamiento

  1. 1. Verificar terreno y preparar sesión

    Comprueba esquema, compatibilidad de motor/bibliotecas y recursos. Transforma y valida la posición inicial; prepara SDF de mundo y vehículo para esa sesión. Un nonce identifica la ejecución.

  2. 2. Iniciar Gazebo y el controlador

    Carga masas, inercias, colisiones, articulaciones y sistemas ambientales. Selecciona ArduPilot, ROS 2 directo o el control de la travesía automática.

  3. 3. Órdenes → integración física

    Aplica fuerzas de actuadores, flotabilidad, hidrodinámica, olas y contactos. Gazebo avanza el tiempo y calcula pose y velocidad; la animación no mueve la física.

  4. 4. Estado → sensores y ROS 2

    Genera los mensajes configurados y expone el estado mediante puentes y servicios. Cámaras y LiDAR GPU siguen necesitando Gazebo y su entorno gráfico.

  5. 5. Espacio de trabajo y RViz

    Browser dibuja terreno y estado recibido. Gazebo entrega imágenes del motor. RViz Web abre Lichtblick con conexión y disposición de la sesión; la aplicación abre RViz nativo incluido.

  6. 6. Supervisar, ampliar cobertura o recuperar

    Controla por separado inicio, temas/TF, imágenes y progreso. Carga terreno verificado por delante. Los cambios de origen transforman navegación y trayectorias de seguimiento conservando velocidades físicas.

Mapa de tecnologías

Componente Responsabilidad Catálogo
POSIM-Terrain y bibliotecas geográficas WGS 84, proyección numérica, ráster/costa, mallas y procedencia. Algoritmos de generación del terreno
Gazebo y Wave Sim Cuerpos rígidos, contactos, actuadores, flotabilidad, arrastre y olas periódicas. Dinámica marina y renderizado
Sensores POSIM y Gazebo Renderizado, cinemática, acústica, marcos y validez. Modelos y parámetros de sensores
POSIM-Routing y POSIM-Control Márgenes de terreno, planificación acotada y control nativo de la travesía. Planificación de rutas y control
ArduPilot SITL y MAVROS Modos, estimaciones de navegación, conversión MAVLink/ROS y actuación. GNSS y navegación · Controlar un espacio de trabajo local
Ogre2 y Three.js Renderizado del motor/sensores y del navegador, respectivamente. Comparten estado, no la misma vía de imágenes. Dinámica marina y renderizado
POSIM-SLAM Estimación y cartografía que requieren entradas, extrínsecos y proveedor compatibles. Modelos y parámetros de sensores · POSIM-SLAM
WWW-POSIM Cuentas, sesiones, ensamblaje, permisos temporales, ciclo de teselas, visores y distribución instalada. Componentes y bibliotecas

Las bibliotecas describen implementaciones reutilizables. Una configuración ejecutable también necesita binarios de plugins, SDK compatible, composición de modelo y conexiones de mensajes. Seleccionar sensores o disponer de una grabación SLAM no demuestra que el estimador esté ejecutándose en todos los paquetes.

Relojes, marcos e identidad

Contrato Interpretación
Tiempo simulado / real Física y adquisición usan tiempo simulado. Admisión, caducidad de conexión y algunos temporizadores usan tiempo real. Registra ambos para analizar rendimiento o retrasos.
Terreno map / cuerpo FLU Terreno geográfico proyectado a metros; ejes corporales delante/izquierda/arriba. Los extrínsecos sitúan cada sensor.
Cámara / FCU Ejes ópticos derecha/abajo/delante. ArduPilot convierte ENU/FLU a NED/FRD; GNSS usa un origen FCU separado. Conserva las transformaciones, no cambies solo las etiquetas.
Sesión y configuración Nonce para cada ejecución; manifiestos de sensores, identidad del terreno y revisiones de bibliotecas para la configuración. Una sesión nueva necesita sus temas y permisos actuales.
Reinicio / origen flotante Reiniciar cambia la línea temporal. Trasladar el origen cambia coordenadas, conservando velocidad física. Ambos eventos deben identificarse en los registros.
Referencia / observación / estimación Pose Gazebo como referencia; cámara/GNSS/DVL como medidas; FCU/SLAM como estimaciones. Conserva procedencia y no evalúes un estimador contra una referencia que consume directamente como verdad.

Renderizado y medición

Three.js dibuja la escena Browser. Elegirla no traslada fuera de Gazebo la generación de cámaras o LiDAR GPU. Ogre2 dibuja la vista del motor y sus sensores de renderizado. LOD visual, máscaras, posición de lentes, materiales del agua y recorte pueden cambiar las observaciones aunque la colisión siga igual.

Geometría de rayos sonar, color RGB y profundidad son salidas independientes. Las capas exclusivas de RGB pueden excluirse de la geometría acústica. Una nube visible puede representar una sola observación de rayos o profundidad; acumularla y corregir poses requiere un proceso de cartografía en ejecución. Véase Vista previa del sonar físico.

Transporte de vídeo y sensores

  1. Gazebo → mediciones e imágenes

    El equipo del motor produce estado físico, mensajes y píxeles. La escena Browser dibuja por separado el estado recibido.

  2. Aplicación → permiso → pasarela

    La web prepara acceso de cuenta/sesión y direcciones. El contenido público viaja directamente desde otro origen del simulador. Imágenes privadas y RViz usan permisos temporales acotados cuando el servidor anuncia transporte directo.

  3. Visor → búfer y antigüedad → pantalla

    El vídeo tiene un búfer; los mensajes conservan tiempos y estado de recepción. Distingue conexión de datos obsoletos y comprueba tiempo del sensor y RTF físico.

Interfaz Formato y comportamiento
Escenas Gazebo de LIVE y demo Hong Kong HLS H.264 compartido; segmentos cortos directos del servidor multimedia y búfer de reproducción.
RGB de la demo Hong Kong HLS H.264 compartido; muestra conexión hasta preparar el búfer inicial.
Escena y cámaras personales Solicitudes de fotogramas JPEG. Servidores compatibles usan acceso directo acotado; la app, su servicio local.
Cámara ROS comprimida JPEG CompressedImage, máximo 1 Hz simulado con el conector estándar, separado de HLS.
RViz Web y visores ROS externos Mensajes ROS por WebSocket. RViz Web es de solo lectura con límites por tema, descritos en Visualización con RViz y Foxglove.

Vercel puede servir la interfaz y peticiones breves de conexión. Los flujos continuos públicos de vídeo y temas evitan sus funciones. El transporte privado directo depende de las capacidades anunciadas por el servidor. Mantén privadas las direcciones temporales. Un fotograma visible no mide por sí solo la latencia de control.

Codificación compartida y demanda

LIVE es una difusión de solo lectura. Cada vista solicitada tiene un proceso de codificación compartido. Las peticiones renuevan una concesión de 5 s; al caducar sin espectadores, se apaga el codificador. Las cámaras de escena no observadas liberan suscripciones Gazebo. Las fotografías de llegada pueden pedir capturas breves por separado. Física, navegación y sensores continúan.

Flujo Objetivo de vídeo
Escena, calidad baja 15 FPS, hasta 640 × 360, 0,6 Mbit/s
Escena, calidad alta 15 FPS, hasta 960 × 540, 1,2 Mbit/s
Cámara de vehículo elegida 5 FPS, hasta 640 píxeles de ancho, 0,4 Mbit/s
Vista sin espectadores Codificador apagado al caducar los 5 s

Las dos calidades de escena se generan una vez a partir de los mismos fotogramas y se comparten entre espectadores. El reproductor elige según ancho de banda; la baja conserva el objetivo de 15 FPS. Cámara del vehículo y demo interactiva tienen ajustes propios.

Cualquiera puede ver la travesía LIVE desde la página de inicio de sesión. La escena seleccionada sigue conectada mientras se vea una parte de la vista de la travesía, incluidos los mapas y los datos del vehículo. Al volver desde la pantalla completa, se mantiene la conexión de la misma escena. Pausar la reproducción, ocultar o cerrar la pestaña, o abrir la demo en directo o el espacio de trabajo web detiene la transmisión de esta página. Una cámara de sensores abierta y visible renueva su propia conexión. El vídeo y los metadatos llegan directamente del servidor. LIVE no tiene cupo de espectadores. La demo interactiva tiene un límite independiente de dos personas.

Durante el primer búfer, el navegador muestra un JPEG de la captura ya almacenada para esa escena, obtenido directamente del servidor. La solicitud comprueba el nonce del mundo nativo. El mensaje y la barra animada quedan debajo del estado de viaje, destino, RTF y velocidad. Cambiar mundo o vista descarta el previo; escenas ocultas suspenden solicitudes. El primer vídeo reproducido retira la imagen. Una interrupción posterior conserva el último fotograma decodificado y muestra reconexión.

Las suscripciones de escena esperan telemetría nativa reciente. Preparar terreno no requiere activar las cámaras de escena de tamaño completo. Aunque la codificación se comparte, el tráfico crece con la audiencia: 40 espectadores con escena y cámara suman 40–64 Mbit/s objetivo, antes de sobrecarga. La subida del servidor y el renderizado determinan capacidad real. El número de espectadores no reduce por sí solo el FPS objetivo.

Búferes y frecuencia real

LIVE empieza a 3 s del extremo en directo de HLS; una interrupción puede aumentarlo hasta 12 s. Un flujo nuevo se anuncia listo con dos segmentos de 2 s y el reloj de captura calibrado: unos 4 s más captura e inicio del codificador. La demo interactiva también empieza con 3 s. Los instrumentos y las cámaras siguen el reloj de presentación del vídeo; el retraso total incluye codificación y disponibilidad de segmentos.

Instrumentos y cámaras siguen el reloj de presentación del vídeo. El retraso captura-pantalla también incluye codificación y disponibilidad de segmentos; el búfer objetivo no mide ese retraso total.

La adquisición usa tiempo simulado. Un RTF bajo o interrupciones de captura reducen los fotogramas distintos por segundo real. Los metadatos source_fps, source_frames y max_source_gap_seconds proceden de entregas de origen. Un decodificador a 15 FPS puede repetir imágenes; no prueba 15 capturas diferentes cada segundo.

Interpretación y responsables

Terreno listo, sesión en marcha y cámara reciente son estados distintos. Actualizar imágenes en segundo plano no reescribe las colisiones activas. La elevación de malla determina contactos; satélite, arena, agua y mapas son capas visuales. RTF compara tiempo simulado y real.

WWW-POSIM mantiene sesiones, transporte y apertura de visores; Terrain, Routing y Control mantienen sus algoritmos. Guía del motor y las bibliotecas POSIM.

Componentes y bibliotecas · Algoritmos de generación del terreno · Planificación de rutas y control · Personalizar los mundos · Vista previa del sonar físico

Buscar en la documentación