eccentricity

Herror ::eccentricity ( Hobject Regions, double *Anisometry, double *Bulkiness, double *StructureFactor ) Herror ::eccentricity ( Hobject Regions, HTuple *Anisometry, HTuple *Bulkiness, HTuple *StructureFactor ) double HRegion::Eccentricity ( double *Bulkiness, double *StructureFactor ) const HTuple HRegionArray::Eccentricity ( HTuple *Bulkiness, HTuple *StructureFactor ) const

Shape features derived from the ellipse parameters.

The operator ::eccentricity calculates three shape features derived from the geometric moments.

Definition: If the ellipse radii Ia, Ib and the area A of the
            region are given (see ::moments_region_2nd),
            the following applies:
	      
   Anisometry = Ia / Ib
   
   Bulkiness = 4 pi Ia Ib / A**3
   
   StructureFactor = Anisometry * Bulkiness - 1

Parameters

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

`Anisometry` (output_control)	real(-array) `->` (HTuple.) double *
Shape feature (in case of a circle = 1.0).
Assertion: `Anisometry >= 1.0`

`Bulkiness` (output_control)	real(-array) `->` (HTuple.) double *
Calculated shape feature.

`StructureFactor` (output_control)	real(-array) `->` (HTuple.) double *
Calculated shape feature.

Complexity

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

Result

The operator ::eccentricity 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

Module

Region processing