Package vcf
Interface GT
-
- All Known Subinterfaces:
RefGT
- All Known Implementing Classes:
BasicGT,BasicRefGT,EstPhase.HapsGT,HapPairPhasedGT,SplicedGT,XBasicGT
public interface GTInterface
GTrepresents genotype data for a list of markers and a list of samples.All instances of
GTare required to be immutable.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description intallele(int marker, int hap)Returns the allele on the specified haplotype for the specified marker or return -1 if the allele is missing.intallele1(int marker, int sample)Returns the first allele for the specified marker and sample or return -1 if the allele is missing.intallele2(int marker, int sample)Returns the second allele for the specified marker and sample or return -1 if the allele is missing.default floatgl(int marker, int sample, int allele1, int allele2)Returns the probability of the observed data for the specified marker and sample if the specified pair of ordered alleles is the true ordered genotype.default booleanisGTData()Returnstrueif the value returned bythis.gl()is determined by a called or missing genotype, and returnsfalseotherwise.booleanisPhased()Returnstrueif the genotype for each marker and sample is a phased, non-missing genotype, and returnsfalseotherwise.booleanisPhased(int sample)Returnstrueif the genotype for each marker for the specified sample is a phased, nonmissing genotype, and returnsfalseotherwise.booleanisPhased(int marker, int sample)Returnstrueif the genotype for the specified marker and sample is a phased, nonmissing genotype, and returnsfalseotherwise.Markermarker(int marker)Returns the specified marker.Markersmarkers()Returns the list of markers.default intnHaps()Returns the number of haplotypes.intnMarkers()Returns the number of markers.intnSamples()Returns the number of samples.Samplessamples()Returns the list of samples.
-
-
-
Method Detail
-
nMarkers
int nMarkers()
Returns the number of markers.- Returns:
- the number of markers
-
markers
Markers markers()
Returns the list of markers.- Returns:
- the list of markers
-
marker
Marker marker(int marker)
Returns the specified marker.- Parameters:
marker- a marker index- Returns:
- the specified marker
- Throws:
java.lang.IndexOutOfBoundsException- ifmarker < 0 || marker >= this.nMarkers()
-
nHaps
default int nHaps()
Returns the number of haplotypes. The returned value is equal to2*this.nSamples().- Returns:
- the number of haplotypes
-
nSamples
int nSamples()
Returns the number of samples.- Returns:
- the number of samples
-
samples
Samples samples()
Returns the list of samples.- Returns:
- the list of samples
-
allele1
int allele1(int marker, int sample)Returns the first allele for the specified marker and sample or return -1 if the allele is missing. The two alleles for a sample are arbitrarily ordered ifthis.unphased(marker, sample) == false.- Parameters:
marker- the marker indexsample- the sample index- Returns:
- the first allele for the specified marker and sample
- Throws:
java.lang.IndexOutOfBoundsException- ifmarker < 0 || marker >= this.nMarkers()java.lang.IndexOutOfBoundsException- ifsample < 0 || sample >= this.nSamples()
-
allele2
int allele2(int marker, int sample)Returns the second allele for the specified marker and sample or return -1 if the allele is missing. The two alleles for a sample are arbitrarily ordered ifthis.unphased(marker, sample) == false.- Parameters:
marker- the marker indexsample- the sample index- Returns:
- the allele for the specified marker and sample
- Throws:
java.lang.IndexOutOfBoundsException- ifmarker < 0 || marker >= this.nMarkers()java.lang.IndexOutOfBoundsException- ifsample < 0 || sample >= this.nSamples()
-
allele
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. The two alleles for an individual are arbitrarily ordered ifthis.unphased(marker, hap/2) == false.- Parameters:
marker- the marker indexhap- the haplotype index- Returns:
- the allele on the specified haplotype for the specified marker
- Throws:
java.lang.IndexOutOfBoundsException- ifmarker < 0 || marker >= this.nMarkers()java.lang.IndexOutOfBoundsException- ifhap < 0 || hap >= this.nHaps()
-
isPhased
boolean isPhased(int marker, int sample)Returnstrueif the genotype for the specified marker and sample is a phased, nonmissing genotype, and returnsfalseotherwise.- Parameters:
marker- the marker indexsample- the sample index- Returns:
trueif the genotype for the specified marker and sample is a phased, nonmissing genotype- Throws:
java.lang.IndexOutOfBoundsException- ifmarker < 0 || marker >= this.nMarkers()java.lang.IndexOutOfBoundsException- ifsample < 0 || sample >= this.nSamples()
-
isPhased
boolean isPhased(int sample)
Returnstrueif the genotype for each marker for the specified sample is a phased, nonmissing genotype, and returnsfalseotherwise.- Parameters:
sample- a sample index- Returns:
trueif the genotype for each marker for the specified sample is a phased, nonmissing genotype- Throws:
java.lang.IndexOutOfBoundsException- ifsample < 0 || sample >= this.nSamples()
-
isPhased
boolean isPhased()
Returnstrueif the genotype for each marker and sample is a phased, non-missing genotype, and returnsfalseotherwise.- Returns:
trueif the genotype for each marker and sample is a phased, non-missing genotype
-
isGTData
default boolean isGTData()
Returnstrueif the value returned bythis.gl()is determined by a called or missing genotype, and returnsfalseotherwise.- Returns:
trueif the value returned bythis.gl()is determined by a called or missing genotype
-
gl
default float gl(int marker, int sample, int allele1, int allele2)Returns the probability of the observed data for the specified marker and sample if the specified pair of ordered alleles is the true ordered genotype.- Parameters:
marker- the marker indexsample- the sample indexallele1- the first allele indexallele2- the second allele index- Returns:
- the probability of the observed data for the specified marker and sample if the specified pair of ordered alleles is the true ordered genotype
- Throws:
java.lang.IndexOutOfBoundsException- ifmarker < 0 || marker >= this.nMarkers()java.lang.IndexOutOfBoundsException- ifsamples < 0 || samples >= this.nSamples()java.lang.IndexOutOfBoundsException- ifallele1 < 0 || allele1 >= this.marker(marker).nAlleles()java.lang.IndexOutOfBoundsException- ifallele2 < 0 || allele2 >= this.marker(marker).nAlleles()
-
-