Skip to content

Make the alphagenome_pt null alias state what verifies it - #241

Merged
lucapinello merged 1 commit into
mainfrom
docs/2026-08-18-alias-premise-is-checkable
Aug 18, 2026
Merged

Make the alphagenome_pt null alias state what verifies it#241
lucapinello merged 1 commit into
mainfrom
docs/2026-08-18-alias-premise-is-checkable

Conversation

@lucapinello

Copy link
Copy Markdown
Contributor

Follow-up to #240. Keeping the alias was confirmed, so the premise it rests on should be traceable.

_CDF_ALIASES maps alphagenome_pt → alphagenome, which makes one backend's percentiles depend on
another backend's background null. That turns "the two produce the same predictions" into a correctness
requirement
, not a convenience note — and the comment stated it as a bare fact, which is exactly how it
stood while being silently false for 738 splice tracks (correlation 0.20 against this very null).

Both comments now:

  • point at tests/test_alphagenome_backends_equivalence.py as the thing that holds the claim up,
  • name the tolerance it enforces (one track per output type, correlation > 0.99, peak-relative < 8%),
  • record that agreement is ~1–5% per head as measured, not assumed,
  • and warn against narrowing that test's coverage again — its earlier three-DNASE-track version passed
    throughout the period the claim was false.

Comments only, no behaviour change. Fast suite 2,142 passed / 35 skipped.

Keeping the alias (confirmed), so the premise it rests on should be traceable rather than asserted.

_CDF_ALIASES makes one backend's percentiles depend on another backend's null. That makes "the two
produce the same predictions" a correctness requirement, not a convenience note -- and the old comment
stated it as a bare fact, which is how it stood while being silently false for 738 splice tracks
(correlation 0.20 against this very null, fixed in #240).

Both comments now point at tests/test_alphagenome_backends_equivalence.py, name the tolerance it enforces
(one track per output type, correlation > 0.99, peak-relative < 8%), record that agreement is ~1-5% per
head as measured rather than assumed, and warn against narrowing that test's coverage again -- the earlier
three-DNASE-track version passed throughout the period the claim was false.

No behaviour change; comments only. Fast suite 2,142 passed / 35 skipped.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@lucapinello
lucapinello merged commit 399d631 into main Aug 18, 2026
2 checks passed
@lucapinello
lucapinello deleted the docs/2026-08-18-alias-premise-is-checkable branch August 18, 2026 02:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant