IMP  2.1.1
The Integrative Modeling Platform
IMP::core::MonteCarloMover Class Referenceabstract

A base class for classes which perturb particles. More...

#include <IMP/core/MonteCarloMover.h>

+ Inheritance diagram for IMP::core::MonteCarloMover:

Public Member Functions

 MonteCarloMover (kernel::Model *m, std::string name)
 
void accept ()
 Roll back any changes made to the kernel::Particles.
 
MonteCarloMoverResult propose ()
 propose a modification More...
 
void reject ()
 Roll back any changes made to the kernel::Particles.
 
- Public Member Functions inherited from IMP::kernel::ModelObject
 ModelObject (kernel::Model *m, std::string name)
 
 ModelObject (std::string name)
 
virtual void do_set_model (kernel::Model *)
 
bool get_has_dependencies () const
 Return whether this object has dependencies computed.
 
bool get_has_required_score_states () const
 
ModelObjectsTemp get_inputs () const
 
ModelObjectsTemps get_interactions () const
 
bool get_is_part_of_model () const
 
Modelget_model () const
 
ModelObjectsTemp get_outputs () const
 
const ScoreStatesTempget_required_score_states () const
 
void set_has_dependencies (bool tf)
 
void set_has_required_score_states (bool tf)
 
virtual void set_model (kernel::Model *m)
 
- Public Member Functions inherited from IMP::base::Object
virtual void clear_caches ()
 
virtual void do_destroy ()
 
CheckLevel get_check_level () const
 
LogLevel get_log_level () const
 
virtual VersionInfo get_version_info () const
 Get information about the module and version of the object.
 
void set_check_level (CheckLevel l)
 
void set_log_level (LogLevel l)
 Set the logging level used in this object. More...
 
void set_was_used (bool tf) const
 
void show (std::ostream &out=std::cout) const
 
const std::string & get_name () const
 
void set_name (std::string name)
 
virtual std::string get_type_name () const
 

Protected Member Functions

virtual void do_accept ()
 Implement accept_proposed_move(), default impl is empty.
 
virtual kernel::ModelObjectsTemp do_get_outputs () const
 
virtual MonteCarloMoverResult do_propose ()=0
 Implement propose_move()
 
virtual void do_reject ()=0
 Implement reset_proposed_move()
 
- Protected Member Functions inherited from IMP::kernel::ModelObject
virtual ModelObjectsTemp do_get_inputs () const =0
 
virtual ModelObjectsTemps do_get_interactions () const
 
virtual void handle_set_has_required_score_states (bool)
 
- Protected Member Functions inherited from IMP::base::Object
 Object (std::string name)
 Construct an object with the given name. More...
 
 Object ()
 

Statistics

Movers keep track of some statistics as they are used.

unsigned int get_number_of_proposed () const
 
unsigned int get_number_of_accepted () const
 
void reset_statistics ()
 

Detailed Description

Mover objects propose a move, which can then be either accepted or rejected based on some criteria. For example, in a Monte-Carlo evaluation scheme.

All changed attributes should be optimizable, it is undefined behavior to try to optimize an attribute which is not.

The output particles (kernel::ModelObject::do_get_outputs()) are assummed to be equal to the inputs (kernel::ModelObject::do_get_inputs()).

Definition at line 41 of file MonteCarloMover.h.

Member Function Documentation

virtual kernel::ModelObjectsTemp IMP::core::MonteCarloMover::do_get_outputs ( ) const
protectedvirtual

Get any Particle, Container or other ModelObjects changed by this during evaluation. This is only useful for ScoreStates, at the moment.

Implements IMP::kernel::ModelObject.

Definition at line 103 of file MonteCarloMover.h.

+ Here is the call graph for this function:

MonteCarloMoverResult IMP::core::MonteCarloMover::propose ( )

The method should return the list of all particles that were actually moved and the ratio between the backward move probability and the forward move probability (for Metropolis-Hastings moves). Just return 1.0 for this value if you are not sure.

Definition at line 55 of file MonteCarloMover.h.

+ Here is the call graph for this function:


The documentation for this class was generated from the following file: