Plugin tag2tag
This plugin can be used to convert between similar tags such GL,PL,GP or QR,QA,QS or tags that use local alleles, e.g. LPL,LAD. (For a description of localized tags see the page on scaling.)
The list of plugin-specific options can be obtained by running bcftools +tag2tag -h, which will print the following usage page:
Usage: bcftools +tag2tag [General Options] -- [Plugin Options]
Options:
run "bcftools plugin" for a list of common options
Plugin options:
--ORI-to-NEW Convert from source tags FORMAT/GL,PL,GP to FORMAT/GL,PL,GP,GT
--QR-QA-to-QS Convert FORMAT/QR,QA to FORMAT/QS
--XX-to-LXX Convert from normal to localized tags (from PL,AD to LAA,LPL,LAD)
--LXX-to-XX Convert from localized to normal tags (from LAA,LPL,LAD to PL,AD)
-d, --defaults LIST Values to use in place of missing --LXX-to-XX fields [AD:.,PL:.]
-s, --skip-nalt INT Do not modify sites with fewer (--XX-to-LXX) or more (--LXX-to-XX)
than INT alternate alleles, 0=all sites [0]
-r, --replace Drop the source tag
-t, --threshold FLOAT Threshold for GP to GT hard-call [0.1]
Examples:
bcftools +tag2tag in.vcf -- -r --GP-to-GL
bcftools +tag2tag in.vcf -- --PL-to-GT
# Expand the family of localized tags (LPL,LAD,LAF) to normal tags (PL,AD,AF). With the -s 3
# option, only sites with fewer than three alternate alleles will be expanded.
# Note that FORMAT/LAA must be present.
bcftools +tag2tag in.vcf -- --LXX-to-XX -s 3
# The same as above, but convert only the LAD tag
bcftools +tag2tag in.vcf -- --LAD-to-AD -s 3
# Replace the family of normal tags (PL,AD,AF) with localized tags (LPL,LAD,LAF). With the -s 3
# option, only sites with more than three alternate alleles will be modified. Note that in order
# to remove the original tags, -r must be given.
bcftools +tag2tag in.vcf -- --XX-to-LXX -s 3 -r
# The same as above, but convert only the PL tag
bcftools +tag2tag in.vcf -- --PL-to-LPL -s 3
Feedback
We welcome your feedback, please help us improve this page by either opening an issue on github or editing it directly and sending a pull request.