POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Guide introduttive

Libreria dei mondi

I mondi si trovano in models/posim_worlds/worlds. Scegli il nome del file senza l'estensione .world.

I mondi oceanici includono model://calm_waves: onde FFT di Wave Sim con vento in ingresso di 3 m/s, tassello periodico di 256 m e area visibile di 768 × 768 m. La superficie è visibile da sopra e da sotto. Gli effetti subacquei nativi agiscono sulle immagini RGB; il tutorial in acque poco profonde li attiva anche nella vista Gazebo. Installazione standard e immagini includono Wave Sim. Galleggiamento dei veicoli subacquei, GNSS marino e limite ottico usano il livello medio z = 0, indipendentemente dall’altezza delle onde visualizzate. WAM-V usa l’idrodinamica Wave Sim accoppiata alle onde. La demo USBL senza acqua e i mondi isolati di prova del sonar mantengono la propria geometria.

Avviare un mondo

Usa il terminale POSIM della tua installazione: Ubuntu nativo, WSL, Docker o il desktop RDP.

ros2 launch posim_demos posim_world.launch.py \
  world_name:=posim_ocean_waves headless:=false

Il nome del file può essere diverso da quello interno. posim_ocean_waves.world, per esempio, definisce oceans_waves, usato nei percorsi di topic e servizi Gazebo. Controlla l'elemento <world name="…"> prima di comporre un percorso.

Scegliere in base all'esperimento

Esperimento Mondo
Primo veicolo posim_ocean_waves
Effetti della telecamera subacquea camera_tutorial
Misure DVL dvl_world
Interrogazione USBL usbl_tutorial
Configurazione delle correnti ocean_current_plugin
Scenario costiero e geografico posim_Santorini
Sonar posim_multibeam_sonar e mondi oceanici con sonar nel nome
Manipolazione posim_bimanual_example, posim_plug_and_socket, posim_electrical_mating

I mondi sonar richiedono il relativo ambiente di esecuzione. Al primo avvio, i riferimenti Fuel possono scaricare modelli.

File SDF

Apri un file per esaminare sistemi, modelli, origine, luci e telecamere.

SDF del mondo
camera_tutorial
dvl_world
new_dvl
ocean_current_plugin
posim_Santorini
posim_bimanual_example
posim_electrical_mating
posim_graded_seabed
posim_integrated
posim_multibeam_sonar
posim_ocean_models
posim_ocean_waves
posim_ocean_waves_mossy_ground
posim_ocean_waves_sonar
posim_ocean_waves_sonar_integrated
posim_ocean_waves_transient_current
posim_plug_and_socket
shallow_surface
shallow_underwater
usbl_tutorial

Comporre un nuovo ambiente

Copia un SDF adatto in models/posim_worlds/worlds, assegnando nuovi nomi al file e al mondo. Usa URI che risolvano le risorse installate. Ricompila e carica l'ambiente, poi avvia il nuovo file. Vedi Terreni da mappe di elevazione e Oggetti.

Attendere i download Fuel

posim_integrated e posim_ocean_models usano modelli remoti. Attendi il primo download senza avviare ripetutamente la simulazione durante il caricamento. verbose:=true mostra i messaggi delle risorse.

In un altro terminale dello stesso ambiente, richiedi la scena caricata:

# posim_integrated.world uses the internal name posim_integrated.
gz service -s /world/posim_integrated/scene/info \
  --reqtype gz.msgs.Empty --reptype gz.msgs.Scene --timeout 5000 --req ''
# For posim_ocean_models.world, use /world/posim_ocean_model/scene/info.

Controlla i modelli attesi nella risposta, l'avanzamento dell'orologio e le misure dei sensori. Se il download si ferma, controlla il messaggio di caricamento e la rete del computer o contenitore che esegue Gazebo.

Consultare gli argomenti di avvio

ros2 launch posim_demos posim_sensor.launch.py --show-args
Argomento Funzione Valore iniziale per l'avvio dei sensori
namespace Cartella del modello installato Vuoto; specificarlo
world_name File del mondo empty.sdf
paused Avvio in pausa true
gui / headless Mostrare / nascondere l'interfaccia Gazebo true / false
use_sim_time Orologio simulato nei nodi ROS true
x, y, z Posizione iniziale, m 0.0 ciascuno
roll, pitch, yaw Orientamento iniziale, rad 0.0 ciascuno
debug / verbosity_level Registro dettagliato / livello false / 1
use_ned_frame Pubblicare la trasformazione world_ned (da ENU a NED) false

Usa paused:=false per ottenere dati dai sensori. Per robot e mondi, consulta --show-args del relativo file di avvio.