Package vcf

Class RestrictedGT

java.lang.Object
vcf.RestrictedGT
All Implemented Interfaces:
GT
public class RestrictedGT extends Object implements GT

Class RestrictedGT is a wrapper for a GT instance that restricts the data to a subset of the VCF records.

Instances of class RestrictGT are immutable.

  • Constructor Summary

    Constructors
    Constructor
    Description
    RestrictedGT(GT gt, Markers markers, int[] indices)
    Constructs a new RestrictedGT instance from the specified data

  • Method Summary

    Modifier and Type
    Method
    Description
    int
    allele(int marker, int hap)
    Returns the allele on the specified haplotype for the specified marker or return -1 if the allele is missing.
    boolean
    isPhased()
    Returns true if the genotype for each marker and sample has non-missing alleles and is either haploid or diploid with a phased allele separator, and returns false otherwise.
    boolean
    isReversed()
    Returns true if the markers are ordered by decreasing chromosome base position, and returns false otherwise.
    Marker
    marker(int marker)
    Returns the specified marker.
    Markers
    markers()
    Returns the list of markers in order of increasing chromosome position.
    int
    nHaps()
    Returns the number of haplotypes.
    int
    nMarkers()
    Returns the number of markers.
    int
    nSamples()
    Returns the number of samples.
    RestrictedGT
    restrict(int start, int end)
    Returns a new GT instance restricted to genotype data for the specified markers.
    RestrictedGT
    restrict(Markers markers, int[] indices)
    Returns a GT instance restricted to genotype data for the specified markers.
    Samples
    samples()
    Returns the list of samples.
    String
    toString()
     

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • RestrictedGT

      public RestrictedGT(GT gt, Markers markers, int[] indices)
      Constructs a new RestrictedGT instance from the specified data
      Parameters:
      gt - the genotypes to be wrapped
      markers - the list of markers in the returned instance
      indices - the mapping of marker indices from markers to gt.markers()
      Throws:
      IndexOutOfBoundsException - if there exists j such that (0 <= j && j < indices.length) such that (indices[j] < 0 || indices[j] >= gt.nMarkers())
      IllegalArgumentException - if there exists j such that (1 <= j && j < indices.length) such that (indices[j] <= indice[j - 1])
      IllegalArgumentException - if there exists j such that (0 <= j && j < indices.length) such that (gt.marker(indices[j]).equals(markers.marker(j)) == false)
      NullPointerException - if (gt == null || markers == null || include == null)

  • Method Details

    • isReversed

      public boolean isReversed()
      Description copied from interface: GT
      Returns true if the markers are ordered by decreasing chromosome base position, and returns false otherwise.
      Specified by:
      isReversed in interface GT
      Returns:
      true if the markers are ordered by decreasing chromosome base position

    • nMarkers

      public int nMarkers()
      Description copied from interface: GT
      Returns the number of markers.
      Specified by:
      nMarkers in interface GT
      Returns:
      the number of markers

    • marker

      public Marker marker(int marker)
      Description copied from interface: GT
      Returns the specified marker.
      Specified by:
      marker in interface GT
      Parameters:
      marker - a marker index
      Returns:
      the specified marker

    • markers

      public Markers markers()
      Description copied from interface: GT
      Returns the list of markers in order of increasing chromosome position. If (this.isReversed() == false) then (this.markers().marker(j).equals(this.marker(j)) == true) for all (0 <= j && j < this.nMarkers()). If (this.isReversed() == true) then (this.markers().marker(this.nMarkers() - 1 - j).equals(this.marker(j)) == true) for all (0 <= j && j < this.nMarkers())
      Specified by:
      markers in interface GT
      Returns:
      the list of markers in order of increasing chromosome position

    • nHaps

      public int nHaps()
      Description copied from interface: GT
      Returns the number of haplotypes. The returned value is equal to 2*this.nSamples().
      Specified by:
      nHaps in interface GT
      Returns:
      the number of haplotypes

    • nSamples

      public int nSamples()
      Description copied from interface: GT
      Returns the number of samples.
      Specified by:
      nSamples in interface GT
      Returns:
      the number of samples

    • samples

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

    • isPhased

      public boolean isPhased()
      Description copied from interface: GT
      Returns true if the genotype for each marker and 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 GT
      Returns:
      true if the genotype for each marker and sample is a phased, non-missing genotype

    • allele

      public int allele(int marker, int hap)
      Description copied from interface: GT
      Returns the allele on the specified haplotype for the specified marker or return -1 if the allele is missing. The order of the two alleles is unspecified if this.isPhased() == false.
      Specified by:
      allele in interface GT
      Parameters:
      marker - the marker index
      hap - the haplotype index
      Returns:
      the allele on the specified haplotype for the specified marker

    • restrict

      public RestrictedGT restrict(Markers markers, int[] indices)
      Description copied from interface: GT
      Returns a GT instance restricted to genotype data for the specified markers.
      Specified by:
      restrict in interface GT
      Parameters:
      markers - the list of markers in the returned instance
      indices - a list of distinct marker indices (from this.markers()) in increasing order
      Returns:
      a GT instance restricted to genotype data for the specified markers

    • restrict

      public RestrictedGT restrict(int start, int end)
      Description copied from interface: GT
      Returns a new GT instance restricted to genotype data for the specified markers.
      Specified by:
      restrict in interface GT
      Parameters:
      start - the start marker (inclusive)
      end - the end marker (exclusive)
      Returns:
      a GT instance restricted to genotype data for the specified markers

    • toString

      public String toString()
      Overrides:
      toString in class Object