volume_object_model_3d_relative_to_plane — Calculate the volume of a 3D object model relative to a plane.
volume_object_model_3d_relative_to_plane calculates the volume of a 3D object model relative to a plane. For the 3D object model a triangulation or a list of polygons must be available.
The plane in Plane must be given as a pose. The x-y plane of the pose specifies the plane.
If a face of the object is located above the plane and the orientation of the face is towards the plane or inverse, its volume is considered positive, otherwise its volume is considered negative. If the volume should be restricted in relation to the plane, the parameter Mode allows to choose either only volumes above the plane (with 'positive') or below the plane (with 'negative'). Alternatively, both sides can be considered either 'unsigned', which will add up all volumes below and above the plane, or 'signed', which will subtract the volumes below from the volumes above. UseFaceOrientation specifies if the order of the points in the faces should be considered for estimating the sign of the volume.
If the 3D object model is completely closed and ordered, the real volume will be measured with the default settings. The plane is still required, but should not change the resulting volume.
The calculation of the volume might be numerically unstable in case of a large distance between the plane and the object (approx. distance > 10000 times the object diameter).
Handle of the 3D object model.
Pose of the plane.
Default value: [0,0,0,0,0,0,0]
Method to combine volumes laying above and below the reference plane.
Default value: 'signed'
List of values: 'negative', 'positive', 'signed', 'unsigned'
Decides whether the orientation of a face should affect the resulting sign of the underlying volume.
Default value: 'true'
List of values: 'false', 'true'
Number of elements: Volume == ObjectModel3D
gen_box_object_model_3d ([0,0,0,0,0,0,0],3,2,1, ObjectModel3D) convex_hull_object_model_3d (ObjectModel3D, ObjectModel3DConvexHull) volume_object_model_3d_relative_to_plane (ObjectModel3DConvexHull,\ [0,0,0,0,0,0,0], 'signed',\ 'true', Volume)
volume_object_model_3d_relative_to_plane returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.
read_object_model_3d, xyz_to_object_model_3d, select_points_object_model_3d