3D圓
運算元功能
在Roi中尋找邊緣點；根據尋找到的邊緣點，擬合出3D圓形。
引數介紹
輸入引數
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 輸入影像 | 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轴角度 |
計算引數
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 使用區域引數 | true/false | false | 啟用則以區域作為輸入，不啟用則以輸入影像作為輸入 | |
| 區域 | 2D視窗/盒子 | 盒子 | 手動框選合適的ROI區域 > 注意：請確保ROI中心點位於圓內。 可以通过绑定选择已存在的ROI区域输入数组时，输出的也是数组 | |
| 強制水平擬合 | true/false | false | 強制水平擬合是指在擬合平面或其他幾何形狀時，要求模型的法向量或主方向與水平面平行，通常用來確保模型在某些應用場景下是水平的。開啟後將會從紅色圓強制修正為藍色圓 |  |
| 查詢模式 | 錐形找點 | 錐形找點 | 錐形找點：使用錐形探針的方法尋找邊緣點，通過控制探針的角度來定位點雲中的邊緣 |  |
| 方向 | 由外向內找圓/由內向外找孔 | 由外向內找圓 | 由外向內找圓：從外向內找特徵點 由內向外找圓：從內向外找特徵點 | |
| 探針角度 | 45 | 控制探針的角度可以影響邊緣點的定義，通常選擇合適的角度範圍以確保可以檢測到真實的邊緣點 |  | |
| 擬合方法 | Ransac/最小二乘法 | Ransac | Ransac：用於從資料中擬合模型，尤其是在資料中存在噪聲或離群點時 最小二乘法：通過最小化誤差平方和來擬合模型，適用於誤差較小且資料點較為集中、邊緣點分佈均勻、噪聲較少的情況 | |
| 距離閾值 | 0.02 | 用於定義一個點與擬合模型的最遠距離，超過此距離的點被認為是外點，不參與擬合 |  | |
| 最大迭代次數 | 500 | 用於設定RANSAC演算法的最大迭代次數，通常迭代次數越多，擬合結果越精確，但計算開銷也會增大 |
提示
更多引數型別詳細說明，請參看型別定義
結果顯示
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| ROI點集 | true/false | false | 僅在使用区域参数選中時生效，ROI框選的區域點集，若啟用，則在影像中顯示 | |
| 邊緣點 | 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 | |
| edge_cloud_point | pointset | 3D圓的特徵點 输入数组时，输出的也是数组 | |
| circle | circle3d | 找到3D圓的座標和方向 输入数组时，输出的也是数组 | |
| Rradius Text | string | 半徑值 | |
| Center Point 3D | point3d | 找到3D圓中心點 |
異常排查
| 序號 | 異常資訊 | 對應引數 | 解決方法 |
|---|---|---|---|
| 1 | 輸入的值是{0}，無效的區域型別 | 區域型別 | 只支援window2d、box、pointset |
| 2 | Region點云為空 | 1. 檢查點云為空 2. 檢查ROI是否框選到點雲 3. 檢查繫結為空 | |
| 3 | 沒有找到平面 | 健壯性內容，基本不會出現 | |
| 4 | 沒有找到 | 調整擬合引數 |
示例介紹
工程設計
選擇
加载点云工具，載入需要處理的3d點雲圖到IM0。選擇
3D圆工具。
工具使用
選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致
選擇區域型別為盒子，將盒子移動到待測位置，包圍住待測點雲區域。
使用技巧
1. 通過影像視窗上的ROI控制器來拖動或縮放盒子；
2. 直接在計算引數中修改盒子的起點或終點座標來調整盒子位置和大小；
設定引數
在結果顯示欄中勾選想要顯示的內容
點選
测试，檢視影像視窗和引數是否符合預期沒有問題後點擊
保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果
