Main Content

bwhitmiss

Binary hit-miss operation

collapse all in page

Syntax

BW2 = bwhitmiss(BW,SE1,SE2)
BW2 = bwhitmiss(BW,interval)

Description

BW2 = bwhitmiss(BW,SE1,SE2) performs the hit-miss operation defined by the structuring elements SE1 and SE2. The hit-miss operation preserves pixels in binary image BW whose neighborhoods match the shape of SE1 and don't match the shape of SE2.

This syntax is equivalent to imerode(BW,SE1) & imerode(~BW,SE2).

BW2 = bwhitmiss(BW,interval) performs the hit-miss operation defined in terms of a single array, called an interval. An interval is an array whose elements are 1, 0, or -1. The 1-valued elements make up the domain of SE1, the -1-valued elements make up the domain of SE2, and the 0-valued elements are ignored.

This syntax is equivalent to bwhitmiss(BW,interval==1,interval==-1).

example

Examples

collapse all

Open Live Script

Create sample binary image for this example.

bw = [0 0 0 0 0 0
      0 0 1 1 0 0
      0 1 1 1 1 0
      0 1 1 1 1 0
      0 0 1 1 0 0
      0 0 1 0 0 0]
bw = 6×6

     0     0     0     0     0     0
     0     0     1     1     0     0
     0     1     1     1     1     0
     0     1     1     1     1     0
     0     0     1     1     0     0
     0     0     1     0     0     0

Define an interval.

interval = [0 -1 -1
            1  1 -1
            0  1  0];

Perform hit-miss operation.

bw2 = bwhitmiss(bw,interval)
bw2 = 6x6 logical array

   0   0   0   0   0   0
   0   0   0   1   0   0
   0   0   0   0   1   0
   0   0   0   0   0   0
   0   0   0   0   0   0
   0   0   0   0   0   0

Input Arguments

collapse all

Binary image, specified as a numeric or logical array of any dimension. For numeric input, any nonzero pixels are considered to be 1 (true).

Flat structuring element, specified as a strel object or a numeric matrix with values of 1 and 0. The neighborhoods of SE1 and SE2 should not have overlapping elements.

Interval, specified as a numeric array with values of 1, 0, and -1.

Data Types: single | double | int8 | int16 | int32 | int64

Output Arguments

collapse all

Processed binary image after the hit-miss operation, specified as a logical array of the same size as BW.

Data Types: logical

Version History

Introduced before R2006a

See Also

| |