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.10

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.10.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.10-py3-none-any.whl (4.6 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: molecularnodes-4.5.10.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.10.tar.gz
Algorithm Hash digest
SHA256 2546028322fc90743dacda2ebd29e77a39906a4b57f84a15984ee3e431c03074
MD5 5e29663d3204823c4170cde775e85ad1
BLAKE2b-256 210b20909114507ff344fe8e12d3baa5590df0181d4766767c9217f5304178d7

See more details on using hashes here.

Provenance

The following attestation bundles were made for molecularnodes-4.5.10.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.10-py3-none-any.whl.

File metadata

File hashes

Hashes for molecularnodes-4.5.10-py3-none-any.whl
Algorithm Hash digest
SHA256 1d29cf4a8deb6edc6cbf3b6d6a7cbfdf24e9acebdc0deb884939a245a1a1acc0
MD5 cd67cfa3031f08a0b761791367e1602a
BLAKE2b-256 1d89cc929f95dccf6a6d2ace32a2af0912d9acd6a07a1c3d37aab9159349c740

See more details on using hashes here.

Provenance

The following attestation bundles were made for molecularnodes-4.5.10-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