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

ワークスペースの基本

まずは準備済みの地形で起動し、各パネルの役割を確認してから機体を操作しましょう。

ログインして最初のワールドを開く

  1. WWW-POSIMで登録し、確認メールから認証してログインします。メールが届かない場合は迷惑メールを確認するか、再送を選んでください。インストール版でもメール認証が必要です。
  2. アプリではシミュレーターを起動を選びます。Webでは個人ワークスペースを開きます。サーバーの空きを待つ場合があります。
  3. ワークスペースで生成済み地形を開き、KMOU waterfront · 1 × 1 kmを選びます。
  4. 地域地形 → 機体でWAM-V、深度0 m、Autopilotを選びます。
  5. 生成ワールドを実行を選び、機体と最新の位置データが表示されるまで待ちます。アプリの初期設定画面は、ワールドが動き始めるまで閉じません。
デモ、生成済み地形、練習場、カスタムワールドを選ぶ初期画面
デモ、生成済み地形、練習場、カスタムワールドを選ぶ初期画面。
入口 用途
デモワールド WAM-VまたはBlueROV2を起動します。他のプレビューには利用可否が表示されます。
生成済み地形 準備済み、ダウンロード可能、生成完了の地形をまとめて表示します。
練習場 利用可能な場合に練習課題を準備します。
カスタムワールド 地域地形、機体編集、RVizツール、ストレージを開きます。
場所 → 機体 → 確認 地形、機体、初期姿勢を設定し、起動前に確認します。

AutopilotとROS 2直接制御は起動前に選びます。制御方式を変えるには、別の方式でワールドを起動してください。ArduPilotのモード変更とは別の操作です。座標と深度は入力範囲を守ってください。練習のシードは0~1,000,000の整数で、空欄なら配置を自動決定します。自由探索と管理者の基準実行では、このシードは使いません。

Macアプリは準備済み地形を初めて選んだときにダウンロードし、進捗を表示します。保存後は、固定された内容リビジョンのままオフラインでも使えます。失敗した場合は接続を確認して選び直します。WAM-Vデモは香港の地形で、前方16 m・左5 mにコーラル色、前方30 m・右8 mにライム色のブイがあります。前方カメラとLiDARで確認できます。

デモワールド

画面の見方

シーン、センサー、機体制御、地図を表示した実行中のワークスペース
シーン、センサー、機体制御、地図を表示した実行中のワークスペース。
場所 内容
上部バー 機体、地形、ライブ状態、ワークスペース、言語、シーン拡大、パネル表示。利用時間を管理する環境ではセッションも表示します。
中央 機体、ワールド、地図の各ビュー。
左側 シーンで環境と表示を設定し、センサーとROSトピックで計測値を確認します。
右側 ArduPilotまたはROS 2の制御。その下に機体の計器とグラフ。
下部の地図 地上管制で地理的位置、ウェイポイント、ミッション操作を確認します。

見出しや+/−で展開・折りたたみできます。内容は利用できる高さの中でスクロールし、別の区画が自動で縮む場合があります。パネルはサイドパネルを表示・非表示にし、シーンに集中は地図を使える状態でシーンを拡大します。シミュレーションは継続します。最初の画面にはメインページに戻る操作とログアウトもあります。

ビュー・操作 動作
機体 機体を追従し、周囲への回転やズームができます。
ワールド 近くの環境を斜めから表示します。ズームと回転には範囲制限があります。
地図 北を上にした地理地図とシミュレーション位置を表示します。ドラッグで移動します。
ドラッグ・右ドラッグ・ホイール 各ビューの案内に従って移動、回転、ズームします。
航跡を消去 予定経路と実際の航跡を画面から消します。現在位置から記録を続け、ミッションレポートは保持します。

下部のコンパスは観察カメラの向きです。機体の針路とは異なります。固定矢印がカメラ前方を示し、方位文字が回転して北を示します。時計はシミュレーション時刻で、1.00×は実時間と同じ速さです。

予定経路は黄色、実測航跡は青緑色です。最大1,024区間を表示し、古い区間から置き換えます。新しい誘導ミッションを始めるとGazeboの航跡を消去します。シーンの幅5 mmの線はセンサー画像には入りません。

シーン・波・海流

