File: RDFreeSASA.h

package info (click to toggle)
rdkit 201809.1%2Bdfsg-6
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 123,688 kB
  • sloc: cpp: 230,509; python: 70,501; java: 6,329; ansic: 5,427; sql: 1,899; yacc: 1,739; lex: 1,243; makefile: 445; xml: 229; fortran: 183; sh: 123; cs: 93
file content (123 lines) | stat: -rw-r--r-- 4,798 bytes parent folder | download
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
//  Copyright (c) 2016, Novartis Institutes for BioMedical Research Inc.
//  All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
//     * Redistributions of source code must retain the above copyright
//       notice, this list of conditions and the following disclaimer.
//     * Redistributions in binary form must reproduce the above
//       copyright notice, this list of conditions and the following
//       disclaimer in the documentation and/or other materials provided
//       with the distribution.
//     * Neither the name of Novartis Institutes for BioMedical Research Inc.
//       nor the names of its contributors may be used to endorse or promote
//       products derived from this software without specific prior written
//       permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//

#ifndef RDKIT_FREESASA_H
#define RDKIT_FREESASA_H

#include <GraphMol/RDKitBase.h>

namespace RDKit {
namespace common_properties {
namespace Atom {
extern const std::string
    SASA;  // Solvent Accessible Surface Area for atom- double
extern const std::string SASAClass;      // Class type, 0,1,2... etc
extern const std::string SASAClassName;  // Class name, Polar, APolar etc...
}
namespace Molecule {
extern const std::string
    SASA;  // Total Solvent Accessible Surface area for molecule;
}
}
}

namespace FreeSASA {
struct SASAOpts {
  enum Algorithm { LeeRichards = 0, ShrakeRupley = 1 };
  enum Classifier { Protor = 0, NACCESS = 1, OONS = 2 };
  enum Classes { Unclassified = 0, APolar = 1, Polar = 2 };

  Algorithm algorithm;
  Classifier classifier;
  SASAOpts() : algorithm(LeeRichards), classifier(Protor) {}
  SASAOpts(Algorithm alg, Classifier cls) : algorithm(alg), classifier(cls) {}
};

//! Classify atoms using standard freesaa classifiers
/*!
  Note:

    FreeSASA identified Classes end up in
  atom.getProp<int>(common_properties::Atom::SASAClassName)
    FreeSASA Class names end up in
  atom.getProp<string>(common_properties::Atom::SASAClassName)

    \param mol:    Molecule to analyze
    \param radii   output vector of radii where radii[idx] is the radius for
  atom with index idx
    \return false if no atoms could be classified
*/
bool classifyAtoms(RDKit::ROMol &mol, std::vector<double> &radii,
                   const FreeSASA::SASAOpts &opts = SASAOpts());

//! calculate the Solvent Accessible Surface Area using the FreeSASA library.
/*!
  SASA atom contribution data is stored in
  atom.getProp(common_properites::Atom::SASA);

  \param mol:    Molecule to analyze
  \param radii   vector of radii where radii[idx] is the radius for atom with
  index idx
                 These can be passed in or calculated with classifyAtoms for
  some proteins.
  \param confIdx specify the conformation [default -1]
  \param query    query atom to limit the number of atoms to the ones matching
  the query
                  precanned query atoms can be made with
  makeFreeSasaPolarAtomQuery and
                  makeFreeSasaAPolarAtomQuery for classified polar and apolar
  atoms respectively.

  \param opts     SASAOpts class specifying options.
  \return the requested solvent accessible surface area
*/
double calcSASA(const RDKit::ROMol &mol, const std::vector<double> &radii,
                int confIdx = -1, const RDKit::QueryAtom *query = NULL,
                const SASAOpts &opts = SASAOpts());

//! Make a query atom returning the FreeSASA supplied apolar atom classification
/*!
    These are atoms that have the "SASAClassName" property set to "Apolar"
    after calling classifyAtoms.

    \return QueryAtom pointer
*/
const RDKit::QueryAtom *makeFreeSasaAPolarAtomQuery();
//! Make a query atom returning the FreeSASA supplied polar atom classification
/*!
    These are atoms that have the "SASAClassName" property set to "Polar"
    after calling classifyAtoms.
    \return QueryAtom pointer
*/
const RDKit::QueryAtom *makeFreeSasaPolarAtomQuery();
}

#endif