ball-morphology

Morphological operations with ball shaped structuring elements

npm install ball-morphology
5 downloads in the last week
13 downloads in the last month

ball-morphology

Mathematical morphology for ndarrays where the structuring element is a ball in some Lp metric.

Example

First, let's read an image:

var morphology = require("ball-morphology")

require("get-pixels")("bwimage.png", function(err, data) {
  var r = data.pick(-1, -1, 0)

  // ... do stuff ...
})

Which gives us the following array:

We can dilate the image using the following command:

morphology.dilate(r, 1)

Which produces the following result:

Similarly, we can also perform an erosion:

morphology.erode(r, 1)

Giving the result:

For convenience, openings and closing are also implemented:

morphology.open(r, 1)
morphology.close(r, 1)

Install

npm install ball-morphology

API

var morphology = require("ball-morphology")

morphology.dilate(array, radius[, p])

Performs a binary morphological dilation with an Lp ball of a given radius

  • array is a binary image (updated in place)
  • radius is the radius of the ball in pixel units (may be fractional)
  • p is an optional argument giving the exponent of the metric. (Default 2)

Returns array

morphology.erode(array, radius[, p])

Performs a binary morphological erosion with an Lp ball of a given radius

  • array is a binary image (updated in place)
  • radius is the radius of the ball in pixel units (may be fractional)
  • p is an optional argument giving the exponent of the metric. (Default 2)

Returns array

morphology.open(array, radius[, p])

Performs a binary morphological opening with an Lp ball of a given radius

  • array is a binary image (updated in place)
  • radius is the radius of the ball in pixel units (may be fractional)
  • p is an optional argument giving the exponent of the metric. (Default 2)

Returns array

morphology.close(array, radius[, p])

Performs a binary morphological closing with an Lp ball of a given radius

  • array is a binary image (updated in place)
  • radius is the radius of the ball in pixel units (may be fractional)
  • p is an optional argument giving the exponent of the metric. (Default 2)

Returns array

Credits

(c) 2013 Mikola Lysenko. MIT License

npm loves you