methylnet

Modular framework for deep learning predictions on methylation data.

https://github.com/christensen-lab-dartmouth/methylnet

Science Score: 33.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 2 DOI reference(s) in README
  • Academic publication links
    Links to: biorxiv.org
  • Committers with academic emails
    1 of 1 committers (100.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.0%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

Modular framework for deep learning predictions on methylation data.

Basic Info
Statistics
  • Stars: 54
  • Watchers: 6
  • Forks: 12
  • Open Issues: 6
  • Releases: 0
Created over 7 years ago · Last pushed about 6 years ago
Metadata Files
Readme License

README.md

MethylNet

Deep Learning with Methylation

MethylNet is a command line tool and python library that provides classes to handle deep learning tasks for methylation data. It is built off of pythonic MethylationArray data types introduced in (https://github.com/Christensen-Lab-Dartmouth/PyMethylProcess), and uses PyTorch to explore/make predictions on the methylation data.

Please check out our code ocean demo at: https://codeocean.com/capsule/5473199/

Featured in BMC Bioinformatics: https://bmcbioinformatics.biomedcentral.com/articles/10.1186/s12859-020-3443-8

Help docs: https://christensen-lab-dartmouth.github.io/MethylNet/

What MethylNet can do:
1. Extract DNA Methylation Latent Space by training Variational Auto-encoders (VAE) after hyperparameter and neural network topology grid-search.

MethylNetPresentationSpring2019Lab 001 MethylNetPresentationSpring2019Lab 002 2. Make classification, single- and multi-output regression predictions on the methylation data such as age, cell type proportions, and disease state. This is done after transfer learning the VAE topology and a hyperparameter and neural network topology grid-search.

MethylNetPresentationSpring2019Lab 003 3. Find most important CpGs for predictions using SHAP, interpreting predictions on the individual and aggragated class level.

MethylNetPresentationSpring2019Lab 004 4. Interrogate these extracted CpGs using popular pipelines such as LOLA, gometh, GSEA and overlap CpGs with other known sets of CpGs. In addition, overlap top sets of CpGs with other CpGs of other predictions.

MethylNetPresentationSpring2019Lab 005

NOTE: Images will be updated to reflect latest set of MethylNet commands.

MethylNet is currently in review, Wiki page in progress. Biorxiv can be accessed at: https://www.biorxiv.org/content/10.1101/692665v1

Help docs: https://christensen-lab-dartmouth.github.io/MethylNet/

Install (Conda highly recommended, though Docker can be used): * conda create -n methylnet python=3.6
* source activate methylnet
* See install instructions for PyMethylProcess at https://github.com/Christensen-Lab-Dartmouth/PyMethylProcess
* conda install pytorch torchvision -c pytorch
* pip install methylnet
* Alternative install: clone this repository and run python setup.py sdist bdistwheel && pip install dist/methylnet-0.1.tar.gz
* Run for GSEA collections: download
help_data
* Alternative docker install: docker pull joshualevy44/methylnet:0.1
* If looking to use only CPUs, only core docker or singularity needed, and see singularity website for information on how to pull Docker images
* See https://singularity.lbl.gov/faq#does-singularity-support-containers-that-require-gpus for information on getting Singularity to work with GPUs
* nvidia-docker is also the Docker equivalent to run GPU jobs
* GPU usage is also possible through the base install (without Docker, or considering nvidia-docker options), provided that your machine has GPU access.

Running MethylNet: 1. source activate methylnet
2. Pre-processing pipeline: Instructions available at https://github.com/Christensen-Lab-Dartmouth/PyMethylProcess to go from 450K/850K IDATs to MethylationArray datatypes that can easily be learned from.
3. Run embedding hyperparameter scan
4. Choose top embedding hyperparameters and train one last time again
5. Run prediction hyperparameter scan
6. Choose top prediction hyperparameters and train one last time again
7. Find top CpGs by running SHAP.
8. Interrogate SHAP derived CpGs.
9. See help-docs for usage.

Running Test Pipeline: 1. docker pull joshualevy44/methylnet:0.1
2. Alternative: sh dockerbuild.sh
3. docker run -it joshualevy44/methylnet:0.1
4. Alternative: sh run
docker.sh
5. methylnet-test test_pipeline

Example of Running Pipeline:
See ./example_scripts for examples on how to explicitly run: 1 2 3 4 5 6 7 8 9

Owner

  • Name: Christensen-Lab-Dartmouth
  • Login: Christensen-Lab-Dartmouth
  • Kind: organization

GitHub Events

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

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 154
  • Total Committers: 1
  • Avg Commits per committer: 154.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
jlevy44 j****4@b****u 154
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 15
  • Total pull requests: 1
  • Average time to close issues: 4 months
  • Average time to close pull requests: 3 minutes
  • Total issue authors: 6
  • Total pull request authors: 1
  • Average comments per issue: 1.27
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • 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
  • jlevy44 (9)
  • AlexanderTitus (2)
  • bioinfo-dirty-jobs (1)
  • rcedgar (1)
  • ofsolomon (1)
  • GillianGrayson (1)
Pull Request Authors
  • jlevy44 (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 20 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 4
  • Total maintainers: 1
pypi.org: methylnet

A modular deep learning approach for Methylation Predictions.

  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 20 Last month
Rankings
Stargazers count: 10.0%
Dependent packages count: 10.0%
Forks count: 10.9%
Average: 16.4%
Dependent repos count: 21.7%
Downloads: 29.4%
Maintainers (1)
Last synced: 11 months ago

Dependencies

methylnet.egg-info/requires.txt pypi
  • dask *
  • mlxtend *
  • pymethylprocess >=0.1.5
  • ruamel.yaml *
  • statsmodels *
setup.py pypi
  • dask *
  • mlxtend *
  • modin *
  • networkx *
  • pymethylprocess >=0.1.5
  • ruamel.yaml *
  • statsmodels *
  • submit_hpc *
  • torch *