org.openimaj.image.pixel.sampling

Class QuadtreeSampler

java.lang.Object

org.openimaj.image.pixel.sampling.QuadtreeSampler

All Implemented Interfaces:

Iterable<Rectangle>

public class QuadtreeSampler
extends Object
implements Iterable<Rectangle>

A QuadtreeSampler provides an easy way of extracting sample patches from an image or other domain in both spatial and scale directions. The sampling regions returned by the sampler form a quadtree. At the first level there is a single sample region covering the entire region; at the second level, there are 4 non-overlapping sample regions, and so on.

Author:

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

Constructor Summary

Constructors

Constructor and Description
QuadtreeSampler(Rectangle r, int nLevels) Construct the sampler with the given parameters

Method Summary

Modifier and Type	Method and Description
List<Rectangle>	allRectangles() Get all the sampling regions
Iterator<Rectangle>	iterator()
Iterator<RectangleSampler>	levelIterator() Create an iterator over each of the levels in the pyramid.
List<List<Rectangle>>	levelRectangles() Get all the sampling regions grouped by level

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

QuadtreeSampler

public QuadtreeSampler(Rectangle r,
                       int nLevels)

Construct the sampler with the given parameters

Parameters:

r - the size of the initial sample region on the first level

nLevels - the number of levels to sample over

Method Detail

levelRectangles

public List<List<Rectangle>> levelRectangles()

Get all the sampling regions grouped by level

Returns:

the sampling regions grouped by level

allRectangles

public List<Rectangle> allRectangles()

Get all the sampling regions

Returns:

all the sampling regions

iterator

public Iterator<Rectangle> iterator()

Specified by:

iterator in interface Iterable<Rectangle>

levelIterator

public Iterator<RectangleSampler> levelIterator()

Create an iterator over each of the levels in the pyramid. Each level is represented by a RectangleSampler that describes the individual rectangles on a level.

Returns:

an iterator over the levels.