Skill Tracer
Skills › Scientific Agent Skills › alphagenome › interpretation.md

interpretation.md

149 lines · skills/alphagenome/references/interpretation.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Interpreting AlphaGenome and Atlas scores
2
3Distilled from the AlphaGenome and Atlas papers, the official FAQ, and the
4interpretation guide DeepMind ships with its own AlphaGenome agent skill.
5Reviewed against official scoring definitions and model source on 2026-09-30.
6These rules describe predictions, not established effects in a patient.
7

Interpreting AlphaGenome and Atlas scores

Distilled from the AlphaGenome and Atlas papers, the official FAQ, and the interpretation guide DeepMind ships with its own AlphaGenome agent skill. Reviewed against official scoring definitions and model source on 2026-09-30. These rules describe predictions, not established effects in a patient.

Raw lines 1 to 7
8## The frame
9
10AlphaGenome predicts what a genomics assay would read out from a DNA sequence.
11An Atlas or model score is therefore a **predicted molecular effect in a
12biosample the model was trained on**, nothing more:
14- It is not pathogenicity. AVI is trained to separate rare from common
15 variants; that correlates with impact and is validated on ClinVar, but a high
16 AVI is one line of evidence in a chain, "not sufficient evidence on its own"
17 (Atlas report, Discussion).
18- It is not a measurement. Predictions are correlative and can be wrong in
19 either direction; independent epigenomic or functional data decides.
20- It is not clinical. Terms of use and the report both exclude diagnostic use.
21 Never turn a score into a diagnosis, penetrance, prognosis, or treatment
22 statement. If the question is clinical, answer about molecular mechanism and
23 say so.

The frame

AlphaGenome predicts what a genomics assay would read out from a DNA sequence. An Atlas or model score is therefore a predicted molecular effect in a biosample the model was trained on, nothing more:

  • It is not pathogenicity. AVI is trained to separate rare from common variants; that correlates with impact and is validated on ClinVar, but a high AVI is one line of evidence in a chain, "not sufficient evidence on its own" (Atlas report, Discussion).
  • It is not a measurement. Predictions are correlative and can be wrong in either direction; independent epigenomic or functional data decides.
  • It is not clinical. Terms of use and the report both exclude diagnostic use. Never turn a score into a diagnosis, penetrance, prognosis, or treatment statement. If the question is clinical, answer about molecular mechanism and say so.
