Componenti e librerie
WWW-POSIM unisce librerie aperte di simulazione e algoritmi al codice privato dell’applicazione. Offre un’area di lavoro web, un’app installata e API di servizio.
Come è composto WWW-POSIM
Componenti aperti
- POSIMMotore, modelli marini e sensori
- POSIM-TerrainTerreno geografico, mesh e immagini
- POSIM-RoutingNavigazione e pianificazione verificata
- POSIM-ControlPropulsione e politiche di movimento
- POSIM-SLAMStima e mappatura da sensori
Componenti privati dell’app
- Area di lavoro e distribuzioneInterfaccia, viste e video
- Account e sessioniAccesso, permessi, tempo e code
- Mondi e risorse salvatePreparazione, libreria veicoli e archiviazione
- Coordinamento del viaggioItinerario, punti di ripresa e recupero
- Integrazione desktopAvvio, preparazione del motore e pacchetti
POSIM
POSIMPOSIM-Terrain
POSIM-TerrainPOSIM-Routing
POSIM-RoutingPOSIM-Control
POSIM-ControlPOSIM-SLAM
POSIM-SLAMWWW-POSIM
WWW-POSIM — Repository privato; accesso richiesto
L’applicazione collega le librerie ad account, aree di lavoro persistenti e interfacce utente. Sensori e modalità di stima disponibili dipendono dal motore e dai provider installati.
Guide per componente
| Componente | Uso | Riferimento tecnico |
|---|---|---|
| Terreno | Genera il terreno di un’area | Algoritmi di generazione del terreno |
| Pianificazione e controllo | Viaggio intorno al mondo LIVE, Controlla un’area di lavoro locale | Pianificazione delle rotte e controllo |
| Motore e applicazione | Conosci l’area di lavoro, Personalizza i mondi | Simulazione, rendering e sensori |
La libreria del terreno genera dati numerici, immagini e mesh. WWW-POSIM gestisce le tessere residenti, i livelli di dettaglio, la disponibilità delle collisioni e le cache di sessione. La disponibilità pubblica di una libreria non implica che il relativo sensore o estimatore SLAM eseguibile sia installato sull’host.
Il catalogo per la ricerca marina comprende Dinamica marina e rendering, Modelli e parametri dei sensori, Algoritmi di generazione del terreno, Pianificazione delle rotte e controllo, Simulazione, rendering e sensori, Anteprima del sonar fisico e GNSS e navigazione. Ogni capitolo distingue modello, configurazione, uscite e limiti di interpretazione.
Librerie pubbliche
| Libreria | Funzione |
|---|---|
| POSIM | Motore di simulazione, ambienti marini, veicoli e sensori basati su Gazebo |
| POSIM-Terrain | Campionamento geografico Python, selezione di fonti terrestri e marine, esportazione mesh/SDF e texture |
| POSIM-Routing | Pianificatori Python globali, costieri e locali; dipende da POSIM-Terrain |
| POSIM-Control | Politiche di movimento Python e plugin C++ Gazebo di propulsione leader/inseguitore |
| POSIM-SLAM | Librerie indipendenti di stima visiva, acustica e inerziale; le funzioni dell’app richiedono sensori e provider compatibili |
POSIM-Terrain
Combina le fonti disponibili di elevazione e batimetria per costruire terra e fondale. Il campo numerico alimenta mesh e verifiche di collisione dei percorsi; Sentinel-2 fornisce la texture terrestre.
- Ingressi: latitudine, longitudine, dimensioni della regione e campioni di griglia.
- Uscite: quote, mesh, SDF, texture e manifesti delle fonti.
- Uso diretto: generare una regione o caricare un pacchetto urbano.
Il README di POSIM-Terrain descrive installazione, preparazione delle texture satellitari ed esportazione.
POSIM-Routing
Pianifica l’itinerario dei porti e l’accesso alle aree di arrivo. I poligoni terrestri OSM guidano i collegamenti. I pianificatori costieri e locali verificano il terreno rappresentato. La posizione del catalogo portuale e l’obiettivo di arrivo in acqua sono ingressi distinti.
- Ingressi: partenza, destinazione, varchi di passaggio e terreno numerico.
- Uscite: rotte globali, corridoi costieri e waypoint locali.
- Uso diretto: esportare una rotta marittima o pianificare su terreno generato.
Il README di POSIM-Routing contiene comandi e API. Una rotta globale da sola non garantisce la profondità dell’acqua.
POSIM-Control
Applica propulsione ai modelli Gazebo. Il leader segue i waypoint forniti; l’inseguitore segue le pose misurate del leader. Le politiche Python osservano il movimento per limitare la velocità e valutare stabilità, avanzamento e recupero.
- Ingressi: waypoint verificati, velocità richiesta e stato misurato.
- Uscite: comandi di propulsione, stato del controllore e decisioni di movimento.
- Uso diretto: politiche Python o compilazione dei plugin leader/inseguitore.
Il README di POSIM-Control descrive requisiti del modello, compilazione e topic. I plugin nativi richiedono i pacchetti di sviluppo Gazebo in un ambiente POSIM configurato.
Ogni libreria include istruzioni inglesi e coreane, struttura delle sorgenti, installazione e test. WWW-POSIM fissa le revisioni come sottomoduli Git. Gli adattatori importano queste implementazioni e i pacchetti includono le sorgenti selezionate.
git submodule update --init --recursive
Flusso complessivo ed esempi urbani
POSIM-Terrain genera i dati, POSIM-Routing pianifica e verifica i percorsi, POSIM-Control segue i waypoint approvati mentre Gazebo calcola il movimento. WWW-POSIM osserva il risultato e coordina aggiornamenti successivi di terreno, rotte e controllo. Account, titolarità delle sessioni, video, punti di ripresa del viaggio e visualizzazione AIS appartengono all’applicazione.
Web e app installata usano le stesse revisioni. La guida alle librerie POSIM tratta modelli, sensori e motore.
Gli esempi POSIM-Terrain includono New York, Busan e Tokyo, con terra e mare:
- Regione: 20 × 20 km.
- Griglia: 257 × 257 vertici, distanti 78.125 m.
- Fonti: GEBCO 2026, Copernicus GLO-30 e batimetria regionale disponibile.
- File: mesh, SDF, array numerici, texture terrestri Sentinel-2 e manifesti.
- Ogni città include immagini Gazebo e un README per rigenerarla.
Il passo della griglia di uscita non aumenta l’accuratezza delle misure originali. Vedi Algoritmi di generazione del terreno.
Il motore nativo Mac include una modifica locale di Gazebo Sim Sensors sotto Apache-2.0. Sorgenti modificate, ricetta di compilazione, patch, avviso e licenza sono conservati in www-posim/sources/gz-sim-sensors-stop nel motore. Il sensore GNSS POSIM conserva la propria licenza MIT e il relativo avviso.