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

Conosci l’area di lavoro

Inizia con un terreno già pronto e impara a leggere pannelli e strumenti prima di inviare comandi al veicolo.

Accedere e avviare il primo mondo

  1. Registrati su WWW-POSIM, verifica l’email e accedi. Se il messaggio manca, controlla la posta indesiderata o richiedine un altro. La verifica serve anche nell’app installata.
  2. Nell’app scegli Avvia simulatore. Sul sito apri l’area personale; potrebbe esserci una coda per il server.
  3. Apri Area di lavoro, scegli Terreno pregenerato, poi KMOU waterfront · 1 × 1 km.
  4. In Terreno regionale → Veicolo, seleziona WAM-V, profondità 0 m e Autopilot.
  5. Seleziona Avvia mondo generato e attendi il veicolo e dati di posizione recenti. La finestra iniziale dell’app resta aperta finché il mondo non è in esecuzione.
Schermata iniziale con dimostrazioni, terreno pronto, esercitazioni e mondo personalizzato
Schermata iniziale con dimostrazioni, terreno pronto, esercitazioni e mondo personalizzato.
Voce Funzione
Mondi dimostrativi Avvia WAM-V o BlueROV2; le altre anteprime indicano la disponibilità.
Terreno pregenerato Riunisce terreni pronti, scaricabili e già generati.
Area di esercitazione Prepara l’esercizio quando disponibile.
Mondo personalizzato Apre terreno regionale, editor dei veicoli, strumenti RViz e archiviazione.
Posizione → Veicolo → Riepilogo Seleziona terreno, veicolo e posa iniziale; verifica le impostazioni prima dell’avvio.

Scegli Autopilot o ROS 2 diretto prima di avviare. Per cambiare tipo di controllo, avvia un mondo con l’altra opzione. Il cambio di modalità ArduPilot è un’operazione distinta. Rispetta i limiti di coordinate e profondità. Il seme dell’esercitazione accetta interi da 0 a 1 000 000; vuoto genera una disposizione automatica. Esplorazione libera ed esecuzioni di riferimento dell’amministratore ignorano questo seme.

L’app Mac scarica un terreno pronto alla prima selezione, mostrando l’avanzamento. Poi resta disponibile offline con la revisione del contenuto fissata. Se il download fallisce, controlla la connessione e selezionalo di nuovo. La demo WAM-V usa Hong Kong: una boa corallo è 16 m avanti e 5 m a sinistra, una verde lime 30 m avanti e 8 m a destra. Osservale con camera frontale e LiDAR.

Mondi dimostrativi

Orientarsi nell’interfaccia

Area di lavoro in esecuzione con scena, sensori, controllo del veicolo e mappa
Area di lavoro in esecuzione con scena, sensori, controllo del veicolo e mappa.
Zona Contenuto
Barra superiore Veicolo, terreno, stato in diretta, area di lavoro, lingua e pulsanti per ingrandire la scena o nascondere i pannelli. La sessione compare quando si contabilizza il tempo d’uso.
Centro Viste del veicolo, del mondo e della mappa.
Sinistra Ambiente e visualizzazione in Scena; misure in Sensori e topic ROS.
Destra Controlli ArduPilot o ROS 2, seguiti dagli strumenti e dai grafici del veicolo.
Mappa inferiore Posizione geografica, waypoint e comandi di missione in Controllo missione.

Espandi le intestazioni o i pulsanti + / −. Il contenuto scorre nello spazio disponibile; un’altra sezione può ridursi per lasciare posto. Pannelli nasconde o mostra i pannelli. Vista scena ingrandisce la scena mantenendo accessibile la mappa. La simulazione continua. La schermata iniziale offre anche il ritorno alla pagina principale e la disconnessione.

