Prendre en main l’espace de travail
Commencez avec un terrain préparé, puis repérez les panneaux et les instruments avant d’envoyer des commandes au véhicule.
Se connecter et ouvrir un premier monde
- Créez un compte sur WWW-POSIM, vérifiez votre adresse e-mail et connectez-vous. Consultez les courriers indésirables ou demandez un autre message si nécessaire. La vérification est aussi requise dans l’application installée.
- Dans l’application, choisissez Démarrer le simulateur. Sur le site, ouvrez votre espace personnel ; l’accès au serveur peut nécessiter une attente.
- Ouvrez Espace de travail, choisissez Terrain prégénéré, puis KMOU waterfront · 1 × 1 km.
- Dans Terrain régional → Véhicule, sélectionnez WAM-V, une profondeur de 0 m et Autopilot.
- Choisissez Lancer le monde généré et attendez le véhicule ainsi que des données de position récentes. La fenêtre initiale de l’application reste ouverte jusqu’au démarrage effectif.

| Entrée | Fonction |
|---|---|
| Démonstrations | Lance WAM-V ou BlueROV2 ; les autres aperçus indiquent leur disponibilité. |
| Terrain prégénéré | Regroupe les terrains prêts, téléchargeables et déjà générés. |
| Zone d’entraînement | Prépare l’exercice lorsqu’il est disponible. |
| Monde personnalisé | Donne accès au terrain régional, à l’éditeur de véhicules, aux outils RViz et au stockage. |
| Emplacement → Véhicule → Vérification | Sélectionne le terrain, le véhicule et sa pose initiale, puis vérifie les réglages avant le lancement. |
Choisissez Autopilot ou ROS 2 direct avant de lancer le monde. Pour changer de type de commande, démarrez un monde avec l’autre option. Changer le mode ArduPilot est une action distincte. Respectez les limites des coordonnées et de profondeur. La graine d’entraînement accepte un entier de 0 à 1 000 000 ; un champ vide produit une disposition automatique. L’exploration libre et les exécutions de référence administrateur ignorent cette graine.
L’application Mac télécharge un terrain préparé lors de sa première sélection et affiche la progression. Il reste ensuite disponible hors ligne avec sa révision de contenu fixée. En cas d’échec, vérifiez la connexion puis sélectionnez-le à nouveau. L’exemple WAM-V se déroule à Hong Kong : une bouée corail se trouve 16 m devant et 5 m à gauche, et une bouée vert citron, 30 m devant et 8 m à droite. Observez-les avec la caméra avant et le LiDAR.
Repérer les zones de l’interface

| Zone | Contenu |
|---|---|
| Barre supérieure | Véhicule, terrain, état en direct, espace de travail, langue et commandes d’agrandissement de la scène et d’affichage des panneaux. La session apparaît lorsque le temps d’utilisation est suivi. |
| Centre | Scène avec vues du véhicule, du monde et de la carte. |
| Gauche | Environnement et affichage dans Scène ; mesures dans Capteurs et les topics ROS. |
| Droite | Commandes ArduPilot ou ROS 2, puis instruments et graphiques du véhicule. |
| Carte inférieure | Position géographique, points de passage et commandes de mission dans Contrôle au sol. |
Dépliez les en-têtes ou leurs boutons + / −. Le contenu défile dans la hauteur disponible ; une autre section peut se replier pour laisser de la place. Panneaux masque ou affiche les panneaux. Vue dégagée agrandit la scène tout en laissant la carte accessible. La simulation continue. L’écran d’entrée permet aussi de revenir à la page principale et de se déconnecter.
| Vue ou action | Effet |
|---|---|
| Véhicule | Suit le véhicule ; permet de tourner autour et de zoomer. |
| Monde | Vue oblique de l’environnement proche, avec limites de zoom et de rotation. |
| Carte | Carte orientée au nord avec position simulée ; faites glisser pour la déplacer. |
| Glisser, bouton droit et molette | Déplacement, rotation ou zoom selon les indications de la vue. |
| Effacer la trace | Efface la route prévue et la trajectoire affichée. L’enregistrement reprend à la position actuelle et le rapport de mission est conservé. |
La boussole inférieure suit la caméra d’observation, pas le cap du véhicule. La flèche fixe indique l’avant de la caméra et les lettres tournent pour situer le nord. Le temps affiché est le temps simulé. 1,00× signifie qu’il avance au rythme du temps réel.
La route prévue est jaune et la trajectoire mesurée, bleu-vert. L’affichage garde au maximum 1 024 segments. Une nouvelle mission guidée efface la trace Gazebo. Les lignes de scène de 5 mm n’apparaissent pas dans les images des capteurs.
Scène, vagues et courant

