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轴角度 |
計算引數
圓柱來源擬合
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 圓柱來源 | 擬合/輸入 | 擬合 | 擬合：框選需要擬合的點雲，對該部分點雲進行擬合和展開 輸入：從暫存器或手動獲取圓柱引數，對輸入影像進行展開 | |
| 區域 | 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 | 設定輸入點雲點數的最大值 | ||
| 目標平面 | XY平面/XZ平面/YZ平面 | XZ平面 | XY平面：將點雲展開到XY平面 XZ平面：將點雲展開到XZ平面 YZ平面：將點雲展開到YZ平面 | |
| 輸出影像 | 0-8 | 0 | 影像輸出的IM編號 |
圓柱來源輸入
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 圓柱來源 | 擬合/輸入 | 擬合 | 擬合：框選需要擬合的點雲，對該部分點雲進行擬合和展開 輸入：從暫存器或手動獲取圓柱引數，對輸入影像進行展開 | |
| 幾何 | 圓柱 | 設定圓柱資訊：底面圓心、半徑可以通过绑定选择拟合好的圆柱 | ||
| 目標平面 | XY平面/XZ平面/YZ平面 | XZ平面 | XY平面：將點雲展開到XY平面 XZ平面：將點雲展開到XZ平面 YZ平面：將點雲展開到YZ平面 | |
| 輸出影像 | 0-8 | 0 | 影像輸出的IM編號 |
輸出引數
| 名稱 | 型別 | 範圍 | 說明 |
|---|---|---|---|
| Result | bool | true/false | true為成功 false為失敗 |
| Warning | bool | true/false | true表示有警告 false表示沒有 |
| Message | string | 輸出成功或錯誤或警告資訊,如果沒有錯誤或警告為空 | |
| Time | float | 運算元執行時間，單位: ms |
異常排查
| 序號 | 異常資訊 | 對應引數 | 解決方法 |
|---|---|---|---|
| 1 | 輸入的區域型別是{0}，無效區域型別 | 區域型別 | 區域輸入型別為2D視窗/2D圓形視窗/2D多邊形視窗/盒子/圓柱盒子/旋轉盒子/點集之一 |
| 2 | 區域為空 | 1. 檢查是否框選為空 2. 檢查點集是否為空 | |
| 3 | 點雲輸入為空 | 確認IM是否存在有效點，若無有效點，請載入點雲或切換存在有效點的IM | |
| 4 | 點數限制非法 | 設定點雲上限小於點雲上限 | |
| 5 | 濾波引數非法 | 調整統計濾波引數： 1. 加大標準差倍數閾值 2. 減小鄰域點數（鄰域點數需小於框選點雲點數） | |
| 6 | 輸入點雲點數超出限制 | 調整點數限制範圍或更換符合限制的點雲 | |
| 7 | 輸入的幾何是{0}，無效幾何型別 | 幾何型別 | 幾何選擇為圓柱 |
| 8 | 輸入的圓柱來源是{0}，無效的圓柱來源 | 圓柱來源 | 影像來源選擇為擬合/輸入 |
| 9 | 輸入的多邊形頂點個數小於3，無法形成多邊形 | 新增2d多邊形視窗頂點數，使得頂點數至少為三個 |
示例介紹
工程設計
選擇
加载点云工具，載入需要處理的3d點雲圖到IM0。選擇
3D裁切工具複製IM0到IM1。設定
3D圆柱工具，擬合點云為圓柱面。選擇兩個
3D展开工具，分別設定不同的圓柱來源。
工具使用
選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致
設定圓柱來源
設定圓柱來源為擬合時設定區域為盒子，將盒子移動到待測位置，包圍住待測點雲。
設定圓柱來源為輸入時繫結3D圆柱工具輸出的圓柱面作為輸入。
使用技巧
1. 通過影像視窗上的ROI控制器來拖動或縮放盒子；
2. 直接在計算引數中修改盒子的起點或終點座標來調整盒子位置和大小；
設定引數
點選
测试，檢視影像視窗和引數是否符合預期沒有問題後點擊
保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果
