Morphological operations with ball shaped structuring elements
JavaScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
example
test
.gitignore
.npmignore
LICENSE
README.md
morphology.js
package.json

README.md

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