3D平面度

運算元功能

採用平均值做點的方式，每一個區域中計算出一個平均點，利用平均點擬合出評定基面。計算出峰基平面度偏差和基谷平面度偏差，最終的平面度=峰基平面度偏差-基谷平面度偏差。平面度越接近於0代表平面越平整。

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

引數介紹

輸入引數

引數	範圍	預設值	說明	圖示
輸入影像	0-31	0	影像輸入的IM編號
3D基準			可以通過繫結選擇基准
X			3D基準引數X座標值，可以通過繫結設定X
Y			3D基準引數Y座標值，可以通過繫結設定Y
Z			3D基準引數Z座標值，可以通過繫結設定Z
X軸角度	-10000000000.000-10000000000.000		3D基準引數X軸角度值，可以通過繫結設定X轴角度
Y軸角度	-10000000000.000-10000000000.000		3D基準引數Y軸角度值，可以通過繫結設定Y轴角度
Z軸角度	-10000000000.000-10000000000.000		3D基準引數Z軸角度值，可以通過繫結設定Z轴角度

計算引數

引數	範圍	預設值	說明	影像
區域選點	所有點/平均點	所有點	參見區域選點
區域數量		1	設定檢測區域的數量。其中，平均点模式，需要至少設定4个ROI區域且區域分佈不能共线分佈。
濾波方式	無/百分位數濾波	無	無：使用任何濾波方法 百分位數濾波：使用百分位數濾波方法對每一個區域中的點進行濾波，去除離群點。參見百分位數濾波

區域選點

當前提供兩種選點方式，分別為所有点和平均点模式。

引數	範圍	預設值	說明	影像
所有點			該模式下，ROI中的所有点都會參與平面度的計算。
平均點			該模式下，會計算出每個區域中所有點的平均点，然後將平均点納入計算中。

注意：平均值做點的平面度計算方式，一方面保留了區域中所有點的統計資訊，一定程度上可以抑制噪聲點的影響，使得計算結果更加穩定；另一方面，由於只採用了平均点進行運算，其在速度上也會更快。但若採用平均点模式，需要至少設定4个ROI區域且區域分佈不能共线分佈。

百分位數濾波模式

若啟用，將對每個區域中的點進行百分位數濾波

引數	範圍	預設值	說明	影像
低百分比			根據輸入的百分比計算z方向的低閾值，去除低於此閾值的所有點
高百分比			根據輸入的百分比計算z方向的高閾值，去除高於此閾值的所有點

結果顯示

引數	範圍	預設值	說明	圖示
高度	true/false	false	區域高度值，若啟用，則在影像中顯示
高度測量點	true/false	false	高度位置點，若啟用，則在影像中顯示
ROI點集	true/false	false	ROI框選的區域點集，若啟用，則在影像中顯示

輸出引數

名稱	型別	範圍	說明
Result	bool	true/false	true為成功 false為失敗
Warning	bool	true/false	true表示有警告 false表示沒有
Message	string		輸出成功或錯誤或警告資訊
Time	float		運算元執行時間，單位: ms
region_height	float[]		區域高度陣列
flatness_value	float		平面度值
distances	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檢視執行結果