VCFv4.5 Specification Inaccuracy -- Large Insertions (Circular) [§5.4.2]

Open Beginner friendly
#869 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
tex
Domain
documentation

Research direction

Open VCFv4.5.tex at lines 1512-1518 and compare the circular contig example with the MATEID definition and preceding insertion examples. Verify the four reciprocal pairings and confirm that all records retain EVENT=INS0; done means the example no longer self-references or points to the undefined bnd_C.

Written by the indexing model from the issue text.

Description

I think there may be a few MATEID typos in the circular contig example in VCF v4.5 (§5.4.2). (LaTeX Lines 1512-1518)

The example currently contains:

bnd_U ... MATEID=bnd_U
bnd_V ... MATEID=bnd_V
bnd_X ... MATEID=bnd_Y
bnd_Y ... MATEID=bnd_C

The first two appear to self-reference, and bnd_C is not defined in the example.

Based on the definition of MATEID (“ID of mate breakend”), the reciprocal pairing used in the preceding insertion examples, and the breakend topology shown here, I believe the intended values may be:

bnd_U ... MATEID=bnd_V
bnd_V ... MATEID=bnd_U
bnd_X ... MATEID=bnd_Y
bnd_Y ... MATEID=bnd_X

with all four records continuing to share EVENT=INS0.

Could you confirm whether these are typos in the current specification example? If so, I’d be happy to submit a small PR correcting the table.

Dominant language
TeX
Stars
713
Forks
180
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from samtools/hts-specs

All issues in samtools/hts-specs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.