biobb/biobb_wf_flexserv repository overview

⁠Protein structure flexibility workflow using BioExcel Building Blocks (biobb)⁠ and FlexServ tools

Based on the FlexServ server: https://mmb.irbbarcelona.org/FlexServ/⁠

This tutorial aims to illustrate the process of generating protein conformational ensembles from 3D structures and analysing its molecular flexibility, step by step, using the BioExcel Building Blocks library (biobb).

⁠Installation

docker pull biobb/biobb_wf_flexserv

⁠Workflow files

Below you can find the list of all the needed files for executing this workflow:

• structure.pdb: PDB structure with the protein molecule. Download example⁠
• workflow.yml: the configuration file with the I/O dependencies and settings for each step of the workflow. Download example⁠

Please put all these files in the same folder. In this execution folder, create a new folder named Files and put inside the following file:

• 1a32.MoDEL.pcz: PCZ file for the compressed 10-ns MD trajectory of the 1A32 protein taken from the MoDEL⁠ database. Download example⁠

⁠Run workflow

The BioBB workflows containers can be executed either interactively via Jupyter Notebook or sequentially in python.

⁠Run in Jupyter Notebook

For running the container in Jupyter Notebook, please type the following instruction in your terminal:

docker run --name <container_name> -d -e MODE=jupyter -p <port>:8888 -v /path/to/inputs:/data biobb/biobb_wf_flexserv

Where:

• container_name is the name of the container (optional).
• port is the port of your computer where the output of the container will be redirected (ie 3000).
• /path/to/inputs is the path to the folder where the input(s) and workflow.yml files are located (all of them must be in the same folder).

This instruction will run the container in detached (or background) mode, so once it's running, you should go to your browser and type:

http://localhost:3000/notebooks/notebook.ipynb⁠

Note that the port can change depending on the value provided in the previous step.

⁠Run in Python

Below you can find the list of all the needed files for executing this workflow in python:

• workflow.yml: the configuration file with the I/O dependencies and settings for each step of the workflow.
• inputs: the inputs vary depending on the workflow, all the needed files are available in this same repository, just be sure to have them in the same folder where workflow.yml is.

For running the container in python, please type the following instruction in your terminal:

docker run --name <container_name> -v /path/to/inputs:/data biobb/biobb_wf_flexserv

Where:

• container_name is the name of the container (optional).
• /path/to/inputs is the path to the folder where the input(s) and workflow.yml files are located (all of them must be in the same folder).

⁠Time of execution

Take into account that depending on the number of steps, the tools executed and the settings provided, along with the power of your computer, the execution of the workflow can take from a few minutes to several hours. The workflow progress will be shown in your terminal if you execute the workflow via python.

⁠Get output results

⁠Jupyter Notebook

Once the workflow is finished, you just should enter the new wf_notebook/biobb_wf_flexserv folder and, inside it, you will find all the outputs generated by the workflow.

⁠Python

Once the workflow is finished, you just should enter the new wf_python/biobb_wf_flexserv folder and, inside it, you will find a folder for each step of the workflow with all the files generated in every step.