moments_object_model_3dT_moments_object_model_3dMomentsObjectModel3dMomentsObjectModel3dmoments_object_model_3d (Operator)
Name
moments_object_model_3dT_moments_object_model_3dMomentsObjectModel3dMomentsObjectModel3dmoments_object_model_3d
— Calculates the mean or the central moment of second order for a 3D object
model.
Signature
Description
moments_object_model_3dmoments_object_model_3dMomentsObjectModel3dMomentsObjectModel3dmoments_object_model_3d
calculates the mean or
the central moment of second order for a 3D object model.
To calculate the mean of the points of the 3D object model,
select 'mean_points'"mean_points""mean_points""mean_points""mean_points"
in MomentsToCalculateMomentsToCalculateMomentsToCalculatemomentsToCalculatemoments_to_calculate
. If instead the central moment
of second order should be calculated, select
'central_moment_2_points'"central_moment_2_points""central_moment_2_points""central_moment_2_points""central_moment_2_points". The results are the variances
of the x, y, z, x-y, x-z, and y-z axes.
To compute the three principal axes of the 3D object model
select 'principal_axes'"principal_axes""principal_axes""principal_axes""principal_axes" in MomentsToCalculateMomentsToCalculateMomentsToCalculatemomentsToCalculatemoments_to_calculate
.
The result is a pose with the mean of the points as center. The
coordinate system that corresponds to the pose has the
x-axis along the first principal axis, the y-axis along the second
principal axis and the z-axis along the third principal axis.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ObjectModel3DObjectModel3DObjectModel3DobjectModel3Dobject_model_3d
(input_control) object_model_3d(-array) →
HObjectModel3D, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the 3D object model.
MomentsToCalculateMomentsToCalculateMomentsToCalculatemomentsToCalculatemoments_to_calculate
(input_control) number(-array) →
HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Moment to calculate.
Default:
'mean_points'
"mean_points"
"mean_points"
"mean_points"
"mean_points"
List of values:
'central_moment_2_points'"central_moment_2_points""central_moment_2_points""central_moment_2_points""central_moment_2_points", 'mean_points'"mean_points""mean_points""mean_points""mean_points", 'principal_axes'"principal_axes""principal_axes""principal_axes""principal_axes"
MomentsMomentsMomentsmomentsmoments
(output_control) number(-array) →
HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Calculated moment.
Number of elements:
Moments == ObjectModel3D
Example (HDevelop)
gen_object_model_3d_from_points (rand(200), rand(200),\
rand(200), ObjectModel3D)
moments_object_model_3d (ObjectModel3D, ['mean_points',\
'central_moment_2_points','principal_axes'], \
Moments)
Result
moments_object_model_3dmoments_object_model_3dMomentsObjectModel3dMomentsObjectModel3dmoments_object_model_3d
returns 2 (
H_MSG_TRUE)
if all parameters
are correct. If necessary, an exception is raised.
Possible Predecessors
read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dread_object_model_3d
,
connection_object_model_3dconnection_object_model_3dConnectionObjectModel3dConnectionObjectModel3dconnection_object_model_3d
Possible Successors
project_object_model_3dproject_object_model_3dProjectObjectModel3dProjectObjectModel3dproject_object_model_3d
,
object_model_3d_to_xyzobject_model_3d_to_xyzObjectModel3dToXyzObjectModel3dToXyzobject_model_3d_to_xyz
,
select_object_model_3dselect_object_model_3dSelectObjectModel3dSelectObjectModel3dselect_object_model_3d
See also
volume_object_model_3d_relative_to_planevolume_object_model_3d_relative_to_planeVolumeObjectModel3dRelativeToPlaneVolumeObjectModel3dRelativeToPlanevolume_object_model_3d_relative_to_plane
Module
3D Metrology