# mikolalysenko/ball-morphology

Morphological operations with ball shaped structuring elements
JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
example
test
.gitignore
.npmignore
morphology.js
package.json

# ball-morphology

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

# Example

```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

You can’t perform that action at this time.