/BioBlender

AddOn for Blender to do molecular work

Primary LanguagePythonBSD 2-Clause "Simplified" LicenseBSD-2-Clause

BioBlender is an addon for Blender, aimed at providing tools for the import and elaboration of biological molecules. It consists of several functions, some executed by Blender and/or its Game Engine, and some others performed by external programs, such as PyMOL, APBS etc.

It was developed by the Scientific Visualization Unit of the Institute of Cliniclal Physiology of the CNR of Italy in Pisa, with the contribution of several colleagues.

We have now made it an Open Project, with the intent of keeping it updated, as long as Blender keeps moving on, and of possibly introducing new, better and useful features.

More info can be found on the SciVis website (www.scivis.it) and on BioBlender.eu

BioBlender was developed to work on Windows, Mac and Linux. Therefore each fix will need to be tested on each of these platforms. Also, as BioBlender is supposed to handle different types of molecules, we will test:

  • Single protein, multiple conformations File: "01_CaM_protein3conformations.pdb";
  • Double strand DNA fragment File "02_4IHV_dsDNA.pdb";
  • Glycoprotein (protein with sugar-like molcule attached) file "05_glycoprotein_4AY9_FSH.pdb";
  • Small protein for testing GE. File "06_1L2Y_4GE.pdb";
  • Composite protein (dimer), file: "04_Dimer_1A4U.pdb";
  • Interacting protein/DNA, file "03_3IV5_ProteinComplex.pdb".

The SciVis Team is grateful to all that will contribute to this project.

#Getting Started# BioBlender is still under development

Prerequisites

##Using the command line## This set up will allow you to update dynamically to the latest snapshot of BioBlender. You need to be able to use the command line and have git properly set up.

Unix/Mac

  1. Get the latest version

    mkdir ~/BioBlender
    git clone https://github.com/MonZop/BioBlender.git ~/BioBlender
    ln -s ~/BioBlender ~/.config/blender/%BLENDER_VERSION_NUM%/scripts/addons/BioBlender
  2. Checkout whichever branch you need. If you're not sure, skip this step.

    cd ~/BioBlender
    git checkout remotes/origin/BRANCH_NAME
  3. Launch Blender and do File-->User Preferences-->Addons

  4. Search the list for BioBlender2.0 and make sure it is ticked

  5. Save user settings and restart blender

  6. To update

    cd ~/BioBlender
    git pull --all

Windows Vista and above

  1. Get the latest version of BioBlender. Assuming you only have one partition C:. If not, just replace with your drive's letter (D, E, etc).

    mkdir C:\some\directory\BioBlender
    git clone https://github.com/MonZop/BioBlender.git C:\some\directory\BioBlender
    mklnk /d "C:\Users\%username%\AppData\Roaming\Blender Foundation\Blender\%BLENDER_VERSION_NUM%\scripts\addons\BioBlender" C:\some\directory\BioBlender
    

    The mklink step will work with /d or /j, both /d and /j are good options, of the two /j requires no elevated user privileges so if /d fails, then use /j

  2. Checkout whichever branch you need. If you're not sure, skip this step.

    cd C:\some\directory\BioBlender
    git checkout remotes/origin/BRANCH_NAME
    
  3. Launch Blender and do File-->User Preferences-->Addons

  4. Search the list for BioBlender2.0 and make sure it is ticked

  5. Save user settings and restart blender

  6. To update

    cd C:\some\directory\BioBlender
    git pull --all