Skip to content

maxim-papusha/StereoMolGraph

Repository files navigation

Logo

StereoMolGraph

PyPI Python License: MIT Unit Tests

Documentation GitHub DOI

StereoMolGraph (SMG) is a library for graph representation of molecules and reactions with a focus on Stereochemistry. It provides:

  • Graph types for molecules and reactions (with/without stereo and stereo changes)
  • Includes non tetrahedral stereocenters and changing stereochemistry in reactions
  • Fast approximate hashing via Weisfeiler–Lehman color refinement
  • Robust equality/isomorphism via a VF2++-style algorithm extended for stereochemistry and reactions
  • Bidirectional conversion from / to RDKit
  • Construction from 3D coordinates with automatic local stereo inference

Design philosophy

  • Unopinionated about bond orders, charge and electronic state
  • SMG focuses just on the connectivity and stereochemistry.
  • Stereochemistry describes relative spatial arrangement. No absolute stereochemistry.
  • Transparent: Simple 2D visualization in IPython notebooks

RDKit interoperability notes

  • Hydrogens must be explicit for bidirectional conversion.
  • Supports tetrahedral and non tetrahedral stereochemistry during conversion.
  • Bond orders, charges, unpaired electrons and other properties are not used!

Installation

Install from PyPI:

pip install stereomolgraph

Feedback and support

Bug reports are welcome — please open an issue on GitHub. Technical questions and feature requests can be added as discussions.

Issues:

Discussions:

Citation

If you use StereoMolGraph in your work, please cite the corresponding paper:

DOI

DOI

License

MIT License — see LICENSE.

About

Python Library for graph representation of molecules and reactions with a focus on Stereochemistry

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages