POSIM v1.0.1Platform for Ocean Simulation · Documentation
Menu de la documentation
POSIM / Référence des plugins

Effets de la scène sous-marine

posim_gz_rendering applique voile sous-marin, absorption RVB, lumière solaire dépendant de la profondeur, caustiques et particules en suspension aux surfaces PBR d'Ogre2. Les particules évoquent la neige marine et sont désactivées par défaut.

Scène Gazebo, caméras RGB et couleur RGBD partagent ces effets. La profondeur numérique et les collisions restent inchangées. Le filtre indépendant fondé sur la profondeur est décrit dans Caméra sous-marine.

Le système installé trouve automatiquement la bibliothèque de rendu voisine et les shaders de share/posim/underwater. renderer_library et shader_directory restent des chemins de remplacement facultatifs. Les lancements océaniques activent automatiquement la transmission directe des pixels ; faites-le dans vos lancements personnalisés utilisant les deux systèmes.

Compiler et intégrer le système

Préparez un environnement de développement Gazebo Jetty/Ogre2 correspondant au serveur. Dans le terminal A préparé, compilez depuis les sources POSIM ; sur macOS, utilisez le terminal Linux du bureau 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 exige les paquets de développement Gazebo et les entrées pkg-config OGRE-Next et OGRE-Next-Hlms. La commande inclut le chemin du paquet ROS gz_ogre_next_vendor sous Ubuntu. Utilisez bibliothèques, en-têtes et shaders d'une même compilation.

Ajoutez ce plugin dans <world> et remplacez /absolute/underwater par le préfixe d'installation précédent. Chargez une seule instance par processus Gazebo, avec un session_nonce propre à chaque session :

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

Linux utilise .so, y compris dans Docker/RDP sur macOS. Les bibliothèques compilées directement pour macOS utilisent .dylib. Une caméra active dans la scène est nécessaire pour produire les images.

Si vous utilisez aussi UnderwaterCamera, définissez POSIM_UNDERWATER_PLUGIN dans l'environnement du serveur avec le chemin du système chargé. Les pixels déjà colorés passent alors sans seconde atténuation. Ne le définissez qu'une fois le système de scène installé et chargé.

Effets et valeurs par défaut

Réglage Effet Défaut
Optique de l'eau Interrupteur général des effets optiques Activée
Voile sous-marin Mélange de couleur selon le trajet sous l'eau Activé
Absorption RVB Perte de couleur selon la longueur d'onde Activée
Atténuation solaire Lumière directionnelle plus faible en profondeur Activée
Caustiques Motifs lumineux animés sur les surfaces immergées Activées
Particules / neige marine Points lumineux procéduraux clairsemés Désactivées
Texture du fond Détails des cartes PBR du fond Activée
Grille du fond Espacement 10 m, réglable de 1 à 500 m Désactivée
Isobathes Espacement 5 m, réglable de 1 à 50 m Désactivées

Couper l'optique conserve les choix de texture, grille et isobathes. Les superpositions reconnaissent les visuels seabed ou shallow, y compris leurs noms complets Gazebo. Fournissez les textures dans les ressources du terrain ; voir Terrain par carte de hauteur.

Activer la neige marine

Une fois le monde démarré, lisez l'état dans le terminal B préparé :

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

Les 13 premières valeurs suivent cet ordre ; les indices commencent à zéro :

Indice Valeur
0–1 Schéma 1, révision
2–5 Optique, texture du fond, grille, isobathes
6–10 Voile, absorption, atténuation solaire, caustiques, particules
11–12 Espacement de la grille et des isobathes, m

Sur un système qui vient de démarrer à la révision 0, cette requête active les particules en conservant les autres valeurs par défaut :

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]'

Pour les modifications suivantes, conservez les réglages voulus et augmentez la révision de un. Les booléens acceptent 0 ou 1. Une requête identique peut être répétée.

Après rendu, relisez /state : ready, nombre de caméras et renderer_failed sont ajoutés aux indices 13–15. Vérifiez la révision demandée, ready = 1 et renderer_failed = 0. La réponse de /set confirme seulement la réception.

Pour activer les particules dès le démarrage, ajoutez cette balise au plugin à la place de la première requête :

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

WWW-POSIM utilise ce moteur public et ajoute son panneau d'apparence, sa gestion de sessions et ses préférences.

Limites du modèle et comparaison

Le calcul du trajet optique sous-marin utilise un plan moyen à z = 0 m, sans suivre chaque crête. Caustiques et particules sont des approximations visuelles ; elles ne simulent pas de concentrations étalonnées ni le bruit optique du capteur.

Les lampes locales conservent leur éclairage direct. Les rayons du ciel subissent l'atténuation sous-marine ; les matériaux non éclairés et les shaders propres à la surface océanique gardent leur rendu. Le dessous des vagues dépend donc du matériau de surface.

Comparez les vues au-dessus/sous l'eau, RGB et couleur RGBD, puis chaque interrupteur. Gardez pose et lumière constantes. Vérifiez la profondeur identique octet par octet, la pause des effets avec le temps simulé et le signalement des pannes. Le paquet public fournit des cas de vérification RGB/RGBD, les shaders et les détails de compilation.