Skip to content

moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdmoments_region_3rdmoments_region_3rd🔗

Short description🔗

moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdmoments_region_3rdmoments_region_3rd — Geometric moments of regions.

Signature🔗

moments_region_3rd( region Regions, out real M21, out real M12, out real M03, out real M30 )moments_region_3rd( Regions : : : M21, M12, M03, M30 )void MomentsRegion3rd( const HObject& Regions, HTuple* M21, HTuple* M12, HTuple* M03, HTuple* M30 )static void HOperatorSet.MomentsRegion3rd( HObject regions, out HTuple m21, out HTuple m12, out HTuple m03, out HTuple m30 )def moments_region_3rd( regions: HObject ) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float]]

def moments_region_3rd_s( regions: HObject ) -> Tuple[float, float, float, float]Herror moments_region_3rd( const Hobject Regions, double* M21, double* M12, double* M03, double* M30 )

Herror T_moments_region_3rd( const Hobject Regions, Htuple* M21, Htuple* M12, Htuple* M03, Htuple* M30 )

HTuple HRegion::MomentsRegion3rd( HTuple* M12, HTuple* M03, HTuple* M30 ) const

double HRegion::MomentsRegion3rd( double* M12, double* M03, double* M30 ) const

HTuple HRegion.MomentsRegion3rd( out HTuple m12, out HTuple m03, out HTuple m30 )

double HRegion.MomentsRegion3rd( out double m12, out double m03, out double m30 )

Description🔗

The operator moments_region_3rdMomentsRegion3rd calculates the translation-invariant central moments (M21m21m21, M12m12m12, M03m03m03, M30m30m30) of order p+q.

  • Calculation: x and y are the coordinates of the center of a region R with the area Z.

    Then the moments \(M_{pq}\) are defined by:

    \[\begin{eqnarray*} M_{pq} = \sum_{i=1}{M} Z(x_{i},y_{i}){(x_{i}-x)^p}{(y_{i}-y)^q} \end{eqnarray*}\]

    ,

    wherein are \(x=\frac{m_{10}}{m_{00}}\) and \(y=\frac{m_{01}}{m_{00}}\).

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.

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

Moment of 3rd order (line-dependent).

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

Moment of 3rd order (column-dependent).

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

Moment of 3rd order (column-dependent).

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

Moment of 3rd order (line-dependent).

Complexity🔗

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

Result🔗

The operator moments_region_3rdMomentsRegion3rd 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