PVST(1)

πŸ“¦
version 1.0.12 Β· 3 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– pVst β€” like, the manual page, but make it make sense πŸ’–

okay bestie, welcome to pVst(1) β€” yeah, that's the section 1 manual, and the whole vibe is pVst (VCF statistics). sit down, grab a boba, we're doing copy-number math and we're gonna enjoy it πŸ§‹βœ¨


✨ NAME ✨

pVst β€” that's it, that's the name, she's short, she's iconic, she does one thing πŸ‘‘


🌸 SYNOPSIS 🌸

pVst –target 0,1,2,3,4,5,6,7 –background 11,12,13,16,17,19,22 –file
my.vcf –type CN

literally just hand her some individuals, a background, a VCF, and a field name, and she goes πŸ¦‹


πŸ’… DESCRIPTION πŸ’…

so pVst calculates vst, which is a measure of CNV stratification. that's the whole job. no cap.


πŸŽ€ OPTIONS πŸŽ€

first, the lore behind the number, because you deserve context, bestie 🫢

the statistic Vst is used to test the difference in copy numbers at each SV between two groups:

Vst = (Vt-Vs)/Vt

where Vt is the overall variance of copy number and Vs the average variance within populations.

Output : 4 columns :

  1. seqid
  2. position
  3. end
  4. vst
  5. probability
not me renumbering the original page πŸ’€ i'm not touching it β€” those are the numbers it shipped with, and we respect the source material. four columns, five lines, that's just how she is πŸ™ˆ

now the actual flags, one bullet each, no skipping, we don't do that here:

  • -t, --target β€” required β€” argument: a zero based comma separated list of target individuals corresponding to VCF columns
  • -b, --background β€” required β€” argument: a zero based comma separated list of background individuals corresponding to VCF columns
  • -f, --file β€” required β€” argument: a properly formatted VCF.
  • -y, --type β€” required β€” argument: the genotype field with the copy number: e.g. CN|CNF
  • -r, --region β€” optional β€” argument: a tabix compliant genomic range : seqid or seqid:start-end
  • -x, --cpu β€” optional β€” argument: number of CPUs [1]
  • -n, --per β€” optional β€” argument: number of permutations [1000]

Type: statistics πŸ“Š

reminder that -t, -b, -f and -y are required, so if you skip one and then act shocked when it fails... bestie, that's on you 😭

🌈 EXIT VALUES 🌈

  • 0 β€” Success πŸŽ‰ (the good ending)
  • not 0 β€” Failure πŸ’€ (the other ending)

⭐ SEE ALSO ⭐

go read your other manuals, i'll wait 🫢


🧚 OTHER 🧚

πŸ‘‘ LICENSE πŸ‘‘

Copyright 2011-2024 (C) Erik Garrison and vcflib contributors. MIT licensed. Copyright 2020-2024 (C) Pjotr Prins.

πŸ“ AUTHORS πŸ“

Erik Garrison and vcflib contributors.


and that's the whole page, bestie β€” pVst (vcflib), straight out of the vcflib crew, no date on the footer so don't come for me about one πŸ’–βœ¨ mwah, go stratify some CNVs, you absolute main character πŸ¦‹

πŸ“¦ where this page comes from