Vista o azione Effetto
Veicolo Segue il veicolo; permette di orbitare e usare lo zoom.
Mondo Panoramica obliqua dell’area vicina, con limiti di zoom e orbita.
Mappa Mappa orientata a nord con posizione simulata; trascina per spostarla.
Trascinamento, tasto destro, rotellina Spostamento, orbita o zoom secondo i suggerimenti della vista.
Cancella traccia Rimuove dalla vista rotta prevista e traccia percorsa. La registrazione riparte dalla posizione corrente e il rapporto di missione resta disponibile.

La bussola inferiore segue la camera di osservazione, non la prua del veicolo. La freccia fissa indica la direzione della camera e le lettere ruotano per individuare il nord. Il tempo visualizzato è quello simulato. 1,00× indica un avanzamento pari al tempo reale.

La rotta prevista è gialla, la traiettoria misurata verde acqua. Restano visibili al massimo 1 024 segmenti. Una nuova missione guidata cancella la traccia Gazebo. Le linee di scena larghe 5 mm non appaiono nelle immagini dei sensori.

Scena, onde e corrente

Pannello della scena con impostazioni dell’ambiente e del rendering
Pannello della scena con impostazioni dell’ambiente e del rendering.
Sezione Uso
Onde Scegli uno stato del mare da 0 a 4 e applica. Le impostazioni avanzate consentono di modificare vento, direzione e ripidità.
Corrente marina Attiva la corrente, scegli flusso uniforme o profilo di profondità e seleziona Applica corrente. Attendi la conferma del solutore.
Traffico marittimo Mostra navi da rapporti AIS recenti; dipende da copertura e velocità della simulazione.
Rendering della scena Sceglie Browser o Gazebo, quando disponibili, e apre gli effetti subacquei.
Visualizzazione Fondale, superficie, griglia e assi; illuminazione e opacità dell’acqua o della mappa quando supportate.
Prestazioni grafiche Statistiche misurate del rendering nel browser.

Le aree libere iniziano con stato del mare 2. Le preimpostazioni usano venti di 0, 1, 3, 6 e 8 m/s e ripidità 1: sono approssimazioni, non altezze d’onda garantite. Il pulsante informativo mostra gli intervalli WMO. Gli esercizi mantengono le condizioni assegnate.

Ferma la missione o il controllo ROS prima di cambiare corrente. Il profilo parte da 0 m di profondità, accetta fino a otto nodi e velocità di 0–1 m/s. Trascina i nodi orizzontalmente per cambiare velocità; la tabella modifica profondità e direzione. 0° indica est, 90° nord, nel verso del flusso. I vettori vengono interpolati linearmente alla profondità reale di ogni link a ogni passo fisico. Sotto l’ultimo nodo resta valida la sua corrente. Il flusso modifica la resistenza relativa all’acqua; le onde mantengono il proprio modello.

L’app installata apre Gazebo per impostazione predefinita. Browser riduce il carico della camera di scena Gazebo; fisica, camere e LiDAR GPU restano calcolati in Gazebo. La selezione vale per la vista aperta. La camera di inseguimento BlueROV2 smorza il movimento e mostra la superficie. Il trascinamento verticale nelle viste compatibili permette di osservare dal basso.

Aspetto subacqueo

Apri Scena → Rendering della scena → Aspetto subacqueo. Le modifiche si applicano alla scena Gazebo e alle immagini a colori delle camere, compreso RGBD. Misure di profondità e geometria di collisione conservano i propri valori.

Gazebo mostra tutti gli effetti; Browser condivide i dettagli della sabbia e le linee del fondale. Il modello visivo usa un livello medio del mare piano e superfici PBR. Materiali non illuminati e shader personalizzati dell’acqua hanno una propria resa. Particelle e motivi di luce sono approssimazioni visive. Foschia, attenuazione e occlusione limitano la visibilità utile oltre al ritaglio geometrico. Consulta Specifiche tecniche e Dinamica marina e rendering.

Sensori e topic ROS

