source: trunk/lib/classifier/SupervisedClassifier.h @ 525

// $Id: SupervisedClassifier.h 525 2006-02-24 16:29:22Z markus $

#ifndef _theplu_classifier_supervisedclassifier_ 
#define _theplu_classifier_supervisedclassifier_ 

#include <cctype>

namespace theplu {

  namespace gslapi {
    class vector;
    class matrix;
  }

  namespace statistics {
    class Score;
  }


namespace classifier {  

  class DataLookup2D;
  class InputRanker;  class Target;


  ///
  /// Interface class for supervised classifiers
  ///

  class SupervisedClassifier
  {
   
  public:
    ///
    /// Constructor. Taking a vector of target values.
    ///
    SupervisedClassifier(const Target&, statistics::Score* =0, 
                         const size_t=0);
    
    ///
    /// Destructor
    ///
    virtual ~SupervisedClassifier() {};

    ///
    /// An interface for making new classifier objects. This function
    /// allows for specification at run-time of which classifier to
    /// instatiate (see 'Prototype' in Design Patterns).
    ///
    /// @Note Returns a dynamically allocated SupervisedClassifier, which has
    /// to be deleted by the caller to avoid memory leaks.
    ///
    virtual SupervisedClassifier* 
    make_classifier(const DataLookup2D&, const Target&) const =0;
    

    //
    // Train the classifier.
    //
    virtual bool train()=0;

    ///
    /// Generate output values for a data set
    ///
    virtual void predict(const DataLookup2D&, gslapi::matrix&) const =0;    

    
  protected:
    
    const Target& target_;
    statistics::Score* score_;
    classifier::InputRanker* ranker_;
    size_t nof_inputs_;
    bool trained_;
    
    
  };  
  
}} // of namespace classifier and namespace theplu

#endif