ワールドをカスタマイズ
ワールドSDFはシミュレーション環境を定義します。選択した地形から書き出したファイルを使ってください。地形の参照先、地理原点、必要なエンジンシステムが含まれます。
ワールドをダウンロードして適用する
- 準備済みの固定範囲の地形と機体を選び、開始前の確認画面を開きます。
- SDFファイルを編集 → ワールドSDFをダウンロードで
world.sdfのコピーを保存します。 - 対応する物理・照明項目を編集します。地形モデル、パス、ワールド名、地理原点は維持します。
- 編集したワールドSDFをアップロードを選びます。検証済みのリビジョンがワールド設定に追加され、自動選択されます。
- ワールドを開始します。地形と機体の準備後に設定が適用されます。物理時間刻み、実測速度、照明を確認します。
ファイルは元の地形リビジョンに関連付けられます。別の地形では、そのSDFをダウンロードして設定を移してください。地形の既定設定で初期値に戻せます。.worldまたは.sdfを1 MBまでアップロードできます。採点を伴わない固定ワールドが対象です。オンデマンド地形や採点課題は指定された設定を使います。
対応する設定
| SDFの節 | 項目と単位 |
|---|---|
physics / max_step_size |
積分間隔。0.001〜0.03秒。小さくすると計算負荷が増えます。 |
physics / real_time_factor |
実時間に対する要求シミュレーション時間比。0より大きく、最大10。実測値はCPU・GPUの能力に依存します。 |
gravity |
加速度ベクトル(m/s²)。標準は0 0 -9.81。 |
magnetic_field |
磁場ベクトル(T)。 |
scene |
環境光、背景色、影、グリッド、原点表示。色はRGBAです。 |
light |
名前付きの平行光源、点光源、スポットライトを最大32個。位置・姿勢、方向、色、減衰、スポット角(rad)を設定します。 |
wind / linear_velocity |
SDF標準の風速(m/s)。海洋の波・海流モデルには別の操作項目と物理的な意味があります。 |
全体のスキーマはSDFormat仕様を参照してください。アップロードでは地形と必要なシステムを保持し、対応する設定を適用します。プラグインのインストール、外部モデルの取得、地理地形の置換は行いません。波と海流はシーンパネルで設定します。機体への作用は海洋動力学と描画をご覧ください。
準備済み地形のテンプレート
KMOU world.sdfをダウンロード。KMOU地形を使う完全な例で、対応するワールド設定を確認できます。地形のメッシュと画像は地形パッケージ内にあり、ワークスペースから取得できます。
kmou.world
<?xml version='1.0' encoding='utf-8'?>
<sdf version="1.4">
<!--
この地形リビジョンのワールド設定です。ワールド名、地形リソース、地理的原点、必須システムを維持してください。開始前の確認画面で対応する環境設定をアップロードできます。
-->
<world name="wwos_gebco">
<!--
シーンの表示設定です。ambientとbackgroundはRGBA色、shadows、grid、origin_visualは表示の切り替えです。エクスポートした空の設定を含め、アップロード可能な項目はワールド設定表を確認してください。
-->
<scene>
<ambient>0.01 0.01 0.01 1.0</ambient>
<sky>
<clouds>
<speed>12</speed>
</clouds>
</sky>
<shadows>1</shadows>
<background>0.7 0.8 0.9 1</background>
<grid>false</grid>
<origin_visual>false</origin_visual>
</scene>
<!--
物理計算の時間設定です。max_step_sizeは積分刻み(秒)、real_time_factorは要求するシミュレーション時間と実時間の比です。nameは識別用の名前で、刻み幅ではありません。実際の速度はCPU/GPUの余力に左右されます。
-->
<physics name="1ms" type="ignored">
<max_step_size>.02</max_step_size>
<real_time_factor>1.0</real_time_factor>
</physics>
<!--
エンジンプラグインです。filenameはインストール済みライブラリ、nameは実装を指定します。数値設定をアップロードするときも両方を維持してください。SDFファイルでプラグイン自体はインストールできません。
-->
<!--
剛体の動力学と接触を計算する必須ワールドシステムです。有効な状態を維持してください。
-->
<plugin filename="gz-sim-physics-system" name="gz::sim::systems::Physics">
</plugin>
<!--
エンジンプラグインです。filenameはインストール済みライブラリ、nameは実装を指定します。数値設定をアップロードするときも両方を維持してください。SDFファイルでプラグイン自体はインストールできません。
-->
<!--
実行中のシーンを変更するGazebo Transportコマンドを提供します。ワークスペースのシーン操作に使います。
-->
<plugin filename="gz-sim-user-commands-system" name="gz::sim::systems::UserCommands">
</plugin>
<!--
エンジンプラグインです。filenameはインストール済みライブラリ、nameは実装を指定します。数値設定をアップロードするときも両方を維持してください。SDFファイルでプラグイン自体はインストールできません。
-->
<!--
ビューアーがシミュレーションを表示できるよう、シーン構造と位置・姿勢を配信します。
-->
<plugin filename="gz-sim-scene-broadcaster-system" name="gz::sim::systems::SceneBroadcaster">
</plugin>
<!--
エンジンプラグインです。filenameはインストール済みライブラリ、nameは実装を指定します。数値設定をアップロードするときも両方を維持してください。SDFファイルでプラグイン自体はインストールできません。
-->
<!--
カメラ画像とGPUレイセンサーデータを描画します。render_engineはインストール済みの描画バックエンドを選択します。使用中のエンジンが出力した値を維持してください。
-->
<plugin filename="gz-sim-sensors-system" name="gz::sim::systems::Sensors">
<render_engine>ogre2</render_engine>
</plugin>
<!--
エンジンプラグインです。filenameはインストール済みライブラリ、nameは実装を指定します。数値設定をアップロードするときも両方を維持してください。SDFファイルでプラグイン自体はインストールできません。
-->
<!--
カスタムDVLセンサーに必要なワールドシステムです。ビームと追跡の設定は機体のSDFで指定します。
-->
<plugin filename="gz-sim-dvl-system" name="gz::sim::systems::DopplerVelocityLogSystem">
</plugin>
<!--
地形の地理的原点です。緯度・経度・方位は度、高度はmです。ENUは東・北・上向きの軸を表します。地図・地形・GNSSを一致させるため値を維持してください。
-->
<spherical_coordinates>
<surface_model>EARTH_WGS84</surface_model>
<world_frame_orientation>ENU</world_frame_orientation>
<latitude_deg>35.077175</latitude_deg>
<longitude_deg>129.085815</longitude_deg>
<elevation>0</elevation>
<heading_deg>0</heading_deg>
</spherical_coordinates>
<!--
光源です。typeで平行光源・点光源・スポットライトを選択します。poseは位置・姿勢、directionは照射方向ベクトルです。diffuse/specularはRGBA色、cast_shadowsは影の生成を指定します。
-->
<light type="directional" name="sun1">
<!--
位置・姿勢です。x y zはm、続くroll pitch yawはradです。relative_toの指定がなければ親の座標系を基準にします。
-->
<pose>50 0 150 0 0 0</pose>
<diffuse>1 1 1 1</diffuse>
<specular>.1 .1 .1 1</specular>
<direction>0.3 0.3 -1</direction>
<cast_shadows>false</cast_shadows>
</light>
<!--
光源です。typeで平行光源・点光源・スポットライトを選択します。poseは位置・姿勢、directionは照射方向ベクトルです。diffuse/specularはRGBA色、cast_shadowsは影の生成を指定します。
-->
<light type="directional" name="sun_diffuse">
<!--
位置・姿勢です。x y zはm、続くroll pitch yawはradです。relative_toの指定がなければ親の座標系を基準にします。
-->
<pose>-50 0 -150 0 0 0</pose>
<diffuse>0.6 0.6 0.6 1</diffuse>
<specular>0 0 0 1</specular>
<direction>-0.3 -0.3 -1</direction>
<cast_shadows>false</cast_shadows>
</light>
<!--
光源です。typeで平行光源・点光源・スポットライトを選択します。poseは位置・姿勢、directionは照射方向ベクトルです。diffuse/specularはRGBA色、cast_shadowsは影の生成を指定します。
-->
<light type="directional" name="sun_diffuse_1">
<!--
位置・姿勢です。x y zはm、続くroll pitch yawはradです。relative_toの指定がなければ親の座標系を基準にします。
-->
<pose>-100 500 -20 0 0 0</pose>
<diffuse>0.8 0.8 0.8 1</diffuse>
<specular>1 1 1 1</specular>
<direction>-1 -1 0</direction>
<cast_shadows>false</cast_shadows>
</light>
<!--
光源です。typeで平行光源・点光源・スポットライトを選択します。poseは位置・姿勢、directionは照射方向ベクトルです。diffuse/specularはRGBA色、cast_shadowsは影の生成を指定します。
-->
<light type="directional" name="sun_diffuse_2">
<!--
位置・姿勢です。x y zはm、続くroll pitch yawはradです。relative_toの指定がなければ親の座標系を基準にします。
-->
<pose>-150 -130 50 0 0 0</pose>
<diffuse>0.6 0.6 0.6 1</diffuse>
<specular>0.2 0.2 0.2 1</specular>
<direction>0.5 0.5 -1</direction>
<cast_shadows>false</cast_shadows>
</light>
<!--
エンジンプラグインです。filenameはインストール済みライブラリ、nameは実装を指定します。数値設定をアップロードするときも両方を維持してください。SDFファイルでプラグイン自体はインストールできません。
-->
<plugin filename="gz-sim-buoyancy-system" name="gz::sim::systems::Buoyancy">
<!--
浮力計算に使う層ごとの流体密度で、単位はkg/m^3です。default_densityは境界より下に適用され、above_depthは密度が切り替わる高さです。この例の境界はz=0です。
-->
<graded_buoyancy>
<default_density>1025</default_density>
<density_change>
<above_depth>0</above_depth>
<density>1</density>
</density_change>
</graded_buoyancy>
</plugin>
<!--
モデルの構成です。linkで剛体、jointで剛体間の接続を定義し、pluginでシミュレーション機能を追加します。名前はエクスポートした制御設定と一致させてください。
-->
<model name="gebco_terrain">
<!--
静的モデルは重力や接触力で動きません。地形は静的に配置し、機体のリンクは動的に計算します。
-->
<static>true</static>
<!--
剛体とそのローカル座標系です。このリンクの形状、質量特性、センサーは一体として動きます。
-->
<link name="terrain">
<!--
物理計算に使う衝突形状です。大きさと位置を船体に合わせてください。単純な形状にすると衝突計算の負荷を減らせます。
-->
<collision name="gebco_collision">
<geometry>
<!--
メッシュファイルと軸ごとの倍率です。エクスポートしたパスとリソースを一緒に保存してください。scaleはメッシュ座標に掛ける倍率です。
-->
<mesh>
<uri>terrain.dae</uri>
</mesh>
</geometry>
</collision>
<!--
画面やカメラに映る形状です。変更しても衝突形状や質量は自動では変わりません。
-->
<visual name="seabed">
<geometry>
<!--
メッシュファイルと軸ごとの倍率です。エクスポートしたパスとリソースを一緒に保存してください。scaleはメッシュ座標に掛ける倍率です。
-->
<mesh>
<uri>terrain-visual.dae</uri>
</mesh>
</geometry>
<!--
表面の見た目です。RGBA色とPBRテクスチャが描画に使われます。地形テクスチャのパスとエクスポートしたリソースを維持してください。材質設定で質量や摩擦は自動では変わりません。
-->
<material>
<ambient>0.6 0.6 0.6 1</ambient>
<diffuse>1 1 1 1</diffuse>
<specular>0.03 0.03 0.03 1</specular>
<pbr>
<metal>
<albedo_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-diff-1803d7e2861b304b.jpg</albedo_map>
<roughness>1</roughness>
<normal_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-nor_gl-0f35185b7225fe20.jpg</normal_map>
<roughness_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/seabed-sand-rough-318b440c109de741.jpg</roughness_map>
<metalness>0</metalness>
</metal>
</pbr>
</material>
</visual>
<!--
画面やカメラに映る形状です。変更しても衝突形状や質量は自動では変わりません。
-->
<visual name="land">
<geometry>
<!--
メッシュファイルと軸ごとの倍率です。エクスポートしたパスとリソースを一緒に保存してください。scaleはメッシュ座標に掛ける倍率です。
-->
<mesh>
<uri>terrain-visual-land.dae</uri>
</mesh>
</geometry>
<!--
表面の見た目です。RGBA色とPBRテクスチャが描画に使われます。地形テクスチャのパスとエクスポートしたリソースを維持してください。材質設定で質量や摩擦は自動では変わりません。
-->
<material>
<ambient>0.6 0.6 0.6 1</ambient>
<diffuse>1 1 1 1</diffuse>
<specular>0.03 0.03 0.03 1</specular>
<pbr>
<metal>
<albedo_map>/home/docker/wwos-data/terrain/fd128f89b979e7830a34dcd7/land-satellite-eb6fd1423859d847a276a4db49db6db51a61fe8965171639c94f8d3df66e0199.png</albedo_map>
<roughness>1</roughness>
<metalness>0</metalness>
</metal>
</pbr>
</material>
</visual>
</link>
</model>
<!--
エンジンプラグインです。filenameはインストール済みライブラリ、nameは実装を指定します。数値設定をアップロードするときも両方を維持してください。SDFファイルでプラグイン自体はインストールできません。
-->
<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu" />
<!--
エンジンプラグインです。filenameはインストール済みライブラリ、nameは実装を指定します。数値設定をアップロードするときも両方を維持してください。SDFファイルでプラグイン自体はインストールできません。
-->
<plugin filename="gz-sim-magnetometer-system" name="gz::sim::systems::Magnetometer" />
<!--
ワールドの重力ベクトルx y zで、単位はm/s^2です。このENUワールドではzの負方向が下向きです。
-->
<gravity>0 0 -9.81</gravity>
<!--
磁力計のシミュレーションに使うワールドの磁場ベクトルx y zです。単位はテスラ(T)です。
-->
<magnetic_field>5.64e-6 2.29e-5 -4.2e-5</magnetic_field>
<!--
標準SDFの風速で、単位はm/sです。運動に反映するには力モデルがこの値を使用する必要があります。波と海流はそれぞれのシーン設定で調整してください。
-->
<wind>
<linear_velocity>0 0 0</linear_velocity>
</wind>
</world>
</sdf>
この例はLinuxエンジンから出力したものです。特にmacOSでは、自分のホストから出力したファイルを使い、プラグインライブラリをインストール環境に合わせてください。
自分で生成した地形を使う
地形を生成・選択し、開始前の確認画面でそのSDFをダウンロードします。正しい参照パスと地理原点が含まれるため、このファイルに物理や照明の変更を加えます。
移動可能なコピーを残す場合は、地形ZIPもダウンロードし、ワールドファイルを相対参照の素材と一緒に保存します。ワールドSDFの操作は対応する保存済み地形に設定を適用するもので、ZIP内の地形を読み込むものではありません。先に地形の準備手順で作成・復元してください。
長時間実行の前に比較する
比較する試験では機体、初期位置、センサー構成をそろえます。時間刻み、実時間比、光の方向、カメラ、機体運動を確認します。要求倍率を上げても、描画やセンサー受信が速くなるとは限りません。初期設定や以前のファイルに戻せるよう、原本を残してください。
性能と表示
実時間係数(RTF)は、実時間1秒当たりに進むシミュレーション秒数です。要求速度は目標であり、RTFが1未満なら実時間より遅く動いています。時間刻みは接触、波、センサー、制御安定性に、ネットワーク遅延は指令と表示に影響します。1×を超えるとライブAISは非表示です。表示更新はカメラ周波数にも制限されます。
時間刻みの変更後は、付属する両機体で静止、旋回、周囲との間隔、潜航、帰還を試します。
| 表示 | 描画担当 |
|---|---|
| センサー画像 | エンジンホストのGazebo |
| 個人の機体/ワールド、ブラウザ選択時 | ブラウザGPU |
| 個人の機体/ワールド、Gazebo選択時 | エンジンホストのGazebo。インストール版の初期設定 |
| 公開LIVEの機体/ワールド | Gazeboの観察カメラ |
まず不要なカメラ数、更新周波数、解像度を減らします。ブラウザ照明は空、反射、トーンマッピング、水面法線を扱い、波形状には物理モデルのサンプルを使います。
同じシーンでFPS、フレーム時間の95パーセンタイル、描画呼び出し、三角形数、テクスチャ、形状の使用量を比較します。移動地形は遠方の表示形状を簡略化します。地形生成の処理とアルゴリズムを参照してください。衝突とセンサーには別の負荷があり、ブラウザ描画でも機体カメラとGPU LiDARはGazeboで動きます。動画FPS、センサーHz、物理RTFは分けて比較します。
機器を比較するときはワールド、機体、周波数、目標速度をそろえ、1セッションから数を増やします。地形準備時の負荷増加も含め、RTFの中央値と5パーセンタイル、物理計算時間、カメラ受信頻度とデータ経過時間、CPU、メモリ、GPU、VRAMを測ります。物理計算はコア単体の性能に依存し、地形やセンサーは複数コアも使います。カメラ数と解像度がGPU負荷を増やします。LIVEの閲覧者は1つのワールドを共有します。
Apple SiliconはMetalを使います。Ubuntu・Windows/WSLのDockerエンジンには、イメージに対応するドライバーとランタイムが必要です。LIVEは個人の利用枠を消費しません。モデル、アップロード、キャッシュには保存容量の上限があります。エンジンとモデルのダウンロード領域も確保してください。アカウントと利用時間も参照できます。