Package: scUNAGI
UNAGIUNAGI: Deep Generative Model for Deciphering Cellular Dynamics and In-Silico Drug Discovery in Complex DiseasesFull documentations and tutorials can be accessed atUNAGI-docs.OverviewUNAGI is a comprehensive unsupervised in-silico cellular dynamics and drug discovery framework. UNAGI adeptly deciphers cellular dynamics from human disease time-series single-cell data and facilitates in-silico drug perturbations to earmark therapeutic targets and drugs potentially active against complex human diseases. All outputs, from cellular dynamics to drug perturbations, are rendered in an interactive visual format within the UNAGI framework. Nestled within a deep learning architecture Variational Autoencoder-Generative adversarial network (VAE-GAN), UNAGI is tailored to manage diverse data distributions frequently arising post-normalization. It also innovatively employs disease-informed cell embeddings, harnessing crucial gene markers derived from the disease dataset. On achieving cell embeddings, UNAGI fabricates a graph that chronologically links cell clusters across disease stages, subsequently deducing the gene regulatory network orchestrating these connections. UNAGI is primed to leverage time-series data, enabling a precise portrayal of cellular dynamics and a superior capture of disease markers and regulators. Lastly, the deep generative prowess of UNAGI framework powers an in-silico drug perturbation module, simulating drug impacts by manipulating the latent space informed by real drug perturbation data from the CMAP database. This allows for an empirical assessment of drug efficacy based on cellular shifts towards healthier states following drug treatment. The in-silico perturbation module can similarly be utilized to investigate therapeutic pathways, employing an approach akin to the one used in drug perturbation analysis.Key CapabilitiesLearning disease-specific cell embeddings through iterative training processes.Constructing temporal dynamic graphs from time-series single-cell data and reconstructing temporal gene regulatory networks to decipher cellular dynamics.Identifying dynamic and hierarchical static markers to profile cellular dynamics, both longitudinally and at specific time points.Performingin-silicoperturbations to identify potential therapeutic pathways and drug/compound candidates.InstallationUNAGI installationgit clone https://github.com/mcgilldinglab/UNAGI.git
pip install scUNAGIPrerequisitesPython >=3.9 (Python3.9 is recommanded)pyro-ppl>=1.8.6scanpy>=1.9.5anndata==0.8.0torch >= 2.0.0matplotlib>=3.7.1Required filesPreprocessed CMAP database:One DriveRequried data to run UNAGI, move it to the folder containing UNAGI and idrem.Preprocessed IPF snRNA-seq dataset:One DriveUNAGI outcomes to reproduce the figures and tables generated for the manuscript.Example dataset:Link.iDREM installation:git clone https://github.com/phoenixding/idrem.gitiDREM prerequisites:Install the iDREM to the source folder of UNAGIJava
To use iDREM, a version of Java 1.7 or later must be installed. If Java 1.7 or later is not currently installed, please refer tohttp://www.java.comfor installation instructions.JavaScript
To enable the interactive visualization powered by Javascript, please make sure that you have Internet connection.
(The users are still able to run the software off-line, but Internet access is needed to view the result interactively.)Tutorials:Dataset preparationPrepare datasets to run UNAGI.Training and analysis on example datasetUNAGI training and analysis on an example dataset.Visualize the results of UNAGI methodVisualization on an example dataset.ContactYumin Zheng,Naftali Kaminski,Jun Ding