> ## 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.

# Mapeamento de cobertura (VSLAM)

## Visão geral

<Warning>
  **O VSLAM é um produto em versão beta.** Embora estejamos aprimorando e testando ativamente,
  você pode encontrar ocasionalmente bugs, quedas de desempenho ou comportamentos inesperados.
  Envie relatos de bugs e solicitações de recursos para nossa equipe em [support@dwe.ai](mailto:support@dwe.ai).
</Warning>

O DeepWater Desktop pode criar automaticamente uma reconstrução densa do seu ambiente, útil para mapeamento de cobertura ao vivo e medições.

## Requisitos

* Módulo SVC Pro - executando dweOS Pro
* Computador/laptop na superfície - executando DeepWater Desktop

## Parâmetros de inicialização

<Steps>
  <Step title="Altere o protocolo de rede">
    Abra a caixa de diálogo "Add Stream", selecione suas câmeras e mude o Network Protocol para Coverage Mapping. Confira [nosso guia de início rápido](/pt/dw-desktop/quickstart) para informações sobre como fazer isso.

    <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="Ajuste os parâmetros de rastreamento e filtro (opcional)">
    <Info>
      Mantenha os parâmetros padrão para a melhor experiência pronta para uso. O ajuste
      manual é totalmente opcional e reservado para otimização avançada de desempenho.
    </Info>

    O desempenho de rastreamento do VSLAM pode ser otimizado para o seu ambiente ajustando os parâmetros de rastreamento e do filtro de voxel.

    <Card title="Parâmetros de rastreamento e filtro" icon="sliders" href="/pt/dw-desktop/guides/vslam-parameters" horizontal>
      Referência para ajustar os parâmetros de rastreamento e do filtro de voxel do VSLAM.
    </Card>
  </Step>

  <Step title="Inicie a transmissão">
    Clique no botão "Start Stream". Assim que a transmissão for iniciada, o DeepWater Desktop começará a processar seus dados.
    Você deve agora ver uma nuvem de pontos 3D sendo gerada conforme sua câmera se move.

    Se você planeja pós-processar os dados, inicie também uma gravação aqui.

    <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>

## Fechamentos de laço

Todos os sistemas SLAM acumulam erro ao longo do tempo. Para corrigir isso, usamos o conceito de fechamentos de laço — visualizar o mesmo local a partir da mesma pose em diferentes momentos.
O DeepWater Desktop reconhece automaticamente os fechamentos de laço e ajusta as poses e nuvens de pontos medidas anteriormente.

Para iniciar um fechamento de laço, basta retornar a uma pose anterior e olhar na mesma direção. Uma mensagem aparecerá no canto inferior direito:

<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>

indicando que um fechamento de laço ocorreu, seguido por
um ajuste global da nuvem de pontos e das poses anteriores.

<Frame caption="Nuvem de pontos antes do fechamento de laço com erro acumulado">
  <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="Nuvem de pontos após o fechamento de laço com poses corrigidas">
  <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>

## Mapas

Ao perder o rastreamento por um período prolongado, o sistema criará um novo mapa do zero. Todos os mapas anteriores são salvos na memória e podem ser visualizados
clicando em seus rótulos no canto superior direito:

<Frame caption="O mapa destacado é aquele ao qual está sendo adicionado atualmente.">
  <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>

Não se preocupe em perder o rastreamento por curtos períodos, pois os mapas são mesclados automaticamente quando possível. Ao descobrir seções sobrepostas, você receberá
esta mensagem:

<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>

e, após uma breve espera, a nuvem de pontos refletirá as alterações.

A criação automática de mapas pode ser ativada/desativada pressionando <kbd>Z</kbd> ou o botão Map. Se estiver desativada, o sistema apenas tentará se localizar em relação aos mapas existentes.

<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>

## Ferramentas e controles

### Navegação

Quando a visualização da cena estiver em foco, use os seguintes controles para mover a câmera virtual:

| Controle                                                            | Ação                          |
| ------------------------------------------------------------------- | ----------------------------- |
| <kbd>W</kbd> / <kbd>S</kbd>                                         | Mover para frente / para trás |
| <kbd>A</kbd> / <kbd>D</kbd>                                         | Mover para esquerda / direita |
| <kbd>E</kbd> / <kbd>Q</kbd>                                         | Mover para cima / para baixo  |
| <kbd><Icon icon="computer-mouse" /> Clique direito</kbd> + arrastar | Deslocar a visualização (pan) |

<Frame caption="A posição da câmera pode ser redefinida pressionando este botão.">
  <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>

### Régua

Pressione <kbd>Space</kbd> para pausar a transmissão.
Pressione <kbd>R</kbd> ou selecione o ícone de régua no canto inferior direito para ativar a ferramenta Régua. Selecione dois pontos para ver a distância entre eles.

<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>

### Modo de cor

Pressione <kbd>C</kbd> ou selecione o ícone da paleta de cores no canto inferior direito para alternar entre os modos de visualização Texture e Coverage.

<Frame caption="O modo Texture mostra a cor RGB média observada para cada ponto.">
  <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="O modo Coverage mostra a distância mais próxima na qual cada ponto foi observado. Vermelho é mais próximo, azul é mais distante. Usa o mesmo mapeamento de cores da visualização de profundidade.">
  <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>

O modo Coverage facilita identificar quais seções estão com pouco detalhe.

| Cor                                                                                     | Distância observada | Detalhe                                                         |
| --------------------------------------------------------------------------------------- | ------------------- | --------------------------------------------------------------- |
| <Badge color="orange" stroke>Laranja</Badge> <Badge color="red" stroke>Vermelho</Badge> | De perto            | Bom nível de detalhe                                            |
| <Badge color="green" stroke>Verde</Badge> <Badge color="blue" stroke>Azul</Badge>       | À distância         | Menor detalhe — pode se beneficiar de uma passagem mais próxima |

## Solução de problemas

### Configurando buffers de recepção UDP

Pacotes RTP podem ser descartados devido ao tamanho insuficiente do buffer de recepção UDP. Recomendamos aumentá-lo manualmente, pois o valor padrão frequentemente é insuficiente para capturar corretamente
frames completos.

<Tabs>
  <Tab title="Linux" icon="linux">
    Recomendamos definir o tamanho máximo do buffer de recepção do sistema operacional em 8 MB:

    ```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>
        Abra o Gerenciador de Dispositivos e clique com o botão direito no adaptador de rede ao qual o SVC está conectado. Abra a página "Propriedades".

        <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>
        Vá para a aba "Avançado" e selecione "Receive Buffers". Defina como 1024 ou o maior valor aceitável.

        <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>
