Tool Connectivity Analysis
Connectivity analysis of a binary input image according to
Burger, W., Burge, M.: Digitale Bildverarbeitung. Springer Verlag 2006, p.208.
Output consists in a symbolic image of the connected foreground regions and a shape of the borders of the foreground regions (outer and inner borders). The shape may contain alternatively the centers or the corners of the border pixels. Optionally, the regions which have contact with the image borders can be removed together with their border shapes.
In addition, an optional morphological filter (erosion-binary reconstruction) can be applied to the input image first.
- Author: HfT Stuttgart (c) 2013
- Menu: Grid|Filter
Parameters
| Name | Type | Identifier | Description | Constraints |
Input | Input Binary Grid | Grid, input | INPUT_GRID | Binary input image for the connectivity analysis | - |
Output | Filtered Image (*) | Grid, output, optional | FILTERED_MASK | Morphologically filtered binary mask | - |
Symbolic Image | Grid, output | SYMBOLIC_IMAGE | The final symbolic image | - |
Outlines | Shapes, output | OUTLINES | Polygon outlines of object regions | - |
Options | Grid System | Grid system | PARAMETERS_GRID_SYSTEM | - | - |
Apply Filter? | Boolean | FILTER | Apply a filter (erosion - binary reconstruction) to the input image | Default: 1 |
Filter Size (Radius) | Integer | SIZE | Filter size (radius in grid cells) | Default: 3 |
Pixel Centers? | Boolean | BORDER_PIXEL_CENTERS | Should the output shapes contain the centers of the border pixels instead of the corners? | Default: 0 |
Remove Border Regions? | Boolean | REMOVE_MARGINAL_REGIONS | Remove regions which have contact with (are adjacent to) the image borders? | Default: 0 |
(*) optional |
Command-line
Usage: saga_cmd grid_filter 14 [-INPUT_GRID <str>] [-FILTERED_MASK <str>] [-FILTER <str>] [-SIZE <num>] [-SYMBOLIC_IMAGE <str>] [-OUTLINES <str>] [-BORDER_PIXEL_CENTERS <str>] [-REMOVE_MARGINAL_REGIONS <str>]
-INPUT_GRID:<str> Input Binary Grid
Grid, input
-FILTERED_MASK:<str> Filtered Image
Grid, output, optional
-FILTER:<str> Apply Filter?
Boolean
Default: 1
-SIZE:<num> Filter Size (Radius)
Integer
Default: 3
-SYMBOLIC_IMAGE:<str> Symbolic Image
Grid, output
-OUTLINES:<str> Outlines
Shapes, output
-BORDER_PIXEL_CENTERS:<str> Pixel Centers?
Boolean
Default: 0
-REMOVE_MARGINAL_REGIONS:<str> Remove Border Regions?
Boolean
Default: 0