Skip to content

Add extra column Hgvs_Offset and extend Additional_Transcripts - #301

Open
leexgh wants to merge 7 commits into
genome-nexus:masterfrom
leexgh:extra-column
Open

Add extra column Hgvs_Offset and extend Additional_Transcripts#301
leexgh wants to merge 7 commits into
genome-nexus:masterfrom
leexgh:extra-column

Conversation

@leexgh

@leexgh leexgh commented Jul 24, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds a new HGVS_Offset column, populated under --mode extended (alongside Additional_Transcripts), resolved from the canonical transcript's hgvs_offset in the raw Genome Nexus transcriptConsequences response.
  • Bumps genome-nexus-java-api-client from c8ba14d555 to b43dccc7fa, which is required to read hgvs_offset at all — the previously pinned client never deserialized that field (confirmed via javap before making any code changes).
  • Fixes a pre-existing broken test: minimal_example_with_additional_columns.txt went stale after RefSeq was added to Additional_Transcripts entries and was never regenerated, so SpringBatchIntegrationTest#check_if_output_contains_additional_transcripts_when_extendedMode_is_true was failing on this branch. Regenerated against www.genomenexus.org and confirmed the only diff was the missing RefSeq field.

Details

  • AnnotationUtil.resolveHgvsOffset(...) matches the canonical transcript by transcriptId against the raw transcriptConsequences list (the summarized TranscriptConsequenceSummary used for HGVSc/HGVSp doesn't expose hgvs_offset).
  • GenomeNexusImpl / AnnotatedRecord follow the exact same pattern as Additional_Transcripts (extended-mode gated, header only grows when the field is actually set).
  • New AnnotationUtilTest unit tests cover the matching logic directly, since www.genomenexus.org doesn't compute hgvs_offset yet (still pre-genome-nexus#861, confirmed via direct API check) — the field reads blank in the live integration test fixture for that reason, not a bug.

Test plan

  • mvn clean test passes (full suite)
  • New AnnotationUtilTest covers match found / null offset / no match / null transcript list / null canonical transcript
  • Verified TranscriptConsequence.getHgvsOffset() exists in the new client jar via javap before wiring it in

leexgh added 4 commits June 22, 2026 18:19
- Bump genome-nexus-java-api-client to b43dccc7fa, which adds
  TranscriptConsequence.hgvsOffset (needed to read hgvs_offset from
  Genome Nexus responses; the previously pinned client never exposed it).
- Add HGVS_Offset column under --mode extended, resolved by matching the
  canonical transcript against the raw transcriptConsequences list.
- Fix minimal_example_with_additional_columns.txt, which went stale after
  RefSeq was added to Additional_Transcripts entries and was never
  regenerated, breaking the extended-mode integration test.
@leexgh leexgh changed the title Extra column Add extra column Hgvs_Offset and extend Additional_Transcripts Jul 24, 2026
leexgh added 2 commits July 25, 2026 00:42
Production upgraded from v2.1.3 to v2.2.1 (crossing genome-nexus#861's
canonical transcript / splice consequence changes), which changed HGVSp
resolution for intronic splice-region and synonymous-splice variants
(e.g. blank/"p.X###_splice" -> "p.Leu###="/"p.*###*"). Regenerated all
affected fixtures against the live server; verified each diff was
consistent with this one underlying behavior change before accepting.
@leexgh
leexgh force-pushed the extra-column branch 2 times, most recently from 583b2b0 to 136afdb Compare August 6, 2026 05:16
…mutation so the protein change is different (since 2.2.1)
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