Toolbox for molecular animations with Blender and Geometry Nodes.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for bradyajohnston from gravatar.com bradyajohnston

Unverified details

These details have not been verified by PyPI
Meta
  • Maintainer: Brady Johnston
  • Requires: Python ~=3.11.0
  • Provides-Extra: bpy , jupyter , build , dev , test , docs
Report project as malware

Project description

Molecular Nodes 🧬🍝💻

CI

Badge displaying license, which is MIT. Repo total downloads count. Badge displaying license, which is MIT. Badge displaying count of GitHub stars.

Badge showing usage of MDAnalysis as a python package powering the add-on Badge showing usage of biotite as a python package powering the add-on

Support me on Patreon with ongoing donations

Support me by buying a couple of coffees as a one-off donation

Join the scientific visualisation in Blender discord.

About

MolecularNodes enables quick import and visualisation of structural biology data inside of Blender. Blender provides advanced industry-leading visualisation and animation technology, while MolecularNodes provides the interface that allows Blender to understand the unique data formats used in structural biology.

The add-on enables creating animations from static crystal structures, styling proteins and other molecules in a variety of highly customisable styles, importing and playing back molecular dynamics trajectories from a wide variety of sources, and even importing of EM density maps.

Examples

See examples, tutorials and video projects that use Molecular Nodes in the documentation page, or academic papers that use Molecular Nodes in the citations page.

Clockwork Veritasium BCON22 Talk
Clockwork Veritasium Clockwork

Installation

Molecular Nodes can be installed from within Blender in versions >=4.2, by using the Get Extensions menu. More details can be found on the installation page of the documentation.

Getting Started

There are video and written tutorials in the documentation that will walk you through the basics of using the addon.

Documentation for all of the individual nodes are also available in the node documentation page.

image

Contributing

If you would like to contribute to the project, please open an issue to discuss potential new features, or comment on an existing issue if you would like to help with fixing it. I welcome any and all potential PRs.

It's recommended to clone this repository using git clone --depth 1 as the complete commit history gets close to 1GB of data. I also recommend using VS Code with the Blender VS Code addon which streamlines the development process.

Once installed, you can use the Blender: Build and Start command with VS Code open in the addon directory, to start Blender with the addon built and installed. Any changes that are then made to the underlying addon code, can be quickly previewed inside of the running Blender by using the VS Code command Blender: Reload Addons.

Once happy with your code, open a pull request to discuss and get it reviewed by others working on the project. Open a draft pull request early, or open an issue to discuss the scope and feasability of potential features.

Citation

A paper has not yet been published on the addon, but if you use it in your academic work you can site it from Zenodo:

Thanks

A massive thanks to the Blender Foundation which develops Blender as a free and open source program, and to the python package developers who enable the functionality of the this add-on. Primarily Biotite and MDAnalysis teams.

The Blender logo.

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for bradyajohnston from gravatar.com bradyajohnston

Unverified details

These details have not been verified by PyPI
Meta
  • Maintainer: Brady Johnston
  • Requires: Python ~=3.11.0
  • Provides-Extra: bpy , jupyter , build , dev , test , docs

Release history Release notifications | RSS feed

This version

4.5.9

4.5.8

4.5.7

4.5.6

4.5.5

4.5.4

4.5.2

4.5.1

4.5.0

4.4.3

4.4.2

4.4.1

4.4.0

4.2.12

4.2.11

4.2.10

4.0.12

4.0.5

4.0.2

4.0.1

4.0.0

2.11.1

2.11.0

2.10.0

Download files

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

Source Distribution

molecularnodes-4.5.9.tar.gz (4.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

molecularnodes-4.5.9-py3-none-any.whl (4.5 MB view details)

Uploaded Python 3

File details

Details for the file molecularnodes-4.5.9.tar.gz.

File metadata

  • Download URL: molecularnodes-4.5.9.tar.gz
  • Upload date:
  • Size: 4.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for molecularnodes-4.5.9.tar.gz
Algorithm Hash digest
SHA256 578384efb36c4e2920b1432fdc693bd709cb90d0a2e7265da9c95ce9553a05df
MD5 a2f8d87dea1de5c3acfcc73d44ae6bae
BLAKE2b-256 357c22ef15c20fe6dae6b92477a72922e82c36d8c1a5c5348f1adbc300a009ef

See more details on using hashes here.

Provenance

The following attestation bundles were made for molecularnodes-4.5.9.tar.gz:

Publisher: pypi.yml on BradyAJohnston/MolecularNodes

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file molecularnodes-4.5.9-py3-none-any.whl.

File metadata

  • Download URL: molecularnodes-4.5.9-py3-none-any.whl
  • Upload date:
  • Size: 4.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for molecularnodes-4.5.9-py3-none-any.whl
Algorithm Hash digest
SHA256 68ed10456364f3abf364e5f85dcd548b15e3d4bbc21c1f3df0ad7bfe9f6a9e75
MD5 9c8b696a84602b009de12c894ce807ae
BLAKE2b-256 a5079479f11bd786620007dc11e27acea2afc59077fbab1633f9e44c591a587f

See more details on using hashes here.

Provenance

The following attestation bundles were made for molecularnodes-4.5.9-py3-none-any.whl:

Publisher: pypi.yml on BradyAJohnston/MolecularNodes

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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