IMP logo
IMP Reference Guide  2.18.0
The Integrative Modeling Platform
ImproperSingletonScore.h
Go to the documentation of this file.
1 /**
2  * \file IMP/atom/ImproperSingletonScore.h
3  * \brief A score on the deviation of an improper angle from ideality.
4  *
5  * Copyright 2007-2022 IMP Inventors. All rights reserved.
6  */
7 
8 #ifndef IMPATOM_IMPROPER_SINGLETON_SCORE_H
9 #define IMPATOM_IMPROPER_SINGLETON_SCORE_H
10 
11 #include <IMP/atom/atom_config.h>
12 #include "bond_decorators.h"
13 #include <IMP/SingletonScore.h>
14 #include <IMP/UnaryFunction.h>
15 #include <IMP/Pointer.h>
16 
17 IMPATOM_BEGIN_NAMESPACE
18 
19 //! Score the improper dihedral based on a UnaryFunction,
20 /** This scores the improper dihedral using information stored in its
21  Dihedral decorator. The score is based on the difference between the
22  stored ideal improper angle and the actual angle and scaled by the
23  stiffness. That is stiffness * (improper_angle-ideal_value). The
24  difference is in radians between -pi and +pi; it is the shortest
25  distance from one angle to the other.
26 
27  Just as for regular dihedral angles, the improper angle is defined
28  as the angle between the plane in which the first three atoms lie and
29  the plane in which the last three atoms lie.
30 
31  \note The multiplicity of the Dihedral is not used.
32 
33  \see CHARMMTopology::add_impropers(), Dihedral.
34  */
35 class IMPATOMEXPORT ImproperSingletonScore : public SingletonScore {
37 
38  public:
39  //! Use f to penalize deviations in angle
41  virtual double evaluate_index(Model *m, ParticleIndex p,
42  DerivativeAccumulator *da) const override;
44  Model *m, const ParticleIndexes &pis) const override;
47  ;
48 };
49 
51 
52 IMPATOM_END_NAMESPACE
53 
54 #endif /* IMPATOM_IMPROPER_SINGLETON_SCORE_H */
#define IMP_OBJECT_METHODS(Name)
Define the basic things needed by any Object.
Definition: object_macros.h:25
Single variable function.
A more IMP-like version of the std::vector.
Definition: Vector.h:42
Contains decorators for a bond.
Class for storing model, its restraints, constraints, and particles.
Definition: Model.h:73
Abstract class for scoring object(s) of type ParticleIndex.
#define IMP_SINGLETON_SCORE_METHODS(Name)
A smart pointer to a ref-counted Object that is a class member.
Definition: Pointer.h:146
Score the improper dihedral based on a UnaryFunction,.
virtual ModelObjectsTemp do_get_inputs(Model *m, const ParticleIndexes &pis) const =0
Overload this method to specify the inputs.
Define SingletonScore.
#define IMP_OBJECTS(Name, PluralName)
Define the types for storing lists of object pointers.
Definition: object_macros.h:44
A nullptr-initialized pointer to an IMP Object.
virtual double evaluate_index(Model *m, ParticleIndex vt, DerivativeAccumulator *da) const =0
Compute the score and the derivative if needed.
Abstract single variable functor class for score functions.
Definition: UnaryFunction.h:25
Class for adding derivatives from restraints to the model.