Study the link between environmental factors and rare diseases
Project description
README
ODAMNet is a Python package to study molecular relationship between environmental factors (called chemicals here) and rare diseases.
The ODAMNet documentation is available in ReadTheDocs.
This tool was created within the framework of the EJRP-RD project.
Installation
From PyPI
ODAMNet is available as Python package. You can easily install it using pip
.
$ python3 -m pip install odamnet
From Conda - It's ongoing
It is available in bioconda too.
$ conda install odamnet
From Github
- Clone the repository from GitHub
$ git clone https://github.com/MOohTus/ODAMNet.git
- Then, install it
$ python3 -m pip install -e ODAMNet/
If it's not working, try to update pip using pip install pip --upgrade
Usage
Three different approaches are available:
- Overlap analysis
- Active Modules Identification (AMI, using DOMINO)
- Random Walk with Restart (RWR, using multiXrank)
$ odamnet [overlap|domino|multixrank|networkCreation] [ARGS]
Examples
Three approaches are implemented to study relationships between genes targeted by chemicals (extracted automatically from CTD database) and rare diseases (extracted automatically from WikiPathways).
Overlap analysis
This method computes the overlap between target genes and rare disease pathways. It is looking for direct associations, i.e., target genes that are part of rare disease pathways.
Give your chemicals list into --chemicalsFile
input.
$ odamnet overlap --chemicalsFile FILENAME
Active Module Identification (AMI)
The Active Module Identification is performed using DOMINO tool.
DOMINO defines target genes as active genes to search for active modules using a biological network (e.g. protein-protein interaction network, PPI). Then, an overlap analysis is performed between identified active modules and rare disease pathways.
Give your chemicals list and your biological network into --chemicalsFile
and --networkFile
respectively.
$ odamnet domino --chemicalsFile FILENAME --networkFile FILENAME
Random Walk with Restart (RWR)
The Random Walk with Restart is performed using multiXrank Python package.
Network and bipartite creation
MultiXrank need networks as input. You need to create a network with the rare disease pathways. This network will not have any connection between disease nodes (i.e. disconnected network). Disease nodes will be only connected with gene nodes that are involved in disease pathways using a bipartite.
Give a path to save generated disease network and disease-gene bipartite using --networksPath
and --bipartitePath
respectively.
$ odamnet networkCreation --networksPath PATH --bipartitePath PATH
Rare disease pathways are extracted automatically from WikiPathways.
multiXrank
Random Walk with Restart mesures the proximity of every node (e.g. genes and diseases) to the target genes within a multilayer network. The multilayer network is composed of molecular multiplex and rare disease pathway network (the one created previously).
Give your chemicals list into --chemicalsFile
input.
MultiXrank needs a configuration file (--configPath
), networks directory (--networksPath
),
the target genes file (--seedsFile
) and a name to write the result into network file (--sifFileName
).
$ odamnet multixrank --chemicalsFile FILENAME --configPath PATH --networksPath PATH --seedsFile FILENAME --sifFileName FILENAME
We provide a molecular multiplex into the useCases directory in the GitHub page.
You can also have more details about the configuration file in the documentation page.
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.