# PointCloudRegistration

**Repository Path**: yaohaitang/cloud

## Basic Information

- **Project Name**: PointCloudRegistration
- **Description**: 该仓库用来进行点云配准

- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-15
- **Last Updated**: 2026-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 点云测量与理论模型对比 Demo

Qt 6.8.3 + PCL 1.12.1 + OpenCASCADE 7.9.3，VS2022 x64 / CMake 工程。

提供中文安装版 EXE（安装进度条、目录选择、快捷方式、卸载）和免安装 ZIP。制作安装版运行 `scripts/build_all.ps1 -Installer`；首次需 `scripts/setup_installer_tools.ps1`。详见 [安装与卸载](docs/安装与卸载.md)。

支持 L/V/帽型实体参数化建模、整体板厚修改、STEP/STL 导入导出、理论点云采样、带尺寸偏差和噪声的模拟测量、PCA/ICP 配准、板面/圆角拟合、截面显示、偏差热图、CSV/HTML/JSON/PNG 导出。

## 直接运行

首次操作可按 [帽型工件成功拟合教程](docs/帽型工件_成功拟合操作教程.md) 填写参数，查看完整操作顺序和实际验证结果。

外部用户完整解压 `dist/PointCloudRegistration-0.0.1-win64-*.zip`，运行其中的 `PointCloudRegistration.exe`。启动时显示约 2.8 秒的点云汇聚与扫描动画及版本号 0.0.1，点击或按 Esc 可以跳过；进入主界面后点击“一键完整演示”。窗口、任务栏与 EXE 使用统一的 CAD / 点云图标。

右侧三维视图、测量结果、运行日志之间的浅蓝色分隔条支持上下拖动。“重置分区”恢复默认高度；“重置视角”只重置三维相机。每条日志包含本地日期、时间和毫秒。

源码位于当前项目；详细说明见 [操作说明](docs/操作说明.md)、[设计与算法](docs/设计与算法说明.md)、[编译与打包](docs/编译与打包.md)、[演示录制脚本](docs/演示录制脚本.md)。

## 编译

在项目目录的 PowerShell 中执行：

```powershell
powershell -ExecutionPolicy Bypass -File scripts/build_all.ps1
```

依赖默认路径为 `D:/Qt/6.8.3/msvc2022_64`、`D:/PCL/PCL 1.12.1` 和 `D:/PointCloudDeps/occt793`。缺少 CAD 依赖时先执行 `scripts/setup_deps.ps1`。

## 验证范围与边界

`demo_tests` 验证三种工件的 CAD 有效性、STEP/STL 回读、点云文件回读、固定种子复现、配准改善以及对已知注入偏差的拟合精度。

第一版只处理模拟数据，不接入扫描设备。点云导入支持 ASCII PCD/PLY/XYZ/CSV；任意导入 CAD 支持采样与配准，厚度/折弯测量依赖内置模型的区域先验。点距容差不等同于尺寸验收容差；对称形状和大面积遮挡可能影响配准结果。提供录制脚本及自动截图，未包含预录视频。