Skip to main content

A plugin for PathMe that allows to explore overlaps across pathway databases.

Project description

This web application aims to facilitate querying, browsing, and navigating pathway knowledge formalized in Biological Expression Language (BEL). While it was built paralelly with PathMe , to facilitate the exploration of the databases harmonized by this package, the PathMe Viewer supports the visualization of BEL files. BEL files can be stored in the PathMe Viewer’s database and so they queried in the main page. In this page, users can select multiple BEL files (pathways) to renders the corresponding merged network in a user-friendly visualization powered by multiple built-in functionalities.

This web application is publicly accessible at http://pathme.scai.fraunhofer.de/ but can be locally deployed using Docker or PyPI (see Installation/Deployment sections).

Citation

If you use PathMe in your work, please cite:

Domingo-Fernández, D., et al. (2018). PathMe: Merging and exploring mechanistic pathway knowledge. bioRxiv 451625.

How to Use

Exploring pathways through this web application is simple. First, select a set of pathways from different databases. To choose a pathway, first select a database and the autocompletion form will then guide you to find pathway(s) of interest to you. After pathways have been selected, click on the “Explore” button to render the merged network corresponding to the selected pathways.

https://github.com/ComPath/PathMe-Viewer/blob/master/src/pathme_viewer/static/img/main_page_screenshot.png

The resulting network is visualized in the next page where multiple functionalities enable the exploration of the pathway(s).

https://github.com/ComPath/PathMe-Viewer/blob/master/src/pathme_viewer/static/img/visualization_example.png

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

PathMe can be installed easily from PyPI running the following code in your terminal:

$ python3 -m pip install pathme_viewer

or from the latest code on GitHub with:

$ python3 -m pip install git+https://github.com/ComPath/PathMe-Viewer.git@master

Database

In order to visualize BEL files with the viwer, you have to load them into the databases. The following command to loads the databases converted to BEL by PathMe (note that the first time it runs might take a couple of hours). Additionally, users can customize the imports to other bel files or databases (please see the documentation page ).

python3 -m pathme_viewer manage load

In order to check the status of the database, you can run:

python3 -m pathme_viewer manage summarize

The content of the database can be erased by running:

python3 -m pathme_viewer manage drop

Deployment

If you have already installed the PathMe-Viewer as a Python package and you have already populated the database, now you can deploy the web application by running:

python3 -m pip install pathme_viewer web

Note that the database runs by default in the following port: http://0.0.0.0:5000/. The Flask host and port can be modified by changing the default parameters (run: “python3 -m pathme_viewer web –help” for more info).

Deployment of PathMe Viewer using Docker

To quickly deploy the web application locally, you can also use Docker. This can be achieved by running the following commands after installing Docker.

  1. Build a container named ‘pathme’ version 0.0.1 (you must be in the root directory after cloning this package with Git).

docker build -t pathme:0.0.1 .
  1. Run docker the pathme container version 0.0.1.

docker run --name=pathme -d -p 5000:5000 --restart=always -d pathme:0.0.1

Note: the docker file is meant to be run on 0.0.0.0:5000. If you want to change the host/port please modify dockerfile (line 55) and src/bin/bootstrap.sh (line 23).

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_viewer-0.0.6.tar.gz (739.4 kB view details)

Uploaded Source

File details

Details for the file pathme_viewer-0.0.6.tar.gz.

File metadata

  • Download URL: pathme_viewer-0.0.6.tar.gz
  • Upload date:
  • Size: 739.4 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.23.0 CPython/3.6.5

File hashes

Hashes for pathme_viewer-0.0.6.tar.gz
Algorithm Hash digest
SHA256 f60de5e9e0ee0adfc4b8d58911f1793b33bcf8499004eac412a4f2f3f40fbb75
MD5 29184df5d8548e48063b90ef3271fc5b
BLAKE2b-256 c38c17d36ccbe8d10071819117ece53df39d4141bccd0d16b0f90f89a3c89fe9

See more details on using hashes here.

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