POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Panoramica di POSIM

Funzionalità ed esempi

POSIM offre sistemi Gazebo, modelli di robot e interfacce ROS. L'SDF del mondo e i file di avvio selezionano i sistemi usati dalla simulazione.

Ambiente e rendering

Funzione Implementazione Guida
Foschia subacquea, assorbimento RGB e attenuazione della luce solare gazebo/posim_gz_rendering Effetti subacquei
Caustiche sul fondale e particelle in sospensione gazebo/posim_gz_rendering Attivare gli effetti
Texture del fondale, griglia e curve di profondità gazebo/posim_gz_rendering; mappe del terreno Materiali e distanze
Onde spettrali e idrodinamica del WAM-V Wave Sim esterno; integrazione extras/surface Veicoli di superficie
Correnti uniformi, dipendenti dalla profondità e di marea posim_gz_world_plugins, posim_gz_model_plugins, posim_ros_gz_plugins Correnti
Origine geografica e conversione delle coordinate posim_ros_gz_plugins Coordinate sferiche
Fondali, oggetti e scenari operativi models/posim_worlds, posim_object_models Mondi, oggetti, terreni

Gli effetti ottici subacquei modificano le superfici PBR e conservano i valori numerici di profondità. La superficie oceanica usa un materiale proprio. La neve marina è un'approssimazione visiva procedurale, inizialmente disattivata. La guida al rendering descrive l'ipotesi sul livello del mare e il comportamento delle telecamere.

Sensori, robot e controllo

Funzione Implementazione Guida
GNSS marino, perdita in immersione, riacquisizione e latenza gazebo/posim_gz_gnss GNSS
Attenuazione delle immagini subacquee basata su RGBD posim_gz_sensor_plugins/UnderwaterCamera Telecamera
Misure DVL e conversione ROS DVL Gazebo; posim_ros_gz_plugins DVL
Pressione idrostatica e profondità calcolata posim_gz_sensor_plugins Pressione
Interrogazione acustica e posizionamento USBL posim_gz_sensor_plugins USBL
Sonar multibeam gazebo/posim_gz_multibeam_sonar Sonar, configurazione e prestazioni
REXROV, varianti BlueROV2 e aliante Slocum models/posim_robot_models ROV, aliante, aggiungere un robot
WAM-V con ArduRover e controllo ROS extras/surface, configurazioni di avvio, posim_interfaces Veicolo di superficie, ROS 2

I sensori disponibili dipendono dai plugin installati e dal modello. I profili GNSS descrivono i montaggi: durante l'integrazione aggiungi il link e il ricevitore. Per il sonar puoi scegliere CPU, WGPU o CUDA in base all’ambiente. Usa l'avvio rapido di ciascun riferimento per verificare le misure durante la simulazione.

Directory del codice sorgente

I percorsi sono relativi al repository POSIM.

Directory Contenuto
models/posim_worlds Mondi e risorse ambientali
models/posim_robot_models Meccanica, sensori e configurazione ROS di ogni robot
models/posim_sensor_models Descrizioni ed esempi di sensori indipendenti
gazebo/ Plugin dell'ambiente marino e dei sensori
posim_interfaces Definizioni di messaggi e servizi POSIM
examples/posim_demos File di avvio che collegano mondi, modelli e ROS

Prima simulazione avvia questi componenti insieme. Per modificarli, consulta Aggiungere un robot e Creare un mondo.

Libreria Ogre alternativa per macOS

Lo strumento di compilazione Ogre genera un core Ogre isolato per macOS arm64 con Ogre-Next 2.3.3. Segui il profilo SDK supportato e i controlli sulle librerie caricate indicati nella guida.

Consulta le licenze dei componenti.