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
- POSIMMotor, modelos marinos y sensores
- POSIM-TerrainTerreno geográfico, mallas e imágenes
- POSIM-RoutingNavegación y planificación comprobada
- POSIM-ControlPropulsión y políticas de movimiento
- POSIM-SLAMEstimación y cartografía a partir de sensores
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
POSIM
POSIMPOSIM-Terrain
POSIM-TerrainPOSIM-Routing
POSIM-RoutingPOSIM-Control
POSIM-ControlPOSIM-SLAM
POSIM-SLAMWWW-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.
- Entradas: latitud, longitud, tamaño de región y muestras de rejilla.
- Salidas: elevaciones, mallas, SDF, texturas y manifiestos de procedencia.
- Uso directo: generar una región o cargar un paquete urbano.
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.
- Entradas: origen, destino, puertas de paso y terreno numérico.
- Salidas: rutas globales, corredores costeros y puntos de paso locales.
- Uso directo: exportar una ruta marítima o planificar sobre un terreno generado.
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.
- Entradas: puntos comprobados, velocidad solicitada y estado medido.
- Salidas: propulsión, estado del controlador y decisiones de movimiento.
- Uso directo: políticas Python o compilación de plugins líder/seguidor.
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:
- Región: 20 × 20 km.
- Rejilla: 257 × 257 vértices, separados 78.125 m.
- Fuentes: GEBCO 2026, Copernicus GLO-30 y batimetría regional disponible.
- Archivos: mallas, SDF, matrices numéricas, texturas terrestres Sentinel-2 y manifiestos.
- Cada ciudad incluye capturas Gazebo y un README para regenerarla.
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.