環境と描画設定を開いたシーンパネル
環境と描画設定を開いたシーンパネル。
区画 操作
波 海況0~4を選んで適用します。詳細設定では風速、風向、波の急峻度を編集します。
海流 海流を有効にし、一様流または深度プロファイルを選び、海流を適用で適用します。ソルバーの確認を待ちます。
海上交通 最新AIS報告から船舶を表示します。受信範囲とシミュレーション速度に依存します。
シーン描画 利用可能なBrowser/Gazeboを選び、水中の見え方を設定します。
表示 海底、海面、グリッド、軸、照明、水や地図の不透明度。対応項目はビューによって異なります。
描画性能 ブラウザーの実測レンダリング統計を表示します。

自由ワークスペースは海況2で始まります。プリセットの風速は0、1、3、6、8 m/s、急峻度は1です。風による近似設定であり、波高を保証するものではありません。情報ボタンでWMOの範囲を確認できます。課題では指定条件が維持されます。

海流を変更する前にミッションまたはROS制御を止めます。プロファイルは深度0 mから始まり、最大8点、速度0~1 m/sです。点を横にドラッグして速度を変え、表で深度と方向を編集します。流れる向きが0°で東、90°で北です。各物理ステップで各リンクの実際の深度を使い、流速ベクトルを線形補間します。最深点より下ではその点の流れを保ちます。海流は水に対する相対速度と抵抗に作用し、波は独立したモデルを使います。

インストール版の既定表示はGazeboです。Browserを選ぶとGazeboのシーンカメラ負荷を減らせます。物理、センサーカメラ、GPU LiDARの計算は引き続きGazeboが行います。選択はそのビューを開いている間有効です。BlueROV2の追従カメラは揺れを滑らかにし、海面も表示します。対応するビューでは縦ドラッグで機体の下側から観察できます。

水中の見え方

シーン → シーン描画 → 水中の見え方を開きます。設定はGazeboシーンとRGBDを含むカメラのカラー画像に反映されます。深度の数値と衝突形状は保持されます。

Gazeboでは全効果を、Browserでは砂の細部と海底線を確認できます。視覚モデルは平らな平均海面とPBR表面を使用します。非照明材質と独自の水シェーダーは固有の見え方になります。粒子と光模様は視覚的な近似です。実際に見える距離は幾何学的クリッピングに加え、かすみ、減衰、遮蔽で制限されます。技術仕様と海洋動力学と描画を参照してください。

センサーとROSトピック

シミュレーション機体のカメラ画像と受信操作
シミュレーション機体のカメラ画像と受信操作。

センサーで機体を展開し、カメラ、LiDAR、IMUを選びます。搭載センサーはモデルごとに異なります。下向きの点検カメラでは海底を観察できます。

操作 動作
配信開始/停止 その画像の受信を切り替えます。シミュレーションは続きます。
拡大/フレームを保存 画像を拡大するか、受信フレームを保存します。
センサー周波数 対応する配信頻度を要求します。実測表示は実際の受信頻度です。
デジタルズーム/リセット 受信画像を拡大するか、元の倍率に戻します。
ROSトピック → 検索 → トピック メッセージを開き、サブスクライブ/解除で受信を切り替えます。
フィールド/グラフ/生データ/描画 型と座標フレームに応じて、数値項目や対応する空間メッセージを表示します。

シーンカメラは外部の観察者です。センサーカメラは機体上の取付位置・姿勢に従うため、両者の向きは一致しないことがあります。

配信状態

接続中・待機中は、センサーまたは通信経路の準備中です。受信時刻も確認してください。古い画像や再接続中と表示された保持画像は、最新の測定ではありません。まずワールドの準備状態と選択したセンサーを確認します。

香港の公開デモは共有H.264動画を使い、初期バッファーを待ちます。個人カメラはJPEGを要求し、ROS圧縮画像は別経路です。フレーム保存は、デモでは表示中動画のスナップショット、個人パネルでは受信画像ファイルを保存します。センサーHz、動画FPS、実時間比はそれぞれ異なる指標です。シミュレーション・描画・センサーの構成とRVizとFoxgloveで表示を参照してください。

ArduPilotと手動操作

アーム状態と確認済みモードを示すWAM-VのArduPilotパネル
アーム状態と確認済みモードを示すWAM-VのArduPilotパネル。
BlueROV2のモード選択を示すArduPilotパネル
BlueROV2のモード選択を示すArduPilotパネル。

