Skip to content

moments_object_model_3dmoments_object_model_3dMomentsObjectModel3dMomentsObjectModel3dmoments_object_model_3dT_moments_object_model_3d🔗

Short description🔗

moments_object_model_3dmoments_object_model_3dMomentsObjectModel3dMomentsObjectModel3dmoments_object_model_3dT_moments_object_model_3d — Calculates the mean or the central moment of second order for a 3D object model.

Signature🔗

moments_object_model_3d( object_model_3d ObjectModel3D, number MomentsToCalculate, out number Moments )moments_object_model_3d( : : ObjectModel3D, MomentsToCalculate : Moments )void MomentsObjectModel3d( const HTuple& ObjectModel3D, const HTuple& MomentsToCalculate, HTuple* Moments )static void HOperatorSet.MomentsObjectModel3d( HTuple objectModel3D, HTuple momentsToCalculate, out HTuple moments )def moments_object_model_3d( object_model_3d: MaybeSequence[HHandle], moments_to_calculate: MaybeSequence[str] ) -> Sequence[float]

def moments_object_model_3d_s( object_model_3d: MaybeSequence[HHandle], moments_to_calculate: MaybeSequence[str] ) -> floatHerror T_moments_object_model_3d( const Htuple ObjectModel3D, const Htuple MomentsToCalculate, Htuple* Moments )

static HTuple HObjectModel3D::MomentsObjectModel3d( const HObjectModel3DArray& ObjectModel3D, const HTuple& MomentsToCalculate )

double HObjectModel3D::MomentsObjectModel3d( const HString& MomentsToCalculate ) const

double HObjectModel3D::MomentsObjectModel3d( const char* MomentsToCalculate ) const

double HObjectModel3D::MomentsObjectModel3d( const wchar_t* MomentsToCalculate ) const (Windows only)

static HTuple HObjectModel3D.MomentsObjectModel3d( HObjectModel3D[] objectModel3D, HTuple momentsToCalculate )

double HObjectModel3D.MomentsObjectModel3d( string momentsToCalculate )

Description🔗

moments_object_model_3dMomentsObjectModel3d 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" in MomentsToCalculatemomentsToCalculatemoments_to_calculate. If instead the central moment of second order should be calculated, select '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" in MomentsToCalculatemomentsToCalculatemoments_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🔗

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🔗

ObjectModel3DobjectModel3Dobject_model_3d (input_control) object_model_3d(-array) → (handle)(handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)MaybeSequence[HHandle]Htuple (handle)

Handle of the 3D object model.

MomentsToCalculatemomentsToCalculatemoments_to_calculate (input_control) number(-array) → (string)(string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Moment to calculate.

Default: 'mean_points'"mean_points"
List of values: 'central_moment_2_points', 'mean_points', 'principal_axes'"central_moment_2_points", "mean_points", "principal_axes"

Momentsmomentsmoments (output_control) number(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (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_3dMomentsObjectModel3d returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

read_object_model_3dReadObjectModel3d, connection_object_model_3dConnectionObjectModel3d

Possible successors

project_object_model_3dProjectObjectModel3d, object_model_3d_to_xyzObjectModel3dToXyz, select_object_model_3dSelectObjectModel3d

See also

volume_object_model_3d_relative_to_planeVolumeObjectModel3dRelativeToPlane

Module🔗

3D Metrology