Drug Mechanism Database (DrugMechDB)

A database of paths that represent the mechanism of action from a drug to a disease in an indication. A preliminary relase of DrugMechDB was published here:

Database of mechanism of action paths for selected drug-disease indications

A web interface to DrugMechDB can be found at https://sulab.github.io/DrugMechDB/.

Purpose

Most drug mechanisms are described simply as a protein target, or sometimes a pathway, that then treats the disease. However, there are usually more steps across a biological knowledge graph required to traverse from the target through its mechanism to the reduction of a disease. This database attempts to catalog a subset of known drug-disease indications as a path through a network of biomedical entities.

Below is a visualized example of one entry in DrugMechDB - A path from Cortisone acetate to Keratitis.

Path Example

Curation

Indications were selected at random from the set contained within DrugCentral. Half were taken from the full set, representing a set of common drug disease pairs, and the other half were selected from a pool of less-common diseases to vary the targets and diseases treated.

Paths were derived from free-text descriptions found on DrugBank, Wikipedia and within literature. Concepts within the text were then normalized to a concept type (Drug, Protein, Pathway, etc) and relationships between the concepts were determined from the source. Finally concepts were mapped to an identifier depending on the concept type according to the following table:

Concept Type	Identifier Source
BiologicalProcess	GO
Cell	CL
CellularComponent	GO
ChemicalSubstance	MESH, CHEBI
Disease	MESH
Drug	MESH, DrugBank
GeneFamily	InterPro
GrossAnatomicalStructure	UBERON
MacromolecularComplex	PR
MolecularActivity	GO
OrganismTaxon	NCBITaxon
Pathway	REACT
PhenotypicFeature	HP
Protein	UniProt

Contributing

If you would like to contribute your own curated mechanistic paths, please do so by making pull requests with edits to the file submission.yaml.

See the Curation Guide for more information about contributions and Submission Guide for detailed submission instructions.

Path formatting

Each path begins with a - directed: true statment. Identifiers for concepts and concept type should conform to the table above.

Paths contain the following structure:

- directed: true
    graph:
        disease: *name of the disease in the indication*
        disease_mesh: *MESH Identifier for the disease (if known)*
        drug: *name of the drug in the indication*
        drug_mesh: *MESH Identifier for the drug (if known)*
        drugbank: *DrugBank Identifier for the drug (if known)*
    links:     (the edges of the path)
    -   key: *Semantics of the relationship (ALL CAPS)*
        source: *Identifier for source node in edge*
        target: *Identifier for target node in edge*
    nodes:     (the nodes in the path)
    -   id: *Identifier for the node*
        label: *Concept type for the node*
        name: *Name of the node*
    multigraph: true    (required statment for importing paths into networkx).

Website build guide

We originally had this configured so that the "Update Website" action would build the Jekyll files and push to the gh-pages branch, which would then be rendered by Github Pages. However, the web content is now too large and the build process times out. Therefore, we have to build locally. The protocol is as follows:

Execute the "Merge Pages" action which will merge the main branch to gh-pages

Create the gh-pages branch locally

git clone --branch gh-pages --depth 1 git@github.com:SuLab/DrugMechDB.git DrugMechDB.gh-pages
cd DrugMechDB.gh-pages

or if the repo already exists locally,

cd DrugMechDB.gh-pages
git pull

Create the Jekyll files from indication_paths.yaml
```
python parse.py
```
Use jekyll to render HTML output:

This command can take up to ~30 mins to complete, and output HTML files will be in _site
```
bundle exec jekyll build
```

Create the gh-pages-html branch locally:

cd ..
git clone --branch gh-pages-html git@github.com:SuLab/DrugMechDB.git DrugMechDB.gh-pages-html
cd DrugMechDB.gh-pages-html

or if the repo already exists locally,

cd DrugMechDB.gh-pages-html
git pull

Copy the new rendered files:

rm -rf *
cp -r ../DrugMechDB.gh-pages/_site/* .

Commit and push:

git add .
git commit -m 'Update website'
git push

To cite the use of DrugMechDB in your work

Gonzalez-Cavazos, A. C., Tanska, A., Mayers, M., Carvalho-Silva, D., Sridharan, B., Rewers, P. A., Sankarlal, U., Jagannathan, L. & Su, A. I. (2023). DrugMechDB: A Curated Database of Drug Mechanisms. Scientific Data, 10(1), 632.

SuLab / DrugMechDB

readme