Raw lines 8 to 24
25## Raw score and quantile: always both
27| Quantity | What it is | Use it for |
28| --- | --- | --- |
29| `raw_score` | effect size on the scorer's own scale (RNA_SEQ: natural-log fold change with 0.001 pseudocount; center-mask scorers: log2 ratio of summed signal; splicing: change in probability or usage) | magnitude, direction, comparing tissues **within one scorer** |
30| `quantile_score` | rank against common variants (gnomAD v3 MAF > 0.01), signed scorers map CDF p to 2p-1; unsigned retain p; finite ranks saturate near 1 | unusualness; comparing across scorers |
31| AVI `avi_raw` | composite model output | ranking within a set |
32| AVI Phred | -10 log10(1 - cdf); 10 / 20 / 30 = top 10 % / 1 % / 0.1 % of all SNVs | genome-wide rank, thresholds |
34For `RNA_SEQ`, the scorer is
35`ln(mean ALT + 0.001) - ln(mean REF + 0.001)`. Thus `exp(raw_score)`
36is the ratio of pseudocount-adjusted means: -1 is about 0.37x, not 0.5x;
37`ln(2)` is about 0.693. At very low expression the pseudocount matters, so
38inspect baseline tracks before translating a score into a biological fold change.
39Recommended center-mask accessibility/TF/TSS scorers instead use a **log2**
40ratio of summed signal with a +1 pseudocount. `RNA_SEQ_ACTIVE` is the larger
41mean activity, with no log transform. Never apply one scorer's scale to another.
43The scripts' `--min-abs-quantile 0.99` keeps signed quantiles at or beyond
44+/-0.99 (the two 0.5% CDF tails), or unsigned quantiles >=0.99 (the upper 1%).
45It does not retain small unsigned scores near zero. Missing calibration does
46not pass this filter; mouse and custom scorers may have only raw scores.
47AVI has a separate genome-wide SNV CDF and Phred transformation.
48Quantiles are ranks, not significance tests or evidence of benignity. See the
49[official scoring definitions](https://www.alphagenomedocs.com/variant_scoring.html)
50and [calibration FAQ](https://www.alphagenomedocs.com/faqs.html).
52**The common trap: high quantile, tiny raw score.** In low-expression genes and
53quiet regions the background distribution is so narrow that a raw change of
540.05 ranks above 0.99. Report a small predicted change in the named track and
55inspect the baseline signal; this does not establish a statistically nonsignificant
56or biologically absent effect. Conversely a raw -1.5 with quantile 0.9 in a highly variable track is
57still a large predicted effect worth mentioning.
59Unsigned scorers (`POLYADENYLATION`, `SPLICE_*`, `CONTACT_MAPS`, all
60`*_ACTIVE`) have no direction; `*_ACTIVE` scores are the activity of the
61stronger allele and cannot be read as a difference at all.

Raw score and quantile: always both

QuantityWhat it isUse it for
raw_scoreeffect size on the scorer's own scale (RNA_SEQ: natural-log fold change with 0.001 pseudocount; center-mask scorers: log2 ratio of summed signal; splicing: change in probability or usage)magnitude, direction, comparing tissues within one scorer
quantile_scorerank against common variants (gnomAD v3 MAF > 0.01), signed scorers map CDF p to 2p-1; unsigned retain p; finite ranks saturate near 1unusualness; comparing across scorers
AVI avi_rawcomposite model outputranking within a set
AVI Phred-10 log10(1 - cdf); 10 / 20 / 30 = top 10 % / 1 % / 0.1 % of all SNVsgenome-wide rank, thresholds

For RNA_SEQ, the scorer is ln(mean ALT + 0.001) - ln(mean REF + 0.001). Thus exp(raw_score) is the ratio of pseudocount-adjusted means: -1 is about 0.37x, not 0.5x; ln(2) is about 0.693. At very low expression the pseudocount matters, so inspect baseline tracks before translating a score into a biological fold change. Recommended center-mask accessibility/TF/TSS scorers instead use a log2 ratio of summed signal with a +1 pseudocount. RNA_SEQ_ACTIVE is the larger mean activity, with no log transform. Never apply one scorer's scale to another.

The scripts' --min-abs-quantile 0.99 keeps signed quantiles at or beyond +/-0.99 (the two 0.5% CDF tails), or unsigned quantiles >=0.99 (the upper 1%). It does not retain small unsigned scores near zero. Missing calibration does not pass this filter; mouse and custom scorers may have only raw scores. AVI has a separate genome-wide SNV CDF and Phred transformation. Quantiles are ranks, not significance tests or evidence of benignity. See the official scoring definitions and calibration FAQ.

The common trap: high quantile, tiny raw score. In low-expression genes and quiet regions the background distribution is so narrow that a raw change of 0.05 ranks above 0.99. Report a small predicted change in the named track and inspect the baseline signal; this does not establish a statistically nonsignificant or biologically absent effect. Conversely a raw -1.5 with quantile 0.9 in a highly variable track is still a large predicted effect worth mentioning.

Unsigned scorers (POLYADENYLATION, SPLICE_*, CONTACT_MAPS, all *_ACTIVE) have no direction; *_ACTIVE scores are the activity of the stronger allele and cannot be read as a difference at all.

Raw lines 25 to 62
63## AVI thresholds
65The report recommends **ranking over hard cut-offs** and thresholds that are
66"genomic region- or application-aware": pathogenic regulatory variants sit in
67lower AVI bins than pathogenic protein-truncating or splice-motif variants, so a
68single genome-wide Phred cut-off systematically under-calls regulatory hits.
69Practical pattern:
711. Rank the candidate set by Phred and report the ranks.
722. State the top-percentile the Phred implies (Phred 20 = top 1 % of SNVs).
733. Read the feature attribution. `MERGED_SPLICING` or `ALPHAMISSENSE` dominant
74 means a coding or splice mechanism; `MAX_ABS_DNASE` / `MAX_ABS_CHIP_TF` /
75 `MAX_ABS_RNA_SEQ` mean a regulatory mechanism you can drill into by track;
76 `CACTUS_241_WAY` / `PHASTCONS_470_WAY` dominant means conservation is
77 carrying the score and the molecular mechanism is **not** resolved by AVI.
784. Only then drill into the per-track scores for the matched tissue.

AVI thresholds

The report recommends ranking over hard cut-offs and thresholds that are "genomic region- or application-aware": pathogenic regulatory variants sit in lower AVI bins than pathogenic protein-truncating or splice-motif variants, so a single genome-wide Phred cut-off systematically under-calls regulatory hits. Practical pattern:

  1. Rank the candidate set by Phred and report the ranks.
  2. State the top-percentile the Phred implies (Phred 20 = top 1 % of SNVs).
  3. Read the feature attribution. MERGED_SPLICING or ALPHAMISSENSE dominant means a coding or splice mechanism; MAX_ABS_DNASE / MAX_ABS_CHIP_TF / MAX_ABS_RNA_SEQ mean a regulatory mechanism you can drill into by track; CACTUS_241_WAY / PHASTCONS_470_WAY dominant means conservation is carrying the score and the molecular mechanism is not resolved by AVI.
  4. Only then drill into the per-track scores for the matched tissue.
Raw lines 63 to 79
80## Tissue matching
82- Choose biosamples by the disease's organ system and cell type, resolved to
83 ontology terms, not by name similarity. Cardiac muscle is not smooth muscle;
84 a fibroblast line is not brain.
85- Report both the tissue with the largest predicted effect and the
86 disease-relevant tissue, even when the latter shows nothing. An unexpected
87 top tissue is a finding; a silent relevant tissue is also a finding.
88- If the specific cell type has no track, fall back to the organ and say so.
89- Evidence from an unrelated tissue is evidence about a different question.

Tissue matching

  • Choose biosamples by the disease's organ system and cell type, resolved to ontology terms, not by name similarity. Cardiac muscle is not smooth muscle; a fibroblast line is not brain.
  • Report both the tissue with the largest predicted effect and the disease-relevant tissue, even when the latter shows nothing. An unexpected top tissue is a finding; a silent relevant tissue is also a finding.
  • If the specific cell type has no track, fall back to the organ and say so.
  • Evidence from an unrelated tissue is evidence about a different question.
Raw lines 80 to 90
91## Negative results
93A flat prediction does not establish that a variant is benign. "AlphaGenome predicts no
94appreciable change in the queried DNase and RNA-seq tracks" is a complete,
95valuable answer. Do not invent a cryptic splice site or an enhancer disruption
96that the tracks do not show; do not infer disruption from location in a peak
97when REF and ALT tracks are identical.

Negative results

A flat prediction does not establish that a variant is benign. "AlphaGenome predicts no appreciable change in the queried DNase and RNA-seq tracks" is a complete, valuable answer. Do not invent a cryptic splice site or an enhancer disruption that the tracks do not show; do not infer disruption from location in a peak when REF and ALT tracks are identical.

Raw lines 91 to 98
99## What the model cannot see
101- **Trans effects.** Only cis-regulatory grammar in a 1 Mb window; nothing about
102 TF abundance, signalling, or the rest of the genome.
103- **Training-data gaps.** RNA-seq training includes poly(A)+ and total RNA assays,
104 with uneven coverage of non-polyadenylated RNAs (including snRNAs);
105 inspect the relevant assay before claiming the model captures them. Many cell types are absent;
106 coverage is uneven across assays. A flat prediction in an untrained cell type
107 is absence of data, not absence of effect.
108- **Protein-level consequences.** Missense stability, catalysis, folding: use
109 AlphaMissense (already an AVI feature) or protein tools.
110- **Post-transcriptional biology** beyond splicing and polyadenylation: RNA
111 structure, miRNA processing, localisation, translation.
112- **Diploidy.** One haplotype per prediction; no heterozygous dosage, no
113 compound effects unless you build the haplotype sequence yourself (the
114 "haplotype workaround" tutorial).
115- **Developmental time and stimulus context.** Static biosample profiles only.
116- **Indels in the Atlas.** Scored for the paper, not yet served; use the model.
117 Very large structural variants are unreliable everywhere.
118- **Other species.** Only human and mouse were trained; nothing else is
119 benchmarked.

What the model cannot see

  • Trans effects. Only cis-regulatory grammar in a 1 Mb window; nothing about TF abundance, signalling, or the rest of the genome.
  • Training-data gaps. RNA-seq training includes poly(A)+ and total RNA assays, with uneven coverage of non-polyadenylated RNAs (including snRNAs); inspect the relevant assay before claiming the model captures them. Many cell types are absent; coverage is uneven across assays. A flat prediction in an untrained cell type is absence of data, not absence of effect.
  • Protein-level consequences. Missense stability, catalysis, folding: use AlphaMissense (already an AVI feature) or protein tools.
  • Post-transcriptional biology beyond splicing and polyadenylation: RNA structure, miRNA processing, localisation, translation.
  • Diploidy. One haplotype per prediction; no heterozygous dosage, no compound effects unless you build the haplotype sequence yourself (the "haplotype workaround" tutorial).
  • Developmental time and stimulus context. Static biosample profiles only.
  • Indels in the Atlas. Scored for the paper, not yet served; use the model. Very large structural variants are unreliable everywhere.
  • Other species. Only human and mouse were trained; nothing else is benchmarked.
Raw lines 99 to 120
121## Coordinate hygiene before any lookup
1231. Assembly must be GRCh38 for the Atlas (hg38 for the human model, mm10 for
124 mouse). Lift over GRCh37 sources first and re-check REF.
1252. REF must equal the reference base; the Atlas key ignores REF, so a swapped
126 allele can miss; a mismatched REF/build can misidentify a record. These
127 helpers compare the returned variant to the requested variant but do not
128 perform a FASTA reference check.
1293. Variants are 1-based, `genome.Interval` is 0-based half-open. Converting a
130 1-based closed `chr:start-end` means `start - 1, end`.
1314. Left-normalise indels before scoring with the model.
1325. Keep the `chr` prefix (`chrM` for the mitochondrion).
134The `genomic-coordinates` skill covers all of this with scripts.

Coordinate hygiene before any lookup

  1. Assembly must be GRCh38 for the Atlas (hg38 for the human model, mm10 for mouse). Lift over GRCh37 sources first and re-check REF.
  2. REF must equal the reference base; the Atlas key ignores REF, so a swapped allele can miss; a mismatched REF/build can misidentify a record. These helpers compare the returned variant to the requested variant but do not perform a FASTA reference check.
  3. Variants are 1-based, genome.Interval is 0-based half-open. Converting a 1-based closed chr:start-end means start - 1, end.
  4. Left-normalise indels before scoring with the model.
  5. Keep the chr prefix (chrM for the mitochondrion).

The genomic-coordinates skill covers all of this with scripts.

Raw lines 121 to 135
Names a skill genomic-coordinates :134
136## Reporting checklist
138- Name the source: "AlphaGenome Atlas (AVI, precomputed)" or "AlphaGenome model
139 (on-demand, 1 Mb window)", with the client version and the date of the query.
140- For every variant: raw score **and** quantile or Phred, the scorer, the track
141 or biosample and its ontology CURIE, and the gene for gene-centric scorers.
142- Direction as words ("predicted 2.3-fold lower HBB expression in erythroblast
143 RNA-seq"), never a bare number.
144- Say which claims rest on the model alone and which have independent support.
145- Link each variant to the Atlas website so a reader can inspect the tracks
146 (`scripts/atlas_link.py`).
147- Close with the limitation that applies (untrained tissue, conservation-driven
148 AVI, non-polyadenylated gene, ...), and the standard research-only statement.
149- Cite the AlphaGenome paper and the Atlas report.

Reporting checklist

  • Name the source: "AlphaGenome Atlas (AVI, precomputed)" or "AlphaGenome model (on-demand, 1 Mb window)", with the client version and the date of the query.
  • For every variant: raw score and quantile or Phred, the scorer, the track or biosample and its ontology CURIE, and the gene for gene-centric scorers.
  • Direction as words ("predicted 2.3-fold lower HBB expression in erythroblast RNA-seq"), never a bare number.
  • Say which claims rest on the model alone and which have independent support.
  • Link each variant to the Atlas website so a reader can inspect the tracks (scripts/atlas_link.py).
  • Close with the limitation that applies (untrained tissue, conservation-driven AVI, non-polyadenylated gene, ...), and the standard research-only statement.
  • Cite the AlphaGenome paper and the Atlas report.
Raw lines 136 to 149
Runs code scripts/atlas_link.py :146