Skip to main content

A tool to analyse Hierarchical Orthologous Groups (HOGs)

Project description


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

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,


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

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


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:


Getting started

We create a small introductory blog post about HOGs and pyHam at 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

Table of compatibility

Support for pyHam by various HOG inference resources.


Species tree format



OMA browser

PhyloXML and Newick

All HOGs , or one HOG at a time


OMA standalone

PhyloXML and Newick

All HOGs




one HOG at a time




one HOG at a time



You can the full documentation of pyHam at

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyham-1.1.11.tar.gz (74.7 kB view hashes)

Uploaded source

Built Distribution

pyham-1.1.11-py2.py3-none-any.whl (37.0 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page