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

Specifiche tecniche

Valori predefiniti di ambiente, dati, fisica e interfacce. Le differenze per piattaforma o mondo sono indicate separatamente.

Software

Voce Specifica
ROS ROS 2 Lyrical
Gazebo Jetty · Gazebo Sim 10; macOS: 10.5.0
Autopilota di superficie ArduRover 4.7.2 · SITL
Autopilota subacqueo ArduSub 4.7.2 · SITL
Sorgente ArduPilot fb773567896014da007bca58358704d4a0d8516f
Grafica del browser Three.js 0.186.1 · React Three Fiber 9.8.1

Tempo di simulazione

Voce Specifica
Velocità obiettivo predefinita 1×
Passo fisico macOS 10 ms
Passo fisico Windows/Linux 20 ms
Passo di valutazione 10 ms
Passo del server web Configurazione del server

Le frequenze usano il tempo simulato. Fattore di tempo reale (RTF), frequenza fisica, frequenza del sensore e FPS di visualizzazione sono misure distinte.

Fisica e rendering

Voce Specifica
Corpi rigidi e contatti Gazebo Physics; DART predefinito
Dinamica marina Campo d’onda, galleggiamento e idrodinamica Wave Sim
Idrodinamica BlueROV2 Galleggiamento sensibile alle onde e smorzamento lineare/angolare
Viste e sensori Gazebo Ogre2 sull’host del motore; Metal su macOS
Scena del browser Three.js/WebGL: terreno, veicoli e acqua dallo stato simulato
Geometria delle onde nel browser Campioni del solutore fisico

Estensione di terreno, acqua e fondale

Voce Specifica
Terreno della demo WAM-V Hong Kong preparato: centro 2 × 2 km, dintorni 6 × 6 km; quote/profondità e immagini aeree
Mondo personalizzato predefinito Area fissa 1 × 1 km; terreno su richiesta opzionale
Regione iniziale su richiesta 1 000 × 1 000 m · 129 × 129
Passo numerico su richiesta 7,8125 m
Tessera predefinita 1 000 × 1 000 m
Fondale richiesto nell’area personale 5 × 5 tessere · 5 × 5 km
Fondale richiesto in LIVE 7 × 7 tessere · 7 × 7 km
Regione fissa senza streaming 1 × 1 km · 513 × 513 · 1,953125 m
Tessera fisica periodica delle onde 256 × 256 m · 64 × 64 celle
Acqua dettagliata personale in Gazebo 3 × 3 tessere · 768 × 768 m
Tessere visive delle onde LIVE 15 × 15 tessere · 3 840 × 3 840 m

La tessera di calcolo delle onde, l’acqua visibile, il terreno numerico e il fondale di collisione caricato hanno estensioni diverse. Le tessere ripetute condividono un campo periodico, non simulazioni indipendenti. Le dimensioni delle griglie contano campioni; il campo FFT conta celle. La demo usa Hong Kong, gli esercizi un’arena dedicata con fondale piano a 20 m. Vedi Algoritmi di generazione del terreno.

Generazione del terreno su richiesta

Voce Specifica
Preparazione Scarica quote/profondità e immagini terrestri disponibili; proiezione metrica locale
Costruzione delle tessere Mesh visive e di collisione condividono campioni; bordo di due celle per continuità
Inserimento in Gazebo Entità SDF reali alle coordinate locali
Verifica Presenza delle entità, profondità RGBD e contatto con una sfera di raggio 0.25 m e massa 10 kg; distanza dalla mesh che tiene conto della pendenza · Verifica fisica del terreno
Precaricamento Fila esterna secondo posizione/velocità: anticipo 120 s, minimo 250 m, massimo 40 % di una tessera
Attesa e ripresa Attende se manca copertura; riprende dopo la verifica dell’intero quadrato corrente
Cache e permanenza Riusa campioni e tessere recenti; rimuove entità lontane entro un budget limitato

Dataset

Voce Specifica
GEBCO 2026 Quote e batimetria globali; griglia nativa di 15 secondi d’arco
Copernicus GLO-30 Quote terrestri; 30 m nominali
Copernicus Marine 202511 Batimetria costiera regionale dove disponibile
EMODnet DTM 2024 Batimetria regionale, soprattutto europea
KHOA BADA2024 Batimetria coreana opzionale
Cesium World Bathymetry Preferito con accesso numerico autorizzato configurato
OpenStreetMap Affinamento della costa e del confine terra/acqua
Sentinel-2 RGB Immagini terrestri; 10 m nominali

Il mondo registra le fonti effettivamente usate. Ridurre il passo della mesh non aumenta l’accuratezza delle misure originali.

Modelli dei veicoli

