moments_region_central (Operator)

Name

`moments_region_central` — Geometric moments of regions.

Signature

`moments_region_central(Regions : : : I1, I2, I3, I4)`

Description

The operator `moments_region_central` calculates the central moments (`I1`, `I2`, `I3`, `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`).

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` (input_object)  region(-array) `→` object

Regions to be examined.

`I1` (output_control)  real(-array) `→` (real)

Moment of 2nd order.

`I2` (output_control)  real(-array) `→` (real)

Moment of 2nd order.

`I3` (output_control)  real(-array) `→` (real)

Moment of 2nd order.

`I4` (output_control)  real(-array) `→` (real)

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

Possible Predecessors

`threshold`, `regiongrowing`, `connection`

Alternatives

`moments_region_2nd`

`elliptic_axis`