Description
Keep whole foreground components whose cell counts fall within inclusive size bounds.
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.
Keep whole foreground components whose cell counts fall within inclusive size bounds.
When to use this tool
Use size selection to retain complete foreground regions within a chosen cell-count interval.
How to use the tool and how it works
- Enter mask, eight, minimum, maximum 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.
Label foreground components using the chosen connectivity and keep an entire component exactly when its cell count lies between minimum and maximum inclusive.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. |
| eight | True uses all eight adjacent neighbors; false uses only four orthogonal neighbors for the foreground/background component specified above. | Boolean true or false. |
| minimum | Inclusive minimum component size in cells, integer 0–4,096. | Finite safe integer satisfying the stated bounds. |
| maximum | Inclusive maximum component size in cells, integer minimum through 4,096. | Finite safe integer satisfying the stated bounds. |
| 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. |
{
"input": {
"mask": [
[
1,
0
],
[
0,
1
]
],
"eight": false,
"minimum": 2,
"maximum": 5
},
"output": {
"result": {
"mask": [
[
0,
0
],
[
0,
0
]
]
}
}
}Limitations and assumptions
- Bounds are integer cell counts from zero through 4,096 with maximum≥minimum. The tool does not split a component to fit a size bound or infer physical pixel area.
- 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
Similar or alternative tools
- Binary Mask Component Cell Area Table
Report foreground component areas as cell counts under the chosen connectivity.
- Binary Mask Isolated Cell Remover
Remove foreground components containing exactly one cell under the chosen connectivity.