ワークスペースの基本
まずは準備済みの地形で起動し、各パネルの役割を確認してから機体を操作しましょう。
ログインして最初のワールドを開く
- WWW-POSIMで登録し、確認メールから認証してログインします。メールが届かない場合は迷惑メールを確認するか、再送を選んでください。インストール版でもメール認証が必要です。
- アプリではシミュレーターを起動を選びます。Webでは個人ワークスペースを開きます。サーバーの空きを待つ場合があります。
- ワークスペースで生成済み地形を開き、KMOU waterfront · 1 × 1 kmを選びます。
- 地域地形 → 機体でWAM-V、深度0 m、Autopilotを選びます。
- 生成ワールドを実行を選び、機体と最新の位置データが表示されるまで待ちます。アプリの初期設定画面は、ワールドが動き始めるまで閉じません。

| 入口 | 用途 |
|---|---|
| デモワールド | 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を含むカメラのカラー画像に反映されます。深度の数値と衝突形状は保持されます。
- 砂のテクスチャ、かすみ、色の吸収、深度に伴う日光減衰、海底の光模様:初期状態で有効。
- グリッド、等深線、浮遊粒子:初期状態で無効。グリッド間隔10 m、等深線間隔5 m。
- BlueROV2 KMOUデモは、浮遊粒子を有効にし、深度に応じた太陽光の減衰を無効にした状態で開始します。インストール型アプリに保存された設定は、このデモの初期設定より優先されます。
- 水中光学のスイッチは光学効果をまとめて切り替えます。テクスチャと計測線は個別設定です。
- インストール版は確認済み設定を保存します。サーバーセッションは既定値から始まり、採点中の変更はできません。
Gazeboでは全効果を、Browserでは砂の細部と海底線を確認できます。視覚モデルは平らな平均海面とPBR表面を使用します。非照明材質と独自の水シェーダーは固有の見え方になります。粒子と光模様は視覚的な近似です。実際に見える距離は幾何学的クリッピングに加え、かすみ、減衰、遮蔽で制限されます。技術仕様と海洋動力学と描画を参照してください。
センサーとROSトピック

センサーで機体を展開し、カメラ、LiDAR、IMUを選びます。搭載センサーはモデルごとに異なります。下向きの点検カメラでは海底を観察できます。
| 操作 | 動作 |
|---|---|
| 配信開始/停止 | その画像の受信を切り替えます。シミュレーションは続きます。 |
| 拡大/フレームを保存 | 画像を拡大するか、受信フレームを保存します。 |
| センサー周波数 | 対応する配信頻度を要求します。実測表示は実際の受信頻度です。 |
| デジタルズーム/リセット | 受信画像を拡大するか、元の倍率に戻します。 |
| ROSトピック → 検索 → トピック | メッセージを開き、サブスクライブ/解除で受信を切り替えます。 |
| フィールド/グラフ/生データ/描画 | 型と座標フレームに応じて、数値項目や対応する空間メッセージを表示します。 |
シーンカメラは外部の観察者です。センサーカメラは機体上の取付位置・姿勢に従うため、両者の向きは一致しないことがあります。
配信状態
接続中・待機中は、センサーまたは通信経路の準備中です。受信時刻も確認してください。古い画像や再接続中と表示された保持画像は、最新の測定ではありません。まずワールドの準備状態と選択したセンサーを確認します。
香港の公開デモは共有H.264動画を使い、初期バッファーを待ちます。個人カメラはJPEGを要求し、ROS圧縮画像は別経路です。フレーム保存は、デモでは表示中動画のスナップショット、個人パネルでは受信画像ファイルを保存します。センサーHz、動画FPS、実時間比はそれぞれ異なる指標です。シミュレーション・描画・センサーの構成とRVizとFoxgloveで表示を参照してください。
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停止は再有効化まで中立出力を維持します。診断には理由、適用シーケンス、ACK、推力を表示します。コマンドが途絶えるとウォッチドッグが中立に戻します。ROSターミナルと接続、Webワークスペースを制御、インストール版のワークスペースを制御に進んでください。
保存と持ち運び
ワークスペース → カスタムワールド → ストレージで、地形、機体リビジョン、ワールド設定、キャッシュ、空き容量を確認します。アーカイブは選択肢から隠す操作で、ファイルは残り、容量は空きません。復元すると再び選択できます。使用中のセッションが終わるまで待ってください。
ZIP書出し/読込みで機体とリソースを移せます。コピーを編集すると新しいリビジョンになります。起動前には機体とワールドのSDFをダウンロードし、編集して互換性のあるリビジョンをアップロードできます。機体を準備、機体をカスタマイズ、ワールドをカスタマイズを参照してください。
小さい画面と待機状態
スマートフォンでは下部ボタンで一つずつスクロール可能なパネルを開き、×かEscapeでシーンに戻ります。横向きでは操作部の横にパネルが出ます。公開デモのデスクトップ表示は全体を縮小し、縦向きでは回転を案内します。全画面表示はブラウザーの対応とユーザー操作に依存します。
無効なボタンは、準備中、地形待ち、実行中ミッション、処理中コマンドなどを示します。状態を読んでから再試行してください。パネル非表示、航跡消去、画像停止、購読解除では機体は止まりません。使い終わったらセッションを終了します。インストール版を閉じるとローカルサービスと地形生成を止め、保存済みデータは保持します。
AISの認証情報
デモはサーバーのAISStreamキーを使います。キーがなければ、インストール版のデモはOpen Watersの公開AISフィードを使います。パネルに提供元と状態が表示され、船舶の表示は最新報告の受信状況によって変わります。
カスタムワールドではシーン → 海上交通に自分のキーを入力してローカル保存します。このブラウザーに保存され、選択したシミュレーションサーバーへ送られます。ローカルキーの削除はブラウザーからキーを消します。交通表示を有効にして接続してください。シミュレーション・描画・センサーの構成も参照してください。
QGCで制御
Autopilotの機体では、ArduPilotパネルの Open QGC を選択します。インストール版アプリとログイン済みのワークスペースを開いたままにしてください。接続ダイアログが機体を準備し、QGroundControlに制御を渡します。インストール、接続、制御の解除はQGCで制御を参照してください。
BlueROV2前方ライト
ジョイスティックの前方ライトでBlueROV2の2灯を一緒にON/OFFします。表示は実際のライト状態を確認し、失敗や利用不能の操作を成功と表示しません。機体照明はシーンの昼夜やカメラ選択とは別です。