Personnaliser les mondes
Le SDF du monde définit l’environnement de simulation. Utilisez l’export du terrain choisi : il contient ses références, l’origine géographique et les systèmes nécessaires au moteur.
Télécharger et appliquer un monde
- Sélectionnez un terrain fixe prêt, choisissez le véhicule et ouvrez la vérification avant démarrage.
- Ouvrez Modifier les fichiers SDF → Télécharger le SDF du monde et conservez une copie de
world.sdf. - Modifiez les champs de physique et d’éclairage pris en charge. Conservez les modèles du terrain, chemins, nom du monde et origine géographique.
- Choisissez Importer le SDF du monde modifié. La révision validée apparaît dans Configuration du monde et devient la sélection active.
- Démarrez le monde. Les réglages s’appliquent après la préparation du terrain et du véhicule. Vérifiez le pas de physique, la vitesse mesurée et l’éclairage.
Le fichier est lié à sa révision de terrain. Pour un autre terrain, téléchargez son fichier et reportez vos réglages. Configuration du terrain par défaut rétablit les valeurs initiales. Les fichiers .world ou .sdf sont limités à 1 Mo. Ce parcours concerne les mondes fixes sans évaluation ; le terrain à la demande et les épreuves notées utilisent leurs réglages attribués.
Réglages pris en charge
| Section SDF | Paramètres et unités |
|---|---|
physics / max_step_size |
Intervalle d’intégration : 0.001–0.03 s. Le réduire augmente le calcul. |
physics / real_time_factor |
Rapport demandé entre temps simulé et réel : supérieur à 0, au maximum 10. Le résultat dépend du CPU et du GPU. |
gravity |
Vecteur d’accélération en m/s² ; valeur standard 0 0 -9.81. |
magnetic_field |
Vecteur du champ magnétique en teslas. |
scene |
Lumière ambiante, couleur de fond, ombres, grille et origine. Couleurs en RGBA. |
light |
Jusqu’à 32 lumières nommées, directionnelles, ponctuelles ou spots : pose, direction, couleur, atténuation et angles en radians. |
wind / linear_velocity |
Vitesse du vent SDF en m/s. Les modèles marins de vagues et de courant possèdent leurs propres commandes et interprétation physique. |
La spécification SDFormat décrit le schéma complet. L’import conserve le terrain et les systèmes requis et applique les réglages compatibles. Il n’installe pas de plugins, ne récupère pas de modèles externes et ne remplace pas le terrain géographique. Réglez vagues et courant dans le panneau de scène ; leur effet est décrit dans Dynamique marine et rendu.
Modèle avec terrain préparé
Télécharger KMOU world.sdf. Cet exemple complet utilise le terrain KMOU et expose les sections compatibles. Maillages et images restent dans le paquet de terrain, téléchargeable depuis l’espace de travail.
kmou.world
<?xml version='1.0' encoding='utf-8'?>
<sdf version="1.4">
<!--
Configuration du monde pour cette révision du terrain. Conservez son nom, ses
ressources, son origine géographique et ses systèmes requis. Importez les réglages
autorisés depuis l'écran de démarrage.
-->
<world name="wwos_gebco">
<!--
Apparence de la scène : ambient et background sont des couleurs RGBA. shadows, grid et
origin_visual règlent leur affichage. Le tableau des réglages du monde précise les
champs acceptés à l'import, y compris ceux du ciel.
-->
<scene>
<ambient>0.01 0.01 0.01 1.0</ambient>
<sky>
<clouds>
<speed>12</speed>
</clouds>
</sky>
<shadows>1</shadows>
<background>0.7 0.8 0.9 1</background>
<grid>false</grid>
<origin_visual>false</origin_visual>
</scene>
<!--
Temps de la physique : max_step_size est le pas d'intégration en secondes ;
real_time_factor est le rapport demandé entre temps simulé et réel. name est une
étiquette, pas le pas de temps. La vitesse effective dépend du CPU/GPU.
-->
<physics name="1ms" type="ignored">
<max_step_size>.02</max_step_size>
<real_time_factor>1.0</real_time_factor>
</physics>
<!--
Plugin du moteur. filename désigne une bibliothèque installée et name son
implémentation. Conservez ces deux valeurs lors des modifications numériques ; un SDF
n'installe pas de plugin.
-->
<!--
Exécute la dynamique des corps rigides et les calculs de contact. Conservez ce système
indispensable.
-->
<plugin filename="gz-sim-physics-system" name="gz::sim::systems::Physics">
</plugin>
<!--
Plugin du moteur. filename désigne une bibliothèque installée et name son
implémentation. Conservez ces deux valeurs lors des modifications numériques ; un SDF
n'installe pas de plugin.
-->
<!--
Fournit les commandes Gazebo Transport qui modifient la scène active. Conservez-le
pour les opérations de l'espace de travail.
-->
<plugin filename="gz-sim-user-commands-system" name="gz::sim::systems::UserCommands">
</plugin>
<!--
Plugin du moteur. filename désigne une bibliothèque installée et name son
implémentation. Conservez ces deux valeurs lors des modifications numériques ; un SDF
n'installe pas de plugin.
-->
<!--
Publie la structure et les poses de la scène pour l'affichage de la simulation.
-->
<plugin filename="gz-sim-scene-broadcaster-system" name="gz::sim::systems::SceneBroadcaster">
</plugin>
<!--
Plugin du moteur. filename désigne une bibliothèque installée et name son
implémentation. Conservez ces deux valeurs lors des modifications numériques ; un SDF
n'installe pas de plugin.
-->
<!--
Produit les images des caméras et les données des capteurs GPU. render_engine choisit
le moteur de rendu installé ; conservez la valeur exportée.
-->
<plugin filename="gz-sim-sensors-system" name="gz::sim::systems::Sensors">
<render_engine>ogre2</render_engine>
</plugin>
<!--
Plugin du moteur. filename désigne une bibliothèque installée et name son
implémentation. Conservez ces deux valeurs lors des modifications numériques ; un SDF
n'installe pas de plugin.
-->
<!--
Système du monde requis par les capteurs DVL personnalisés. Leurs faisceaux et leur
suivi se règlent dans le SDF du véhicule.
-->
<plugin filename="gz-sim-dvl-system" name="gz::sim::systems::DopplerVelocityLogSystem">
</plugin>
<!--
Origine géographique du terrain. Latitude, longitude et cap sont en degrés ; altitude
en mètres. ENU signifie est, nord, haut. Conservez ces valeurs pour aligner carte,
terrain et GNSS.
-->
<spherical_coordinates>
<surface_model>EARTH_WGS84</surface_model>
<world_frame_orientation>ENU</world_frame_orientation>
<latitude_deg>35.077175</latitude_deg>
<longitude_deg>129.085815</longitude_deg>
<elevation>0</elevation>
<heading_deg>0</heading_deg>
</spherical_coordinates>
<!--
Source lumineuse. type choisit une lumière directionnelle, ponctuelle ou un spot ;
pose place son repère et direction définit le faisceau. diffuse/specular sont en RGBA
; cast_shadows active les ombres.
-->
<light type="directional" name="sun1">
<!--
Pose : x y z en mètres, puis roll pitch yaw en radians. Le repère est celui du parent,
sauf indication différente par relative_to.
-->
<pose>50 0 150 0 0 0</pose>
<diffuse>1 1 1 1</diffuse>
<specular>.1 .1 .1 1</specular>
<direction>0.3 0.3 -1</direction>
<cast_shadows>false</cast_shadows>
</light>
<!--
Source lumineuse. type choisit une lumière directionnelle, ponctuelle ou un spot ;
pose place son repère et direction définit le faisceau. diffuse/specular sont en RGBA
; cast_shadows active les ombres.
-->
<light type="directional" name="sun_diffuse">
<!--
Pose : x y z en mètres, puis roll pitch yaw en radians. Le repère est celui du parent,
sauf indication différente par relative_to.
-->
<pose>-50 0 -150 0 0 0</pose>
<diffuse>0.6 0.6 0.6 1</diffuse>
<specular>0 0 0 1</specular>
<direction>-0.3 -0.3 -1</direction>
<cast_shadows>false</cast_shadows>
</light>
<!--
Source lumineuse. type choisit une lumière directionnelle, ponctuelle ou un spot ;
pose place son repère et direction définit le faisceau. diffuse/specular sont en RGBA
; cast_shadows active les ombres.
-->
<light type="directional" name="sun_diffuse_1">
<!--
Pose : x y z en mètres, puis roll pitch yaw en radians. Le repère est celui du parent,
sauf indication différente par relative_to.
-->
<pose>-100 500 -20 0 0 0</pose>
<diffuse>0.8 0.8 0.8 1</diffuse>
<specular>1 1 1 1</specular>
<direction>-1 -1 0</direction>
<cast_shadows>false</cast_shadows>
</light>
<!--
Source lumineuse. type choisit une lumière directionnelle, ponctuelle ou un spot ;
pose place son repère et direction définit le faisceau. diffuse/specular sont en RGBA
; cast_shadows active les ombres.
-->
<light type="directional" name="sun_diffuse_2">
<!--
Pose : x y z en mètres, puis roll pitch yaw en radians. Le repère est celui du parent,
sauf indication différente par relative_to.
-->
<pose>-150 -130 50 0 0 0</pose>
<diffuse>0.6 0.6 0.6 1</diffuse>
<specular>0.2 0.2 0.2 1</specular>
<direction>0.5 0.5 -1</direction>
<cast_shadows>false</cast_shadows>
</light>
<!--
Plugin du moteur. filename désigne une bibliothèque installée et name son
implémentation. Conservez ces deux valeurs lors des modifications numériques ; un SDF
n'installe pas de plugin.
-->
<plugin filename="gz-sim-buoyancy-system" name="gz::sim::systems::Buoyancy">
<!--
Densité du fluide par couches pour la flottabilité, en kg/m^3. default_density
s'applique sous la transition ; above_depth indique la hauteur du changement. Ici, la
limite est z=0.
-->
<graded_buoyancy>
<default_density>1025</default_density>
<density_change>
<above_depth>0</above_depth>
<density>1</density>
</density_change>
</graded_buoyancy>
</plugin>
<!--
Structure du modèle : les liens définissent les corps rigides, les articulations les
relient et les plugins assurent leur simulation. Conservez les noms utilisés par les
contrôleurs exportés.
-->
<model name="gebco_terrain">
<!--
Les modèles statiques restent fixes sous l'effet de la gravité et des contacts. Le
terrain est statique ; les liens du véhicule sont dynamiques.
-->
<static>true</static>
<!--
Corps rigide et repère local. Sa géométrie, ses propriétés de masse et ses capteurs se
déplacent ensemble.
-->
<link name="terrain">
<!--
Géométrie de contact utilisée par la physique. Adaptez ses dimensions et sa position à
la coque ; une forme simple réduit le coût des collisions.
-->
<collision name="gebco_collision">
<geometry>
<!--
Maillage et échelle facultative par axe. Conservez le chemin exporté avec ses
ressources ; l'échelle multiplie les coordonnées du maillage.
-->
<mesh>
<uri>terrain.dae</uri>
</mesh>
</geometry>
</collision>
<!--
Surface visible pour le rendu et les caméras. Sa modification ne redimensionne pas
automatiquement la collision et ne change pas la masse.
-->
<visual name="seabed">
<geometry>
<!--
Maillage et échelle facultative par axe. Conservez le chemin exporté avec ses
ressources ; l'échelle multiplie les coordonnées du maillage.
-->
<mesh>
<uri>terrain-visual.dae</uri>
</mesh>
</geometry>
<!--
Apparence de surface. Les couleurs RGBA et textures PBR modifient le rendu. Conservez
les textures du terrain avec les ressources exportées ; le matériau ne change pas
automatiquement masse ou frottement.
-->
<material>
<ambient>0.6 0.6 0.6 1</ambient>
<diffuse>1 1 1 1</diffuse>
<specular>0.03 0.03 0.03 1</specular>
<pbr>
<metal>
<albedo_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-diff-1803d7e2861b304b.jpg</albedo_map>
<roughness>1</roughness>
<normal_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-nor_gl-0f35185b7225fe20.jpg</normal_map>
<roughness_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-rough-318b440c109de741.jpg</roughness_map>
<metalness>0</metalness>
</metal>
</pbr>
</material>
</visual>
<!--
Surface visible pour le rendu et les caméras. Sa modification ne redimensionne pas
automatiquement la collision et ne change pas la masse.
-->
<visual name="land">
<geometry>
<!--
Maillage et échelle facultative par axe. Conservez le chemin exporté avec ses
ressources ; l'échelle multiplie les coordonnées du maillage.
-->
<mesh>
<uri>terrain-visual-land.dae</uri>
</mesh>
</geometry>
<!--
Apparence de surface. Les couleurs RGBA et textures PBR modifient le rendu. Conservez
les textures du terrain avec les ressources exportées ; le matériau ne change pas
automatiquement masse ou frottement.
-->
<material>
<ambient>0.6 0.6 0.6 1</ambient>
<diffuse>1 1 1 1</diffuse>
<specular>0.03 0.03 0.03 1</specular>
<pbr>
<metal>
<albedo_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/land-satellite-eb6fd1423859d847a276a4db49db6db51a61fe8965171639c94f8d3df66e0199.png</albedo_map>
<roughness>1</roughness>
<metalness>0</metalness>
</metal>
</pbr>
</material>
</visual>
</link>
</model>
<!--
Plugin du moteur. filename désigne une bibliothèque installée et name son
implémentation. Conservez ces deux valeurs lors des modifications numériques ; un SDF
n'installe pas de plugin.
-->
<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu" />
<!--
Plugin du moteur. filename désigne une bibliothèque installée et name son
implémentation. Conservez ces deux valeurs lors des modifications numériques ; un SDF
n'installe pas de plugin.
-->
<plugin filename="gz-sim-magnetometer-system" name="gz::sim::systems::Magnetometer" />
<!--
Vecteur de gravité du monde x y z en m/s^2. Dans ce monde ENU, z négatif pointe vers
le bas.
-->
<gravity>0 0 -9.81</gravity>
<!--
Vecteur du champ magnétique mondial x y z en teslas, utilisé pour simuler le
magnétomètre.
-->
<magnetic_field>5.64e-6 2.29e-5 -4.2e-5</magnetic_field>
<!--
Vitesse du vent standard SDF, en m/s. Un modèle de forces doit l'utiliser pour agir
sur le mouvement. Réglez vagues et courants avec leurs commandes de scène.
-->
<wind>
<linear_velocity>0 0 0</linear_velocity>
</wind>
</world>
</sdf>
Cet exemple provient du moteur Linux. Utilisez l’export de votre hôte, notamment sur macOS, afin que les bibliothèques des plugins correspondent à l’installation.
Utiliser votre propre terrain
Générez et sélectionnez le terrain, puis téléchargez son SDF à la vérification de départ. Vous obtenez ses chemins et son origine géographique exacts. Reportez vos modifications de physique ou d’éclairage dans ce fichier.
Pour une copie transportable, téléchargez le ZIP du terrain et gardez le monde auprès de ses ressources relatives. Le contrôle SDF applique des réglages au terrain enregistré correspondant ; il n’importe pas le terrain d’un ZIP. Créez ou restaurez d’abord le terrain par son parcours de préparation.
Comparer avant une longue session
Conservez véhicule, position initiale et capteurs identiques entre essais. Vérifiez pas temporel, rapport de temps réel, direction lumineuse, caméras et mouvement. Une vitesse demandée plus élevée ne garantit pas un rendu ou une réception plus rapide. Gardez l’original pour revenir aux valeurs par défaut ou réimporter une copie précédente.
Performances et affichage
Le facteur de temps réel (RTF) mesure les secondes simulées par seconde réelle. La vitesse demandée est une cible ; un RTF inférieur à 1 signifie une exécution plus lente que le temps réel. Le pas influe sur contacts, vagues, capteurs et stabilité de commande ; le réseau influe sur commandes et affichage. AIS en direct est masqué au-delà de 1×. La fréquence des caméras limite les mises à jour visuelles.
Après modification du pas, testez immobilité, virages, dégagement, plongée et retour avec les deux véhicules fournis.
| Vue | Rendu |
|---|---|
| Images des capteurs | Gazebo sur l’hôte du moteur |
| Véhicule/monde personnel, navigateur | GPU du navigateur |
| Véhicule/monde personnel, Gazebo | Gazebo sur l’hôte ; choix initial de l’application |
| Véhicule/monde du LIVE public | Caméras d’observation Gazebo |
Réduisez d’abord les caméras inutiles, leur fréquence et leur résolution. L’éclairage du navigateur règle ciel, reflets, mappage tonal et normales de l’eau ; la géométrie des vagues reprend les échantillons du modèle physique.
Comparez les diagnostics dans la même scène : images/s, temps d’image p95, appels de dessin, triangles, textures et géométrie. Le terrain mobile simplifie les formes visuelles éloignées ; voir Algorithmes de génération du terrain. Collisions et capteurs ont leurs coûts propres. Le rendu navigateur conserve Gazebo pour les caméras et le LiDAR GPU : comparez séparément FPS vidéo, Hz des capteurs et RTF.
Pour dimensionner une machine, gardez monde, véhicule, fréquences et vitesse identiques. Commencez avec une session, augmentez leur nombre et incluez les pics de préparation du terrain. Mesurez RTF médian et 5e percentile, durée du pas physique, réception et âge des images, CPU, mémoire, GPU et VRAM. La physique dépend des performances par cœur ; terrain et capteurs exploitent aussi plusieurs cœurs. Caméras et résolution augmentent la charge GPU. Les spectateurs du LIVE partagent un seul monde.
Apple Silicon utilise Metal. Les moteurs Docker Ubuntu et Windows/WSL exigent des pilotes et runtimes adaptés à leurs images. LIVE ne consomme pas de quota personnel ; modèles, fichiers et caches ont des limites de stockage. Prévoyez de l’espace pour le moteur et les modèles. Voir Comptes et durée des sessions.