frei_dirfrei_dirFreiDirFreiDir (Operator)

Name

frei_dirfrei_dirFreiDirFreiDir — Detect edges (amplitude and direction) using the Frei-Chen operator.

Signature

frei_dir(Image : ImageEdgeAmp, ImageEdgeDir : : )

Description

frei_dirfrei_dirFreiDirFreiDirFreiDir calculates an approximation of the first derivative of the image data and is used as an edge detector. The filter is based on the following filter masks:

The result image contains the maximum response of the masks A and B. The edge directions are returned in ImageEdgeDirImageEdgeDirImageEdgeDirImageEdgeDirimageEdgeDir, and are stored in 2-degree steps, i.e., an edge direction of x degrees in mathematically positive sense and with respect to the horizontal axis is stored as x / 2 in the edge direction image. Furthermore, the direction of the change of intensity is taken into account. Let denote the image gradient. Then the following edge directions are returned as r/2:

Points with edge amplitude 0 are assigned the edge direction 255 (undefined direction).

Attention

Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.

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.
Automatically parallelized on channel level.
Automatically parallelized on domain level.

Parameters

ImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte / int2 / uint2)

Input image.

ImageEdgeAmpImageEdgeAmpImageEdgeAmpImageEdgeAmpimageEdgeAmp (output_object) (multichannel-)image(-array) → object (byte / int2 / uint2)

Edge amplitude (gradient magnitude) image.

ImageEdgeDirImageEdgeDirImageEdgeDirImageEdgeDirimageEdgeDir (output_object) (multichannel-)image(-array) → object (direction)

Edge direction image.

Example (HDevelop)

read_image(Image,'fabrik')
frei_dir(Image,Frei_dirA,Frei_dirD)
threshold(Frei_dirA,Res,128,255)

Example (C)

read_image(&Image,"fabrik");
frei_dir(Image,&Frei_dirA,&Frei_dirD);
threshold(Frei_dirA,&Res,128,255);

Example (HDevelop)

read_image(Image,'fabrik')
frei_dir(Image,Frei_dirA,Frei_dirD)
threshold(Frei_dirA,Res,128,255)

Example (HDevelop)

read_image(Image,'fabrik')
frei_dir(Image,Frei_dirA,Frei_dirD)
threshold(Frei_dirA,Res,128,255)

Example (HDevelop)

read_image(Image,'fabrik')
frei_dir(Image,Frei_dirA,Frei_dirD)
threshold(Frei_dirA,Res,128,255)

Result

frei_dirfrei_dirFreiDirFreiDirFreiDir always returns 2 (H_MSG_TRUE). If the input is empty the behavior can be set via 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>). If necessary, an exception is raised.

Possible Predecessors

binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, sigma_imagesigma_imageSigmaImageSigmaImageSigmaImage, median_imagemedian_imageMedianImageMedianImageMedianImage, smooth_imagesmooth_imageSmoothImageSmoothImageSmoothImage

Possible Successors

hysteresis_thresholdhysteresis_thresholdHysteresisThresholdHysteresisThresholdHysteresisThreshold, thresholdthresholdThresholdThresholdThreshold, gray_skeletongray_skeletonGraySkeletonGraySkeletonGraySkeleton, nonmax_suppression_dirnonmax_suppression_dirNonmaxSuppressionDirNonmaxSuppressionDirNonmaxSuppressionDir, close_edgesclose_edgesCloseEdgesCloseEdgesCloseEdges, close_edges_lengthclose_edges_lengthCloseEdgesLengthCloseEdgesLengthCloseEdgesLength

Alternatives

edges_imageedges_imageEdgesImageEdgesImageEdgesImage, sobel_dirsobel_dirSobelDirSobelDirSobelDir, robinson_dirrobinson_dirRobinsonDirRobinsonDirRobinsonDir, prewitt_dirprewitt_dirPrewittDirPrewittDirPrewittDir, kirsch_dirkirsch_dirKirschDirKirschDirKirschDir

Module

Foundation

Operators