Skip to main content

Troubleshoot

Common issues and how to avoid them

Even with careful inspection and targeted scans, common issues can occur. Use the following guidance to identify and prevent these problems.

Patchy results

A sparse mesh usually indicates insufficient overlap or limited perspective change. You can:

  • Move side-to-side and vary height while scanning.
  • Capture multiple viewpoints to ensure sufficient detail.

Poor localization

Localization can fail if scans begin in areas with few distinct features. You can:

  • Start scans from previously captured views with strong geometry.
  • Include visually distinct surfaces in your scan path.

Disconnected rooms

Rooms may fail to align if doorways or hallways lack overlap. You can:

  • Move slowly through transitions between spaces.
  • Keep shared features visible between connected spaces.

Large outdoor drift

Drift occurs when scans gradually shift from their true position, often in open areas with few landmarks. You can:

  • Include stable reference points such as trees, benches, or building edges.
  • Perform multiple passes through the area to strengthen alignment.

Missing ceilings or floors

Vertical surfaces are often under-captured. You can:

  • Perform upward and downward passes during overview scans.
  • Ensure both ceilings and floors are captured in each room.

Over-scanning

Long scans without adding a new perspective do not improve quality. You can:

  • Prioritize coverage and viewpoint diversity over scan duration.
  • Add short, targeted scans instead of repeating long passes.

Final tips for reliable, reusable scans

The following best practices help ensure your scans are complete, accurate, and reusable.

  • Move deliberately and maintain steady motion throughout each scan.
  • Focus on what the camera sees rather than what you know is present.
  • Maintain overlap within each scan and between adjacent scans.
  • Favor stable, static features over dynamic or moving elements.
  • Plan scans according to intended user behavior and expected paths.
  • When in doubt, add a short, targeted scan instead of repeating a full session.
  • After completing new scans, inspect meshes and splats to verify coverage and alignment.

By combining careful review, incremental scanning, and these best practices, you can create reliable, reusable sites with accurate localization.