Chemical Data Processing Library C++ API - Version 1.4.0
BasicPharmacophore.hpp
Go to the documentation of this file.
1 /*
2  * BasicPharmacophore.hpp
3  *
4  * This file is part of the Chemical Data Processing Toolkit
5  *
6  * Copyright (C) 2003 Thomas Seidel <thomas.seidel@univie.ac.at>
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2 of the License, or (at your option) any later version.
12  *
13  * This library is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public License
19  * along with this library; see the file COPYING. If not, write to
20  * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21  * Boston, MA 02111-1307, USA.
22  */
23 
29 #ifndef CDPL_PHARM_BASICPHARMACOPHORE_HPP
30 #define CDPL_PHARM_BASICPHARMACOPHORE_HPP
31 
32 #include <vector>
33 
34 #include <boost/iterator/indirect_iterator.hpp>
35 
36 #include "CDPL/Pharm/APIPrefix.hpp"
39 #include "CDPL/Util/ObjectPool.hpp"
40 
41 
42 namespace CDPL
43 {
44 
45  namespace Pharm
46  {
47 
53  {
54 
56  typedef FeatureCache::SharedObjectPointer FeaturePointer;
57  typedef std::vector<FeaturePointer> FeatureList;
58 
59  public:
63  typedef std::shared_ptr<BasicPharmacophore> SharedPointer;
64 
68  typedef boost::indirect_iterator<FeatureList::iterator, BasicFeature> FeatureIterator;
69 
73  typedef boost::indirect_iterator<FeatureList::const_iterator, const BasicFeature> ConstFeatureIterator;
74 
79 
85 
91 
97  explicit BasicPharmacophore(const FeatureContainer& cntnr);
98 
105 
106  void clear();
107 
108  std::size_t getNumFeatures() const;
109 
115 
121 
127 
133 
134  const BasicFeature& getFeature(std::size_t idx) const;
135 
136  BasicFeature& getFeature(std::size_t idx);
137 
139 
140  void removeFeature(std::size_t idx);
141 
143 
144  bool containsFeature(const Feature& feature) const;
145 
146  std::size_t getFeatureIndex(const Feature& feature) const;
147 
158 
159  using Pharmacophore::operator=;
160 
171 
172  using Pharmacophore::operator+=;
173 
175 
181  void copy(const BasicPharmacophore& pharm);
182 
183  void copy(const Pharmacophore& pharm);
184 
185  void copy(const FeatureContainer& cntnr);
186 
193  void append(const BasicPharmacophore& pharm);
194 
195  void append(const Pharmacophore& pharm);
196 
197  void append(const FeatureContainer& cntnr);
198 
199  void remove(const FeatureContainer& cntnr);
200 
202 
203  private:
204  template <typename T>
205  void doCopy(const T& pharm);
206 
207  template <typename T>
208  void doAppend(const T& pharm);
209 
210  void clearFeatures();
211 
212  void renumberFeatures(std::size_t idx);
213 
214  BasicFeature* createFeature();
215 
216  static void destroyFeature(BasicFeature* feature);
217  static void clearFeature(BasicFeature& feature);
218 
219  FeatureCache featureCache;
220  FeatureList features;
221  };
222  } // namespace Pharm
223 } // namespace CDPL
224 
225 #endif // CDPL_PHARM_BASICPHARMACOPHORE_HPP
Definition of class CDPL::Pharm::BasicFeature.
Definition of class CDPL::Util::ObjectPool.
Definition of the preprocessor macro CDPL_PHARM_API.
#define CDPL_PHARM_API
Tells the compiler/linker which classes, functions and variables are part of the library API.
Definition of class CDPL::Pharm::Pharmacophore.
Pharm::Feature implementation owned by a Pharm::BasicPharmacophore parent.
Definition: BasicFeature.hpp:48
Concrete Pharm::Pharmacophore implementation that owns its features as Pharm::BasicFeature instances ...
Definition: BasicPharmacophore.hpp:53
void clear()
Removes all features and clears all properties of the pharmacophore.
ConstFeatureIterator getFeaturesBegin() const
Returns a constant iterator pointing to the beginning of the stored const Pharm::BasicFeature objects...
void copy(const FeatureContainer &cntnr)
Replaces the current set of pharmacophore features and properties by a copy of the features and prope...
ConstFeatureIterator getFeaturesEnd() const
Returns a constant iterator pointing to the end of the stored const Pharm::BasicFeature objects.
void remove(const FeatureContainer &cntnr)
Removes the pharmacophore features referenced by the feature container cntnr from this instance.
void removeFeature(std::size_t idx)
Removes the pharmacophore feature at the specified index.
boost::indirect_iterator< FeatureList::iterator, BasicFeature > FeatureIterator
A mutable random access iterator used to iterate over the stored Pharm::BasicFeature objects.
Definition: BasicPharmacophore.hpp:68
BasicPharmacophore(const BasicPharmacophore &pharm)
Constructs a BasicPharmacophore instance that is a copy of the pharmacophore pharm.
BasicPharmacophore(const FeatureContainer &cntnr)
Constructs a BasicPharmacophore instance with copies of the features provided by the feature containe...
bool containsFeature(const Feature &feature) const
Tells whether the specified feature instance is stored in this pharmacophore.
BasicPharmacophore & operator=(const BasicPharmacophore &pharm)
Replaces the current set of features by a copy of the features and properties of the pharmacophore ph...
BasicFeature & getFeature(std::size_t idx)
Returns a non-const reference to the pharmacophore feature at index idx.
BasicFeature & addFeature()
Creates a new pharmacophore feature and adds it to the pharmacophore.
void copy(const BasicPharmacophore &pharm)
Replaces the current set of features and properties by a copy of the features and properties of the p...
Pharmacophore::SharedPointer clone() const
Creates a copy of the current pharmacophore state.
boost::indirect_iterator< FeatureList::const_iterator, const BasicFeature > ConstFeatureIterator
A constant random access iterator used to iterate over the stored const Pharm::BasicFeature objects.
Definition: BasicPharmacophore.hpp:73
std::size_t getFeatureIndex(const Feature &feature) const
Returns the index of the specified feature in this pharmacophore.
std::size_t getNumFeatures() const
Returns the number of pharmacophore features.
std::shared_ptr< BasicPharmacophore > SharedPointer
A reference-counted smart pointer [SHPTR] for dynamically allocated BasicPharmacophore instances.
Definition: BasicPharmacophore.hpp:63
void copy(const Pharmacophore &pharm)
Replaces the current set of pharmacophore features and properties by a copy of the features and prope...
void orderFeatures(const FeatureCompareFunction &func)
Orders the stored features according to criteria implemented by the provided feature comparison funct...
void append(const BasicPharmacophore &pharm)
Extends the current set of features by a copy of the features in the pharmacophore pharm.
BasicPharmacophore & operator+=(const BasicPharmacophore &pharm)
Extends the current set of features by a copy of the features in the pharmacophore pharm.
FeatureIterator removeFeature(const FeatureIterator &it)
BasicPharmacophore()
Constructs an empty BasicPharmacophore instance.
void append(const FeatureContainer &cntnr)
Extends the current set of pharmacophore features by a copy of the features in the feature container ...
FeatureIterator getFeaturesEnd()
Returns a mutable iterator pointing to the end of the stored Pharm::BasicFeature objects.
FeatureIterator getFeaturesBegin()
Returns a mutable iterator pointing to the beginning of the stored Pharm::BasicFeature objects.
BasicPharmacophore(const Pharmacophore &pharm)
Constructs a BasicPharmacophore instance that is a copy of the pharmacophore pharm.
const BasicFeature & getFeature(std::size_t idx) const
Returns a const reference to the pharmacophore feature at index idx.
void append(const Pharmacophore &pharm)
Extends the current set of features by a copy of the features in the pharmacophore pharm.
Abstract base class for containers holding a sequence of Pharm::Feature objects with associated prope...
Definition: FeatureContainer.hpp:55
Abstract base class representing a single pharmacophore feature within a parent Pharm::Pharmacophore.
Definition: Feature.hpp:48
Abstract base class for mutable containers of Pharm::Feature instances representing a pharmacophore m...
Definition: Pharmacophore.hpp:52
std::shared_ptr< Pharmacophore > SharedPointer
A reference-counted smart pointer [SHPTR] for dynamically allocated Pharmacophore instances.
Definition: Pharmacophore.hpp:58
std::shared_ptr< ObjectType > SharedObjectPointer
A smart pointer to a borrowed object that returns the object to the pool on destruction.
Definition: ObjectPool.hpp:71
constexpr unsigned int T
Specifies Hydrogen (Tritium).
Definition: AtomType.hpp:67
std::function< bool(const Feature &, const Feature &)> FeatureCompareFunction
Generic wrapper class used to store a user-defined feature compare function.
Definition: FeatureCompareFunction.hpp:41
The namespace of the Chemical Data Processing Library.