ClassesClassesClassesClasses | | | | Operators

euler_numbereuler_numberEulerNumbereuler_numberEulerNumberEulerNumber (Operator)

Name

euler_numbereuler_numberEulerNumbereuler_numberEulerNumberEulerNumber — Calculate the Euler number.

Signature

euler_number(Regions : : : EulerNumber)

Herror euler_number(const Hobject Regions, Hlong* EulerNumber)

Herror T_euler_number(const Hobject Regions, Htuple* EulerNumber)

Herror euler_number(Hobject Regions, Hlong* EulerNumber)

Herror euler_number(Hobject Regions, HTuple* EulerNumber)

Hlong HRegion::EulerNumber() const

HTuple HRegionArray::EulerNumber() const

void EulerNumber(const HObject& Regions, HTuple* EulerNumber)

HTuple HRegion::EulerNumber() const

void HOperatorSetX.EulerNumber(
[in] IHUntypedObjectX* Regions, [out] VARIANT* EulerNumber)

VARIANT HRegionX.EulerNumber()

static void HOperatorSet.EulerNumber(HObject regions, out HTuple eulerNumber)

HTuple HRegion.EulerNumber()

Description

The operator euler_numbereuler_numberEulerNumbereuler_numberEulerNumberEulerNumber calculates the Euler number, i.e., the difference between the number of connection components and the number of holes.

In the documentation of the operator region_featuresregion_featuresRegionFeaturesregion_featuresRegionFeaturesRegionFeatures, you can find an image illustrating regions which vary in their Euler number.

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.

Parallelization

Parameters

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Region(s) to be examined.

EulerNumberEulerNumberEulerNumberEulerNumberEulerNumbereulerNumber (output_control)  integer(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Calculated Euler number.

Result

The operator euler_numbereuler_numberEulerNumbereuler_numberEulerNumberEulerNumber 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("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>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection

Alternatives

connect_and_holesconnect_and_holesConnectAndHolesconnect_and_holesConnectAndHolesConnectAndHoles

Module

Foundation


ClassesClassesClassesClasses | | | | Operators