3D斑點
運算元功能
在輸入的點雲區域中尋找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視窗/盒子 | 盒子 | 手動框選合適的ROI區域可以通过绑定选择已存在的ROI区域 | |
| 演算法 | 歐式聚類 | 歐式聚類 | 歐式聚類 | |
| 最大距離閾值 | 0.500 | 區分兩個不同斑點間的距離閾值。若相邻斑点间的距离较小，尝试调小该值。 |  | |
| 斑點包含最少點數 | 1.000 | 每一個斑點中需要包含的最少點數，可以對斑點進行過濾。 | ||
| 斑點包含最多點數 | 100000000.000 | 每一個斑點中需要包含的最多點數，可以對斑點進行過濾。 | ||
| 排序方式 | 不排序/點數/X/Y/Z | 不排序 | 點數：根據每一個斑點中包含的點數對斑點進行排序 X：根據每一個斑點的質心X座標，對斑點進行排序。 Y：根據每一個斑點的質心Y座標，對斑點進行排序。 Z：根據每一個斑點的質心Z座標，對斑點進行排序。 |  |
| 排序方向 | 降序/升序 | 升序 | ||
| 最大輸出斑點個數 | 5 | 限制輸出斑點的最多數量 | ||
| 偏移 | 0.0-10000.0 | 1.0 | 輔助排序的引數，判斷斑點是否要劃分到同一序列 |  |
結果顯示
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 點集 | true/false | false | 目標點集，若啟用，則在影像中顯示 | |
| 中心點 | true/false | false | 斑點中心，若啟用，則在影像中顯示 | |
| 序號 | 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 | |
| blob_num | float | 找到的斑點個數 | |
| blobs | pointset[] | 找到的斑點點集。可用于其他算子的区域绑定 | |
| blob_center_points | point3d[] | 找到的斑點中心座標 |
提示
更多引數型別詳細說明，請參看型別定義
異常排查
| 序號 | 異常資訊 | 對應引數 | 解決方法 |
|---|---|---|---|
| 1 | 輸入的值是{0}，無效區域型別 | 區域型別 | 只支援window2d、box、pointset |
| 2 | 輸入的值是{0}，無效的斑點輸出最大... | 當前斑點數量（等於0...） | 輸入的斑點數量>=0 |
| 3 | 輸入的值是{0}，無效的排序方式 | 排序方式 | 只支援no sorting、point count、X、Y、Z這些排序方式 |
| 4 | 輸入的值是{0}，無效的排序方向 | 排序方向 | 只支援descending、ascending |
| 5 | 歐式聚類失敗 | 檢查斑點引數，是否有小於0的引數 | |
| 6 | 檢測斑點失敗 | 檢查斑點引數中的距離閾值引數，是否設定過小 | |
| 7 | 輸入的值是{0}，無效的斑點查詢演算法 | 斑點查詢演算法 | 只支援Euclidean cluster |
示例介紹
工程設計
選擇
加载3D点云工具，載入需要處理的3d點雲圖到IM0。選擇
3D斑点工具。
工具使用
選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致
選擇區域型別為盒子，將盒子移動到待測位置，包圍住待測點雲
使用技巧
1. 通過影像視窗上的ROI控制器來拖動或縮放盒子；
2. 直接在計算引數中修改盒子的起點或終點座標來調整盒子位置和大小；
設定引數
在結果顯示欄中勾選想要顯示的內容
點選
测试，檢視影像視窗和引數是否符合預期沒有問題後點擊
保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果
