IMP  2.1.0
The Integrative Modeling Platform
IMP::kernel::OptimizerState Class Reference

Shared optimizer state that is invoked upon commitment of new coordinates. More...

#include <IMP/kernel/OptimizerState.h>

+ Inheritance diagram for IMP::kernel::OptimizerState:

Public Member Functions

 OptimizerState (kernel::Model *m, std::string name)
 
 OptimizerState (std::string name="OptimizerState %1%")
 
unsigned int get_number_of_updates () const
 Return the number of times update has been called.
 
Optimizerget_optimizer () const
 
unsigned int get_period () const
 
virtual void reset ()
 
virtual void set_is_optimizing (bool)
 
void set_number_of_updates (unsigned int n)
 Set the counter.
 
void set_period (unsigned int p)
 
virtual void update ()
 Called when the Optimizer accepts a new conformation. More...
 
void update_always ()
 
- 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 ModelObjectsTemp do_get_inputs () const
 
virtual ModelObjectsTemp do_get_outputs () const
 
virtual void do_set_is_optimizing (bool)
 
virtual void do_update (unsigned int)
 
- Protected Member Functions inherited from IMP::kernel::ModelObject
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 ()
 

Detailed Description

An OptimizerState update() method is called every time that an owning Optimizer commits to a new set of coordinates. The update() method, in turn, invokes do_update(), which can be overridden by inheriting classes.

Note
An OptimizerState may have periodicity by its set_period() method
An OptimizerState is added to an Optimizer object by calling Optimizer::add_optimizer_state().
Optimizer states may change the values of particle attributes. However, changes to whether an attribute is optimized or not may not be picked up by the Optimizer until the next call to optimize.
When logging is VERBOSE, state should print enough information in evaluate to reproduce the the entire flow of data in update. When logging is TERSE the restraint should print out only a constant number of lines per update call.

Definition at line 43 of file kernel/OptimizerState.h.

Constructor & Destructor Documentation

IMP::kernel::OptimizerState::OptimizerState ( kernel::Model m,
std::string  name 
)

constructs an optimizer state whose update() method is invoked every time that a set of model coordinates is committed by an optimizer.

Parameters
mthe model to which this optimizer state is associated
namethe name of the object
Note
An optimizer state may become periodic via its set_period() method.
IMP::kernel::OptimizerState::OptimizerState ( std::string  name = "OptimizerState %1%")
Deprecated:
As of IMP release 2.1. See the IMP Deprecation Policy for more information about deprecation in IMP. Use the constructor that takes a Model.

Member Function Documentation

virtual ModelObjectsTemp IMP::kernel::OptimizerState::do_get_inputs ( ) const
protectedvirtual

Get any Particle, Container or other ModelObjects read by this during evaluation. If you read everything in a container, you can just return that container.

Implements IMP::kernel::ModelObject.

Reimplemented in IMP::atom::WritePDBOptimizerState.

Definition at line 127 of file kernel/OptimizerState.h.

virtual ModelObjectsTemp IMP::kernel::OptimizerState::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 130 of file kernel/OptimizerState.h.

unsigned int IMP::kernel::OptimizerState::get_period ( ) const
Returns
the periodicity of the optimizer (how many calls to update() are required to invoke do_update()

Definition at line 101 of file kernel/OptimizerState.h.

virtual void IMP::kernel::OptimizerState::reset ( )
virtual

Reset the phase to 0 and set the call number to 0 too.

virtual void IMP::kernel::OptimizerState::set_is_optimizing ( bool  )
virtual

Called with true at the beginning of an optimizing run and with false at the end.

Note
Do not override, override do_set_is_optimizing() instead.
void IMP::kernel::OptimizerState::set_period ( unsigned int  p)

Causes update() invoke do_update() only every p calls to update() instead of the default p=1. Note that this periodicity is shared by all optimizers that own this OptimizerState object.

Parameters
pperiodicity
virtual void IMP::kernel::OptimizerState::update ( )
virtual

This method is called by owning optimizers every time they commit. However, if set_period(p) was invoked, it calls do_update() only every p times it is called (by any optimizer).

Note
Overriding this method is deprecated, override do_update() instead.

Reimplemented in IMP::container::PairsOptimizerState, IMP::container::QuadsOptimizerState, IMP::container::SingletonsOptimizerState, IMP::container::TripletsOptimizerState, IMP::container::EventPairsOptimizerState, IMP::container::EventQuadsOptimizerState, IMP::container::EventSingletonsOptimizerState, and IMP::container::EventTripletsOptimizerState.

void IMP::kernel::OptimizerState::update_always ( )

Force the optimizer state to perform its action now, ignoring the phase.


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