Chemical Data Processing Library C++ API - Version 1.4.0
Pharmacophore.hpp
Go to the documentation of this file.
1 /*
2  * Pharmacophore.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_PHARMACOPHORE_HPP
30 #define CDPL_PHARM_PHARMACOPHORE_HPP
31 
32 #include <memory>
33 
34 #include "CDPL/Pharm/APIPrefix.hpp"
36 
37 
38 namespace CDPL
39 {
40 
41  namespace Pharm
42  {
43 
53  {
54 
55  public:
59  typedef std::shared_ptr<Pharmacophore> SharedPointer;
60 
65 
70 
74  virtual ~Pharmacophore() {}
75 
78 
82  virtual void clear() = 0;
83 
88  virtual std::size_t getNumFeatures() const = 0;
89 
96  virtual const Feature& getFeature(std::size_t idx) const = 0;
97 
104  virtual Feature& getFeature(std::size_t idx) = 0;
105 
110  virtual Feature& addFeature() = 0;
111 
117  virtual void removeFeature(std::size_t idx) = 0;
118 
127 
134  virtual std::size_t getFeatureIndex(const Feature& feature) const = 0;
135 
141  virtual bool containsFeature(const Feature& feature) const = 0;
142 
148  virtual void copy(const Pharmacophore& pharm) = 0;
149 
155  virtual void copy(const FeatureContainer& cntnr) = 0;
156 
163  virtual void append(const Pharmacophore& pharm) = 0;
164 
171  virtual void append(const FeatureContainer& cntnr) = 0;
172 
178  virtual void remove(const FeatureContainer& cntnr) = 0;
179 
184  virtual SharedPointer clone() const = 0;
185 
196 
207 
218 
229 
239  };
240  } // namespace Pharm
241 } // namespace CDPL
242 
243 #endif // CDPL_PHARM_PHARMACOPHORE_HPP
Definition of class CDPL::Pharm::FeatureContainer.
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.
Abstract base class for containers holding a sequence of Pharm::Feature objects with associated prope...
Definition: FeatureContainer.hpp:55
ConstFeatureIterator getFeaturesEnd() const
Returns a constant iterator pointing to the end of the stored const Pharm::Feature objects.
ConstFeatureIterator getFeaturesBegin() const
Returns a constant iterator pointing to the beginning of the stored const Pharm::Feature objects.
std::shared_ptr< FeatureContainer > SharedPointer
A reference-counted smart pointer [SHPTR] for dynamically allocated FeatureContainer instances.
Definition: FeatureContainer.hpp:58
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:53
virtual void copy(const FeatureContainer &cntnr)=0
Replaces the current set of pharmacophore features and properties by a copy of the features and prope...
Pharmacophore & operator-=(const FeatureContainer &cntnr)
Removes the pharmacophore features referenced by the feature container cntnr from this Pharmacophore ...
virtual std::size_t getNumFeatures() const =0
Returns the number of pharmacophore features.
Pharmacophore & operator+=(const FeatureContainer &cntnr)
Extends the current set of pharmacophore features by a copy of the features in the feature container ...
virtual Feature & addFeature()=0
Creates a new pharmacophore feature and adds it to the pharmacophore.
std::shared_ptr< Pharmacophore > SharedPointer
A reference-counted smart pointer [SHPTR] for dynamically allocated Pharmacophore instances.
Definition: Pharmacophore.hpp:59
virtual const Feature & getFeature(std::size_t idx) const =0
Returns a const reference to the pharmacophore feature at index idx.
virtual void append(const Pharmacophore &pharm)=0
Extends the current set of pharmacophore features by a copy of the features in the pharmacophore phar...
FeatureContainer::FeatureIterator FeatureIterator
A mutable random access iterator used to iterate over the stored Pharm::Feature objects.
Definition: Pharmacophore.hpp:69
Pharmacophore & operator=(const FeatureContainer &cntnr)
Replaces the current set of pharmacophore features and properties by a copy of the features and prope...
virtual std::size_t getFeatureIndex(const Feature &feature) const =0
Returns the index of the specified feature in this pharmacophore.
virtual Feature & getFeature(std::size_t idx)=0
Returns a non-const reference to the pharmacophore feature at index idx.
virtual ~Pharmacophore()
Virtual destructor.
Definition: Pharmacophore.hpp:74
virtual SharedPointer clone() const =0
Creates a copy of the current pharmacophore state.
virtual void clear()=0
Removes all features and clears all properties of the pharmacophore.
virtual void append(const FeatureContainer &cntnr)=0
Extends the current set of pharmacophore features by a copy of the features in the feature container ...
FeatureIterator removeFeature(const FeatureIterator &it)
Removes the pharmacophore feature specified by the iterator it.
virtual void copy(const Pharmacophore &pharm)=0
Replaces the current set of pharmacophore features and properties by a copy of the features and prope...
FeatureContainer::ConstFeatureIterator ConstFeatureIterator
A constant random access iterator used to iterate over the stored const Pharm::Feature objects.
Definition: Pharmacophore.hpp:64
virtual void removeFeature(std::size_t idx)=0
Removes the pharmacophore feature at the specified index.
virtual bool containsFeature(const Feature &feature) const =0
Tells whether the specified feature instance is stored in this pharmacophore.
virtual void remove(const FeatureContainer &cntnr)=0
Removes the pharmacophore features referenced by the feature container cntnr from this Pharmacophore ...
Pharmacophore & operator=(const Pharmacophore &pharm)
Replaces the current set of pharmacophore features and properties by a copy of the features and prope...
Pharmacophore & operator+=(const Pharmacophore &pharm)
Extends the current set of pharmacophore features by a copy of the features in the pharmacophore phar...
STL compatible random access iterator for container elements accessible by index.
Definition: IndexedElementIterator.hpp:125
The namespace of the Chemical Data Processing Library.