BioSimSpace is an interoperable Python framework for biomolecular simulation. With it you can:
- Write robust and portable biomolecular workflow components that work on different hardware, with different software packages, and that can be run in different ways, e.g. command-line, Jupyter.
- Interact with molecular-simulation processes in real time.
Full documentation can be found here.
The easiest way to install BioSimSpace is using our conda channel:
conda install -c rdkit -c conda-forge -c omnia -c michellab biosimspace
To install the latest development version you can use:
conda install -c rdkit -c conda-forge -c omnia -c michellab/label/dev biosimspace
Following this, you'll need to use pip
to install some additional, non-conda, packages into your environment:
pip install fileupload pygtail pypdb
Unless you add the required channels to your Conda configuration, then you'll need to add them when updating, e.g., for the development package:
conda update -c rdkit -c conda-forge -c omnia -c michellab/label/dev biosimspace
Note that on OS X you will need to run Python scripts with the sire_python
interpreter. This is due to an issue with the default Python interpreter that is installed via Conda. (This applies to all installation methods.)
The latest self-extracting binary for the development version of BioSimSpace can be downloaded from one of the following links:
- Linux: biosimspace_devel_latest_linux.run
- Mac OS X: biosimspace_devel_latest_osx.run
One downloaded, the binary can be unpacked as follows:
chmod +x biosimspace_devel_latest_linux.run
./biosimspace_devel_latest_linux.run
Unless a different installation path was given, BioSimSpace can be found in: $HOME/biosimspace.app
. BioSimSpace comes with a bundled with a Python interpreter, an interactive Python (IPython) shell, and Jupyter.
For example, to run a BioSimSpace Python script, use:
$HOME/biosimspace.app/bin/python script.py
To launch an interactive BioSimSpace session:
$HOME/biosimspace.app/bin/ipython
To run a BioSimSpace notebook:
$HOME/biosimspace.app/bin/jupyter notebook notebook.ipynb
Alternatively, to install BioSimSpace from source:
(Before starting, you'll need a working Git installation.)
BioSimSpace is built on top of the Sire molecular simulation framework. To download and install Sire:
git clone https://github.com/michellab/Sire
cd Sire
./compile_sire.sh
Assuming the default installation path, this will install Sire into $HOME/sire.app
.
(Note that the installation is slow and can take in excess of an hour.)
Next you will need to download BioSimSpace and install it into your Sire application. (The following assumes the default Sire installation path.)
git clone https://github.com/michellab/BioSimSpace
cd BioSimSpace/python
$HOME/sire.app/bin/python setup.py install
Once finished, you can test the installation by running:
$HOME/sire.app/bin/ipython
Then try importing the BioSimSpace package:
import BioSimSpace as BSS
If you don't want to build or install, you can also run BioSimSpace via one of our docker images. The easy way to run the latest development image of BioSimSpace is via:
docker run -it biosimspace/biosimspace-devel:latest
This will download the latest BioSimSpace development container, and will run it, giving you a bash prompt inside the container.
Some BioSimSpace functionality requires OpenMM. Although a bundled version is provided as part of the installation, this may not be appropriate for your GPU drivers. To automatically detect and install a suitable version of OpenMM, simply run the following command post-install:
optimise_openmm
(Note that, depending on your installation method, optimise_openmm
may be located in $HOME/sire.app/bin
.)
Alternatively, to manually install a particular version of OpenMM you can use a specific Conda label, e.g.:
conda install -c omnia/label/cuda90 openmm
If you have compiled Sire against a custom OpenMM installation, then you'll need to set the OPENMM_PLUGIN_DIR
environment variable to point to the correct plugin location. By default this variable is set to the plugin directory of the bundled OpenMM package.
Please follow the developer's guide.
Please report bugs and other issues using the GitHub issue tracker. When reporting issues please try to include a minimal code snippet that reproduces the problem. Additional files can be also be uploaded as an archive, e.g. a zip file. Please also report the branch on which you are experiencing the issue, along with the BioSimSpace version number. This can be found by running:
import BioSimSpace as BSS
print(BSS.__version__)