Skip to main content

Graphium: Scaling molecular GNNs to infinity.

Project description

Scaling molecular GNNs to infinity


Run on Gradient PyPI Conda PyPI - Downloads Conda license GitHub Repo stars GitHub Repo stars test test-ipu release code-check doc codecov hydra

A deep learning library focused on graph representation learning for real-world chemical tasks.

  • ✅ State-of-the-art GNN architectures.
  • 🐍 Extensible API: build your own GNN model and train it with ease.
  • ⚗️ Rich featurization: powerful and flexible built-in molecular featurization.
  • 🧠 Pretrained models: for fast and easy inference or transfer learning.
  • ⮔ Read-to-use training loop based on Pytorch Lightning.
  • 🔌 Have a new dataset? Graphium provides a simple plug-and-play interface. Change the path, the name of the columns to predict, the atomic featurization, and you’re ready to play!

Documentation

Visit https://graphium-docs.datamol.io/.

Run on Gradient

You can try running Graphium on Graphcore IPUs for free on Gradient by clicking on the button above.

Installation for developers

For CPU and GPU developers

Use mamba:

# Install Graphium's dependencies in a new environment named `graphium`
mamba env create -f env.yml -n graphium

# Install Graphium in dev mode
mamba activate graphium
pip install --no-deps -e .

For IPU developers

# Install Graphcore's SDK and Graphium dependencies in a new environment called `.graphium_ipu`
./install_ipu.sh .graphium_ipu

The above step needs to be done once. After that, enable the SDK and the environment as follows:

source enable_ipu.sh .graphium_ipu

The Graphium CLI

Installing graphium makes two CLI tools available: graphium and graphium-train. These CLI tools make it easy to access advanced functionality, such as training a model, extracting fingerprints from a pre-trained model or precomputing the dataset. For more information, visit the documentation.

License

Under the Apache-2.0 license. See LICENSE.

Documentation

  • Diagram for data processing in Graphium.
Data Processing Chart
  • Diagram for Muti-task network in Graphium
Full Graph Multi-task Network

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

graphium-2.3.5.tar.gz (4.7 MB view details)

Uploaded Source

Built Distribution

graphium-2.3.5-py3-none-any.whl (1.0 MB view details)

Uploaded Python 3

File details

Details for the file graphium-2.3.5.tar.gz.

File metadata

  • Download URL: graphium-2.3.5.tar.gz
  • Upload date:
  • Size: 4.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for graphium-2.3.5.tar.gz
Algorithm Hash digest
SHA256 b0ea21a337ecc11ab3084602043b9f2b181586b98402e1f9a343e4ac2a8d2b9e
MD5 f77f84a117380f33c4f969cfa9ceabdd
BLAKE2b-256 f43e117261d54f9bbb0f825c98a791a601c18e12e3b5e0089bc9999d5bafb9c2

See more details on using hashes here.

File details

Details for the file graphium-2.3.5-py3-none-any.whl.

File metadata

  • Download URL: graphium-2.3.5-py3-none-any.whl
  • Upload date:
  • Size: 1.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for graphium-2.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 a1dd9f47b316b9f96f5bb725e35b2a3f027c912e63f8bf0a028199ad1c45d9d8
MD5 23ef48f3d260d94935797ef77aee431f
BLAKE2b-256 c9cee8a2bd5ded3fb451820aa39fa8ec6de60d422ee820672e237c2ec82f4d63

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page