PabloEnmanuelRamos / BioBlender21

Blender plugin to process biological data and molecular work.
BSD 2-Clause "Simplified" License
83 stars 11 forks source link
bioblender bioinformatics bioinformatics-tool biology blender blender-addon python

BioBlender2.1 available for Blender 3.0

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 Clinical 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, where is also present the Forum

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:

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

Getting Started

BioBlender is still under development

Minimum 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/PabloEnmanuelRamos/BioBlender21.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.1 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 http://github.com/PabloEnmanuelRamos/BioBlender21.git C:\some\directory\BioBlender
    mklink /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.1 and make sure it is ticked

  5. Save user settings and restart blender

  6. To update

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