Composants et bibliothèques
WWW-POSIM associe des bibliothèques ouvertes de simulation et d’algorithmes à du code applicatif privé. L’ensemble fournit un espace de travail web, une application installée et des API de service.
Composition de WWW-POSIM
Composants ouverts
- POSIMMoteur, modèles marins et capteurs
- POSIM-TerrainTerrain géographique, maillages et images
- POSIM-RoutingNavigation et planification vérifiée
- POSIM-ControlPropulsion et politiques de mouvement
- POSIM-SLAMEstimation et cartographie par capteurs
Composants applicatifs privés
- Espace de travail et diffusionInterface, vues et vidéo
- Comptes et sessionsConnexion, droits, quotas et files
- Mondes et ressources enregistréesPréparation, bibliothèque de véhicules et stockage
- Coordination du voyageItinéraire, points de reprise et récupération
- Intégration de bureauLanceur, préparation du moteur et paquets
POSIM
POSIMPOSIM-Terrain
POSIM-TerrainPOSIM-Routing
POSIM-RoutingPOSIM-Control
POSIM-ControlPOSIM-SLAM
POSIM-SLAMWWW-POSIM
WWW-POSIM — Dépôt privé ; accès requis
L’application relie les bibliothèques aux comptes, aux espaces de travail persistants et aux interfaces utilisateur. Les capteurs et modes d’estimation disponibles dépendent du moteur et des fournisseurs installés.
Guides par composant
| Composant | Utilisation | Référence technique |
|---|---|---|
| Terrain | Générer le terrain d’un site | Algorithmes de génération du terrain |
| Planification et commande | Tour du monde en direct, Commander un espace de travail local | Planification des trajectoires et commande |
| Moteur et application | Prendre en main l’espace de travail, Personnaliser les mondes | Simulation, rendu et capteurs |
La bibliothèque de terrain produit données numériques, images et maillages. WWW-POSIM gère les tuiles résidentes, leur niveau de détail, la disponibilité des collisions et les caches de session. La publication d’une bibliothèque ne signifie pas que son capteur ou estimateur SLAM exécutable est installé sur l’hôte.
Le catalogue destiné à la recherche marine comprend Dynamique marine et rendu, Modèles et paramètres des capteurs, Algorithmes de génération du terrain, Planification des trajectoires et commande, Simulation, rendu et capteurs, Aperçu du sonar physique et GNSS et navigation. Chaque chapitre distingue modèle, configuration, sorties et limites d’interprétation.
Bibliothèques publiques
| Bibliothèque | Rôle |
|---|---|
| POSIM | Moteur de simulation, milieux marins, véhicules et capteurs sur Gazebo |
| POSIM-Terrain | Échantillonnage géographique Python, sélection de sources terrestres et marines, export maillages/SDF et textures |
| POSIM-Routing | Planificateurs Python globaux, côtiers et locaux ; dépend de POSIM-Terrain |
| POSIM-Control | Politiques de mouvement Python et plugins C++ de propulsion meneur/suiveur pour Gazebo |
| POSIM-SLAM | Bibliothèques indépendantes d’estimation visuelle, acoustique et inertielle ; les fonctions de l’application exigent les capteurs et fournisseurs adaptés |
POSIM-Terrain
Les sources disponibles d’altitude et de bathymétrie sont combinées pour construire le sol et le fond marin. Le champ numérique alimente le maillage et les vérifications de collision des trajets ; Sentinel-2 fournit la texture terrestre.
- Entrées : latitude, longitude, dimensions de région et échantillons de grille.
- Sorties : altitudes, maillages, SDF, textures et manifestes de provenance.
- Utilisation directe : générer une région ou charger un paquet urbain.
Le README de POSIM-Terrain présente installation, préparation des images satellites et export.
POSIM-Routing
La bibliothèque planifie l’itinéraire portuaire et l’accès à chaque zone d’arrivée. Les polygones terrestres OSM guident les liaisons. Les planificateurs côtiers et locaux vérifient le terrain représenté. Position du catalogue portuaire et cible d’arrivée sur l’eau constituent deux entrées distinctes.
- Entrées : départ, destination, portes de passage et terrain numérique.
- Sorties : routes globales, corridors côtiers et points de passage locaux.
- Utilisation directe : exporter une route maritime ou planifier sur un terrain généré.
Le README de POSIM-Routing fournit commandes et API. Une route globale ne suffit pas à établir la profondeur disponible.
POSIM-Control
Les modèles Gazebo reçoivent des forces de propulsion. Le meneur suit les points fournis ; le suiveur suit les poses mesurées du meneur. Les politiques Python observent le mouvement pour limiter la vitesse et évaluer stabilité, progression et récupération.
- Entrées : points vérifiés, vitesse demandée et état mesuré.
- Sorties : propulsion, état du contrôleur et décisions de mouvement.
- Utilisation directe : politiques Python ou compilation des plugins meneur/suiveur.
Le README de POSIM-Control détaille prérequis, compilation et topics. Les plugins natifs exigent les paquets de développement Gazebo dans un environnement POSIM préparé.
Chaque bibliothèque fournit des instructions en anglais et coréen, une structure des sources, l’installation et des tests. WWW-POSIM fixe leurs révisions comme sous-modules Git. Les adaptateurs importent ces implémentations et les paquets incluent les sources sélectionnées.
git submodule update --init --recursive
Chaîne de traitement et exemples urbains
POSIM-Terrain produit les données ; POSIM-Routing planifie et vérifie les trajets ; POSIM-Control suit les points approuvés pendant que Gazebo calcule le mouvement. WWW-POSIM observe le résultat et coordonne terrain, routes et commandes suivants. Comptes, propriété des sessions, vidéo, points de reprise du voyage et affichage AIS relèvent de l’application.
Web et application installée utilisent les mêmes révisions. Le guide des bibliothèques POSIM décrit modèles, capteurs et moteur.
Les exemples POSIM-Terrain couvrent New York, Busan et Tokyo, avec terre et mer :
- Région : 20 × 20 km.
- Grille : 257 × 257 sommets, espacés de 78.125 m.
- Sources : GEBCO 2026, Copernicus GLO-30 et bathymétrie régionale disponible.
- Fichiers : maillages, SDF, tableaux numériques, textures terrestres Sentinel-2 et manifestes.
- Chaque ville comprend des captures Gazebo et un README de régénération.
L’espacement de la grille de sortie n’améliore pas la précision des mesures sources. Voir Algorithmes de génération du terrain.
Le moteur natif Mac inclut une modification locale de Gazebo Sim Sensors sous Apache-2.0. Sources modifiées, recette de compilation, correctif, notice et licence sont conservés dans www-posim/sources/gz-sim-sensors-stop au sein du moteur. Le capteur GNSS de POSIM possède sa licence MIT et sa notice.