POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Guías básicas

Biblioteca de mundos

Los mundos están en models/posim_worlds/worlds. Selecciónalos por su nombre de archivo, sin la extensión .world.

Los mundos oceánicos incluyen model://calm_waves: olas FFT de Wave Sim con viento de entrada de 3 m/s, una tesela periódica de 256 m y un área visible de 768 × 768 m. La superficie se ve desde arriba y desde abajo. Los efectos submarinos nativos se aplican a imágenes RGB; el tutorial de aguas someras también los activa en la vista de Gazebo. Las instalaciones estándar y las imágenes incluyen Wave Sim. La flotabilidad de los vehículos submarinos, el GNSS marino y el límite óptico usan el nivel medio z = 0, independientemente de la altura visual de las olas. WAM-V utiliza la hidrodinámica de Wave Sim acoplada a las olas. La demostración USBL sin agua y los mundos aislados de prueba del sonar conservan su propia geometría.

Iniciar un mundo

Usa la terminal POSIM de tu instalación, tanto en Ubuntu nativo como en WSL, Docker o RDP.

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

El nombre de archivo puede diferir del nombre interno: posim_ocean_waves.world declara oceans_waves. Este último aparece en tópicos y servicios Gazebo. Comprueba <world name="…"> antes de construir una ruta.

Elegir según el experimento

Experimento Mundo
Primer vehículo posim_ocean_waves
Efectos de cámara submarina camera_tutorial
Mediciones DVL dvl_world
Interrogación USBL usbl_tutorial
Configuración de corrientes ocean_current_plugin
Escena costera y geográfica posim_Santorini
Sonar posim_multibeam_sonar y mundos oceánicos con sonar en el nombre
Manipulación posim_bimanual_example, posim_plug_and_socket, posim_electrical_mating

Los mundos de sonar requieren su entorno de ejecución. Las referencias Fuel pueden descargar modelos en el primer uso.

Archivos SDF

Abre un archivo para consultar sus sistemas, modelos, origen, luces y cámaras.

SDF del mundo
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

Crear otro entorno

Copia un SDF adecuado en models/posim_worlds/worlds y asigna nombres nuevos al archivo y al mundo. Utiliza URI que resuelvan los recursos instalados. Vuelve a compilar, carga el entorno y ejecuta el nuevo archivo. Consulta Terrenos con mapas de alturas y Objetos.

Esperar las descargas de Fuel

posim_integrated y posim_ocean_models usan modelos remotos. Espera a que termine la primera descarga; evita iniciar varias simulaciones durante la carga. verbose:=true muestra los mensajes de recursos.

En otra terminal con el mismo entorno, consulta la escena cargada:

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

Comprueba los modelos de la respuesta, el avance del reloj y las mediciones. Si la descarga se detiene, revisa el mensaje de carga y la red del equipo o contenedor que ejecuta Gazebo.

Consultar los argumentos de lanzamiento

ros2 launch posim_demos posim_sensor.launch.py --show-args
Argumento Función Valor inicial del lanzamiento de sensores
namespace Directorio del modelo instalado Vacío; especifícalo
world_name Archivo del mundo empty.sdf
paused Iniciar en pausa true
gui / headless Mostrar / ocultar la interfaz Gazebo true / false
use_sim_time Usar el reloj simulado en ROS true
x, y, z Posición inicial, m 0.0 cada uno
roll, pitch, yaw Orientación inicial, rad 0.0 cada uno
debug / verbosity_level Registro detallado / nivel false / 1
use_ned_frame Publicar la transformación world_ned (ENU a NED) false

Usa paused:=false para que los sensores produzcan datos. Consulta --show-args del lanzamiento concreto para ver las opciones de robots y mundos.