moments_region_3rd

Herror ::moments_region_3rd_invar ( Hobject Regions, double *M21, double *M12, double *M03, double *M30 ) Herror ::moments_region_3rd_invar ( Hobject Regions, HTuple *M21, HTuple *M12, HTuple *M03, HTuple *M30 ) double HRegion::MomentsRegion3rdInvar ( double *M12, double *M03, double *M30 ) const HTuple HRegionArray::MomentsRegion3rdInvar ( HTuple *M12, HTuple *M03, HTuple *M30 ) const

Geometric moments of regions.

The operator ::moments_region_3rd_invar calculates the scale-invariant moments (M21, M12, M03, M30).

Calculation: Then the moments Mpq  are defined by:

                    Mpq = MUpq / MU^3,

            wherein are p+q>=2 and MU=MU00=m00.

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

Parameters

`Regions` (input_object)	region(-array) `->` Hobject: HRegion(Array)
Regions to be examined.

`M21` (output_control)	real(-array) `->` (HTuple.) double *
Moment of 3nd order (line-dependent).

`M12` (output_control)	real(-array) `->` (HTuple.) double *
Moment of 3nd order (column-dependent).

`M03` (output_control)	real(-array) `->` (HTuple.) double *
Moment of 3nd order (column-dependent).

`M30` (output_control)	real(-array) `->` (HTuple.) double *
Moment of 3nd order (line-dependent).

Complexity

If Z is the area of the region the mean runtime complexity is O(Z).

Result

The operator ::moments_region_3rd_invar returns the value 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 handling is raised.

Possible Predecessors

::threshold, ::regiongrowing, ::connection

Alternatives

::moments_region_2nd

See also

::elliptic_axis

Module

Region processing