テレメトリー、アーム状態、見出しに報告されたモードを確認します。手動入力を中立にし、ミッションを終了または中止してからモードを変えます。動作モードを選んで適用し、返された値を確認してください。選択欄の値は要求であり、確定状態ではありません。

起動は準備検査後に推進を有効にします。停止は推進を無効にし、ミッションも取り消します。モードの選択だけではアームされません。拒否されたらエラーと接続詳細を確認します。カメラが映っていても制御の準備完了とは限りません。

機体 メニューのモード
WAM-V · ArduRover MANUAL:スロットルと操舵を直接操作。HOLD:推進を中立にしますが、慣性・波・海流で動くことがあります。STEERING:速度と旋回をフィードバックで補助。
BlueROV2 · ArduSub MANUAL:直接操作。STABILIZE:姿勢を安定化し、深度は手動。ALT_HOLD:深度維持も行いますが、水平位置は保持しません。

確認済みミッションの開始時には、アプリがGUIDEDとアームを要求します。ミッションが管理するモードで、手動メニューにはありません。オートパイロットのミッションを参照してください。

マウス、タッチ、ゲームパッドによる手動入力パネル
マウス、タッチ、ゲームパッドによる手動入力パネル。

ジョイスティック入力を有効にし、マウス/タッチまたはゲームパッドを選びます。WAM-Vはスロットルと操舵、BlueROV2は横移動と上下移動も使えます。低いゲインと中立入力から始めます。入力を停止は現在の押下を取り消します。再開するには離してから押し直してください。フォーカス喪失、ディスアーム、入力元変更、コマンド拒否でも押下が終了します。

ゲームパッドはLB/L1を押しながら操作します。離すと中立入力を送り、ディスアームはしません。移動中の機体が即停止するわけでもありません。BlueROV2ではY/△がALT_HOLD、A/×がSTABILIZEを要求します。結果をパネルで確認してください。全割り当ては手動操作とゲームパッドで説明しています。

地図とミッション

新しい水中ウェイポイントの初期深度は2 mです。通常の範囲は0~10 mで、対応する観測シーンではサーバーが表示するミッションの深度制限を確認してください。

ウェイポイントとミッション操作を表示する地上管制地図
ウェイポイントとミッション操作を表示する地上管制地図。

経路を確認する前に座標と深度を入力します。水上のポイントは深度0 mで、地図の各ポイントでは1秒待機します。編集中の空欄は空欄のままです。

操作 動作
クリック/右クリック ポイント追加/近くのポイント削除。ドラッグ、ホイール、ピンチで移動・拡大します。
出発点に戻る/消去 帰還を設定/編集中のポイントを消去。
経路確認 地形を検査したプレビューを作成。経路、余裕、障害理由を確認します。
経路実行 検査済み経路を開始し、準備確認後にアーム。
停止/次へ/中止 待機目標を維持/再開/中止してディスアーム。

機体が移動した可能性があるため、次の実行前にも再検査します。地図のポイントはプリセットより優先されるので、プリセットを使うには消去します。検査は地形と船体の余裕を確認しますが、移動船の回避やCOLREG準拠までは保証しません。オートパイロットのミッションを参照してください。

機体の計器

姿勢計、グラフ、シミュレーション速度、位置、接続詳細
姿勢計、グラフ、シミュレーション速度、位置、接続詳細。

固定された青いマーカーが機体で、動く水平線がロールとピッチを示します。針路は0°北、90°東、180°南、270°西です。深度は海面ゼロ基準の−Zで、水中が正、上が負です。海底までの距離とは異なります。

グラフは直近100件の姿勢サンプルを保持します。深度、針路、ピッチ、ロール、速度、推力入力を選べます。深度・姿勢・速度はシミュレーター値です。速度は機体座標でX前、Y左、Z上、単位m/sです。推力はN単位の要求値で、実測力ではありません。欠測や古いデータは線の空白や—になります。深度と姿勢は同一サンプル・時刻を使い、デモでは動画時刻に合わせます。

速度と物理ステップ

選択すると直ちに要求が送られます。適用結果を待ってください。

