Sampler.h

Go to the documentation of this file.

/**
 *  \file Sampler.h     \brief Base class for all samplers.
 *
 *  Copyright 2007-2012 IMP Inventors. All rights reserved.
 *
 */

#ifndef IMPKERNEL_SAMPLER_H
#define IMPKERNEL_SAMPLER_H

#include "kernel_config.h"
#include "Model.h"
#include "Pointer.h"
#include "ConfigurationSet.h"
#include <IMP/base/ref_counted_macros.h>

IMP_BEGIN_NAMESPACE

//! Base class for all samplers.
/** A sampler takes a Model and searches for good configurations,
    given the optimizeable parameters and the scoring function in
    the Model and extra information that can be provided. Typically,
    the current configuration of the model is ignore.

    Typically a sampler works by using one or more Optimizer
    types to search for configurations which minimize the scoring
    function.
*/
class IMPEXPORT Sampler: public IMP::base::Object
{
  OwnerPointer<Model> model_;
  OwnerPointer<ScoringFunction> sf_;
 public:
  Sampler(Model *m, std::string name="Sampler %1%");

  ConfigurationSet *get_sample() const;

  ScoringFunction *get_scoring_function() const {
    return sf_;
  }
  void set_scoring_function(ScoringFunctionInput sf);

  Model *get_model() const {return model_;}

  // for the vtable
  IMP_REF_COUNTED_NONTRIVIAL_DESTRUCTOR(Sampler);
 protected:
  //! Subclasses should override this method
  virtual ConfigurationSet* do_sample() const=0;
};

IMP_OBJECTS(Sampler,Samplers);

IMP_END_NAMESPACE

#endif  /* IMPKERNEL_SAMPLER_H */