> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dwe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Coverage Mapping (VSLAM)

## 概要

<Warning>
  **VSLAM はベータ版製品です。** 現在も改良とテストを積極的に進めているため、
  不具合、パフォーマンスの低下、想定外の動作が発生する可能性があります。
  バグ報告や機能リクエストは [support@dwe.ai](mailto:support@dwe.ai) までお寄せください。
</Warning>

DeepWater Desktop は環境の高密度な再構築を自動的に生成でき、リアルタイムのカバレッジマッピングや計測に活用できます。

## 必要条件

* SVC Pro モジュール - dweOS Pro を実行
* トップサイドコンピュータ/ノート PC - DeepWater Desktop を実行

## 起動パラメータ

<Steps>
  <Step title="ネットワークプロトコルを変更する">
    「Add Stream」ダイアログを開き、カメラを選択して Network Protocol を Coverage Mapping に切り替えます。手順については [クイックスタートガイド](/ja/dw-desktop/quickstart) を参照してください。

    <Frame caption="">
      <img width="400px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-1.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=d13d554be6d25dbf8a23f0360d013bf1" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-1.png" />
    </Frame>
  </Step>

  <Step title="トラッキングとフィルターのパラメータを調整する (任意)">
    <Info>
      最良の使用感を得るためには、デフォルトのパラメータのまま使用することを推奨します。手動チューニングは完全に任意で、
      高度なパフォーマンス最適化のためのものです。
    </Info>

    VSLAM のトラッキング性能は、トラッキングおよびボクセルフィルターのパラメータを調整することで、ご利用の環境に合わせて最適化できます。

    <Card title="トラッキング & フィルターパラメータ" icon="sliders" href="/ja/dw-desktop/guides/vslam-parameters" horizontal>
      VSLAM のトラッキングおよびボクセルフィルターのパラメータをチューニングするためのリファレンスです。
    </Card>
  </Step>

  <Step title="ストリームを開始する">
    「Start Stream」ボタンを押します。ストリームが開始されると、DeepWater Desktop はデータの処理を開始します。
    カメラを動かすにつれて 3D ポイントクラウドが生成されていく様子が表示されます。

    データを後処理する予定がある場合は、ここで録画も開始してください。

    <Frame caption="">
      <video playsinline="true" muted="muted" autoplay="autoplay" loop="loop" preload="metadata" type="video/mp4" src="https://dwe.ai/cdn/shop/videos/c/vp/ced793c107f24d01881ef1f911c640db/ced793c107f24d01881ef1f911c640db.HD-1080p-7.2Mbps-85197215.mp4?v=0" />
    </Frame>
  </Step>
</Steps>

## ループクロージャ

すべての SLAM システムは時間とともに誤差を蓄積します。これを補正するため、ループクロージャという概念を使用します。これは、異なる時刻に同じ姿勢で同じ場所を再観測することを指します。
DeepWater Desktop はループクロージャを自動的に認識し、以前に測定された姿勢とポイントクラウドを適切に補正します。

ループクロージャを発生させるには、以前の姿勢に戻って同じ方向を向くだけで済みます。画面右下にメッセージがポップアップ表示されます:

<Frame caption="">
  <img width="250px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-loop-closure.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=a729873ad91a59c98e980d2519bf7b56" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-loop-closure.png" />
</Frame>

これによりループクロージャが発生したことが示され、続いてポイントクラウドと過去の姿勢のグローバル調整が行われます。

<Frame caption="誤差が蓄積したループクロージャ前のポイントクラウド">
  <img width="400px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-pre-loop-closure.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=fad615fd06e541445793ba14d0911256" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-pre-loop-closure.png" />
</Frame>

<br />

<Frame caption="姿勢が補正されたループクロージャ後のポイントクラウド">
  <img width="400px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-post-loop-closure.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=65d7803a4e9abcca452e2212203667f7" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-post-loop-closure.png" />
</Frame>

## マップ

トラッキングが長時間失われると、システムは新しいマップを最初から作成します。これまでのマップはすべてメモリに保存されており、右上のラベルをクリックすることで表示できます:

<Frame caption="ハイライトされているマップが現在追加中のマップです。">
  <img width="250px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-map-selection.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=94f7e91e338e8955ffa17ad54619f551" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-map-selection.png" />
</Frame>

短時間のトラッキングロスは気にする必要はありません。マップは可能な場合、自動的にマージされます。重複する部分が検出されると、次のメッセージが表示されます:

<Frame caption="">
  <img width="250px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-map-merge.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=b6d1fa6a408c4f97b30caf446e75a5e9" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-map-merge.png" />
</Frame>

しばらくするとポイントクラウドに変更が反映されます。

