Modèles et paramètres des capteurs
Ce catalogue décrit la génération des mesures : capteurs de rendu et cinématiques Gazebo, plugins acoustiques POSIM et adaptateurs de l’application. Intégré désigne le robot fourni ; éditeur, un véhicule nouvellement créé ; fournisseur, une fonction nécessitant son plugin compatible. Le SDF final et sensor-manifest.json définissent la configuration enregistrée.
De la simulation à la mesure
- État physique ou géométrie rendue
Gazebo fournit mouvement, champs du monde ou intersections de rayons. Chaque capteur possède un montage et une horloge d’acquisition.
- Modèle de mesure
Le plugin projette des images, forme les mesures inertielles, résout les vitesses par faisceau ou calcule les retours acoustiques. Bruit et validité interviennent ici.
- Messages et repères
Les ponts ROS–Gazebo et adaptateurs POSIM conservent les mesures, nomment les repères, convertissent les unités et signalent les données indisponibles.
- Algorithme ou affichage
Commande et estimation utilisent les mesures horodatées. L’interface peut compresser les images, les mettre en tampon ou les transmettre à une cadence inférieure.
Configuration et temps communs
| Paramètre | Signification |
|---|---|
sensor/@type, gz:type |
Sélectionnent camera, rgbd_camera, gpu_lidar, imu, magnetometer ou GNSS/DVL/multifaisceaux personnalisé. Le monde doit charger le système correspondant. |
pose |
x/y/z en mètres, roulis/tangage/lacet en radians par rapport au lien parent. Éditeur : positions ±10 m, angles ±2π. |
update_rate |
Acquisitions demandées par seconde simulée ; éditeur 0,1–30 Hz. Pas physique, rendu et transmission peuvent diminuer la cadence observée. L’augmenter ne crée pas d’états physiques entre les pas. |
always_on, connexions |
Activation. Les caméras intégrées fonctionnent à la demande ; les capteurs de l’éditeur définissent always_on=true. Un fournisseur ou moteur de rendu indisponible peut empêcher les mesures. |
topic, frame_id, TF |
L’éditeur utilise /vehicle/sensors/{id}. Montages relatifs à vehicle/base_link. Axes optiques : droite/bas/avant ; corps : avant/gauche/haut. |
| Horodatage d’acquisition | Temps simulé de la mesure, à conserver dans les enregistrements et la fusion. Lecture HLS et réception navigateur décrivent le transport. |
noise |
Propre au plugin. L’IMU accepte bruit blanc, biais et biais dynamique par axe ; la caméra, moyenne et écart-type. Une balise XML commune ne garantit pas un modèle d’erreur commun. |
Les capteurs Gazebo définissent les modèles de base. Tous leurs paramètres ne sont pas exposés dans l’éditeur. L’import SDF de WWW-POSIM autorise les valeurs prises en charge dans les blocs existants et conserve leur structure ; ajoutez les capteurs disponibles depuis l’éditeur. Les blocs optionnels Gazebo décrits ici indiquent les possibilités du moteur, pas l’acceptation de tout XML importé.
Caméras RGB : avant et dessous
CameraSensor projette la géométrie par un modèle sténopé vers une cible Ogre2, puis publie image et calibration. Matériaux, éclairage, occultations et Dynamique marine et rendu déterminent la couleur. Les caméras fournies ne simulent ni obturateur déroulant, ni électronique d’exposition, ni salissure de lentille.
| Paramètre | Sélection |
|---|---|
camera/image/width, height |
Avant intégré et éditeur : 640×480 ; dessous dans l’éditeur : 800×600. Dimensions 64–1920, largeur × hauteur × fréquence ≤30 millions de pixels/s par caméra. |
camera/horizontal_fov |
Avant intégré : 1,05 rad ; éditeur : 1,4 rad, réglable de 0,1 à 3. Résolution et champ de vision définissent échantillonnage angulaire et calibration. |
camera/clip/near, far |
Avant intégré : 0,1–5000 m ; éditeur : 0,1–100 m. Il s’agit de plans de coupure géométriques, pas de visibilité utile sous l’eau. |
update_rate |
Initialement 5 Hz ; le transport a ses propres limites. |
camera/noise, distortion, lens/intrinsics |
Gazebo prend en charge bruit gaussien d’image, distorsion radiale/tangentielle de Brown (k1, k2, k3, p1, p2) et paramètres intrinsèques fournis. Les définitions générées n’ajoutent ni bruit ni distorsion. Conservez SDF et CameraInfo. |
Sorties : sensor_msgs/Image et sensor_msgs/CameraInfo. Le JPEG est une représentation de transport. Les vues Monde/Véhicule de l’observateur ne sont pas des capteurs du robot. Implémentation.
L’adaptateur s’abonne tant qu’un affichage ou consommateur demande des images. Un abonnement accepté ne prouve pas leur réception : après 10 s réelles sans image, il renouvelle l’abonnement si la demande persiste. L’état en direct exige une nouvelle image décodée. Cette reprise ne change ni fréquence simulée, ni horodatages, ni vérifications de fraîcheur de navigation.
Caméra RGB-D d’inspection
RgbdCameraSensor produit couleur, profondeur flottante et nuage de points à partir de la même géométrie, via le tampon de profondeur. Ce modèle n’effectue pas d’appariement stéréo et ne simule pas un instrument physique à lumière structurée/ToF. L’atténuation des couleurs sous l’eau n’ajoute pas d’incertitude au canal de profondeur.
| Paramètre | BlueROV2 intégré |
|---|---|
pose |
(0.4, 0, −0.25) m sur base_link, tangage π/4 : objectif inférieur distinct. |
| Image et champ | 640×480, horizontal 1,05 rad. |
| Plans de coupure | 0,1–80 m. Gazebo accepte des limites depth_camera/clip distinctes ; l’application ne les redéfinit pas séparément ici. |
| Cadence et activation | 5 Hz demandés, à la demande. |
Les ponts ROS exposent Image, CameraInfo et PointCloud2 selon la configuration. Conservez les profondeurs invalides/hors plage ; une palette colorée ne remplace pas les valeurs. Le nuage représente une observation, pas une carte SLAM accumulée. Implémentation.
LiDAR plan
GpuLidarSensor utilise des rayons GPU sur la géométrie visible, puis applique portée et bruit configurés. La distance est géométrique, sans calcul de puissance optique reçue ni propagation laser sous-marine. Les objets hors de la hauteur ou du plan de balayage peuvent être manqués.
| Paramètre | WAM-V intégré / éditeur |
|---|---|
lidar/scan/horizontal/samples |
360, resolution=1 angulaire. |
min_angle, max_angle |
−π à +π rad, un plan horizontal. |
lidar/range/min, max, resolution |
Intégré : 0,2 / 50 / 0,02 m ; éditeur : 0,1 / 50 / 0,01 m. Portée maximale réglable de 1 à 100 m. La résolution du modèle ne garantit pas l’exactitude mesurée. |
| Cadence et montage | Habituellement 5 Hz. Intégré : 2,5 m au-dessus de la base ; démonstration partagée : étrave (3.5, 0, 1.0) m pour intercepter les bouées. L’éditeur enregistre la pose. |
lidar/noise |
Aucun bloc de bruit ajouté au scanner généré. Gazebo dispose de modèles de bruit de distance. |
Sortie sensor_msgs/LaserScan. Conservez angles et valeurs non finies ; une absence de retour n’est pas une distance nulle. Implémentation.
Ping unique vers le bas
L’adaptateur Ping réduit 5×5 rayons GPU au retour valide le plus proche et publie sensor_msgs/Range. Il représente empreinte et validité du faisceau, sans calculer intensité acoustique, formes d’onde ou trajets multiples.
| Paramètre | Éditeur |
|---|---|
| Rayons et angles | 5×5, chaque axe ±0,00872665 rad (±0,5°). Les capteurs de démonstrations dédiées peuvent avoir un autre éventail. |
| Minimum / maximum / résolution | 0,1 / 30 / 0,01 m ; maximum réglable de 1 à 100 m. |
| Cadence et pose | Initialement 5 Hz ; montage inférieur issu de la configuration enregistrée. |
field_of_view publié |
Cône contenant le faisceau carré, calculé à partir des demi-angles. Le retour peut provenir de n’importe quel rayon. |
Une entrée trop proche donne −∞ ; sans retour, +∞ ; inconnue, NaN lorsqu’aucun impact valide n’existe. L’horodatage est conservé. Ping et DVL sont deux choix alternatifs sous le véhicule. Une distance dans l’empreinte ne définit pas un point unique du fond.
Loch Doppler (DVL)
DopplerVelocityLog recherche le fond dans des cônes rendus. Il projette la vitesse cinématique relative capteur-cible sur les faisceaux, ajoute du bruit puis résout la vitesse par moindres carrés avec SVD. Il ne synthétise pas de porteuse acoustique ni n’en estime le spectre Doppler.
Paramètre <gz:dvl> |
Profil sélectionné |
|---|---|
type, arrangement |
phased_array ; quatre faisceaux à 45°, 135°, −45°, −135°, inclinaison 30°, ouverture 2°. |
tracking/bottom_mode/when |
best, suivi du fond. Le suivi de masse d’eau existe dans Gazebo mais n’est pas activé ici. |
tracking/bottom_mode/noise/stddev |
Écart-type gaussien de vitesse par faisceau : 0,002 m/s. La covariance résolue dépend de la géométrie. |
minimum_range, maximum_range, resolution |
0,1 / 20 / 0,01 m ; maximum réglable de 1 à 100 m. |
update_rate, reference_frame |
Initialement 1 Hz ; référence 0 0 0 0 0 0. Rotation et bras de levier font partie de la calibration. |
L’adaptateur exige au moins trois faisceaux accrochés, une covariance valide, le repère attendu et des horodatages croissants. Il publie geometry_msgs/Vector3Stamped et un état JSON dans std_msgs/String. Une perte d’accrochage ne produit pas une vitesse nulle. L’état contient les distances au fond par faisceau : minima dans le cône, pas forcément intersections du rayon central. Sans variance de distance, l’incertitude est inconnue. Implémentation.
Sonar imageur multifaisceaux
Le fournisseur POSIM transforme les rayons en rétrodiffusion acoustique, réponses fréquentielles corrigées par faisceau et intensités par cellule de distance. Aperçu du sonar physique décrit Rust/WGPU, CUDA et CPU ainsi que la différence entre observation acoustique et nuage géométrique.
| Groupe | Configuration |
|---|---|
| Faisceaux horizontaux | 256 entre −π/3 et +π/3 rad, 120°. |
| Rayons verticaux | 256 entre −π/18 et +π/18 rad, 20°. |
sonarFreq, maxDistance, rayons |
700 kHz ; traitement jusqu’à 15 m ; rayons 0,2–15 m. |
update_rate, raySkips |
Initialement 2 Hz ; facteur de saut 1. |
soundSpeed, bandwidth, sourceLevel, sensorGain |
Réglages du SDF fournisseur pour propagation, traitement et échelle d’affichage. Tous ne sont pas des commandes de l’éditeur ; conservez-les avec les données brutes. |
La comparaison exploratoire utilise un éventail incliné plus large, décrit avec les figures. L’éditeur publie marine_acoustic_msgs/ProjectedSonarImage brut ; l’éventail coloré en est une présentation. Le fournisseur doit réussir les vérifications de compatibilité de l’hôte.
IMU : accélération et vitesse angulaire
ImuSensor reçoit la cinématique, soustrait la gravité exprimée dans le repère du capteur pour former la force spécifique, puis applique le bruit par axe. Son orientation vient de celle du simulateur par rapport à la référence configurée ; ce n’est pas une estimation d’attitude embarquée.
| Paramètre | Sélection |
|---|---|
update_rate |
WAM-V : 200 Hz ; BlueROV2 intégré : 1000 Hz demandés, limités par les pas physiques. |
pose, orientation_reference_frame |
Montage et référence définissent les axes. BlueROV2 en commande ROS directe utilise une rotation de montage nulle ; le modèle ArduPilot conserve celle de son interface. Consultez repères émis et TF. |
imu/linear_acceleration/{x,y,z}/noise |
mean/stddev en m/s² ; bias_mean/bias_stddev pour le biais ; dynamic_bias_stddev/dynamic_bias_correlation_time pour son évolution. Les IMU de base ne configurent pas ces blocs. |
imu/angular_velocity/{x,y,z}/noise |
Paramètres gyroscopiques équivalents en rad/s. Le biais dynamique activé est corrélé dans le temps. |
Sortie sensor_msgs/Imu. IMU brute et attitude fusionnée MAVROS sont distinctes. Pour évaluer VIO ou commande, signalez l’absence de bruit et l’orientation issue de l’état de référence du simulateur. IMU, bruit gaussien.
L’interface JSON d’ArduPilot interpole les états physiques déjà calculés pour produire des échantillons SITL intermédiaires. Le Planification des trajectoires et commande décrit les fréquences et le comportement lorsque le pas de temps change. L’acquisition de l’IMU ROS reste limitée par les pas physiques ; les échantillons SITL interpolés n’ajoutent aucun détail physique.
Magnétomètre
MagnetometerSensor transforme le champ mondial vers le repère capteur et ajoute le bruit configuré par axe. BlueROV2 en possède un à 20 Hz, à l’origine de base_link. Les mondes utilisent teslas et ENU : use_units_gauss=false, use_earth_frame_ned=false.
| Paramètre | Signification |
|---|---|
magnetic_field du monde |
Vecteur de champ ; conservez la définition du monde. |
pose, update_rate |
Montage et cadence demandée. |
magnetometer/{x,y,z}/noise |
Moyenne/écart-type gaussiens en teslas ; aucun bruit supplémentaire configuré sur ce capteur. |
Sortie sensor_msgs/MagneticField. Interférences de fer dur/doux et anomalies locales ne sont pas modélisées. Le compas ArduPilot de WAM-V utilise le modèle SITL : un topic ROS ne prouve pas ce que fusionne la FCU. Implémentation.
Récepteur GNSS
posim::Gnss transforme la position mondiale de l’antenne en coordonnées géographiques, ajoute du bruit reproductible de position/vitesse, retarde la transmission et conditionne les solutions à l’immersion et aux obstacles. Il publie NavSatFix/état puis, en navigation GNSS, GPS_INPUT MAVLink.
| Paramètres | Fonction |
|---|---|
update_rate, latency, reacquire_seconds |
Cadence, délai et intervalle continu hors de l’eau, en temps simulé. |
horizontal_stddev, vertical_stddev, velocity_stddev, seed |
Amplitudes gaussiennes et reproductibilité. |
link_name, pose, water_level, wave_topic, dry_margin |
Bras de levier et test d’immersion tenant compte des vagues. |
enabled, topic d’obstruction |
Sélection du récepteur et blocage imposé. |
GNSS et navigation fait référence pour valeurs, covariances, ENU/NED, datum vertical et EKF. Géométrie satellitaire et multitrajets sont hors du modèle.
Pression et profondeur
La profondeur affichée par le simulateur et celle estimée par ArduSub se distinguent de SubseaPressureSensorPlugin. Ce plugin indépendant équipe d’autres modèles POSIM, dont RexROV et Slocum ; il n’est pas proposé dans l’éditeur WWW-POSIM.
Il lit la profondeur de l’origine du modèle sous le plan moyen z=0, la borne à zéro au-dessus de l’eau et ajoute une pression hydrostatique linéaire. Il publie sensor_msgs/FluidPressure en Pa et, facultativement, une profondeur déduite dans geometry_msgs/PointStamped.
| Paramètre | Valeur ou fonction |
|---|---|
namespace, topic |
Recherche du modèle et sortie ; topic par défaut sea_pressure. |
standard_pressure, kPa_per_meter |
101,325 kPa et 9,80638 kPa/m ; conversion des kPa internes en Pa. |
estimate_depth_on, update_rate |
Conversion inverse activée initialement ; fréquence 0 sans plafond supplémentaire du plugin. |
saturation |
Lu avec défaut 3000, mais non appliqué à la mesure ; aucune coupure de portée n’est imposée. |
Le code n’ajoute aucun bruit de pression tout en annonçant une variance correspondant à 3 kPa d’écart-type. Cette variance ne prouve pas un bruit effectivement tiré. La mesure utilise l’origine du modèle, sans prise de pression calibrée ni pression de surface liée aux vagues. Implémentation.
Composants USBL de POSIM
UsblTransceiver et UsblTransponder échangent positions et commandes simulées pour produire des localisations relatives. Le transpondeur perturbe ses coordonnées mondiales par un bruit gaussien. Ce composant de test fondé sur la position ne simule ni réception par différence de phase ni propagation acoustique complète. Il n’est pas un capteur standard de l’éditeur.
| Groupe | Fonction |
|---|---|
namespace, noms/ID, objets associés |
Appareils, modèles et circuits de messages. |
enable_ping_scheduler, ping_frequency, interrogation_mode |
Interrogations programmées et adressage commun/individuel. |
sound_speed |
Initialement 1540 m/s ; les rappels peuvent le remplacer par une approximation profondeur/température. |
mu, sigma du transpondeur |
Bruit de position : moyenne 0, écart-type 1 m. |
L’attente de propagation utilise une pause en temps réel dans le rappel. Ce n’est pas un instrument précis de temps de vol en temps simulé. Voir émetteur-récepteur et transpondeur.
Odométrie, référence et enregistrements
OdometryPublisher expose pose et vitesse simulées ; la commande du voyage automatique publie aussi l’état natif mesuré. Ce sont des références, pas de l’odométrie de roues ni une estimation fusionnée. Enregistrez repères parent/enfant, fréquence et changements d’origine. Identifiez séparément les estimations FCU ou SLAM.
Conservez SDF final, manifeste, extrinsèques TF, calibration, révisions application/fournisseur, pas temporel, graines aléatoires, horodatages, validité et observations brutes. Vidéos, captures et palettes de couleur les complètent.
Préparer son véhicule · Personnaliser les capteurs · Simulation, rendu et capteurs · Dynamique marine et rendu