Harmonizing pathway databases using Biological Expression Language (BEL)
Project description
PathMe is a Python package aimed to convert KEGG [2] [3] [4], Reactome [5] [6], and WikiPathways [7] [8] [9] to Biological Expression Language (BEL).
It is the continuation of the ComPath web application aimed at exploring, analyzing, and curating pathway knowledge in a gene-centric view. This different approach involves converting all the pathways in these resources into BEL as a pivotal integration schema to harmonize entities and relationships in order across these multiple resources; thus, enabling a more comprehensive evaluation of pathway cross-talks, consensus, and boundaries. Additionally, PathMe is complemented with the PathMe-Viewer, a web application that enables querying, browsing, and navigating pathway knowledge assisted by a user-friendly visualization.
Citation
If you use PathMe in your work, please consider citing:
Installation
pathme can be installed with the following commands:
$ python3 -m pip install git+https://github.com/ComPath/PathMe.git@master
or in editable mode with:
$ git clone https://github.com/ComPath/PathMe.git
$ cd pathme
$ python3 -m pip install -e .
How to Use
Before using PathMe, make sure you have installed and populated the Bio2BEL HGNC and Bio2BEL ChEBI databases (Simple run:”python3 -m bio2bel_hgnc populate” and “python3 -m bio2bel_chebi populate”) in your favourite terminal.
Each database has three main commands: download, bel, and summarize:
Download content
PathMe first requires to download the raw files from the original pathway databases. This can be accomplished by running the command (‘database’ can be either KEGG, Reactome, or WikiPathways). E.g., python3 -m pathme kegg download
$ python3 -m pathme <database> download
Generate BEL Graphs
Once the raw files are downloaded, you can run the following to command to generate BELGraphs that will be exported as Python pickles files for further analysis. Furthermore, the conversion to BEL can be tuned differently for each database by using specific commands. For example, KEGG parameters are shown when running “python3 -m pathme kegg bel –help”. Finally, please bear in mind that converting the Reactome files take up to 8 hours due to the large amount of its RDF file.
$ python3 -m pathme <database> bel
Summarize
Summarizes the result of the conversion to BEL.
$ python3 -m pathme <database> summarize
Advanced Parameters
KEGG Functionalities
The KEGG module of PathMe is able to handle KGML differently depending on the goal. By default, KEGG groups together the complex of nodes (e.g., gene families) into one node as it is depicted in the KEGG cartoons and represented in the KGML files. However, this behavior can be modified by adding the parameter –flatten=True in the exporting command. Example:
$ python3 -m pathme kegg bel --flatten
References
KEGG
PathMe makes use of KEGG KGML files that are downloaded via the KEGG API for academic purposes (please make sure you comply their Terms and Conditions).
Kanehisa, et al. (2017) KEGG: new perspectives on genomes, pathways, diseases and drugs. Nucleic Acids Res. 45, D353-D361.
Kanehisa, M., et al. (2016). KEGG as a reference resource for gene and protein annotation. Nucleic Acids Res. 44, D457-D462.
Kanehisa, M. and Goto, S. (2000). KEGG: Kyoto Encyclopedia of Genes and Genomes. Nucleic Acids Res. 28, 27-30.
Reactome
Fabregat, A et al. (2016). The Reactome Pathway Knowledgebase. Nucleic Acids Research 44. Database issue: D481–D487.
Croft, D et al. (2014). The Reactome Pathway Knowledgebase. Nucleic Acids Research 42.Database issue: D472–D477.
WikiPathways
Slenter, D.N., et al. (2017). WikiPathways: a multifaceted pathway database bridging metabolomics to other omics research. Nucleic Acids Research, doi.org/10.1093/nar/gkx1064
Kutmon, M., et al. (2016). WikiPathways: capturing the full diversity of pathway knowledge Nucl. Acids Res., 44, D488-D494.
Kelder, T., et al. (201). WikiPathways: building research communities on biological pathways. Nucleic Acids Res. Jan;40(Database issue):D1301-7
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pathme-0.1.8.tar.gz
.
File metadata
- Download URL: pathme-0.1.8.tar.gz
- Upload date:
- Size: 173.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/39.1.0 requests-toolbelt/0.8.0 tqdm/4.31.1 CPython/3.6.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c0aa41fdf830fa29f4f4a110d9fe005debba16831d28470f78d0cbdb59d3884e |
|
MD5 | d9f297122d30281b5bd2eef39a9b9e3e |
|
BLAKE2b-256 | 5b83cd5a0271c09282e192604170383896ea3727966d1ce4d948965209312ea5 |