All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Support for importing
.star
files from RELION and cisTEM files for instancing of structures from EM tomography datasets (#196)- Adds
starfile
andeulerangles
as dependencies - Creates another tab for the MolecularNodes input panel called
Starfile
- Adds
- Adds
MOL_style_cartoon
for cartoon representations of proteins (#199). Currently supports:- Beta sheets with & without arrow heads
- Alpha-helices as cylinders or as arrows
- Adds
MOL_utils_dssp
for detection of secondary structure.
-
Improved secondary structure import when downloading structure from the PDB as a
mmtf
file which includes assigned secondary structure. -
Improved some calculations for surface style, ~2x speedup
-
Added another row of buttons for the panel to avoid the buttons being squished
[2.5.4] 2023-04-10
- Issue with creation of biological assembly nodes. (#191)
[2.5.3] - 2023-03-30
- Import of CryoEM
.map
files as volume objects. Addition of volume-centric nodes for styling the volumes. (#164) - New
sec_struct
attribute as an integer for secondary structure of proteins when imported via Biotite. Atoms in a residue are given an integer value to specificy their secondary structure (#160):- 0 = '' : non-protein or not assigned by biotite annotate_sse
- 1 = a : alpha helix
- 2 = b : beta sheet
- 3 = c : coil
- Refactor of python package dependency management and installation. (#172)
- Fix consistency in load_trajectory function call.
custom_selections
were being taken from the GUI from inside themd.load_trajectory()
function, rather being passed in as a function which is now the case. (#182)
[2.4.3] - 2023-03-17
- Bumped version of biotite to install
0.36.1
2.4.2 - 2023-03-14
- Fix for custom selections panel with MDAnalysis import.
- Blender crashed when using MDAnlysis import filter, if bonds were present in the topology. (#177)
Fixed created during refactor that disabled the custom selection list for MD import.
2.4.0 - 2023-02-23
- Custom text input for creating selections of
res_id
ranges and indivual numbers thanks to @YaoYinYing (#149), enabling quicker creation of complex selections inside of Molecular Nodes.
- Refactor of package installation via pip, to help with those who require
pip
mirrors and provide more information when installation fails on ARM macs. (#162) - Removed redundant python submodules and general cleanup
2.3.1 - 2023-01-26
- Change translations for other languages to
bpy.app.translations.pgettext_data()
frombpy.app.translations.pgettext()
which reduces potential conflicts with other addons. (#147) - Fixed
chain_id_unique
not being added when importing via MDAnalysis, stopping custom nodes relying on chain information to break. (#156)
[2.3.0] - 2023-01-26
- Panel for adding multiple selection strings, which will become boolean attributes on the imported model when importing via MDAnalysis.
- Ball and stick node sphers now support field input for scaling the radius
- Error with initial node setup breaking when in non-english Blender UI (#139) contributed by @YaoYinYing
- Problems with biological assemblies failling on larger structures. (#143)
- Problem with Animate Frames node defaulting to wrong from range on start
[2.2.2] - 2023-01-06
- Issue on linux and with newer versions of Numpy where
np.bool
is deprecated and was erroring on import.
[2.2.1] - 2023-01-05
- multi-model
b_factor
is added when importing from.pdb
files via biotite #133 - 'Invert' field option to atom_properties and other selection nodes to optionally invert the selection
- Added better detection of ligands and modifcations (such as sugars) and a separate selection node for them. Currently ligands are stored on the
res_name
attribute, starting at 100 and incrementing one for each unique ligand.
include_bonds
option was not being utilised on MD import #132MOL_animate_res_wiggle
was wiggling theOXT
(res_name == 38
) oxygen when a peptide chain ended. Added additional selection to not wiggle this atom, which should only ever appear when a peptide chain terminates.- fixed import of
vdw_radii
for elements not supported by biotite (such as Fe) by moving vdw_radii to the data dictionary rather than relying on a function from biotite which had a limited dictionary for vdw_radii lookup
[2.2.0] - 2023-01-03
atom_name
attribute, which is a numerical representation of the atom name (C, CA, C5 etc)- Dicussed in #118
- Allows for more precise selections for new styling and animation nodes
- Reimplemented amino acid 'wiggle' node: using the
atom_name
attribute- 3x faster with the improved
atom_name
attribute and refactor of the underlying nodes
- 3x faster with the improved
- Reimplemented the amino acid to curve node
- Ribbon Style Nucleic: A ribbon representation for nucleic acids to complement the ribbon represenation of the proteins from alpha carbons. Enabled now thanks to the
atom_name
attribute. - Capturing the
Index
field in the selection node before the selection occurs, and added anIndex
field input to theMOL_animate_frames
node to enable selection to occur before animating between frames, if thePre-Sel Index
field is used in theIndex
field of theMOL_animate_frames
node - Added cutoff field for limiting the interpolation of atoms between frames based on a distance cutoff
- Added bonds through MDAnalysis import when a trajectory supports it #129
- Added
is_solvent
,is_nucleic
andis_peptide
boolean attributes when importing via MDAnalysis - Added frame-specific attribute
occupancy
which is added to each frame of the trajectory when imported via MDAnalysis. #128
- Changed naming of
MOL_style_atoms
toMOL_style_atoms_cycles
andMOL_style_ribbon
toMOL_style_ribbon_protein
[2.1.0] - 2023-01-01
CHANGELOG.md
for tracking changes to the project- Issue templates for GitHub issues
- Proper support for Fields for ribbon width, enabling 'licorice' representation amoung others
- Tooltips documentation for each of the custom node groups that can be added in Geometry Nodes
- More selection nodes for distance, XYZ slice and whole residues.
- Custom selections using a string when importing via MDAnalysis #123
- Added option to disable interpolation of atom positions between frames
- Added node for animating any field between frames of a trajectory (no fields currently added on import, but used in the new Aniamte Frames backend)
- UVs are now available for the ribbon mesh style, idea from ErikMarklund and implemented by quellenform
- Error when defaulting to
connect_via_distance()
when importing with 'Find Bonds' enabled - Adding of a color node which was mis-labelled and couldn't be added
- Non-
.gro
topology files were failling to addvdw_radii
attribute #124 - Remove use of
np.int
which is now deprecated and was causing errors when linking python on M1 Mac - Attributes now available on ribbon mesh which are sampled from backbone
- Changed starting material to be appended instead of created, which should avoid duplication of material.
[2.0.2] - 2022-12-13
- Error on reporting the success of improting a molecule
[2.0.1] - 2022-12-13
-
Remove usage of Atomium and switched to Biotite for most internal structural file parsing
-
Removed reliance upon Serpens to build the addon. Can now be developed by anybody without the requirements of additional Blender addons.
- Aspects of the addon can now have changes tracked properly by git, rather than inside a binary
.blend
Serpens file. - Now also allows easier and clearer contributions from others who wish to contribute
- Custom node trees still remain opaque to git unfortunately
- Aspects of the addon can now have changes tracked properly by git, rather than inside a binary
-
Attributes are now created and stored on the molecular model itself, removing the need for properties models that store the data XYZ positions. Makes the import process clearer, more robust and more easily expandable.
-
Bond information is available by default as edges of the mesh along with bond types
-
Improve MDAnalysis installation and usage internally
-
Expose operators and functions to Blender Python console to enable user scripting with the addon
import molecularnodes as mn
# to fetch structures from the protein data bank
struc_list = ['4ozs', '1xi4', '6n2y']
for pdb in struc_list:
mn.load.molecule_rcsb(pdb, starting_style = 1)
# to open a local structure file
mn.load.molecule_local('file_path_here.pdb', 'SomeMoleculeName', starting_style = 2)