WWW-POSIM v0.6.16Documentation du simulateur
Menu de la documentation
WWW-POSIM / Documentation du simulateur

Simulation, rendu et capteurs

WWW-POSIM coordonne l’espace de travail. POSIM et Gazebo calculent physique et capteurs ; navigateur et visualiseurs affichent leurs résultats.

Chaîne de traitement

  1. 1. Vérifier le terrain et préparer la session

    Contrôle schéma, compatibilité moteur/bibliothèques et ressources. Transforme et valide la pose initiale ; prépare les SDF de monde et de véhicule propres à la session. Un nonce identifie l’exécution.

  2. 2. Démarrer Gazebo et le contrôleur

    Charge masses, inerties, collisions, articulations et systèmes environnementaux. Sélectionne ArduPilot, ROS 2 direct ou la commande du voyage automatique.

  3. 3. Commandes → intégration physique

    Applique actionneurs, flottabilité, hydrodynamique, vagues et contacts. Gazebo avance le temps et calcule pose et vitesse ; l’animation ne pilote pas la physique.

  4. 4. État → capteurs et ROS 2

    Produit les messages configurés et expose l’état via ponts et services. Caméras et LiDAR GPU dépendent toujours de Gazebo et de son environnement graphique.

  5. 5. Espace de travail et RViz

    Browser dessine terrain et état reçu ; Gazebo transmet les images du moteur. RViz Web ouvre Lichtblick avec connexion et disposition de session ; l’application lance RViz natif inclus.

  6. 6. Surveiller, étendre ou récupérer

    Suit séparément démarrage, topics/TF, images et progression. Charge du terrain vérifié en avant. Les déplacements d’origine transforment navigation et traces du suiveur en conservant les vitesses physiques.

Carte des technologies

Composant Responsabilité Catalogue
POSIM-Terrain et bibliothèques géographiques WGS 84, terrain projeté, rasters/côtes, maillages et provenance. Algorithmes de génération du terrain
Gazebo et Wave Sim Corps rigides, contacts, actionneurs, flottabilité, traînée et vagues périodiques. Dynamique marine et rendu
Capteurs POSIM et Gazebo Rendu, cinématique, acoustique, repères et validité. Modèles et paramètres des capteurs
POSIM-Routing et POSIM-Control Dégagement du terrain, planification bornée et propulsion native du voyage. Planification des trajectoires et commande
ArduPilot SITL et MAVROS Modes, estimations de navigation, conversion MAVLink/ROS et actionnement. GNSS et navigation · Commander un espace de travail local
Ogre2 et Three.js Rendu moteur/capteurs et rendu navigateur, respectivement. Même état, chemins d’images distincts. Dynamique marine et rendu
POSIM-SLAM Estimation/cartographie exigeant entrées, extrinsèques et fournisseur compatibles. Modèles et paramètres des capteurs · POSIM-SLAM
WWW-POSIM Comptes, sessions, assemblage, autorisations temporaires, tuiles, visualiseurs et distribution installée. Composants et bibliothèques

Les bibliothèques décrivent des implémentations réutilisables. Une configuration fonctionnelle exige aussi binaires des plugins, SDK compatible, composition du modèle et connexions de messages. Une sélection de capteurs ou une démonstration SLAM enregistrée ne prouve pas qu’un estimateur tourne dans tous les paquets.

Horloges, repères et identité

Contrat Interprétation
Temps simulé / réel Physique et acquisition utilisent le temps simulé. Admission, expiration des connexions et certains délais utilisent le temps réel. Consignez les deux pour mesurer débit ou retard.
Terrain map / corps FLU Terrain géographique projeté en mètres ; axes corporels avant/gauche/haut. Les extrinsèques situent les capteurs.
Caméra / FCU Axes optiques droite/bas/avant. ArduPilot convertit ENU/FLU en NED/FRD ; GNSS a une origine FCU séparée. Conservez les transformations au lieu de renommer les axes.
Session et configuration Nonce pour l’exécution ; manifestes capteurs, terrain et révisions de bibliothèques pour la configuration. Une nouvelle session exige topics et autorisations actuels.
Réinitialisation / origine flottante Un reset modifie la chronologie. Une translation d’origine change les coordonnées en conservant la vitesse physique. Les deux événements doivent être identifiables dans les journaux.
Vérité / observation / estimation Pose Gazebo comme référence ; caméra/GNSS/DVL comme mesures ; FCU/SLAM comme estimations. Conservez la provenance et n’évaluez pas un estimateur contre une vérité qu’il consomme directement.

Rendu et mesure

Three.js dessine la scène Browser. Ce choix ne déplace pas la génération des caméras ou du LiDAR GPU hors de Gazebo. Ogre2 rend la vue moteur et les capteurs fondés sur le rendu. LOD visuel, masques, position des lentilles, matériaux de l’eau et plans de coupe peuvent donc modifier les observations sans changer les collisions.

Géométrie des rayons sonar, couleur RGB et profondeur sont des sorties séparées. Les couches réservées au RGB peuvent être exclues de la géométrie acoustique. Un nuage affiché peut représenter une seule observation de rayons/profondeur ; son accumulation et la correction de pose exigent un processus de cartographie actif. Voir Aperçu du sonar physique.

Transport vidéo et capteurs

  1. Gazebo → mesures et images

    L’hôte moteur produit état physique, messages et pixels. Browser dessine séparément l’état reçu.

  2. Application → autorisation → passerelle

    Le site prépare l’accès compte/session et les adresses. Les données publiques viennent directement d’une autre origine du simulateur. Images privées et RViz utilisent des autorisations temporaires limitées si l’hôte annonce le transport direct.

  3. Visualiseur → tampon et âge → affichage

    La vidéo est mise en tampon ; les messages gardent horodatages et état de réception. Distinguez connexion et données périmées, puis vérifiez temps capteur et RTF physique.

