Spaces:
Runtime error
Runtime error
File size: 3,315 Bytes
77d940e bcd1195 77d940e bcd1195 77d940e bcd1195 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 | ---
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](https://depmap.org) 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](https://github.com/WayScience/gene_dependency_representations)
---
## 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`](https://docs.astral.sh/uv/)-managed environment.
### Prerequisites
```sh
curl -LsSf https://astral.sh/uv/install.sh | sh
```
### Start the app
```sh
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)
```sh
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/`](../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](https://github.com/WayScience/gene_dependency_representations) repository, which contains the full analysis pipeline from data download through VAE training to result generation.
|