File: SmilesMolSupplier.cpp

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 (129 lines) | stat: -rw-r--r-- 4,985 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
124
125
126
127
128
129
// $Id$
//
//  Copyright (C) 2003-2008  Greg Landrum and Rational Discovery LLC
//
//   @@ 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.
//

#define NO_IMPORT_ARRAY
#include <RDBoost/python.h>
#include <RDBoost/iterator_next.h>
#include <string>

// ours
#include <GraphMol/FileParsers/MolSupplier.h>
#include <GraphMol/RDKitBase.h>
#include <RDGeneral/FileParseException.h>
#include "MolSupplier.h"

namespace python = boost::python;

namespace RDKit {

SmilesMolSupplier *SmilesSupplierFromText(
    std::string text, std::string delimiter = " ", int smilesColumn = 0,
    int nameColumn = 1, bool titleLine = true, bool sanitize = true) {
  auto *res = new SmilesMolSupplier();
  res->setData(text, delimiter, smilesColumn, nameColumn, titleLine, sanitize);
  return res;
}

std::string smilesMolSupplierClassDoc =
    "A class which supplies molecules from a text file.\n \
\n \
  Usage examples:\n \
\n \
    1) Lazy evaluation: the molecules are not constructed until we ask for them:\n \
       >>> suppl = SmilesMolSupplier('in.smi')\n \
       >>> for mol in suppl:\n \
       ...    mol.GetNumAtoms()\n \
\n \
    2) Lazy evaluation 2:\n \
       >>> suppl = SmilesMolSupplier('in.smi')\n \
       >>> mol1 = suppl.next()\n \
       >>> mol2 = suppl.next()\n \
       >>> suppl.reset()\n \
       >>> mol3 = suppl.next()\n \
       # mol3 and mol1 are the same: \
       >>> MolToSmiles(mol3)==MolToSmiles(mol1)\n \
\n \
    3) Random Access:  all molecules are constructed as soon as we ask for the\n \
       length:\n \
       >>> suppl = SmilesMolSupplier('in.smi')\n \
       >>> nMols = len(suppl)\n \
       >>> for i in range(nMols):\n \
       ...   suppl[i].GetNumAtoms()\n \
\n \
  If the input file has a title line and more than two columns (smiles and id), the\n\
  additional columns will be used to set properties on each molecule.  The properties\n\
  are accessible using the mol.GetProp(propName) method.\n\
\n";

std::string smsDocStr =
    "Constructor\n \n \
  ARGUMENTS: \n \
\n \
    - fileName: name of the file to be read\n \
\n \
    - delimiter: (optional) text delimiter (a string).  Defauts to ' '.\n \
\n \
    - smilesColumn: (optional) index of the column containing the SMILES\n \
      data.  Defaults to 0.\n \
\n \
    - nameColumn: (optional) index of the column containing molecule names.\n \
      Defaults to 1.\n \
\n \
    - titleLine: (optional) set this toggle if the file contains a title line.\n \
      Defaults to 1.\n \
\n \
    - sanitize: (optional) toggles sanitization of molecules as they are read.\n \
      Defaults to 1.\n \
\n";
struct smimolsup_wrap {
  static void wrap() {
    python::class_<SmilesMolSupplier, boost::noncopyable>(
        "SmilesMolSupplier", smilesMolSupplierClassDoc.c_str(),
        python::init<std::string, std::string, int, int, bool, bool>(
            (python::arg("data"), python::arg("delimiter") = " ",
             python::arg("smilesColumn") = 0, python::arg("nameColumn") = 1,
             python::arg("titleLine") = true, python::arg("sanitize") = true),
            smsDocStr.c_str()))
        .def(python::init<>())
        .def("__iter__",
             (SmilesMolSupplier * (*)(SmilesMolSupplier *)) & MolSupplIter,
             python::return_internal_reference<1>())
        .def(NEXT_METHOD, (ROMol * (*)(SmilesMolSupplier *)) & MolSupplNext,
             "Returns the next molecule in the file.  Raises _StopIteration_ "
             "on EOF.\n",
             python::return_value_policy<python::manage_new_object>())
        .def("__getitem__",
             (ROMol * (*)(SmilesMolSupplier *, int)) & MolSupplGetItem,
             python::return_value_policy<python::manage_new_object>())
        .def("reset", &SmilesMolSupplier::reset,
             "Resets our position in the file to the beginning.\n")
        .def("__len__", &SmilesMolSupplier::length)
        .def("SetData", &SmilesMolSupplier::setData,
             "Sets the text to be parsed",
             (python::arg("self"), python::arg("data"),
              python::arg("delimiter") = " ", python::arg("smilesColumn") = 0,
              python::arg("nameColumn") = 1, python::arg("titleLine") = true,
              python::arg("sanitize") = true))
        .def("GetItemText", &SmilesMolSupplier::getItemText,
             "returns the text for an item",
             (python::arg("self"), python::arg("index")));

    python::def(
        "SmilesMolSupplierFromText", SmilesSupplierFromText,
        (python::arg("text"), python::arg("delimiter") = " ",
         python::arg("smilesColumn") = 0, python::arg("nameColumn") = 1,
         python::arg("titleLine") = true, python::arg("sanitize") = true),
        python::return_value_policy<python::manage_new_object>());
  }
};
}

void wrap_smisupplier() { RDKit::smimolsup_wrap::wrap(); }