Converts a VCFArrow object to a PLINK .bed format infile
Usage
vcf2plink_bed(
vcf_arrow,
out_file,
keep_groups = NULL,
sex = NULL,
pheno = NULL,
chrom_code = c("auto", "index", "zero", "keep")
)Arguments
- vcf_arrow
-> VCFArrow object
- out_file
-> output file prefix; extensions are added automatically, no default (character)
- keep_groups
-> groups to retain, default NULL (character)
- sex
-> vector of sexes of samples, default NULL (character)
- pheno
-> vector of phenotypes of samples, default NULL (character)
- chrom_code
-> how CHROM is written: "auto" (keep numeric CHROM, otherwise 0), "index" (1..n by first appearance), "zero" (all 0) or "keep" (verbatim), default "auto" (character)
Details
This function converts a VCFArrow object to an external PLINK .bed formatted file. Writing occurs in chunks whose size is determined by the read_vcf() function. Larger chunks result in faster writing speeds. If no groups are defined, the default behavior is to use all groups. Sex and phenotype vectors are optional. If not defined sex = 0, pheno = -9.
Examples
f <- system.file("extdata", "vaillantii_discosnp_sub.vcf.gz",
package = "VCFArrow")
vcf <- read_vcf(f) |> set_vcf_groups(dirname(f))
#> ℹ VCF is being read in chunks of 50000 variants
#> ✔ VCF successfully read into a VCFArrow object
vcf2plink_bed(vcf, out_file = file.path(tempdir(), "plink_out"))
#> ℹ Building PLINK: 9313 variants x 18 samples (0 MiB raw storage)
#> ℹ Writing PLINK files...
#> ℹ Chromosome names were recoded as integers for PLINK compatibility; mapping written to /tmp/RtmpSpcr9J/plink_out.chrommap
#> ✔ PLINK binary fileset written to /tmp/RtmpSpcr9J/plink_out.bed, /tmp/RtmpSpcr9J/plink_out.bim, /tmp/RtmpSpcr9J/plink_out.fam