3D点位置度
算子功能
计算形位公差-点位置度
如下图所示，点位置度为实际圆圆心到理论圆圆心的距离
参数介绍
输入参数
| 参数 | 范围 | 默认值 | 说明 | 图示 |
|---|---|---|---|---|
| 输入图像 | 0-8 | 0 | 图像输入的IM编号 | |
计算参数
| 参数 | 范围 | 默认值 | 说明 | 图示 |
|---|---|---|---|---|
| 实际位置 | 3D圆 | - | 实际的拟合3D圆 | |
| 理论位置 | json文件 | - | 被测平面上的采集点文件 | |
| 贴合点云 | true/false | false | 将理论位置点平移到最贴合区域框选点云的位置，使得测量值最小，参见贴合设置 | |
| 使用区域参数 | true/false | false | 启用则以区域作为输入，不启用则以输入图像作为输入 | |
| 区域 | 2D窗口/2D圆形窗口/2D多边形窗口/盒子/圆柱盒子/旋转盒子/点集 | 盒子 | 手动框选合适的ROI区域可以通过绑定选择已存在的ROI区域 | |
| 拟合方法 | 最小二乘法/RANSAC | 最小二乘法 | 选择拟合圆的方法 | |
| 距离阈值 | 0.0-50.0 | 0.02 | 选择合适的距离阈值，当噪点多时，调大该参数，当噪点少则调小该参数 | |
| 最大迭代次数 | 100-10000 | 500 | 设置迭代次数的最大值 |
贴合设置
| 参数 | 范围 | 默认值 | 说明 | 图示 |
|---|---|---|---|---|
| 迭代次数 | 1-2000 | 500 | 迭代时最大计算次数 | |
| 误差期望 | 0.00001-1000000 | 0.00001 | 点到圆的距离误差之和，当到达误差期望值时，迭代停止 | |
| 步长 | 0.00001-1000000 | 0.00001 | 迭代时每次点移动的长度 |
结果显示
| 参数 | 范围 | 默认值 | 说明 | 图示 |
|---|---|---|---|---|
| 实际平面 | true/false | false | 输入的实际平面，若启用，则显示在IM上 | |
| 基准线 | true/false | false | 输入的基准线，若启用，则显示在IM上 | |
| 交点 | true/false | false | 输入的采集点到实际平面的垂足，若启用，则显示在IM上 | |
| 测量点与贴合基准面交点连线 | true/false | false | 输入的采集点到实际平面的垂足连线，若启用，则显示在IM上 | |
| 平行度 | true/false | false | 输出的平行度，若启用，则显示在IM上 | |
| result | string | OK/NG | 平行度是否在范围内 |
输出参数
| 名称 | 类型 | 范围 | 说明 |
|---|---|---|---|
| Result | bool | true/false | true为成功 false为失败 |
| Warning | bool | true/false | true表示有警告 false表示没有 |
| Message | string | 输出成功或错误或警告信息,如果没有错误或警告为空 | |
| Time | float | 算子执行时间，单位: ms | |
| positional_degree | float | 位置度 |
提示
更多参数类型详细说明，请参看类型定义
异常排查
| 序号 | 异常信息 | 对应参数 | 解决方法 |
|---|---|---|---|
| 1 | 输入点云的点数小于3 | 确认IM是否存在至少三个有效点，若少于3个有效点，请加载点云或切换存在至少3个有效点的IM | |
| 2 | 输入的实际位置圆类型为{0}，无效的类型 | 实际位置类型 | 检查平面类型是否为3D圆 |
| 3 | 参数 {0} 不能为空 | 路径 | 检查路径是否为空 |
| 4 | 文件 {0} 不存在或无法访问 | 路径 | 检查路径是否有效 |
| 5 | 输入的理论位置点云为空 | 检查理论位置点json文件是否为空 | |
| 6 | 输入垂直度范围的最小值大于最大值，无效的垂直度范围 | 设置垂直度范围最小值小于等于最大值 | |
| 7 | 输入的拟合方式为{0}，无效的拟合方式 | 拟合方式 | 输入拟合方式为最小二乘法/RANSAC |
| 8 | RANSAC拟合圆失败 | 调整RANSAC参数：距离阈值 | |
| 9 | 输入的区域类型是{0}，无效区域类型 | 区域类型 | 检查区域类型是否为2D窗口/2D圆形窗口/2D多边形窗口/盒子/圆柱盒子/旋转盒子/点集其中之一 |
| 10 | 输入的多边形顶点个数小于3，无法形成多边形 | 添加2d多边形窗口顶点数，使得顶点数至少为3 | |
| 11 | 输入的区域点云为空 | 1. 检查是否框选为空 2. 检查点集是否为空 |
示例介绍
工程设计
选择
加载点云工具，加载需要处理的3d点云图到IM0；选择
3D圆工具，拟合3D圆。选择
3D点位置度工具。
工具使用
选择需要进行操作的输入图像，图像序号要与工程中图像所在IM序号一致
不启用使用区域参数或启用区域并选择区域类型为盒子，将盒子移动到待测位置，包围住待测点云
使用技巧
1. 通过图像窗口上的ROI控制器来拖动或缩放盒子；
2. 直接在计算参数中修改盒子的起点或终点坐标来调整盒子位置和大小
设置参数
在结果显示栏中勾选想要显示的内容
点击
测试，查看图像窗口和参数是否符合预期没有问题后点击
保存，在运行列表中运行该算子，即可在对应的IM查看运行结果
