gov.sandia.cognition.learning.algorithm.ensemble

Class BinaryCategorizerSelector<InputType>

java.lang.Object

gov.sandia.cognition.util.AbstractCloneableSerializable

gov.sandia.cognition.learning.algorithm.ensemble.BinaryCategorizerSelector<InputType>

Type Parameters:

InputType - The type of the input.

All Implemented Interfaces:

BatchLearner<java.util.Collection<? extends InputOutputPair<? extends InputType,java.lang.Boolean>>,BinaryCategorizer<? super InputType>>, SupervisedBatchLearner<InputType,java.lang.Boolean,BinaryCategorizer<? super InputType>>, CloneableSerializable, java.io.Serializable, java.lang.Cloneable

@CodeReview(reviewer="Kevin R. Dixon",
            date="2008-07-23",
            changesNeeded=false,
            comments={"Removed implements Serializable, since BatchLearner already does.","Otherwise, looks fine."})
public class BinaryCategorizerSelector<InputType>
extends AbstractCloneableSerializable
implements SupervisedBatchLearner<InputType,java.lang.Boolean,BinaryCategorizer<? super InputType>>

The BinaryCategorizerSelector class implements a "weak learner" meant for use in boosting algorithms that selects the best BinaryCategorizer from a pre-set list by picking the one with the best weighted error.

Since:

2.0

Author:

Justin Basilico

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Collection<BinaryCategorizer<? super InputType>>	categorizers The collection of categorizers to evaluate and select from.

Constructor Summary

Constructors

Constructor and Description
BinaryCategorizerSelector() Creates a new instance of BinaryCategorizerSelector.
BinaryCategorizerSelector(java.util.Collection<BinaryCategorizer<? super InputType>> categorizers) Creates a new instance of BinaryCategorizerSelector.

Method Summary

Modifier and Type	Method and Description
java.util.Collection<BinaryCategorizer<? super InputType>>	getCategorizers() Gets the collection of categorizers that the learner selects from.
BinaryCategorizer<? super InputType>	learn(java.util.Collection<? extends InputOutputPair<? extends InputType,java.lang.Boolean>> data) Selects the BinaryCategorizer from its list of categorizers that minimizes the weighted error on the given set of weighted input-output pairs.
void	setCategorizers(java.util.Collection<BinaryCategorizer<? super InputType>> categorizers) Gets the collection of categorizers that the learner selects from.

Methods inherited from class gov.sandia.cognition.util.AbstractCloneableSerializable

clone

Methods inherited from class java.lang.Object

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

Methods inherited from interface gov.sandia.cognition.util.CloneableSerializable

clone

Field Detail

categorizers

protected java.util.Collection<BinaryCategorizer<? super InputType>> categorizers

The collection of categorizers to evaluate and select from.

Constructor Detail

BinaryCategorizerSelector

public BinaryCategorizerSelector()

Creates a new instance of BinaryCategorizerSelector.

BinaryCategorizerSelector

public BinaryCategorizerSelector(java.util.Collection<BinaryCategorizer<? super InputType>> categorizers)

Creates a new instance of BinaryCategorizerSelector.

Parameters:

categorizers - The categorizers to use.

Method Detail

learn

public BinaryCategorizer<? super InputType> learn(java.util.Collection<? extends InputOutputPair<? extends InputType,java.lang.Boolean>> data)

Selects the BinaryCategorizer from its list of categorizers that minimizes the weighted error on the given set of weighted input-output pairs.

Specified by:

learn in interface BatchLearner<java.util.Collection<? extends InputOutputPair<? extends InputType,java.lang.Boolean>>,BinaryCategorizer<? super InputType>>

Parameters:

data - The set of weighted input-output pairs to use to select the best categorizer.

Returns:

The BinaryCategorizer from its list of categorizers that minimizes the weighted error on the given data.

getCategorizers

public java.util.Collection<BinaryCategorizer<? super InputType>> getCategorizers()

Gets the collection of categorizers that the learner selects from.

Returns:

The collection of categorizers that the learner selects from.

setCategorizers

public void setCategorizers(java.util.Collection<BinaryCategorizer<? super InputType>> categorizers)

Gets the collection of categorizers that the learner selects from.

Parameters:

categorizers - The collection of categorizers that the learner selects from.