IMP  2.3.0
The Integrative Modeling Platform
IMP::kernel::TripletScore Class Reference

Abstract class for scoring object(s) of type ParticleTriplet. More...

#include <IMP/kernel/TripletScore.h>

+ Inheritance diagram for IMP::kernel::TripletScore:

Detailed Description

Abstract class for scoring object(s) of type ParticleTriplet.

TripletScore will evaluate the score and derivatives for passed object(s) of type ParticleTriplet.

Use in conjunction with various restraints such as IMP::core::TripletsRestraint or IMP::core::TripletRestraint. The restraints couple the score functions with appropariate lists of object(s) of type ParticleTriplet.

Implementers should check out IMP_TRIPLET_SCORE().

See Also
PredicateTripletRestraint

Definition at line 38 of file kernel/TripletScore.h.

Public Types

typedef kernel::ParticleTriplet Argument
 
typedef
kernel::ParticleIndexTriplet 
IndexArgument
 
typedef TripletModifier Modifier
 
typedef const
kernel::ParticleTriplet
PassArgument
 
typedef const
kernel::ParticleIndexTriplet
PassIndexArgument
 

Public Member Functions

 TripletScore (std::string name="TripletScore %1%")
 
Restraints create_current_decomposition (kernel::Model *m, const kernel::ParticleIndexTriplet &vt) const
 
virtual double evaluate (const kernel::ParticleTriplet &vt, DerivativeAccumulator *da) const
 Compute the score and the derivative if needed. More...
 
virtual double evaluate_if_good_index (kernel::Model *m, const kernel::ParticleIndexTriplet &vt, DerivativeAccumulator *da, double max) const
 Compute the score and the derivative if needed. More...
 
virtual double evaluate_if_good_indexes (kernel::Model *m, const kernel::ParticleIndexTriplets &o, DerivativeAccumulator *da, double max, unsigned int lower_bound, unsigned int upper_bound) const
 
virtual double evaluate_index (kernel::Model *m, const kernel::ParticleIndexTriplet &vt, DerivativeAccumulator *da) const
 Compute the score and the derivative if needed. More...
 
virtual double evaluate_indexes (kernel::Model *m, const kernel::ParticleIndexTriplets &o, DerivativeAccumulator *da, unsigned int lower_bound, unsigned int upper_bound) const
 Compute the score and the derivative if needed over a set. More...
 
- Public Member Functions inherited from IMP::kernel::ParticleInputs
virtual ContainersTemp get_input_containers (Particle *p) const
 
virtual ParticlesTemp get_input_particles (Particle *p) const
 
ModelObjectsTemp get_inputs (kernel::Model *m, const ParticleIndexes &pis) const
 
- Public Member Functions inherited from IMP::base::Object
virtual void clear_caches ()
 
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. More...
 
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 Restraints do_create_current_decomposition (kernel::Model *m, const kernel::ParticleIndexTriplet &vt) const
 
- Protected Member Functions inherited from IMP::kernel::ParticleInputs
virtual ModelObjectsTemp do_get_inputs (kernel::Model *m, const ParticleIndexes &pis) const
 
- Protected Member Functions inherited from IMP::base::Object
 Object (std::string name)
 Construct an object with the given name. More...
 
virtual void do_destroy ()
 

Member Function Documentation

Restraints IMP::kernel::TripletScore::create_current_decomposition ( kernel::Model m,
const kernel::ParticleIndexTriplet vt 
) const

Decompose this pair score acting on the pair into a set of restraints. The scoring function and derivatives should be equal to the current score. The defualt implementation just returns this object bound to the pair.

virtual Restraints IMP::kernel::TripletScore::do_create_current_decomposition ( kernel::Model m,
const kernel::ParticleIndexTriplet vt 
) const
protectedvirtual

Overide this to return your own decomposition.

Reimplemented in IMP::container::MinimumTripletScore.

virtual double IMP::kernel::TripletScore::evaluate ( const kernel::ParticleTriplet vt,
DerivativeAccumulator da 
) const
virtual

Compute the score and the derivative if needed.

Deprecated:
As of IMP release 2.1. See the IMP Deprecation Policy for more information about deprecation in IMP. Use the index-based evaluate instead.
virtual double IMP::kernel::TripletScore::evaluate_if_good_index ( kernel::Model m,
const kernel::ParticleIndexTriplet vt,
DerivativeAccumulator da,
double  max 
) const
virtual

Compute the score and the derivative if needed.

Compute the score and the derivative if needed as in evaluate_index(). but may terminate the computation early if the score is higher than max.

Returns
the score if score<= max or some arbitrary value > max otherwise.
virtual double IMP::kernel::TripletScore::evaluate_if_good_indexes ( kernel::Model m,
const kernel::ParticleIndexTriplets o,
DerivativeAccumulator da,
double  max,
unsigned int  lower_bound,
unsigned int  upper_bound 
) const
virtual

Compute the score and the derivative if needed as in evaluate_index(). but may terminate the computation early if the total score is higher than max.

Returns
the score if score<= max or some arbitrary value > max otherwise.

Implementations for these are provided by the IMP_TRIPLET_SCORE() macro.

Reimplemented in IMP::container::MinimumTripletScore, and IMP::core::AngleTripletScore.

virtual double IMP::kernel::TripletScore::evaluate_index ( kernel::Model m,
const kernel::ParticleIndexTriplet vt,
DerivativeAccumulator da 
) const
virtual

Compute the score and the derivative if needed.

evaluate the score and the derivative if needed over vt

Parameters
mthe model of vt
vtthe index in m of an object of type ParticleTriplet
daa derivative accumulator that reweighting computed derivatives. If nullptr, derivatives will not be computed

Reimplemented in IMP::container::MinimumTripletScore, and IMP::core::AngleTripletScore.

virtual double IMP::kernel::TripletScore::evaluate_indexes ( kernel::Model m,
const kernel::ParticleIndexTriplets o,
DerivativeAccumulator da,
unsigned int  lower_bound,
unsigned int  upper_bound 
) const
virtual

Compute the score and the derivative if needed over a set.

evaluate the score and the derivative if needed over a set of objects in o

Parameters
mthe model of o
oobjects of type ParticleTriplet, specified by index
daa derivative accumulator that reweighting computed derivatives. If nullptr, derivatives will not be computed
lower_boundindex of first item in o to evaluate
upper_boundindex of last item in o to evaluate
Note
Implementations for these are provided by the IMP_TRIPLET_SCORE() macro.

Reimplemented in IMP::container::MinimumTripletScore, and IMP::core::AngleTripletScore.


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