mirror of
https://github.com/rdkit/rdkit.git
synced 2026-06-04 21:54:27 +08:00
7d1e662bc7
* string_view props API * wip * fix leak * add string_view to swig * fix comment * add backwards incompatibilty note * fix rebase issue --------- Co-authored-by: Greg Landrum <greg.landrum@gmail.com>
352 lines
15 KiB
C++
352 lines
15 KiB
C++
//
|
|
// Copyright (C) 2019 Greg Landrum
|
|
//
|
|
// @@ 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 <boost/python.hpp>
|
|
#include <string>
|
|
|
|
// ours
|
|
#include <GraphMol/RDKitBase.h>
|
|
#include <GraphMol/SubstanceGroup.h>
|
|
#include <RDBoost/Wrap.h>
|
|
#include "props.hpp"
|
|
|
|
namespace python = boost::python;
|
|
|
|
namespace RDKit {
|
|
|
|
namespace {
|
|
|
|
SubstanceGroup *getMolSubstanceGroupWithIdx(ROMol &mol, unsigned int idx) {
|
|
auto &sgs = getSubstanceGroups(mol);
|
|
if (idx >= sgs.size()) {
|
|
throw_index_error(idx);
|
|
}
|
|
return &(sgs[idx]);
|
|
}
|
|
|
|
std::vector<SubstanceGroup> getMolSubstanceGroups(ROMol &mol) {
|
|
return getSubstanceGroups(mol);
|
|
}
|
|
void clearMolSubstanceGroups(ROMol &mol) {
|
|
std::vector<SubstanceGroup> &sgs = getSubstanceGroups(mol);
|
|
sgs.clear();
|
|
}
|
|
|
|
SubstanceGroup *createMolSubstanceGroup(ROMol &mol, std::string type) {
|
|
SubstanceGroup sg(&mol, type);
|
|
addSubstanceGroup(mol, sg);
|
|
return &(getSubstanceGroups(mol).back());
|
|
}
|
|
|
|
SubstanceGroup *createMolDataSubstanceGroup(ROMol &mol, std::string fieldName,
|
|
std::string value) {
|
|
SubstanceGroup sg(&mol, "DAT");
|
|
sg.setProp("FIELDNAME", fieldName);
|
|
STR_VECT dataFields{value};
|
|
sg.setProp("DATAFIELDS", dataFields);
|
|
addSubstanceGroup(mol, sg);
|
|
return &(getSubstanceGroups(mol).back());
|
|
}
|
|
|
|
SubstanceGroup *addMolSubstanceGroup(ROMol &mol, const SubstanceGroup &sgroup) {
|
|
addSubstanceGroup(mol, sgroup);
|
|
return &(getSubstanceGroups(mol).back());
|
|
}
|
|
|
|
void addBracketHelper(SubstanceGroup &self, python::object pts) {
|
|
unsigned int sz = boost::python::len(pts);
|
|
if (sz != 2 && sz != 3) {
|
|
throw_value_error("pts object have a length of 2 or 3");
|
|
}
|
|
|
|
SubstanceGroup::Bracket bkt;
|
|
python::stl_input_iterator<RDGeom::Point3D> beg(pts);
|
|
for (unsigned int i = 0; i < sz; ++i) {
|
|
bkt[i] = *beg;
|
|
++beg;
|
|
}
|
|
self.addBracket(bkt);
|
|
}
|
|
|
|
python::tuple getCStatesHelper(const SubstanceGroup &self) {
|
|
python::list res;
|
|
for (const auto &cs : self.getCStates()) {
|
|
res.append(cs);
|
|
}
|
|
return python::tuple(res);
|
|
}
|
|
|
|
python::tuple getBracketsHelper(const SubstanceGroup &self) {
|
|
python::list res;
|
|
for (const auto &brk : self.getBrackets()) {
|
|
res.append(python::make_tuple(brk[0], brk[1], brk[2]));
|
|
}
|
|
return python::tuple(res);
|
|
}
|
|
|
|
python::tuple getAttachPointsHelper(const SubstanceGroup &self) {
|
|
python::list res;
|
|
for (const auto &ap : self.getAttachPoints()) {
|
|
res.append(ap);
|
|
}
|
|
return python::tuple(res);
|
|
}
|
|
|
|
void SetAtomsHelper(SubstanceGroup &self, const python::object &iterable) {
|
|
std::vector<unsigned int> atoms;
|
|
pythonObjectToVect(iterable, atoms);
|
|
self.setAtoms(atoms);
|
|
}
|
|
|
|
void SetParentAtomsHelper(SubstanceGroup &self,
|
|
const python::object &iterable) {
|
|
std::vector<unsigned int> patoms;
|
|
pythonObjectToVect(iterable, patoms);
|
|
self.setParentAtoms(patoms);
|
|
}
|
|
|
|
void SetBondsHelper(SubstanceGroup &self, const python::object &iterable) {
|
|
std::vector<unsigned int> bonds;
|
|
pythonObjectToVect(iterable, bonds);
|
|
self.setBonds(bonds);
|
|
}
|
|
|
|
} // namespace
|
|
|
|
std::string sGroupClassDoc =
|
|
"A collection of atoms and bonds with associated properties\n";
|
|
|
|
struct sgroup_wrap {
|
|
static void wrap() {
|
|
RegisterVectorConverter<SubstanceGroup>("SubstanceGroup_VECT");
|
|
|
|
python::class_<SubstanceGroup::CState,
|
|
boost::shared_ptr<SubstanceGroup::CState>>(
|
|
"SubstanceGroupCState", "CSTATE for a SubstanceGroup",
|
|
python::init<>(python::args("self")))
|
|
.def_readonly("bondIdx", &SubstanceGroup::CState::bondIdx)
|
|
.def_readonly("vector", &SubstanceGroup::CState::vector);
|
|
|
|
python::class_<SubstanceGroup::AttachPoint,
|
|
boost::shared_ptr<SubstanceGroup::AttachPoint>>(
|
|
"SubstanceGroupAttach", "AttachPoint for a SubstanceGroup",
|
|
python::init<>(python::args("self")))
|
|
.def_readonly("aIdx", &SubstanceGroup::AttachPoint::aIdx,
|
|
"attachment index")
|
|
.def_readonly("lvIdx", &SubstanceGroup::AttachPoint::lvIdx,
|
|
"leaving atom or index (0 for implied)")
|
|
.def_readonly("id", &SubstanceGroup::AttachPoint::id, "attachment id");
|
|
|
|
python::class_<SubstanceGroup, boost::shared_ptr<SubstanceGroup>>(
|
|
"SubstanceGroup", sGroupClassDoc.c_str(), python::no_init)
|
|
.def("GetOwningMol", &SubstanceGroup::getOwningMol,
|
|
"returns the molecule owning this SubstanceGroup",
|
|
python::return_internal_reference<>(), python::args("self"))
|
|
.def("GetIndexInMol", &SubstanceGroup::getIndexInMol,
|
|
python::args("self"),
|
|
"returns the index of this SubstanceGroup in the owning "
|
|
"molecule's list.")
|
|
.def("GetAtoms", &SubstanceGroup::getAtoms,
|
|
"returns a list of the indices of the atoms in this "
|
|
"SubstanceGroup",
|
|
python::return_value_policy<python::copy_const_reference>(),
|
|
python::args("self"))
|
|
.def("GetParentAtoms", &SubstanceGroup::getParentAtoms,
|
|
"returns a list of the indices of the parent atoms in this "
|
|
"SubstanceGroup",
|
|
python::return_value_policy<python::copy_const_reference>(),
|
|
python::args("self"))
|
|
.def("GetBonds", &SubstanceGroup::getBonds,
|
|
"returns a list of the indices of the bonds in this "
|
|
"SubstanceGroup",
|
|
python::return_value_policy<python::copy_const_reference>(),
|
|
python::args("self"))
|
|
.def("SetAtoms", SetAtomsHelper, python::args("self", "iterable"),
|
|
"Set the list of the indices of the atoms in this "
|
|
"SubstanceGroup.\nNote that this does not update "
|
|
"properties, CStates or Attachment Points.")
|
|
.def("SetParentAtoms", SetParentAtomsHelper,
|
|
python::args("self", "iterable"),
|
|
"Set the list of the indices of the parent atoms in this "
|
|
"SubstanceGroup.\nNote that this does not update "
|
|
"properties, CStates or Attachment Points.")
|
|
.def("SetBonds", SetBondsHelper, python::args("self", "iterable"),
|
|
"Set the list of the indices of the bonds in this "
|
|
"SubstanceGroup.\nNote that this does not update "
|
|
"properties, CStates or Attachment Points.")
|
|
.def("AddAtomWithIdx", &SubstanceGroup::addAtomWithIdx,
|
|
python::args("self", "idx"))
|
|
.def("AddBondWithIdx", &SubstanceGroup::addBondWithIdx,
|
|
python::args("self", "idx"))
|
|
.def("AddParentAtomWithIdx", &SubstanceGroup::addParentAtomWithIdx,
|
|
python::args("self", "idx"))
|
|
.def("AddAtomWithBookmark", &SubstanceGroup::addAtomWithBookmark,
|
|
python::args("self", "mark"))
|
|
.def("AddParentAtomWithBookmark",
|
|
&SubstanceGroup::addParentAtomWithBookmark,
|
|
python::args("self", "mark"))
|
|
.def("AddCState", &SubstanceGroup::addCState,
|
|
python::args("self", "bondIdx", "vector"))
|
|
.def("GetCStates", getCStatesHelper, python::args("self"))
|
|
.def("AddBondWithBookmark", &SubstanceGroup::addBondWithBookmark,
|
|
python::args("self", "mark"))
|
|
.def("AddAttachPoint", &SubstanceGroup::addAttachPoint,
|
|
python::args("self", "aIdx", "lvIdx", "idStr"))
|
|
.def("GetAttachPoints", getAttachPointsHelper, python::args("self"))
|
|
.def("AddBracket", addBracketHelper, python::args("self", "pts"))
|
|
.def("GetBrackets", getBracketsHelper, python::args("self"))
|
|
.def("ClearBrackets", &SubstanceGroup::clearBrackets,
|
|
python::args("self"))
|
|
.def("ClearCStates", &SubstanceGroup::clearCStates,
|
|
python::args("self"))
|
|
.def("ClearAttachPoints", &SubstanceGroup::clearAttachPoints,
|
|
python::args("self"))
|
|
|
|
.def("SetProp",
|
|
(void (RDProps::*)(const std::string_view, std::string, bool)
|
|
const) &
|
|
SubstanceGroup::setProp<std::string>,
|
|
(python::arg("self"), python::arg("key"), python::arg("val"),
|
|
python::arg("computed") = false),
|
|
"sets the value of a particular property")
|
|
.def("SetDoubleProp",
|
|
(void (RDProps::*)(const std::string_view, double, bool) const) &
|
|
SubstanceGroup::setProp<double>,
|
|
(python::arg("self"), python::arg("key"), python::arg("val"),
|
|
python::arg("computed") = false),
|
|
"sets the value of a particular property")
|
|
.def("SetIntProp",
|
|
(void (RDProps::*)(const std::string_view, int, bool) const) &
|
|
SubstanceGroup::setProp<int>,
|
|
(python::arg("self"), python::arg("key"), python::arg("val"),
|
|
python::arg("computed") = false),
|
|
"sets the value of a particular property")
|
|
.def("SetUnsignedProp",
|
|
(void (RDProps::*)(const std::string_view, unsigned int, bool)
|
|
const) &
|
|
SubstanceGroup::setProp<unsigned int>,
|
|
(python::arg("self"), python::arg("key"), python::arg("val"),
|
|
python::arg("computed") = false),
|
|
"sets the value of a particular property")
|
|
.def("SetBoolProp",
|
|
(void (RDProps::*)(const std::string_view, bool, bool) const) &
|
|
SubstanceGroup::setProp<bool>,
|
|
(python::arg("self"), python::arg("key"), python::arg("val"),
|
|
python::arg("computed") = false),
|
|
"sets the value of a particular property")
|
|
.def("HasProp",
|
|
(bool (RDProps::*)(const std::string_view) const) &
|
|
SubstanceGroup::hasProp,
|
|
python::args("self", "key"),
|
|
"returns whether or not a particular property exists")
|
|
.def(
|
|
"GetProp", GetPyProp<SubstanceGroup>,
|
|
(python::arg("self"), python::arg("key"),
|
|
python::arg("autoConvert") = false),
|
|
"Returns the value of the property.\n\n"
|
|
" ARGUMENTS:\n"
|
|
" - key: the name of the property to return (a string).\n\n"
|
|
" - autoConvert: if True attempt to convert the property into a python object\n\n"
|
|
" RETURNS: a string\n\n"
|
|
" NOTE:\n"
|
|
" - If the property has not been set, a KeyError exception "
|
|
"will be raised.\n",
|
|
boost::python::return_value_policy<return_pyobject_passthrough>())
|
|
.def("GetIntProp",
|
|
(int (RDProps::*)(const std::string_view) const) &
|
|
SubstanceGroup::getProp<int>,
|
|
python::args("self", "key"),
|
|
"returns the value of a particular property")
|
|
.def("GetUnsignedProp",
|
|
(unsigned int (RDProps::*)(const std::string_view) const) &
|
|
SubstanceGroup::getProp<unsigned int>,
|
|
python::args("self", "key"),
|
|
"returns the value of a particular property")
|
|
.def("GetDoubleProp",
|
|
(double (RDProps::*)(const std::string_view) const) &
|
|
SubstanceGroup::getProp<double>,
|
|
python::args("self", "key"),
|
|
"returns the value of a particular property")
|
|
.def("GetBoolProp",
|
|
(bool (RDProps::*)(const std::string_view) const) &
|
|
SubstanceGroup::getProp<bool>,
|
|
python::args("self", "key"),
|
|
"returns the value of a particular property")
|
|
.def("GetUnsignedVectProp",
|
|
(std::vector<unsigned int> (RDProps::*)(const std::string_view)
|
|
const) &
|
|
SubstanceGroup::getProp<std::vector<unsigned int>>,
|
|
python::args("self", "key"),
|
|
"returns the value of a particular property")
|
|
.def("GetStringVectProp",
|
|
(std::vector<std::string> (RDProps::*)(const std::string_view)
|
|
const) &
|
|
SubstanceGroup::getProp<std::vector<std::string>>,
|
|
python::args("self", "key"),
|
|
"returns the value of a particular property")
|
|
.def("GetPropNames", &SubstanceGroup::getPropList,
|
|
(python::arg("self"), python::arg("includePrivate") = false,
|
|
python::arg("includeComputed") = false),
|
|
"Returns a list of the properties set on the "
|
|
"SubstanceGroup.\n\n")
|
|
.def("GetPropsAsDict", GetPropsAsDict<SubstanceGroup>,
|
|
(python::arg("self"), python::arg("includePrivate") = true,
|
|
python::arg("includeComputed") = true,
|
|
python::arg("autoConvertStrings") = true),
|
|
"Returns a dictionary of the properties set on the "
|
|
"SubstanceGroup.\n"
|
|
" n.b. some properties cannot be converted to python types.\n")
|
|
.def("ClearProp",
|
|
(void (RDProps::*)(const std::string_view) const) &
|
|
SubstanceGroup::clearProp,
|
|
python::args("self", "key"),
|
|
"Removes a particular property (does nothing if not set).\n\n");
|
|
|
|
python::def("GetMolSubstanceGroups", &getMolSubstanceGroups,
|
|
"returns a copy of the molecule's SubstanceGroups (if any)",
|
|
python::with_custodian_and_ward_postcall<0, 1>(),
|
|
python::args("mol"));
|
|
python::def("GetMolSubstanceGroupWithIdx", &getMolSubstanceGroupWithIdx,
|
|
"returns a particular SubstanceGroup from the molecule",
|
|
python::return_internal_reference<
|
|
1, python::with_custodian_and_ward_postcall<0, 1>>(),
|
|
python::args("mol", "idx"));
|
|
python::def("ClearMolSubstanceGroups", &clearMolSubstanceGroups,
|
|
python::args("mol"),
|
|
"removes all SubstanceGroups from a molecule (if any)");
|
|
python::def("CreateMolSubstanceGroup", &createMolSubstanceGroup,
|
|
(python::arg("mol"), python::arg("type")),
|
|
"creates a new SubstanceGroup associated with a molecule, "
|
|
"returns the new SubstanceGroup",
|
|
python::return_value_policy<
|
|
python::reference_existing_object,
|
|
python::with_custodian_and_ward_postcall<0, 1>>());
|
|
python::def(
|
|
"CreateMolDataSubstanceGroup", &createMolDataSubstanceGroup,
|
|
(python::arg("mol"), python::arg("fieldName"), python::arg("value")),
|
|
"creates a new DATA SubstanceGroup associated with a molecule, "
|
|
"returns the new SubstanceGroup",
|
|
python::return_value_policy<
|
|
python::reference_existing_object,
|
|
python::with_custodian_and_ward_postcall<0, 1>>());
|
|
python::def("AddMolSubstanceGroup", &addMolSubstanceGroup,
|
|
(python::arg("mol"), python::arg("sgroup")),
|
|
"adds a copy of a SubstanceGroup to a molecule, returns the "
|
|
"new SubstanceGroup",
|
|
python::return_value_policy<
|
|
python::reference_existing_object,
|
|
python::with_custodian_and_ward_postcall<0, 1>>());
|
|
}
|
|
};
|
|
} // namespace RDKit
|
|
|
|
void wrap_sgroup() { RDKit::sgroup_wrap::wrap(); }
|