openvax / topiary

88%

master: 90%

LAST BUILD ON BRANCH v5.2.0

branch: v5.2.0

CHANGE BRANCH

x

Reset

• v5.2.0
• add-agents-md
• add-cache-sharding
• add-cached-predictor
• add-model-colon-kind-syntax
• add-netmhc-cache-loaders
• add-protected-tissues-scope
• add-self-proteome-nearest
• antigen-fragment
• bare-ident-brackets
• best-allele-aggregation
• cached-predictor-cli
• cached-predictor-vaxrank-polish
• chore/varcode-floor-122
• ci-caching
• cleanup-dsl-version-syntax
• codex/mhctools-3-7-compat
• codex/predict-wt-peptides
• combine-predictor-results
• csv-fasta-inputs
• dsl-extensions
• dsl-polish
• dsl-polish-v5.0.1
• dsl-refactor-v5
• eval-context-default-methods
• evaluate-scores-helper
• expression-data
• expression-dsl-v2
• feature/peptide-property-dsl
• filter-auto-aggregate
• fix-127-autowrap-test
• fix-165-backfill-value-from-score
• fix-biopython-dependency
• fix-deploy-python-selection
• improve-cli-errors
• inline-blosum62
• io-wide-v4.11
• lazy-varcode-imports
• lens-loader
• master
• multi-model-disambiguation
• openvax_switch
• peptide-provenance
• pirlygenes-5.1-expression-accessors
• plumb-kind-support
• pr-b-fragment-refactor
• promote-kind-aliases-public
• pvacseq-loader
• refactor-for-protein-sequences
• release-4.8.0
• restore-varcode-cli-parser-delegation
• shrink-cached-predictor-index
• test-audit-v4.10
• topiary-result
• v4.10.0
• v4.11.0
• v4.11.1
• v4.11.2
• v4.12.0
• v4.3.0
• v4.3.1
• v4.3.2
• v4.4.0
• v4.5.0
• v4.5.1
• v4.6.0
• v4.8.0
• v4.9.0
• v5.0.0
• v5.0.1
• v5.1.0
• v5.10.0
• v5.10.1
• v5.10.2
• v5.10.3
• v5.10.4
• v5.10.5
• v5.10.6
• v5.10.7
• v5.10.8
• v5.11.0
• v5.12.0
• v5.13.0
• v5.14.0
• v5.14.1
• v5.15.0
• v5.16.1
• v5.16.2
• v5.4.0
• v5.5.0
• v5.6.0
• v5.8.0
• v5.9.0
• v5.9.1

Build # 24363753027

Build Type

push

github

Committed by web-flow

Commit Message

AntigenFragment abstraction — v5.2.0 (#120)

* Add AntigenFragment abstraction — v5.2.0

Core abstraction for antigens from any origin (somatic variants,
structural variants, ERVs, CTAs, viral proteins, allergens,
autoantigens, synthetic constructs), unified through one prediction
pipeline.  Designed to be reusable by vaxrank for vaccine-window
selection, not just epitope scoring.

New module topiary/antigen.py:
- AntigenFragment dataclass (frozen, eq=False).  Free-form
  `source_type` tag (recommended vocabulary documented but not
  enforced); `target_intervals: list[tuple[int,int]] | None` for
  disjoint regions (tandem-duplication breakpoints, ERV non-self
  regions, etc.); `reference_sequence` + `germline_sequence` with
  germline-precedence `effective_baseline`.  Identity by
  `fragment_id`: human-readable prefix + SHA-1 hash (8 hex).
  Convenience constructors `from_variant` (handles in-frame vs
  frameshift target semantics) and `from_junction` (fusion / splice
  / cryptic-exon variants).  Stdlib-only serialization
  `to_dict`/`from_dict`/`to_json`/`from_json`; compact `__str__`.

New module topiary/io_antigen.py:
- `read_antigens` / `write_antigens` / `iter_antigens` TSV IO.
  JSON-encoded columns for `target_intervals` and `annotations`.
  Unknown columns rejected to catch typos; use annotations dict for
  tool-specific extensions.

TopiaryPredictor.predict_from_antigens(fragments):
- Scans each fragment's sequence, propagates fragment-level fields
  (source_type, variant, effect, effect_type, gene, gene_id,
  transcript_id, gene_expression, transcript_expression, plus every
  annotation key) onto prediction rows.
- Threads `fragment_id` through so downstream code (vaxrank) can
  group peptides back to their source.
- Emits `overlaps_target` (bool / NaN) computed from each peptide's
  position vs. the fragment's target_intervals.
- Backwards-compat `contains_mutant_residues` for source types
  prefixed with `variant`.
- `wt_peptide` + `wt_pep... (continued)

Coverage Stats

240 of 247 new or added lines in 5 files covered. (97.17%)

2983 of 3390 relevant lines covered (87.99%)

2.64 hits per line