3D平面度

算子功能

采用平均值做点的方式，每一个区域中计算出一个平均点，利用平均点拟合出评定基面。计算出峰基平面度偏差和基谷平面度偏差，最终的平面度=峰基平面度偏差-基谷平面度偏差

参考：ISO 12781-1:2011(en) Geometrical product specifications (GPS) — Flatness — Part 1: Vocabulary and parameters of flatness

参数介绍

输入参数

参数	范围	默认值	说明	图示
输入图像	0-8	0	图像输入的IM编号

计算参数

参数	范围	默认值	说明	图像
区域选点	所有点/平均点	所有点	参见区域选点
区域数量		1	设置检测区域的数量。其中，平均点模式，需要至少设定4个ROI区域且区域分布不能共线分布。
滤波方式	无/百分位数滤波	无	无：使用任何滤波方法 百分位数滤波：使用百分位数滤波方法对每一个区域中的点进行滤波，去除离群点。参见百分位数滤波

区域选点

当前提供两种选点方式，分别为所有点和平均点模式。

参数	范围	默认值	说明	图像
所有点			该模式下，ROI中的所有点都会参与平面度的计算。
平均点			该模式下，会计算出每个区域中所有点的平均点，然后将平均点纳入计算中。

注意：平均值做点的平面度计算方式，一方面保留了区域中所有点的统计信息，一定程度上可以抑制噪声点的影响，使得计算结果更加稳定；另一方面，由于只采用了平均点进行运算，其在速度上也会更快。但若采用平均点模式，需要至少设定4个ROI区域且区域分布不能共线分布。

百分位数滤波模式

若启用，将对每个区域中的点进行百分位数滤波

参数	范围	默认值	说明	图像
低百分比			根据输入的百分比计算z方向的低阈值，去除低于此阈值的所有点
高百分比			根据输入的百分比计算z方向的高阈值，去除高于此阈值的所有点

结果显示

参数	范围	默认值	说明	图示
高度	true/false	false	区域高度值，若启用，则在图像中显示

输出参数

名称	类型	范围	说明
Result	bool	true/false	true为成功 false为失败
Warning	bool	true/false	true表示有警告 false表示没有
Message	string		输出成功或错误或警告信息
Time	float		算子执行时间，单位: ms
region_height	float[]		区域高度数组
flatness_value	float		平面度值

异常排查

序号	异常信息	对应参数	解决方法
1	高低百分比不能都是50.0		调整高低百分比，不能同时为50
2	输入的值是{0}，无效的高度统计方式	高度模式	只支持Minimum、Maximum、Mean、Median
3	全局平面度测试失败		1. 检查输入点云是否为空 2. 检查高低百分比是否都大于0且小于50
4	此模式下需要设置至少4个区域		选择至少4个不同区域，区域的中心点不要在一条直线上
6	输入的值为{0}，无效的区域选点方式	区域选点	只支持All Points、Single Average Point

示例介绍

工程设计

1. 选择3D加载点云工具。
2. 选择2个调用程序工具，分别进行位置调整和平面拟合。
3. 选择2个3D平面度工具，分别使用平均点模式和所有点模式。

工具使用

1. 选择输入图像的IM序号。

2. 设置参数。

3. 点击测试，查看图像窗口和参数是否符合预期。

4. 没有问题后点击保存，在运行列表中运行该算子，即可在对应的IM查看运行结果