org.openimaj.image.analysis.pyramid.gaussian

Class GaussianOctave<IMAGE extends Image<?,IMAGE> & SinglebandImageProcessor.Processable<Float,FImage,IMAGE>>

java.lang.Object

org.openimaj.image.analysis.pyramid.Octave<GaussianPyramidOptions<IMAGE>,GaussianPyramid<IMAGE>,IMAGE>

org.openimaj.image.analysis.pyramid.gaussian.GaussianOctave<IMAGE>

Type Parameters:

IMAGE - Type of underlying image

All Implemented Interfaces:

Iterable<IMAGE>

Direct Known Subclasses:

DoGOctave, FirstBandDoGOctave

public class GaussianOctave<IMAGE extends Image<?,IMAGE> & SinglebandImageProcessor.Processable<Float,FImage,IMAGE>>
extends Octave<GaussianPyramidOptions<IMAGE>,GaussianPyramid<IMAGE>,IMAGE>

This class represents a Gaussian octave in the style of Lowe's SIFT paper. The size of the image stack is controlled by the parameters scales and extraScaleSteps. The stack is constructed such that images[0] is the initial image, and images[scales] has twice the blur of the initial image. The sigma of the initial image is the parameter initialSigma. Octaves are Iterable for easy access to each of the images in turn.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Field Summary

Fields inherited from class org.openimaj.image.analysis.pyramid.Octave

images, octaveSize, options, parentPyramid

Constructor Summary

Constructors

Constructor and Description
GaussianOctave(GaussianPyramid<IMAGE> parent, float octaveSize) Construct a Gaussian octave with the provided parent Pyramid and octaveSize.

Method Summary

Modifier and Type	Method and Description
IMAGE	getNextOctaveImage() Get the image that starts the next octave.
void	process(IMAGE image) Populate the octave, starting from the provided image.

Methods inherited from class org.openimaj.image.analysis.pyramid.Octave

iterator

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

GaussianOctave

public GaussianOctave(GaussianPyramid<IMAGE> parent,
                      float octaveSize)

Construct a Gaussian octave with the provided parent Pyramid and octaveSize. The octaveSize parameter is the size of the octave's images compared to the original image used to construct the pyramid. An octaveSize of 1 means the same size as the original, 2 means half size, 4 means quarter size, etc.

Parameters:

parent - the pyramid that this octave belongs to

octaveSize - the size of the octave relative to the original image.

Method Detail

process

public void process(IMAGE image)

Description copied from class: Octave

Populate the octave, starting from the provided image.

Specified by:

process in class Octave<GaussianPyramidOptions<IMAGE extends Image<?,IMAGE> & SinglebandImageProcessor.Processable<Float,FImage,IMAGE>>,GaussianPyramid<IMAGE extends Image<?,IMAGE> & SinglebandImageProcessor.Processable<Float,FImage,IMAGE>>,IMAGE extends Image<?,IMAGE> & SinglebandImageProcessor.Processable<Float,FImage,IMAGE>>

Parameters:

image - the image.

getNextOctaveImage

public IMAGE getNextOctaveImage()

Description copied from class: Octave

Get the image that starts the next octave. Usually this is the image that has twice the sigma of the image used to initialise this octave.

Specified by:

getNextOctaveImage in class Octave<GaussianPyramidOptions<IMAGE extends Image<?,IMAGE> & SinglebandImageProcessor.Processable<Float,FImage,IMAGE>>,GaussianPyramid<IMAGE extends Image<?,IMAGE> & SinglebandImageProcessor.Processable<Float,FImage,IMAGE>>,IMAGE extends Image<?,IMAGE> & SinglebandImageProcessor.Processable<Float,FImage,IMAGE>>

Returns:

image image to start next octave.