fixedsplitvalidationchain.java

著名的开源仿真软件yale

/*
 *  YALE - Yet Another Learning Environment
 *  Copyright (C) 2002, 2003
 *      Simon Fischer, Ralf Klinkenberg, Ingo Mierswa, 
 *          Katharina Morik, Oliver Ritthoff
 *      Artificial Intelligence Unit
 *      Computer Science Department
 *      University of Dortmund
 *      44221 Dortmund,  Germany
 *  email: [e-mail]
 *  web:   http://yale.cs.uni-dortmund.de/
 *
 *  This program is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU General Public License as 
 *  published by the Free Software Foundation; either version 2 of the
 *  License, or (at your option) any later version. 
 *
 *  This program is distributed in the hope that it will be useful, but
 *  WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 *  General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
 *  USA.
 */
package edu.udo.cs.yale.operator;

import edu.udo.cs.yale.operator.parameter.*;
import edu.udo.cs.yale.tools.LogService;
import edu.udo.cs.yale.example.ExampleSet;
import edu.udo.cs.yale.example.SplittedExampleSet;
import edu.udo.cs.yale.operator.learner.Model;
import edu.udo.cs.yale.operator.performance.PerformanceVector;
import edu.udo.cs.yale.operator.performance.PerformanceCriterion;

import java.util.List;

/** A FixedSplitValidationChain splits up the example set at a fixed point into a training and test set
 *  and evaluates the model. The examples are not shuffled.
 *
 *  The first inner operator must accept an
 *  {@link edu.udo.cs.yale.example.ExampleSet} while the second must accept an
 *  {@link edu.udo.cs.yale.example.ExampleSet} and the output of the first (which
 *  in most cases is a {@link edu.udo.cs.yale.operator.learner.Model}) and must produce
 *  a {@link edu.udo.cs.yale.operator.performance.PerformanceVector}.
 *
 *  @yale.xmlclass FixedSplitValidationChain
 *  @author simon, ingo
 *  @version $Id: FixedSplitValidationChain.java,v 2.7 2003/07/03 16:01:30 fischer Exp $
 */
public class FixedSplitValidationChain extends ValidationChain { 

    private int trainingSetSize;

    public IOObject[] apply() throws OperatorException {
	IOContainer input = getInput();
	SplittedExampleSet eSet = new SplittedExampleSet((ExampleSet)input.getInput(ExampleSet.class),
							 trainingSetSize);

	eSet.selectSingleSubset(0);
	learn(eSet);
	eSet.selectSingleSubset(1);
	IOContainer evalRes = evaluate(eSet);

	PerformanceVector pv = (PerformanceVector)evalRes.getInput(PerformanceVector.class);
	setResult(pv.getMainCriterion());
		
	return new IOObject[] { pv };
    }

    public void initApply() throws OperatorException {
	super.initApply();
	trainingSetSize = getParameterAsInt("training_set_size");
    }

    public List getParameterTypes() {
	List types = super.getParameterTypes();
	types.add(new ParameterTypeInt("training_set_size", "Absolute size of the training set.", 0, Integer.MAX_VALUE, 1));
	return types;
    }

    public int getNumberOfValidationSteps() {
	return 1;
    }
    
}