Voce Specifica
Propulsione WAM-V 2: sinistra e destra
Propulsione BlueROV2 6
Massa WAM-V Scafo 180 kg; totale 211,151 kg
Massa BlueROV2 Scafo 10 kg; totale ≈10,0132 kg
Ingombro di collisione WAM-V 5,006 × 2,487 × 1,291 m
Scatola di collisione BlueROV2 0,457 × 0,338 × 0,065 m
Luci anteriori BlueROV2 Due faretti anteriori; ON predefinito; raggio di attenuazione del modello 25 m
Dimensioni complessive BlueROV2 del produttore 0,457 × 0,338 × 0,254 m

Le dimensioni di collisione descrivono la geometria simulata, non l’intero prodotto fisico. Le masse totali sommano i link SDF.

Sensori e stati predefiniti

Voce Specifica
GNSS WAM-V Predefinito; 5 Hz; latenza 0,2 s; GPS_INPUT → EKF
GNSS satellitare BlueROV2 Attivo per impostazione predefinita; disattivazione esplicita; controllo d’immersione; riacquisizione 3 s
IMU WAM-V 200 Hz
IMU BlueROV2 1 000 Hz configurati; limitati dal passo fisico
RGB frontale, entrambi i veicoli 640 × 480 px · 5 Hz · HFOV 1,05 rad (60,2°)
RGB-D d’ispezione BlueROV2 640 × 480 px · 5 Hz · HFOV 60,2°; 45° verso il basso
LiDAR 2D WAM-V 5 Hz; 360 campioni su 360°; 0,2–50 m; risoluzione 0,02 m
Magnetometro BlueROV2 20 Hz · Gazebo
Odometria WAM-V 20 Hz
Odometria BlueROV2 100 Hz

Le camere si attivano su richiesta. Il connettore ROS standard consegna JPEG fino a 1 Hz simulato. L’odometria è stato del simulatore, non un sensore fisico di posizione con errore. La frequenza pubblicata può essere inferiore a quella configurata. HFOV indica il campo visivo orizzontale.

GNSS e navigazione definisce qualità, riferimenti dell’antenna e recupero. L’editor può cambiare sensori, montaggi e impostazioni. I topic generati usano /vehicle/sensors/{sensor_id} con suffissi specifici delle uscite; consulta lista attiva e sensor-manifest.json. Personalizza i sensori distingue DVL, Ping e multibeam. Metodi, parametri SDF, rumore e validità sono in Modelli e parametri dei sensori.

Clipping e visibilità delle camere

Voce Specifica
RGB frontale WAM-V integrato near 0,1 m · far 5 000 m
RGB frontale BlueROV2 integrato near 0,1 m · far 5 000 m
RGB-D d’ispezione BlueROV2 near 0,1 m · far 80 m
Camere dell’editor Impostazioni salvate, separate dalle camere integrate
Camera di scena personale Gazebo near 0,1 m; far = max(5 000 m, 16 × diagonale 3D del terreno)
Camere di scena LIVE Gazebo near 0,1 m · far 5 000 m · 1280 × 720 px
Camera World/Vehicle del browser near adattivo 0,03–40 m; far ≥8 000 m, esteso secondo mondo e distanza

near e far delimitano il disegno geometrico. Attenuazione subacquea, occlusione, terreno caricato e copertura delle immagini possono ridurre la visibilità utile. Camere di scena e sensori del robot sono separati.

Topic e messaggi ROS

Voce Specifica
/clock rosgraph_msgs/msg/Clock
/model/{robot}/odometry nav_msgs/msg/Odometry
/model/{robot}/imu sensor_msgs/msg/Imu
/model/{robot}/camera/compressed sensor_msgs/msg/CompressedImage · JPEG ≤1 Hz
/model/wamv/scan sensor_msgs/msg/LaserScan
/model/bluerov2/inspection/image/compressed sensor_msgs/msg/CompressedImage · RGB
/tf, /tf_static tf2_msgs/msg/TFMessage
/mavros/battery sensor_msgs/msg/BatteryState · Autopilot
/wwos/cmd_vel geometry_msgs/msg/TwistStamped · WAM-V · ROS 2
/wwos/thrusters std_msgs/msg/Float64MultiArray · ROS 2 · N

{robot} è wamv o bluerov2. Il connettore espone l’RGB d’ispezione; la profondità RGBD è un’uscita nativa separata. Un watchdog di 0,75 s riporta i comandi a neutro se non vengono aggiornati.

Coordinate, unità e ipotesi

Voce Specifica
Coordinate geografiche WGS 84; latitudine/longitudine in gradi
Assi locali ENU: est/nord/alto
Assi corporei Gazebo FLU: avanti/sinistra/alto
Assi corporei ArduPilot FRD: avanti/destra/basso
Assi di navigazione ArduPilot NED: nord/est/basso
Unità ROS m · s · m/s · rad/s · m/s² · N

Le conversioni di riferimento avvengono all’interfaccia dell’autopilota. Questi parametri descrivono un modello e non implicano autonomia, profondità nominale o accuratezza del prodotto reale.

Riferimenti

Cerca nella documentazione