ImageMorphology.jl

This package provides morphology operations for structure analysis and image processing.

setup

ImageMorphology is a sub-package of the umbrella package Images.jl – either using Images or using ImageMorphology will give you access to this functionality.

Installation

Just like all normal Julia packages, you can use Pkg to install it:

pkg> add ImageMorphology # hit ] to enter Pkg mode

Learn

The perhaps quickest way to use this library is to find a set of useful operators from the gallery and build your own pipeline from it.

For any advanced usage, we recommend you to read the "Concept" part. For instance, many morphology operation supports generic "structuring element".

Overview

The following tables give an overview of ImageMorphology functionalities.

🚧 work in progress

This overview is not yet finished and only contains a subset of exported functions. The missing functions will be added in the future. You might still need to check the heavy reference page to find out what you need. Contributions are welcome!

Structuring Element (SE)

Structuring element is the key concept in morphology. If you're not familiar with this, please read concept: structuring element first.

name	summary
`strel`	convert between different SE representations
`strel_type`	infer the SE type
`strel_size`	get the minimal block size that contains the SE
`strel_chain` and `strel_product`	compose multiple SEs into a bigger one
`strel_box`	construct a box-shaped SE, e.g., C8, C26 connectivity
`strel_diamond`	construct a diamond-shaped SE, e.g., C4, C6 connectivity
`centered`	shift the array center to `(0, 0, ..., 0)`

Basic morphological operations

name	summary	examples
`extreme_filter` and `extreme_filter!`	iteratively apply a select function `f(x, y)` to each neighborhood	`extreme_filter` operation
`dilate` and `dilate!`	morphological max filter	`dilate` operation
`erode` and `erode!`	morphological min filter	`erode` operation
`opening` and `opening!`	fills white holes	`opening` operation
`closing` and `closing!`	fills black holes	`closing` operation
`bothat` and `bothat!`	extract black details	`bothat` operation
`tophat` and `tophat!`	extract white details	`tophat` operation
`mgradient` and `mgradient!`	morphological gradient	`mgradient` operation
`mlaplacian` and `mlaplacian!`	morpholigical laplacian	`mlaplacian` operation

Geodesic operations

name	summary	examples
`underbuild`	morphological reconstruction by dilation, see also `mreconstruct`	`underbuild` operation and `mreconstruct` operation
`underbuild`	morphological reconstruction by erosion, see also `mreconstruct`	`overbuild` operation and `mreconstruct` operation