moments_region_central moments_region_central MomentsRegionCentral MomentsRegionCentral moments_region_central (Operator)
Name
moments_region_central moments_region_central MomentsRegionCentral MomentsRegionCentral moments_region_central
— Geometric moments of regions.
Signature
Herror moments_region_central (const Hobject Regions , double* I1 , double* I2 , double* I3 , double* I4 )
Herror T_moments_region_central (const Hobject Regions , Htuple* I1 , Htuple* I2 , Htuple* I3 , Htuple* I4 )
void MomentsRegionCentral (const HObject& Regions , HTuple* I1 , HTuple* I2 , HTuple* I3 , HTuple* I4 )
HTuple HRegion ::MomentsRegionCentral (HTuple* I2 , HTuple* I3 , HTuple* I4 ) const
double HRegion ::MomentsRegionCentral (double* I2 , double* I3 , double* I4 ) const
def moments_region_central (regions : HObject) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
def moments_region_central_s (regions : HObject) -> Tuple[float, float, float, float]
Description
The operator moments_region_central moments_region_central MomentsRegionCentral MomentsRegionCentral MomentsRegionCentral moments_region_central
calculates the
central moments (I1 I1 I1 I1 i1 i1
, I2 I2 I2 I2 i2 i2
,
I3 I3 I3 I3 i3 i3
, I4 I4 I4 I4 i4 i4
).
Calculation: Then the moments
are defined by:
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_system set_system SetSystem SetSystem SetSystem set_system
).
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
Regions Regions Regions Regions regions regions
(input_object) region(-array) →
object HRegion HObject HRegion Hobject
Regions to be examined.
I1 I1 I1 I1 i1 i1
(output_control) real(-array) →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Moment of 2nd order.
I2 I2 I2 I2 i2 i2
(output_control) real(-array) →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Moment of 2nd order.
I3 I3 I3 I3 i3 i3
(output_control) real(-array) →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Moment of 2nd order.
I4 I4 I4 I4 i4 i4
(output_control) real(-array) →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Moment of 3rd order.
Complexity
If Z is the area of the region the mean runtime
complexity is O(sqrt(Z)).
Result
The operator moments_region_central moments_region_central MomentsRegionCentral MomentsRegionCentral MomentsRegionCentral moments_region_central
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>) set_system("no_object_result",<Result>) SetSystem("no_object_result",<Result>) SetSystem("no_object_result",<Result>) SetSystem("no_object_result",<Result>) 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>) set_system("empty_region_result",<Result>) SetSystem("empty_region_result",<Result>) SetSystem("empty_region_result",<Result>) SetSystem("empty_region_result",<Result>) set_system("empty_region_result",<Result>)
.
If necessary an exception is raised.
Possible Predecessors
threshold threshold Threshold Threshold Threshold threshold
,
regiongrowing regiongrowing Regiongrowing Regiongrowing Regiongrowing regiongrowing
,
connection connection Connection Connection Connection connection
Alternatives
moments_region_2nd moments_region_2nd MomentsRegion2nd MomentsRegion2nd MomentsRegion2nd moments_region_2nd
See also
elliptic_axis elliptic_axis EllipticAxis EllipticAxis EllipticAxis elliptic_axis
Module
Foundation