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

Algoritmi di generazione del terreno

Quote e profondità numeriche definiscono il terreno. OpenStreetMap fornisce la maschera della costa, Sentinel-2 i colori della terraferma. Geometria, costa e immagini hanno funzioni distinte.

Catena di elaborazione

  1. 1. Area → griglia metrica

    Proietta il centro WGS 84 in un sistema azimutale equidistante locale, AEQD. Campiona N × N punti: x est, y nord, z alto. Passo = larghezza / (N − 1).

  2. 2. Quote e profondità

    Interpola GEBCO come base e GLO-30 sulla terraferma. Per ogni vertice in acqua sceglie una profondità regionale valida: prima i dati numerici Cesium autorizzati, poi le altre fonti ordinate per passo nativo.

  3. 3. Poligoni terrestri OSM

    Legge lo shapefile derivato da OSM, verifica EPSG:4326, ritaglia celle di atlante da 0,05° e unisce i poligoni in land.json. La costa non viene ricavata dal colore delle immagini.

  4. 4. Atlante satellitare verificato

    Cerca scene recenti Sentinel-2 L2A tramite STAC. Controlla RGB e classificazione; ammette al massimo il 5 % di pixel locali non validi, incluse nuvole e ombre. Conserva data di acquisizione e impronte.

  5. 5. Applicare la costa ai dati numerici

    Shapely verifica quali vertici appartengono alla terraferma. Assegna quote GLO-30 finite al suolo e profondità documentate all’acqua. Le correzioni costiere richiedono misure marine vicine. Un candidato incompleto viene scartato e la fonte alternativa registrata.

  6. 6. Mesh fisiche e visive

    Triangola la griglia per le collisioni. Genera mesh visive complete e ridotte, mantenendo bordi e transizioni costiere. Proietta le immagini terrestri con coordinate UV e ripete la sabbia sul fondale. L’acqua animata è separata.

  7. 7. Verificare e salvare

    Esporta SDF, mesh, matrici e provenienza, quindi esegue gz sdf -k. Le aree automatiche con terraferma attendono immagini verificate. Salva risorse complete oppure segnala l’errore. Annullare interrompe il lavoro e rimuove i dati parziali.

  8. 8. Movimento, LOD e copertura

    Nei mondi a caricamento progressivo, il tassello del veicolo determina il dettaglio. Prepara i successivi, verifica le collisioni e sostituisce le mesh visive. Le collisioni complete restano invariate; tornando indietro riutilizza la geometria salvata.

LOD: dettaglio vicino al veicolo

Il livello di dettaglio, LOD, riduce la geometria visiva lontana. Dipende dal tassello del veicolo, non dallo zoom della camera, e riguarda sia terraferma sia fondale.

Copertura di cinque tasselli per cinque: nove centrali con passo visivo uno, anello esterno con passo quattro. Le collisioni mantengono la griglia completa.
Copertura personale. LIVE usa un anello più ampio; entrambi mantengono il dettaglio completo nei 3 × 3 tasselli centrali.
Area Metodo
Vicina 3 × 3 tasselli, passo visivo 1: viene disegnato ogni vertice numerico.
Lontana Passo 4: un punto interno ogni quattro per asse. Restano tutti i bordi e le celle di transizione costiera o di acque basse. Delaunay collega i vertici; non è una griglia uniforme 33 × 33 né una riduzione esatta di sedici volte dei triangoli.
Texture Terra e acque basse lontane usano un quarto di larghezza e altezza, minimo 32 pixel. I tasselli condividono una texture ripetuta del fondale.
Movimento Il quadrato centrale segue il veicolo nel nuovo tassello. I tasselli in avvicinamento acquistano dettaglio; quelli alle spalle lo riducono finché rimangono caricati.
Fisica e rotte Dati numerici e collisioni completi non cambiano. Vertici di bordo condivisi evitano fessure tra livelli.

I sensori basati sul rendering osservano la mesh visiva selezionata. Una collisione completa non garantisce quindi la stessa immagine lontana ai due livelli. Per ispezionare un oggetto, mantienilo nell’area dettagliata e controlla l’uscita del sensore.

Durante la sostituzione, la mesh precedente resta presente finché la nuova non viene osservata. Se la conferma scade ma una posa nativa recente conferma la precedente, il livello rimane invariato e si riprova dopo 30 s. Il candidato fallito viene rimosso e la sua assenza verificata prima del successivo. Un errore di pulizia resta segnalato.

