8.2 Single Scan Processing — XGRIDS Pro Guide
XGRIDS Pro Guide™ / Module 8: LixelStudio

8.2 Single Scan Processing

Setting up a single-scan project in LixelStudio, selecting the correct SLAM mode, configuring advanced settings, and diagnosing common processing failures.

Project Setup

A single-scan project processes one continuous scan session into a point cloud. This is the standard workflow for any scan that fits within your workstation's RAM capacity. For scans that exceed your RAM ceiling (approximately 2 GB per minute of scan data), split into segments and use 8.3 Map Fusion.

  1. Transfer the raw scan folder from the device to your workstation's NVMe SSD. Copy the entire folder structure. Do not rename, move, or delete individual files within the folder. Verify the transfer completed by comparing folder sizes.
  2. Open LixelStudio and create a new project. Point the project at the transferred scan folder. Save the project file to a non-system drive (D: or similar). Saving project files to C: may cause disk space bottlenecks or file access conflicts during processing.
  3. Verify Windows Power and Sleep settings. Go to Settings > System > Power & Sleep. Set both Screen and Sleep to Never. A sleep interruption during SLAM optimization corrupts the project and requires restarting from import.
  4. Confirm LixelStudio version matches your device firmware. LixelStudio version requirements depend on the device firmware tier. A mismatch produces processing failures that may not include a clear error message. See the firmware-to-software compatibility table on 8.1 for the full three-tier requirement. If you recently updated device firmware, verify compatibility before processing.

SLAM Mode Selection

LixelStudio processes each scan using one of three SLAM modes. The default mode (None) provides the highest accuracy. The other two modes are Special Modes, found in Advanced Settings, used only in specific failure or environment scenarios.

None (Default)

Standard processing mode. Use this for the initial processing attempt in all environments. It provides the highest accuracy in scenes with adequate geometry, stable motion, and sufficient LiDAR return. Most scans should succeed in this mode.

Robust Mode (Off by Default)

Enable Robust Mode from Advanced Settings after a None mode failure, particularly when the processing report shows "LIO trajectory drift." Robust Mode improves success rate in partially degraded scenes and high-motion conditions but may reduce accuracy compared to None mode. Do not use Robust Mode as a first choice. It is a recovery step.

Robust Mode is a Special Mode in LixelStudio Advanced Settings, not the default. If you see "lio drift" in a processing failure, enable Robust Mode and reprocess before submitting diagnostic logs to XGRIDS support. Many scans that fail in None mode succeed in Robust Mode.

Narrow Scene Mode

Reserved for tunnels, mine shafts, and long corridors. Effective within approximately 500 m (1,640 ft). For corridors over 500 m, segment the scan every 500 m with control points at boundaries and use Map Fusion. Using Narrow Scene Mode in a standard interior or exterior environment will produce a processing failure.

Using the wrong SLAM mode wastes processing time without warning. Narrow Scene in a normal environment fails outright. None mode in a heavily degraded scene produces a drift error that Robust Mode may resolve. The processing run must complete (or fail) before you can try a different mode. Budget time for a potential second run when working with challenging environments.

Advanced Settings

These settings are configured before starting the SLAM run. They cannot be changed after processing begins without starting over.

Noise Filter

Controls point cloud noise reduction. Three levels: Weak, Normal, and Strong. Normal is appropriate for most environments. For low-density scans (sparse geometry, long-range captures), use Weak. Strong filtering on low-density scans removes legitimate detail along with noise, particularly thin structures like railings and cables.

Point Cloud Enhancement

Generates a denser, more uniform point cloud at the cost of processing time. Available at 5 mm spacing for both L2 Pro and K1, and at 1 mm spacing for L2 Pro only. The 1 mm mode requires 128 GB RAM and substantial free disk space. Enhanced point clouds are segmented into chunks during processing. If a chunk fails, only that chunk needs to be reprocessed, not the entire scan.

Point Cloud Segmentation

Splits the output point cloud into files of a specified size. Default is disabled. When enabled, the default split size is 1 GB, adjustable by the user. Useful when downstream software has file size limitations or when the full point cloud would exceed available viewer memory.

Dynamic Object Removal

Removes point cloud noise from objects that were moving during the scan, such as people, vehicles, or equipment. Effectiveness depends on the original scan collection quality. Following the field technique guidelines in Module 3 produces cleaner results than relying on this filter to compensate for a crowded scan environment.

SLAM Mapping End Time

Allows you to select a specific end time for the trajectory, discarding data after that point. This is useful when the end of a scan contains a drift event or was recorded while the device was being packed up. The selected mapping time must exceed 3 minutes. For RTK or PPK scans, re-enter the positioning settings after adjusting the end time to verify sufficient satellite data remains in the trimmed window. For GCP scans, confirm all control points still fall within the selected time range, with a minimum of 3 points required.

Running the Process

