Modelli e parametri dei sensori
Questo catalogo descrive come si producono le misure: sensori di rendering e cinematici Gazebo, plugin acustici POSIM e adattatori dell’app. Integrato indica il robot fornito; editor, un veicolo appena generato; provider, una funzione che richiede il relativo plugin compatibile. SDF finale e sensor-manifest.json definiscono la configurazione salvata.
Dalla simulazione alla misura
- Stato fisico o geometria renderizzata
Gazebo fornisce movimento, campi del mondo o intersezioni dei raggi. Ogni sensore ha trasformazione di montaggio e clock di acquisizione.
- Modello di misura
Il plugin proietta immagini, genera misure inerziali, risolve velocità dei fasci o calcola ritorni acustici. Qui si applicano rumore e validità.
- Messaggi e sistemi di riferimento
Bridge ROS–Gazebo e adattatori POSIM conservano le misure, assegnano riferimenti, convertono unità e segnalano dati indisponibili.
- Algoritmo o visualizzazione
Controllori e stimatori usano misure con timestamp. Le immagini dell’interfaccia possono essere compresse, memorizzate in buffer o trasmesse a frequenza inferiore.
Configurazione e tempi comuni
| Parametro | Significato |
|---|---|
sensor/@type, gz:type |
Scelgono camera, rgbd_camera, gpu_lidar, imu, magnetometer o GNSS/DVL/multifascio personalizzato. Il mondo deve caricare anche il sistema corrispondente. |
pose |
x/y/z in metri e rollio/beccheggio/imbardata in radianti rispetto al link padre. Editor: posizioni ±10 m, ciascun angolo ±2π. |
update_rate |
Acquisizioni richieste per secondo simulato; editor 0,1–30 Hz. Passi fisici, rendering e trasporto possono ridurre la frequenza osservata. Aumentarla non crea stati fisici intermedi. |
always_on, connessioni |
Attivazione. Le camere integrate si attivano su richiesta; i sensori dell’editor usano always_on=true. Un provider o renderer che non parte può impedire le misure. |
topic, frame_id, TF |
L’editor usa /vehicle/sensors/{id}. Montaggi relativi a vehicle/base_link. Assi ottici destra/basso/avanti; corpo avanti/sinistra/alto. |
| Timestamp di acquisizione | Tempo simulato della misura, da conservare nella registrazione e nella fusione. Riproduzione HLS e ricezione nel browser descrivono il trasporto. |
noise |
Specifico del plugin. L’IMU ammette rumore bianco, bias e bias dinamico per asse; la camera media e deviazione standard. Lo stesso tag XML non implica lo stesso errore. |
I sensori Gazebo definiscono i modelli di base. Non tutti i parametri sono esposti nell’editor. Il caricamento SDF di WWW-POSIM modifica valori supportati dei blocchi esistenti e ne conserva la struttura; aggiungi i sensori disponibili dall’editor. I blocchi opzionali Gazebo citati qui descrivono capacità del motore, non l’accettazione di qualsiasi estensione XML.
Camere RGB: anteriore e inferiore
CameraSensor proietta la geometria con un modello pinhole su una destinazione Ogre2 e pubblica immagine e calibrazione. Materiali, luce, occlusioni e Dinamica marina e rendering determinano il colore. Le camere fornite non modellano rolling shutter, elettronica di esposizione o sporco sulla lente.
| Parametro | Selezione |
|---|---|
camera/image/width, height |
Anteriore integrata e dell’editor: 640×480; inferiore dell’editor: 800×600. Dimensioni 64–1920, larghezza × altezza × frequenza ≤30 milioni di pixel/s per camera. |
camera/horizontal_fov |
Anteriore integrata: 1,05 rad; editor: 1,4 rad, regolabile 0,1–3. Risoluzione e campo visivo determinano campionamento angolare e calibrazione. |
camera/clip/near, far |
Anteriore integrata: 0,1–5000 m; editor: 0,1–100 m. Sono piani di clipping geometrici, non visibilità utile sott’acqua. |
update_rate |
Inizialmente 5 Hz; il trasporto ha limiti indipendenti. |
camera/noise, distortion, lens/intrinsics |
Gazebo supporta rumore gaussiano, distorsione radiale/tangenziale di Brown (k1, k2, k3, p1, p2) e intrinseci forniti. Le definizioni generate non aggiungono rumore o distorsione. Conserva SDF e CameraInfo. |
Uscite: sensor_msgs/Image e sensor_msgs/CameraInfo. JPEG è una rappresentazione per il trasporto. Le viste Mondo/Veicolo dell’osservatore non sono sensori del robot. Implementazione.
L’adattatore si sottoscrive finché un visualizzatore o consumatore richiede immagini. Una sottoscrizione accettata non prova la ricezione: dopo 10 s reali senza fotogrammi la rinnova, se la richiesta persiste. Lo stato dal vivo richiede un’immagine nuova decodificata. Il recupero non cambia frequenza simulata, timestamp o controlli di aggiornamento della navigazione.
Camera RGB-D di ispezione
RgbdCameraSensor genera colore, profondità in virgola mobile e nuvola di punti dalla stessa geometria tramite il buffer di profondità. Non esegue corrispondenza stereo né simula un dispositivo fisico a luce strutturata/ToF. L’attenuazione del colore in acqua non aggiunge incertezza al canale numerico di profondità.
| Parametro | BlueROV2 integrato |
|---|---|
pose |
(0.4, 0, −0.25) m su base_link, beccheggio π/4; ottica inferiore separata. |
| Immagine e campo visivo | 640×480, orizzontale 1,05 rad. |
| Clipping | 0,1–80 m. Gazebo supporta limiti depth_camera/clip separati; qui non vengono sovrascritti indipendentemente. |
| Frequenza e attivazione | 5 Hz richiesti, su richiesta. |
I bridge ROS espongono Image, CameraInfo e PointCloud2 secondo la configurazione. Mantieni profondità non valide e fuori intervallo: una mappa di colori non sostituisce i dati. La nuvola è una singola osservazione, non una mappa SLAM accumulata. Implementazione.
LiDAR planare
GpuLidarSensor usa raggi GPU sulla geometria visibile e applica portata e rumore configurati. La distanza è geometrica, senza calcolo di potenza ottica ricevuta o propagazione laser subacquea. Gli oggetti fuori dall’altezza o dal piano di scansione possono sfuggire.
| Parametro | WAM-V integrato / editor |
|---|---|
lidar/scan/horizontal/samples |
360, resolution=1 angolare. |
min_angle, max_angle |
−π a +π rad, un piano orizzontale. |
lidar/range/min, max, resolution |
Integrato: 0,2 / 50 / 0,02 m; editor: 0,1 / 50 / 0,01 m. Massimo regolabile 1–100 m. La risoluzione del modello non garantisce accuratezza misurata. |
| Frequenza e montaggio | Di norma 5 Hz. Integrato: 2,5 m sopra la base; demo condivisa: prua (3.5, 0, 1.0) m per intercettare le boe. L’editor salva la posa. |
lidar/noise |
Nessun blocco di rumore aggiunto allo scanner generato. Gazebo dispone di modelli di rumore sulla distanza. |
Uscita sensor_msgs/LaserScan. Conserva metadati angolari e valori non finiti; assenza di ritorno non equivale a distanza zero. Implementazione.
Ping singolo verso il basso
L’adattatore Ping riduce 5×5 raggi GPU al ritorno valido più vicino e pubblica sensor_msgs/Range. Modella impronta e validità del fascio, senza intensità acustica, forme d’onda o cammini multipli.
| Parametro | Editor |
|---|---|
| Raggi e angoli | 5×5, ciascun asse ±0,00872665 rad (±0,5°). Sensori di demo dedicate possono avere un ventaglio diverso. |
| Minimo / massimo / risoluzione | 0,1 / 30 / 0,01 m; massimo regolabile 1–100 m. |
| Frequenza e posa | Inizialmente 5 Hz, montaggio inferiore dalla configurazione salvata. |
field_of_view pubblicato |
Cono che contiene il fascio quadrato, calcolato dai semiangoli. Il ritorno può provenire da qualsiasi raggio. |
Un ingresso troppo vicino produce −∞; nessun ritorno +∞; sconosciuto NaN quando manca un impatto valido. Il timestamp resta invariato. Ping e DVL sono alternative inferiori nell’editor. Una distanza sull’impronta non identifica un punto unico del fondale.
Doppler Velocity Log (DVL)
DopplerVelocityLog individua il fondale nei coni renderizzati, proietta la velocità cinematica relativa sensore-bersaglio sui fasci, aggiunge rumore e risolve la velocità ai minimi quadrati tramite SVD. Non sintetizza portanti acustiche né ne stima lo spettro Doppler.
Parametro <gz:dvl> |
Profilo scelto |
|---|---|
type, arrangement |
phased_array; quattro fasci a 45°, 135°, −45°, −135°, inclinazione 30°, apertura 2°. |
tracking/bottom_mode/when |
best, inseguimento del fondale. Il water tracking è disponibile in Gazebo ma non attivo qui. |
tracking/bottom_mode/noise/stddev |
Deviazione standard gaussiana per fascio: 0,002 m/s. La covarianza risolta dipende dalla geometria. |
minimum_range, maximum_range, resolution |
0,1 / 20 / 0,01 m; massimo regolabile 1–100 m. |
update_rate, reference_frame |
Inizialmente 1 Hz; riferimento 0 0 0 0 0 0. Rotazione e braccio di leva appartengono alla calibrazione. |
L’adattatore richiede almeno tre fasci agganciati, covarianza valida, riferimento atteso e timestamp crescenti. Emette geometry_msgs/Vector3Stamped e stato JSON in std_msgs/String. Perdere l’aggancio non produce velocità zero. Lo stato contiene distanze per fascio: minimi nel cono, non necessariamente intersezioni del raggio centrale. Senza varianza della distanza, l’incertezza è sconosciuta. Implementazione.
Sonar multibeam a immagine
Il provider POSIM converte raggi in retrodiffusione acustica, risposte in frequenza corrette per fascio e intensità per cella di distanza. Anteprima del sonar fisico descrive Rust/WGPU, CUDA e CPU, distinguendo osservazioni acustiche e nuvole geometriche.
| Gruppo | Configurazione |
|---|---|
| Fasci orizzontali | 256 da −π/3 a +π/3 rad, 120°. |
| Raggi verticali | 256 da −π/18 a +π/18 rad, 20°. |
sonarFreq, maxDistance, raggi |
700 kHz; elaborazione fino a 15 m; raggi 0,2–15 m. |
update_rate, raySkips |
Inizialmente 2 Hz, fattore di salto 1. |
soundSpeed, bandwidth, sourceLevel, sensorGain |
Parametri SDF del provider per propagazione, elaborazione e scala visiva. Non tutti sono controlli dell’editor; conservali con i dati grezzi. |
Il confronto esplorativo usa un ventaglio inclinato più ampio, descritto accanto alle figure. L’editor produce marine_acoustic_msgs/ProjectedSonarImage grezzo; il ventaglio colorato è una sua rappresentazione. Il provider deve superare le verifiche di compatibilità dell’host.
IMU: accelerazione e velocità angolare
ImuSensor riceve cinematica, sottrae la gravità nel riferimento del sensore per ottenere la forza specifica e applica rumore per asse. L’orientamento deriva da quello del simulatore rispetto al riferimento configurato, non da uno stimatore di assetto a bordo.
| Parametro | Selezione |
|---|---|
update_rate |
WAM-V: 200 Hz; BlueROV2 integrato: 1000 Hz richiesti. Entrambi limitati dal passo fisico. |
pose, orientation_reference_frame |
Montaggio e riferimento determinano gli assi. BlueROV2 con ROS diretto usa rotazione di montaggio nulla; il modello ArduPilot conserva quella della propria interfaccia. Controlla frame emessi e TF. |
imu/linear_acceleration/{x,y,z}/noise |
mean/stddev in m/s²; bias_mean/bias_stddev per bias; dynamic_bias_stddev/dynamic_bias_correlation_time per l’evoluzione. Le IMU di base non configurano questi blocchi. |
imu/angular_velocity/{x,y,z}/noise |
Parametri equivalenti del giroscopio in rad/s. Il bias dinamico, se attivo, è correlato nel tempo. |
Uscita sensor_msgs/Imu. IMU grezza e assetto fuso MAVROS sono segnali diversi. Per valutare VIO o controllori, dichiara assenza di rumore e orientamento ricavato dallo stato di riferimento del simulatore. IMU, rumore gaussiano.
L’interfaccia JSON di ArduPilot interpola gli stati fisici già calcolati per generare campioni SITL intermedi. La Pianificazione delle rotte e controllo descrive le frequenze e il comportamento quando cambia il passo temporale. L’acquisizione dell’IMU ROS resta limitata dai passi fisici; i campioni SITL interpolati non aggiungono nuovi dettagli fisici.
Magnetometro
MagnetometerSensor ruota il campo del mondo nel riferimento sensore e aggiunge rumore configurato per asse. BlueROV2 ne include uno a 20 Hz, all’origine di base_link. I mondi usano tesla ed ENU: use_units_gauss=false, use_earth_frame_ned=false.
| Parametro | Significato |
|---|---|
magnetic_field del mondo |
Vettore usato dal simulatore; conserva la definizione del mondo. |
pose, update_rate |
Montaggio e frequenza richiesta. |
magnetometer/{x,y,z}/noise |
Media/deviazione gaussiana in tesla; nessun rumore aggiuntivo nel sensore inserito. |
Uscita sensor_msgs/MagneticField. Non modella interferenze hard iron/soft iron o anomalie locali. La bussola ArduPilot del WAM-V usa il modello SITL: un topic ROS non dimostra quali dati fonda la FCU. Implementazione.
Ricevitore GNSS
posim::Gnss trasforma la posizione mondiale dell’antenna in coordinate geografiche, aggiunge rumore riproducibile di posizione/velocità, ritarda la consegna e condiziona il fix a immersione e ostacoli. Pubblica NavSatFix/stato e, in navigazione GNSS, GPS_INPUT MAVLink.
| Parametri | Funzione |
|---|---|
update_rate, latency, reacquire_seconds |
Frequenza, ritardo e intervallo continuo emerso, in tempo simulato. |
horizontal_stddev, vertical_stddev, velocity_stddev, seed |
Ampiezze gaussiane e riproducibilità. |
link_name, pose, water_level, wave_topic, dry_margin |
Braccio di leva e verifica di immersione con le onde. |
enabled, topic di ostruzione |
Selezione del ricevitore e blocco imposto. |
GNSS e navigazione è il riferimento per valori, covarianze, ENU/NED, datum verticale ed EKF. Geometria satellitare e multipath non sono inclusi.
Pressione e profondità
La profondità del simulatore e quella stimata da ArduSub sono distinte da SubseaPressureSensorPlugin. Questo plugin autonomo è usato da altri modelli POSIM, come RexROV e Slocum; non è selezionabile nell’editor WWW-POSIM.
Legge la profondità dell’origine del modello sotto il piano medio z=0, la limita a zero sopra l’acqua e aggiunge pressione idrostatica lineare. Pubblica sensor_msgs/FluidPressure in Pa e, facoltativamente, profondità dedotta in geometry_msgs/PointStamped.
| Parametro | Valore o funzione |
|---|---|
namespace, topic |
Ricerca del modello e uscita; topic predefinito sea_pressure. |
standard_pressure, kPa_per_meter |
101,325 kPa e 9,80638 kPa/m; conversione da kPa interni a Pa. |
estimate_depth_on, update_rate |
Conversione inversa inizialmente attiva; frequenza 0 senza limite aggiuntivo del plugin. |
saturation |
Letto con valore 3000, ma non applicato alla misura. Non impone un limite di portata. |
Il codice non aggiunge rumore di pressione, pur dichiarando varianza equivalente a una deviazione di 3 kPa. Quel campo non dimostra rumore campionato. Usa l’origine del modello, non una presa calibrata, e non campiona pressione superficiale delle onde. Implementazione.
Componenti USBL in POSIM
UsblTransceiver e UsblTransponder scambiano posizioni e comandi simulati per produrre localizzazioni relative. Il transponder perturba le coordinate mondiali con rumore gaussiano. È un componente di prova basato sulla posizione, senza ricevitore a differenza di fase né soluzione completa di propagazione acustica. Non è un sensore standard dell’editor.
| Gruppo | Funzione |
|---|---|
namespace, nomi/ID, oggetti associati |
Dispositivi, modelli e percorsi dei messaggi. |
enable_ping_scheduler, ping_frequency, interrogation_mode |
Interrogazioni programmate e indirizzamento comune/individuale. |
sound_speed |
Inizialmente 1540 m/s; le callback possono sostituirlo con un’approssimazione di profondità/temperatura. |
mu, sigma del transponder |
Rumore di posizione: media 0, deviazione standard 1 m. |
L’attesa di propagazione usa una pausa in tempo reale nella callback. Non rappresenta uno strumento preciso di tempo di volo in tempo simulato. Vedi ricetrasmettitore e transponder.
Odometria, riferimento e registrazioni
OdometryPublisher espone posa e velocità simulate; il controllo del viaggio automatico pubblica anche lo stato nativo misurato. Sono riferimenti, non odometria delle ruote né stime fuse. Registra frame padre/figlio, frequenza ed eventi di cambio origine. Identifica separatamente stime FCU o SLAM.
Conserva SDF finale, manifesto, estrinseci TF, calibrazione, revisioni app/provider, passo temporale, semi casuali, timestamp, validità e osservazioni grezze. Video, schermate e mappe di colore sono complementari.
Prepara il veicolo · Personalizza i sensori · Simulazione, rendering e sensori · Dinamica marina e rendering