Skip to content

Fix copy-pasted UMI help text on paired-guide --pg-* options (#22) - #24

Merged
davidliwei merged 1 commit into
mainfrom
fix/pg-option-help-text
Jul 17, 2026
Merged

Fix copy-pasted UMI help text on paired-guide --pg-* options (#22)#24
davidliwei merged 1 commit into
mainfrom
fix/pg-option-help-text

Conversation

@davidliwei

@davidliwei davidliwei commented Jul 17, 2026

Copy link
Copy Markdown
Owner

Closes #22.

The count help text for the paired-guide options --pg-start, --pg-end, --pg-start-2, and --pg-end-2 was accidentally copied verbatim from the UMI options. It read "The relative start/end position of UMI ... if UMI is found on the first/second pair" and its worked examples referenced --umi-start/--umi-end — which reads as though a UMI is required to count paired-guide screens. It is not (reported in #22).

What changed

  • Rewrote the four --pg-* help strings to describe the second guide and the correct coordinate reference for each mode, matching the actual code in mageckcount_processonefile:
    • --pg-start / --pg-end — measured from the end of the first guide (--pairguide firstpair); slice is fseq[(end_1st_guide)+pg_start : (end_2nd_guide)+pg_end].
    • --pg-start-2 / --pg-end-2 — measured from the first nucleotide of read 2 (--pairguide secondpair); slice is fseq1[pg_start_2 : pg_end_2].
  • Fixed the --pg-min-read help, which stated "Default 2" while the actual default is 3.
  • CHANGELOG entry under Unreleased → Fixed.

Docs-only / help-string change; no behavior change. A companion PR updates the generated USAGE.md in davidliwei/mageck2-doc.

The count help for --pg-start/--pg-end/--pg-start-2/--pg-end-2 was copied
verbatim from the UMI options: it read "position of UMI ... if UMI is found
on the first/second pair" and its examples referenced --umi-start/--umi-end,
implying a UMI is required for paired-guide counting. It is not.

Rewrite the four strings to describe the second guide and the correct
coordinate reference for each mode: --pg-start/--pg-end are measured from the
end of the first guide (--pairguide firstpair), and --pg-start-2/--pg-end-2
from the first nucleotide of read 2 (--pairguide secondpair), matching the
actual slices in mageckcount_processonefile.

Also correct --pg-min-read help, which said "Default 2" while the default is 3.

Reported in issue #22.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EZcdrQdWJfczuqaMeZ3DBD
@davidliwei
davidliwei marked this pull request as ready for review July 17, 2026 14:16
@davidliwei
davidliwei merged commit 22fd1e7 into main Jul 17, 2026
6 checks passed
@davidliwei
davidliwei deleted the fix/pg-option-help-text branch July 17, 2026 14:19
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.

mageck2 count documentation error

1 participant