La collisione di un tassello nuovo viene creata una sola volta. La conferma visiva può tentare tre volte. Il tassello viene ammesso solo dopo controlli visivi, di profondità e di contatto. La copertura mancante mantiene il veicolo in attesa.

Modalità del terreno

Modalità Griglia e politica visiva
Area personalizzata fissa 1 × 1 km, 513 × 513 campioni, circa 1,95 m. Nessun LOD mobile.
KMOU, New York e Hong Kong preparati Centro 513 × 513: KMOU 1 × 1 km, gli altri 2 × 2 km. Intorno 6 × 6 km, griglia misurata separata, collisioni complete e mesh esterne ridotte fisse. KMOU ha anche un anello centrale. L’esterno non aumenta automaticamente il dettaglio all’avvicinarsi del veicolo.
Personale a caricamento progressivo Tasselli da 1 km, 129 × 129 campioni, 7,8125 m. Copertura richiesta 5 × 5; centro 3 × 3 a passo 1, anello a passo 4.
LIVE Copertura richiesta 7 × 7, stesso centro dettagliato 3 × 3. Tasselli recenti e precaricati possono estendere quelli residenti.

LOD è automatico, senza cursore manuale. Vedi Genera il terreno di un’area e Viaggio intorno al mondo LIVE.

Tecnologie geospaziali

Tecnologia Ingresso, metodo e risultato
Proiezione locale PyProj trasforma WGS 84 in AEQD centrata sull’area, con longitudine sempre al primo asse. L’origine mobile allinea le coordinate attive. Produce x/y metriche e sistema di riferimento registrato, distinti da latitudine/longitudine e origine FCU.
Campionamento raster SciPy interpola finestre GEBCO e quote terrestri sulla griglia richiesta. I metadati regolano assi e NoData. Passo prodotto, risoluzione originale e accuratezza sono grandezze diverse.
Scelta regionale Cesium numerico autorizzato ha priorità. Gli altri fornitori seguono il passo nativo e vengono accettati per singolo vertice marino valido. Restano identificativi per vertice e fonti. L’accesso alle immagini non fornisce batimetria numerica.
Supporto costiero Ricostruisce celle marine classificate come terra da dati grossolani usando misure vicine reali, LinearNDInterpolator e controllo cKDTree. Ripiego sul punto marino più vicino entro 1,5 km; KHOA richiede 225 m. Non inventa una profondità costante.
Maschera terrestre Unione e test punto-poligono Shapely su OSM, con quote finite. Il colore non decide la navigabilità.
Immagini Selezione STAC, classificazione, riproiezione Rasterio e verifiche di qualità separate. Metadati di acquisizione e fonte. Hong Kong preparato usa fotografie aeree attribuite.
Geometria Griglie triangolate per le collisioni, materiali separati per terra, acqua bassa e fondale. LOD conserva bordi e costa. Produce SDF, mesh e texture con carichi fisici e visivi distinti.

Download e integrità della cache

Le celle costiere vengono verificate per aggiornamento e checksum prima del riuso. Una cache completa evita di preparare l’archivio mondiale delle coste. Celle mancanti o non valide avviano l’aggiornamento.

I sottoinsiemi GEBCO usano un indice SQLite. Modifiche a dimensione o data aggiornano la voce; i candidati vengono ricontrollati tramite URL, SHA-256 del file originale e assi. Senza indice, subentra una scansione verificata della cache.

I download regionali passano da un file temporaneo. Se disponibile, Content-Length deve corrispondere ai byte ricevuti. I NetCDF KHOA devono esporre esattamente Lat, Lon e MSL, con matrici non vuote e ultimi elementi leggibili. Solo dopo la verifica il file entra nella cache permanente. Un file esistente respinto resta disponibile per la diagnosi.

Verifica fisica del terreno

WWW-POSIM verifica ogni tassello caricato con una camera RGBD rivolta verso il basso e una sfera temporanea. La camera misura la profondità del terreno renderizzato. Gazebo lascia cadere la sfera sulla mesh di collisione e conferma il contatto con nuove misure di posa prima di accettare il tassello.

File e riproducibilità

