Back to Aurora Vision Studio website

You are here: Start » Filter Reference » Region » Region Morphology » RegionHitAndMissTransform

RegionHitAndMissTransform

Advanced

Module: FoundationBasic

Performs a hit-and-miss transformation on a region using arbitrary kernels.

Name Type Description
Input value inRegion Region Input region
Input value inHitKernel Region The kernel of pixels that should be present
Input value inHitKernelAnchor Location* Location withing inHitKernel, defining its center
Input value inMissKernel Region The kernel of pixels that should be missing
Input value inMissKernelAnchor Location* Location withing inMissKernel, defining its center
Output value outRegion Region Output region

Description

The operation performs a hit-and-miss transformation. Similarly to other region morphology operations, hit-and-miss is conducted using a shape called kernel (or structuring element). In this particular case, there are two kernels: inHitKernel and inMissKernel. Both of them are repeatedly centered at each location within the dimensions of the input region. Then, pixel location L is added to the resulting region if and only if all of the inHitKernel pixels centered at L lie inside and all of the inMissKernel pixels centered at L lie outside the input region.

Examples

RegionHitAndMissTransform run with kernels \( \begin{bmatrix} 1 & X & X\\ 1 & 0 & X\\ 1 & X & X \end{bmatrix} \) where \( 1 \)'s represent pixels from inHitKernel, \( 0 \)'s from inMissKernel and \( X \)'s the other ones.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Hit kernel empty in RegionHitAndMissTransform.
DomainError Inconsistent region dimensions in RegionHitAndMissTransform.
DomainError Miss kernel empty in RegionHitAndMissTransform.

Complexity Level

This filter is available on Advanced Complexity Level.

See Also