WWW-POSIM v0.6.16シミュレーターのドキュメント
ドキュメントメニュー
WWW-POSIM / シミュレーターのドキュメント

ワールドをカスタマイズ

ワールドSDFはシミュレーション環境を定義します。選択した地形から書き出したファイルを使ってください。地形の参照先、地理原点、必要なエンジンシステムが含まれます。

ワールドをダウンロードして適用する

  1. 準備済みの固定範囲の地形と機体を選び、開始前の確認画面を開きます。
  2. SDFファイルを編集 → ワールドSDFをダウンロードでworld.sdfのコピーを保存します。
  3. 対応する物理・照明項目を編集します。地形モデル、パス、ワールド名、地理原点は維持します。
  4. 編集したワールドSDFをアップロードを選びます。検証済みのリビジョンがワールド設定に追加され、自動選択されます。
  5. ワールドを開始します。地形と機体の準備後に設定が適用されます。物理時間刻み、実測速度、照明を確認します。

ファイルは元の地形リビジョンに関連付けられます。別の地形では、その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は個人の利用枠を消費しません。モデル、アップロード、キャッシュには保存容量の上限があります。エンジンとモデルのダウンロード領域も確保してください。アカウントと利用時間も参照できます。

ドキュメントを検索