Binary Mask Explicit Stencil Black Hat

Description

Calculate a signed black-hat grid as explicit-stencil closing minus the original binary mask.

A binary grid represents foreground as numeric one and background as zero. A stencil is a set of integer [rowOffset,columnOffset] positions relative to a cell. Connectivity describes allowed neighbor steps: four-neighbor connectivity uses orthogonal steps, while eight-neighbor connectivity also includes diagonals. Finite image borders and asymmetric stencils affect the result.

Calculate a signed black-hat grid as explicit-stencil closing minus the original binary mask.

When to use this tool

Use a black-hat difference to inspect changes introduced by closing, including negative border artifacts.

How to use the tool and how it works

Enter mask, stencil using the definitions below.
Run the operation. Resolve input-format errors before interpreting an output.
Read result.mask, using the stated boundary, ordering, sign and absence conventions.

Compute closing as dilation followed by erosion, then subtract the original mask from that closed frame cellwise.^[1]

Input field	Meaning and units	Accepted input
mask	Rectangular numeric 0/1 rows, up to 64×64; row is the first coordinate and column the second.	Dense numeric rows, each dimension at most 128; the stated shape rules also apply.
stencil	Nonempty list of distinct integer [rowOffset,columnOffset] pairs, each coordinate -16 through 16; at most 128 offsets.	Dense numeric rows, each dimension at most 128; the stated shape rules also apply.

Output field	Interpretation
result	Object containing the fields below.
result.mask	Result grid in original frame dimensions, with numeric cell meanings and any signed subtraction convention described above.

json

{
  "input": {
    "mask": [
      [
        0,
        0,
        0
      ],
      [
        0,
        1,
        0
      ],
      [
        0,
        0,
        0
      ]
    ],
    "stencil": [
      [
        0,
        0
      ],
      [
        0,
        1
      ]
    ]
  },
  "output": {
    "result": {
      "mask": [
        [
          0,
          0,
          0
        ],
        [
          0,
          0,
          0
        ],
        [
          0,
          0,
          0
        ]
      ]
    }
  }
}

Limitations and assumptions

Return signed differences without clipping. Cropping between stages can make closing smaller than the input near a border, so -1 values are possible.
Masks are rectangular dense arrays of numeric 0/1 cells, with at most 64 rows and 64 columns. Empty frames are allowed where no in-bounds seed is required. Stencils are nonempty lists of distinct integer [rowOffset,columnOffset] pairs, each coordinate between -16 and 16. Outside-frame samples are zero at every stage.
Every declared outer field is required and unknown outer fields are rejected. Strings and JSON text have size limits, lists are bounded to 128 entries, and JSON nesting/node counts are bounded. Tighter operation-specific bounds stated above take precedence.
Numeric outputs must remain finite and within safe-integer magnitude. Original record indexes and cell coordinates are zero-based; stated half-open ranges exclude their end.

Alternative or Complementary methods

Choose a component operation for connected regions and an explicit stencil for local shape tests. Fix connectivity and border policy before comparing masks; convert cell counts to physical area separately when pixel spacing is known.

References

Tool behavior and example: Binary Mask Explicit Stencil Black Hat — tool.io

Similar or alternative tools

Binary Mask Explicit Stencil Closing
Apply explicit-stencil dilation followed by erosion within the original finite binary-grid frame.
Binary Mask Explicit Stencil Top Hat
Calculate a signed top-hat grid as the original binary mask minus its explicit-stencil opening.