/MolecularNodes

Addon and nodes for working with structural biology and molecular data in Blender.

Primary LanguagePythonMIT LicenseMIT

MolecularNodes 🧬🍝💻

Buy Me A Coffee

MolecularNodes is a plugin for easy visualisation of structural biology and molecular data inside of the 3D modelling and animation program Blender. It provides a method for quick 1-button import of a range of formats including downloading directly from the protein data bank, or opening molecular dynamics trajectories.

MolecularNodes is powered by two key python packages:

Biotite Logo

  • Biotite which powers the majority of the file parsing and downloading from the PDB

Powered by MDAnalysis

  • MDAnalysis which powers the reading of a variety of molecular dynamics topology and trajectory files.

Installation

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

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

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 ou use it in your academic work you can site it from Zenodo:

DOI