org.openimaj.image.processing.convolution.filterbank

Class FilterBank

java.lang.Object

org.openimaj.image.processing.convolution.filterbank.FilterBank

All Implemented Interfaces:

ImageAnalyser<FImage>

Direct Known Subclasses:

LawsTextureBase, LeungMalikFilterBank, RootFilterSetFilterBank, SchmidFilterBank

public abstract class FilterBank
extends Object
implements ImageAnalyser<FImage>

A FilterBank is a set of convolution filters which can be applied to an image. The filterbank allows a response vector of the filter at each pixel in the image to be generated. Convolution is performed in the fourier domain for efficiency (the fft's of the filters are cached, and the fft of the image only has to be performed once for all convolutions)

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected FImage[]	responses

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FilterBank(FConvolution[] filters)

Method Summary

Modifier and Type	Method and Description
void	analyseImage(FImage in)
float[]	getResponse(int x, int y) Get the response vector for a given pixel.
FloatFV	getResponseFV(int x, int y) Get the response vector for a given pixel as a FloatFV.
FImage[]	getResponseImages() Get the response images for the image analysed with analyseImage(FImage).
float[][]	getResponses() Build an array of responses for every pixel.
FImage	renderFilters(int numFiltersX) Create an image to visualise the filters in the bank.

Methods inherited from class java.lang.Object

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

Field Detail

responses

protected FImage[] responses

Constructor Detail

FilterBank

protected FilterBank(FConvolution[] filters)

Method Detail

analyseImage

public void analyseImage(FImage in)

Specified by:

analyseImage in interface ImageAnalyser<FImage>

getResponseImages

public FImage[] getResponseImages()

Get the response images for the image analysed with analyseImage(FImage).

Returns:

the filter responses.

getResponse

public float[] getResponse(int x,
                           int y)

Get the response vector for a given pixel.

Parameters:

x - the x-ordinate

y - the y-ordinate

Returns:

the response vector

getResponseFV

public FloatFV getResponseFV(int x,
                             int y)

Get the response vector for a given pixel as a FloatFV.

Parameters:

x - the x-ordinate

y - the y-ordinate

Returns:

the response vector

renderFilters

public FImage renderFilters(int numFiltersX)

Create an image to visualise the filters in the bank. Assumes that all the filters are the same size. Filters are normalised and displayed in a grid.

Parameters:

numFiltersX - number of filters to display per row

Returns:

a visualisation of the filters

getResponses

public float[][] getResponses()

Build an array of responses for every pixel. The response for each pixel is added in scan order (left-right, top-bottom).

Returns:

the responses for each pixel.