.. image:: https://raw.githubusercontent.com/monteirotorres/ProtCHOIR/master/ProtCHOIR/Contents/ProtCHOIR.svg?sanitize=true
.. image:: https://zenodo.org/badge/205372962.svg
:target: https://zenodo.org/badge/latestdoi/205372962
ProtCHOIR
############
This pipeline was devised to create homo-oligomeric structures based on selected subsets of the PDB databank.
With ProtCHOIR you can supply either a sequence in FASTA format or a protomeric structure in the PDB format to obtain homo-oligomeric models based on homologues.
Prerequisites
*************
The following packages and external programs are used by ProtCHOIR scripts and must be installed and in either the binaries path or python path.
Python packages
===============
- progressbar2
- pandas
- biopython
- pathlib
- parasail
- networkx
- jinja2
- numpy
- matplotlib
External software (must be installed separately)
================================================
- `PyMOL`_
- `parasail`_
- `PSI-BLAST`_
- `MAFFT`_
- `PISA`_
- `GESAMT`_
- `Molprobity`_
- `Modeller`_
- `TMHMM`_
.. _`PyMol`: https://sourceforge.net/projects/pymol/
.. _`parasail`: https://github.com/jeffdaily/parasail
.. _`PSI-BLAST`: https://blast.ncbi.nlm.nih.gov/Blast.cgi?CMD=Web&PAGE_TYPE=BlastDocs&DOC_TYPE=Download
.. _`MAFFT`: https://mafft.cbrc.jp/alignment/software/
.. _`PISA`: http://www.ccp4.ac.uk
.. _`GESAMT`: http://www.ccp4.ac.uk
.. _`Molprobity`: http://www.ccp4.ac.uk
.. _`Modeller`: https://salilab.org/modeller/
.. _`TMHMM`: http://www.cbs.dtu.dk/cgi-bin/nph-sw_request?tmhmm
Note: PISA, GESAMT and MolProbity may be installed as part of the `CCP4 Software Suite`_
.. _`CCP4 Software Suite`: http://www.ccp4.ac.uk
Installation
************
The scripts are available as a `PyPi project`_. Just install them with:
.. _`PyPi project`: https://pypi.org/project/ProtCHOIR/
:code:`pip install ProtCHOIR`
Initial Setup
*************
If that is the first time you are running ProtCHOIR and you do not provide a configuration file (with --conf), the program will ask whether you desire the configuration file to be created.
This configuration file simply has the paths to all the external software that are necessary.
The file also contains the path to a locally generated database (referred to as "choirdb") in which it will look for possible homo-oligomeric proteins to serve as templates for modelling.
Make sure that the directory to which the choirdb variable is pointing actually exists.
The choirdb must be created locally and is a lengthy process whose total duration will depend on the processing capabilities of your machine. In the process, the whole pdb database will be downloaded, analysed and sorted in the expected directories.
Initial creation of the local database can be done with:
:code:`ProtCHOIR -v -u --conf conf_file`
Subsequent updates will not re-download and re-analyse the whole PDB database, but only the new (or updated) entries.
Usage
*****
After the initial database set-up, you may run the program normally via command line, by invoking the ProtCHOIR executable and providing an input file either in PDB or FASTA format.
:code:`ProtCHOIR -v -f protomer.pdb --conf conf_file`
If no conf file is yet in place, ProtCHOIR will ask you whether you want a default one to be generated, just run:
:code:`ProtCHOIR`
And then modify the generated configuration file to match your environment.
To generate a full html report with detailed model analysis as output, run the program with:
:code:`ProtCHOIR -v -f protomer.pdb --generate-report --conf conf_file`
To expose all available runtime options, run:
:code:`ProtCHOIR -h`
Methodology Flowchart
*********************
The image below summarizes the approach used by ProtCHOIR to build the homo-oligomeric proteins.
.. image:: https://raw.githubusercontent.com/monteirotorres/ProtCHOIR/master/ProtCHOIR/Contents/ProtCHOIRScheme.svg?sanitize=true
Authors
*******
Pedro Torres, Ph.D;
Tom Blundell, FRS, FMedSci.
Department Of Biochemistry
University of Cambridge
80 Tennis Court Road
Cambridge CB2 1GA
License
*******
This project is licensed under Creative Commons license (CC-BY-4.0_), provided along with the package - see `LICENSE`_.
.. _LICENSE: https://github.com/monteirotorres/ProtCHOIR/blob/master/LICENSE.txt
.. _CC-BY-4.0: https://creativecommons.org/licenses/by/4.0/
.. image:: https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/by.svg
:target: https://creativecommons.org/licenses/by/4.0/
Raw data
{
"_id": null,
"home_page": "https://github.com/monteirotorres/ProtCHOIR",
"name": "ProtCHOIR",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "PDB,structure,protein,oligomerization,oligomers,multimer",
"author": "Pedro Torres, Tom Blundell",
"author_email": "monteirotorres@biof.ufrj.br",
"download_url": "",
"platform": null,
"description": ".. image:: https://raw.githubusercontent.com/monteirotorres/ProtCHOIR/master/ProtCHOIR/Contents/ProtCHOIR.svg?sanitize=true\n\n.. image:: https://zenodo.org/badge/205372962.svg\n :target: https://zenodo.org/badge/latestdoi/205372962\n\nProtCHOIR\n############\n\nThis pipeline was devised to create homo-oligomeric structures based on selected subsets of the PDB databank.\n\nWith ProtCHOIR you can supply either a sequence in FASTA format or a protomeric structure in the PDB format to obtain homo-oligomeric models based on homologues.\n\n\nPrerequisites\n*************\n\nThe following packages and external programs are used by ProtCHOIR scripts and must be installed and in either the binaries path or python path.\n\nPython packages\n===============\n\n - progressbar2\n - pandas\n - biopython\n - pathlib\n - parasail\n - networkx\n - jinja2\n - numpy\n - matplotlib\n\n\nExternal software (must be installed separately)\n================================================\n\n - `PyMOL`_\n - `parasail`_\n - `PSI-BLAST`_\n - `MAFFT`_\n - `PISA`_\n - `GESAMT`_\n - `Molprobity`_\n - `Modeller`_\n - `TMHMM`_\n\n\n.. _`PyMol`: https://sourceforge.net/projects/pymol/\n.. _`parasail`: https://github.com/jeffdaily/parasail\n.. _`PSI-BLAST`: https://blast.ncbi.nlm.nih.gov/Blast.cgi?CMD=Web&PAGE_TYPE=BlastDocs&DOC_TYPE=Download\n.. _`MAFFT`: https://mafft.cbrc.jp/alignment/software/\n.. _`PISA`: http://www.ccp4.ac.uk\n.. _`GESAMT`: http://www.ccp4.ac.uk\n.. _`Molprobity`: http://www.ccp4.ac.uk\n.. _`Modeller`: https://salilab.org/modeller/\n.. _`TMHMM`: http://www.cbs.dtu.dk/cgi-bin/nph-sw_request?tmhmm\n\nNote: PISA, GESAMT and MolProbity may be installed as part of the `CCP4 Software Suite`_\n\n.. _`CCP4 Software Suite`: http://www.ccp4.ac.uk\n\n\nInstallation\n************\nThe scripts are available as a `PyPi project`_. Just install them with:\n\n.. _`PyPi project`: https://pypi.org/project/ProtCHOIR/\n\n\n:code:`pip install ProtCHOIR`\n\n\nInitial Setup\n*************\nIf that is the first time you are running ProtCHOIR and you do not provide a configuration file (with --conf), the program will ask whether you desire the configuration file to be created.\nThis configuration file simply has the paths to all the external software that are necessary.\n\nThe file also contains the path to a locally generated database (referred to as \"choirdb\") in which it will look for possible homo-oligomeric proteins to serve as templates for modelling.\n\nMake sure that the directory to which the choirdb variable is pointing actually exists.\n\nThe choirdb must be created locally and is a lengthy process whose total duration will depend on the processing capabilities of your machine. In the process, the whole pdb database will be downloaded, analysed and sorted in the expected directories.\n\nInitial creation of the local database can be done with:\n\n:code:`ProtCHOIR -v -u --conf conf_file`\n\nSubsequent updates will not re-download and re-analyse the whole PDB database, but only the new (or updated) entries.\n\nUsage\n*****\nAfter the initial database set-up, you may run the program normally via command line, by invoking the ProtCHOIR executable and providing an input file either in PDB or FASTA format.\n\n:code:`ProtCHOIR -v -f protomer.pdb --conf conf_file`\n\nIf no conf file is yet in place, ProtCHOIR will ask you whether you want a default one to be generated, just run:\n\n:code:`ProtCHOIR`\n\nAnd then modify the generated configuration file to match your environment.\n\nTo generate a full html report with detailed model analysis as output, run the program with:\n\n:code:`ProtCHOIR -v -f protomer.pdb --generate-report --conf conf_file`\n\nTo expose all available runtime options, run:\n\n:code:`ProtCHOIR -h`\n\nMethodology Flowchart\n*********************\n\nThe image below summarizes the approach used by ProtCHOIR to build the homo-oligomeric proteins.\n\n.. image:: https://raw.githubusercontent.com/monteirotorres/ProtCHOIR/master/ProtCHOIR/Contents/ProtCHOIRScheme.svg?sanitize=true\n\n\n\nAuthors\n*******\nPedro Torres, Ph.D;\nTom Blundell, FRS, FMedSci.\n\nDepartment Of Biochemistry\nUniversity of Cambridge\n80 Tennis Court Road\nCambridge CB2 1GA\n\n\n\nLicense\n*******\n\nThis project is licensed under Creative Commons license (CC-BY-4.0_), provided along with the package - see `LICENSE`_.\n\n.. _LICENSE: https://github.com/monteirotorres/ProtCHOIR/blob/master/LICENSE.txt\n\n.. _CC-BY-4.0: https://creativecommons.org/licenses/by/4.0/\n\n.. image:: https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/by.svg\n :target: https://creativecommons.org/licenses/by/4.0/\n",
"bugtrack_url": null,
"license": "CC-BY-4.0",
"summary": "A Modeller-based pipeline to generate homo-oligomers.",
"version": "1.2.25",
"project_urls": {
"Homepage": "https://github.com/monteirotorres/ProtCHOIR"
},
"split_keywords": [
"pdb",
"structure",
"protein",
"oligomerization",
"oligomers",
"multimer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9796034026a2b5fbf337d0dc01bcc2dc97641cf9e225ae39be11677fb24eabb4",
"md5": "efeb7bf46d4365c0f192ae266a30193e",
"sha256": "7be8a9835089039a1ca956a1aeb95e19bbc8d906ffe8546060c31a70b3318b72"
},
"downloads": -1,
"filename": "ProtCHOIR-1.2.25-py3-none-any.whl",
"has_sig": false,
"md5_digest": "efeb7bf46d4365c0f192ae266a30193e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 102478,
"upload_time": "2023-06-26T20:37:54",
"upload_time_iso_8601": "2023-06-26T20:37:54.121389Z",
"url": "https://files.pythonhosted.org/packages/97/96/034026a2b5fbf337d0dc01bcc2dc97641cf9e225ae39be11677fb24eabb4/ProtCHOIR-1.2.25-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-26 20:37:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "monteirotorres",
"github_project": "ProtCHOIR",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "protchoir"
}
JSON
