AlpsModel.h

Go to the documentation of this file.

/*===========================================================================*
 * This file is part of the Abstract Library for Parallel Search (ALPS).     *
 *                                                                           *
 * ALPS is distributed under the Eclipse Public License as part of the       *
 * COIN-OR repository (http://www.coin-or.org).                              *
 *                                                                           *
 * Authors:                                                                  *
 *                                                                           *
 *          Yan Xu, Lehigh University                                        *
 *          Ted Ralphs, Lehigh University                                    *
 *                                                                           *
 * Conceptual Design:                                                        *
 *                                                                           *
 *          Yan Xu, Lehigh University                                        *
 *          Ted Ralphs, Lehigh University                                    *
 *          Laszlo Ladanyi, IBM T.J. Watson Research Center                  *
 *          Matthew Saltzman, Clemson University                             *
 *                                                                           * 
 *                                                                           *
 * Copyright (C) 2001-2013, Lehigh University, Yan Xu, and Ted Ralphs.       *
 *===========================================================================*/

#ifndef AlpsModel_h
#define AlpsModel_h

#include <string>

#include "CoinError.hpp"

#include "AlpsKnowledge.h"
#include "AlpsTreeNode.h"
#include "AlpsParams.h"

class AlpsKnowledgeBroker;

class AlpsModel : public AlpsKnowledge {

 private:

    AlpsModel(const AlpsModel&);
    AlpsModel& operator=(const AlpsModel&);

 protected:

    AlpsKnowledgeBroker *broker_;
    
    std::string dataFile_; 

    AlpsParams * AlpsPar_;

 public:

    AlpsModel() :
        broker_(NULL), 
        AlpsPar_(new AlpsParams) { setType(AlpsKnowledgeTypeModel); }

    virtual ~AlpsModel() { delete AlpsPar_; }

    AlpsKnowledgeBroker *getKnowledgeBroker() { return broker_; }

    void setKnowledgeBroker(AlpsKnowledgeBroker *b) { broker_ = b; }

    inline std::string getDataFile() const { return dataFile_; }

    inline void setDataFile(std::string infile) { dataFile_ = infile; }
    
    AlpsParams * AlpsPar() { return AlpsPar_; }

    virtual void readInstance(const char* dateFile) {
        throw CoinError("readInstance() is not defined.", "readData",
                        "AlpsModel");
    } 

    virtual void readParameters(const int argnum, const char * const * arglist);

    void writeParameters(std::ostream& outstream) const;

    virtual bool setupSelf() { return true; }

    virtual void preprocess() {}

    virtual void postprocess() {}
    
    virtual AlpsTreeNode * createRoot() {
        throw CoinError("createRoot is not defined.", "createRoot",
                        "AlpsModel");
    } 

    virtual void modelLog() {}

    virtual void nodeLog(AlpsTreeNode *node, bool force);

    virtual bool fathomAllNodes() { return false; }
    
    //------------------------------------------------------
    // For parallel.
    //------------------------------------------------------
    
    AlpsReturnStatus encodeAlps(AlpsEncoded *encoded) const;

    AlpsReturnStatus decodeAlps(AlpsEncoded &encoded);
    
    virtual void decodeToSelf(AlpsEncoded& encoded) {}
    
    virtual void registerKnowledge() { /* Default does nothing */ }

    virtual void sendGeneratedKnowledge() { /* Default does nothing */ }

    virtual void receiveGeneratedKnowledge() { /* Default does nothing */ }

    virtual AlpsEncoded* packSharedKnowlege() {
        /* Default does nothing */ 
        AlpsEncoded* encoded = NULL;
        return encoded;
    }
    
    virtual void unpackSharedKnowledge(AlpsEncoded&) 
    { /* Default does nothing */ }
};
#endif