POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Referencia de plugins

Efectos de la escena submarina

posim_gz_rendering aplica turbidez con la distancia, absorción RGB, luz solar dependiente de la profundidad, cáusticas y partículas suspendidas a las superficies PBR de Ogre2. Las partículas representan nieve marina y empiezan desactivadas.

La escena Gazebo, las cámaras RGB y el color RGBD comparten estos efectos. La profundidad numérica y las colisiones se mantienen. El filtro independiente basado en profundidad se explica en Cámara subacuática.

El sistema instalado encuentra automáticamente la biblioteca de renderizado contigua y los shaders de share/posim/underwater. renderer_library y shader_directory permiten sustituir las rutas. Los lanzamientos oceánicos activan automáticamente el paso directo de la cámara; configúralo en tus lanzamientos personalizados que usen ambos sistemas.

Compilar e incorporar el sistema

Prepara un entorno de desarrollo Gazebo Jetty/Ogre2 compatible con el servidor. En la terminal A preparada, compila desde el código de POSIM; en macOS, usa la terminal Linux del escritorio RDP:

cd "$POSIM_WS/src/posim"
export PKG_CONFIG_PATH="/opt/ros/lyrical/opt/gz_ogre_next_vendor/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}"
cmake -S gazebo/posim_gz_rendering -B build/underwater \
  -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="$PWD/install/underwater"
cmake --build build/underwater --parallel 2
cmake --install build/underwater

CMake necesita los paquetes de desarrollo Gazebo y las entradas pkg-config OGRE-Next y OGRE-Next-Hlms. El comando incluye la ruta del paquete ROS gz_ogre_next_vendor en Ubuntu. Usa bibliotecas, cabeceras y sombreadores de la misma compilación.

Añade este plugin a <world> y sustituye /absolute/underwater por el prefijo de instalación anterior. Carga una sola instancia por proceso Gazebo y asigna un session_nonce distinto a cada sesión:

<plugin filename="/absolute/underwater/lib/posim_underwater.so"
        name="posim::Underwater">
  <session_nonce>appearance_example</session_nonce>
</plugin>

Linux usa .so, también dentro de Docker/RDP en macOS. Las bibliotecas compiladas directamente para macOS usan .dylib. La escena necesita una cámara activa para generar imágenes.

Si también usas UnderwaterCamera, configura POSIM_UNDERWATER_PLUGIN con la ruta del sistema cargado en el entorno del servidor. Así pasan los píxeles ya coloreados sin segunda atenuación. Actívalo únicamente cuando el sistema de escena esté instalado y cargado.

Efectos y valores predeterminados

Ajuste Efecto Predeterminado
Óptica del agua Interruptor general de los efectos ópticos Activada
Turbidez Mezcla de color según el recorrido bajo el agua Activada
Absorción RGB Pérdida de color según longitud de onda Activada
Atenuación solar Luz direccional más débil con la profundidad Activada
Cáusticas Patrones animados de luz sobre superficies sumergidas Activadas
Partículas / nieve marina Puntos brillantes procedimentales dispersos Desactivadas
Textura del fondo Detalle de los mapas PBR del fondo Activada
Cuadrícula del fondo Separación 10 m, ajustable de 1 a 500 m Desactivada
Curvas de profundidad Separación 5 m, ajustable de 1 a 50 m Desactivadas

Desactivar la óptica conserva las selecciones de textura, cuadrícula y curvas. Las superposiciones reconocen visuales llamados seabed o shallow, incluidos sus nombres completos de Gazebo. Incluye las texturas en los recursos del terreno; consulta Terreno con mapas de altura.

Activar la nieve marina

Con el mundo iniciado, consulta el estado desde la terminal B preparada:

gz service -s /posim/appearance/appearance_example/state \
  --reqtype gz.msgs.Empty --reptype gz.msgs.Double_V --timeout 3000 --req ''

Los primeros 13 valores siguen este orden; los índices empiezan en cero:

Índice Valor
0–1 Esquema 1, revisión
2–5 Óptica, textura del fondo, cuadrícula, curvas
6–10 Turbidez, absorción, atenuación solar, cáusticas, partículas
11–12 Separación de cuadrícula y curvas, m

En un sistema recién iniciado con revisión 0, esta solicitud activa las partículas y conserva los demás valores predeterminados:

gz service -s /posim/appearance/appearance_example/set \
  --reqtype gz.msgs.Double_V --reptype gz.msgs.Double_V --timeout 3000 \
  --req 'data: [1, 1, 1, 1, 0, 0, 1, 1, 1, 1, 1, 10, 5]'

Para cambios posteriores, conserva los valores deseados y aumenta la revisión en uno. Los booleanos aceptan 0 o 1. Puedes repetir una solicitud idéntica.

Después de renderizar, vuelve a leer /state: añade ready, número de cámaras y renderer_failed en 13–15. Confirma la revisión solicitada, ready = 1 y renderer_failed = 0. La respuesta de /set solo confirma recepción.

Para activar partículas desde el inicio, añade esta etiqueta al plugin en lugar de la primera solicitud:

<initial_settings>1 0 1 1 0 0 1 1 1 1 1 10 5</initial_settings>

WWW-POSIM utiliza este renderizador público y añade su propio panel de apariencia, gestión de sesiones y preferencias.

Alcance del modelo y comparación

El cálculo de la longitud del recorrido óptico bajo el agua usa el plano del nivel medio del mar en z = 0 m, sin seguir cada cresta. Cáusticas y partículas son aproximaciones visuales; no modelan concentraciones calibradas ni ruido óptico del sensor.

Las luces locales conservan iluminación directa. Los rayos del cielo reciben atenuación subacuática; los materiales sin iluminación y los sombreadores propios de superficie oceánica mantienen su renderizado. La cara inferior de la ola depende del material de superficie.

Compara vistas sobre/bajo el agua, RGB y color RGBD, y cada interruptor. Mantén posición y luz constantes. Comprueba profundidad idéntica byte a byte, pausa de efectos con el tiempo simulado y notificación de fallos. El paquete público incluye ejemplos de comprobación RGB/RGBD, sombreadores y detalles de compilación.