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区域 | |
| 方向 | +X/-X/+Y/-Y/+Z/ -Z/選擇所有點 | 選擇所有點 | 選擇搜尋方向 +X:沿著X軸正方向搜尋 -X:沿著X軸負方向搜尋 +Y:沿著Y軸正方向搜尋 -Y:沿著Y軸負方向搜尋 +Z:沿著Z軸正方向搜尋 -Z:沿著Z軸負方向搜尋 選擇所有點:選擇ROI內所有點 |  |
| 排除錐角 | 45.000 | 沿著選定方向搜尋時的圓錐角度，圓錐以外的點將會被保留 |  | |
| 解析度 | 1000 | 沿著選定方向搜尋時的步長倒數，增大解析度意味著取樣點個數的增加，但同時會增加運算元的執行時間。 |  | |
| 僅搜尋前景 | 是否只搜尋前景邊緣點，若勾選，則需要手動設定z方向閾值，以此來分離前景和背景。 |  | ||
| 輸出幾何 | 點/直線/平面/線段 | 線 | 點：點雲區域的質心座標點 直線：包含直線段的中心點和直線的方向向量 平面：包含平面的幾何中心點和平面的法向量 線段：包含線段的兩個端點座標 | |
| 濾波方式 | 無濾波/統計濾波/RANSAC濾波 | 無濾波 | 參見濾波方式 |
結果顯示
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 點集 | true/false | false | 目標點集，若啟用，則在影像中顯示 | |
| 點 | true/false | false | 工具找到的點，若啟用，則在影像中顯示 | |
| 線 | true/false | false | 工具找到的線，若啟用，則在影像中顯示 | |
| 平面 | true/false | false | 工具找到的面，若啟用，則在影像中顯示 | |
| ROI點集 | true/false | false | ROI框選的區域點集，若啟用，則在影像中顯示 | |
| 線段 | true/false | false | 工具找到的線段，若啟用，則在影像中顯示 | |
| 線段中心點 | true/false | false | 工具找到的線段中點，若啟用，則在影像中顯示 |
輸出引數
| 名稱 | 型別 | 範圍 | 說明 |
|---|---|---|---|
| Result | bool | true/false | true為成功 false為失敗 |
| Warning | bool | true/false | true表示有警告 false表示沒有 |
| Message | string | 輸出成功或錯誤或警告資訊,如果沒有錯誤或警告為空 | |
| Time | float | 運算元執行時間，單位:ms | |
| region | pointset | 點集區域 | |
| middle_point | point3d | 中點座標 | |
| Line | line3d | 直線資訊 | |
| plane | plane | 平面資訊 | |
| Segment | segment3d | 線段資訊 | |
| Segment Center | point3d | 線段中點資訊 |
濾波方式
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 無濾波 | 不進行找到的邊緣點進行濾波 | |||
| 統計濾波 | 該濾波方式先對找到的邊緣點進行一次最佳擬合，接著利用標準差乘積因子，計算得到距離閾值。計算所有邊緣點到擬合模型的距離，若該距離大於距離閾值，則被認為是離群點。 標準差乘積：推薦值範圍 [1.0, 2.0] | |||
| RANSAC | 該濾波方式分為假設和檢驗兩個步驟。假設流程即從點集中任取n個點進行幾何模型擬合；檢驗流程即利用剩下的點集計算其到該幾何模型的距離，小於距離閾值的點被稱為局內點，若局內點的個數滿足閾值，則此次假設流程得出的幾何模型為最佳模型，停止迭代。 距離閾值：若某一點到輸出幾何的距離大於此閾值，將會被濾除。 迭代次數：超過此迭代次數，演算法將停止迭代。 |
異常排查
| 序號 | 異常資訊 | 對應引數 | 解決方法 |
|---|---|---|---|
| 1 | 輸入的值是{0}，無效的區域型別 | 區域型別 | 只支援window2d、box、pointset |
| 2 | 區域為空 | 1.檢查輸入點雲是否為空 2.檢查ROI區域是否框選到點雲 3.檢查繫結的pointset是否為空 | |
| 3 | 輸入的值為{0}，無效的搜尋方向 | 搜尋方向 | 只支援+X、-X、+Y、-Y、+Z、-Z、no probing |
| 4 | 搜尋邊緣點失敗 | 1.檢查搜尋方向是否正確 2.檢查解析度是否為負數，若為負數，需要更改為正數 | |
| 5 | 輸入的值為{0}，無效的濾波方式 | 濾波方式 | 只支援No dispersion filter、Statistical outlier removal、RANSAC |
| 6 | 輸入的值為{0}，無效的輸出幾何型別 | 幾何型別 | 只支援Point、Line、Plane、Segment 3D |
示例介紹
工程設計
選擇
加载3D点云工具，載入需要處理的3d點雲圖到IM0。選擇
3D点云裁切工具，分別複製IM0到IM1、IM2、IM3用於不同的操作選擇
3D方形探针工具。
工具使用
選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致
選擇區域型別為盒子，將盒子移動到待測位置，包圍住待測點雲
使用技巧
1. 通過影像視窗上的ROI控制器來拖動或縮放盒子；
2. 直接在計算引數中修改盒子的起點或終點座標來調整盒子位置和大小；
- 設定引數
選擇多個3D方形探针工具，設定輸出幾何為點和線時分別設定搜尋方向為+X+Y-X-Y，設定輸出幾何為面時設定選擇不同區域。
在結果顯示欄中勾選想要顯示的內容
點選
测试，檢視影像視窗和引數是否符合預期沒有問題後點擊
保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果
