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
-
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