drug2ways

A Python package for drug discovery by analyzing causal paths on multiscale networks

https://github.com/drug2ways/drug2ways

Science Score: 23.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.3%) to scientific vocabulary

Keywords

bioinformatics causal-networks drug-discovery networks-biology software systems-biology
Last synced: 6 months ago · JSON representation

Repository

A Python package for drug discovery by analyzing causal paths on multiscale networks

Basic Info
Statistics
  • Stars: 27
  • Watchers: 4
  • Forks: 7
  • Open Issues: 0
  • Releases: 9
Topics
bioinformatics causal-networks drug-discovery networks-biology software systems-biology
Created over 5 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

drug2ways

Travis CI License DOI

Drug2ways is a Python package for reasoning over paths on biological networks for drug discovery

QuickstartApplicationsInstallation

Quickstart

Drug2ways supports generic network formats such as JSON, CSV, GraphML, or GML. Check out drug2ways's documentation here. Ideally, the network should contain three different types of nodes representing drugs, proteins, and indications/phenotypes. The hypothesis underlying this software is that by reasoning over a multitude of possible paths between a given drug and indication, the drug regulates the indication in the direction of the signs of the most frequently occurring paths (i.e., majority rule). In other words, we assume that a drug has a greater likelihood of interacting with its target, and its target with intermediate nodes, to modulate a pathological phenotype as the number of possible paths connecting a drug to the phenotype increases. Based on this hypothesis, this software can be applied for different applications outlined in the next section.

Citation

If you use drug2ways for your research please cite our paper:

Daniel Rivas-Barragan, Sarah Mubeen, Francesc Guim-Bernat,Martin Hofmann-Apitius, and Daniel Domingo-Fernández (2020). Drug2ways: Reasoning over causal paths in biological networks for drug discovery. PLOS Computational Biology 16(12): e1008464; https://doi.org/10.1371/journal.pcbi.1008464

Applications

Drug2ways can be applied for three different applications:

Scripts and real examples: https://github.com/drug2ways/drug2ways/tree/master/examples

1. Identifying candidate drugs

The following command of the command line interface (CLI) of drug2ways enables candidate drug identification. The minimum required input are the path to the network and its format, a path to the nodes considered as drugs and the ones considered as conditions/phenotypes. Finally, the maximum length allowed for a given path (i.e., lmax). Type "python -m drug2ways explore --help" to see other optional arguments.

python python -m drug2ways explore \ --graph=<path-to-graph> \ --fmt=<format> \ --sources=<sources> \ --targets=<targets> \ --lmax=<lmax>

2. Optimization of drugs' effects

The following command of the CLI of drug2ways enables searching drugs that not only target a given disease but also activate/inhibit a set of phenotypes. This method requires the same arguments as the previous explore functionality but the target file requires an additional second column where the desired effect on the node (e.g., 'node1,activate') is specified. See the examples directory for more information.

python python -m drug2ways optimize \ --graph=<path-to-graph> \ --fmt=<format> \ --sources=<sources> \ --targets=<targets> \ # Note that this file is slightly different than the other targets --lmax=<lmax>

3. Proposing combination therapies

The following command of the CLI of drug2ways enables the identification of candidate drugs for combination therapies. The minimum required input are the path to the network and its format, a path to the nodes considered as drugs and the ones considered as conditions/phenotypes. As with the optimization command, here again the target file requires an additional second column specifying the desired effect on the node (e.g., 'node1,activate'). Furthermore, the maximum length allowed for a given path (i.e., lmax) and the possible number of combinations of drugs must be provided. Type "python -m drug2ways combine --help" to see other optional arguments.

python python -m drug2ways combine \ --graph=<path-to-graph> \ --fmt=<format> \ --sources=<sources> \ --targets=<targets> \ --lmax=<lmax> \ --combination-length=<number>

Installation

Documentation Stable Supported Python Versions PyPi

The latest stable code can be installed from PyPI with:

python python -m pip install drug2ways

The most recent code can be installed from the source on GitHub with:

python python -m pip install git+https://github.com/drug2ways/drug2ways.git

For developers, the repository can be cloned from GitHub and installed in editable mode with:

python git clone https://github.com/drug2ways/drug2ways.git cd drug2ways python -m pip install -e .

Requirements

python click==7.1.1 tqdm==4.47.0 networkx>=2.1 pandas==1.0.3 networkx>=2.4 numpy scipy statsmodels

Owner

  • Name: Drug2Ways
  • Login: drug2ways
  • Kind: organization
  • Email: danieldomingofernandez@hotmail.com

Reasoning over causal paths in biological networks for drug discovery

GitHub Events

Total
  • Watch event: 1
Last Year
  • Watch event: 1

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 79
  • Total Committers: 6
  • Avg Commits per committer: 13.167
  • Development Distribution Score (DDS): 0.215
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Daniel Domingo-Fernandez d****z@h****m 62
YojanaGadiya 4****a 10
Charles Tapley Hoyt c****t@g****m 4
10mubeen m****h@h****m 1
Daniel Rivas d****s@b****s 1
Daniel Domingo d****o@M****x 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 8
  • Total pull requests: 6
  • Average time to close issues: 4 months
  • Average time to close pull requests: about 2 months
  • Total issue authors: 3
  • Total pull request authors: 5
  • Average comments per issue: 1.63
  • Average comments per pull request: 0.33
  • Merged pull requests: 6
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • cthoyt (6)
  • aalmodovares (1)
  • sailseem (1)
Pull Request Authors
  • cthoyt (2)
  • CristiGuijarro (1)
  • sarahbeenie (1)
  • YojanaGadiya (1)
  • ddomingof (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 42 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 2
  • Total versions: 12
  • Total maintainers: 1
pypi.org: drug2ways

Reasoning over polar paths in biological networks for drug discovery applications

  • Versions: 12
  • Dependent Packages: 0
  • Dependent Repositories: 2
  • Downloads: 42 Last month
Rankings
Dependent packages count: 10.0%
Dependent repos count: 11.6%
Stargazers count: 12.2%
Forks count: 12.5%
Average: 20.0%
Downloads: 53.7%
Maintainers (1)
Last synced: 6 months ago