Skip to content

moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarmoments_region_central_invarmoments_region_central_invar🔗

Short description🔗

moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarmoments_region_central_invarmoments_region_central_invar — Geometric moments of regions.

Signature🔗

moments_region_central_invar( region Regions, out real PSI1, out real PSI2, out real PSI3, out real PSI4 )moments_region_central_invar( Regions : : : PSI1, PSI2, PSI3, PSI4 )void MomentsRegionCentralInvar( const HObject& Regions, HTuple* PSI1, HTuple* PSI2, HTuple* PSI3, HTuple* PSI4 )static void HOperatorSet.MomentsRegionCentralInvar( HObject regions, out HTuple PSI1, out HTuple PSI2, out HTuple PSI3, out HTuple PSI4 )def moments_region_central_invar( regions: HObject ) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float]]

def moments_region_central_invar_s( regions: HObject ) -> Tuple[float, float, float, float]Herror moments_region_central_invar( const Hobject Regions, double* PSI1, double* PSI2, double* PSI3, double* PSI4 )

Herror T_moments_region_central_invar( const Hobject Regions, Htuple* PSI1, Htuple* PSI2, Htuple* PSI3, Htuple* PSI4 )

HTuple HRegion::MomentsRegionCentralInvar( HTuple* PSI2, HTuple* PSI3, HTuple* PSI4 ) const

double HRegion::MomentsRegionCentralInvar( double* PSI2, double* PSI3, double* PSI4 ) const

HTuple HRegion.MomentsRegionCentralInvar( out HTuple PSI2, out HTuple PSI3, out HTuple PSI4 )

double HRegion.MomentsRegionCentralInvar( out double PSI2, out double PSI3, out double PSI4 )

Description🔗

The operator moments_region_central_invarMomentsRegionCentralInvar calculates the moments (PSI1PSI1psi1, PSI2PSI2psi2, PSI3PSI3psi3, PSI4PSI4psi4) that are invariant under translation and general linear transformations.

Calculation: Then the moments \(\psi_{i}\) are defined by:

\[\begin{eqnarray*} \psi_{1} = \frac{I_{1}}{\mu^4} \\ \psi_{2} = \frac{I_{2}}{\mu^10} \\ \psi_{3} = \frac{I_{3}}{\mu^7} \\ \psi_{4} = \frac{I_{4}}{\mu^11} \end{eqnarray*}\]

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.

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

Moment of 2nd order.

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

Moment of 2nd order.

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

Moment of 2nd order.

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

Moment of 2nd order.

Complexity🔗

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

Result🔗

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