pyham


Namepyham JSON
Version 1.2.0 PyPI version JSON
download
home_pagehttp://lab.dessimoz.org/ham
SummaryA tool to analyse Hierarchical Orthologous Groups (HOGs)
upload_time2024-03-19 15:51:17
maintainer
docs_urlNone
authorDessimoz Lab - Laboratory of Computational Evolutionary Biology and Genomics
requires_python
licenseMIT
keywords orthology hogs orthoxml
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            pyHam: A Tool to Analyze Hierarchical Orthologous Groups (HOGs)
===============================================================


Motivation
----------
pyHam is a library to facilitate the analysis of hierarchical orthologous groups.
It also contains a few tools to run standard type of analysis.

Currently, Ham is limited to analyze HOGs that are stored in an orthoXML file.
More information on the schema of orthoxml and some examples are
available at http://orthoxml.org.

For extended documentation we refer to the docs folder that contain information
on common use cases and API documentation of the library.

How to cite pyHam
-----------------
If you use pyHam in your work, please consider citing:

*Clément-Marie Train, Miguel Pignatelli, Adrian Altenhoff, Christophe Dessimoz; iHam and pyHam: visualizing and processing hierarchical orthologous groups, Bioinformatics, bty994, https://doi.org/10.1093/bioinformatics/bty994*

Installation
------------
Ham is written in python3 (also compatible with python2), with little external dependencies, i.e.
currently ete3, lml, six. The setup script should resolve these
dependencies automatically.
Consider using pip to install the package directly from a checked out git repo

.. code-block:: sh

   python -m pip install --upgrade pip
   pip install pyham

Example
-------
We prepare a ready-to-use example (see example folder) with few python scripts to use main pyHam features.
You just have to run the following command in bash:

.. code-block:: sh

   python run_hog_queries.py
   python run_treeProfile.py
   python run_iHam.py

Getting started
---------------
We create a small introductory blog post about HOGs and pyHam at http://lab.dessimoz.org/blog/2017/06/29/pyham. We highly recommend you to read it before starting using pyHam.

We also create an ipython notebook to help you with basic uses of pyHam API and embedded tools at http://zoo.cs.ucl.ac.uk/tutorials/tutorial_pyHam_get_started.html.

Table of compatibility
----------------------

Support for pyHam by various HOG inference resources.

+-----------------+------------------------------+---------------------------------------+-----------+
| Resource        | Species tree format          | OrthoXML                              | SUPPORT   |
+=================+==============================+=======================================+===========+
||OMA browser|_   | |PhyloXMLo|_ and |Newicko|_  ||All HOGso|_ , or |one HOG at a timeo|_|    YES    |
+-----------------+------------------------------+---------------------------------------+-----------+
||OMA standalone|_| PhyloXML and Newick          | All HOGs                              |    YES    |
+-----------------+------------------------------+---------------------------------------+-----------+
| |Ensembl|_      | |Newicke|_                   |    one HOG at a time                  |    YES    |
+-----------------+------------------------------+---------------------------------------+-----------+
| |HieranoidDB|_  | |Newickh|_                   |    one HOG at a time                  |    YES    |
+-----------------+------------------------------+---------------------------------------+-----------+

.. |OMA browser| replace:: ``OMA browser``
.. |OMA standalone| replace:: ``OMA standalone``
.. |Ensembl| replace:: ``Ensembl``
.. |HieranoidDB| replace:: ``HieranoidDB``

.. |PhyloXMLo| replace:: ``PhyloXML``
.. |Newicko| replace:: ``Newick``
.. |PhyloXMLs| replace:: ``PhyloXML``
.. |Newicks| replace:: ``Newick``
.. |Newicke| replace:: ``Newick``
.. |Newickh| replace:: ``Newick``

.. |All HOGso| replace:: ``All HOGs``
.. |one HOG at a timeo| replace:: ``one HOG at a time``

