POSIM v1.0.1Platform for Ocean Simulation · ドキュメント
ドキュメントメニュー
POSIM / プラグインリファレンス

水中シーンの表現

posim_gz_rendering は Ogre2 の PBR 表面に、水中のかすみ、RGB 吸収、深度による日光減衰、コースティクス、浮遊粒子を適用します。粒子はマリンスノーを簡易的に表し、初期状態では無効です。

Gazebo のシーン、RGB カメラ、RGBD のカラー画像で同じ効果を使います。数値深度と衝突形状は変わりません。別の深度ベース画像フィルターは水中カメラを参照してください。

システムは同じ場所の描画補助ライブラリと share/posim/underwater のシェーダーを自動で探します。renderer_library と shader_directory で上書きできます。海洋サンプルの起動ではカメラのパススルーフラグを自動設定します。独自の起動で両システムを使う場合は手動で設定してください。

ビルドして組み込む

サーバーに合う Gazebo Jetty/Ogre2 開発環境を用意します。準備済みのターミナル Aで POSIM ソースからビルドします。macOS では RDP デスクトップ内の Linux ターミナルを使います。

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 は Gazebo 開発パッケージと、pkg-config の OGRE-Next、OGRE-Next-Hlms を必要とします。このコマンドは Ubuntu の ROS パッケージ gz_ogre_next_vendor のパスを追加します。同じビルドのライブラリ、ヘッダー、シェーダーを使ってください。

<world> 内に追加し、/absolute/underwater を上のインストール先に置き換えます。Gazebo プロセスにつき 1 インスタンスとし、セッションごとに異なる session_nonce を指定します。

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

Linux では .so を使い、macOS の Docker/RDP 内でも同じです。macOS 向けに直接ビルドしたライブラリは .dylib を使います。センサー画像を生成するにはシーンに有効なカメラが必要です。

UnderwaterCamera も使う場合は、サーバー環境の POSIM_UNDERWATER_PLUGIN を読み込み済みシステムのパスに設定します。着色済み画素をそのまま通し、二重の減衰を防ぎます。シーンシステムをインストールして読み込んだ場合にのみ設定してください。

効果と既定値

設定 効果 既定値
水中光学効果 光学効果全体の切り替え 有効
かすみ 水中の光路長に応じた色の混合 有効
RGB 吸収 波長に応じた色の減衰 有効
日光減衰 深くなるほど弱まる平行光 有効
コースティクス 水中表面を動く日光模様 有効
浮遊粒子/マリンスノー 疎らに生成する明るい点 無効
海底テクスチャ 海底に指定した PBR マップの細部 有効
海底グリッド 間隔 10 m、1~500 m で調整可能 無効
等深線 間隔 5 m、1~50 m で調整可能 無効

光学効果を切っても、テクスチャ・グリッド・等深線の選択は保持されます。海底の重ね表示は seabed または shallow という visual を認識し、Gazebo の完全なスコープ名にも対応します。テクスチャは地形アセットに含めます。ハイトマップ地形を参照してください。

マリンスノーを有効にする

ワールドを起動し、準備済みのターミナル B で状態を読みます。

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

先頭 13 個の値は次の順です。インデックスは 0 始まりです。

インデックス 値
0~1 スキーマ 1、リビジョン
2~5 光学効果、海底テクスチャ、グリッド、等深線
6~10 かすみ、吸収、日光減衰、コースティクス、粒子
11~12 グリッドと等深線の間隔、m

起動直後のリビジョン 0 では、次のリクエストが他の既定値を保ったまま粒子を有効にします。

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

以降は必要な設定を保持し、リビジョンを 1 増やします。真偽値は 0 または 1 です。同一リクエストの再送も可能です。

描画後に /state を再度読みます。インデックス 13~15 に ready、カメラ数、renderer_failed が追加されます。要求したリビジョン、ready = 1、renderer_failed = 0 を確認してください。/set の応答だけでは受領の確認にとどまります。

起動時から粒子を有効にする場合は、最初のリクエストの代わりに次のタグをプラグインへ追加します。

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

WWW-POSIM はこの公開レンダラーに、独自の外観パネル、セッション管理、設定保存を追加しています。

モデルの範囲と比較

水中の光路長は z = 0 m の平均水面を基準に計算し、個々の波頂には追従しません。コースティクスと粒子は視覚的な近似で、校正された粒子濃度や光学センサーノイズは再現しません。

局所光源は直接照明を保ちます。空へのレイには水中減衰がかかりますが、unlit 材質や独自の海面シェーダーは自身の描画を保ちます。波面の裏側は海面材質の設定で扱います。

水面上と水中、RGB と RGBD カラー、各切り替えを比較します。姿勢と照明を固定し、深度がバイト単位で同一なこと、時間依存の効果がシミュレーションの一時停止に合わせて止まること、描画エラーが報告されることを確認します。公開パッケージには RGB/RGBD 確認用の例、シェーダー、ビルド情報があります。