| Section | Utilisation |
|---|---|
| Vagues | Choisissez un état de mer de 0 à 4, puis appliquez. Les réglages avancés donnent accès au vent, à sa direction et à la cambrure. |
| Courant marin | Activez le courant, choisissez un écoulement uniforme ou un profil de profondeur, puis Appliquer le courant. Attendez la confirmation du solveur. |
| Trafic maritime | Affiche des navires à partir de rapports AIS récents ; dépend de la couverture et de la vitesse de simulation. |
| Rendu de la scène | Choisit Browser ou Gazebo lorsque ces options sont disponibles et donne accès aux effets sous-marins. |
| Affichage | Fond, surface, grille et axes ; éclairage et opacité de l’eau ou de la carte selon la vue. |
| Performances graphiques | Statistiques mesurées du rendu dans le navigateur. |
Les espaces libres démarrent avec un état de mer 2. Les préréglages utilisent des vents de 0, 1, 3, 6 et 8 m/s, avec une cambrure de 1. Ce sont des approximations, pas des hauteurs de vagues garanties. Le bouton d’information présente les plages WMO. Les exercices conservent leurs conditions imposées.
Arrêtez la mission ou la commande ROS avant de modifier le courant. Le profil accepte huit nœuds au maximum, commence à 0 m de profondeur et couvre 0–1 m/s. Déplacez les nœuds horizontalement pour régler la vitesse ; le tableau permet de modifier profondeur et direction. 0° désigne l’est et 90° le nord, dans le sens de l’écoulement. Les vecteurs sont interpolés linéairement à la profondeur réelle de chaque lien à chaque pas physique. Sous le dernier nœud, son courant est conservé. Le courant modifie la traînée relative à l’eau ; les vagues gardent leur propre modèle.
L’application installée ouvre Gazebo par défaut. Browser réduit la charge de la caméra de scène Gazebo ; physique, caméras et LiDAR GPU restent calculés dans Gazebo. Le choix dure tant que cette vue est ouverte. La caméra de suivi BlueROV2 adoucit les mouvements et montre la surface. Un glissement vertical dans les vues compatibles permet de regarder depuis le dessous.
Apparence sous-marine
Ouvrez Scène → Rendu de la scène → Apparence sous-marine. Les changements s’appliquent à la scène Gazebo et aux images couleur des caméras, y compris RGBD. Les mesures de profondeur et la géométrie de collision conservent leurs valeurs.
- Texture de sable, brume, absorption des couleurs, atténuation solaire et motifs lumineux sur le fond : activés initialement.
- Grille, courbes de niveau et particules : désactivés ; espacements par défaut de 10 m pour la grille et de 5 m pour les courbes.
- La démo BlueROV2 KMOU démarre avec les particules en suspension activées et l’atténuation solaire selon la profondeur désactivée. Les réglages enregistrés dans l’application installée ont priorité sur ces valeurs par défaut de la démo.
- L’optique de l’eau regroupe les effets optiques ; texture et lignes restent indépendantes.
- L’application installée conserve les réglages confirmés. Les sessions hébergées démarrent avec les valeurs par défaut. Ces réglages sont verrouillés pendant une évaluation.
Gazebo affiche l’ensemble des effets ; Browser reprend le détail du sable et les lignes du fond. Le modèle visuel utilise un niveau moyen de mer plan et des surfaces PBR. Les matériaux non éclairés et les shaders d’eau personnalisés ont leur propre rendu. Particules et motifs lumineux sont des approximations visuelles. Brume, atténuation et occultation limitent la visibilité utile au-delà du simple plan de coupe géométrique. Consultez Caractéristiques techniques et Dynamique marine et rendu.
Capteurs et topics ROS

Dans Capteurs, sélectionnez le véhicule puis une caméra, un LiDAR ou une IMU. La liste dépend du modèle. La caméra d’inspection orientée vers le bas permet d’examiner le fond.
| Commande | Action |
|---|---|
| Démarrer/arrêter le flux | Agit sur la réception de cette image ; la simulation continue. |
| Agrandir / Enregistrer l’image | Agrandit l’image ou enregistre la trame reçue. |
| Fréquence du capteur | Demande une fréquence de livraison ; l’indicateur mesuré donne la réception réelle. |
| Zoom numérique / Réinitialiser | Agrandit l’image reçue ou rétablit son échelle. |
| Topics ROS → recherche → topic | Ouvre le message ; l’abonnement contrôle sa réception. |
| Champ / Graphique / Données brutes / Dessiner | Affiche des champs numériques ou des messages spatiaux compatibles selon le type et le repère. |
La caméra de scène est un observateur extérieur. La caméra du capteur suit sa pose sur le véhicule ; leurs directions peuvent être différentes.
États du flux
Connexion ou En attente signifie que le capteur ou le transport se prépare. Vérifiez l’heure de réception. Une image conservée signalée comme périmée ou en reconnexion n’est pas une mesure récente. Vérifiez d’abord que le monde est prêt et que le bon capteur est sélectionné.
La démonstration publique de Hong Kong utilise une vidéo H.264 partagée avec un tampon initial. Les caméras personnelles demandent des images JPEG ; les images ROS compressées suivent un autre chemin. L’enregistrement capture la vidéo affichée dans la démonstration, et le fichier image reçu dans un espace personnel. Fréquence du capteur, FPS vidéo et facteur de temps réel sont des mesures différentes. Consultez Simulation, rendu et capteurs et Visualiser avec RViz et Foxglove.
ArduPilot et commande manuelle


