IMP logo
IMP Reference Guide  2.20.0
The Integrative Modeling Platform
ConnectivityRestraint.h
Go to the documentation of this file.
1 /**
2  * \file IMP/core/ConnectivityRestraint.h \brief Connectivity restraint.
3  *
4  * Restrict max distance between at least one pair of particles of any
5  * two distinct types.
6  *
7  * Copyright 2007-2022 IMP Inventors. All rights reserved.
8  *
9  */
10 
11 #ifndef IMPCORE_CONNECTIVITY_RESTRAINT_H
12 #define IMPCORE_CONNECTIVITY_RESTRAINT_H
13 
14 #include <IMP/core/core_config.h>
15 #include "DistanceRestraint.h"
16 
17 #include <IMP/SingletonContainer.h>
18 #include <IMP/Restraint.h>
19 #include <IMP/PairScore.h>
20 
21 IMPCORE_BEGIN_NAMESPACE
22 
23 //! Ensure that a set of particles remains connected with one another.
24 /** The restraint implements ambiguous connectivity. That is, it takes
25  several particles and ensures that they remain
26  connected, but allows how they are connected to change. If you wish
27  to restrain the connectivity of sets of
28  particles (e.g. each protein is represented using a set of balls)
29  use an appropriate PairScore which calls a Refiner (such
30  as ClosePairsPairScore).
31 
32  \include connectivity_restraint.py
33 
34  More precisely, the restraint scores by computing the minimum spanning
35  tree on the complete graph connecting all the particles. The edge
36  weights are given by the value of the PairScore for the two endpoints
37  of the edge.
38  */
39 class IMPCOREEXPORT ConnectivityRestraint : public Restraint {
42 
43  public:
44  //! Use the given PairScore
46 
47  //! Return the set of pairs which are connected by the restraint
48  /** This set of pairs reflects the current configuration at the time of
49  the get_connected_pairs() call, not the set at the time of the last
50  evaluate() call.
51  */
52  ParticleIndexPairs get_connected_index_pairs() const;
53 
54  //! Return the pair score used for scoring
55  PairScore *get_pair_score() const { return ps_; }
56 
58 
59  public:
61  override;
62  IMP::ModelObjectsTemp do_get_inputs() const override;
64  ;
65 };
66 
67 IMPCORE_END_NAMESPACE
68 
69 #endif /* IMPCORE_CONNECTIVITY_RESTRAINT_H */
Abstract class for scoring object(s) of type ParticleIndexPair.
Definition: PairScore.h:44
Distance restraint between two particles.
A container for Singletons.
#define IMP_OBJECT_METHODS(Name)
Define the basic things needed by any Object.
Definition: object_macros.h:25
virtual double unprotected_evaluate(DerivativeAccumulator *da) const
Return the unweighted score for the restraint.
virtual Restraints do_create_current_decomposition() const
Definition: Restraint.h:315
Define PairScore.
PairScore * get_pair_score() const
Return the pair score used for scoring.
Ensure that a set of particles remains connected with one another.
Abstract base class for all restraints.
virtual ModelObjectsTemp do_get_inputs() const =0
Class for adding derivatives from restraints to the model.
A restraint is a term in an IMP ScoringFunction.
Definition: Restraint.h:56