3D表面積

運算元功能

輸入物體表麵點雲，計算表面點雲的表面積，輸出計算結果。

引數介紹

輸入引數

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

計算引數

引數	範圍	預設值	說明	圖示
使用區域引數	true/false	false	啟用則以区域作為輸入，不啟用則以输入图像作為輸入
區域	2D視窗/2D圓形視窗/2D多邊形視窗/盒子/圓柱盒子/旋轉盒子/點集(僅繫結)	盒子	手動框選合適的ROI區域 可以通过绑定选择已存在的ROI区域
搜尋半徑	0-200	2.500	設定用於確定k最近鄰域的球體半徑 根據點雲的密度和分佈，這個值可能需要調整。例如，對於較稀疏的點雲，可能需要設定較大的搜尋半徑
鄰域數量	1-100	50	設定對焊點點雲法向量估計的最大鄰域數量 較大的值可能會提高法向量估計的魯棒性，特別是在點雲稀疏或不規則的情況下。然而，過大的值也可能增加計算負擔，並可能引入不必要的噪聲。較小的值則可能提高計算效率，但在某些情況下可能導致法向量估計不夠準確
最近鄰域距離乘積係數	0-50	2.500	動態調整每個樣本點的最大搜索距離，該值越大，最終樣本點的最大搜索距離越大。 當設定為較大的值時，搜尋半徑會增大，這意味著演算法會考慮更多的鄰近點來構建三角形，這可能在點雲較稀疏的區域是有益的。然而，如果設定得過大，可能會導致過度連線，產生不準確的三角形。 當設定為較小的值時，搜尋半徑會減小，演算法會考慮較少的鄰近點。這可能在點雲較密集的區域或需要更精細的重構時是有益的。但是，如果設定得過小，可能會導致漏掉一些應該連線的點，從而產生不完整的三角網格。

結果顯示

引數	範圍	預設值	說明	圖示
表面積	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
surface_area	float		表面積的值
注：当输入为数组时，所有数组测量得到的表面积将组成一个数组

提示

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

異常排查

序號	異常資訊	對應引數	解決方法
1	輸入點云為空		確認IM是否存在有效點，若無有效點，請載入點雲或切換存在有效點的IM
2	輸入的區域型別是{0}，無效區域型別	區域型別	區域輸入型別為2D視窗/2D圓形視窗/2D多邊形視窗/盒子/圓柱盒子/旋轉盒子/點集之一
3	{0}個區域為空	區域數量	1.檢查每個區域，是否存在框選為空的情況 2.檢查每個點集，是否存在空點集
4	當前引數計算表面積失敗		調整表面重建引數： 1.搜尋半徑 2.最大鄰域數量 3.最近鄰域距離乘積係數
5	輸出面積值過大		建議分段計算表面積
6	輸入的多邊形頂點個數小於3，無法形成多邊形		新增2d多邊形視窗頂點數，使得頂點數至少為三個

示例介紹

工程設計

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

2. 選擇3D表面积工具。

工具使用

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

2. 不啟用使用區域引數或啟用區域並選擇區域型別為盒子，將盒子移動到待測位置，包圍住待測點雲

使用技巧

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

3. 設定引數

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

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

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