org.openimaj.ml.annotation.basic

Class IndependentPriorRandomAnnotator<OBJECT,ANNOTATION>

java.lang.Object

org.openimaj.ml.annotation.AbstractAnnotator<OBJECT,ANNOTATION>

org.openimaj.ml.annotation.BatchAnnotator<OBJECT,ANNOTATION>

org.openimaj.ml.annotation.basic.IndependentPriorRandomAnnotator<OBJECT,ANNOTATION>

Type Parameters:

OBJECT - Type of object being annotated

ANNOTATION - Type of annotation.

All Implemented Interfaces:

Classifier<ANNOTATION,OBJECT>, Annotator<OBJECT,ANNOTATION>, BatchTrainer<Annotated<OBJECT,ANNOTATION>>

public class IndependentPriorRandomAnnotator<OBJECT,ANNOTATION>
extends BatchAnnotator<OBJECT,ANNOTATION>

Annotator that randomly assigns annotations, but takes account of the prior probability of each annotation based on the proportion of times it occurred in training. Annotations that occurred less in training are less likely to be picked. The number of annotations produced is set by the type of NumAnnotationsChooser used.

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected cern.jet.random.EmpiricalWalker	annotationProbability
protected List<ANNOTATION>	annotations
protected NumAnnotationsChooser	numAnnotations

Constructor Summary

Constructors

Constructor and Description
IndependentPriorRandomAnnotator(NumAnnotationsChooser chooser) Construct with the given NumAnnotationsChooser to determine how many annotations are produced by calls to annotate(Object).

Method Summary

Modifier and Type	Method and Description
List<ScoredAnnotation<ANNOTATION>>	annotate(OBJECT image) Generate annotations for the given object.
Set<ANNOTATION>	getAnnotations()
void	train(List<? extends Annotated<OBJECT,ANNOTATION>> data) Train the object with the given data.

Methods inherited from class org.openimaj.ml.annotation.BatchAnnotator

train

Methods inherited from class org.openimaj.ml.annotation.AbstractAnnotator

classify

Methods inherited from class java.lang.Object

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

Field Detail

annotations

protected List<ANNOTATION> annotations

numAnnotations

protected NumAnnotationsChooser numAnnotations

annotationProbability

protected cern.jet.random.EmpiricalWalker annotationProbability

Constructor Detail

IndependentPriorRandomAnnotator

public IndependentPriorRandomAnnotator(NumAnnotationsChooser chooser)

Construct with the given NumAnnotationsChooser to determine how many annotations are produced by calls to annotate(Object).

Parameters:

chooser - the NumAnnotationsChooser to use.

Method Detail

train

public void train(List<? extends Annotated<OBJECT,ANNOTATION>> data)

Description copied from interface: BatchTrainer

Train the object with the given data. BatchTrainers should reset the underlying model everytime this method is called.

Parameters:

data - the training data

annotate

public List<ScoredAnnotation<ANNOTATION>> annotate(OBJECT image)

Description copied from interface: Annotator

Generate annotations for the given object.

Parameters:

image - the image

Returns:

generated annotations

getAnnotations

public Set<ANNOTATION> getAnnotations()

Returns:

a Set of all annotations this Annotator knows about