Personalizza i mondi
Il SDF del mondo definisce l’ambiente di simulazione. Parti dall’esportazione del terreno selezionato: contiene riferimenti alle risorse, origine geografica e sistemi necessari al motore.
Scaricare e applicare un mondo
- Seleziona un terreno fisso pronto, scegli il veicolo e apri la verifica prima dell’avvio.
- Apri Modifica i file SDF → Scarica SDF del mondo e conserva una copia di
world.sdf. - Modifica i campi supportati di fisica e illuminazione. Mantieni modelli del terreno, percorsi, nome del mondo e origine geografica.
- Scegli Carica SDF del mondo modificato. La revisione validata compare in Configurazione del mondo e viene selezionata.
- Avvia il mondo. I valori vengono applicati dopo la preparazione di terreno e veicolo. Controlla passo fisico, velocità misurata e illuminazione.
Il file è legato alla revisione del terreno da cui proviene. Per un altro terreno, scarica il suo file e riapplica le modifiche. Configurazione predefinita del terreno ripristina i valori iniziali. Sono accettati file .world o .sdf fino a 1 MB. Il percorso è disponibile nei mondi fissi senza valutazione; terreno su richiesta e prove valutate usano le impostazioni assegnate.
Impostazioni supportate
| Sezione SDF | Parametri e unità |
|---|---|
physics / max_step_size |
Intervallo di integrazione: 0.001–0.03 s. Ridurlo aumenta il calcolo. |
physics / real_time_factor |
Rapporto richiesto tra tempo simulato e reale: maggiore di 0, fino a 10. Il risultato dipende da CPU e GPU. |
gravity |
Vettore di accelerazione in m/s²; valore standard 0 0 -9.81. |
magnetic_field |
Vettore del campo magnetico in tesla. |
scene |
Luce ambiente, colore di sfondo, ombre, griglia e origine. Colori RGBA. |
light |
Fino a 32 luci con nome, direzionali, puntiformi o faretti: posa, direzione, colore, attenuazione e angoli in radianti. |
wind / linear_velocity |
Velocità del vento SDF in m/s. Onde e correnti marine hanno controlli e interpretazione fisica propri. |
La specifica SDFormat descrive l’intero schema. L’importazione conserva terreno e sistemi necessari e applica le impostazioni supportate. Non installa plugin, recupera modelli esterni o sostituisce il terreno geografico. Regola onde e corrente nel pannello della scena; gli effetti sul veicolo sono descritti in Dinamica marina e rendering.
Modello con terreno preparato
Scarica KMOU world.sdf. L’esempio completo usa il terreno KMOU e mostra le sezioni supportate. Mesh e immagini restano nel pacchetto del terreno, scaricabile dall’area di lavoro.
kmou.world
<?xml version='1.0' encoding='utf-8'?>
<sdf version="1.4">
<!--
Configurazione del mondo per questa revisione del terreno. Mantieni nome, risorse,
origine geografica e sistemi necessari. Carica le impostazioni consentite dal
riepilogo di avvio.
-->
<world name="wwos_gebco">
<!--
Aspetto della scena: ambient e background sono colori RGBA. shadows, grid e
origin_visual ne controllano la visualizzazione. La tabella delle impostazioni del
mondo indica i campi accettati al caricamento, compresi quelli del cielo.
-->
<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>
<!--
Temporizzazione della fisica: max_step_size è il passo d'integrazione in secondi;
real_time_factor è il rapporto richiesto tra tempo simulato e reale. name è solo
un'etichetta. La velocità effettiva dipende da CPU/GPU.
-->
<physics name="1ms" type="ignored">
<max_step_size>.02</max_step_size>
<real_time_factor>1.0</real_time_factor>
</physics>
<!--
Plugin del motore. filename identifica una libreria installata e name la sua
implementazione. Mantieni entrambi quando carichi modifiche numeriche; il file SDF non
installa plugin.
-->
<!--
Esegue la dinamica dei corpi rigidi e il calcolo dei contatti. Mantieni attivo questo
sistema necessario.
-->
<plugin filename="gz-sim-physics-system" name="gz::sim::systems::Physics">
</plugin>
<!--
Plugin del motore. filename identifica una libreria installata e name la sua
implementazione. Mantieni entrambi quando carichi modifiche numeriche; il file SDF non
installa plugin.
-->
<!--
Fornisce comandi Gazebo Transport per modificare la scena attiva. È necessario per le
operazioni della scena nell'area di lavoro.
-->
<plugin filename="gz-sim-user-commands-system" name="gz::sim::systems::UserCommands">
</plugin>
<!--
Plugin del motore. filename identifica una libreria installata e name la sua
implementazione. Mantieni entrambi quando carichi modifiche numeriche; il file SDF non
installa plugin.
-->
<!--
Pubblica struttura e pose della scena per la visualizzazione della simulazione.
-->
<plugin filename="gz-sim-scene-broadcaster-system" name="gz::sim::systems::SceneBroadcaster">
</plugin>
<!--
Plugin del motore. filename identifica una libreria installata e name la sua
implementazione. Mantieni entrambi quando carichi modifiche numeriche; il file SDF non
installa plugin.
-->
<!--
Genera immagini delle camere e dati dei sensori GPU. render_engine seleziona il
backend grafico installato; mantieni il valore esportato.
-->
<plugin filename="gz-sim-sensors-system" name="gz::sim::systems::Sensors">
<render_engine>ogre2</render_engine>
</plugin>
<!--
Plugin del motore. filename identifica una libreria installata e name la sua
implementazione. Mantieni entrambi quando carichi modifiche numeriche; il file SDF non
installa plugin.
-->
<!--
Sistema del mondo richiesto dai sensori DVL personalizzati. Fasci e inseguimento si
configurano nel file SDF del veicolo.
-->
<plugin filename="gz-sim-dvl-system" name="gz::sim::systems::DopplerVelocityLogSystem">
</plugin>
<!--
Origine geografica del terreno. Latitudine, longitudine e orientamento sono in gradi;
quota in metri. ENU significa est, nord, alto. Mantieni questi valori per allineare
mappa, terreno e 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>
<!--
Sorgente luminosa. type seleziona luce direzionale, puntiforme o spot; pose ne colloca
il riferimento e direction definisce il fascio. diffuse/specular sono colori RGBA;
cast_shadows controlla le ombre.
-->
<light type="directional" name="sun1">
<!--
Posa: x y z in metri, poi roll pitch yaw in radianti. Il riferimento è quello del
genitore, salvo diversa indicazione in 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>
<!--
Sorgente luminosa. type seleziona luce direzionale, puntiforme o spot; pose ne colloca
il riferimento e direction definisce il fascio. diffuse/specular sono colori RGBA;
cast_shadows controlla le ombre.
-->
<light type="directional" name="sun_diffuse">
<!--
Posa: x y z in metri, poi roll pitch yaw in radianti. Il riferimento è quello del
genitore, salvo diversa indicazione in 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>
<!--
Sorgente luminosa. type seleziona luce direzionale, puntiforme o spot; pose ne colloca
il riferimento e direction definisce il fascio. diffuse/specular sono colori RGBA;
cast_shadows controlla le ombre.
-->
<light type="directional" name="sun_diffuse_1">
<!--
Posa: x y z in metri, poi roll pitch yaw in radianti. Il riferimento è quello del
genitore, salvo diversa indicazione in 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>
<!--
Sorgente luminosa. type seleziona luce direzionale, puntiforme o spot; pose ne colloca
il riferimento e direction definisce il fascio. diffuse/specular sono colori RGBA;
cast_shadows controlla le ombre.
-->
<light type="directional" name="sun_diffuse_2">
<!--
Posa: x y z in metri, poi roll pitch yaw in radianti. Il riferimento è quello del
genitore, salvo diversa indicazione in 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 del motore. filename identifica una libreria installata e name la sua
implementazione. Mantieni entrambi quando carichi modifiche numeriche; il file SDF non
installa plugin.
-->
<plugin filename="gz-sim-buoyancy-system" name="gz::sim::systems::Buoyancy">
<!--
Densità del fluido a strati per la galleggiabilità, in kg/m^3. default_density vale
sotto la transizione; above_depth indica la quota del cambio. Qui il confine è z=0.
-->
<graded_buoyancy>
<default_density>1025</default_density>
<density_change>
<above_depth>0</above_depth>
<density>1</density>
</density_change>
</graded_buoyancy>
</plugin>
<!--
Struttura del modello: i link definiscono corpi rigidi, i giunti li collegano e i
plugin ne simulano il comportamento. Mantieni i nomi usati dai controllori esportati.
-->
<model name="gebco_terrain">
<!--
I modelli statici restano fermi sotto gravità e forze di contatto. Il terreno è
statico; i link del veicolo sono dinamici.
-->
<static>true</static>
<!--
Corpo rigido e sistema di riferimento locale. Geometria, proprietà di massa e sensori
del link si muovono insieme.
-->
<link name="terrain">
<!--
Geometria di contatto usata dalla fisica. Dimensioni e posizione devono corrispondere
allo scafo; una forma semplice riduce il costo delle collisioni.
-->
<collision name="gebco_collision">
<geometry>
<!--
Risorsa mesh e scala facoltativa per asse. Conserva il percorso esportato insieme ai
file; scale moltiplica le coordinate della mesh.
-->
<mesh>
<uri>terrain.dae</uri>
</mesh>
</geometry>
</collision>
<!--
Superficie visibile nel rendering e nelle camere. Le modifiche non aggiornano
automaticamente la forma di collisione o la massa.
-->
<visual name="seabed">
<geometry>
<!--
Risorsa mesh e scala facoltativa per asse. Conserva il percorso esportato insieme ai
file; scale moltiplica le coordinate della mesh.
-->
<mesh>
<uri>terrain-visual.dae</uri>
</mesh>
</geometry>
<!--
Aspetto della superficie. Colori RGBA e texture PBR influenzano il rendering. Conserva
le texture del terreno con le risorse esportate; il materiale non cambia
automaticamente massa o attrito.
-->
<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>
<!--
Superficie visibile nel rendering e nelle camere. Le modifiche non aggiornano
automaticamente la forma di collisione o la massa.
-->
<visual name="land">
<geometry>
<!--
Risorsa mesh e scala facoltativa per asse. Conserva il percorso esportato insieme ai
file; scale moltiplica le coordinate della mesh.
-->
<mesh>
<uri>terrain-visual-land.dae</uri>
</mesh>
</geometry>
<!--
Aspetto della superficie. Colori RGBA e texture PBR influenzano il rendering. Conserva
le texture del terreno con le risorse esportate; il materiale non cambia
automaticamente massa o attrito.
-->
<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 del motore. filename identifica una libreria installata e name la sua
implementazione. Mantieni entrambi quando carichi modifiche numeriche; il file SDF non
installa plugin.
-->
<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu" />
<!--
Plugin del motore. filename identifica una libreria installata e name la sua
implementazione. Mantieni entrambi quando carichi modifiche numeriche; il file SDF non
installa plugin.
-->
<plugin filename="gz-sim-magnetometer-system" name="gz::sim::systems::Magnetometer" />
<!--
Vettore di gravità del mondo x y z in m/s^2. In questo mondo ENU, z negativo indica il
basso.
-->
<gravity>0 0 -9.81</gravity>
<!--
Vettore del campo magnetico del mondo x y z in tesla, usato dal magnetometro simulato.
-->
<magnetic_field>5.64e-6 2.29e-5 -4.2e-5</magnetic_field>
<!--
Velocità del vento standard SDF, in m/s. Un modello di forze deve usarla per influire
sul moto. Configura onde e correnti dai rispettivi controlli della scena.
-->
<wind>
<linear_velocity>0 0 0</linear_velocity>
</wind>
</world>
</sdf>
L’esempio proviene dal motore Linux. Usa l’esportazione del tuo host, soprattutto su macOS, affinché le librerie dei plugin corrispondano all’installazione.
Usare il terreno generato da te
Genera e seleziona il terreno, poi scarica il suo SDF nella verifica iniziale. Otterrai percorsi e origine geografica corretti. Riporta in questo file le modifiche alla fisica o alla luce.
Per una copia trasferibile, scarica il ZIP del terreno e conserva il mondo accanto alle risorse relative. Il controllo SDF applica impostazioni al terreno salvato corrispondente; non importa il terreno da un ZIP. Prima crea o ripristina il terreno tramite il suo percorso di preparazione.
Confrontare prima di una sessione lunga
Usa lo stesso veicolo, posizione iniziale e sensori nei due test. Verifica passo temporale, rapporto di tempo reale, direzione della luce, camere e movimento. Un fattore richiesto maggiore non garantisce rendering o ricezione dei sensori più rapidi. Conserva l’originale per ripristinare i valori predefiniti o caricare una copia precedente.
Prestazioni e visualizzazione
Il fattore di tempo reale (RTF) misura i secondi simulati per secondo reale. La velocità richiesta è un obiettivo; un RTF inferiore a 1 indica un’esecuzione più lenta del tempo reale. Il passo influisce su contatti, onde, sensori e stabilità del controllo; la latenza di rete su comandi e visualizzazione. Oltre 1× AIS dal vivo viene nascosto. La frequenza delle camere limita gli aggiornamenti visivi.
Dopo una modifica del passo, prova stazionarietà, curve, spazio libero, immersione e ritorno con entrambi i veicoli inclusi.
| Vista | Rendering |
|---|---|
| Immagini dei sensori | Gazebo sull’host del motore |
| Veicolo/mondo personale con browser | GPU del browser |
| Veicolo/mondo personale con Gazebo | Gazebo sull’host; scelta iniziale dell’app |
| Veicolo/mondo del LIVE pubblico | Camere di osservazione Gazebo |
Riduci prima camere superflue, frequenze e risoluzioni. L’illuminazione del browser controlla cielo, riflessi, mappatura tonale e normali dell’acqua; la geometria delle onde usa i campioni del modello fisico.
Confronta i dati grafici nella stessa scena: FPS, tempo fotogramma p95, chiamate di disegno, triangoli, texture e geometria. Il terreno mobile semplifica la geometria visiva distante; vedi Algoritmi di generazione del terreno. Collisioni e sensori hanno costi separati. La scena nel browser continua a usare Gazebo per camere e LiDAR GPU: confronta separatamente FPS video, Hz dei sensori e RTF.
Per dimensionare l’hardware, mantieni mondo, veicolo, frequenze e velocità uguali. Inizia con una sessione, aumentane il numero e includi i picchi di preparazione del terreno. Misura RTF mediano e 5º percentile, durata del passo fisico, ricezione ed età delle immagini, CPU, memoria, GPU e VRAM. La fisica dipende dalle prestazioni per core; terreno e sensori usano anche più core. Numero e risoluzione delle camere aumentano il carico GPU. Gli spettatori LIVE condividono un mondo.
Apple Silicon usa Metal. I motori Docker Ubuntu e Windows/WSL richiedono driver e runtime compatibili con le immagini. LIVE non consuma tempo personale; modelli, caricamenti e cache hanno limiti di archiviazione. Prevedi spazio per motore e modelli. Vedi Account e durata delle sessioni.