File Utilità
projected.npz e metadati Matrici x/y/quota nel loro riferimento; confronto con percorsi e misure.
manifest.json e fornitori Limiti, campioni, selezione fonti, impronte e identità compatibile di motore e librerie. La cache vale per tale identità.
SDF e collisioni Superficie di contatto e composizione effettive; una schermata non le sostituisce.
Mesh visive, texture e LOD Riproduzione di immagini e sensori visivi, separata dall’accuratezza delle collisioni.

WWW-POSIM coordina generazione, precaricamento, permanenza e sostituzione attorno a POSIM-Terrain. La collisione deve essere confermata prima di avanzare. Risorsa pronta, tassello fisico caricato e immagine corrente sono stati diversi.

La versione selezionata di POSIM-Terrain include terrain.py, terrain_sources.py, bathymetry.py, coastal_detail.py, floating_origin.py e seabed_visual.py. Consulta manifest.json e source-providers.json.

Terreni preparati e immagini

Terreno Centro: latitudine, longitudine Immagini
KMOU waterfront 35.077175, 129.085815 Sentinel-2
Porto di New York 40.70044, −74.004885 NYC OTI, 2024
Porto di Hong Kong 22.2899, 114.168169 Lands Department, ottobre 2018 / gennaio 2019

Ogni centro contiene 513 × 513 campioni; su 2 km il passo è circa 3,91 m. L’intorno di 6 × 6 km forma 3 × 3 tasselli da 2 km, con quote/profondità misurate e visuali ridotte. KMOU aggiunge un anello centrale. La demo WAM-V usa lo stesso terreno Hong Kong.

New York e Hong Kong includono texture centrali 4096 × 4096, circa 49 cm/pixel. Le immagini native hanno risoluzione di 6 pollici e 20 cm, rispettivamente. Il dettaglio visivo non migliora l’accuratezza della profondità. La generazione automatica usa Sentinel-2.

Le immagini di New York sono sotto CC BY 4.0, NYC OTI. Quelle di Hong Kong provengono dal Lands Department del governo della RAS di Hong Kong / portale CSDI, tassello T11-SW-B, pubblicato nel 2023. Sono ritagliate, riproiettate e ricampionate. Le attribuzioni accompagnano ogni download.

Le aree automatiche con terraferma attendono immagini verificate. In caso di errore, ripristina l’accesso e riprova. Un’area salvata senza immagini va rigenerata. Aree interamente acquatiche possono completarsi senza immagini terrestri. Browser e Gazebo condividono il colore senza cambiare le collisioni. Gli esercizi mantengono la loro arena piana.

Disponibilità, annullamento e nuovo tentativo

Il download mostra file, dimensioni ricevuta/totale, percentuale e velocità. Senza dimensione totale nota mostra quantità ricevuta e velocità. Arresta interrompe attività e download; i file sorgente completati restano riutilizzabili.

Un terreno preparato scaricato rimane pronto. Questo stato riguarda le risorse: dopo l’avvio controlla anche posizione e sensori recenti. File mancanti o motore incompatibile richiedono download o rigenerazione secondo l’indicazione. Seleziona il terreno salvato e avvia quel mondo per visualizzarlo.

Usa Arresta nell’app oppure Annulla durante la preparazione web. Attendi la pulizia prima di riprovare o cambiare mondo. Preparazione, posto sul server e mondo attivo sono distinti. Se non vedi la costa, riduci lo zoom in Mondo, apri Mappa e controlla fondale e sovrapposizione cartografica.

Fonti e aspetto

Fonte Ruolo
Cesium World Bathymetry Priorità se è configurato l’accesso numerico autorizzato.
Copernicus Marine Batimetria costiera regionale dettagliata.
EMODnet Profondità regionali, soprattutto europee.
KHOA Profondità coreane opzionali.
GEBCO Quote e profondità globali di base e ripiego.
Copernicus GLO-30 Quote terrestri costiere.
OpenStreetMap Confine terra/acqua.
Sentinel-2 RGB Colore terrestre, risoluzione nominale 10 m.

Verifica copertura e accesso presso Cesium, Copernicus Marine, EMODnet e GEBCO. L’interfaccia identifica la fonte utilizzata.

Costa verificata e immagini limpide consentono l’affinamento. La terra usa GLO-30, l’acqua profondità supportate da misure. Le quote corrette alimentano rendering, collisioni, sensori e rotte. Le profondità sconosciute sono escluse dalle rotte. Senza affinamento valido restano in uso le fonti numeriche disponibili.

