entropy_grayentropy_grayEntropyGrayEntropyGrayentropy_gray (Operator)

Name

entropy_grayentropy_grayEntropyGrayEntropyGrayentropy_gray — Determine the entropy and anisotropy of images.

Signature

entropy_gray(Regions, Image : : : Entropy, Anisotropy)

Herror entropy_gray(const Hobject Regions, const Hobject Image, double* Entropy, double* Anisotropy)

Herror T_entropy_gray(const Hobject Regions, const Hobject Image, Htuple* Entropy, Htuple* Anisotropy)

void EntropyGray(const HObject& Regions, const HObject& Image, HTuple* Entropy, HTuple* Anisotropy)

HTuple HImage::EntropyGray(const HRegion& Regions, HTuple* Anisotropy) const

double HImage::EntropyGray(const HRegion& Regions, double* Anisotropy) const

HTuple HRegion::EntropyGray(const HImage& Image, HTuple* Anisotropy) const

double HRegion::EntropyGray(const HImage& Image, double* Anisotropy) const

static void HOperatorSet.EntropyGray(HObject regions, HObject image, out HTuple entropy, out HTuple anisotropy)

HTuple HImage.EntropyGray(HRegion regions, out HTuple anisotropy)

double HImage.EntropyGray(HRegion regions, out double anisotropy)

HTuple HRegion.EntropyGray(HImage image, out HTuple anisotropy)

double HRegion.EntropyGray(HImage image, out double anisotropy)

def entropy_gray(regions: HObject, image: HObject) -> Tuple[Sequence[float], Sequence[float]]

def entropy_gray_s(regions: HObject, image: HObject) -> Tuple[float, float]

Description

The operator entropy_grayentropy_grayEntropyGrayEntropyGrayentropy_gray creates the histogram of relative frequencies of the gray values in the input image and calculates from these frequencies the entropy and the anisotropy coefficient for each region from RegionsRegionsRegionsregionsregions according to the following formulae:

Entropy: Anisotropiy coefficient: where rel[i] histogram of relative gray value frequencies i Gray value of input image (0..255) and k Smallest possible gray value with sum(rel[i]) >= 0.5

Attention

Note that the operator entropy_grayentropy_grayEntropyGrayEntropyGrayentropy_gray only considers the given RegionsRegionsRegionsregionsregions and ignores any previously set domain of the input image ImageImageImageimageimage.

Execution Information

Parameters

RegionsRegionsRegionsregionsregions (input_object)  region(-array) objectHRegionHObjectHObjectHobject

Regions where the features are to be determined.

ImageImageImageimageimage (input_object)  singlechannelimage objectHImageHObjectHObjectHobject (byte)

Gray value image.

EntropyEntropyEntropyentropyentropy (output_control)  real(-array) HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Information content (entropy) of the gray values.

Assertion: 0 <= Entropy && Entropy <= 8

AnisotropyAnisotropyAnisotropyanisotropyanisotropy (output_control)  real(-array) HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Measure of the symmetry of gray value distribution.

Complexity

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

Result

The operator entropy_grayentropy_grayEntropyGrayEntropyGrayentropy_gray returns the value 2 ( H_MSG_TRUE) if an image with defined gray values is entered and the parameters are correct. The behavior in case of empty input (no input images 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>)set_system("no_object_result",<Result>), the behavior in case of empty region 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>)set_system("empty_region_result",<Result>). If necessary an exception is raised.

Alternatives

select_grayselect_graySelectGraySelectGrayselect_gray

See also

entropy_imageentropy_imageEntropyImageEntropyImageentropy_image, gray_histogray_histoGrayHistoGrayHistogray_histo, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsgray_histo_abs, fuzzy_entropyfuzzy_entropyFuzzyEntropyFuzzyEntropyfuzzy_entropy, fuzzy_perimeterfuzzy_perimeterFuzzyPerimeterFuzzyPerimeterfuzzy_perimeter

Module

Foundation