Rvision (version 0.4.2)

watershed: Image Segmentation Using the Watershed Algorithm

Description

watershed implements one of the variants of watershed, non-parametric marker-based segmentation algorithm, described in Meyer (1992).

Usage

watershed(image, markers)

Arguments

image

An 8-bit (8U), BGR Image object.

markers

A signed 32-bit (32S) single-channel (GRAY) Image object (see Details).

Value

This function does not return anything. It modifies markers in place.

Details

Before passing image to the function, you have to roughly outline the desired regions in the markers image with positive (>0) indices. So, every region is represented as one or more connected components with the pixel values 1, 2, 3, and so on. Such markers can be retrieved from a binary mask using findContours. The markers are "seeds" of the future image regions. All the other pixels in markers, whose relation to the outlined regions is not known and should be defined by the algorithm, should be set to 0's. In the function output, each pixel in markers is set to a value of the "seed" components or to -1 at boundaries between the regions.

References

Meyer F. Color image segmentation. 1992 International Conference on Image Processing. 1992. Available: https://ieeexplore.ieee.org/abstract/document/785528/

See Also

findContours

Examples

# NOT RUN {
dots <- image(system.file("sample_img/dots.jpg", package = "Rvision"))
dots_gray <- changeColorSpace(dots, "GRAY")
dots_bin <- dots_gray < 200
contours <- findContours(dots_bin)
rows <- contours$contours$y
cols <- contours$contours$x
colors <- contours$contours$id + 2
markers <- array(0.0, dim = c(nrow(dots_bin), ncol(dots_bin), 1))
markers[1:2, 1:2, 1] <- 1
markers[cbind(rows, cols, 1)] <- colors
markers <- image(markers)
changeBitDepth(markers, "32S", in_place = TRUE)
watershed(dots, markers)
plot(markers)

# }