Skip to main content

Toolbox for molecular animations with Blender and Geometry Nodes.

Project description

MolecularNodes 🧬🍝💻

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

Documentation Building Running Tests codecov

Button linking to buymeacoffee.com to leave me a tip as a thank you. Button linking to buymeacoffee.com to leave me a tip as a thank you. Button linking to buymeacoffee.com to leave me a tip as a thank you.

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.

Installation

See the installation page of the documentation, for detailed instructions on how to install the add-on.

Getting Started

These tutorials are for earlier versions of the addon. There are some differences in design, but overall the workflow is the same. Watch through the videos to get an overview of how the addon works.

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.

To contribute to the project, fork and clone the Molecular Nodes repo to your local machine. I recommend using VS Code and 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 Addonds.

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.

The Blender logo.

Buy Me a Coffee

If you'd like to say thank you, you can buy me a coffee (or 10!) as a thanks for developing the add-on. Many others have already down exactly that. You can also join our Blender.Science discord, where fellow science visualisation enthusiasts and experts hang out and help each other.

Button linking to buymeacoffee.com to leave me a tip as a thank you.

Project details


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.0.12.tar.gz (7.7 MB view details)

Uploaded Source

Built Distribution

molecularnodes-4.0.12-py3-none-any.whl (7.7 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: molecularnodes-4.0.12.tar.gz
  • Upload date:
  • Size: 7.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.10.0 Darwin/23.4.0

File hashes

Hashes for molecularnodes-4.0.12.tar.gz
Algorithm Hash digest
SHA256 d8e5d19f0e402e73e0420a42e924f48b997cd336a7317e84687f76229d8d8d23
MD5 3052606893e16c170470c6e0569792fb
BLAKE2b-256 fc36fd48f9e412e20d2767d3c6d615aba6d3211e3aa5ae4aa1d7e0860e57f3d6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: molecularnodes-4.0.12-py3-none-any.whl
  • Upload date:
  • Size: 7.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.10.0 Darwin/23.4.0

File hashes

Hashes for molecularnodes-4.0.12-py3-none-any.whl
Algorithm Hash digest
SHA256 5321031600fd8f7f439dfe0a21f480be8bfadc6f45dcb74a9506c54e2b99f285
MD5 9f3fda068dbbbad4011a55ac49cd0948
BLAKE2b-256 07753f7a43bdfe4bebd481e4a457cd9bbeb31dd4fb58109ea34eab915057636f

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