Chemical Data Processing Library C++ API - Version 1.4.0
HashCodeCalculator.hpp
Go to the documentation of this file.
1 /*
2  * HashCodeCalculator.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_CHEM_HASHCODECALCULATOR_HPP
30 #define CDPL_CHEM_HASHCODECALCULATOR_HPP
31 
32 #include <cstddef>
33 #include <cstdint>
34 #include <vector>
35 #include <functional>
36 
37 #include "CDPL/Chem/APIPrefix.hpp"
40 
41 
42 namespace CDPL
43 {
44 
45  namespace Chem
46  {
47 
48  class MolecularGraph;
49  class Atom;
50  class Bond;
51 
67  {
68 
69  public:
74  static constexpr unsigned int DEF_ATOM_PROPERTY_FLAGS =
78 
83  static constexpr unsigned int DEF_BOND_PROPERTY_FLAGS =
86 
91  {
92 
93  public:
109  DefAtomHashSeedFunctor(const HashCodeCalculator& calculator, unsigned int flags = DEF_ATOM_PROPERTY_FLAGS):
110  calculator(calculator), flags(flags) {}
111 
121  std::uint64_t operator()(const Atom& atom) const;
122 
123  private:
124  std::uint64_t getAtomTypeHashSeed(const Atom&) const;
125  std::uint64_t getAtomIsotopeHashSeed(const Atom&) const;
126  std::uint64_t getAtomChargeHashSeed(const Atom&) const;
127  std::uint64_t getAtomHCountHashSeed(const Atom&) const;
128  std::uint64_t getAtomConfigHashSeed(const Atom&) const;
129  std::uint64_t getAtomAromaticityHashSeed(const Atom&) const;
130 
131  const HashCodeCalculator& calculator;
132  unsigned int flags;
133  };
134 
139  {
140 
141  public:
154  DefBondHashSeedFunctor(unsigned int flags = DEF_BOND_PROPERTY_FLAGS):
155  flags(flags) {}
156 
166  std::uint64_t operator()(const Bond& bond) const;
167 
168  private:
169  std::uint64_t getBondTypeHashSeed(const Bond&) const;
170  std::uint64_t getBondConfigHashSeed(const Bond&) const;
171  std::uint64_t getBondTopologyHashSeed(const Bond&) const;
172 
173  unsigned int flags;
174  };
175 
184  typedef std::function<std::uint64_t(const Atom&)> AtomHashSeedFunction;
185 
194  typedef std::function<std::uint64_t(const Bond&)> BondHashSeedFunction;
195 
200 
210 
212 
214 
221 
228 
234  std::uint64_t calculate(const MolecularGraph& molgraph);
235 
240  std::uint64_t getResult() const;
241 
242  private:
243  void init(const MolecularGraph&);
244 
245  void calcAtomHashCodes();
246  void calcBondHashCodes();
247  void calcSHAHashCode();
248 
249  typedef std::vector<std::uint64_t> UInt64Array;
250  typedef std::vector<std::size_t> IndexList;
251 
252  const MolecularGraph* molGraph;
253  AtomHashSeedFunction atomHashSeedFunc;
254  BondHashSeedFunction bondHashSeedFunc;
255  UInt64Array atomHashCodes;
256  UInt64Array bondHashCodes;
257  UInt64Array tmpHashCodes1;
258  UInt64Array tmpHashCodes2;
259  UInt64Array shaInput;
260  std::uint8_t shaHashCode[20];
261  };
262  } // namespace Chem
263 } // namespace CDPL
264 
265 #endif // CDPL_CHEM_HASHCODECALCULATOR_HPP
Definition of constants in namespace CDPL::Chem::BondPropertyFlag.
Definition of the preprocessor macro CDPL_CHEM_API.
#define CDPL_CHEM_API
Tells the compiler/linker which classes, functions and variables are part of the library API.
Definition of constants in namespace CDPL::Chem::AtomPropertyFlag.
Abstract base class representing a chemical atom and its bonded neighborhood.
Definition: Atom.hpp:57
Abstract base class representing a chemical bond between two Chem::Atom instances.
Definition: Bond.hpp:54
The default functor for the generation of atom hash seeds.
Definition: HashCodeCalculator.hpp:91
std::uint64_t operator()(const Atom &atom) const
Generates an initial hash code value (seed) for the specified atom.
DefAtomHashSeedFunctor(const HashCodeCalculator &calculator, unsigned int flags=DEF_ATOM_PROPERTY_FLAGS)
Constructs the atom hash seed functor object for the specified set of atomic properties.
Definition: HashCodeCalculator.hpp:109
The default functor for the generation of bond hash seeds.
Definition: HashCodeCalculator.hpp:139
DefBondHashSeedFunctor(unsigned int flags=DEF_BOND_PROPERTY_FLAGS)
Constructs the bond hash seed functor object for the specified set of bond properties.
Definition: HashCodeCalculator.hpp:154
std::uint64_t operator()(const Bond &bond) const
Generates an initial hash code value (seed) for the specified bond.
Computes a 64-bit hash code that identifies a molecular graph up to a configurable set of atom and bo...
Definition: HashCodeCalculator.hpp:67
std::function< std::uint64_t(const Atom &)> AtomHashSeedFunction
Type of the generic functor class used to store user-defined functions or function objects for the ge...
Definition: HashCodeCalculator.hpp:184
void setBondHashSeedFunction(const BondHashSeedFunction &func)
Allows to specify a custom function for the generation of initial bond hash codes.
std::uint64_t calculate(const MolecularGraph &molgraph)
Calculates the hash code of the molecular graph molgraph.
void setAtomHashSeedFunction(const AtomHashSeedFunction &func)
Allows to specify a custom function for the generation of initial atom hash codes.
std::uint64_t getResult() const
Returns the result of the last hash code calculation.
HashCodeCalculator & operator=(const HashCodeCalculator &)=delete
HashCodeCalculator(const HashCodeCalculator &)=delete
HashCodeCalculator()
Constructs the HashCodeCalculator instance.
HashCodeCalculator(const MolecularGraph &molgraph)
Constructs the HashCodeCalculator instance and calculates the hash code of the molecular graph molgra...
std::function< std::uint64_t(const Bond &)> BondHashSeedFunction
Type of the generic functor class used to store user-defined functions or function objects for the ge...
Definition: HashCodeCalculator.hpp:194
Abstract base class for representations of a chemical structure as a graph of bonded atoms.
Definition: MolecularGraph.hpp:57
constexpr unsigned int FORMAL_CHARGE
Specifies the formal charge of an atom.
Definition: Chem/AtomPropertyFlag.hpp:73
constexpr unsigned int H_COUNT
Specifies the hydrogen count of an atom.
Definition: Chem/AtomPropertyFlag.hpp:78
constexpr unsigned int AROMATICITY
Specifies the membership of an atom in aromatic rings.
Definition: Chem/AtomPropertyFlag.hpp:93
constexpr unsigned int ISOTOPE
Specifies the isotopic mass of an atom.
Definition: Chem/AtomPropertyFlag.hpp:68
constexpr unsigned int CIP_CONFIGURATION
Specifies the CIP-configuration of a chiral atom.
Definition: Chem/AtomPropertyFlag.hpp:58
constexpr unsigned int TYPE
Specifies the generic type or element of an atom.
Definition: Chem/AtomPropertyFlag.hpp:63
constexpr unsigned int AROMATICITY
Specifies the membership of a bond in aromatic rings.
Definition: BondPropertyFlag.hpp:73
constexpr unsigned int ORDER
Specifies the order of a bond.
Definition: BondPropertyFlag.hpp:63
constexpr unsigned int CIP_CONFIGURATION
Specifies the CIP-configuration of a double bond.
Definition: BondPropertyFlag.hpp:58
constexpr unsigned int TOPOLOGY
Specifies the ring/chain topology of a bond.
Definition: BondPropertyFlag.hpp:68
The namespace of the Chemical Data Processing Library.