Catalano.Imaging.ActiveContour.Ovuscule

Class Ovuscule

java.lang.Object

Catalano.Imaging.ActiveContour.Ovuscule.Ovuscule

All Implemented Interfaces:

IOvusculeSnake2D

public class Ovuscule
extends java.lang.Object
implements IOvusculeSnake2D

References: http://www.ricarddelgado.com/papers/ovuscule2011.pdf

Constructor Summary

Constructors

Constructor and Description
Ovuscule(FastBitmap fastBitmap, double p1, double p2, double q1, double q2, double r1, double r2)
Ovuscule(FastBitmap fastBitmap, DoublePoint p, DoublePoint q, DoublePoint r)
Ovuscule(FastBitmap fastBitmap, IntPoint p, IntPoint q, IntPoint r)

Method Summary

Modifier and Type	Method and Description
double	energy() The purpose of this method is to compute the energy of the snake.
DoublePoint[]	getEnergyGradient() The purpose of this method is to compute the gradient of the snake energy with respect to the snake-defining nodes.
OvusculeSnake2DNode[]	getNodes() This method provides an accessor to the snake-defining nodes.
OvusculeSnake2DScale[]	getScales() The purpose of this method is to detemine what to draw on screen, given the current configuration of nodes.
void	setNodes(OvusculeSnake2DNode[] node) This method provides a mutator to the snake-defining nodes.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Ovuscule

public Ovuscule(FastBitmap fastBitmap,
                DoublePoint p,
                DoublePoint q,
                DoublePoint r)

Ovuscule

public Ovuscule(FastBitmap fastBitmap,
                IntPoint p,
                IntPoint q,
                IntPoint r)

Ovuscule

public Ovuscule(FastBitmap fastBitmap,
                double p1,
                double p2,
                double q1,
                double q2,
                double r1,
                double r2)

Method Detail

energy

public double energy()

Description copied from interface: IOvusculeSnake2D

The purpose of this method is to compute the energy of the snake. This energy is usually made of three additive terms: 1) the image energy, which gives the driving force associated to the data; 2) the internal energy, which favors smoothness of the snake; and 3) the constraint energy, which incorporates a priori knowledge. This method is called repeatedly during the optimization of the snake. It is imperative that this function be everywhere differentiable with respect to the snake-defining nodes.

Specified by:

energy in interface IOvusculeSnake2D

Returns:

Return a number that should attain a minimal value when the snake is optimal. Negative values are admissible.

getEnergyGradient

public DoublePoint[] getEnergyGradient()

Description copied from interface: IOvusculeSnake2D

The purpose of this method is to compute the gradient of the snake energy with respect to the snake-defining nodes. This method is called repeatedly during the optimization of the snake. The optimization takes place under the control of the method OvusculeSnake2DKeeper.Optimize().

Specified by:

getEnergyGradient in interface IOvusculeSnake2D

Returns:

Return an array that contains the gradient values associated to each node. They predict the variation of the energy for a horizontal or vertical displacement of one pixel. The ordering of the nodes must follow that of getNodes(). If null is returned, the optimizer within the class OvusculeSnake2DKeeper will attempt to estimate the gradient by a finite-difference approach.

See Also:

IOvusculeSnake2D.getNodes()

getNodes

public OvusculeSnake2DNode[] getNodes()

Description copied from interface: IOvusculeSnake2D

This method provides an accessor to the snake-defining nodes.

Specified by:

getNodes in interface IOvusculeSnake2D

Returns:

Return an array of subpixel node locations. It is expected that the ordering of the nodes and the number of nodes does not change during the lifetime of the snake.

See Also:

IOvusculeSnake2D.setNodes(Catalano.Imaging.ActiveContour.Ovuscule.OvusculeSnake2DNode[])

getScales

public OvusculeSnake2DScale[] getScales()

Description copied from interface: IOvusculeSnake2D

The purpose of this method is to detemine what to draw on screen, given the current configuration of nodes. This method is called repeatedly during the user interaction provided by the method OvusculeSnake2DKeeper.interactAndOptimize(). The origin of coordinates lies at the top-left corner of the display parameter. Collectively, the array of scales forms the skin of the snake.

Specified by:

getScales in interface IOvusculeSnake2D

Returns:

Return an array of OvusculeSnake2DScale objects. Straight lines will be drawn between the apices of each polygon, in the specified color. It is not necessary to maintain a constant number of polygons in the array, or a constant number of apices in a given polygon.

See Also:

OvusculeSnake2DScale

setNodes

public void setNodes(OvusculeSnake2DNode[] node)

Description copied from interface: IOvusculeSnake2D

This method provides a mutator to the snake-defining nodes. It will be called repeatedly by the method OvusculeSnake2DKeeper.Optimize().

Specified by:

setNodes in interface IOvusculeSnake2D

Parameters:

node - Array of subpixel node locations.