Skip to content

docs: wet-lab probability analysis, gold standard calibration, AUROC fix - #81

Merged
cschanhniem merged 2 commits into
mainfrom
feat/wet-lab-probability-and-calibration
Jun 28, 2026
Merged

cschanhniem merged 2 commits into
mainfrom
feat/wet-lab-probability-and-calibration

Conversation

@cschanhniem

Copy link
Copy Markdown
Collaborator

Summary

  • docs/WET_LAB_PROBABILITY.md — Comprehensive per-family and composite probability analysis for the 20-candidate pilot panel across 7 scaffold families. Covers: P(MIC ≤ 16 µg/mL) = 92–97%, P(potent, ≤4 µg/mL) = 65–80%, P(publishable) = 30–50%, P(breaking news with MDR) = 8–18%. Includes attrition model, assay sequence guidance, and documented epistemic ceiling (why 100% probability is computationally impossible).
  • docs/GOLD_STANDARD_CALIBRATION.md — Committed calibration report (previously only in gitignored outputs/). Magainin-2 scores ABOVE the panel (0.872); Melittin, Defensin-HNP1, Temporin-A score WITHIN; LL-37/Cecropin-A score BELOW. Confirms internal consistency at AUROC 0.8420.
  • cli.py AUROC fix — gold_standard disclaimer text had stale AUROC=0.8047 (pre-PR fix: remove duplicate validation entry (REF-GIG-001 = magainin-2) #66 value); corrected to AUROC=0.8420 (PR feat: face segregation bonus in activity scoring (+AUROC 0.8348→0.8420) #72 final).

Stale output files (gitignored, regenerated locally)

outputs/pilot_panel.fasta and outputs/external_predict_checklist.md were stale (pre-PR #72 panel, missing SEED-001_VAR_064, wrong SEED-008 variant). Regenerated by running make external-predict which re-ran the full pipeline. Both files now reflect the current 20-candidate 7-family panel. (These files are gitignored per .gitignore; they can be regenerated at any time with make external-predict.)

Test plan

  • All 1258 tests pass (make test)
  • Gold standard calibration regenerated and matches expected values (panel mean 0.821, SEED-008_VAR_032 highest at 0.857, SEED-001_VAR_064 at 0.802)
  • pilot_panel.fasta contains SEED-001_VAR_064 (rank 20) and correct 7-family 20-candidate panel
  • AUROC fix: grep "AUROC=0.8420" src/openamp_foundry/cli.py passes
  • Human review of probability estimates in WET_LAB_PROBABILITY.md before sending to wet-lab team

🤖 Generated with Claude Code

…x AUROC

- docs/WET_LAB_PROBABILITY.md: quantified per-family and composite discovery
  probability for 20-candidate pilot panel across 7 scaffold families; includes
  attrition model, breaking-news criteria, assay sequence guidance, and
  documented epistemic ceiling on computational prediction
- docs/GOLD_STANDARD_CALIBRATION.md: committed calibration report showing known
  AMPs (Magainin-2, Melittin, Defensin-HNP1, Temporin-A) score within/above the
  current 7-family pilot panel (mean ensemble 0.821); confirms pipeline calibration
- cli.py: fix AUROC=0.8047→0.8420 in gold_standard disclaimer text (AUROC 0.8047
  was the pre-PR #66 duplicate-corrected value; 0.8420 is the PR #72 final value)
GOLD_STANDARD_CALIBRATION.md:
- [HIGH] Fix Melittin blind-spot text: safety model assigns Safety=1.0 for Melittin
  (a confirmed model failure for curvature-mediated hemolysis); warn that Safety=1.0
  cannot be used as evidence of non-hemolysis for any panel candidate
- [MEDIUM] Acknowledge LL-37/Cecropin-A scoring below panel floor — indicates
  pipeline is optimised for magainin/mastoparan class; LL-37-like mechanisms may
  be under-scored
- [MEDIUM] Rephrase AUROC disclaimer: "retrospective benchmark, not external
  prospective validation" (avoids conflating benchmark performance with independence)
- [LOW] Fix Temporin-A SEED-004 reference for readers without history context

WET_LAB_PROBABILITY.md:
- [HIGH] Fix arithmetic error in pessimistic composite: 0.000127 → 0.000635,
  "99.99%" → "99.94%"
- [MEDIUM] Fix SEED-009 mechanism description: ribosome exit tunnel binding (Gagnon
  2016) and DnaK chaperone binding are distinct intracellular targets, not one pathway
- [LOW] Fix "lowest serum stability" text: SEED-003 and SEED-008 (not SEED-003 and
  SEED-005) have the lowest model-estimated stability scores
- Downgrade hemolysis probability estimates in conditional table: safety model is
  blind to curvature-mediated hemolysis (Melittin confirmed); estimate from structural
  class literature instead; adjust P(active AND passes hemolysis) 55-70% → 45-60%
@cschanhniem
cschanhniem merged commit 7134b1d into main Jun 28, 2026
3 checks passed
@cschanhniem
cschanhniem deleted the feat/wet-lab-probability-and-calibration branch June 28, 2026 16:00
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