histo_2dimhisto_2dimHisto2dimHisto2dim (Operator)

Name

histo_2dimhisto_2dimHisto2dimHisto2dim — Calculate the histogram of two-channel gray value images.

Signature

Description

The operator histo_2dimhisto_2dimHisto2dimHisto2dimHisto2dim calculates the 2-dimensional histogram of two images within RegionsRegionsRegionsRegionsregions. The gray values of channel 1 (ImageColImageColImageColImageColimageCol) are interpreted as row index, those of channel 2 (ImageRowImageRowImageRowImageRowimageRow) as column index. The gray value at one point P(g1,g2) in the output image Histo2DimHisto2DimHisto2DimHisto2Dimhisto2Dim indicates the frequency of the gray value combination (g1,g2) with g1 indicating the line index and g2 the column index.

Attention

Note that the operator histo_2dimhisto_2dimHisto2dimHisto2dimHisto2dim only considers the given RegionsRegionsRegionsRegionsregions and ignores any previously set domain of the input images.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

read_image(Image,'monkey')
get_domain (Image, Domain)
gauss_filter (Image, ImageGauss, 7)
histo_2dim(Domain,ImageGauss, Image,Histo2Dim)
dev_display(Histo2Dim)

read_image(&Image,"monkey");
get_domain (Image, &Domain)
gauss_filter(Image,&ImageGauss,7);
histo_2dim(Domain,Image,ImageGauss,&Histo2Dim);
set_part(WindowHandle,0,0,511,511);
disp_image(Histo2Dim,WindowHandle);

read_image(Image,'monkey')
get_domain (Image, Domain)
gauss_filter (Image, ImageGauss, 7)
histo_2dim(Domain,ImageGauss, Image,Histo2Dim)
dev_display(Histo2Dim)

read_image(Image,'monkey')
get_domain (Image, Domain)
gauss_filter (Image, ImageGauss, 7)
histo_2dim(Domain,ImageGauss, Image,Histo2Dim)
dev_display(Histo2Dim)

read_image(Image,'monkey')
get_domain (Image, Domain)
gauss_filter (Image, ImageGauss, 7)
histo_2dim(Domain,ImageGauss, Image,Histo2Dim)
dev_display(Histo2Dim)

Complexity

If F is the plane of the region, the runtime complexity is O(F + 256^2).

Result

The operator histo_2dimhisto_2dimHisto2dimHisto2dimHisto2dim returns the value 2 (H_MSG_TRUE) if both images have defined gray values. 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>)SetSystem("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>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

decompose3decompose3Decompose3Decompose3Decompose3, decompose2decompose2Decompose2Decompose2Decompose2, draw_regiondraw_regionDrawRegionDrawRegionDrawRegion

Possible Successors

thresholdthresholdThresholdThresholdThreshold, class_2dim_supclass_2dim_supClass2dimSupClass2dimSupClass2dimSup, pouringpouringPouringPouringPouring, local_maxlocal_maxLocalMaxLocalMaxLocalMax, gray_skeletongray_skeletonGraySkeletonGraySkeletonGraySkeleton

Alternatives

gray_histogray_histoGrayHistoGrayHistoGrayHisto, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbs

See also

get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayval

Module

Foundation