AlphaGenome Atlas Deep-Linking & URL Configuration
Construct and validate deep-links for the AlphaGenome Atlas web application
(https://deepmind.google.com/science/alphagenome/atlas).
Base URL: https://deepmind.google.com/science/alphagenome/atlas
[!IMPORTANT] Mandatory Atlas Deep-Linking with Variant Scores: Whenever
presenting, discussing, or scoring genetic variants, you MUST always provide
clickable deep-links to the
AlphaGenome Atlas.
Use scripts/alphagenome_atlas_links.py to automate link and table
generation.
Prerequisites
# 1. Single Variant Exploration Link:
uv run scripts/alphagenome_atlas_links.py variant "chr9:128225994:G>A" \
--biosample K562 \
--modalities RNA_SEQ,DNASE,CHIP_TF
# 2. Genomic Locus / Interval Link:
uv run scripts/alphagenome_atlas_links.py locus "chr11:5288500-5290500" \
--biosample K562 \
--modalities RNA_SEQ,DNASE,CHIP_TF
# 3. Format Candidate Variant Records Table (with embedded clickable links):
uv run scripts/alphagenome_atlas_links.py table --input top_variants.json --biosample K562
# 4. Construct Ref vs. Alt Track Predictions Link (/atlas/track-predictions):
uv run scripts/alphagenome_atlas_links.py track-predictions \
--variant "chr15:42387805:C>G" \
--gene CAPN3 \
--biosample "Muscle_Skeletal"
2. URL Query Parameters
q (string, Required): Primary search target. Supports 1-based
closed intervals (chr11:5288500-5290500), gene symbols (BRCA1), Ensembl
IDs (ENSG00000012048), or 1-based variants (chr7:27170000:A>G).
m (enum, Optional): View mode. Defaults to entity for
genes/variants and locus for coordinate intervals. Use variant for
variant queries. (Allowed: locus, entity, variant, motifs).
i (string, Optional): Centered viewport zoom interval in 1-based
closed chr:start-end format (e.g. chr11:5289310-5289690). Required for
automatic motif rendering.
f (string, Optional): Comma-separated filter predicates in
KEY:VALUE format (e.g.
BIOSAMPLE_NAME:K562,SCORER_MODALITY:RNA-seq,ASSAY_TRANSCRIPTOR_FACTOR:GATA1).
Controls visible heatmap rows.
lItems (string, Optional): Layout item sequence, AVI score track
toggle (avi), section heatmaps, and pinned tracks list (e.g.
avi,section:RNA_SEQ,section:DNASE,pinned:<TrackKey>).
scores (string, Optional): Comma-separated list of ScoreId tokens
for the /atlas/track-predictions page comparison (e.g.
<ScoreId1>,<ScoreId2>).
md (enum, Optional): Active modality tab selector on the track
predictions view (RNA_SEQ, SPLICE_JUNCTIONS, SPLICE_SITE_USAGE,
DNASE).
tpRenames (string, Optional): Custom title overrides for specific
score predictions (ScoreId:CustomTitle).
tpLegendTitle (string, Optional): Custom legend title for the track
predictions chart card (e.g. Predicted Gene Expression).
[!IMPORTANT] Variant Query Format: Variants in q must strictly use
chr:pos_1_based:ref>alt format (e.g. chr7:27170000:A>G or URL-encoded
chr7:27170000:A%3EG, where the position is 1-based). Do not use
colon-separated alleles (A:G) or dbSNP rsIDs (rsIDs are unsupported).
3. Multi-Modality Filtering & The Assay Group Gotcha (f)
Filter Groups & Boolean Evaluation
Filters in f map to three primary evaluation groups:
Biosample Group (BIOSAMPLE_NAME, BIOSAMPLE_TYPE): Evaluated with
AND logic.
Assay Group (SCORER_MODALITY, ASSAY_TRANSCRIPTOR_FACTOR,
ASSAY_HISTONE_MARK): Evaluated with OR logic.
Gene Group (GENE_NAME): Evaluated with OR logic.
⚠️ Mandatory Multi-Modality Filter Rule
RNA-seq and DNase tracks have no transcription factor code
(transcriptionFactorCode === ""). If f contains only
ASSAY_TRANSCRIPTOR_FACTOR filters under the Assay group, RNA-seq and DNase
tracks fail the Assay evaluation and are hidden from the heatmap.
To display RNA-seq and DNase tracks alongside specific ChIP-seq
transcription factors, explicitly include SCORER_MODALITY:RNA-seq and
SCORER_MODALITY:DNase in f (handled automatically by
scripts/alphagenome_atlas_links.py):
f=BIOSAMPLE_NAME:<CellLine>,SCORER_MODALITY:RNA-seq,SCORER_MODALITY:DNase,ASSAY_TRANSCRIPTOR_FACTOR:<TF1>,ASSAY_TRANSCRIPTOR_FACTOR:<TF2>
4. Layout Configuration, AVI Scores, & Pinned Tracks (lItems)
Plotting AVI Scores and Modality Sections
- AVI Variant Impact Track (
avi): Including avi in lItems renders
the top-level AlphaGenome Variant Impact score track for the interval or
variant.
- Database Modality Sections (
section:<MODALITY>): Sections render full
unpinned heatmaps across all matching tracks for that modality (e.g.
section:RNA_SEQ, section:DNASE, section:CHIP_TF, section:ATAC,
section:CAGE).
Pinned Tracks & Motif Instances
[!NOTE] Track-Specific Motif Guideline: Pinned Active-ISM tracks with
motif instances and Contribution Weight Matrix (CWM) logos should only be
added when specifically requested for individual tracks. Only a limited
subset of tracks (such as key ChIP-TF or RNA-seq tracks relevant to the locus)
support and benefit from pinned motif overlays. For standard exploration
links, default section heatmaps
(avi,section:RNA_SEQ,section:DNASE,section:CHIP_TF) without pinned tracks
are preferred.
Motif instances and CWM logos render exclusively on pinned tracks at
base-pair resolution. General section heatmaps do not trigger motif footprint
rendering.
Pinned Track Key Schema
pinned:<TrackMetadataName>:<StrandNumber>:<ScorerShortName>:heatmap:HEATMAP_TILESET_SOURCE_ACTIVE_ISM_SCORES:<TilesetId>
<TrackMetadataName>: Exact track name from production metadata proto,
URL-encoded (%20 for spaces).
<StrandNumber>: 1 (STRAND_POSITIVE), 2 (STRAND_NEGATIVE), 3
(STRAND_UNSTRANDED).
<ScorerShortName>: RNA_SEQ, CHIP_TF, DNASE, ATAC, CAGE,
PROCAP, CHIP_HISTONE.
HEATMAP_TILESET_SOURCE_ACTIVE_ISM_SCORES: Required source identifier for
Active-ISM motif layers.
<TilesetId>: Server-assigned tileset identifier (17354278441953531756
for current production).
Recipe for Automatic Motif Display on Load
- Append
pinned:<PinnedKey> entries to lItems for the specific target
tracks only.
- Set viewport interval
i to base-pair resolution ($\le 1\text{ bp/px}$,
window $\le 380\text{ bp}$).
- Configure
f with cell line and transcription factors.
5. Track Predictions & Ref vs. Alt Comparisons (/atlas/track-predictions)
The dedicated /atlas/track-predictions page compares predicted functional
profiles between the Reference and Alternate alleles for selected scores across
genomic windows:
- Route:
https://deepmind.google.com/science/alphagenome/atlas/track-predictions
- Visualizations: Expanded line plots (expression, chromatin
accessibility, TF binding) and Sashimi arc charts (splice junctions).
Automated Prediction Link Generation (scripts/alphagenome_atlas_links.py track-predictions)
Always construct track prediction URLs using scripts/alphagenome_atlas_links.py track-predictions. Manual ScoreId string formatting is error-prone due to
donor/acceptor skipping coordinates, strand orientation (+/-), and genic vs.
non-genic suffix rules. The script automatically handles coordinate extraction
from GENCODE v46, track catalog resolution, and URL synthesis.
# Variant & Gene:
uv run scripts/alphagenome_atlas_links.py track-predictions \
--variant "chr15:42387805:C>G" \
--gene CAPN3 \
--biosample "Muscle_Skeletal" \
--modalities SPLICE_JUNCTIONS,RNA_SEQ,DNASE,CHIP_TF \
--tf CTCF
# Interval/Locus query:
uv run scripts/alphagenome_atlas_links.py track-predictions \
--variant "chr15:42387805:C>G" \
--interval "chr15:41869312-42917888" \
--biosample "Muscle_Skeletal" \
--modalities SPLICE_JUNCTIONS,RNA_SEQ,DNASE,CHIP_TF
Supported CLI Options for track-predictions
--variant, -v (string, default: None): Variant string in
chr:pos_1_based:ref>alt format.
--gene, -g (string, default: None): Target gene symbol (bounds
i= viewport and computes splice junctions).
--gene_id (string, default: None): Target Ensembl gene ID (e.g.
ENSG00000092529.26).
--interval, -i (string, default: None): Genomic interval
viewport in chr:start-end format.
--biosample, -b (string, default: Muscle_Skeletal): Target
biosample or tissue query (e.g. Muscle_Skeletal, K562, Whole_Blood).
--modalities, -m (string, default:
SPLICE_JUNCTIONS,RNA_SEQ,DNASE,CHIP_TF): Comma-separated list of
modalities (SPLICE_JUNCTIONS, RNA_SEQ, DNASE, ATAC, CHIP_TF).
--tf (string, default: CTCF): Transcription factor name for
ChIP-TF tracks (e.g. CTCF, GATA1).
--rename (string, default: None): Custom track rename overrides in
the chart card.
--legend_title (string, default: None): Custom legend header for
the chart card.
--format (enum, default: table): Output format (table, url,
json).
[!IMPORTANT] Mandatory Splicing & RNA-seq Co-Plotting Rule: When
generating /atlas/track-predictions deep-links, plotting, or visualizing
variant impact data for splicing variants, always plot continuous RNA-seq
expression alongside splicing tracks (SPLICE_JUNCTIONS,
SPLICE_SITE_USAGE, SPLICE_SITES). Splicing mutations frequently activate
cryptic splice junctions and trigger nonsense-mediated decay (NMD) or alter
total transcript output; assessing splice junctions (sashimi arcs) together
with continuous RNA-seq read coverage is required to observe both the
structural splice defect and the resulting change in overall transcript
abundance.
[!IMPORTANT] Always Provide Bounded i= in Track Prediction URLs:
Omitting scores= or leaving the genomic interval (i=) unbounded causes the
web application to attempt querying all matching tracks across the broader
locus, leading to severe latency or page hanging. alphagenome_atlas_links.py track-predictions automatically bounds i= to the target gene or requested
interval.
1---2name: alphagenome-atlas-website-links3description: "Constructs deep-links and URLs for the AlphaGenome Atlas website. Supports generating single-variant exploration links (1-based chr:pos:ref>alt), genomic locus views (1-based closed chr:start-end), candidate summary tables, and AlphaGenome reference vs. alternate predictions. Use whenever visualizing, exploring, charting, or linking genetic variants and genomic loci on the AlphaGenome Atlas, or when asked to inspect, view, or link predictions for a genomic variant."4metadata:5 source: https://skillmd.com/skills/fridrichmethod/alphagenome-atlas-website-links6---78# AlphaGenome Atlas Deep-Linking & URL Configuration910Construct and validate deep-links for the AlphaGenome Atlas web application11(`https://deepmind.google.com/science/alphagenome/atlas`).1213Base URL: `https://deepmind.google.com/science/alphagenome/atlas`1415> [!IMPORTANT] **Mandatory Atlas Deep-Linking with Variant Scores**: Whenever16> presenting, discussing, or scoring genetic variants, you **MUST always provide17> clickable deep-links to the18> [AlphaGenome Atlas](https://deepmind.google.com/science/alphagenome/atlas)**.19> Use `scripts/alphagenome_atlas_links.py` to automate link and table20> generation.2122--------------------------------------------------------------------------------2324## Prerequisites2526```bash27# 1. Single Variant Exploration Link:28uv run scripts/alphagenome_atlas_links.py variant "chr9:128225994:G>A" \29 --biosample K562 \30 --modalities RNA_SEQ,DNASE,CHIP_TF3132# 2. Genomic Locus / Interval Link:33uv run scripts/alphagenome_atlas_links.py locus "chr11:5288500-5290500" \34 --biosample K562 \35 --modalities RNA_SEQ,DNASE,CHIP_TF3637# 3. Format Candidate Variant Records Table (with embedded clickable links):38uv run scripts/alphagenome_atlas_links.py table --input top_variants.json --biosample K5623940# 4. Construct Ref vs. Alt Track Predictions Link (/atlas/track-predictions):41uv run scripts/alphagenome_atlas_links.py track-predictions \42 --variant "chr15:42387805:C>G" \43 --gene CAPN3 \44 --biosample "Muscle_Skeletal"45```4647--------------------------------------------------------------------------------4849## 2. URL Query Parameters5051* **`q`** (*string*, **Required**): Primary search target. Supports 1-based52 closed intervals (`chr11:5288500-5290500`), gene symbols (`BRCA1`), Ensembl53 IDs (`ENSG00000012048`), or 1-based variants (`chr7:27170000:A>G`).54* **`m`** (*enum*, Optional): View mode. Defaults to `entity` for55 genes/variants and `locus` for coordinate intervals. Use `variant` for56 variant queries. (Allowed: `locus`, `entity`, `variant`, `motifs`).57* **`i`** (*string*, Optional): Centered viewport zoom interval in 1-based58 closed `chr:start-end` format (e.g. `chr11:5289310-5289690`). Required for59 automatic motif rendering.60* **`f`** (*string*, Optional): Comma-separated filter predicates in61 `KEY:VALUE` format (e.g.62 `BIOSAMPLE_NAME:K562,SCORER_MODALITY:RNA-seq,ASSAY_TRANSCRIPTOR_FACTOR:GATA1`).63 Controls visible heatmap rows.64* **`lItems`** (*string*, Optional): Layout item sequence, AVI score track65 toggle (`avi`), section heatmaps, and pinned tracks list (e.g.66 `avi,section:RNA_SEQ,section:DNASE,pinned:<TrackKey>`).67* **`scores`** (*string*, Optional): Comma-separated list of `ScoreId` tokens68 for the `/atlas/track-predictions` page comparison (e.g.69 `<ScoreId1>,<ScoreId2>`).70* **`md`** (*enum*, Optional): Active modality tab selector on the track71 predictions view (`RNA_SEQ`, `SPLICE_JUNCTIONS`, `SPLICE_SITE_USAGE`,72 `DNASE`).73* **`tpRenames`** (*string*, Optional): Custom title overrides for specific74 score predictions (`ScoreId:CustomTitle`).75* **`tpLegendTitle`** (*string*, Optional): Custom legend title for the track76 predictions chart card (e.g. `Predicted Gene Expression`).7778> [!IMPORTANT] **Variant Query Format**: Variants in `q` must strictly use79> `chr:pos_1_based:ref>alt` format (e.g. `chr7:27170000:A>G` or URL-encoded80> `chr7:27170000:A%3EG`, where the position is 1-based). **Do not use**81> colon-separated alleles (`A:G`) or dbSNP rsIDs (rsIDs are unsupported).8283--------------------------------------------------------------------------------8485## 3. Multi-Modality Filtering & The Assay Group Gotcha (`f`)8687### Filter Groups & Boolean Evaluation8889Filters in `f` map to three primary evaluation groups:9091* **`Biosample` Group (`BIOSAMPLE_NAME`, `BIOSAMPLE_TYPE`)**: Evaluated with92 **AND** logic.93* **`Assay` Group (`SCORER_MODALITY`, `ASSAY_TRANSCRIPTOR_FACTOR`,94 `ASSAY_HISTONE_MARK`)**: Evaluated with **OR** logic.95* **`Gene` Group (`GENE_NAME`)**: Evaluated with **OR** logic.9697### ⚠️ Mandatory Multi-Modality Filter Rule9899`RNA-seq` and `DNase` tracks have no transcription factor code100(`transcriptionFactorCode === ""`). If `f` contains *only*101`ASSAY_TRANSCRIPTOR_FACTOR` filters under the Assay group, `RNA-seq` and `DNase`102tracks fail the Assay evaluation and are hidden from the heatmap.103104To display `RNA-seq` and `DNase` tracks alongside specific ChIP-seq105transcription factors, **explicitly include `SCORER_MODALITY:RNA-seq` and106`SCORER_MODALITY:DNase`** in `f` (handled automatically by107`scripts/alphagenome_atlas_links.py`):108109```110f=BIOSAMPLE_NAME:<CellLine>,SCORER_MODALITY:RNA-seq,SCORER_MODALITY:DNase,ASSAY_TRANSCRIPTOR_FACTOR:<TF1>,ASSAY_TRANSCRIPTOR_FACTOR:<TF2>111```112113--------------------------------------------------------------------------------114115## 4. Layout Configuration, AVI Scores, & Pinned Tracks (`lItems`)116117### Plotting AVI Scores and Modality Sections118119* **AVI Variant Impact Track (`avi`)**: Including `avi` in `lItems` renders120 the top-level AlphaGenome Variant Impact score track for the interval or121 variant.122* **Database Modality Sections (`section:<MODALITY>`)**: Sections render full123 unpinned heatmaps across all matching tracks for that modality (e.g.124 `section:RNA_SEQ`, `section:DNASE`, `section:CHIP_TF`, `section:ATAC`,125 `section:CAGE`).126127### Pinned Tracks & Motif Instances128129> [!NOTE] **Track-Specific Motif Guideline**: Pinned Active-ISM tracks with130> motif instances and Contribution Weight Matrix (CWM) logos should **only be131> added when specifically requested for individual tracks**. Only a limited132> subset of tracks (such as key ChIP-TF or RNA-seq tracks relevant to the locus)133> support and benefit from pinned motif overlays. For standard exploration134> links, default section heatmaps135> (`avi,section:RNA_SEQ,section:DNASE,section:CHIP_TF`) without pinned tracks136> are preferred.137138Motif instances and CWM logos render **exclusively on pinned tracks** at139base-pair resolution. General section heatmaps do not trigger motif footprint140rendering.141142### Pinned Track Key Schema143144```145pinned:<TrackMetadataName>:<StrandNumber>:<ScorerShortName>:heatmap:HEATMAP_TILESET_SOURCE_ACTIVE_ISM_SCORES:<TilesetId>146```147148* `<TrackMetadataName>`: Exact track name from production metadata proto,149 URL-encoded (`%20` for spaces).150* `<StrandNumber>`: `1` (`STRAND_POSITIVE`), `2` (`STRAND_NEGATIVE`), `3`151 (`STRAND_UNSTRANDED`).152* `<ScorerShortName>`: `RNA_SEQ`, `CHIP_TF`, `DNASE`, `ATAC`, `CAGE`,153 `PROCAP`, `CHIP_HISTONE`.154* `HEATMAP_TILESET_SOURCE_ACTIVE_ISM_SCORES`: Required source identifier for155 Active-ISM motif layers.156* `<TilesetId>`: Server-assigned tileset identifier (`17354278441953531756`157 for current production).158159### Recipe for Automatic Motif Display on Load1601611. Append `pinned:<PinnedKey>` entries to `lItems` for the specific target162 tracks only.1632. Set viewport interval `i` to base-pair resolution ($\le 1\text{ bp/px}$,164 window $\le 380\text{ bp}$).1653. Configure `f` with cell line and transcription factors.166167--------------------------------------------------------------------------------168169## 5. Track Predictions & Ref vs. Alt Comparisons (`/atlas/track-predictions`)170171The dedicated `/atlas/track-predictions` page compares predicted functional172profiles between the Reference and Alternate alleles for selected scores across173genomic windows:174175* **Route**:176 `https://deepmind.google.com/science/alphagenome/atlas/track-predictions`177* **Visualizations**: Expanded line plots (expression, chromatin178 accessibility, TF binding) and Sashimi arc charts (splice junctions).179180### Automated Prediction Link Generation (`scripts/alphagenome_atlas_links.py track-predictions`)181182Always construct track prediction URLs using `scripts/alphagenome_atlas_links.py183track-predictions`. Manual `ScoreId` string formatting is error-prone due to184donor/acceptor skipping coordinates, strand orientation (+/-), and genic vs.185non-genic suffix rules. The script automatically handles coordinate extraction186from GENCODE v46, track catalog resolution, and URL synthesis.187188```bash189# Variant & Gene:190uv run scripts/alphagenome_atlas_links.py track-predictions \191 --variant "chr15:42387805:C>G" \192 --gene CAPN3 \193 --biosample "Muscle_Skeletal" \194 --modalities SPLICE_JUNCTIONS,RNA_SEQ,DNASE,CHIP_TF \195 --tf CTCF196197# Interval/Locus query:198uv run scripts/alphagenome_atlas_links.py track-predictions \199 --variant "chr15:42387805:C>G" \200 --interval "chr15:41869312-42917888" \201 --biosample "Muscle_Skeletal" \202 --modalities SPLICE_JUNCTIONS,RNA_SEQ,DNASE,CHIP_TF203```204205### Supported CLI Options for `track-predictions`206207* **`--variant`, `-v`** (*string*, default: `None`): Variant string in208 `chr:pos_1_based:ref>alt` format.209* **`--gene`, `-g`** (*string*, default: `None`): Target gene symbol (bounds210 `i=` viewport and computes splice junctions).211* **`--gene_id`** (*string*, default: `None`): Target Ensembl gene ID (e.g.212 `ENSG00000092529.26`).213* **`--interval`, `-i`** (*string*, default: `None`): Genomic interval214 viewport in `chr:start-end` format.215* **`--biosample`, `-b`** (*string*, default: `Muscle_Skeletal`): Target216 biosample or tissue query (e.g. `Muscle_Skeletal`, `K562`, `Whole_Blood`).217* **`--modalities`, `-m`** (*string*, default:218 `SPLICE_JUNCTIONS,RNA_SEQ,DNASE,CHIP_TF`): Comma-separated list of219 modalities (`SPLICE_JUNCTIONS`, `RNA_SEQ`, `DNASE`, `ATAC`, `CHIP_TF`).220* **`--tf`** (*string*, default: `CTCF`): Transcription factor name for221 ChIP-TF tracks (e.g. `CTCF`, `GATA1`).222* **`--rename`** (*string*, default: `None`): Custom track rename overrides in223 the chart card.224* **`--legend_title`** (*string*, default: `None`): Custom legend header for225 the chart card.226* **`--format`** (*enum*, default: `table`): Output format (`table`, `url`,227 `json`).228229> [!IMPORTANT] **Mandatory Splicing & RNA-seq Co-Plotting Rule**: When230> generating `/atlas/track-predictions` deep-links, plotting, or visualizing231> variant impact data for splicing variants, **always plot continuous RNA-seq232> expression alongside splicing tracks** (`SPLICE_JUNCTIONS`,233> `SPLICE_SITE_USAGE`, `SPLICE_SITES`). Splicing mutations frequently activate234> cryptic splice junctions and trigger nonsense-mediated decay (NMD) or alter235> total transcript output; assessing splice junctions (sashimi arcs) together236> with continuous RNA-seq read coverage is required to observe both the237> structural splice defect and the resulting change in overall transcript238> abundance.239240> [!IMPORTANT] **Always Provide Bounded `i=` in Track Prediction URLs**:241> Omitting `scores=` or leaving the genomic interval (`i=`) unbounded causes the242> web application to attempt querying all matching tracks across the broader243> locus, leading to severe latency or page hanging. `alphagenome_atlas_links.py244> track-predictions` automatically bounds `i=` to the target gene or requested245> interval.