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

Caractéristiques techniques

Valeurs par défaut de l’environnement, des données, de la physique et des interfaces. Les différences par plateforme ou monde sont indiquées séparément.

Logiciels

Élément Spécification
ROS ROS 2 Lyrical
Gazebo Jetty · Gazebo Sim 10; macOS: 10.5.0
Pilote automatique de surface ArduRover 4.7.2 · SITL
Pilote automatique sous-marin ArduSub 4.7.2 · SITL
Code ArduPilot fb773567896014da007bca58358704d4a0d8516f
Graphismes du navigateur Three.js 0.186.1 · React Three Fiber 9.8.1

Temps de simulation

Élément Spécification
Vitesse cible par défaut 1×
Pas physique macOS 10 ms
Pas physique Windows/Linux 20 ms
Pas d’évaluation 10 ms
Pas du serveur web Configuration du serveur

Les fréquences utilisent le temps simulé. Facteur de temps réel (RTF), cadence physique, fréquence capteur et FPS d’affichage sont des mesures distinctes.

Physique et rendu

Élément Spécification
Corps rigides et contacts Gazebo Physics ; DART par défaut
Dynamique marine Champ de vagues, flottabilité et hydrodynamique Wave Sim
Hydrodynamique BlueROV2 Flottabilité sensible aux vagues et amortissement linéaire/angulaire
Vues et capteurs Gazebo Ogre2 sur l’hôte moteur ; Metal sur macOS
Scène du navigateur Three.js/WebGL : terrain, véhicules et eau depuis l’état simulé
Géométrie des vagues du navigateur Échantillons du solveur physique

Étendue du terrain, de l’eau et du fond

Élément Spécification
Terrain de la démo WAM-V Hong Kong préparé : centre 2 × 2 km, alentours 6 × 6 km ; altitude/profondeur et imagerie aérienne
Monde personnalisé par défaut Zone fixe 1 × 1 km ; terrain à la demande en option
Région initiale à la demande 1 000 × 1 000 m · 129 × 129
Pas numérique à la demande 7,8125 m
Tuile par défaut 1 000 × 1 000 m
Fond requis en espace personnel 5 × 5 tuiles · 5 × 5 km
Fond requis dans LIVE 7 × 7 tuiles · 7 × 7 km
Région fixe sans chargement continu 1 × 1 km · 513 × 513 · 1,953125 m
Tuile physique périodique de vagues 256 × 256 m · 64 × 64 cellules
Eau détaillée personnelle dans Gazebo 3 × 3 tuiles · 768 × 768 m
Tuiles visibles de vagues LIVE 15 × 15 tuiles · 3 840 × 3 840 m

La tuile de calcul des vagues, l’eau visible, le terrain numérique et le fond de collision chargé ont des étendues différentes. Les tuiles répétées partagent un champ périodique, pas des simulations indépendantes. Les dimensions des grilles comptent les échantillons ; le champ FFT compte les cellules. La démo utilise Hong Kong ; les exercices, une arène dédiée à fond plat de 20 m. Voir Algorithmes de génération du terrain.

Génération du terrain à la demande

Élément Spécification
Préparation Télécharge altitude/profondeur et imagerie terrestre disponible ; projection métrique locale
Construction des tuiles Maillages visuels et de collision partagent les échantillons ; halo de deux cellules pour la continuité
Insertion dans Gazebo Entités SDF réelles aux coordonnées locales
Vérification Présence des entités, profondeur RGBD et contact par une sphère de rayon 0.25 m et de masse 10 kg ; distance au maillage tenant compte de la pente · Contrôle physique du terrain
Préchargement Rangée extérieure selon position/vitesse : anticipation 120 s, minimum 250 m, maximum 40 % d’une tuile
Attente et reprise Attend si la couverture manque ; reprend après validation du carré courant complet
Cache et résidence Réutilise échantillons et tuiles récentes ; retire les entités lointaines sous budget borné

Jeux de données

Élément Spécification
GEBCO 2026 Altitude et bathymétrie mondiales ; grille native de 15 secondes d’arc
Copernicus GLO-30 Altitude terrestre ; 30 m nominaux
Copernicus Marine 202511 Bathymétrie côtière régionale selon disponibilité
EMODnet DTM 2024 Bathymétrie régionale, surtout européenne
KHOA BADA2024 Bathymétrie coréenne optionnelle
Cesium World Bathymetry Prioritaire si l’accès numérique sous licence est configuré
OpenStreetMap Affinement du trait de côte et de la limite terre/eau
Sentinel-2 RGB Imagerie terrestre ; 10 m nominaux

Le monde consigne les sources réellement utilisées. Réduire le pas du maillage n’améliore pas l’exactitude des mesures d’origine.

Modèles de véhicules

