SHAPEIT4(1)

πŸ’– SHAPEIT4 πŸ’–

okay so bestie, welcome to the SHAPEIT4(1) page β€” yeah it's a "General Commands Manual" page, but honestly? it's giving main character energy and we're gonna read it together. grab a snack πŸ“


✨ NAME ✨

shapeit4 β€” fast and accurate method for estimation of haplotypes (phasing)

like. it phases. it's fast. it's accurate. periodt.


🌈 SYNOPSIS 🌈

shapeit4 [options]

that's it, that's the whole vibe check. you just run it with options and let it cook πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

Segmented HAPlotype Estimation and Imputation Tools version 4 β€” aka SHAPEIT4, iykyk.

so SHAPEIT4 is a fast and accurate method for estimation of haplotypes (aka phasing) for SNP array and sequencing data. no cap.

it includes a Positional Burrow Wheeler Transform (PBWT) based approach to quickly select a small set of informative conditioning haplotypes to be used when updating the phase of an individual. literally so smart of it.

it accounts for sets of pre-phased genotypes (i.e. haplotype scaffold). and bestie, the scaffold can be derived either from family data or large reference panels β€” your choice, your era πŸ’œ

it reads and writes files using HTSlib for better I/O performance in either VCF or BCF formats. the genotype graph and HMM routines have been re-implemented for better hardware usage and performance. she got a glow-up fr fr ✨


πŸ‘‘ OPTIONS πŸ‘‘

πŸŽ€ Basic options

  • --help β€” Produce help message. the "hi bestie what do you need" flag 🫢
  • --seed arg (=15052011) β€” Seed of the random number generator. same seed, same results, that's the rule 🌸
  • -T, --thread arg (=1) β€” Number of thread used. give her more threads, she'll go faster πŸ”₯

🧚 Input files

  • -I, --input arg β€” Genotypes to be phased in VCF/BCF format. your raw material, bestie
  • -H, --reference arg β€” Reference panel of haplotypes in VCF/BCF format. the iconic elders we look up to πŸ‘‘
  • -S, --scaffold arg β€” Scaffold of haplotypes in VCF/BCF format. the structure holding it all together πŸ’…
  • -M, --map arg β€” Genetic map. the map. of genetics.
  • -R, --region arg β€” Target region. zoom in on where you're working πŸ“
  • --use-PS arg β€” Informs phasing using PS field from read based phasing. the PS field said "let me help" and honestly? we let it

🎲 MCMC parameters

  • --mcmc-iterations arg (=5b,1p,1b,1p,1b,1p,5m) β€” Iteration scheme of the MCMC. that default string is a whole choreography, not me reading it like a dance routine 😭
  • --mcmc-prune arg (=0.999) β€” Pruning threshold. she's pruning, she's selective, we love that for her 🌿
  • --mcmc-store-K arg β€” Store K sizes in last iterations. keep the receipts from the final rounds 🧾

🌸 PBWT parameters

  • --pbwt-disable-init β€” Do not initialise haplotypes by PBWT (rephase input haplotype data). turning off the init and rephasing the input haplotype data instead πŸ™ˆ
  • --pbwt-modulo arg (=8) β€” Storage frequency of PBWT indexes in variant numbers (i.e. 16 means storage every 16 variants). so like, 16 = every 16 variants. cute little storage schedule ✨
  • --pbwt-depth arg (=4) β€” Depth of PBWT indexes to condition on. how deep we're conditioning, no pun intended (pun fully intended)

πŸ’œ HMM parameters

  • -W, --window arg (=2000000) β€” Minimal size of the phasing window. the minimal size, so it can be bigger, she just won't go smaller πŸͺŸ
  • --effective-size arg (=15000) β€” Effective size of the population. 15000 of them. iconic crowd

πŸ’Ύ Output files

  • -O, --output arg β€” Phased haplotypes in VCF/BCF format. the final look, the reveal, the slay πŸ’–
  • --log arg β€” Log file. so you can read back what happened like a diary entry πŸ““

πŸ”— SEE ALSO πŸ”—

go read the docs bestie, they're right there 🫢


πŸ–ŠοΈ AUTHOR πŸ–ŠοΈ

SHAPEIT4 was written by Olivier Delaneau. thank you Olivier, you ate πŸ’…βœ¨


lowkey reminder: this page is from December 2018, and it's the SHAPEIT4(1) manual page from the General Commands Manual section β€” so if you're reading this in the future, just know she's been iconic since 2018 πŸ’–πŸ¦‹πŸŽ€ ok bye ily, go phase something 🧬🌈