Spaces:
Runtime error
Runtime error
|
Download README.md from WayScience/gene-dependency-explorer: direct link, hf CLI and curl.
- Browser
- Download file 3.32 kB
-
https://huggingface.co/spaces/WayScience/gene-dependency-explorer/resolve/main/README.md
- Command line
-
hf download hf://spaces/WayScience/gene-dependency-explorer/README.md
-
curl -L -o README.md https://huggingface.co/spaces/WayScience/gene-dependency-explorer/resolve/main/README.md
3.32 kB
| 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. | |