Skip to content

justinshaffer/DEICODE

 
 

Repository files navigation

Build Status Coverage Status

deicode is a tool box for running Robust Aitchison RPCA on sparse omics datasets, linking specific features to beta-diversity ordination.

Note that deicode is not compatible with python 2, and is compatible with Python 3.4 or later. deicode is currently in alpha. We are actively developing it, and backward-incompatible interface changes may arise.

Installation

To install the most up to date version of deicode, run the following command

# stable version (currently v.0.1.0)
pip install deicode

# dev. version
pip install git+https://github.com/cameronmartino/DEICODE.git

Tutorials

Qiime2 tutorial

First make sure that qiime2 is installed before installing deicode. Then run

qiime dev refresh-cache

Once qiime2 is properly interfaced with deicode, you can import your biom tables into Artifacts. Here we will be using the Sleep Apnea dataset as an example.

qiime tools import \
    --input-path qiita_10422_table.biom \
    --output-path qiita_10422_table.biom.qza \
    --type FeatureTable[Frequency]

You can then run the qiime2 deicode rpca-biplot commmand as follows.

qiime deicode rpca-biplot \
    --i-table qiita_10422_table.biom.qza \
    --p-min-feature-count 10 \
    --p-min-sample-count 500 \
    --o-biplot ordination.qza

Once you have this, you can directly visualize this in emperor

qiime emperor biplot \
    --i-biplot ordination.qza \
    --m-sample-metadata-file qiita_10422_metadata.tsv \
    --m-feature-metadata-file taxonomy.qza \
    --o-visualization biplot.qzv \
    --p-number-of-features 8

You can view the resulting visualization at https://view.qiime2.org. It should look as follows biplot

Python Tutorial

Simulation Benchmarking

Other Resources

The code for OptSpace was translated to python from a MATLAB package maintained by Sewoong Oh (UIUC).

Simulation and Case Study Benchmarking

About

Robust Aitchison RPCA on sparse omics datasets

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%