Skip to content

moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarmoments_region_2nd_invarmoments_region_2nd_invar🔗

Short description🔗

moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarmoments_region_2nd_invarmoments_region_2nd_invar — Geometric moments of regions.

Signature🔗

moments_region_2nd_invar( region Regions, out real M11, out real M20, out real M02 )moments_region_2nd_invar( Regions : : : M11, M20, M02 )void MomentsRegion2ndInvar( const HObject& Regions, HTuple* M11, HTuple* M20, HTuple* M02 )static void HOperatorSet.MomentsRegion2ndInvar( HObject regions, out HTuple m11, out HTuple m20, out HTuple m02 )def moments_region_2nd_invar( regions: HObject ) -> Tuple[Sequence[float], Sequence[float], Sequence[float]]

def moments_region_2nd_invar_s( regions: HObject ) -> Tuple[float, float, float]Herror moments_region_2nd_invar( const Hobject Regions, double* M11, double* M20, double* M02 )

Herror T_moments_region_2nd_invar( const Hobject Regions, Htuple* M11, Htuple* M20, Htuple* M02 )

HTuple HRegion::MomentsRegion2ndInvar( HTuple* M20, HTuple* M02 ) const

double HRegion::MomentsRegion2ndInvar( double* M20, double* M02 ) const

HTuple HRegion.MomentsRegion2ndInvar( out HTuple m20, out HTuple m02 )

double HRegion.MomentsRegion2ndInvar( out double m20, out double m02 )

Description🔗

The operator moments_region_2nd_invarMomentsRegion2ndInvar calculates the scaled moments (M20m20m20, M02m02m02) and the product of inertia of the axes through the center parallel to the coordinate axes (M11m11m11).

  • Calculation: \(Z_{0}\) and \(S_{0}\) are the coordinates of the center of a region R with the area F. Then the moments \(M_{ij}\) are defined by:

    \[\begin{eqnarray*} M_{ij} = \frac{1}{F^2}\sum_{(Z,S) \in R} {(Z_{0} - Z)^i (S_{0} - S)^j} \end{eqnarray*}\]

    ,

    wherein Z and S run through all pixels of the region R.

If more than one region is passed the results are stored in tuples, the index of a value in the tuple corresponding to the index of a region in the input.

In case of empty region all parameters have the value 0.0 if no other behavior was set (see set_systemSetSystem).

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on tuple level.

Parameters🔗

Regionsregionsregions (input_object) region(-array) → objectobjectHObjectHRegionHObjectHobject

Regions to be examined.

M11m11m11 (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Product of inertia of the axes through the center parallel to the coordinate axes.

M20m20m20 (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Moment of 2nd order (line-dependent).

M02m02m02 (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Moment of 2nd order (column-dependent).

Complexity🔗

If \(F\) is the area of the region the mean runtime complexity is \(O(\sqrt{F})\).

Result🔗

The operator moments_region_2nd_invarMomentsRegion2ndInvar returns the value 2 (H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>). The behavior in case of empty region (the region is the empty set) is set via set_system('empty_region_result',<Result>). If necessary an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

thresholdThreshold, regiongrowingRegiongrowing, connectionConnection

Alternatives

moments_region_2ndMomentsRegion2nd

See also

elliptic_axisEllipticAxis

Module🔗

Foundation