File: Metal.h

package info (click to toggle)
rdkit 202503.1-4
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 220,160 kB
  • sloc: cpp: 399,240; python: 77,453; ansic: 25,517; java: 8,173; javascript: 4,005; sql: 2,389; yacc: 1,565; lex: 1,263; cs: 1,081; makefile: 578; xml: 229; fortran: 183; sh: 105
file content (96 lines) | stat: -rw-r--r-- 2,981 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
//
//  Copyright (C) 2018-2021 Susan H. Leung and other RDKit contributors
//
//   @@ All Rights Reserved @@
//  This file is part of the RDKit.
//  The contents are covered by the terms of the BSD license
//  which is included in the file license.txt, found at the root
//  of the RDKit source tree.
//
/*! \file Metal.h

        \brief Defines the MetalDisconnector class.

*/
#include <RDGeneral/export.h>
#ifndef RD_METAL_H
#define RD_METAL_H

#include <GraphMol/ROMol.h>

namespace RDKit {
class RWMol;
class ROMol;

namespace MolStandardize {
//! The MetalDisconnector class contains tools for disconnecting metal atoms
//! that are defined as covalently bonded to non-metals.
/*!

  <b>Notes:</b>
    -
*/

struct RDKIT_MOLSTANDARDIZE_EXPORT MetalDisconnectorOptions {
  bool splitGrignards = false;  // Whether to split Grignard-type complexes.
  bool splitAromaticC = false;  // Whether to split metal-aromatic C bonds.
  bool adjustCharges = true;    // Whether to adjust charges on ligand atoms.
  bool removeHapticDummies =
      false;  // Whether to remove the dummy atoms representing haptic bonds.
              // Such dummies are bonded to the metal with a bond
              // that has the _MolFileBondEndPts prop set.
};

class RDKIT_MOLSTANDARDIZE_EXPORT MetalDisconnector {
 public:
  MetalDisconnector(
      const MetalDisconnectorOptions &options = MetalDisconnectorOptions());
  MetalDisconnector(const MetalDisconnector &other);
  ~MetalDisconnector();

  ROMol *getMetalNof();  // {return dp_metal_nof;}
  ROMol *getMetalNon();  // {return dp_metal_non;}
  void setMetalNof(const ROMol &mol);
  void setMetalNon(const ROMol &mol);

  //! Break covalent bonds between metals and organic atoms under certain
  //! conditions.
  /*!
    <b>Notes:</b>
          The algorithm works as follows:
- Disconnect N, O, F from any metal.
- Disconnect other non-metals from transition metals + Al (but not Hg, Ga, Ge,
In, Sn, As, Tl, Pb, Bi, Po).
          - For every bond broken, adjust the charges of the begin and end atoms
accordingly.
  */
  ROMol *disconnect(const ROMol &mol);
  //! overload
  /// modifies the molecule in place
  void disconnect(RWMol &mol);
  void disconnectInPlace(RWMol &mol) { disconnect(mol); };

 private:
  struct NonMetal {
    int cutBonds{0};
    std::vector<int> boundMetalIndices;
  };
  int chargeAdjustment(const Atom *a, int order);
  ROMOL_SPTR dp_metal_nof;
  ROMOL_SPTR dp_metal_non;
  ROMOL_SPTR dp_metalDummy;

  const MetalDisconnectorOptions d_options;

  void adjust_charges(RDKit::RWMol &mol, std::map<int, NonMetal> &nonMetals,
                      std::map<int, int> &metalChargeExcess);
  // Remove any dummy atoms that are bonded to a metal and have the ENDPTS
  // prop.  These are assumed to marking a haptic bond from the aotms in
  // ENDPTS to the metal, e.g. in ferrocene.
  void remove_haptic_dummies(RDKit::RWMol &mol);

};  // class Metal

}  // namespace MolStandardize
}  // namespace RDKit
#endif