3D共面度-座面法

運算元功能

使用座面法，計算共面性偏差

原理說明：

1. 提取各個端子點雲的最高點
2. 確定三個表現出最大垂直距離的端子頂點（定義座面的端子三角形必須包含重心的投影，以構成有效的座面。如果平面不被認為是有效的，則下一個具有最大垂直距離的端子將被視為候選端子，用於形成有效的座面）
   
3. 三個頂底計算出座面
4. 共面性偏差需要求座面到每個端子頂點的距離，其中，最大測量值是共面性偏差：
   

引數介紹

輸入引數

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

計算引數

引數	範圍	預設值	說明	圖示
區域	2D視窗/2D圓形視窗/2D多邊形視窗/盒子/圓柱盒子/旋轉盒子/點集(僅繫結)	盒子	手動框選合適的ROI區域 可以通过绑定选择已存在的ROI区域
端子設定			設定分割端子的引數
端子最小間隔	0.0-1000000.0	0.1	區分不同端子的最小間距
端子最少點數	1-1000000	100	限制端子點雲的最小點數
端子最大點數	1-1000000	10000	限制端子點雲的最大點數

結果顯示

引數	範圍	預設值	說明	圖示
頂點	true/false	false	輸入各個點雲的最高點，若啟用，則在影像中顯示
中心	true/false	false	所有端子點雲的質心，若啟用，則在影像中顯示
座面	true/false	false	三個符合要求的端子頂點形成的平面，若啟用，則在影像中顯示
共面性偏差	true/false	false	計算出的共面度值，若啟用，則在影像中顯示
頂點三角形	true/false	false	三個符合要求的端子頂點形成的三角形

輸出引數

名稱	型別	範圍	說明
Result	bool	true/false	true為成功，false為失敗
Warning	bool	true/false	true表示有警告，false表示沒有
Message	string		輸出成功、錯誤或警告資訊，如果沒有錯誤或警告則為空
Time	float		運算元執行時間，單位:ms
coplanarity_deviation	float		共面度

提示

更多引數型別詳細說明，請參看型別定義

異常排查

序號	異常資訊	對應引數	解決方法
1	輸入點云為空		確認IM是否存在有效點，若無有效點，請載入點雲或切換存在有效點的IM
2	輸入的區域型別是{0}，無效區域型別	區域型別	區域輸入型別為2D視窗/2D圓形視窗/盒子/圓柱盒子/旋轉盒子/點集之一
3	區域為空		檢查輸入的ROI是否選中至少4個點雲
4	檢測到的端子個數為{0}，至少需要4個端子	區域個數	檢查輸入的點雲或端子設定引數：端子點數限制或端子最小間距
5	輸入的多邊形頂點個數小於3，無法形成多邊形		新增2d多邊形視窗頂點數，使得頂點數至少為三個
6	沒有一組端子頂點符合要求		-
7	輸入的端子點數限制無效		設定端子點數的上限大於等於下限

示例介紹

工程設計

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

2. 選擇3D共面度-座面法工具，設定不同輸出型別。

工具使用

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

2. 繫結需要測量的點雲陣列

3. 設定引數

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

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

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