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

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

  1. 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.

  2. Modello di misura

    Il plugin proietta immagini, genera misure inerziali, risolve velocità dei fasci o calcola ritorni acustici. Qui si applicano rumore e validità.

  3. Messaggi e sistemi di riferimento

    Bridge ROS–Gazebo e adattatori POSIM conservano le misure, assegnano riferimenti, convertono unità e segnalano dati indisponibili.

  4. 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

Cerca nella documentazione