.. _OMA browser: https://omabrowser.org
.. _OMA standalone: https://omabrowser.org/standalone/
.. _Ensembl: https://www.ensembl.org/index.html
.. _HieranoidDB: http://hieranoidb.sbc.su.se/

.. _PhyloXMLo: https://omabrowser.org/All/speciestree.phyloxml
.. _Newicko: https://omabrowser.org/All/speciestree.nwk
.. _Newicke: https://www.ensembl.org/info/about/speciestree.html
.. _Newickh: http://hieranoid.sbc.su.se/download/H2/66c.tree

.. _All HOGso:  https://omabrowser.org/All/oma-hogs.orthoXML.gz
.. _one HOG at a timeo:  https://omabrowser.org/oma/hogs/


Documentation
-------------
You can the full documentation of pyHam at http://zoo.cs.ucl.ac.uk/doc/pyham/index.html



            

Raw data

            {
    "_id": null,
    "home_page": "http://lab.dessimoz.org/ham",
    "name": "pyham",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "orthology, HOGs, orthoxml",
    "author": "Dessimoz Lab - Laboratory of Computational Evolutionary Biology and Genomics",
    "author_email": "adrian.altenhoff@inf.ethz.ch",
    "download_url": "https://files.pythonhosted.org/packages/e8/66/5117721c04795e302c9832712a2f19e2fbc06f3ec98a97ec348cf0272a24/pyham-1.2.0.tar.gz",
    "platform": null,
    "description": "pyHam: A Tool to Analyze Hierarchical Orthologous Groups (HOGs)\n===============================================================\n\n\nMotivation\n----------\npyHam is a library to facilitate the analysis of hierarchical orthologous groups.\nIt also contains a few tools to run standard type of analysis.\n\nCurrently, Ham is limited to analyze HOGs that are stored in an orthoXML file.\nMore information on the schema of orthoxml and some examples are\navailable at http://orthoxml.org.\n\nFor extended documentation we refer to the docs folder that contain information\non common use cases and API documentation of the library.\n\nHow to cite pyHam\n-----------------\nIf you use pyHam in your work, please consider citing:\n\n*Cl\u00e9ment-Marie Train, Miguel Pignatelli, Adrian Altenhoff, Christophe Dessimoz; iHam and pyHam: visualizing and processing hierarchical orthologous groups, Bioinformatics, bty994, https://doi.org/10.1093/bioinformatics/bty994*\n\nInstallation\n------------\nHam is written in python3 (also compatible with python2), with little external dependencies, i.e.\ncurrently ete3, lml, six. The setup script should resolve these\ndependencies automatically.\nConsider using pip to install the package directly from a checked out git repo\n\n.. code-block:: sh\n\n   python -m pip install --upgrade pip\n   pip install pyham\n\nExample\n-------\nWe prepare a ready-to-use example (see example folder) with few python scripts to use main pyHam features.\nYou just have to run the following command in bash:\n\n.. code-block:: sh\n\n   python run_hog_queries.py\n   python run_treeProfile.py\n   python run_iHam.py\n\nGetting started\n---------------\nWe create a small introductory blog post about HOGs and pyHam at http://lab.dessimoz.org/blog/2017/06/29/pyham. We highly recommend you to read it before starting using pyHam.\n\nWe also create an ipython notebook to help you with basic uses of pyHam API and embedded tools at http://zoo.cs.ucl.ac.uk/tutorials/tutorial_pyHam_get_started.html.\n\nTable of compatibility\n----------------------\n\nSupport for pyHam by various HOG inference resources.\n\n+-----------------+------------------------------+---------------------------------------+-----------+\n| Resource        | Species tree format          | OrthoXML                              | SUPPORT   |\n+=================+==============================+=======================================+===========+\n||OMA browser|_   | |PhyloXMLo|_ and |Newicko|_  ||All HOGso|_ , or |one HOG at a timeo|_|    YES    |\n+-----------------+------------------------------+---------------------------------------+-----------+\n||OMA standalone|_| PhyloXML and Newick          | All HOGs                              |    YES    |\n+-----------------+------------------------------+---------------------------------------+-----------+\n| |Ensembl|_      | |Newicke|_                   |    one HOG at a time                  |    YES    |\n+-----------------+------------------------------+---------------------------------------+-----------+\n| |HieranoidDB|_  | |Newickh|_                   |    one HOG at a time                  |    YES    |\n+-----------------+------------------------------+---------------------------------------+-----------+\n\n.. |OMA browser| replace:: ``OMA browser``\n.. |OMA standalone| replace:: ``OMA standalone``\n.. |Ensembl| replace:: ``Ensembl``\n.. |HieranoidDB| replace:: ``HieranoidDB``\n\n.. |PhyloXMLo| replace:: ``PhyloXML``\n.. |Newicko| replace:: ``Newick``\n.. |PhyloXMLs| replace:: ``PhyloXML``\n.. |Newicks| replace:: ``Newick``\n.. |Newicke| replace:: ``Newick``\n.. |Newickh| replace:: ``Newick``\n\n.. |All HOGso| replace:: ``All HOGs``\n.. |one HOG at a timeo| replace:: ``one HOG at a time``\n\n.. _OMA browser: https://omabrowser.org\n.. _OMA standalone: https://omabrowser.org/standalone/\n.. _Ensembl: https://www.ensembl.org/index.html\n.. _HieranoidDB: http://hieranoidb.sbc.su.se/\n\n.. _PhyloXMLo: https://omabrowser.org/All/speciestree.phyloxml\n.. _Newicko: https://omabrowser.org/All/speciestree.nwk\n.. _Newicke: https://www.ensembl.org/info/about/speciestree.html\n.. _Newickh: http://hieranoid.sbc.su.se/download/H2/66c.tree\n\n.. _All HOGso:  https://omabrowser.org/All/oma-hogs.orthoXML.gz\n.. _one HOG at a timeo:  https://omabrowser.org/oma/hogs/\n\n\nDocumentation\n-------------\nYou can the full documentation of pyHam at http://zoo.cs.ucl.ac.uk/doc/pyham/index.html\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A tool to analyse Hierarchical Orthologous Groups (HOGs)",
    "version": "1.2.0",
    "project_urls": {
        "Homepage": "http://lab.dessimoz.org/ham"
    },
    "split_keywords": [
        "orthology",
        " hogs",
        " orthoxml"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b9b0478849baee68624097ecf24c134f72d9feec90f4d85df6f7a38fa5c8eb33",
                "md5": "dc02645d4c65f5559988fe8c680c9174",
                "sha256": "57c91020ceb4d55dc5e8bfff40ad83d2410e15dad35f2d5c4bcbf4451031ad88"
            },
            "downloads": -1,
            "filename": "pyham-1.2.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "dc02645d4c65f5559988fe8c680c9174",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": null,
            "size": 37747,
            "upload_time": "2024-03-19T15:51:15",
            "upload_time_iso_8601": "2024-03-19T15:51:15.029146Z",
            "url": "https://files.pythonhosted.org/packages/b9/b0/478849baee68624097ecf24c134f72d9feec90f4d85df6f7a38fa5c8eb33/pyham-1.2.0-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e8665117721c04795e302c9832712a2f19e2fbc06f3ec98a97ec348cf0272a24",
                "md5": "2f17cfaa05a594dd8db15b97b865f52d",
                "sha256": "4a8fd4e11ccf05fb52c185618393c179b3266442d03286be19b7828493fe0cde"
            },
            "downloads": -1,
            "filename": "pyham-1.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2f17cfaa05a594dd8db15b97b865f52d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 95019,
            "upload_time": "2024-03-19T15:51:17",
            "upload_time_iso_8601": "2024-03-19T15:51:17.435040Z",
            "url": "https://files.pythonhosted.org/packages/e8/66/5117721c04795e302c9832712a2f19e2fbc06f3ec98a97ec348cf0272a24/pyham-1.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-19 15:51:17",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "pyham"
}
        
Elapsed time: 0.20127s