3D共面度

運算元功能

對輸入的點雲圖，例如BGA焊锡球，進行共面度測量。輸出的共面度為所有点高度的标准差。

引數介紹

輸入引數

引數	範圍	預設值	說明	圖示
輸入影像	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轴角度

計算引數

引數	範圍	預設值	說明	圖示
區域			可以手动選擇需要計算共面度的區域 可以通过绑定选择已存在的ROI区域
3D斑點引數			參見3D斑點引數
輸出影像	0-8	0	影像輸出的IM編號

3D斑點引數

在進行共面度計算之前會進行3D斑點的提取，這些引數有助於進行斑點的正確獲取。

引數	範圍	預設值	說明	圖示
最大輸出斑點個數		1	至多可以輸出的斑點數量
最大距離閾值		0.500	區分兩個不同斑點間的距離閾值。若相邻斑点间的距离较小，尝试调小该值。
斑點包含最少點數		1	每一個斑點中需要包含的最少点数，可以對斑點進行過濾。
斑點包含最多點數		100000000	每一個斑點中需要包含的最多点数，可以對斑點進行過濾。
排序方式	+X/-X/+Y/-Y/+Z/-Z	-X	將找到的斑點按照指定的规则進行排序： - 不排序：隨機輸出 - 點數：根據每一個斑點中包含的點數對斑點進行排序 - X：根據每一個斑點的質心X座標，對斑點進行排序 - Y：根據每一個斑點的質心Y座標，對斑點進行排序 - Z：根據每一個斑點的質心Z座標，對斑點進行排序

結果顯示

引數	範圍	預設值	說明	圖示
序號	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
coplanarity_value	float		共面度值

異常排查

序號	異常資訊	對應引數	解決方法
1	輸入的值是{0}，無效的區域型別	區域型別	只支援window2d、box、pointset
2	區域為空		1.檢查輸入點是否為空 2.檢查ROI區域是否框選到點雲 3.檢查繫結的pointset是否為空
3	輸入的值為{0}，無效的排序方式	排序方式	只支援+X、-X、+Y、-Y
4	斑點查詢失敗		檢查斑點引數中的距離閾值是否設定過小

示例介紹

工程設計

1. 選擇加载3D点云工具，載入需要處理的3d點雲圖到IM0。

2. 選擇3D共面度工具。

工具使用

1. 選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致

2. 選擇區域型別為盒子，將盒子移動到待測位置，包圍住待測點雲

使用技巧

1. 通過影像視窗上的ROI控制器來拖動或縮放盒子；
2. 直接在計算引數中修改盒子的起點或終點座標來調整盒子位置和大小；

3. 設定引數

4. 在結果顯示欄中勾選想要顯示的內容

5. 點選测试，檢視影像視窗和引數是否符合預期

6. 沒有問題後點擊保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果