Docs for 0.14.3
All versions

Comparing edge-based and region-based segmentation

In this example, we will see how to segment objects from a background. We use the coins image from, which shows several coins outlined against a darker background.

import numpy as np
import matplotlib.pyplot as plt

from skimage import data

coins = data.coins()
hist = np.histogram(coins, bins=np.arange(0, 256))

fig, axes = plt.subplots(1, 2, figsize=(8, 3))
axes[0].imshow(coins,, interpolation='nearest')
axes[1].plot(hist[1][:-1], hist[0], lw=2)
axes[1].set_title('histogram of gray values')


A simple way to segment the coins is to choose a threshold based on the histogram of gray values. Unfortunately, thresholding this image gives a binary image that either misses significant parts of the coins or merges parts of the background with the coins:

fig, axes = plt.subplots(1, 2, figsize=(8, 3), sharey=True)

axes[0].imshow(coins > 100,, interpolation='nearest')
axes[0].set_title('coins > 100')

axes[1].imshow(coins > 150,, interpolation='nearest')
axes[1].set_title('coins > 150')

for a in axes:


Edge-based segmentation

Next, we try to delineate the contours of the coins using edge-based segmentation. To do this, we first get the edges of features using the Canny edge-detector.

from skimage.feature import canny

edges = canny(coins)

fig, ax = plt.subplots(figsize=(4, 3))
ax.imshow(edges,, interpolation='nearest')
ax.set_title('Canny detector')

These contours are then filled using mathematical morphology.

from scipy import ndimage as ndi

fill_coins = ndi.binary_fill_holes(edges)

fig, ax = plt.subplots(figsize=(4, 3))
ax.imshow(fill_coins,, interpolation='nearest')
ax.set_title('filling the holes')

Small spurious objects are easily removed by setting a minimum size for valid objects.

from skimage import morphology

coins_cleaned = morphology.remove_small_objects(fill_coins, 21)

fig, ax = plt.subplots(figsize=(4, 3))
ax.imshow(coins_cleaned,, interpolation='nearest')
ax.set_title('removing small objects')

However, this method is not very robust, since contours that are not perfectly closed are not filled correctly, as is the case for one unfilled coin above.

Region-based segmentation

We therefore try a region-based method using the watershed transform. First, we find an elevation map using the Sobel gradient of the image.

from skimage.filters import sobel

elevation_map = sobel(coins)

fig, ax = plt.subplots(figsize=(4, 3))
ax.imshow(elevation_map,, interpolation='nearest')
ax.set_title('elevation map')

Next we find markers of the background and the coins based on the extreme parts of the histogram of gray values.

markers = np.zeros_like(coins)
markers[coins < 30] = 1
markers[coins > 150] = 2

fig, ax = plt.subplots(figsize=(4, 3))
ax.imshow(markers,, interpolation='nearest')

Finally, we use the watershed transform to fill regions of the elevation map starting from the markers determined above:

segmentation = morphology.watershed(elevation_map, markers)

fig, ax = plt.subplots(figsize=(4, 3))
ax.imshow(segmentation,, interpolation='nearest')

This last method works even better, and the coins can be segmented and labeled individually.

from skimage.color import label2rgb

segmentation = ndi.binary_fill_holes(segmentation - 1)
labeled_coins, _ = ndi.label(segmentation)
image_label_overlay = label2rgb(labeled_coins, image=coins)

fig, axes = plt.subplots(1, 2, figsize=(8, 3), sharey=True)
axes[0].imshow(coins,, interpolation='nearest')
axes[0].contour(segmentation, [0.5], linewidths=1.2, colors='y')
axes[1].imshow(image_label_overlay, interpolation='nearest')

for a in axes:


Total running time of the script: ( 0 minutes 0.493 seconds)

Gallery generated by Sphinx-Gallery