alhena 0.1.0__tar.gz

alhena-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,63 @@
+name: docs
+
+# A push to main builds and deploys the site; a pull request only builds it.
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+# Read only; the deploy job alone gets the two Pages permissions.
+permissions:
+  contents: read
+
+# A running deployment in `pages` is never canceled; a pull request builds in a group of its own.
+concurrency:
+  group: ${{ github.event_name == 'push' && 'pages' || format('docs-{0}', github.ref) }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      # CPU builds of torch and torchvision: the build never uses CUDA.
+      # mkdocstrings parses `src` and the notebooks are not executed: nothing here runs alhena.
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
+          python -m pip install -e ".[docs]"
+
+      # --strict fails on any warning: a moved page, a nav entry with no file, an unresolved path.
+      - name: Build
+        run: mkdocs build --strict
+
+      - if: github.event_name == 'push'
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: site
+
+  # A job of its own, so a failed build never enters the `github-pages` environment.
+  deploy:
+    if: github.event_name == 'push'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      # Fails here, naming the cause, where the Pages source is not set to GitHub Actions.
+      - uses: actions/configure-pages@v6
+
+      - id: deployment
+        uses: actions/deploy-pages@v5

alhena-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,95 @@
+name: release
+
+# A push to main builds the package; Run workflow also uploads it to TestPyPI, a release to PyPI.
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+  release:
+    types: [published]
+
+# Read only; the two upload jobs alone get id-token: write, for Trusted Publishing.
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      # The build needs no git access after the checkout, so the token is not kept.
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install
+        run: python -m pip install build twine
+
+      # The source archive and the wheel, in dist/.
+      - name: Build
+        run: python -m build
+
+      # Checks that the README renders on PyPI; --strict fails on warnings too.
+      - name: Check the package
+        run: twine check --strict dist/*
+
+      # A release uploads only the version its tag names: v plus __version__.
+      - name: Check the tag
+        if: github.event_name == 'release'
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+        run: |
+          version=$(python -c "import runpy; print(runpy.run_path('src/alhena/_version.py')['__version__'])")
+          if [ "$TAG" != "v$version" ]; then
+            echo "::error::Tag $TAG does not match version $version in src/alhena/_version.py: tag the release v$version, or change the version first."
+            exit 1
+          fi
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  # Run workflow, by hand: a trial upload to TestPyPI.
+  testpypi:
+    if: github.event_name == 'workflow_dispatch'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/alhena
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  # A published release; waits for approval where the `pypi` environment requires a reviewer.
+  pypi:
+    if: github.event_name == 'release'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/alhena
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

alhena-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,143 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+# An older run on the same branch is canceled when a new one starts.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      # CPU builds of torch and torchvision: the tests never use CUDA.
+      # viz for test_viz.py; the spatial and wsi tests run in the extras and floors jobs.
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
+          python -m pip install -e ".[dev,viz]"
+
+      # ruff keeps its format within a minor release: the floors' 0.16.0 and 0.16 here agree.
+      - name: Lint
+        run: |
+          ruff check src tests scripts
+          ruff format --check src tests scripts
+
+      # -rs lists each skipped test with its reason, so a lost dependency shows as a shorter run.
+      - name: Test
+        run: pytest -rs
+
+  # Every extra at its latest release, as a new install resolves it.
+  extras:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install the extras
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
+          python -m pip install -e ".[dev,viz,spatial,wsi]"
+
+      - name: Test
+        run: pytest -rs
+
+  # Every dependency at the lowest release pyproject.toml allows, pinned in ci/constraints-min.txt.
+  floors:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      # torchvision 0.17.0 is the release paired with torch 2.2.0, from the CPU index.
+      - name: Install the floors
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install torch==2.2.0 torchvision==0.17.0 --index-url https://download.pytorch.org/whl/cpu
+          python -m pip install -c ci/constraints-min.txt -e ".[dev,viz]"
+
+      - name: Lint
+        run: |
+          ruff check src tests scripts
+          ruff format --check src tests scripts
+
+      - name: Test
+        run: pytest -rs
+
+  # Each extra at its floor, the core resolved freely: the spatial stack needs newer core releases.
+  floors-spatial:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install the spatial extra at its floors
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
+          python -m pip install -c ci/constraints-min-extras.txt -e ".[dev,viz,spatial]"
+
+      - name: Lint
+        run: |
+          ruff check src tests scripts
+          ruff format --check src tests scripts
+
+      - name: Test
+        run: pytest -rs
+
+  # A job of its own: tiffslide 2.5.1 needs zarr 2, and spatialdata 0.8.0 needs zarr 3.
+  floors-wsi:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install the wsi extra at its floor
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
+          python -m pip install -c ci/constraints-min-extras.txt -e ".[dev,viz,wsi]"
+
+      - name: Lint
+        run: |
+          ruff check src tests scripts
+          ruff format --check src tests scripts
+
+      - name: Test
+        run: pytest -rs

alhena-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+build/
+dist/
+*.egg-info/
+.venv/
+venv/
+# the environment of scripts/alhena_atlas_embed.py
+alhena_atlas/
+.ipynb_checkpoints/
+.DS_Store
+
+# documentation build
+site/
+.cache/

alhena-0.1.0/CITATION.cff

@@ -0,0 +1,48 @@
+cff-version: 1.2.0
+message: If you use this software, please cite it using the metadata in this file.
+type: software
+title: ALHENA
+abstract: "ALHENA, an H&E encoder distilled from transcriptomic foundation models for multi-scale slide analysis."
+version: 0.1.0
+license: BSD-3-Clause
+repository-code: https://github.com/prism-oncology/ALHENA
+keywords:
+  - histopathology
+  - spatial-transcriptomics
+  - cell-typing
+  - foundation-model
+authors:
+  - family-names: Giraud-Sauveur
+    given-names: Félicie
+    email: felicie.giraudsauveur@gmail.com
+  - family-names: Blampey
+    given-names: Quentin
+  - family-names: Marza
+    given-names: Pierre
+  - family-names: Benkirane
+    given-names: Hakim
+  - family-names: Vakalopoulou
+    given-names: Maria
+  - family-names: Cournède
+    given-names: Paul-Henry
+  - family-names: Christodoulidis
+    given-names: Stergios
+preferred-citation:
+  type: unpublished
+  title: "ALHENA, an H&E encoder distilled from transcriptomic foundation models for multi-scale slide analysis"
+  notes: Manuscript under review.
+  authors:
+    - family-names: Giraud-Sauveur
+      given-names: Félicie
+    - family-names: Blampey
+      given-names: Quentin
+    - family-names: Marza
+      given-names: Pierre
+    - family-names: Benkirane
+      given-names: Hakim
+    - family-names: Vakalopoulou
+      given-names: Maria
+    - family-names: Cournède
+      given-names: Paul-Henry
+    - family-names: Christodoulidis
+      given-names: Stergios

alhena-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# Contributing to ALHENA
+
+Bug reports, questions and suggestions are welcome in the
+[issues](https://github.com/prism-oncology/ALHENA/issues). Include the command or code you ran, the
+message it printed in full, and what `alhena info` reports.
+
+## Development install
+
+Clone the repository and install it in editable mode, with the development tools:
+
+```bash
+git clone https://github.com/prism-oncology/ALHENA.git
+cd ALHENA
+pip install -e ".[dev]"
+```
+
+Add the `viz`, `wsi` and `spatial` extras to run the tests that need them.
+
+## Tests and style
+
+The tests use synthetic data only, so they need no model weights and no network:
+
+```bash
+pytest
+```
+
+The code is linted and formatted with ruff, as the continuous integration checks it:
+
+```bash
+ruff check src tests scripts
+ruff format --check src tests scripts
+```
+
+## Documentation
+
+The documentation is built with MkDocs. Install the docs extra, then serve the site locally:
+
+```bash
+pip install -e ".[docs]"
+mkdocs serve
+```

alhena-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Félicie Giraud-Sauveur
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

alhena-0.1.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.5
+Name: alhena
+Version: 0.1.0
+Summary: ALHENA, an H&E encoder distilled from transcriptomic foundation models for multi-scale slide analysis.
+Project-URL: Homepage, https://github.com/prism-oncology/ALHENA
+Project-URL: Documentation, https://prism-oncology.github.io/ALHENA/
+Project-URL: Source, https://github.com/prism-oncology/ALHENA
+Project-URL: Issues, https://github.com/prism-oncology/ALHENA/issues
+Project-URL: Weights, https://huggingface.co/prism-oncology/ALHENA
+Project-URL: References, https://huggingface.co/prism-oncology/ALHENA-references
+Author-email: Félicie Giraud-Sauveur <felicie.giraudsauveur@gmail.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: cell-typing,foundation-model,histopathology,spatial-transcriptomics
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.12
+Requires-Dist: anndata>=0.12.7
+Requires-Dist: h5py>=3.10
+Requires-Dist: huggingface-hub>=0.34
+Requires-Dist: numpy>=1.26
+Requires-Dist: opencv-python-headless>=4.8
+Requires-Dist: pandas>=2.1.1
+Requires-Dist: pyarrow>=14
+Requires-Dist: safetensors>=0.4
+Requires-Dist: timm<2,>=1.0
+Requires-Dist: torch>=2.2
+Requires-Dist: tqdm>=4.65
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff<0.17,>=0.16; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-jupyter>=0.25; extra == 'docs'
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.26; extra == 'docs'
+Provides-Extra: spatial
+Requires-Dist: sopa>=2.2; extra == 'spatial'
+Requires-Dist: spatialdata>=0.8; extra == 'spatial'
+Provides-Extra: viz
+Requires-Dist: matplotlib>=3.8; extra == 'viz'
+Provides-Extra: wsi
+Requires-Dist: tiffslide>=2.5.1; extra == 'wsi'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/prism-oncology/ALHENA/main/docs/assets/alhena_banner.svg" alt="ALHENA" width="100%" height="168">
+</p>
+
+<p align="center">
+  <b>ALHENA, an H&amp;E encoder distilled from transcriptomic foundation models for multi-scale slide analysis.</b>
+</p>
+
+<p align="center">
+  <a href="https://prism-oncology.github.io/ALHENA/"><b>Documentation</b></a> |
+  <a href="https://github.com/prism-oncology/ALHENA-paper"><b>Paper code</b></a> |
+  <a href="https://huggingface.co/prism-oncology/ALHENA"><b>Weights on Hugging Face</b></a> |
+  <a href="https://huggingface.co/prism-oncology/ALHENA-references"><b>References on Hugging Face</b></a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/alhena/"><img alt="PyPI" src="https://img.shields.io/pypi/v/alhena.svg"></a>
+  <a href="https://github.com/prism-oncology/ALHENA/actions/workflows/tests.yml"><img alt="Tests" src="https://github.com/prism-oncology/ALHENA/actions/workflows/tests.yml/badge.svg"></a>
+  <a href="https://github.com/prism-oncology/ALHENA/actions/workflows/docs.yml"><img alt="Docs" src="https://github.com/prism-oncology/ALHENA/actions/workflows/docs.yml/badge.svg"></a>
+  <img alt="License: BSD-3-Clause" src="https://img.shields.io/badge/license-BSD--3--Clause-blue.svg">
+  <img alt="Python 3.12+" src="https://img.shields.io/badge/python-3.12%2B-blue.svg">
+</p>
+
+---
+
+ALHENA reads an H&E section and returns two things: **embeddings**, per tile and per cell, and
+**cell types** on an unlabeled section. No spatial transcriptomics is needed at inference, and
+nothing is fitted at deployment.
+
+Cell types come from retrieval against a labeled single-cell reference, so a different reference
+gives a different taxonomy. ALHENA provides prebuilt references for fifteen human tissues, built
+from fourteen public single-cell atlases, or you can build a custom reference.
+
+When the inputs share a spatial frame, the embeddings and the cell types stay aligned with the
+slide and can be analyzed together across scales.
+
+ALHENA is gamma Geminorum, from the Arabic *al-han'ah*, a brand mark placed on something to make it
+readable. To the eye, it appears as a single star, though it is in fact a binary system. The light
+we see comes from a bright A-type subgiant. Its companion has never been imaged and reveals itself
+only through the faint wobble it leaves in the motion of the visible star. The H&E section is that
+visible star, inexpensive, familiar, and collected everywhere. The spatial transcriptome is the
+unseen companion, physically present, shaping what we observe, yet never directly accessible at
+inference.
+
+## Install
+
+ALHENA needs Python 3.12 or later, and runs with or without a GPU.
+
+```bash
+pip install alhena
+```
+
+Optional extras add plotting (`viz`), whole-slide reading (`wsi`) and SpatialData support
+(`spatial`): `pip install "alhena[viz,wsi,spatial]"`.
+
+The UNI2-h model weights are distributed separately by their authors and are not included with
+ALHENA. Their repository is gated: request access at
+[MahmoodLab/UNI2-h](https://huggingface.co/MahmoodLab/UNI2-h) and accept the license. Then log
+in and download the weights, 2.7 GB, into the Hugging Face cache, where ALHENA finds them:
+
+```bash
+hf auth login
+hf download MahmoodLab/UNI2-h pytorch_model.bin
+```
+
+For weights stored elsewhere, set `ALHENA_BACKBONE` to the file. ALHENA adds its own low-rank
+adapters and projection heads on top of the UNI2-h weights, and downloads them from Hugging Face
+on first use, with the prebuilt reference of each tissue it annotates.
+
+## See it work
+
+The demo needs no data of your own. It reads a few annotated breast H&E fields from the public
+PanNuke dataset, annotates their nuclei with the prebuilt breast reference, and compares the
+predicted cell types with the PanNuke labels. It needs the UNI2-h model weights.
+
+```bash
+alhena demo Breast
+```
+
+## Use it on your own data
+
+```python
+import alhena
+
+source = alhena.io.read_slide("slide.svs")                        # an H&E slide, read tile by tile
+nuclei = alhena.io.read_polygons("nuclei.geojson", tiles=source)  # nucleus outlines
+
+encoder = alhena.load_encoder()
+tiles = encoder.encode_tiles(source)                              # one embedding per tile
+tiles.write_h5ad("tiles.h5ad")                                    # one row per tile, ready to analyze
+
+cells = encoder.encode_cells(source, nuclei=nuclei)               # one pass, each tile once
+cells.write_h5ad("cells.h5ad")
+
+typer = alhena.load_celltyper(tissue="Breast")                    # loads the reference alone
+result = typer.annotate(cells)                                    # retrieval, no encoder
+result.to_frame()
+```
+
+`read_slide` needs the `wsi` extra and reads the resolution the slide declares. `source` can also
+be an array of H&E tiles, `(n_tiles, height, width, 3)` uint8 RGB; `mpp=` then declares the
+resolution it is already at. The nuclei come from a segmenter of your choice: ALHENA does not
+segment. The documentation shows how to
+[segment a slide with sopa and StarDist](https://prism-oncology.github.io/ALHENA/inputs/nuclei/#segment-a-slide-with-sopa-and-stardist).
+`read_polygons` expects the outlines in the slide's full-resolution pixels. Outlines written in
+microns need `units="um"`, and outlines segmented on another image need `transform=`. See
+[Coordinates](https://prism-oncology.github.io/ALHENA/inputs/coordinates/).
+With SpatialData, `alhena.spatial` reads the image and the nucleus outlines from the object.
+
+Cells are encoded once and can be annotated again, against another reference or on another
+annotation axis, without rerunning the image encoder: `alhena.io.read_cells("cells.h5ad")` reads
+them back with the provenance that pairs them with a reference.
+`typer.annotate(source, nuclei=nuclei)` runs both steps in one call and keeps the cells on
+`result.cells`.
+
+## Documentation
+
+**[prism-oncology.github.io/ALHENA](https://prism-oncology.github.io/ALHENA/)**
+
+Start with [Choose your task](https://prism-oncology.github.io/ALHENA/start/choose-your-task/):
+tile embeddings, cell embeddings, cell-type annotation, or multi-scale slide analysis.
+[Inputs](https://prism-oncology.github.io/ALHENA/inputs/) says how to provide your images and
+nuclei, whatever form they take.
+
+Six [tutorials](https://prism-oncology.github.io/ALHENA/tutorials/) cover these tasks, custom
+references, and annotation evaluation. The [use case example](https://prism-oncology.github.io/ALHENA/use-case/crc_multiscale/) applies
+ALHENA to two public colorectal cancer cohorts, from tissue contexts to patient-level analyses.
+
+## Contributing
+
+Report a problem or ask a question in the [issues](https://github.com/prism-oncology/ALHENA/issues);
+[CONTRIBUTING.md](https://github.com/prism-oncology/ALHENA/blob/main/CONTRIBUTING.md) explains how to
+install ALHENA for development and run its tests.
+
+## License
+
+The ALHENA software is released under the BSD 3-Clause License. The ALHENA model weights,
+comprising the LoRA adapters and the projection heads used at inference, are released under the
+Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0).
+
+The precomputed single-cell reference representations are released under the CC BY-NC 4.0
+license. They remain subject to the terms of their source atlases, and those derived from DISCO
+are provided for academic research only, in accordance with the DISCO terms of use.
+
+## Citation
+
+If you use ALHENA, please cite it as described on the
+[Cite page](https://prism-oncology.github.io/ALHENA/cite/) of the documentation. Please also cite
+the models and datasets ALHENA builds on, listed on the same page.