3D圓柱擬合

運算元功能

對輸入的點雲進行圓柱擬合，獲取擬合所得的圓柱引數：上下底面圓心座標以及圓柱半徑（為在較短時間內取得較好的擬合數據，推薦點雲點數在1000-100000內）

引數介紹

輸入引數

引數	範圍	預設值	說明	圖示
輸入影像	0-8	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中心點位於圓內。 可以通过绑定选择已存在的ROI区域
統計濾波	true/false	false	對輸入點雲統計濾波
標準差倍數閾值	0.1-10	0.150	輸入引數n，則任何超過平均值n倍標準差的點都將被視為離群點並被移除
鄰域點數	3-500	100	濾波時需要考慮的鄰居點數量（該點數必須小於輸入點雲點數）
K近鄰數	3-500	20	計算點雲一點法線時，搜尋周圍點的個數，若設定的搜尋點數過大，會引入遠離當前點的其他點，導致估計不準確；若設定的值過小，會忽略掉一些鄰近的點，同樣將影響法線估計的準確性。
距離閾值	0-10000	0.15	當資料點與擬合模型之間的距離小於這個閾值時，該資料點被認為是內點（即符合模型的點），否則被認為是外點（即不符合模型的點）
最小點數		0	設定輸入點雲點數的最小值
最大點數		1000000	設定輸入點雲點數的最大值

注：如下圖所示，在空間座標系中，圓柱可由上、下地面圓心和半徑R確定

結果顯示

引數	範圍	預設值	說明	圖示
圓柱	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
cylinder	cylinder		輸出圓柱

提示

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

異常排查

序號	異常資訊	對應引數	解決方法
1	輸入的區域型別是{0}，無效區域型別	區域型別	區域輸入型別為2D視窗/2D圓形視窗/2D多邊形視窗/盒子/圓柱盒子/旋轉盒子/點集之一
2	區域為空		1. 檢查是否框選為空 2. 檢查點集是否為空
3	輸入點云為空		確認IM是否存在有效點，若無有效點，請載入點雲或切換存在有效點的IM
4	濾波引數非法		調整統計濾波引數
5	點數限制非法		設定點雲上限小於點雲上限
6	輸入點雲點數超出限制		調整點數限制範圍或更換符合限制的點雲
7	輸入的多邊形頂點個數小於3，無法形成多邊形		新增2d多邊形視窗頂點數，使得頂點數至少為三個

示例介紹

工程設計

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

2. 選擇3D圆工具。

工具使用

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

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

使用技巧

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

3. 設定引數

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

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

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