Name Mode Size
.github 040000
R 040000
inst 040000
man 040000
tests 040000
vignettes 040000
.Rbuildignore 100755 0 kb
DESCRIPTION 100644 2 kb
LICENSE 100644 0 kb
LICENSE.md 100644 1 kb
NAMESPACE 100755 2 kb
NEWS.md 100644 1 kb
README.md 100755 4 kb
_pkgdown.yml 100644 1 kb
configure 100755 0 kb
configure.win 100755 0 kb
README.md
<img src="vignettes/orthos.png" alt="orthos" width="160"/> # _orthos_ - Mechanistic insights from differential gene expression experiments with Deep Generative Networks ## Overview Differential expression analysis upon cellular perturbations is the most commonly used tool for probing molecular mechanisms of action due to its simplicity and low cost. However, interpretation of such experiments is confounded by the complex and nuanced impact of experimental treatments on cellular processes. Enter `orthos`, a generative modelling-based approach that disentangles experiment-specific from non-specific effects of perturbations on gene expression. Utilizing a large corpus of gene expression contrasts (>100K annotated / >1M augmented) compiled from the [ARCHS4](https://maayanlab.cloud/archs4/) database of uniformly processed RNAseq experiments we trained conditional variational models that accurately capture and isolate "**polytopic**" (non-specific, observed across multiple treatments) effects while accounting for context. The residual, **specific** component obtained from this decomposition offers a more unequivocal experimental signature and is a proxy more closely related to the direct molecular effects of a treatment when compared to the raw signal. In addition to providing a clearer understanding of the effects of experimental treatments on gene exrpession `orthos` also enables researchers to query the contrast database with arbitrary contrasts and identify experiments with similar specific effects ultimately helping to map pharmacological, physiological or genetic treatments to mechanisms of action. `orthos` is developed at the [FMI-Friedrich Miescher Institute for Biomedical Research](https://www.fmi.ch/) and is supported by funding from the [NIBR-Novartis Institutes for Biomedical Research](https://www.novartis.com/research-development/novartis-institutes-biomedical-research). Current contributors include: - [Panagiotis Papasaikas](https://github.com/ppapasaikas) - [Charlotte Soneson](https://github.com/csoneson) - [Michael Stadler](https://github.com/mbstadler) ## Installation `orthos` can be installed from from Bioconductor using `BiocManager::install()`: ```r if (!requireNamespace("BiocManager", quietly = TRUE)) install.packages("BiocManager") BiocManager::install("orthos") # or also... BiocManager::install("orthos", dependencies = TRUE) ``` ## Functionality The workhorse behind `orthos` are organism-specific conditional variational autoencoder (cVAE) models that break down the variance of a given differential expression experiment into a non-specific (polytopic) and an experiment-specific components. The non-specific (polytopic) component corresponds to gene variance that has been observed across multiple instances during training, while the experiment-specific variance is fairly unique to the experiment. Given these inputs, the model maps the contrast to a concise latent representation (z~D~) which is then used to generate a decoded version of the contrast. This decoded contrast corresponds directly to the **polytopic** (non-specific) component of the observed effects; it subsumes the gene variance that the model can account for because it has been encountered, in some form, during training. The residual obtained after removing the decoded contrast from the original one is the specific component; this encompasses the gene variance that the model cannot account for (random noise + experiment-specific biological effects). <img src="vignettes/orthos_arch.png" alt="orthos" width="600"/> A typical analysis with `orthos` involves two main steps: 1. Decomposing one or several contrasts into their corresponding specific and polytopic (non-specific) fraction and 2. Performing queries with the original and decomposed specific and polytopic fractions against the `orthosData` contrast database For more details on usage please refer to the package vignette. ### Miscellaneous ### Code of Conduct