Interface Format et comportement
Scènes Gazebo LIVE et démo Hong Kong HLS H.264 partagé ; segments courts directs du serveur multimédia et tampon de lecture.
RGB de la démo Hong Kong HLS H.264 partagé ; connexion affichée jusqu’au remplissage initial.
Scène et caméras personnelles Requêtes de trames JPEG. Accès direct limité sur hôtes compatibles ; service local pour l’application.
Caméra ROS compressée JPEG CompressedImage, jusqu’à 1 Hz simulé avec le connecteur standard, distinct du HLS.
RViz Web et visualiseurs externes Messages ROS par WebSocket. RViz Web est en lecture seule, avec limites par topic décrites dans Visualiser avec RViz et Foxglove.

Vercel peut servir l’interface et les courtes requêtes d’établissement de connexion. Les flux publics continus de vidéo et topics contournent ses fonctions. Le transport privé direct dépend des capacités annoncées par l’hôte. Gardez les adresses temporaires privées. Une image affichée ne mesure pas seule la latence de commande.

Encodage partagé et demande

LIVE est une diffusion en lecture seule. Chaque vue demandée possède un processus d’encodage partagé. Les requêtes renouvellent un bail de 5 s ; sans spectateur à son expiration, l’encodeur s’arrête. Les caméras de scène non regardées libèrent leurs abonnements Gazebo. Les photographies d’arrivée peuvent demander de brèves captures indépendantes. Physique, navigation et capteurs continuent.

Flux Cible vidéo
Scène, qualité basse 15 FPS, jusqu’à 640 × 360, 0,6 Mbit/s
Scène, qualité haute 15 FPS, jusqu’à 960 × 540, 1,2 Mbit/s
Caméra du véhicule choisi 5 FPS, jusqu’à 640 pixels de large, 0,4 Mbit/s
Vue sans spectateur Encodeur arrêté après expiration du bail de 5 s

Les deux qualités de scène sont produites une fois à partir des mêmes images et partagées. Le lecteur choisit selon la bande passante ; la qualité basse garde la cible de 15 FPS. Caméra du véhicule et démonstration interactive ont leurs propres réglages.

Tout le monde peut suivre la traversée LIVE depuis la page de connexion. La scène sélectionnée reste connectée tant qu’une partie de la traversée est visible, y compris les cartes et les données du véhicule. Le retour du plein écran conserve la connexion de la même scène. La mise en pause, le masquage ou la fermeture de l’onglet, ou l’ouverture de la démo en direct ou de l’espace de travail web arrête le flux de cette page. Une caméra de capteur ouverte et visible renouvelle sa propre connexion. La vidéo et les métadonnées proviennent directement du serveur. LIVE est accessible sans limite de spectateurs. La démo interactive est limitée à deux personnes.

Pendant le premier tampon, le navigateur affiche un JPEG de capture déjà en cache pour cette scène, obtenu directement du serveur. La requête vérifie le nonce du monde natif. Message et barre animée restent sous les indications de voyage, destination, RTF et vitesse. Changer de monde ou de vue abandonne l’aperçu ; une scène masquée suspend les requêtes. La première lecture vidéo retire l’image. Une interruption ultérieure garde la dernière trame décodée et indique la reconnexion.

Les abonnements de scène attendent une télémétrie native récente. Préparer le terrain n’exige pas d’activer les grandes caméras de scène. L’encodage est partagé, mais le trafic croît avec l’audience : 40 spectateurs regardant scène et caméra représentent 40–64 Mbit/s visés, hors surcoût réseau. Débit montant et rendu du serveur déterminent la capacité pratique. Le nombre de spectateurs ne réduit pas à lui seul la cible FPS.

Tampons et fréquence réelle

LIVE démarre à 3 s du bord direct HLS ; un blocage peut porter cette cible à 12 s. Un nouveau flux est prêt après deux segments de 2 s et le calibrage de l’horloge de capture : environ 4 s, plus le démarrage de la capture et de l’encodeur. La démonstration interactive démarre aussi à 3 s. Les instruments et les caméras suivent l’horloge de présentation ; le délai total inclut l’encodage et la disponibilité des segments.

Instruments et caméras suivent l’horloge de présentation vidéo. Le délai capture-écran inclut aussi encodage et disponibilité des segments ; la cible du tampon ne mesure pas le délai total.

L’acquisition suit le temps simulé. Faible RTF et interruptions réduisent les images distinctes par seconde réelle. Les métadonnées source_fps, source_frames et max_source_gap_seconds proviennent des soumissions source. Un décodeur à 15 FPS peut répéter des images : il ne prouve pas 15 captures distinctes par seconde.

Interprétation et responsabilités

Terrain prêt, session active et caméra récente sont des états distincts. Actualiser l’imagerie en arrière-plan ne réécrit pas les collisions en cours. Les altitudes du maillage gouvernent les contacts ; satellite, sable, eau et carte sont des couches visuelles. RTF compare temps simulé et réel.

WWW-POSIM gère sessions, transport et lancement des visualiseurs ; Terrain, Routing et Control leurs algorithmes. Guide du moteur et des bibliothèques POSIM.

Composants et bibliothèques · Algorithmes de génération du terrain · Planification des trajectoires et commande · Personnaliser les mondes · Aperçu du sonar physique

Rechercher dans la documentation