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轴角度 |
計算引數
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 實際位置 | 3D圓 | - | 實際的擬合3D圓 | |
| 理論位置 | json檔案 | - | 被測平面上的測量點檔案 | |
| 貼合點雲 | true/false | false | 將理論位置點平移到最貼合區域框選點雲的位置，使得測量值最小，參見貼合設定 | |
| 使用區域引數 | true/false | false | 啟用則以区域作為輸入，不啟用則以输入图像作為輸入 | |
| 區域 | 2D視窗/2D圓形視窗/2D多邊形視窗/盒子/圓柱盒子/旋轉盒子/點集 | 盒子 | 手動框選合適的ROI區域可以通过绑定选择已存在的ROI区域 | |
| 擬合方法 | 最小二乘法/RANSAC | 最小二乘法 | 選擇擬合圓的方法 | |
| 距離閾值 | 0.0-50.0 | 0.02 | 選擇合適的距離閾值，當噪點多時，調大該引數，當噪點少則調小該引數 | |
| 最大迭代次數 | 100-10000 | 500 | 設定迭代次數的最大值 |
貼合設定
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 迭代次數 | 1-2000 | 500 | 迭代時最大計算次數 | |
| 誤差期望 | 0.00001-1000000 | 0.00001 | 點到圓的距離誤差之和，當到達誤差期望值時，迭代停止 | |
| 步長 | 0.00001-1000000 | 0.00001 | 迭代時每次點移動的長度 |
結果顯示
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 實際平面 | true/false | false | 輸入的實際平面，若啟用，則顯示在IM上 | |
| 基準線 | true/false | false | 輸入的基準線，若啟用，則顯示在IM上 | |
| 交點 | true/false | false | 顯示兩組點：輸入的測量點和測量點到實際平面的垂足，若啟用，則顯示在IM上 | |
| 測量點與貼合基準面交點連線 | true/false | false | 輸入的測量點到實際平面的垂足連線，若啟用，則顯示在IM上 | |
| 平行度 | true/false | false | 輸出的平行度，若啟用，則顯示在IM上 | |
| result | string | OK/NG | 平行度是否在範圍內 |
輸出引數
| 名稱 | 型別 | 範圍 | 說明 |
|---|---|---|---|
| Result | bool | true/false | true為成功 false為失敗 |
| Warning | bool | true/false | true表示有警告 false表示沒有 |
| Message | string | 輸出成功或錯誤或警告資訊,如果沒有錯誤或警告為空 | |
| Time | float | 運算元執行時間，單位: ms | |
| positional_degree | float | 位置度 |
提示
更多引數型別詳細說明，請參看型別定義
異常排查
| 序號 | 異常資訊 | 對應引數 | 解決方法 |
|---|---|---|---|
| 1 | 輸入點雲的點數小於3 | 確認IM是否存在至少三個有效點，若少於3個有效點，請載入點雲或切換存在至少3個有效點的IM | |
| 2 | 輸入的實際位置圓型別為{0}，無效的型別 | 實際位置型別 | 檢查平面型別是否為3D圓 |
| 3 | 引數 {0} 不能為空 | 路徑 | 檢查路徑是否為空 |
| 4 | 檔案 {0} 不存在或無法訪問 | 路徑 | 檢查路徑是否有效 |
| 5 | 輸入的理論位置點云為空 | 檢查理論位置點json檔案是否為空 | |
| 6 | 輸入垂直度範圍的最小值大於最大值，無效的垂直度範圍 | 設定垂直度範圍最小值小於等於最大值 | |
| 7 | 輸入的擬合方式為{0}，無效的擬合方式 | 擬合方式 | 輸入擬合方式為最小二乘法/RANSAC |
| 8 | RANSAC擬合圓失敗 | 調整RANSAC引數：距離閾值 | |
| 9 | 輸入的區域型別是{0}，無效區域型別 | 區域型別 | 檢查區域型別是否為2D視窗/2D圓形視窗/2D多邊形視窗/盒子/圓柱盒子/旋轉盒子/點集其中之一 |
| 10 | 輸入的多邊形頂點個數小於3，無法形成多邊形 | 新增2d多邊形視窗頂點數，使得頂點數至少為3 | |
| 11 | 輸入的區域點云為空 | 1. 檢查是否框選為空 2. 檢查點集是否為空 |
示例介紹
工程設計
選擇
加载点云工具，載入需要處理的3d點雲圖到IM0；選擇
3D圆工具，擬合3D圓。選擇
3D点位置度工具。
工具使用
選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致
不啟用使用區域引數或啟用區域並選擇區域型別為盒子，將盒子移動到待測位置，包圍住待測點雲
使用技巧
1. 通過影像視窗上的ROI控制器來拖動或縮放盒子；
2. 直接在計算引數中修改盒子的起點或終點座標來調整盒子位置和大小
設定引數
在結果顯示欄中勾選想要顯示的內容
點選
测试，檢視影像視窗和引數是否符合預期沒有問題後點擊
保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果