設定 値
要求速度 0.25×、0.5×、1×、2×、4×
物理ステップ 5、10、20 ms。すでに30 msのワールドでは30 msも表示
実測 シミュレーション時間÷実時間。要求より遅くなる場合あり

機体のディスアーム、ミッション・手動・ROS入力の停止、地形準備完了が必要です。1×を超えるとAISは使えません。Windows/Linuxの初期値は20 ms、Macネイティブは10 msです。課題では指定の10 msを維持します。ワールドをカスタマイズを参照してください。

位置と接続

N/E/Dはローカル原点から北・東・下への距離で、単位はmです。地理座標は緯度、経度の順で度単位です。R/P/Y · ENUは生の角度で、ヨー0°が東、90°が北です。計器ではピッチを−P、針路を(90 − Y + 360) % 360に変換します。

接続詳細は位置データのシーケンス、経過時間、ENUフレームを示します。増加する番号と新しい時刻が受信継続の目安です。制御パネルの診断は別です。RViz操作は、アプリではネイティブRViz2、Webではブラウザービューアーを開きます。ワールドと、アプリではRVizサービスの準備が必要です。RVizとFoxgloveで表示を参照してください。ArduPilotパラメーターは専用パネルで読取・書出し・編集を行い、許可された値をディスアーム中に適用して読み戻します。

ROS 2直接制御

ROS制御の許可、停止、診断を表示するパネル
ROS制御の許可、停止、診断を表示するパネル。

ROSを有効にすると、接続したコントローラーから範囲制限付きコマンドを受け付けます。ROS停止は再有効化まで中立出力を維持します。診断には理由、適用シーケンス、ACK、推力を表示します。コマンドが途絶えるとウォッチドッグが中立に戻します。ROSターミナルと接続、Webワークスペースを制御、インストール版のワークスペースを制御に進んでください。

保存と持ち運び

ワークスペース → カスタムワールド → ストレージで、地形、機体リビジョン、ワールド設定、キャッシュ、空き容量を確認します。アーカイブは選択肢から隠す操作で、ファイルは残り、容量は空きません。復元すると再び選択できます。使用中のセッションが終わるまで待ってください。

ZIP書出し/読込みで機体とリソースを移せます。コピーを編集すると新しいリビジョンになります。起動前には機体とワールドのSDFをダウンロードし、編集して互換性のあるリビジョンをアップロードできます。機体を準備、機体をカスタマイズ、ワールドをカスタマイズを参照してください。

小さい画面と待機状態

スマートフォンでは下部ボタンで一つずつスクロール可能なパネルを開き、×かEscapeでシーンに戻ります。横向きでは操作部の横にパネルが出ます。公開デモのデスクトップ表示は全体を縮小し、縦向きでは回転を案内します。全画面表示はブラウザーの対応とユーザー操作に依存します。

無効なボタンは、準備中、地形待ち、実行中ミッション、処理中コマンドなどを示します。状態を読んでから再試行してください。パネル非表示、航跡消去、画像停止、購読解除では機体は止まりません。使い終わったらセッションを終了します。インストール版を閉じるとローカルサービスと地形生成を止め、保存済みデータは保持します。

AISの認証情報

デモはサーバーのAISStreamキーを使います。キーがなければ、インストール版のデモはOpen Watersの公開AISフィードを使います。パネルに提供元と状態が表示され、船舶の表示は最新報告の受信状況によって変わります。

カスタムワールドではシーン → 海上交通に自分のキーを入力してローカル保存します。このブラウザーに保存され、選択したシミュレーションサーバーへ送られます。ローカルキーの削除はブラウザーからキーを消します。交通表示を有効にして接続してください。シミュレーション・描画・センサーの構成も参照してください。

QGCで制御

Autopilotの機体では、ArduPilotパネルの Open QGC を選択します。インストール版アプリとログイン済みのワークスペースを開いたままにしてください。接続ダイアログが機体を準備し、QGroundControlに制御を渡します。インストール、接続、制御の解除はQGCで制御を参照してください。

BlueROV2前方ライト

ジョイスティックの前方ライトでBlueROV2の2灯を一緒にON/OFFします。表示は実際のライト状態を確認し、失敗や利用不能の操作を成功と表示しません。機体照明はシーンの昼夜やカメラ選択とは別です。

ドキュメントを検索