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

Componentes y bibliotecas

WWW-POSIM combina bibliotecas abiertas de simulación y algoritmos con código privado de aplicación. Ofrece un espacio de trabajo web, una aplicación instalada y API de servicio.

Cómo se compone WWW-POSIM

Componentes abiertos

Componentes privados de aplicación

  • Espacio de trabajo y entregaInterfaz, vistas y vídeo
  • Cuentas y sesionesAcceso, permisos, tiempo y colas
  • Mundos y recursos guardadosPreparación, biblioteca de vehículos y almacenamiento
  • Coordinación de la travesíaItinerario, puntos de recuperación y continuidad
  • Integración de escritorioLanzador, preparación del motor y paquetes
WWW-POSIMAplicación y API

Web · Aplicación instalada · API

Los componentes abiertos y el código privado forman WWW-POSIM. SLAM depende de los sensores y proveedores instalados.
  1. POSIM

    POSIM
  2. POSIM-Terrain

    POSIM-Terrain
  3. POSIM-Routing

    POSIM-Routing
  4. POSIM-Control

    POSIM-Control
  5. POSIM-SLAM

    POSIM-SLAM
  6. WWW-POSIM

    WWW-POSIM — Repositorio privado; requiere acceso

La aplicación conecta las bibliotecas con cuentas, espacios de trabajo persistentes e interfaces de usuario. Los sensores y modos de estimación disponibles dependen del motor y de los proveedores instalados.

Guías por componente

Componente Uso Referencia técnica
Terreno Generar el terreno de una zona Algoritmos de generación del terreno
Planificación y control Travesía mundial en directo, Controlar un espacio de trabajo local Planificación de rutas y control
Motor y aplicación Conocer el espacio de trabajo, Personalizar los mundos Simulación, renderizado y sensores

La biblioteca de terreno genera datos numéricos, imágenes y mallas. WWW-POSIM gestiona qué teselas permanecen cargadas, su nivel de detalle, las colisiones listas y las cachés de sesión. Que una biblioteca sea pública no significa que el host tenga instalado su sensor o estimador SLAM ejecutable.

El catálogo técnico para investigación marina incluye Dinámica marina y renderizado, Modelos y parámetros de sensores, Algoritmos de generación del terreno, Planificación de rutas y control, Simulación, renderizado y sensores, Vista previa del sonar físico y GNSS y navegación. Cada capítulo distingue modelo, configuración, salidas y límites de interpretación.

Bibliotecas públicas

Biblioteca Función
POSIM Motor de simulación, entornos marinos, vehículos y sensores sobre Gazebo
POSIM-Terrain Muestreo geográfico Python, selección de fuentes terrestres y marinas, exportación de mallas/SDF y texturas
POSIM-Routing Planificadores Python globales, costeros y locales; depende de POSIM-Terrain
POSIM-Control Políticas Python de movimiento y plugins C++ de propulsión líder/seguidor para Gazebo
POSIM-SLAM Bibliotecas independientes de estimación visual, acústica e inercial; requieren sensores y proveedores compatibles en la aplicación

POSIM-Terrain

Combina las fuentes disponibles de elevación y batimetría para construir tierra y fondo marino. El campo numérico alimenta la malla y la comprobación de colisiones de ruta; Sentinel-2 aporta la textura terrestre.

El README de POSIM-Terrain explica instalación, preparación de imágenes satelitales y exportación.

POSIM-Routing

Planifica el itinerario de puertos y el acceso a cada zona de llegada. Los polígonos terrestres OSM guían las conexiones. Los planificadores costero y local comprueban el terreno representado. La posición del catálogo portuario y el objetivo de llegada sobre el agua son entradas distintas.

El README de POSIM-Routing incluye comandos y API. Una ruta global por sí sola no establece la profundidad disponible.

POSIM-Control

Aplica propulsión a modelos Gazebo. El líder sigue puntos de paso y el seguidor sigue poses medidas del líder. Las políticas Python observan el movimiento para limitar velocidad y evaluar estabilidad, avance y recuperación.

El README de POSIM-Control detalla requisitos, compilación y temas de control. Los plugins nativos necesitan paquetes de desarrollo Gazebo en un entorno POSIM preparado.

Cada biblioteca incluye instrucciones en inglés y coreano, estructura del código, instalación y pruebas. WWW-POSIM fija sus revisiones como submódulos Git; los adaptadores importan esas implementaciones y los paquetes incluyen sus fuentes seleccionadas.

git submodule update --init --recursive

Flujo conjunto y ejemplos urbanos

POSIM-Terrain genera datos; POSIM-Routing comprueba y planifica rutas; POSIM-Control sigue puntos aprobados mientras Gazebo calcula el movimiento. WWW-POSIM observa el resultado y coordina los siguientes terrenos, rutas y órdenes. Cuentas, propiedad de sesiones, vídeo, puntos de recuperación del viaje y AIS pertenecen a la aplicación.

Web y aplicación instalada usan las mismas revisiones. La guía de bibliotecas POSIM describe modelos, sensores y motor.

Los ejemplos de POSIM-Terrain incluyen Nueva York, Busan y Tokio, con tierra y océano:

La separación de la rejilla de salida no mejora la precisión de las mediciones originales. Consulta Algoritmos de generación del terreno.

El motor nativo de Mac incluye una modificación local del componente Gazebo Sim Sensors, con licencia Apache-2.0. Fuentes modificadas, receta de compilación, parche, aviso y licencia están en www-posim/sources/gz-sim-sensors-stop dentro del motor. El sensor GNSS de POSIM conserva su licencia MIT y su aviso.

Buscar en la documentación