skimage 0.17.2

NotesParametersReturns
morphological_chan_vese(image, iterations, init_level_set='checkerboard', smoothing=1, lambda1=1, lambda2=1, iter_callback=<function <lambda> at 0x0000000>)

Active contours without edges implemented with morphological operators. It can be used to segment objects in images and volumes without well defined borders. It is required that the inside of the object looks different on average than the outside (i.e., the inner area of the object should be darker or lighter than the outer area on average).

Notes

This is a version of the Chan-Vese algorithm that uses morphological operators instead of solving a partial differential equation (PDE) for the evolution of the contour. The set of morphological operators used in this algorithm are proved to be infinitesimally equivalent to the Chan-Vese PDE (see ). However, morphological operators are do not suffer from the numerical stability issues typically found in PDEs (it is not necessary to find the right time step for the evolution), and are computationally faster.

The algorithm and its theoretical derivation are described in .

Parameters

image : (M, N) or (L, M, N) array

Grayscale image or volume to be segmented.

iterations : uint

Number of iterations to run

init_level_set : str, (M, N) array, or (L, M, N) array

Initial level set. If an array is given, it will be binarized and used as the initial level set. If a string is given, it defines the method to generate a reasonable initial level set with the shape of the :None:None:`image`. Accepted values are 'checkerboard' and 'circle'. See the documentation of checkerboard_level_set and :None:None:`circle_level_set` respectively for details about how these level sets are created.

smoothing : uint, optional

Number of times the smoothing operator is applied per iteration. Reasonable values are around 1-4. Larger values lead to smoother segmentations.

lambda1 : float, optional

Weight parameter for the outer region. If :None:None:`lambda1` is larger than :None:None:`lambda2`, the outer region will contain a larger range of values than the inner region.

lambda2 : float, optional

Weight parameter for the inner region. If :None:None:`lambda2` is larger than :None:None:`lambda1`, the inner region will contain a larger range of values than the outer region.

iter_callback : function, optional

If given, this function is called once per iteration with the current level set as the only argument. This is useful for debugging or for plotting intermediate results during the evolution.

Returns

out : (M, N) or (L, M, N) array

Final segmentation (i.e., the final level set)

Morphological Active Contours without Edges (MorphACWE)

See Also

checkerboard_level_set
circle_level_set

Examples

See :

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


File: /skimage/segmentation/morphsnakes.py#256
type: <class 'function'>
Commit: