3D體積

運算元功能

計算給定區域中的點雲體積。提供了3種體積測量演算法，分別為根據包围盒計算體積、根據轮廓积分和切片积分計算體積。

引數介紹

輸入引數

引數	範圍	預設值	說明	圖示
輸入影像	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	啟用則以区域作為輸入，不啟用則以输入图像作為輸入
區域			設定體積計算區域
演算法	包圍盒/輪廓積分/切片積分	包圍盒	包围盒：根據包圍盒計算體積 轮廓积分：根據輸入的點雲輪廓，由每一個點的Z方向高度積分後計算體積。注意：該演算法要求輸入有序点云 切片积分：根據切片積分計算體積。(轮廓积分演算法要求輸入有序点云)
包圍盒型別	軸對齊包圍盒/旋轉包圍盒	軸對齊包圍盒	軸對齊包圍盒：包圍盒的邊界都平行或者垂直於任意一個座標軸。其引數為最小x、y、z坐标值和最大x、y、z坐标值。對於旋轉物體來說，貼合不緊密，冗餘空間較大。 旋轉包圍盒：能更好地貼合物體，引數為中心点坐标、长宽高、旋转欧拉角。
參考高度		0.000	當算法設定為包围盒時，需要設定參考平面的高度
切片輪廓數		1000	算法設定為切片积分時需要設定：需要進行切割的輪廓數量。數量越多則體積計算越精確，但數量的增大會加大計算量，使用時需調整。
切片方向	X/Y/Z	X	算法設定為切片积分時需要設定：切平面的法線方向。目前可以設定為X、Y和Z。切片的方向為X方向。

結果顯示

引數	範圍	預設值	說明	圖示
盒子	true/false	false	物體的包圍盒，若啟用，則在影像中顯示
點集	true/false	false	目標區域點集，若啟用，則在影像中顯示

輸出引數

名稱	型別	範圍	說明
Result	bool	true/false	true為成功 false為失敗
Warning	bool	true/false	true表示有警告 false表示沒有
Message	string		輸出成功或錯誤或警告資訊,如果沒有錯誤或警告為空
Time	float		運算元執行時間，單位: ms
volume_measurement	float		體積測量值
region	pointset		目標區域點集

異常排查

檢視錯誤碼列表瞭解通用的錯誤資訊及解決方案。

序號	異常資訊	對應引數	解決方法
1	輸入的值是{0}，無效的區域型別	區域型別	只支援window2d、box、pointset
2	區域為空		1. 檢查輸入點雲是否為空 2. 檢查ROI區域是否框選到點雲 3. 檢查繫結的pointset是否為空
3	此模式下僅支援有序點雲輸入		輪廓積分模式下只支援有序點雲
4	輪廓積分計算失敗		檢查輸入點雲是否為空
5	輸入x解析度是{0}，y解析度是{1}，無效的x方向或者y方向解析度	x解析度、y解析度	只支援x解析度>0，y解析度>0
6	輸入的值是{0}，無效的切片方向	切片方向	只支援切片方向X、Y
7	請增大x解析度或者y解析度的值		x解析度或者y解析度>=點雲點距
8	體積計算失敗		檢查切片輪廓數是否設定大於0

示例介紹

工程設計

1. 選擇2個加载3D点云工具，分別載入兩個點雲用於體積計算。
2. 選擇并行调用程序工具，分別使用切片体积算法和包围盒算法，計算兩個點雲的體積。
3. 在切片体积算法程式中，選擇3D区域运算、3D平面拟合和1個3D体积工具。其中3D区域运算和3D平面拟合工具用來將點雲調整至零平面，3D体积工具使用切片积分演算法計算體積。
4. 在包围盒算法程式中，選擇3D区域运算、3D平面拟合和2個3D体积工具。其中3D区域运算和3D平面拟合工具用來將點雲調整至零平面，2個3D体积工具分別用來計算轴对齐包围盒體積和旋转包围盒體積。

工具使用

1. 設定輸入影像的IM序號。

2. 設定引數。

3. 點選测试，檢視標定矩陣。

4. 沒有問題後點擊保存，在執行列表中執行該運算元，即可檢視執行結果。