org.openimaj.image.feature.global

Class RuleOfThirds

java.lang.Object

org.openimaj.image.feature.global.RuleOfThirds

All Implemented Interfaces:

FeatureVectorProvider<DoubleFV>, ImageAnalyser<MBFImage>

@Reference(type=Inproceedings,
           author={"Che-Hua Yeh","Yuan-Chen Ho","Brian A. Barsky","Ming Ouhyoung"},
           title="Personalized Photograph Ranking and Selection System",
           year="2010",
           booktitle="Proceedings of ACM Multimedia",
           pages={"211","220"},
           month="October",
           customData={"location","Florence, Italy"})
public class RuleOfThirds
extends Object
implements ImageAnalyser<MBFImage>, FeatureVectorProvider<DoubleFV>

Implementation of the rule-of-thirds algorithm described by Yeh et al.

I've assumed that the distances to the power-points should be normalized with respect to the image size - this isn't explicit in the paper, but given that the sigma of the gaussian is fixed, it seems likely...

Author:

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

Constructor Summary

Constructors

Constructor and Description
RuleOfThirds() Construct a new RuleOfThirds with the default settings for the YehSaliency algorithm.
RuleOfThirds(float saliencySigma, float segmenterSigma, float k, int minSize) Construct a new RuleOfThirds with the given values for the YehSaliency algorithm.

Method Summary

Modifier and Type	Method and Description
void	analyseImage(MBFImage image) Analyse an image.
DoubleFV	getFeatureVector() Get the FeatureVector associated with this object.

Methods inherited from class java.lang.Object

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

Constructor Detail

RuleOfThirds

public RuleOfThirds()

Construct a new RuleOfThirds with the default settings for the YehSaliency algorithm.

RuleOfThirds

public RuleOfThirds(float saliencySigma,
                    float segmenterSigma,
                    float k,
                    int minSize)

Construct a new RuleOfThirds with the given values for the YehSaliency algorithm.

Parameters:

saliencySigma - smoothing for the AchantaSaliency class

segmenterSigma - smoothing for FelzenszwalbHuttenlocherSegmenter.

k - k value for FelzenszwalbHuttenlocherSegmenter.

minSize - minimum region size for FelzenszwalbHuttenlocherSegmenter.

Method Detail

getFeatureVector

public DoubleFV getFeatureVector()

Description copied from interface: FeatureVectorProvider

Get the FeatureVector associated with this object.

Specified by:

getFeatureVector in interface FeatureVectorProvider<DoubleFV>

Returns:

the feature vector.

analyseImage

public void analyseImage(MBFImage image)

Description copied from interface: ImageAnalyser

Analyse an image.

Specified by:

analyseImage in interface ImageAnalyser<MBFImage>

Parameters:

image - The image to process in place.