Package vcf

Class VcfRec

java.lang.Object
vcf.VcfRec
All Implemented Interfaces:
IntArray, GTRec
public final class VcfRec extends Object implements GTRec

Class VcfRec represents a VCF record. If one allele in a diploid genotype is missing, then both alleles are set to missing.

Instances of class VcfRec are immutable.

  • Constructor Summary

    Constructors
    Constructor
    Description
    VcfRec(VcfHeader vcfHeader, String vcfRecord, MarkerParser markerParser)
    Constructs a new VcfRec instance from a VCF record.

  • Method Summary

    Modifier and Type
    Method
    Description
    String
    filter()
    Returns the FILTER field.
    String
    format()
    Returns the FORMAT field.
    String[]
    formatData(String formatCode)
    Returns an array of length this.size() containing the specified FORMAT subfield data for each sample.
    int
    formatIndex(String formatCode)
    Returns the index of the specified FORMAT subfield if the specified subfield is defined for this VCF record, and returns -1 otherwise.
    String
    formatSubfield(int subfieldIndex)
    Returns the specified FORMAT subfield.
    int
    get(int hap)
    Returns the specified allele for the specified haplotype or -1 if the allele is missing.
    static int
    gtIndex(int a1, int a2)
    Returns the VCF genotype index for the specified pair of alleles.
    boolean
    hasFormat(String formatCode)
    Returns true if the specified FORMAT subfield is present, and returns false otherwise.
    String
    info()
    Returns the INFO field.
    boolean
    isPhased()
    Returns true if every genotype for each sample is a phased, non-missing genotype, and returns false otherwise.
    boolean
    isPhased(int sample)
    Returns true if the genotype for the specified sample has non-missing alleles and is either haploid or diploid with a phased allele separator, and returns false otherwise.
    Marker
    marker()
    Returns the marker.
    int
    nFormatSubfields()
    Returns the number of FORMAT subfields.
    String
    qual()
    Returns the QUAL field.
    String
    sampleData(int sample)
    Returns the data for the specified sample.
    String
    sampleData(int sample, int subfieldIndex)
    Returns the specified data for the specified sample.
    String
    sampleData(int sample, String formatCode)
    Returns the specified data for the specified sample.
    Samples
    samples()
    Returns the list of samples.
    int
    size()
    Returns the number of haplotypes.
    String
    toString()
    Returns the VCF record.
    VcfHeader
    vcfHeader()
    Returns the VCF meta-information lines and the VCF header line.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • VcfRec

      public VcfRec(VcfHeader vcfHeader, String vcfRecord, MarkerParser markerParser)
      Constructs a new VcfRec instance from a VCF record.
      Parameters:
      vcfHeader - meta-information lines and header line for the specified VCF record.
      vcfRecord - a VCF record with a GL format field corresponding to the specified vcfHeader object
      markerParser - a filter for a VCF record's ID, QUAL, FILTER, and INFO subfields
      Throws:
      IllegalArgumentException - if the VCF record does not have a GT format field
      IllegalArgumentException - if a VCF record format error is detected
      IllegalArgumentException - if there are not vcfHeader.nHeaderFields() tab-delimited fields in the specified VCF record
      NullPointerException - if (vcfHeader == null) || (vcfRecord == null) || (markerParser == null)

  • Method Details

    • gtIndex

      public static int gtIndex(int a1, int a2)
      Returns the VCF genotype index for the specified pair of alleles.
      Parameters:
      a1 - the first allele
      a2 - the second allele
      Returns:
      the VCF genotype index for the specified pair of alleles
      Throws:
      IllegalArgumentException - if a1 < 0 || a2 < 0

    • qual

      public String qual()
      Returns the QUAL field.
      Returns:
      the QUAL field

    • filter

      public String filter()
      Returns the FILTER field.
      Returns:
      the FILTER field

    • info

      public String info()
      Returns the INFO field.
      Returns:
      the INFO field

    • format

      public String format()
      Returns the FORMAT field. Returns the empty string ("") if the FORMAT field is missing.
      Returns:
      the FORMAT field

    • nFormatSubfields

      public int nFormatSubfields()
      Returns the number of FORMAT subfields.
      Returns:
      the number of FORMAT subfields

    • formatSubfield

      public String formatSubfield(int subfieldIndex)
      Returns the specified FORMAT subfield.
      Parameters:
      subfieldIndex - a FORMAT subfield index
      Returns:
      the specified FORMAT subfield
      Throws:
      IndexOutOfBoundsException - if subfieldIndex < 0 || subfieldIndex >= this.nFormatSubfields()

    • hasFormat

      public boolean hasFormat(String formatCode)
      Returns true if the specified FORMAT subfield is present, and returns false otherwise.
      Parameters:
      formatCode - a FORMAT subfield code
      Returns:
      true if the specified FORMAT subfield is present

    • formatIndex

      public int formatIndex(String formatCode)
      Returns the index of the specified FORMAT subfield if the specified subfield is defined for this VCF record, and returns -1 otherwise.
      Parameters:
      formatCode - the format subfield code
      Returns:
      the index of the specified FORMAT subfield if the specified subfield is defined for this VCF record, and -1 otherwise

    • sampleData

      public String sampleData(int sample)
      Returns the data for the specified sample.
      Parameters:
      sample - a sample index
      Returns:
      the data for the specified sample
      Throws:
      IndexOutOfBoundsException - if sample < 0 || sample >= this.size()

    • sampleData

      public String sampleData(int sample, String formatCode)
      Returns the specified data for the specified sample.
      Parameters:
      sample - a sample index
      formatCode - a FORMAT subfield code
      Returns:
      the specified data for the specified sample
      Throws:
      IllegalArgumentException - if this.hasFormat(formatCode)==false
      IndexOutOfBoundsException - if sample < 0 || sample >= this.size()

    • sampleData

      public String sampleData(int sample, int subfieldIndex)
      Returns the specified data for the specified sample.
      Parameters:
      sample - a sample index
      subfieldIndex - a FORMAT subfield index
      Returns:
      the specified data for the specified sample
      Throws:
      IndexOutOfBoundsException - if field < 0 || field >= this.nFormatSubfields()
      IndexOutOfBoundsException - if sample < 0 || sample >= this.size()

    • formatData

      public String[] formatData(String formatCode)
      Returns an array of length this.size() containing the specified FORMAT subfield data for each sample. The k-th element of the array is the specified FORMAT subfield data for the k-th sample.
      Parameters:
      formatCode - a format subfield code
      Returns:
      an array of length this.size() containing the specified FORMAT subfield data for each sample
      Throws:
      IllegalArgumentException - if this.hasFormat(formatCode) == false

    • samples

      public Samples samples()
      Description copied from interface: GTRec
      Returns the list of samples.
      Specified by:
      samples in interface GTRec
      Returns:
      the list of samples

    • vcfHeader

      public VcfHeader vcfHeader()
      Returns the VCF meta-information lines and the VCF header line.
      Returns:
      the VCF meta-information lines and the VCF header line

    • marker

      public Marker marker()
      Description copied from interface: GTRec
      Returns the marker.
      Specified by:
      marker in interface GTRec
      Returns:
      the marker

    • get

      public int get(int hap)
      Description copied from interface: GTRec
      Returns the specified allele for the specified haplotype or -1 if the allele is missing. The two alleles for a sample at a marker are arbitrarily ordered if this.unphased(marker, hap/2) == false.
      Specified by:
      get in interface GTRec
      Specified by:
      get in interface IntArray
      Parameters:
      hap - a haplotype index
      Returns:
      the specified allele for the specified sample

    • isPhased

      public boolean isPhased(int sample)
      Description copied from interface: GTRec
      Returns true if the genotype for the specified sample has non-missing alleles and is either haploid or diploid with a phased allele separator, and returns false otherwise.
      Specified by:
      isPhased in interface GTRec
      Parameters:
      sample - a sample index
      Returns:
      true if the genotype for the specified sample is a phased, nonmissing genotype

    • isPhased

      public boolean isPhased()
      Description copied from interface: GTRec
      Returns true if every genotype for each sample is a phased, non-missing genotype, and returns false otherwise.
      Specified by:
      isPhased in interface GTRec
      Returns:
      true if the genotype for each sample is a phased, non-missing genotype

    • size

      public int size()
      Description copied from interface: GTRec
      Returns the number of haplotypes.
      Specified by:
      size in interface GTRec
      Specified by:
      size in interface IntArray
      Returns:
      the number of haplotypes

    • toString

      public String toString()
      Returns the VCF record.
      Overrides:
      toString in class Object
      Returns:
      the VCF record