gov.sandia.cognition.learning.experiment
Class SupervisedLearnerValidationExperiment<InputType,OutputType,StatisticType,SummaryType>

java.lang.Object
  extended by gov.sandia.cognition.util.AbstractCloneableSerializable
      extended by gov.sandia.cognition.learning.experiment.AbstractLearningExperiment
          extended by gov.sandia.cognition.learning.experiment.AbstractValidationFoldExperiment<InputDataType,FoldDataType>
              extended by gov.sandia.cognition.learning.experiment.LearnerValidationExperiment<InputOutputPair<InputType,OutputType>,InputOutputPair<InputType,OutputType>,Evaluator<? super InputType,OutputType>,StatisticType,SummaryType>
                  extended by gov.sandia.cognition.learning.experiment.SupervisedLearnerValidationExperiment<InputType,OutputType,StatisticType,SummaryType>
Type Parameters:
InputType - The type of the input data for supervised learning.
OutputType - The type of the output data for supervised learning.
StatisticType - The type of the statistic generated by the performance evaluator on the learned object for each fold. It is created by passing the learned object plus the test data for the fold into the performance evaluator.
SummaryType - The type produced by the summarizer at the end of the experiment from a collection of the given statistics (one for each fold). This represents the performance result for the learning algorithm for the whole experiment.
All Implemented Interfaces:
LearningExperiment, PerformanceEvaluator<BatchLearner<? super Collection<? extends InputOutputPair<InputType,OutputType>>,? extends Evaluator<? super InputType,OutputType>>,Collection<? extends InputOutputPair<InputType,OutputType>>,SummaryType>, CloneableSerializable, Serializable, Cloneable

public class SupervisedLearnerValidationExperiment<InputType,OutputType,StatisticType,SummaryType>
extends LearnerValidationExperiment<InputOutputPair<InputType,OutputType>,InputOutputPair<InputType,OutputType>,Evaluator<? super InputType,OutputType>,StatisticType,SummaryType>

The SupervisedLearnerValidationExperiment class extends the LearnerValidationExperiment class to provide a easy way to create a learner validation experiment for supervised learning.

Since:
2.0
Author:
Justin Basilico
See Also:
Serialized Form

Field Summary
 
Fields inherited from class gov.sandia.cognition.learning.experiment.LearnerValidationExperiment
performanceEvaluator, statistics, summarizer, summary
 
Fields inherited from class gov.sandia.cognition.learning.experiment.AbstractValidationFoldExperiment
foldCreator, numTrials
 
Fields inherited from class gov.sandia.cognition.learning.experiment.AbstractLearningExperiment
listeners
 
Constructor Summary
SupervisedLearnerValidationExperiment()
          Creates a new instance of SupervisedLearnerValidationExperiment.
SupervisedLearnerValidationExperiment(ValidationFoldCreator<InputOutputPair<InputType,OutputType>,InputOutputPair<InputType,OutputType>> foldCreator, PerformanceEvaluator<? super Evaluator<? super InputType,? extends OutputType>,Collection<? extends InputOutputPair<InputType,OutputType>>,? extends StatisticType> performanceEvaluator, Summarizer<? super StatisticType,? extends SummaryType> summarizer)
          Creates a new instance of SupervisedLearnerValidationExperiment.
 
Method Summary
 
Methods inherited from class gov.sandia.cognition.learning.experiment.LearnerValidationExperiment
evaluate, evaluatePerformance, getLearner, getPerformanceEvaluator, getStatistics, getSummarizer, getSummary, runTrial, setLearner, setPerformanceEvaluator, setStatistics, setSummarizer, setSummary
 
Methods inherited from class gov.sandia.cognition.learning.experiment.AbstractValidationFoldExperiment
getFoldCreator, getNumTrials, runExperiment, setFoldCreator, setNumTrials
 
Methods inherited from class gov.sandia.cognition.learning.experiment.AbstractLearningExperiment
addListener, fireExperimentEnded, fireExperimentStarted, fireTrialEnded, fireTrialStarted, getListeners, removeListener, setListeners
 
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
 

Constructor Detail

SupervisedLearnerValidationExperiment

public SupervisedLearnerValidationExperiment()
Creates a new instance of SupervisedLearnerValidationExperiment.


SupervisedLearnerValidationExperiment

public SupervisedLearnerValidationExperiment(ValidationFoldCreator<InputOutputPair<InputType,OutputType>,InputOutputPair<InputType,OutputType>> foldCreator,
                                             PerformanceEvaluator<? super Evaluator<? super InputType,? extends OutputType>,Collection<? extends InputOutputPair<InputType,OutputType>>,? extends StatisticType> performanceEvaluator,
                                             Summarizer<? super StatisticType,? extends SummaryType> summarizer)
Creates a new instance of SupervisedLearnerValidationExperiment.

Parameters:
foldCreator - The object to use for creating the folds.
performanceEvaluator - The evaluator to use to compute the performance of the learned object on each fold.
summarizer - The summarizer for summarizing the result of the performance evaluator from all the folds.