Immagine della camera del veicolo simulato e controlli di ricezione
Immagine della camera del veicolo simulato e controlli di ricezione.

In Sensori, seleziona il veicolo e poi una camera, LiDAR o IMU. La lista dipende dal modello. La camera d’ispezione rivolta verso il basso serve a osservare il fondale.

Controllo Azione
Avvia/interrompi flusso Controlla la ricezione dell’immagine; la simulazione continua.
Ingrandisci / Salva immagine Ingrandisce l’immagine o salva il fotogramma ricevuto.
Frequenza del sensore Richiede una frequenza di consegna; l’indicatore misurato mostra la ricezione effettiva.
Zoom digitale / Ripristina Ingrandisce l’immagine ricevuta o ripristina la scala.
Topic ROS → ricerca → topic Apre il messaggio; la sottoscrizione controlla la ricezione.
Campo / Grafico / Dati grezzi / Disegna Mostra campi numerici o messaggi spaziali compatibili in base al tipo e al riferimento.

La camera di scena è un osservatore esterno. Quella del sensore segue la propria posa sul veicolo. Possono guardare in direzioni diverse.

Stati del flusso

Connessione o In attesa indica che il sensore o il trasporto si sta preparando. Controlla l’ora di ricezione. Un’immagine conservata e segnalata come obsoleta o in riconnessione non è una misura recente. Verifica prima che il mondo sia pronto e il sensore corretto.

La demo pubblica di Hong Kong usa video H.264 condiviso con un buffer iniziale. Le camere personali richiedono immagini JPEG; le immagini ROS compresse seguono un percorso separato. Salvare un fotogramma acquisisce il video visualizzato nella demo e il file immagine ricevuto nell’area personale. Frequenza del sensore, FPS video e fattore di tempo reale sono misure diverse. Consulta Simulazione, rendering e sensori e Visualizzazione con RViz e Foxglove.

ArduPilot e controllo manuale

Pannello ArduPilot WAM-V con armamento e modalità confermati
Pannello ArduPilot WAM-V con armamento e modalità confermati.
Pannello ArduPilot BlueROV2 con le sue modalità
Pannello ArduPilot BlueROV2 con le sue modalità.

Controlla telemetria, armamento e modalità indicata nell’intestazione. Centra gli ingressi manuali e termina o annulla la missione prima di cambiare modalità. Scegli Modalità di volo, applica e verifica il valore ricevuto: il menu esprime una richiesta.

Arma abilita la propulsione dopo le verifiche preliminari. Disarma la disabilita e annulla la missione. Scegliere una modalità non arma il veicolo. In caso di rifiuto, leggi errore e dettagli di connessione; un’immagine della camera non basta a confermare che il controllo sia pronto.

Veicolo Modalità del menu
WAM-V · ArduRover MANUAL: acceleratore e sterzo diretti. HOLD: propulsione neutra, con possibile deriva per inerzia, onde o corrente. STEERING: assistenza di velocità e virata.
BlueROV2 · ArduSub MANUAL: controllo diretto. STABILIZE: stabilizza l’assetto, profondità manuale. ALT_HOLD: aggiunge il mantenimento della profondità, non della posizione orizzontale.

Le missioni verificate richiedono GUIDED e armano il controllore all’avvio. La missione gestisce questa modalità, che non compare nel menu manuale. Vedi Missioni con autopilota.

Pannello di ingresso manuale tramite mouse, touch o gamepad
Pannello di ingresso manuale tramite mouse, touch o gamepad.

Attiva l’ingresso joystick e scegli mouse/touch o gamepad. WAM-V offre acceleratore e sterzo; BlueROV2 aggiunge movimento laterale e verticale. Inizia con ingressi centrati e guadagno basso. Ferma input annulla la pressione corrente: rilascia e premi di nuovo per riprendere. Anche perdita di focus, disarmo, cambio di sorgente o comando rifiutato terminano la pressione.

