Predictor.h

Go to the documentation of this file.

#ifndef _PREDICTOR_H
#define _PREDICTOR_H

#ifdef _PREDICTOR_EXPORT
# define _FEATURE_EXPORT
#endif
#ifdef _PREDICTOR_EXPORT_CLASS
# define _FEATURE_EXPORT_CLASS
#endif

#include "../Features/Feature.h"


#define PREDICTOR_EXPORT FEATURE_EXPORT
#define PREDICTOR_EXPORT_CLASS FEATURE_EXPORT_CLASS


#define EXPORT_PREDICTOR(predictor) \
 \
        static predictor *pred; \
        void INIT_EXPORT library_initialize() { pred = NULL; } \
        void FINI_EXPORT library_finalize() { if (pred != NULL) delete pred; } \
 \
        extern "C" PREDICTOR_EXPORT PredictorAlgorithm* getPredictor(predictorparams &params) { if (pred == NULL) pred = new predictor(params); return pred; }

typedef parametermap predictorparams;

typedef vector<unsigned long> contexttrajectory;

class PredictorAlgorithm {
        public:
                virtual ~PredictorAlgorithm() {}

                // add a single step to the model
                virtual void addContexts(const membershiplist* contexts, time_t time) = 0;
                virtual void addContext(unsigned long contextId, time_t time) = 0;

                // this is single-step prediction
                virtual unsigned long getNextContext() const = 0;
                virtual membershiplist getNextContexts() const = 0;

                // this is multi-step prediction
                // the parameters ars start and end (in number of time steps) of the trajectory that should be predicted
                // if no offset is necessary (the trajectory should be predicted from the current context), give 0 as start
                // the returned vector will have a length of (end - start)
                virtual contexttrajectory getContextTrajectory(unsigned int start, unsigned int end) const = 0;

                // this is a prediction for specific points in time
                // this will just return 0 if no prediction can be made (because no context is known until now)
                virtual unsigned long getContextAt(time_t time) const = 0;
                // this will return an empty list if no prediction can be made at all
                virtual membershiplist getContextsAt(time_t time) const = 0;

                virtual string serialize() const = 0;

                virtual void unserialize(string data) = 0;

#if _DEBUG_PREDICTORS

                virtual string toString() const = 0;
#endif
};

class Predictor : PredictorAlgorithm {
        private:
                PredictorAlgorithm *pa;

#if defined(_WIN32_WCE) || defined (_WINDOWS)
                HMODULE dll;
#else

                void* dlHandle;
#endif

        public:
                Predictor(const string &name, const predictorparams &params);
                virtual ~Predictor();

                virtual void addContexts(const membershiplist* contexts, time_t time) { pa->addContexts(contexts, time); }
                virtual void addContext(unsigned long contextId, time_t time) { pa->addContext(contextId, time); }
                virtual unsigned long getNextContext() const { return pa->getNextContext(); }
                virtual membershiplist getNextContexts() const { return pa->getNextContexts(); }
                virtual unsigned long getContextAt(time_t time) const { return pa->getContextAt(time); }
                virtual membershiplist getContextsAt(time_t time) const { return pa->getContextsAt(time); }
                virtual string serialize() const { return pa->serialize(); }
                virtual void unserialize(string data) { pa->unserialize(data); }
};

typedef PredictorAlgorithm* (*getPredictor_t) (const predictorparams &params);

#endif

---