Le immagini possono applicarsi indipendentemente dall’affinamento costiero. L’avvio verifica quelle disponibili. L’app conserva le cache complete in data/providers. Durante l’estensione progressiva, immagini mancanti vengono richieste di nuovo in background e appaiono dopo la verifica senza cambiare terreno numerico o collisioni.

Il mondo progressivo parte da 1 × 1 km e prepara i vicini fino a completare la copertura. Conserva tasselli recenti, aggiunge/rimuove entità in sequenza e riprova quelli mancanti. I comandi si sospendono prima di zone prive di collisioni o copertura sensore verificate. I bordi condividono campioni; tornando indietro si ricarica la geometria salvata. Le aree fisse conservano 513 × 513 punti. Le distanze costiere LIVE sono in Viaggio intorno al mondo LIVE.

Sabbia e linee del fondale

La sabbia è inizialmente attiva, le linee disattivate. Modificale in Scena → Rendering della scena → Aspetto subacqueo. Le impostazioni interessano Gazebo e le camere a colori.

La texture è Aerial Beach 01 di Rob Tuytel, sotto CC0, con mappe 2K di colore, normali e rugosità ripetute ogni 30 m. È sabbia generica disponibile offline. Le quote numeriche definiscono geometria e profondità.

Risoluzione della fonte, passo della mesh, LOD e risoluzione dell’immagine sono diversi. Una mesh più fine non crea misure mancanti; elementi costieri stretti possono non essere risolti.

Genera il terreno di un’area · Pianificazione delle rotte e controllo · Simulazione, rendering e sensori

Generare un atlante dei materiali del fondale

Scarica ed estrai lo ZIP con generatore e materiali. Lo script Python è disponibile anche separatamente. Servono Python 3.10 o successivo, NumPy e Pillow. Esegui i comandi nella cartella estratta.

python -m pip install numpy pillow
python generate_seabed_materials.py --materials materials --output output --bounds -3000 -3000 3000 3000 --seed 321 --region-m 240 --detail-m 4 --size 1024 --green-zones materials/kmou-green-zones.json

Il generatore miscela otto materiali nelle coordinate del mondo: vegetazione rossa, vegetazione rossa e verde densa, fondale blu e pietre miste, bianche e nere. La stessa seed mantiene continua la distribuzione fra aree adiacenti generate separatamente. Sono texture cromatiche sintetiche: non aggiungono altezza delle piante, geometria delle pietre, collisioni o batimetria misurata.

L’esempio copre 6 × 6 km con 1024 × 1024 pixel, circa 5,86 m per pixel. È una panoramica che non risolve piccole piante e pietre. I bounds sono coordinate locali est/nord in metri, non latitudine/longitudine. La riga superiore corrisponde al massimo nord.

La nuova cartella contiene albedo.png e manifest.json con limiti, impostazioni e hash. Le cartelle esistenti vengono rifiutate. --tile-m divide l’area; --size indica quindi la dimensione di ogni tassello. Il limite predefinito totale è 67.108.864 pixel. Riduci estensione o risoluzione, oppure imposta --max-total-pixels dopo aver verificato memoria e spazio. INCOMPLETE.txt indica un risultato incompleto.

Con --green-zones materials/kmou-green-zones.json, il materiale aggiuntivo verde marino scuro si concentra intorno alle impronte dei tre relitti KMOU. Il JSON definisce x/y locali, core_m, fade_m e strength per ogni zona. Senza questa opzione, il generatore autonomo non deduce le posizioni dei relitti. --region-m 240 crea ampie zone dominanti con transizioni fra materiali adiacenti. Conserva insieme versione del generatore, hash degli input e seed per riprodurre l’atlante.

I dintorni prevalentemente verdi sono un progetto visivo per studiare il riconoscimento RGB difficile. Non dimostrano le prestazioni del sonar. Geometria e impostazioni sonar sono fattori distinti; il confronto richiede osservazioni effettive di camera e sonar.

Anteprima dell’output del generatore: atlante cromatico generato, non una schermata del terreno o un’immagine di un sensore nativo.
Anteprima dell’output del generatore: atlante cromatico generato, non una schermata del terreno o un’immagine di un sensore nativo.
Cerca nella documentazione