Con il gamepad, tieni premuto LB/L1 mentre usi gli stick. Rilasciarlo invia un ingresso neutro; non disarma né ferma immediatamente un veicolo in moto. Su BlueROV2, Y/Triangolo richiede ALT_HOLD e A/Croce, STABILIZE. Verifica la modalità ricevuta. Tutte le associazioni sono in Controllo manuale e gamepad.

Mappa e missioni

I nuovi punti subacquei partono da 2 m. L’intervallo normale è 0–10 m; nelle scene di ispezione supportate, consultare il Limiti di profondità delle missioni mostrato dal server.

Mappa di controllo con waypoint e comandi di missione
Mappa di controllo con waypoint e comandi di missione.

Completa coordinate e profondità prima di verificare la rotta. I punti di superficie usano 0 m; ogni punto della mappa prevede un’attesa di un secondo. Durante la modifica, i campi vuoti restano vuoti.

Azione Effetto
Clic / clic destro Aggiunge un punto / rimuove un punto vicino. Trascinamento, rotellina o gesto di pinza spostano e ingrandiscono la mappa.
Ritorna alla partenza / Cancella Imposta il ritorno / elimina i punti modificabili.
Verifica percorso Calcola un’anteprima verificata sul terreno. Controlla percorso, margine e impedimenti.
Avvia percorso Avvia la rotta verificata e arma dopo i controlli.
Ferma / Continua / Interrompi Mantiene un obiettivo di attesa / riprende / annulla e disarma.

Verifica di nuovo prima di un’altra esecuzione, perché il veicolo può essersi spostato. I punti della mappa hanno priorità sugli scenari predefiniti: cancellali per usare uno scenario. La verifica valuta terreno e distanza dello scafo, senza garantire l’evitamento di navi in movimento o la conformità al COLREG. Vedi Missioni con autopilota.

Strumenti del veicolo

Strumento d’assetto, grafici, velocità di simulazione, posizione e connessione
Strumento d’assetto, grafici, velocità di simulazione, posizione e connessione.

Il marcatore blu fisso rappresenta il veicolo. L’orizzonte mobile mostra rollio e beccheggio. La prua usa 0° nord, 90° est, 180° sud e 270° ovest. La profondità è −Z rispetto al livello zero del mare: positiva sotto, negativa sopra. Non è la distanza dal fondale.

Il grafico conserva le ultime 100 pose ricevute. Scegli profondità, prua, beccheggio, rollio, velocità o spinta richiesta. Profondità, assetto e velocità provengono dal simulatore. La velocità mostra X avanti, Y a sinistra e Z in alto, in m/s. La spinta rappresenta comandi in newton, non una forza misurata. Dati assenti o obsoleti producono interruzioni o —. Profondità e assetto condividono acquisizione e tempo; la demo li allinea al video.

Velocità e passo fisico

La selezione viene inviata subito. Attendi la conferma.

Impostazione Valori
Velocità richiesta 0,25×, 0,5×, 1×, 2× e 4×
Passo fisico 5, 10 o 20 ms; compare anche 30 ms se il mondo lo usa già
Effettiva Tempo simulato diviso per tempo reale; può essere inferiore al valore richiesto

Il veicolo deve essere disarmato, il terreno pronto e i flussi di missione o controllo manuale/ROS inattivi. AIS non è disponibile oltre 1×. Windows e Linux partono da 20 ms, Mac nativo da 10 ms. Gli esercizi mantengono il passo obbligatorio di 10 ms. Vedi Personalizza i mondi.

Posizione e connessioni

N/E/D indica nord, est e basso in metri dall’origine locale. Le coordinate geografiche sono latitudine e longitudine in gradi. R/P/Y · ENU mostra gli angoli grezzi: imbardata 0° verso est, 90° verso nord. Lo strumento mostra beccheggio −P e prua (90 − Y + 360) % 360.

