edgeFeatures {EBImage}R Documentation

Extraction of edge profiles and edge features from images of indexed objects

Description

Edge profile is a distance profile from the geometric center of the object to all its perimeter points calculated by taking the distance at different rotation angles (rotation around the center). The profile is calculated for the rotation angle, theta in [-pi,pi].

Usage


  ## S4 method for signature 'IndexedImage':
  edgeProfile(x, ref, n=32, fft=TRUE, scale=TRUE, rotate=TRUE, ...)
  ## S4 method for signature 'IndexedImage':
  edgeFeatures(x, ref, ...)

Arguments

x An object of IndexedImage.
ref A reference Grayscale image of the same size as x. See details.
n An integer value giving the number of angle measures. The full circle of [-pi,pi] is divided into n-1 segments, at which edges the profile is approximated.
fft A logical value. If TRUE, the resulting profile is the fft transformation of the distance profile giving the frequences of angular changes in shape.
scale A logical value. If TRUE, the resulting profile is scaled by the effective radius (calcualted as part of link{hull.features}) making the profile scale invariant.
rotate A logical value. If TRUE, the resulting profile is shifted by the object's roation angle (calculated from the moments on the ref image, if provided, and on the hull otherwise.
... Reserved.

Details

The ref image can be omitted. However, if supplied it affects the centers of objects and their angles of rotation as in moments.

The edge.features runs with n=16 calculating scale and rotation invariant features. From the original distance profile, it returns the measure of object's irregularity taken by calculating the difference between the farthest and the closest to the center edge points. Then it computes the fft and returns 4 of it's lowest frequences, corresponding to 2*Pi, 2*Pi/2=Pi, 2*Pi/3 and 2*Pi/4=Pi/2.

The extracted feature names carry a e. prefix to indicate edge features.

Value

For a single frame, both functions return a matrix of descriptors with objects in rows and ordered profile points (or features) in columns. For image stacks, a list of such matrices.
The matrix columns in edge.profile correspond, from left to right, to the equidistant divisions of the range [-pi,pi] if fft is not used, otherwise to the frequences of angular changes (lower frequences on the left, higher on the right up to the middle of the vector).

Author(s)

Oleg Sklyar, osklyar@ebi.ac.uk, 2007

See Also

IndexedImage, watershed, getFeatures, hullFeatures, moments

Examples

  ## see example(getFeatures)

[Package EBImage version 2.2.0 Index]