After configuring all settings, start the SLAM optimization. Processing time is approximately 20 to 30 times the scan duration on recommended hardware with NVMe SSD. A 10-minute scan takes 3 to 5 hours. A 20-minute scan takes 7 to 10 hours.

  1. Confirm Power and Sleep settings are set to Never. This is worth checking twice.
  2. Close all other applications that consume significant RAM or CPU. Web browsers, Revit, and other processing software compete for memory and can trigger out-of-memory crashes mid-run.
  3. Start SLAM optimization. LixelStudio displays an estimated processing time. This estimate is a reference only and varies based on scene complexity, hardware, and concurrent system activity.
  4. Do not use the workstation for other intensive work during processing. Memory-intensive tasks launched during the run can cause the SLAM process to crash. Light tasks (email, file management) are generally safe.
  5. After SLAM completes, proceed to coloring if camera data is available. Coloring requires LixelStudio v2.5.2.1 or later, CUDA 11.6+, and an NVIDIA GPU from the 20-series or newer. See 8.1 Pipeline Overview for full requirements.

Failure Modes and Recovery

When processing fails, the error message and context narrow down the cause. This table covers the failures most commonly encountered in single-scan processing.

Symptom
Likely Cause
Recovery
Prevention
"LIO trajectory drift" or "lio drift" error
SLAM tracking lost lock due to degraded geometry, intense motion, or sensor interference during the scan.
Enable Robust Mode in Advanced Settings and reprocess. If Robust Mode also fails, try adjusting the SLAM Mapping End Time to isolate the drifted portion. If both fail, submit diagnostic logs to XGRIDS support.
Maintain steady walking speed of 1.5 ft/s (0.5 m/s). Avoid rapid rotations. Ensure adequate feature geometry in the scan path.
Crash during filtering or out-of-memory error
Insufficient RAM for the scan duration, or other applications consuming memory during processing.
Close all unnecessary applications and reprocess. If the scan exceeds your RAM capacity (~2 GB per minute), split the scan data into segments and use 8.3 Map Fusion. Verify project files are not saved on the C: drive, which can cause disk space bottlenecks.
Match scan duration to RAM capacity. 64 GB handles ~30 min. 128 GB handles ~60 min. Close all other applications before starting.
HBC file parse failure or data corruption
Incomplete data transfer from device, file corruption during cloud storage transfer, or interrupted recording on the device.
Re-copy the raw scan folder from the device. If the data was transferred via cloud storage, re-download the original files. If the recording was interrupted on the device, the data may be partially recoverable by adjusting the SLAM Mapping End Time to the last clean segment.
Always copy the full scan folder without renaming or moving files. Verify folder sizes after transfer. Use direct USB connection rather than cloud transfer when possible.
Processing fails silently or produces unexpected results after firmware update
LixelStudio version incompatible with device firmware. See the three-tier firmware compatibility table on 8.1 for the full requirement.
Match your LixelStudio version to the correct firmware tier. Update LixelStudio if needed, then re-import and reprocess.
After any device firmware update, verify LixelStudio version compatibility before processing new data.
Coloring crash with no clear error message
GPU does not meet coloring requirements. Requires NVIDIA 20-series or newer GPU, CUDA 11.6+, NVIDIA driver v520.0+, and LixelStudio v2.5.2.1 or later.
Verify all four requirements. Update GPU drivers. If using a 10-series or older GPU, coloring cannot be performed on this workstation. Process SLAM locally and transfer the project to a compatible machine for coloring.
Confirm GPU compatibility before beginning any project that requires coloring.
Narrow Scene mode fails on standard interior
Narrow Scene mode is designed for tunnels and long corridors only. It will fail in standard environments.
Reprocess using None mode (default). If None fails, try Robust Mode.
Use Narrow Scene only for tunnels, mine shafts, and corridors. All other environments start with None.

Coordinate Transformation

If the scan includes RTK, PPK, or GCP positioning data, the coordinate transformation stage places the point cloud in a real-world coordinate system. This configuration must be set before starting SLAM optimization. Changing the target coordinate system after processing requires a complete reprocess from raw data.

RTK

RTK data is applied automatically when present and valid. The RTK status during the scan must have achieved Fixed status with 10 or more satellites, at least 10 m of movement while Fixed, and antenna tilt within 20 degrees. Validation requirements are covered in Module 4: Positioning.

PPK

PPK requires importing RINEX observation files (RINEX 3.0 or later) and configuring the base station parameters. After adjusting any settings, including SLAM Mapping End Time, re-enter the PPK settings to verify sufficient satellite data remains. Full PPK workflow details are in the LixelStudio Manual.

GCP (Ground Control Points)

GCP-based georeferencing requires at minimum 3 control points within the scan. Control point names are case-sensitive and must exactly match the names assigned during field collection. If the SLAM Mapping End Time has been adjusted, confirm all control points still fall within the selected time range.

©2026 Alpine Reality Capture LLC  •  XGRIDS Pro Guide™  •  Site Disclaimer