Vérifiez la télémétrie, l’armement et le mode indiqué dans l’en-tête. Centrez les entrées manuelles et terminez ou annulez la mission avant de changer de mode. Choisissez Mode de vol, appliquez, puis contrôlez la valeur reçue : la liste déroulante exprime une demande.
Armer active la propulsion après les vérifications préalables. Désarmer la désactive et annule la mission. Le choix d’un mode n’arme pas le véhicule. En cas de refus, lisez l’erreur et les détails de connexion ; une image de caméra ne confirme pas à elle seule que les commandes sont prêtes.
| Véhicule | Modes du menu |
|---|---|
| WAM-V · ArduRover | MANUAL : accélération et direction directes. HOLD : propulsion neutre, avec dérive possible due à l’inertie, aux vagues ou au courant. STEERING : vitesse et virage assistés. |
| BlueROV2 · ArduSub | MANUAL : commande directe. STABILIZE : stabilise l’attitude, profondeur manuelle. ALT_HOLD : ajoute le maintien de profondeur, sans maintien de position horizontale. |
Une mission vérifiée demande GUIDED et arme le contrôleur pendant son démarrage. Ce mode est géré par la mission, pas par le menu manuel. Voir Missions avec pilote automatique.

Activez l’entrée joystick et choisissez souris/tactile ou manette. WAM-V propose accélération et direction ; BlueROV2 ajoute les axes latéral et vertical. Commencez avec les commandes centrées et un faible gain. Arrêter la commande annule l’appui en cours ; relâchez puis appuyez à nouveau pour reprendre. Perte de focus, désarmement, changement de source ou commande refusée terminent aussi cet appui.
À la manette, maintenez LB/L1 pendant les commandes. Relâcher envoie une entrée neutre ; cela ne désarme pas et n’arrête pas instantanément un véhicule en mouvement. Sur BlueROV2, Y/Triangle demande ALT_HOLD et A/Croix, STABILIZE. Vérifiez le mode reçu. Les affectations complètes figurent dans Commande manuelle et manette.
Carte et missions
Les nouveaux points sous-marins commencent à 2 m. La plage normale est de 0–10 m ; pour les scènes d’inspection compatibles, consultez la Limites de profondeur des missions affichée par le serveur.

Complétez coordonnées et profondeur avant de vérifier la route. Les points de surface utilisent 0 m et chaque point de la carte marque une attente d’une seconde. Les champs vides restent vides pendant la saisie.
| Action | Effet |
|---|---|
| Clic / clic droit | Ajoute un point / supprime un point proche. Glissement, molette ou pincement déplacent et agrandissent la carte. |
| Retour au départ / Effacer | Définit le retour / efface les points modifiables. |
| Vérifier le trajet | Calcule un aperçu vérifié contre le terrain. Examinez trajet, marge et blocages. |
| Suivre le trajet | Lance la route vérifiée et arme après les contrôles. |
| Arrêter / Continuer / Annuler | Maintient une cible d’attente / reprend / annule et désarme. |
Vérifiez de nouveau avant une autre exécution, car le véhicule peut avoir bougé. Les points de la carte priment sur les scénarios prédéfinis ; effacez-les pour utiliser un scénario. La vérification évalue terrain et dégagement de coque, sans garantir l’évitement des navires mobiles ni le respect du COLREG. Voir Missions avec pilote automatique.
Instruments du véhicule

