gwaybio's picture
initial deploy
bcd1195 verified
|
Raw History Blame Contribute Delete
3.32 kB
metadata
title: Gene Process Dependency Explorer
emoji: 🧬
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: true
license: bsd-3-clause

Gene Process Dependency Explorer

An interactive Streamlit dashboard for exploring gene process dependencies across cancer types, built on DepMap data and latent representations learned by a Beta Variational Autoencoder (BVAE).

This app accompanies the paper:

Discovering multivariate gene vulnerability patterns in cancer using latent representations of gene dependencies WayScience · GitHub


What the app shows

The dashboard has six tabs:

Tab Description
Welcome Overview and links
Single dependency plots PCA of raw CRISPR gene dependency scores across all cell lines; filter by cancer type
Latent plots PCA of VAE latent representations for Reactome, CORUM, and Drug subsets
Spider plots Radar charts of biological process dependency profiles per cell line or cancer type
Top scores Heatmaps and bar charts of highest-scoring processes by cancer type and model ID
Data table Searchable table of all cell lines and their primary diseases

Running locally

The webapp is self-contained with its own uv-managed environment.

Prerequisites

curl -LsSf https://astral.sh/uv/install.sh | sh

Start the app

cd 9.webapp
uv run streamlit run app.py

uv creates and populates the virtual environment automatically on first run. The app will be available at http://localhost:8501.

Deploy headless (e.g. on a server)

cd 9.webapp
PORT=8501 uv run streamlit run app.py \
  --server.address 0.0.0.0 \
  --server.headless true \
  --server.port "$PORT" \
  --server.fileWatcherType none

Data

All data files are committed to the repository — no external downloads needed to run the app.

File Size Description
data/Model.parquet 188 KB DepMap cell line metadata
data/pca_embeddings_single_dependencies.parquet 34 KB Pre-computed PCA of raw gene dependency scores
data/pca_embeddings_latent_reactome.parquet 27 KB Pre-computed PCA of Reactome latent scores
data/pca_embeddings_latent_corum.parquet 27 KB Pre-computed PCA of CORUM latent scores
data/pca_embeddings_latent_drug.parquet 27 KB Pre-computed PCA of drug latent scores
data/all_reactome_results.parquet 1.7 MB Full Reactome latent scores (spider + heatmap tabs)
data/all_corum_results.parquet 1.7 MB Full CORUM latent scores
data/all_drug_results.parquet 4.1 MB Full drug latent scores

Raw DepMap files (CRISPRGeneEffect.parquet etc.) are not required by the webapp and are gitignored. Download them via 0.data-download/ if you need to re-run the full analysis pipeline.


Repository structure

This webapp lives in 9.webapp/ within the larger gene_dependency_representations repository, which contains the full analysis pipeline from data download through VAE training to result generation.