Skip to main content

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 cite [1]:

Installation Current version on PyPI Stable Supported Python Versions Apache-2.0

  1. pathme can be installed with the following commands:

$ python3 -m pip install git+https://github.com/ComPath/PathMe.git@master
  1. 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:

  1. 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):

$ python3 -m pathme 'database' download
  1. 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
  1. 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 (see KEGG Terms and conditions.).

Reactome

WikiPathways

Project details


Download files

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

Source Distribution

pathme-0.0.11.tar.gz (609.6 kB view details)

Uploaded Source

Built Distribution

pathme-0.0.11-py3-none-any.whl (50.9 kB view details)

Uploaded Python 3

File details

Details for the file pathme-0.0.11.tar.gz.

File metadata

  • Download URL: pathme-0.0.11.tar.gz
  • Upload date:
  • Size: 609.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.5

File hashes

Hashes for pathme-0.0.11.tar.gz
Algorithm Hash digest
SHA256 9d7c08a09a9661d774c6c3627113b03653b179215fbe8baebe95c0a924a49465
MD5 31e0c01ef2893e578a6d9321258314c5
BLAKE2b-256 9b6d83128376ca0234974dce8275ea7387d58b3649f352eea9cc5ab8c90b08e9

See more details on using hashes here.

Provenance

File details

Details for the file pathme-0.0.11-py3-none-any.whl.

File metadata

  • Download URL: pathme-0.0.11-py3-none-any.whl
  • Upload date:
  • Size: 50.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.5

File hashes

Hashes for pathme-0.0.11-py3-none-any.whl
Algorithm Hash digest
SHA256 4c9bbc93dba47d62abd7178ed8b957e83106c1b137bcf1c4084d8cbe83b73b7f
MD5 0a900e6e4fa826fee3c108f0d2310fa9
BLAKE2b-256 792e0a5ff155e302bd8390096e3f1fe879da0c76142db4abb64bca84ffd5ca4c

See more details on using hashes here.

Provenance

Supported by

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