Le repère bleu fixe représente le véhicule. L’horizon mobile indique roulis et tangage. Le cap utilise 0° nord, 90° est, 180° sud et 270° ouest. La profondeur vaut −Z par rapport au niveau zéro de la mer : positive dessous, négative dessus. Elle diffère de la hauteur au-dessus du fond.
Le graphique conserve les 100 dernières poses reçues. Choisissez profondeur, cap, tangage, roulis, vitesse ou poussée demandée. Profondeur, attitude et vitesse proviennent du simulateur. La vitesse affiche X vers l’avant, Y vers la gauche et Z vers le haut, en m/s. La poussée représente des commandes en newtons, pas une force mesurée. Les données absentes ou périmées laissent des trous ou —. Profondeur et attitude partagent la même acquisition ; la démonstration les aligne sur la vidéo.
Vitesse et pas physique
Un choix est envoyé immédiatement ; attendez sa confirmation.
| Réglage | Valeurs |
|---|---|
| Vitesse demandée | 0,25×, 0,5×, 1×, 2× et 4× |
| Pas physique | 5, 10 ou 20 ms ; 30 ms apparaît aussi si le monde l’utilise déjà |
| Réelle | Temps simulé divisé par temps réel ; peut être inférieur à la consigne |
Le véhicule doit être désarmé, le terrain prêt et les flux de mission ou de commande manuelle/ROS inactifs. AIS est indisponible au-delà de 1×. Windows et Linux démarrent à 20 ms ; le Mac natif, à 10 ms. Les exercices conservent leur pas imposé de 10 ms. Voir Personnaliser les mondes.
Position et connexions
N/E/D signifie nord, est et bas en mètres depuis l’origine locale. Les coordonnées géographiques sont latitude et longitude en degrés. R/P/Y · ENU donne les angles bruts : lacet 0° vers l’est, 90° vers le nord. L’instrument affiche le tangage −P et le cap (90 − Y + 360) % 360.
Les détails de connexion indiquent séquence, âge et repère ENU de la position. Une séquence croissante et un faible âge confirment de nouvelles acquisitions. Le panneau de commande possède ses propres diagnostics. RViz ouvre le visualiseur adapté : RViz2 natif dans l’application, visualiseur web dans le navigateur. Il faut un monde prêt et, dans l’application, le service RViz disponible. Voir Visualiser avec RViz et Foxglove. Les paramètres ArduPilot se lisent, s’exportent et se modifient dans leur panneau ; les changements autorisés s’appliquent désarmé et sont vérifiés par relecture.
Commande ROS 2 directe

Activez ROS pour accepter les commandes bornées du contrôleur connecté. Arrêter ROS maintient une sortie neutre jusqu’à réactivation. Les diagnostics affichent motif, séquence appliquée, accusé de réception et poussées. Le chien de garde remet les sorties au neutre si les commandes cessent d’arriver. Suivez Terminaux ROS et connexion, Commander un espace de travail web ou Commander un espace de travail local.
Enregistrer et transférer des ressources
Dans Espace de travail → Monde personnalisé → Stockage, consultez terrains, révisions de véhicules, configurations de monde, caches et espace libre. Archiver masque une ressource sans supprimer ses fichiers ni libérer d’espace. Restaurer la rend à nouveau visible. Attendez la fin des sessions qui l’utilisent.
L’export/import ZIP transfère un véhicule avec ses ressources. Modifier une copie crée une nouvelle révision. Avant le lancement, vous pouvez télécharger les SDF du véhicule et du monde, les modifier puis charger une révision compatible. Voir Préparer son véhicule, Personnaliser le véhicule et Personnaliser les mondes.
Petits écrans et états d’attente
Sur téléphone, les boutons inférieurs ouvrent un seul panneau défilant. Fermez-le avec × ou Échap pour revenir à la scène. En paysage, il se place à côté des commandes. La vue bureau de la démonstration publique réduit la disposition complète ; en portrait, elle demande de tourner le téléphone. Le plein écran dépend du navigateur et d’une action de l’utilisateur.
Un bouton désactivé indique souvent une préparation incomplète, un terrain en attente, une mission active ou une commande en cours. Lisez l’état avant de réessayer. Masquer des panneaux, effacer des traces, arrêter des images ou se désabonner ne stoppe pas le véhicule. Terminez la session à la fin. Fermer l’application installée arrête les services locaux et la génération de terrain tout en conservant les données enregistrées.
Identifiants AIS
Les démonstrations utilisent la clé AISStream du serveur. En son absence, les démonstrations installées utilisent le flux AIS public Open Waters. Le panneau indique fournisseur et état ; les navires visibles dépendent de rapports récents.
Pour un monde personnalisé, saisissez votre clé dans Scène → Trafic maritime et enregistrez-la localement. Elle reste dans ce navigateur et est envoyée au serveur de simulation choisi. La suppression locale l’efface du navigateur. Activez le trafic pour vous connecter. Voir Simulation, rendu et capteurs.
Commander avec QGC
Pour un véhicule Autopilot, sélectionnez Open QGC dans le panneau ArduPilot. Gardez l’application installée et l’espace de travail connecté ouverts. La boîte de dialogue prépare le véhicule puis confie la commande à QGroundControl. Consultez Commander avec QGC pour installer, connecter et libérer la commande.
- Commander un espace de travail local
- Commander un espace de travail web
- Commander ArduPilot avec Python
Éclairage avant BlueROV2
Utilisez Éclairage avant dans le joystick pour commuter les deux lampes BlueROV2 ON/OFF. Le retour confirme leur état réel; une commande échouée ou indisponible n’est pas indiquée comme réussie. Cet éclairage est indépendant du jour/nuit de la scène et de la caméra.