I dettagli di connessione indicano sequenza, età e riferimento ENU della posizione. Una sequenza crescente e dati recenti confermano nuove acquisizioni. Il pannello di controllo ha diagnostica separata. RViz apre il visualizzatore supportato: RViz2 nativo nell’app, visualizzatore web nel browser. Serve un mondo pronto e, nell’app, il servizio RViz disponibile. Vedi Visualizzazione con RViz e Foxglove. I parametri ArduPilot si leggono, esportano e modificano nel proprio pannello; le modifiche consentite si applicano disarmati e vengono verificate rileggendo i valori.

Controllo ROS 2 diretto

Pannello ROS 2 con abilitazione, arresto e diagnostica
Pannello ROS 2 con abilitazione, arresto e diagnostica.

Abilita ROS per accettare comandi limitati dal controllore collegato. Ferma ROS mantiene l’uscita neutra fino alla nuova abilitazione. La diagnostica mostra motivo, sequenza applicata, conferma e spinte. Il watchdog riporta le uscite a neutro se i comandi smettono di arrivare. Segui Terminali ROS e connessione, Controlla un’area di lavoro web o Controlla un’area di lavoro locale.

Salvare e trasferire risorse

In Area di lavoro → Mondo personalizzato → Archiviazione, controlla terreni, revisioni dei veicoli, configurazioni dei mondi, cache e spazio libero. Archiviare nasconde una risorsa senza rimuoverne i file o liberare spazio. Ripristinare la rende nuovamente selezionabile. Attendi la fine delle sessioni che la usano.

Esportazione/importazione ZIP trasferisce il veicolo con le risorse. Modificare una copia crea una revisione nuova. Prima dell’avvio puoi scaricare i file SDF di veicolo e mondo, modificarli e caricare una revisione compatibile. Vedi Prepara il veicolo, Personalizza il veicolo e Personalizza i mondi.

Schermi piccoli e stati di attesa

Sul telefono, i pulsanti inferiori aprono un solo pannello scorrevole. Chiudilo con × o Escape per tornare alla scena. In orizzontale si dispone accanto ai controlli. La vista desktop della demo pubblica ridimensiona l’intera disposizione; in verticale invita a ruotare il telefono. Lo schermo intero dipende dal browser e da un’azione dell’utente.

Un pulsante disabilitato indica spesso preparazione incompleta, terreno in attesa, missione attiva o comando in corso. Leggi lo stato prima di riprovare. Nascondere pannelli, cancellare tracce, fermare immagini o annullare una sottoscrizione non ferma il veicolo. Al termine chiudi la sessione. Chiudere l’app installata arresta i servizi locali e la generazione del terreno, conservando i dati salvati.

Credenziali AIS

Le demo usano la chiave AISStream del server. In sua assenza, quelle installate usano il flusso AIS pubblico di Open Waters. Il pannello mostra provider e stato; le navi visibili dipendono da rapporti recenti.

Per un mondo personalizzato inserisci la tua chiave in Scena → Traffico marittimo e salvala localmente. Resta in questo browser e viene inviata al server di simulazione selezionato. Rimuovere la chiave locale la cancella dal browser. Attiva il traffico per connetterti. Vedi Simulazione, rendering e sensori.

Controllare con QGC

Per un veicolo Autopilot, seleziona Open QGC nel pannello ArduPilot. Tieni aperti l’app installata e l’area di lavoro con accesso effettuato. La finestra prepara il veicolo e passa il controllo a QGroundControl. Consulta Controllare con QGC per installazione, connessione e rilascio del controllo.

Luci anteriori BlueROV2

Usare Luci anteriori nel joystick per commutare entrambe le lampade BlueROV2 ON/OFF. La lettura conferma lo stato effettivo; un comando fallito o indisponibile non viene indicato come riuscito. Le luci del veicolo sono indipendenti da giorno/notte della scena e scelta della camera.

Cerca nella documentazione