自動マップ作成は <kbd>Z</kbd> キーまたは Map ボタンでオン/オフを切り替えられます。オフの場合、システムは既存のマップに対して自己位置推定のみを試みます。

<Frame caption="">
  <img width="250px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-togglemap.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=02e4f48e93132e0b88bad9f76a4bf613" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-togglemap.png" />
</Frame>

## ツールとコントロール

### ナビゲーション

Scene ビューにフォーカスがある状態で、以下のコントロールを使って仮想カメラを移動できます:

| コントロール                                                 | アクション    |
| ------------------------------------------------------ | -------- |
| <kbd>W</kbd> / <kbd>S</kbd>                            | 前進 / 後退  |
| <kbd>A</kbd> / <kbd>D</kbd>                            | 左 / 右に移動 |
| <kbd>E</kbd> / <kbd>Q</kbd>                            | 上 / 下に移動 |
| <kbd><Icon icon="computer-mouse" /> 右クリック</kbd> + ドラッグ | ビューをパン   |

<Frame caption="このボタンを押すとカメラ位置をリセットできます。">
  <img width="250px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-resetcamera.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=5ca0ce440191a9a4d0e9f1e267545b01" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-resetcamera.png" />
</Frame>

### Ruler

<kbd>Space</kbd> キーを押してストリームを一時停止します。
<kbd>R</kbd> キーを押すか、右下の Ruler アイコンを選択して Ruler ツールを有効化します。2 点を選択するとその間の距離が表示されます。

<Frame caption="">
  <video playsinline="true" muted="muted" autoplay="autoplay" loop="loop" preload="metadata" type="video/mp4" src="https://dwe.ai/cdn/shop/videos/c/vp/b687eeb8036540dc88ba9982ba5aa4b4/b687eeb8036540dc88ba9982ba5aa4b4.HD-1080p-7.2Mbps-85197296.mp4?v=0" />
</Frame>

### カラーモード

<kbd>C</kbd> キーを押すか、右下のカラーパレットアイコンを選択して、Texture モードと Coverage モードの表示を切り替えます。

<Frame caption="Texture mode は各点について観測された RGB の平均色を表示します。">
  <img width="400px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-texture-mode.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=7ce4cda80da8dfe376ea4ffe5d4e2342" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-texture-mode.png" />
</Frame>

<br />

<Frame caption="Coverage モードは各点が観測された最短距離を表示します。赤が近く、青が遠いことを表します。深度ビューと同じカラーマッピングを使用します。">
  <img width="400px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-coverage-mode.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=db74254149ca6e0ecc86097f67728bff" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-coverage-mode.png" />
</Frame>

Coverage モードを使用すると、ディテールが不足している箇所を見つけやすくなります。

| 色                                                                                 | 観測距離 | ディテール                           |
| --------------------------------------------------------------------------------- | ---- | ------------------------------- |
| <Badge color="orange" stroke>Orange</Badge> <Badge color="red" stroke>Red</Badge> | 近距離  | 高いディテール                         |
| <Badge color="green" stroke>Green</Badge> <Badge color="blue" stroke>Blue</Badge> | 遠距離  | 低めのディテール — より近づいて再スキャンするとよいでしょう |

## トラブルシューティング

### UDP 受信バッファの設定

UDP 受信バッファのサイズが不足していると、RTP パケットが破棄されることがあります。デフォルト値ではフルフレームを適切にキャプチャするには不十分な場合が多いため、手動で値を増やすことを推奨します。

<Tabs>
  <Tab title="Linux" icon="linux">
    OS の最大受信バッファサイズを 8MB に設定することを推奨します:

    ```bash theme={null}
    sudo sysctl -w net.core.rmem_max=8338608 
    sudo sysctl -w net.core.rmem_default=8338608 
    ```
  </Tab>

  <Tab title="Windows" icon="windows">
    <Steps>
      <Step>
        デバイスマネージャーを開き、SVC が接続されているネットワークアダプターを右クリックします。「プロパティ」ページを開きます。

        <Frame caption="">
          <img width="400px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-device-manager.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=02bd8713c60b218202cdc24e28cd38d2" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-device-manager.png" />
        </Frame>
      </Step>

      <Step>
        「詳細設定」タブに移動し、「受信バッファ」を選択します。1024 または許容される最大値に設定してください。

        <Frame caption="">
          <img width="400px" src="https://mintcdn.com/deepwaterexplorationinc/XQu0YI4ZP0f0zWio/dw-desktop/guides/images/vslam/dw-desktop-vslam-receive-buffers.png?fit=max&auto=format&n=XQu0YI4ZP0f0zWio&q=85&s=ae6fa1b22d8b7a75f7fe6ab424a524e8" data-path="dw-desktop/guides/images/vslam/dw-desktop-vslam-receive-buffers.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>
