Module 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
Specification: grid
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 (optional output)	`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	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 (optional output)
  -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