WWW-POSIM v0.6.16Documentazione del simulatore
Menu della documentazione
WWW-POSIM / Documentazione del simulatore

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

  1. Seleziona un terreno fisso pronto, scegli il veicolo e apri la verifica prima dell’avvio.
  2. Apri Modifica i file SDF → Scarica SDF del mondo e conserva una copia di world.sdf.
  3. Modifica i campi supportati di fisica e illuminazione. Mantieni modelli del terreno, percorsi, nome del mondo e origine geografica.
  4. Scegli Carica SDF del mondo modificato. La revisione validata compare in Configurazione del mondo e viene selezionata.
  5. 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.

Cerca nella documentazione