Élément Spécification
Propulsion WAM-V 2 : gauche et droite
Propulsion BlueROV2 6
Masse WAM-V Coque 180 kg ; total 211,151 kg
Masse BlueROV2 Coque 10 kg ; total ≈10,0132 kg
Limites de collision WAM-V 5,006 × 2,487 × 1,291 m
Boîte de collision BlueROV2 0,457 × 0,338 × 0,065 m
Éclairage avant BlueROV2 Deux projecteurs avant; ON par défaut; portée d’atténuation du modèle 25 m
Dimensions hors tout BlueROV2 du constructeur 0,457 × 0,338 × 0,254 m

Les dimensions de collision décrivent la géométrie simulée, pas le produit physique complet. Les masses totales additionnent les liens SDF.

Capteurs et états par défaut

Élément Spécification
GNSS WAM-V Par défaut ; 5 Hz ; latence 0,2 s ; GPS_INPUT → EKF
GNSS satellite BlueROV2 Activé par défaut ; désactivation explicite ; contrôle d’immersion ; réacquisition 3 s
IMU WAM-V 200 Hz
IMU BlueROV2 1 000 Hz configurés ; limités par le pas physique
RGB avant, deux véhicules 640 × 480 px · 5 Hz · HFOV 1,05 rad (60,2°)
RGB-D d’inspection BlueROV2 640 × 480 px · 5 Hz · HFOV 60,2° ; 45° vers le bas
LiDAR 2D WAM-V 5 Hz ; 360 échantillons sur 360° ; 0,2–50 m ; résolution 0,02 m
Magnétomètre BlueROV2 20 Hz · Gazebo
Odométrie WAM-V 20 Hz
Odométrie BlueROV2 100 Hz

Les caméras s’activent à la demande. Le connecteur ROS standard livre des JPEG jusqu’à 1 Hz simulé. L’odométrie est un état du simulateur, pas un capteur physique de position bruité. La fréquence publiée peut être inférieure à la fréquence configurée. HFOV désigne le champ de vision horizontal.

GNSS et navigation définit qualité, repères d’antenne et récupération. L’éditeur peut modifier capteurs, montages et réglages. Les topics générés utilisent /vehicle/sensors/{sensor_id} avec des suffixes propres aux sorties ; consultez la liste active et sensor-manifest.json. Personnaliser les capteurs distingue DVL, Ping et multifaisceau. Méthodes, paramètres SDF, bruit et validité figurent dans Modèles et paramètres des capteurs.

Plans de coupe et visibilité des caméras

Élément Spécification
RGB avant WAM-V intégré near 0,1 m · far 5 000 m
RGB avant BlueROV2 intégré near 0,1 m · far 5 000 m
RGB-D d’inspection BlueROV2 near 0,1 m · far 80 m
Caméras de l’éditeur Réglages enregistrés, distincts des caméras intégrées
Caméra de scène personnelle Gazebo near 0,1 m ; far = max(5 000 m, 16 × diagonale 3D du terrain)
Caméras de scène LIVE Gazebo near 0,1 m · far 5 000 m · 1280 × 720 px
Caméra World/Vehicle du navigateur near adaptatif 0,03–40 m ; far ≥8 000 m, étendu selon monde et distance

near et far définissent les limites géométriques de dessin. Atténuation sous-marine, occultation, terrain chargé et couverture d’imagerie peuvent réduire la visibilité utile. Caméras de scène et capteurs du robot sont séparés.

Topics et messages ROS

Élément Spécification
/clock rosgraph_msgs/msg/Clock
/model/{robot}/odometry nav_msgs/msg/Odometry
/model/{robot}/imu sensor_msgs/msg/Imu
/model/{robot}/camera/compressed sensor_msgs/msg/CompressedImage · JPEG ≤1 Hz
/model/wamv/scan sensor_msgs/msg/LaserScan
/model/bluerov2/inspection/image/compressed sensor_msgs/msg/CompressedImage · RGB
/tf, /tf_static tf2_msgs/msg/TFMessage
/mavros/battery sensor_msgs/msg/BatteryState · Autopilot
/wwos/cmd_vel geometry_msgs/msg/TwistStamped · WAM-V · ROS 2
/wwos/thrusters std_msgs/msg/Float64MultiArray · ROS 2 · N

{robot} vaut wamv ou bluerov2. Le connecteur expose le RGB d’inspection ; la profondeur RGBD est une sortie native distincte. Un chien de garde de 0,75 s remet les commandes au neutre si elles ne sont plus actualisées.

Coordonnées, unités et hypothèses

Élément Spécification
Coordonnées géographiques WGS 84 ; latitude/longitude en degrés
Axes locaux ENU : est/nord/haut
Axes du corps Gazebo FLU : avant/gauche/haut
Axes du corps ArduPilot FRD : avant/droite/bas
Axes de navigation ArduPilot NED : nord/est/bas
Unités ROS m · s · m/s · rad/s · m/s² · N

Les conversions de repères s’effectuent à l’interface du pilote automatique. Ces paramètres décrivent un modèle ; ils n’impliquent ni autonomie, ni profondeur nominale, ni exactitude du produit réel.

Références

Rechercher dans la documentation