[![](https://img.shields.io/github/v/tag/bioexcel/biobb_haddock?label=Version)](https://GitHub.com/bioexcel/biobb_haddock/tags/)
[![](https://img.shields.io/pypi/v/biobb-haddock.svg?label=Pypi)](https://pypi.python.org/pypi/biobb-haddock/)
[![](https://img.shields.io/conda/vn/bioconda/biobb_haddock?label=Conda)](https://anaconda.org/bioconda/biobb_haddock)
[![](https://img.shields.io/conda/dn/bioconda/biobb_haddock?label=Conda%20Downloads)](https://anaconda.org/bioconda/biobb_haddock)
[![](https://img.shields.io/badge/Docker-Quay.io-blue)](https://quay.io/repository/biocontainers/biobb_haddock?tab=tags)
[![](https://img.shields.io/badge/Singularity-GalaxyProject-blue)](https://depot.galaxyproject.org/singularity/biobb_haddock:5.0.0--pyhdfd78af_0)
[![](https://img.shields.io/badge/OS-Unix%20%7C%20MacOS-blue)](https://github.com/bioexcel/biobb_haddock)
[![](https://img.shields.io/pypi/pyversions/biobb-haddock.svg?label=Python%20Versions)](https://pypi.org/project/biobb-haddock/)
[![](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![](https://img.shields.io/badge/Open%20Source%3f-Yes!-blue)](https://github.com/bioexcel/biobb_haddock)
[![](https://readthedocs.org/projects/biobb-haddock/badge/?version=latest&label=Docs)](https://biobb-haddock.readthedocs.io/en/latest/?badge=latest)
[![](https://img.shields.io/website?down_message=Offline&label=Biobb%20Website&up_message=Online&url=https%3A%2F%2Fmmb.irbbarcelona.org%2Fbiobb%2F)](https://mmb.irbbarcelona.org/biobb/)
[![](https://img.shields.io/badge/Youtube-tutorials-blue?logo=youtube&logoColor=red)](https://www.youtube.com/@BioExcelCoE/search?query=biobb)
[![](https://zenodo.org/badge/DOI/10.1038/s41597-019-0177-4.svg)](https://doi.org/10.1038/s41597-019-0177-4)
[![](https://img.shields.io/endpoint?color=brightgreen&url=https%3A%2F%2Fapi.juleskreuer.eu%2Fcitation-badge.php%3Fshield%26doi%3D10.1038%2Fs41597-019-0177-4)](https://www.nature.com/articles/s41597-019-0177-4#citeas)
[![](https://docs.bioexcel.eu/biobb_haddock/junit/testsbadge.svg)](https://docs.bioexcel.eu/biobb_haddock/junit/report.html)
[![](https://docs.bioexcel.eu/biobb_haddock/coverage/coveragebadge.svg)](https://docs.bioexcel.eu/biobb_haddock/coverage/)
[![](https://docs.bioexcel.eu/biobb_haddock/flake8/flake8badge.svg)](https://docs.bioexcel.eu/biobb_haddock/flake8/)
[![](https://img.shields.io/github/last-commit/bioexcel/biobb_haddock?label=Last%20Commit)](https://github.com/bioexcel/biobb_haddock/commits/master)
[![](https://img.shields.io/github/issues/bioexcel/biobb_haddock.svg?color=brightgreen&label=Issues)](https://GitHub.com/bioexcel/biobb_haddock/issues/)
[![fair-software.eu](https://img.shields.io/badge/fair--software.eu-%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F-green)](https://fair-software.eu)
[![](https://www.bestpractices.dev/projects/8847/badge)](https://www.bestpractices.dev/projects/8847)
[](https://bestpractices.coreinfrastructure.org/projects/8847/badge)
[//]: # (The previous line invisible link is for compatibility with the howfairis script https://github.com/fair-software/howfairis-github-action/tree/main wich uses the old bestpractices URL)
# biobb_haddock
## Introduction
biobb_haddock is the Biobb module collection to compute information-driven flexible protein-protein docking.
Biobb (BioExcel building blocks) packages are Python building blocks that
create new layer of compatibility and interoperability over popular
bioinformatics tools.
The latest documentation of this package can be found in our readthedocs site:
[latest API documentation](http://biobb-haddock.readthedocs.io/en/latest/).
## Version
v5.0.0 2024.2
## Install CNS
### 1 Download the source code of CNS
In this case: `cns_solve_1.3_all.tar.gz`
From the [CNS site](http://cns-online.org) create a new folder in the Haddock
folder and uncompress it.
```bash
# Replace /__PATH__/__to__/ by your path to the haddock3 directory.
cd /__PATH__/__to__/haddock3
mkdir haddock3/CNS
cp cns_solve_1.3_all.tar.gz haddock3/CNS/
cd haddock3/CNS/
tar xvzf cns_solve_1.3_all.tar.gz
```
### 2 Download the Intel Fortran and C++ offline compilers
In this case: `m_fortran-compiler-classic_p_2022.0.0.63_offline.dmg` and `m_cpp-compiler-classic_p_2022.0.0.62_offline.dmg`
From the [Intel developers site](https://www.intel.com/content/www/us/en/developer/articles/tool/oneapi-standalone-components.html) and double click to install them.
### 3 Configure the CNS environment
#### 3.1 `cns_solve_env`:
```bash
# Replace /__PATH__/__to__/ by your path to the haddock3 directory.
cd /__PATH__/__to__/haddock3/CNS
vim cns_solve_1.3/cns_solve_env
```
Modify the `CNS_SOLVE` env var:
```bash
# CHANGE THE NEXT LINE TO POINT TO THE LOCATION OF THE CNSsolve DIRECTORY
setenv CNS_SOLVE '_CNSsolve_location_'
#
# ==========================================================================
```
In this case:
```bash
# Replace /__PATH__/__to__/ by your path to the haddock3 directory.
setenv CNS_SOLVE '/__PATH__/__to__/haddock3/CNS/cns_solve_1.3/'
```
#### 3.2 `rtf.inc`:
```bash
# Replace /__PATH__/__to__/ by your path to the haddock3 directory.
cd /__PATH__/__to__/haddock3/CNS
vim cns_solve_1.3/source/rtf.inc
```
Modify all the MX (maximum) variables adding one extra zero to all of them:
```
PARAMETER (MXRTRS=200,NICM=50) --> PARAMETER (MXRTRS=2000,NICM=50)
PARAMETER (MXRTA=2000) --> PARAMETER (MXRTA=20000)
PARAMETER (MXRTX=2000) --> PARAMETER (MXRTX=20000)
PARAMETER (MXRTB=2000) --> PARAMETER (MXRTB=20000)
PARAMETER (MXRTT=3000) --> PARAMETER (MXRTT=30000)
PARAMETER (MXRTP=2000) --> PARAMETER (MXRTP=20000)
PARAMETER (MXRTI=2000) --> PARAMETER (MXRTI=20000)
```
### 4 Compile and link CNS
```bash
# Replace /__PATH__/__to__/ by your path to the haddock3 directory.
cd /__PATH__/__to__/haddock3/CNS/cns_solve_1.3
make install
```
If everything ended well, one of the last output lines will be:
```
created executable file cns_solve-xxxxxxxxx.exe
```
The `xxxxxxxxx` will be a different number on each build.
Finally link the CNS binary:
```bash
# Replace /__PATH__/__to__/ by your path to the haddock3 directory.
cd /__PATH__/__to__/haddock3
mkdir -p bin/
#Replace the `xxxxxxxxx` and the __PATH__TO_BIN__ by your binary file
ln -s CNS/__PATH__TO_BIN__/cns_solve-xxxxxxxxx.exe bin/cns
```
## Installation
Using PIP:
> **Important:** PIP only installs the package. All the dependencies must be installed separately. To perform a complete installation, please use ANACONDA, DOCKER or SINGULARITY.
* Installation:
pip install "biobb_haddock>=5.0.0"
* Usage: [Python API documentation](https://biobb-haddock.readthedocs.io/en/latest/modules.html)
Using ANACONDA:
* Installation:
conda install -c bioconda "biobb_haddock>=5.0.0"
* Usage: With conda installation BioBBs can be used with the [Python API documentation](https://biobb-haddock.readthedocs.io/en/latest/modules.html) and the [Command Line documentation](https://biobb-haddock.readthedocs.io/en/latest/command_line.html)
Using DOCKER:
* Installation:
docker pull quay.io/biocontainers/biobb_haddock:5.0.0--pyhdfd78af_0
* Usage:
docker run quay.io/biocontainers/biobb_haddock:5.0.0--pyhdfd78af_0 <command>
Using SINGULARITY:
**MacOS users**: it's strongly recommended to avoid Singularity and use **Docker** as containerization system.
* Installation:
singularity pull --name biobb_haddock.sif https://depot.galaxyproject.org/singularity/biobb_haddock:5.0.0--pyhdfd78af_0
* Usage:
singularity exec biobb_haddock.sif <command>
The command list and specification can be found at the [Command Line documentation](https://biobb-haddock.readthedocs.io/en/latest/command_line.html).
## Copyright & Licensing
This software has been developed in the [MMB group](http://mmb.irbbarcelona.org) at the [BSC](http://www.bsc.es/) & [IRB](https://www.irbbarcelona.org/) for the [European BioExcel](http://bioexcel.eu/), funded by the European Commission (EU H2020 [823830](http://cordis.europa.eu/projects/823830), EU H2020 [675728](http://cordis.europa.eu/projects/675728)), EU Horizon Europe [101093290] (https://cordis.europa.eu/project/id/101093290).
* (c) 2015-2024 [Barcelona Supercomputing Center](https://www.bsc.es/)
* (c) 2015-2024 [Institute for Research in Biomedicine](https://www.irbbarcelona.org/)
Licensed under the
[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0), see the file LICENSE for details.
![](https://bioexcel.eu/wp-content/uploads/2019/04/Bioexcell_logo_1080px_transp.png "Bioexcel")
Raw data
{
"_id": null,
"home_page": "https://github.com/bioexcel/biobb_haddock",
"name": "biobb-haddock",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "Bioinformatics Workflows BioExcel Compatibility",
"author": "Biobb developers",
"author_email": "pau.andrio@bsc.es",
"download_url": "https://files.pythonhosted.org/packages/81/00/05fd3565d65137431d4dbfea930fa2972f9cd3713435b6f5cb56d3d2c147/biobb_haddock-5.0.0.tar.gz",
"platform": null,
"description": "[![](https://img.shields.io/github/v/tag/bioexcel/biobb_haddock?label=Version)](https://GitHub.com/bioexcel/biobb_haddock/tags/)\n[![](https://img.shields.io/pypi/v/biobb-haddock.svg?label=Pypi)](https://pypi.python.org/pypi/biobb-haddock/)\n[![](https://img.shields.io/conda/vn/bioconda/biobb_haddock?label=Conda)](https://anaconda.org/bioconda/biobb_haddock)\n[![](https://img.shields.io/conda/dn/bioconda/biobb_haddock?label=Conda%20Downloads)](https://anaconda.org/bioconda/biobb_haddock)\n[![](https://img.shields.io/badge/Docker-Quay.io-blue)](https://quay.io/repository/biocontainers/biobb_haddock?tab=tags)\n[![](https://img.shields.io/badge/Singularity-GalaxyProject-blue)](https://depot.galaxyproject.org/singularity/biobb_haddock:5.0.0--pyhdfd78af_0)\n\n[![](https://img.shields.io/badge/OS-Unix%20%7C%20MacOS-blue)](https://github.com/bioexcel/biobb_haddock)\n[![](https://img.shields.io/pypi/pyversions/biobb-haddock.svg?label=Python%20Versions)](https://pypi.org/project/biobb-haddock/)\n[![](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![](https://img.shields.io/badge/Open%20Source%3f-Yes!-blue)](https://github.com/bioexcel/biobb_haddock)\n\n[![](https://readthedocs.org/projects/biobb-haddock/badge/?version=latest&label=Docs)](https://biobb-haddock.readthedocs.io/en/latest/?badge=latest)\n[![](https://img.shields.io/website?down_message=Offline&label=Biobb%20Website&up_message=Online&url=https%3A%2F%2Fmmb.irbbarcelona.org%2Fbiobb%2F)](https://mmb.irbbarcelona.org/biobb/)\n[![](https://img.shields.io/badge/Youtube-tutorials-blue?logo=youtube&logoColor=red)](https://www.youtube.com/@BioExcelCoE/search?query=biobb)\n[![](https://zenodo.org/badge/DOI/10.1038/s41597-019-0177-4.svg)](https://doi.org/10.1038/s41597-019-0177-4)\n[![](https://img.shields.io/endpoint?color=brightgreen&url=https%3A%2F%2Fapi.juleskreuer.eu%2Fcitation-badge.php%3Fshield%26doi%3D10.1038%2Fs41597-019-0177-4)](https://www.nature.com/articles/s41597-019-0177-4#citeas)\n\n[![](https://docs.bioexcel.eu/biobb_haddock/junit/testsbadge.svg)](https://docs.bioexcel.eu/biobb_haddock/junit/report.html)\n[![](https://docs.bioexcel.eu/biobb_haddock/coverage/coveragebadge.svg)](https://docs.bioexcel.eu/biobb_haddock/coverage/)\n[![](https://docs.bioexcel.eu/biobb_haddock/flake8/flake8badge.svg)](https://docs.bioexcel.eu/biobb_haddock/flake8/)\n[![](https://img.shields.io/github/last-commit/bioexcel/biobb_haddock?label=Last%20Commit)](https://github.com/bioexcel/biobb_haddock/commits/master)\n[![](https://img.shields.io/github/issues/bioexcel/biobb_haddock.svg?color=brightgreen&label=Issues)](https://GitHub.com/bioexcel/biobb_haddock/issues/)\n\n[![fair-software.eu](https://img.shields.io/badge/fair--software.eu-%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F-green)](https://fair-software.eu)\n[![](https://www.bestpractices.dev/projects/8847/badge)](https://www.bestpractices.dev/projects/8847)\n\n[](https://bestpractices.coreinfrastructure.org/projects/8847/badge)\n\n[//]: # (The previous line invisible link is for compatibility with the howfairis script https://github.com/fair-software/howfairis-github-action/tree/main wich uses the old bestpractices URL)\n\n# biobb_haddock\n\n## Introduction\nbiobb_haddock is the Biobb module collection to compute information-driven flexible protein-protein docking.\nBiobb (BioExcel building blocks) packages are Python building blocks that\ncreate new layer of compatibility and interoperability over popular\nbioinformatics tools.\nThe latest documentation of this package can be found in our readthedocs site:\n[latest API documentation](http://biobb-haddock.readthedocs.io/en/latest/).\n\n## Version\nv5.0.0 2024.2\n\n## Install CNS\n\n### 1 Download the source code of CNS\n\nIn this case: `cns_solve_1.3_all.tar.gz`\n\nFrom the [CNS site](http://cns-online.org) create a new folder in the Haddock\nfolder and uncompress it.\n\n```bash\n# Replace /__PATH__/__to__/ by your path to the haddock3 directory.\ncd /__PATH__/__to__/haddock3\nmkdir haddock3/CNS\ncp cns_solve_1.3_all.tar.gz haddock3/CNS/\ncd haddock3/CNS/\ntar xvzf cns_solve_1.3_all.tar.gz\n```\n### 2 Download the Intel Fortran and C++ offline compilers\n\nIn this case: `m_fortran-compiler-classic_p_2022.0.0.63_offline.dmg` and `m_cpp-compiler-classic_p_2022.0.0.62_offline.dmg`\n\nFrom the [Intel developers site](https://www.intel.com/content/www/us/en/developer/articles/tool/oneapi-standalone-components.html) and double click to install them.\n\n### 3 Configure the CNS environment\n\n#### 3.1 `cns_solve_env`:\n\n```bash\n# Replace /__PATH__/__to__/ by your path to the haddock3 directory.\ncd /__PATH__/__to__/haddock3/CNS\nvim cns_solve_1.3/cns_solve_env\n```\nModify the `CNS_SOLVE` env var:\n\n```bash\n# CHANGE THE NEXT LINE TO POINT TO THE LOCATION OF THE CNSsolve DIRECTORY\n\n setenv CNS_SOLVE '_CNSsolve_location_'\n\n#\n# ==========================================================================\n```\n\nIn this case:\n\n```bash\n# Replace /__PATH__/__to__/ by your path to the haddock3 directory.\n\n setenv CNS_SOLVE '/__PATH__/__to__/haddock3/CNS/cns_solve_1.3/'\n\n```\n\n#### 3.2 `rtf.inc`:\n\n```bash\n# Replace /__PATH__/__to__/ by your path to the haddock3 directory.\ncd /__PATH__/__to__/haddock3/CNS\nvim cns_solve_1.3/source/rtf.inc\n```\n\nModify all the MX (maximum) variables adding one extra zero to all of them:\n```\nPARAMETER (MXRTRS=200,NICM=50) --> PARAMETER (MXRTRS=2000,NICM=50)\nPARAMETER (MXRTA=2000) --> PARAMETER (MXRTA=20000)\nPARAMETER (MXRTX=2000) --> PARAMETER (MXRTX=20000)\nPARAMETER (MXRTB=2000) --> PARAMETER (MXRTB=20000)\nPARAMETER (MXRTT=3000) --> PARAMETER (MXRTT=30000)\nPARAMETER (MXRTP=2000) --> PARAMETER (MXRTP=20000)\nPARAMETER (MXRTI=2000) --> PARAMETER (MXRTI=20000)\n```\n\n### 4 Compile and link CNS\n\n```bash\n# Replace /__PATH__/__to__/ by your path to the haddock3 directory.\ncd /__PATH__/__to__/haddock3/CNS/cns_solve_1.3\nmake install\n```\n\nIf everything ended well, one of the last output lines will be:\n\n```\ncreated executable file cns_solve-xxxxxxxxx.exe\n```\n\nThe `xxxxxxxxx` will be a different number on each build.\n\nFinally link the CNS binary:\n\n```bash\n# Replace /__PATH__/__to__/ by your path to the haddock3 directory.\ncd /__PATH__/__to__/haddock3\nmkdir -p bin/\n#Replace the `xxxxxxxxx` and the __PATH__TO_BIN__ by your binary file\nln -s CNS/__PATH__TO_BIN__/cns_solve-xxxxxxxxx.exe bin/cns\n```\n\n## Installation\nUsing PIP:\n\n> **Important:** PIP only installs the package. All the dependencies must be installed separately. To perform a complete installation, please use ANACONDA, DOCKER or SINGULARITY.\n\n* Installation:\n\n\n pip install \"biobb_haddock>=5.0.0\"\n\n\n* Usage: [Python API documentation](https://biobb-haddock.readthedocs.io/en/latest/modules.html)\n\nUsing ANACONDA:\n\n* Installation:\n\n\n conda install -c bioconda \"biobb_haddock>=5.0.0\"\n\n\n* Usage: With conda installation BioBBs can be used with the [Python API documentation](https://biobb-haddock.readthedocs.io/en/latest/modules.html) and the [Command Line documentation](https://biobb-haddock.readthedocs.io/en/latest/command_line.html)\n\nUsing DOCKER:\n\n* Installation:\n\n\n docker pull quay.io/biocontainers/biobb_haddock:5.0.0--pyhdfd78af_0\n\n\n* Usage:\n\n\n docker run quay.io/biocontainers/biobb_haddock:5.0.0--pyhdfd78af_0 <command>\n\n\nUsing SINGULARITY:\n\n**MacOS users**: it's strongly recommended to avoid Singularity and use **Docker** as containerization system.\n\n* Installation:\n\n\n singularity pull --name biobb_haddock.sif https://depot.galaxyproject.org/singularity/biobb_haddock:5.0.0--pyhdfd78af_0\n\n\n* Usage:\n\n\n singularity exec biobb_haddock.sif <command>\n\n\nThe command list and specification can be found at the [Command Line documentation](https://biobb-haddock.readthedocs.io/en/latest/command_line.html).\n\n\n## Copyright & Licensing\nThis software has been developed in the [MMB group](http://mmb.irbbarcelona.org) at the [BSC](http://www.bsc.es/) & [IRB](https://www.irbbarcelona.org/) for the [European BioExcel](http://bioexcel.eu/), funded by the European Commission (EU H2020 [823830](http://cordis.europa.eu/projects/823830), EU H2020 [675728](http://cordis.europa.eu/projects/675728)), EU Horizon Europe [101093290] (https://cordis.europa.eu/project/id/101093290).\n\n* (c) 2015-2024 [Barcelona Supercomputing Center](https://www.bsc.es/)\n* (c) 2015-2024 [Institute for Research in Biomedicine](https://www.irbbarcelona.org/)\n\nLicensed under the\n[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0), see the file LICENSE for details.\n\n![](https://bioexcel.eu/wp-content/uploads/2019/04/Bioexcell_logo_1080px_transp.png \"Bioexcel\")\n",
"bugtrack_url": null,
"license": null,
"summary": "biobb_haddock is the Biobb module collection to compute information-driven flexible protein-protein docking.",
"version": "5.0.0",
"project_urls": {
"Bioexcel": "https://bioexcel.eu/",
"Documentation": "http://biobb_haddock.readthedocs.io/en/latest/",
"Homepage": "https://github.com/bioexcel/biobb_haddock"
},
"split_keywords": [
"bioinformatics",
"workflows",
"bioexcel",
"compatibility"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "49933d167303a3d2ef28129e6246de7cdf97c37bb37c3d3a8ad1306e6242fc31",
"md5": "3ce8767279fa2042cf5d34771bbe1f96",
"sha256": "235c89a2042616de1368f9c18d46cb936dcd0303904e149050203c2dd31db6b7"
},
"downloads": -1,
"filename": "biobb_haddock-5.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3ce8767279fa2042cf5d34771bbe1f96",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 36061,
"upload_time": "2024-11-20T09:08:29",
"upload_time_iso_8601": "2024-11-20T09:08:29.240611Z",
"url": "https://files.pythonhosted.org/packages/49/93/3d167303a3d2ef28129e6246de7cdf97c37bb37c3d3a8ad1306e6242fc31/biobb_haddock-5.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "810005fd3565d65137431d4dbfea930fa2972f9cd3713435b6f5cb56d3d2c147",
"md5": "670d4a761c8acaedd9c9d4192fb015f8",
"sha256": "6a41e63280f577e16e923bc1027967c37a3dfca823cc21803324c6fe33786bb8"
},
"downloads": -1,
"filename": "biobb_haddock-5.0.0.tar.gz",
"has_sig": false,
"md5_digest": "670d4a761c8acaedd9c9d4192fb015f8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 19046,
"upload_time": "2024-11-20T09:08:30",
"upload_time_iso_8601": "2024-11-20T09:08:30.294051Z",
"url": "https://files.pythonhosted.org/packages/81/00/05fd3565d65137431d4dbfea930fa2972f9cd3713435b6f5cb56d3d2c147/biobb_haddock-5.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-20 09:08:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bioexcel",
"github_project": "biobb_haddock",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "biobb-haddock"
}