From ee40791776dfcdb8d192820c9a61f3a1b0a01012 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 11 Nov 2011 09:55:42 -0500
Subject: [PATCH 001/113] Attributes are now Map<String,Object> not
 Map<String,?>

-- Allows us to avoid an unnecessary copy when creating InferredGeneticContext (whose name really needs to change).
---
 .../gatk/refdata/VariantContextAdaptors.java  |  2 +-
 .../indels/SomaticIndelDetectorWalker.java    |  2 +-
 .../varianteval/VariantEvalWalker.java        |  2 +-
 .../evaluators/G1KPhaseITable.java            | 14 +++++-------
 .../IntervalStratification.java               |  4 ++--
 .../sting/utils/codecs/vcf/VCF3Codec.java     |  4 ++--
 .../sting/utils/codecs/vcf/VCFCodec.java      |  4 ++--
 .../sting/utils/variantcontext/Genotype.java  |  4 ++--
 .../InferredGeneticContext.java               | 22 ++++++-------------
 .../utils/variantcontext/MutableGenotype.java |  2 +-
 .../variantcontext/MutableVariantContext.java |  4 ++--
 .../utils/variantcontext/VariantContext.java  | 10 ++++-----
 .../variantcontext/VariantContextUtils.java   |  2 +-
 .../utils/genotype/vcf/VCFWriterUnitTest.java |  4 ++--
 14 files changed, 35 insertions(+), 45 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index 7bf518fd5..941dc66b5 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -257,7 +257,7 @@ public class VariantContextAdaptors {
                     else genotypeAlleles.add(refAllele);
                 }
 
-                Map<String, String> attributes = new HashMap<String, String>();
+                Map<String, Object> attributes = new HashMap<String, Object>();
                 Collection<Genotype> genotypes = new ArrayList<Genotype>();
                 MutableGenotype call = new MutableGenotype(name, genotypeAlleles);
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
index 414ffa09c..a97117acd 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
@@ -1061,7 +1061,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
 
         for ( String sample : normalSamples ) {
 
-            Map<String,?> attrs = call.makeStatsAttributes(null);
+            Map<String,Object> attrs = call.makeStatsAttributes(null);
 
             if ( call.isCall() ) // we made a call - put actual het genotype here:
                 genotypes.put(sample,new Genotype(sample,alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrs,false));
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
index 4e4a1550d..4556692bd 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
@@ -186,7 +186,7 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
      * File containing tribble-readable features for the IntervalStratificiation
      */
     @Input(fullName="stratIntervals", shortName="stratIntervals", doc="File containing tribble-readable features for the IntervalStratificiation", required=false)
-    protected IntervalBinding<Feature> intervalsFile = null;
+    public IntervalBinding<Feature> intervalsFile = null;
 
     // Variables
     private Set<SortableJexlVCMatchExp> jexlExpressions = new TreeSet<SortableJexlVCMatchExp>();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
index 3ab618496..8cc321ef5 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
@@ -51,21 +51,21 @@ public class G1KPhaseITable extends VariantEvaluator {
     @DataPoint(description = "Number of SNPs")
     public long nSNPs = 0;
     @DataPoint(description = "SNP Novelty Rate")
-    public double SNPNoveltyRate = 0;
+    public String SNPNoveltyRate = "NA";
     @DataPoint(description = "Mean number of SNPs per individual")
     public long nSNPsPerSample = 0;
 
     @DataPoint(description = "Number of Indels")
     public long nIndels = 0;
     @DataPoint(description = "Indel Novelty Rate")
-    public double IndelNoveltyRate = 0;
+    public String IndelNoveltyRate = "NA";
     @DataPoint(description = "Mean number of Indels per individual")
     public long nIndelsPerSample = 0;
 
     @DataPoint(description = "Number of SVs")
     public long nSVs = 0;
     @DataPoint(description = "SV Novelty Rate")
-    public double SVNoveltyRate = 0;
+    public String SVNoveltyRate = "NA";
     @DataPoint(description = "Mean number of SVs per individual")
     public long nSVsPerSample = 0;
 
@@ -106,9 +106,6 @@ public class G1KPhaseITable extends VariantEvaluator {
         if ( eval == null || eval.isMonomorphic() ) return null;
 
         switch (eval.getType()) {
-//            case NO_VARIATION:
-//                // shouldn't get here
-//                break;
             case SNP:
             case INDEL:
             case SYMBOLIC:
@@ -139,11 +136,12 @@ public class G1KPhaseITable extends VariantEvaluator {
         return (int)(Math.round(sum / (1.0 * countsPerSample.size())));
     }
 
-    private final double noveltyRate(VariantContext.Type type) {
+    private final String noveltyRate(VariantContext.Type type) {
         int all = allVariantCounts.get(type);
         int known = knownVariantCounts.get(type);
         int novel = all - known;
-        return (novel / (1.0 * all));
+        double rate = (novel / (1.0 * all));
+        return all == 0 ? "NA" : String.format("%.2f", rate);
     }
 
     public void finalizeEvaluation() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/IntervalStratification.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/IntervalStratification.java
index bf001588a..00a656cc6 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/IntervalStratification.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/IntervalStratification.java
@@ -63,8 +63,8 @@ public class IntervalStratification extends VariantStratifier {
         if ( locs.isEmpty() )
             throw new UserException.BadArgumentValue("stratIntervals", "Contains no intervals.  Perhaps the file is malformed or empty?");
 
-        logger.info(String.format("Creating IntervalStratification containing %d intervals covering %d bp",
-                locs.size(), IntervalUtils.intervalSize(locs)));
+        logger.info(String.format("Creating IntervalStratification %s containing %d intervals covering %d bp",
+                getVariantEvalWalker().intervalsFile.getSource(), locs.size(), IntervalUtils.intervalSize(locs)));
 
         // set up the map from contig -> interval tree
         for ( final String contig : getVariantEvalWalker().getContigNames() )
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
index e5b1a2de5..bed66a439 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
@@ -141,7 +141,7 @@ public class VCF3Codec extends AbstractVCFCodec {
 
             double GTQual = VariantContext.NO_NEG_LOG_10PERROR;
             Set<String> genotypeFilters = null;
-            Map<String, String> gtAttributes = null;
+            Map<String, Object> gtAttributes = null;
             String sampleName = sampleNameIterator.next();
 
             // check to see if the value list is longer than the key list, which is a problem
@@ -150,7 +150,7 @@ public class VCF3Codec extends AbstractVCFCodec {
 
             int genotypeAlleleLocation = -1;
             if (nGTKeys >= 1) {
-                gtAttributes = new HashMap<String, String>(nGTKeys - 1);
+                gtAttributes = new HashMap<String, Object>(nGTKeys - 1);
 
                 for (int i = 0; i < nGTKeys; i++) {
                     final String gtKey = new String(genotypeKeyArray[i]);
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
index 42ea05355..58dfd3589 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
@@ -168,7 +168,7 @@ public class VCFCodec extends AbstractVCFCodec {
 
             double GTQual = VariantContext.NO_NEG_LOG_10PERROR;
             Set<String> genotypeFilters = null;
-            Map<String, String> gtAttributes = null;
+            Map<String, Object> gtAttributes = null;
             String sampleName = sampleNameIterator.next();
 
             // check to see if the value list is longer than the key list, which is a problem
@@ -177,7 +177,7 @@ public class VCFCodec extends AbstractVCFCodec {
 
             int genotypeAlleleLocation = -1;
             if (nGTKeys >= 1) {
-                gtAttributes = new HashMap<String, String>(nGTKeys - 1);
+                gtAttributes = new HashMap<String, Object>(nGTKeys - 1);
 
                 for (int i = 0; i < nGTKeys; i++) {
                     final String gtKey = new String(genotypeKeyArray[i]);
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
index e2e44e2b9..c59c002f2 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
@@ -25,11 +25,11 @@ public class Genotype {
     protected boolean isPhased = false;
     protected boolean filtersWereAppliedToContext;
 
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean isPhased) {
+    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, boolean isPhased) {
         this(sampleName, alleles, negLog10PError, filters, attributes, isPhased, null);
     }
 
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean isPhased, double[] log10Likelihoods) {
+    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, boolean isPhased, double[] log10Likelihoods) {
         if ( alleles != null )
             this.alleles = Collections.unmodifiableList(alleles);
         commonInfo = new InferredGeneticContext(sampleName, negLog10PError, filters, attributes);
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/InferredGeneticContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/InferredGeneticContext.java
index bf16cd1cf..e7d9b3338 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/InferredGeneticContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/InferredGeneticContext.java
@@ -22,22 +22,14 @@ public final class InferredGeneticContext {
     private Set<String> filters = NO_FILTERS;
     private Map<String, Object> attributes = NO_ATTRIBUTES;
 
-//    public InferredGeneticContext(String name) {
-//        this.name = name;
-//    }
-//
-//    public InferredGeneticContext(String name, double negLog10PError) {
-//        this(name);
-//        setNegLog10PError(negLog10PError);
-//    }
-
-    public InferredGeneticContext(String name, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+    public InferredGeneticContext(String name, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this.name = name;
         setNegLog10PError(negLog10PError);
-        if ( filters != null )
-            setFilters(filters);
-        if ( attributes != null )
-            setAttributes(attributes);
+        if ( filters != null && ! filters.isEmpty() )
+            this.filters = filters;
+        if ( attributes != null && ! attributes.isEmpty() ) {
+            this.attributes = attributes;
+        }
     }
 
     /**
@@ -157,7 +149,7 @@ public final class InferredGeneticContext {
 
         if ( attributes == NO_ATTRIBUTES ) // immutable -> mutable
             attributes = new HashMap<String, Object>();
-        
+
         attributes.put(key, value);
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableGenotype.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableGenotype.java
index 14419a2a0..fdffb1e10 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableGenotype.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableGenotype.java
@@ -17,7 +17,7 @@ public class MutableGenotype extends Genotype {
     }
 
 
-    public MutableGenotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean genotypesArePhased) {
+    public MutableGenotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, boolean genotypesArePhased) {
         super(sampleName, alleles, negLog10PError, filters, attributes, genotypesArePhased);
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java
index a752f4a1b..d563c5180 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java
@@ -18,11 +18,11 @@ public class MutableVariantContext extends VariantContext {
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
     }
 
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index f52a7087b..ba96b13d8 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -222,7 +222,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes, Byte referenceBaseForIndel) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
         this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false);
     }
 
@@ -239,7 +239,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false);
     }
 
@@ -260,7 +260,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, Byte referenceBaseForIndel) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
         this(source, contig, start, stop, alleles, NO_GENOTYPES, negLog10PError, filters, attributes, referenceBaseForIndel, true);
     }
 
@@ -277,7 +277,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters        filters: use null for unfiltered and empty set for passes filters
      * @param attributes     attributes
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes, null, false);
     }
 
@@ -334,7 +334,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     private VariantContext(String source, String contig, long start, long stop,
                            Collection<Allele> alleles, Map<String, Genotype> genotypes,
-                           double negLog10PError, Set<String> filters, Map<String, ?> attributes,
+                           double negLog10PError, Set<String> filters, Map<String, Object> attributes,
                            Byte referenceBaseForIndel, boolean genotypesAreUnparsed) {
         if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
         this.contig = contig;
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 43f91041f..0bb01dbb5 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -69,7 +69,7 @@ public class VariantContextUtils {
      * @param attributes      attributes
      * @return VariantContext object
      */
-    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes != null ? VariantContext.genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
index 35c6a4993..ea06d897e 100644
--- a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
@@ -120,7 +120,7 @@ public class VCFWriterUnitTest extends BaseTest {
         GenomeLoc loc = genomeLocParser.createGenomeLoc("chr1",1);
         List<Allele> alleles = new ArrayList<Allele>();
         Set<String> filters = null;
-        Map<String, String> attributes = new HashMap<String,String>();
+        Map<String, Object> attributes = new HashMap<String,Object>();
         Map<String, Genotype> genotypes = new HashMap<String,Genotype>();
 
         alleles.add(Allele.create("-",true));
@@ -128,7 +128,7 @@ public class VCFWriterUnitTest extends BaseTest {
 
         attributes.put("DP","50");
         for (String name : header.getGenotypeSamples()) {
-            Map<String, String> gtattributes = new HashMap<String,String>();
+            Map<String, Object> gtattributes = new HashMap<String,Object>();
             gtattributes.put("BB","1");
             Genotype gt = new Genotype(name,alleles.subList(1,2),0,null,gtattributes,true);
 

From e216e85465a51d86860217d581c0eb5f64c28efa Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 11 Nov 2011 09:56:00 -0500
Subject: [PATCH 002/113] First working version of VariantContextBenchmark

---
 .../VariantContextBenchmark.java              | 121 ++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java

diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
new file mode 100644
index 000000000..2f8419b5e
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -0,0 +1,121 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext;
+
+import com.google.caliper.Param;
+import com.google.caliper.SimpleBenchmark;
+import com.google.caliper.runner.CaliperMain;
+import org.broad.tribble.readers.AsciiLineReader;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFCodec;
+
+import java.io.*;
+import java.util.*;
+
+/**
+ * Caliper microbenchmark of parsing a VCF file
+ */
+public class VariantContextBenchmark extends SimpleBenchmark {
+    @Param({"/Users/depristo/Desktop/broadLocal/localData/ALL.chr20.merged_beagle_mach.20101123.snps_indels_svs.genotypes.vcf"})
+    String vcfFile;
+
+    @Param({"1000"})
+    int linesToRead; // set automatically by framework
+
+    @Param({"100"})
+    int nSamplesToTake; // set automatically by framework
+
+    private String INPUT_STRING;
+
+    private enum Operation {
+        READ,
+        READ_SUBSET
+    }
+
+    @Override protected void setUp() {
+        // read it into a String so that we don't try to benchmark IO issues
+        try {
+            FileInputStream s = new FileInputStream(new File(vcfFile));
+            AsciiLineReader lineReader = new AsciiLineReader(s);
+            int counter = 0;
+            StringBuffer sb = new StringBuffer();
+            while (counter++ < linesToRead ) {
+                String line = lineReader.readLine();
+                if ( line == null )
+                    break;
+                sb.append(line + "\n");
+            }
+            s.close();
+            INPUT_STRING = sb.toString();
+        } catch (IOException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    private void parseGenotypes(VCFCodec codec, Operation op) {
+        try {
+            InputStream is = new ByteArrayInputStream(INPUT_STRING.getBytes());
+            AsciiLineReader lineReader = new AsciiLineReader(is);
+            codec.readHeader(lineReader);
+
+            int counter = 0;
+            List<String> samples = null;
+            while (counter++ < linesToRead ) {
+                String line = lineReader.readLine();
+                if ( line == null )
+                    break;
+
+                VariantContext vc = (VariantContext)codec.decode(line);
+                if ( samples == null ) {
+                    samples = new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake);
+                }
+
+                if ( op == Operation.READ_SUBSET)
+                    processOneVC(vc, samples);
+            }
+        } catch (Exception e) {
+            System.out.println("Benchmarking run failure because of " + e.getMessage());
+        }
+    }
+
+    public void timeOriginalRead(int rep) {
+        for ( int i = 0; i < rep; i++ )
+            parseGenotypes(new VCFCodec(), Operation.READ);
+    }
+
+    public void timeOriginalReadSubset(int rep) {
+        for ( int i = 0; i < rep; i++ )
+            parseGenotypes(new VCFCodec(), Operation.READ_SUBSET);
+    }
+
+    public static void main(String[] args) {
+        CaliperMain.main(VariantContextBenchmark.class, args);
+    }
+
+    private static final void processOneVC(VariantContext vc, List<String> samples) {
+        VariantContext sub = vc.subContextFromGenotypes(vc.getGenotypes(samples).values(), vc.getAlleles());
+        sub.getNSamples();
+    }
+
+}

From ef9f8b5d4618f97e75fecef75f5357bd58e1fe43 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 11 Nov 2011 10:07:11 -0500
Subject: [PATCH 003/113] Added subContextOfSamples to VariantContext

-- This is a more convenient accesssor than subContextOfGenotypes, represents nearly all of the use cases of the former function, and potentially can be implemented more efficiently.
---
 .../varianteval/util/VariantEvalUtils.java     |  2 +-
 .../walkers/variantutils/SelectVariants.java   |  8 +-------
 .../utils/variantcontext/VariantContext.java   | 18 +++++++++++++++++-
 3 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
index aa8c6cfb9..e700a733c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
@@ -277,7 +277,7 @@ public class VariantEvalUtils {
      * @return a new VariantContext with just the requested samples
      */
     public VariantContext getSubsetOfVariantContext(VariantContext vc, Collection<String> sampleNames) {
-        VariantContext vcsub = vc.subContextFromGenotypes(vc.getGenotypes(sampleNames).values(), vc.getAlleles());
+        VariantContext vcsub = vc.subContextFromSamples(sampleNames, vc.getAlleles());
 
         HashMap<String, Object> newAts = new HashMap<String, Object>(vcsub.getAttributes());
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index 609593acc..0efb46bf5 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -659,13 +659,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
         if ( samples == null || samples.isEmpty() )
             return vc;
 
-        ArrayList<Genotype> genotypes = new ArrayList<Genotype>();
-        for ( Map.Entry<String, Genotype> genotypePair : vc.getGenotypes().entrySet() ) {
-            if ( samples.contains(genotypePair.getKey()) )
-                genotypes.add(genotypePair.getValue());
-        }
-
-        VariantContext sub = vc.subContextFromGenotypes(genotypes, vc.getAlleles());
+        VariantContext sub = vc.subContextFromSamples(samples);
 
         // if we have fewer alternate alleles in the selected VC than in the original VC, we need to strip out the GL/PLs (because they are no longer accurate)
         if ( vc.getAlleles().size() != sub.getAlleles().size() )
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index ba96b13d8..db398b478 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -446,9 +446,25 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return vc subcontext
      */
     public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes, Collection<Allele> alleles) {
-        return new VariantContext(getSource(), contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, getNegLog10PError(), filtersWereApplied() ? getFilters() : null, getAttributes(), getReferenceBaseForIndel());
+        return new VariantContext(getSource(), contig, start, stop, alleles,
+                genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null,
+                getNegLog10PError(),
+                filtersWereApplied() ? getFilters() : null,
+                getAttributes(),
+                getReferenceBaseForIndel());
     }
 
+    public VariantContext subContextFromSamples(Collection<String> sampleNames, Collection<Allele> alleles) {
+        return subContextFromGenotypes(getGenotypes(sampleNames).values(), alleles);
+    }
+
+    public VariantContext subContextFromSamples(Collection<String> sampleNames) {
+        return subContextFromGenotypes(getGenotypes(sampleNames).values());
+    }
+
+    public VariantContext subContextFromSample(String sampleName) {
+        return subContextFromGenotypes(getGenotype(sampleName));
+    }
 
     /**
      * helper routine for subcontext

From 4938569b3ac26eb1fb3e66ab5ffb47ac0723f03e Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 11 Nov 2011 10:22:19 -0500
Subject: [PATCH 004/113] More general handling of parameters for
 VariantContextBenchmark

---
 .../VariantContextBenchmark.java              | 43 +++++++++++++------
 1 file changed, 30 insertions(+), 13 deletions(-)

diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
index 2f8419b5e..7ad2c5c1b 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -46,13 +46,24 @@ public class VariantContextBenchmark extends SimpleBenchmark {
     @Param({"100"})
     int nSamplesToTake; // set automatically by framework
 
+    @Param({"READ", "READ_SUBSET"})
+    Operation operation; // set automatically by framework
+
+    @Param({"OF_GENOTYPES", "OF_SAMPLES"})
+    SubContextOp subContextOp; // set automatically by framework
+
     private String INPUT_STRING;
 
-    private enum Operation {
+    public enum Operation {
         READ,
         READ_SUBSET
     }
 
+    public enum SubContextOp {
+        OF_GENOTYPES,
+        OF_SAMPLES
+    }
+
     @Override protected void setUp() {
         // read it into a String so that we don't try to benchmark IO issues
         try {
@@ -73,7 +84,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
         }
     }
 
-    private void parseGenotypes(VCFCodec codec, Operation op) {
+    private void parseGenotypes(VCFCodec codec, Operation op, SubContextOp subop ) {
         try {
             InputStream is = new ByteArrayInputStream(INPUT_STRING.getBytes());
             AsciiLineReader lineReader = new AsciiLineReader(is);
@@ -92,30 +103,36 @@ public class VariantContextBenchmark extends SimpleBenchmark {
                 }
 
                 if ( op == Operation.READ_SUBSET)
-                    processOneVC(vc, samples);
+                    processOneVC(vc, samples, subop);
             }
         } catch (Exception e) {
             System.out.println("Benchmarking run failure because of " + e.getMessage());
         }
     }
 
-    public void timeOriginalRead(int rep) {
+    public void timeMe(int rep) {
         for ( int i = 0; i < rep; i++ )
-            parseGenotypes(new VCFCodec(), Operation.READ);
-    }
-
-    public void timeOriginalReadSubset(int rep) {
-        for ( int i = 0; i < rep; i++ )
-            parseGenotypes(new VCFCodec(), Operation.READ_SUBSET);
+            parseGenotypes(new VCFCodec(), operation, subContextOp);
     }
 
     public static void main(String[] args) {
         CaliperMain.main(VariantContextBenchmark.class, args);
     }
 
-    private static final void processOneVC(VariantContext vc, List<String> samples) {
-        VariantContext sub = vc.subContextFromGenotypes(vc.getGenotypes(samples).values(), vc.getAlleles());
+    private static final void processOneVC(VariantContext vc, List<String> samples, SubContextOp subop) {
+        VariantContext sub;
+
+        switch ( subop ) {
+            case OF_GENOTYPES:
+                sub = vc.subContextFromGenotypes(vc.getGenotypes(samples).values(), vc.getAlleles());
+                break;
+            case OF_SAMPLES:
+                sub = vc.subContextFromSamples(samples, vc.getAlleles());
+                break;
+            default:
+                throw new RuntimeException("Unexpected op: " + subop);
+        }
+
         sub.getNSamples();
     }
-
 }

From fee9b367e49e8fdc798c9d511ecb1f7b9eed9efd Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 11 Nov 2011 15:00:35 -0500
Subject: [PATCH 005/113] VariantContext genotypes are now stored as
 GenotypeMap objects

-- Enables further sophisticated optimizations, as this class can be smarter about storing the data and will directly support operations like subset to samples
-- All instances in the gatk that used Map<String, Genotype> now use GenotypeMap type.
-- Amazingly, there were many places where HashMap<String, Genotype> is used, so that the order of the genotypes is technically undefined and could be dangerous.  Now everything uses GenotypeMap with a specific ordering of samples (by name)
-- Integrationtests updated and all pass
---
 .../gatk/refdata/VariantContextAdaptors.java  |  4 +-
 .../gatk/walkers/annotator/AlleleBalance.java |  3 +-
 .../gatk/walkers/annotator/HardyWeinberg.java |  3 +-
 .../walkers/annotator/InbreedingCoeff.java    |  3 +-
 .../gatk/walkers/annotator/QualByDepth.java   |  3 +-
 .../gatk/walkers/annotator/RankSumTest.java   |  3 +-
 .../annotator/VariantAnnotatorEngine.java     |  5 +-
 .../beagle/BeagleOutputToVCFWalker.java       | 10 +--
 .../filters/VariantFiltrationWalker.java      |  5 +-
 .../AlleleFrequencyCalculationModel.java      |  7 +-
 .../genotyper/ExactAFCalculationModel.java    | 11 ++--
 .../genotyper/GridSearchAFEstimation.java     |  9 +--
 .../walkers/genotyper/UGCallVariants.java     |  3 +-
 .../genotyper/UnifiedGenotyperEngine.java     |  6 +-
 .../indels/SomaticIndelDetectorWalker.java    |  5 +-
 .../walkers/phasing/PhaseByTransmission.java  |  7 +-
 .../phasing/ReadBackedPhasingWalker.java      | 11 ++--
 .../evaluators/GenotypePhasingEvaluator.java  |  5 +-
 .../variantutils/LeftAlignVariants.java       |  3 +-
 .../walkers/variantutils/SelectVariants.java  |  9 +--
 .../walkers/variantutils/VariantsToVCF.java   |  7 +-
 .../utils/codecs/vcf/AbstractVCFCodec.java    |  3 +-
 .../sting/utils/codecs/vcf/VCF3Codec.java     |  5 +-
 .../sting/utils/codecs/vcf/VCFCodec.java      |  5 +-
 .../sting/utils/codecs/vcf/VCFParser.java     |  3 +-
 .../broadinstitute/sting/utils/gcf/GCF.java   |  7 +-
 .../utils/variantcontext/GenotypeMap.java     | 66 +++++++++++++++++++
 .../variantcontext/MutableVariantContext.java |  5 +-
 .../utils/variantcontext/VariantContext.java  | 44 +++++--------
 .../variantcontext/VariantContextUtils.java   | 20 +++---
 .../VariantAnnotatorIntegrationTest.java      |  6 +-
 .../UnifiedGenotyperIntegrationTest.java      | 19 +++---
 .../utils/genotype/vcf/VCFWriterUnitTest.java |  3 +-
 .../VariantContextUtilsUnitTest.java          |  3 +-
 34 files changed, 186 insertions(+), 125 deletions(-)
 create mode 100644 public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index 941dc66b5..cb26f3bf5 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -194,7 +194,7 @@ public class VariantContextAdaptors {
                     return null; // we weren't given enough reference context to create the VariantContext
                 Byte refBaseForIndel = new Byte(ref.getBases()[index]);
 
-                Map<String, Genotype> genotypes = null;
+                GenotypeMap genotypes = null;
                 VariantContext vc = new VariantContext(name, dbsnp.getChr(), dbsnp.getStart() - (sawNullAllele ? 1 : 0), dbsnp.getEnd() - (refAllele.isNull() ? 1 : 0), alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, attributes, refBaseForIndel);
                 return vc;
             } else
@@ -329,7 +329,7 @@ public class VariantContextAdaptors {
             String[] samples = hapmap.getSampleIDs();
             String[] genotypeStrings = hapmap.getGenotypes();
 
-            Map<String, Genotype> genotypes = new HashMap<String, Genotype>(samples.length);
+            GenotypeMap genotypes = GenotypeMap.create(samples.length);
             for ( int i = 0; i < samples.length; i++ ) {
                 // ignore bad genotypes
                 if ( genotypeStrings[i].contains("N") )
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
index 3a21e97a4..297490172 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
@@ -35,6 +35,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.pileup.ReadBackedExtendedEventPileup;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -54,7 +55,7 @@ public class AlleleBalance extends InfoFieldAnnotation {
         
         if ( !vc.isBiallelic() )
             return null;
-        final Map<String, Genotype> genotypes = vc.getGenotypes();
+        final GenotypeMap genotypes = vc.getGenotypes();
         if ( !vc.hasGenotypes() )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
index f068ed895..6352fcf2a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
@@ -11,6 +11,7 @@ import org.broadinstitute.sting.utils.QualityUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -30,7 +31,7 @@ public class HardyWeinberg extends InfoFieldAnnotation implements WorkInProgress
 
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
 
-        final Map<String, Genotype> genotypes = vc.getGenotypes();
+        final GenotypeMap genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() < MIN_SAMPLES )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
index 8728e5aa4..9935eced9 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
@@ -10,6 +10,7 @@ import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -32,7 +33,7 @@ public class InbreedingCoeff extends InfoFieldAnnotation implements StandardAnno
 
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
 
-        final Map<String, Genotype> genotypes = vc.getGenotypes();
+        final GenotypeMap genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() < MIN_SAMPLES )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
index b942d9817..e34ef5d45 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
@@ -9,6 +9,7 @@ import org.broadinstitute.sting.gatk.walkers.annotator.interfaces.StandardAnnota
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -28,7 +29,7 @@ public class QualByDepth extends InfoFieldAnnotation implements StandardAnnotati
         if ( stratifiedContexts.size() == 0 )
             return null;
 
-        final Map<String, Genotype> genotypes = vc.getGenotypes();
+        final GenotypeMap genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() == 0 )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
index 93e093248..f75997d57 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
@@ -13,6 +13,7 @@ import org.broadinstitute.sting.utils.collections.Pair;
 import org.broadinstitute.sting.utils.pileup.PileupElement;
 import org.broadinstitute.sting.utils.pileup.ReadBackedPileup;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.ArrayList;
@@ -32,7 +33,7 @@ public abstract class RankSumTest extends InfoFieldAnnotation implements Standar
         if ( stratifiedContexts.size() == 0 )
             return null;
          
-        final Map<String, Genotype> genotypes = vc.getGenotypes();
+        final GenotypeMap genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() == 0 )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
index e4bc0d5d5..87b1366cf 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
@@ -34,6 +34,7 @@ import org.broadinstitute.sting.gatk.walkers.annotator.interfaces.*;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.*;
@@ -216,11 +217,11 @@ public class VariantAnnotatorEngine {
         }
     }
 
-    private Map<String, Genotype> annotateGenotypes(RefMetaDataTracker tracker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
+    private GenotypeMap annotateGenotypes(RefMetaDataTracker tracker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
         if ( requestedGenotypeAnnotations.size() == 0 )
             return vc.getGenotypes();
 
-        Map<String, Genotype> genotypes = new HashMap<String, Genotype>(vc.getNSamples());
+        GenotypeMap genotypes = GenotypeMap.create(vc.getNSamples());
         for ( Map.Entry<String, Genotype> g : vc.getGenotypes().entrySet() ) {
             Genotype genotype = g.getValue();
             AlignmentContext context = stratifiedContexts.get(g.getKey());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index 7f6dabeec..352b1790e 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -36,10 +36,7 @@ import org.broadinstitute.sting.gatk.walkers.RodWalker;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.util.*;
 
@@ -190,8 +187,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         byte refByte = ref.getBase();
 
         // make new Genotypes based on Beagle results
-        Map<String, Genotype> genotypes = new HashMap<String, Genotype>(vc_input.getGenotypes().size());
-
+        GenotypeMap genotypes = GenotypeMap.create(vc_input.getGenotypes().size());
 
         // for each genotype, create a new object with Beagle information on it
 
@@ -200,7 +196,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         Double alleleFrequencyH = 0.0;
         int beagleVarCounts = 0;
 
-        Map<String,Genotype> hapmapGenotypes = null;
+        GenotypeMap hapmapGenotypes = null;
 
         if (vc_comp != null) {
             hapmapGenotypes = vc_comp.getGenotypes();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
index bf3606b54..9428fd7ee 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
@@ -37,6 +37,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
@@ -282,11 +283,11 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
         VariantContext vc = context.getVariantContext();
 
         // make new Genotypes based on filters
-        Map<String, Genotype> genotypes;
+        GenotypeMap genotypes;
         if ( genotypeFilterExps.size() == 0 ) {
             genotypes = null;
         } else {
-            genotypes = new HashMap<String, Genotype>(vc.getGenotypes().size());
+            genotypes = GenotypeMap.create(vc.getGenotypes().size());
 
             // for each genotype, check filters then create a new object
             for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
index 35a9fe31d..2bee98879 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
@@ -30,6 +30,7 @@ import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
 import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
@@ -85,7 +86,7 @@ public abstract class AlleleFrequencyCalculationModel implements Cloneable {
      *
      * @return calls
      */
-    protected abstract Map<String, Genotype> assignGenotypes(VariantContext vc,
-                                                             double[] log10AlleleFrequencyPosteriors,
-                                                             int AFofMaxLikelihood);
+    protected abstract GenotypeMap assignGenotypes(VariantContext vc,
+                                                   double[] log10AlleleFrequencyPosteriors,
+                                                   int AFofMaxLikelihood);
 }
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index 1c2d82ab7..0e3062cfc 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -33,6 +33,7 @@ import org.broadinstitute.sting.utils.Utils;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
@@ -268,14 +269,14 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
      *
      * @return calls
      */
-    public Map<String, Genotype> assignGenotypes(VariantContext vc,
-                                                 double[] log10AlleleFrequencyPosteriors,
-                                                 int AFofMaxLikelihood) {
+    public GenotypeMap assignGenotypes(VariantContext vc,
+                                       double[] log10AlleleFrequencyPosteriors,
+                                       int AFofMaxLikelihood) {
         if ( !vc.isVariant() )
             throw new UserException("The VCF record passed in does not contain an ALT allele at " + vc.getChr() + ":" + vc.getStart());
 
 
-        Map<String, Genotype> GLs = vc.getGenotypes();
+        GenotypeMap GLs = vc.getGenotypes();
         double[][] pathMetricArray = new double[GLs.size()+1][AFofMaxLikelihood+1];
         int[][] tracebackArray = new int[GLs.size()+1][AFofMaxLikelihood+1];
 
@@ -342,7 +343,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
             }
         }
 
-        HashMap<String, Genotype> calls = new HashMap<String, Genotype>();
+        GenotypeMap calls = GenotypeMap.create();
 
         int startIdx = AFofMaxLikelihood;
         for (int k = sampleIdx; k > 0; k--) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java
index 27842a8bf..bb31045a7 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java
@@ -34,6 +34,7 @@ import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
@@ -89,15 +90,15 @@ public class GridSearchAFEstimation extends AlleleFrequencyCalculationModel {
      *
      * @return calls
      */
-    protected Map<String, Genotype> assignGenotypes(VariantContext vc,
-                                                    double[] log10AlleleFrequencyPosteriors,
-                                                    int AFofMaxLikelihood) {
+    protected GenotypeMap assignGenotypes(VariantContext vc,
+                                          double[] log10AlleleFrequencyPosteriors,
+                                          int AFofMaxLikelihood) {
         if ( !vc.isVariant() )
             throw new UserException("The VCF record passed in does not contain an ALT allele at " + vc.getChr() + ":" + vc.getStart());
 
         Allele refAllele = vc.getReference();
         Allele altAllele = vc.getAlternateAllele(0);
-        HashMap<String, Genotype> calls = new HashMap<String, Genotype>();
+        GenotypeMap calls = GenotypeMap.create();
 
         // first, the potential alt calls
         for ( String sample : AFMatrix.getSamples() ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
index d88e55687..c54089350 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
@@ -36,6 +36,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
@@ -128,7 +129,7 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
             return null;
 
         VariantContext variantVC = null;
-        Map<String, Genotype> genotypes = new HashMap<String, Genotype>();
+        GenotypeMap genotypes = GenotypeMap.create();
         for ( VariantContext vc : VCs ) {
             if ( variantVC == null && vc.isVariant() )
                 variantVC = vc;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
index cee128a6a..bc9a5f65b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
@@ -265,7 +265,7 @@ public class UnifiedGenotyperEngine {
         alleles.add(refAllele);
         boolean addedAltAlleles = false;
 
-        HashMap<String, Genotype> genotypes = new HashMap<String, Genotype>();
+        GenotypeMap genotypes = GenotypeMap.create();
         for ( MultiallelicGenotypeLikelihoods GL : GLs.values() ) {
             if ( !addedAltAlleles ) {
                 addedAltAlleles = true;
@@ -354,7 +354,7 @@ public class UnifiedGenotyperEngine {
         }
 
         // create the genotypes
-        Map<String, Genotype> genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
+        GenotypeMap genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
 
         // print out stats if we have a writer
         if ( verboseWriter != null )
@@ -491,7 +491,7 @@ public class UnifiedGenotyperEngine {
         }
 
         // create the genotypes
-        Map<String, Genotype> genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
+        GenotypeMap genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
 
         // *** note that calculating strand bias involves overwriting data structures, so we do that last
         HashMap<String, Object> attributes = new HashMap<String, Object>();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
index a97117acd..ee5562ba2 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
@@ -60,6 +60,7 @@ import org.broadinstitute.sting.utils.sam.AlignmentUtils;
 import org.broadinstitute.sting.utils.sam.GATKSAMRecord;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -1057,7 +1058,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
             stop += event_length;
         }
 
-        Map<String,Genotype> genotypes = new HashMap<String,Genotype>();
+        GenotypeMap genotypes = GenotypeMap.create();
 
         for ( String sample : normalSamples ) {
 
@@ -1147,7 +1148,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
         homRefAlleles.add( alleles.get(0));
         homRefAlleles.add( alleles.get(0));
 
-        Map<String,Genotype> genotypes = new HashMap<String,Genotype>();
+        GenotypeMap genotypes = GenotypeMap.create();
 
         for ( String sample : normalSamples ) {
             genotypes.put(sample,new Genotype(sample, homRefN ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsNormal,false));
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
index 3eedc2a28..6b52fcf62 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
@@ -12,10 +12,7 @@ import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.text.XReadLines;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.File;
 import java.io.FileNotFoundException;
@@ -296,7 +293,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
         if (tracker != null) {
             VariantContext vc = tracker.getFirstValue(variantCollection.variants, context.getLocation());
 
-            Map<String, Genotype> genotypeMap = vc.getGenotypes();
+            GenotypeMap genotypeMap = vc.getGenotypes();
 
             for (Trio trio : trios) {
                 Genotype mother = vc.getGenotype(trio.getMother());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index 68fbe8ce2..2aa96379c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -41,10 +41,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.pileup.PileupElement;
 import org.broadinstitute.sting.utils.pileup.ReadBackedPileup;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.*;
 import java.util.*;
@@ -355,7 +352,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         UnfinishedVariantContext uvc = uvr.unfinishedVariant;
 
         // Perform per-sample phasing:
-        Map<String, Genotype> sampGenotypes = vc.getGenotypes();
+        GenotypeMap sampGenotypes = vc.getGenotypes();
         Map<String, PhaseCounts> samplePhaseStats = new TreeMap<String, PhaseCounts>();
         for (Map.Entry<String, Genotype> sampGtEntry : sampGenotypes.entrySet()) {
             String samp = sampGtEntry.getKey();
@@ -1126,7 +1123,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         private int start;
         private int stop;
         private Collection<Allele> alleles;
-        private Map<String, Genotype> genotypes;
+        private GenotypeMap genotypes;
         private double negLog10PError;
         private Set<String> filters;
         private Map<String, Object> attributes;
@@ -1137,7 +1134,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
             this.start = vc.getStart();
             this.stop = vc.getEnd();
             this.alleles = vc.getAlleles();
-            this.genotypes = new HashMap<String, Genotype>(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
+            this.genotypes = GenotypeMap.create(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
             this.negLog10PError = vc.getNegLog10PError();
             this.filters = vc.filtersWereApplied() ? vc.getFilters() : null;
             this.attributes = new HashMap<String, Object>(vc.getAttributes());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
index e69dbfb28..ad9ad62b3 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
@@ -14,6 +14,7 @@ import org.broadinstitute.sting.gatk.walkers.varianteval.util.TableType;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.HashMap;
@@ -91,13 +92,13 @@ public class GenotypePhasingEvaluator extends VariantEvaluator {
 
         Set<String> allSamples = new HashSet<String>();
 
-        Map<String, Genotype> compSampGenotypes = null;
+        GenotypeMap compSampGenotypes = null;
         if (isRelevantToPhasing(comp)) {
             allSamples.addAll(comp.getSampleNames());
             compSampGenotypes = comp.getGenotypes();
         }
 
-        Map<String, Genotype> evalSampGenotypes = null;
+        GenotypeMap evalSampGenotypes = null;
         if (isRelevantToPhasing(eval)) {
             allSamples.addAll(eval.getSampleNames());
             evalSampGenotypes = eval.getGenotypes();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
index c9f330db5..64f54e611 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
@@ -40,6 +40,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.sam.AlignmentUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.*;
@@ -210,7 +211,7 @@ public class LeftAlignVariants extends RodWalker<Integer, Integer> {
         }
 
         // create new Genotype objects
-        Map<String, Genotype> newGenotypes = new HashMap<String, Genotype>(vc.getNSamples());
+        GenotypeMap newGenotypes = GenotypeMap.create(vc.getNSamples());
         for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
             List<Allele> newAlleles = new ArrayList<Allele>();
             for ( Allele allele : genotype.getValue().getAlleles() ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index 0efb46bf5..3c5a55134 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -33,7 +33,7 @@ import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.text.XReadLines;
 import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
 import org.broadinstitute.sting.utils.MendelianViolation;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 import org.broadinstitute.sting.commandline.Argument;
 import org.broadinstitute.sting.commandline.Output;
 import org.broadinstitute.sting.gatk.contexts.AlignmentContext;
@@ -41,9 +41,6 @@ import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
 import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
 import org.broadinstitute.sting.gatk.walkers.RodWalker;
 import org.broadinstitute.sting.utils.SampleUtils;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
 import java.io.File;
 import java.io.FileNotFoundException;
@@ -561,7 +558,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
             return (compVCs == null || compVCs.isEmpty());
 
         // check if we find it in the variant rod
-        Map<String, Genotype> genotypes = vc.getGenotypes(samples);
+        GenotypeMap genotypes = vc.getGenotypes(samples);
         for (Genotype g : genotypes.values()) {
             if (sampleHasVariant(g)) {
                 // There is a variant called (or filtered with not exclude filtered option set) that is not HomRef for at least one of the samples.
@@ -659,7 +656,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
         if ( samples == null || samples.isEmpty() )
             return vc;
 
-        VariantContext sub = vc.subContextFromSamples(samples);
+        VariantContext sub = vc.subContextFromSamples(samples, vc.getAlleles());
 
         // if we have fewer alternate alleles in the selected VC than in the original VC, we need to strip out the GL/PLs (because they are no longer accurate)
         if ( vc.getAlleles().size() != sub.getAlleles().size() )
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
index 9b33f8537..7f1fc9d16 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
@@ -42,10 +42,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.hapmap.RawHapMapFeature;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.File;
 import java.util.*;
@@ -133,7 +130,7 @@ public class VariantsToVCF extends RodWalker<Integer, Integer> {
             // set the appropriate sample name if necessary
             if ( sampleName != null && vc.hasGenotypes() && vc.hasGenotype(variants.getName()) ) {
                 Genotype g = Genotype.modifyName(vc.getGenotype(variants.getName()), sampleName);
-                Map<String, Genotype> genotypes = new HashMap<String, Genotype>();
+                GenotypeMap genotypes = GenotypeMap.create(1);
                 genotypes.put(sampleName, g);
                 vc = VariantContext.modifyGenotypes(vc, genotypes);
             }
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index 3377172dd..c285a9f68 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -12,6 +12,7 @@ import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -76,7 +77,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public abstract Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+    public abstract GenotypeMap createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
 
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
index bed66a439..fcfc0c6fc 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
@@ -5,6 +5,7 @@ import org.broad.tribble.readers.LineReader;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.File;
@@ -118,13 +119,13 @@ public class VCF3Codec extends AbstractVCFCodec {
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+    public GenotypeMap createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
         if (genotypeParts == null)
             genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
 
         int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
 
-        Map<String, Genotype> genotypes = new LinkedHashMap<String, Genotype>(nParts);
+        GenotypeMap genotypes = GenotypeMap.create(nParts);
 
         // get the format keys
         int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
index 58dfd3589..eefb929bb 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
@@ -5,6 +5,7 @@ import org.broad.tribble.readers.LineReader;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.File;
@@ -145,13 +146,13 @@ public class VCFCodec extends AbstractVCFCodec {
      * @param alleles the list of alleles
      * @return a mapping of sample name to genotype object
      */
-    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+    public GenotypeMap createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
         if (genotypeParts == null)
             genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
 
         int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
 
-        Map<String, Genotype> genotypes = new LinkedHashMap<String, Genotype>(nParts);
+        GenotypeMap genotypes = GenotypeMap.create(nParts);
 
         // get the format keys
         int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
index 1dba351e2..2887c5360 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
@@ -2,6 +2,7 @@ package org.broadinstitute.sting.utils.codecs.vcf;
 
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 
 import java.util.List;
 import java.util.Map;
@@ -20,6 +21,6 @@ public interface VCFParser {
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+    public GenotypeMap createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
 
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
index ef0d9ca42..7f15b4f5e 100644
--- a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
+++ b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
@@ -28,6 +28,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.StandardVCFWriter;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -145,16 +146,16 @@ public class GCF {
         Map<String, Object> attributes = new HashMap<String, Object>();
         attributes.put("INFO", info);
         Byte refPadByte = refPad == 0 ? null : refPad;
-        Map<String, Genotype> genotypes = decodeGenotypes(header);
+        GenotypeMap genotypes = decodeGenotypes(header);
 
         return new VariantContext(source, contig, start, stop, alleleMap, genotypes, negLog10PError, filters, attributes, refPadByte);
     }
 
-    private Map<String, Genotype> decodeGenotypes(final GCFHeader header) {
+    private GenotypeMap decodeGenotypes(final GCFHeader header) {
         if ( genotypes.isEmpty() )
             return VariantContext.NO_GENOTYPES;
         else {
-            Map<String, Genotype> map = new TreeMap<String, Genotype>();
+            GenotypeMap map = GenotypeMap.create();
 
             for ( int i = 0; i < genotypes.size(); i++ ) {
                 final String sampleName = header.getSample(i);
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java
new file mode 100644
index 000000000..319a3b8e8
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext;
+
+import java.util.Collection;
+import java.util.Map;
+import java.util.TreeMap;
+
+/**
+ *
+ */
+public class GenotypeMap extends TreeMap<String, Genotype> implements Map<String, Genotype> {
+    public final static GenotypeMap NO_GENOTYPES = new GenotypeMap();
+
+    public static final GenotypeMap create() {
+        return new GenotypeMap();
+    }
+
+    public static final GenotypeMap create(int nGenotypes) {
+        return new GenotypeMap();
+    }
+
+    public static final GenotypeMap create(final GenotypeMap genotypes) {
+        return create(genotypes.values());
+    }
+
+    public static final GenotypeMap create(final Map<String, Genotype> genotypes) {
+        return create(genotypes.values());
+    }
+
+    public static final GenotypeMap create(final Collection<Genotype> genotypes) {
+        if ( genotypes == null )
+            return null; // todo -- really should return an empty map
+        else {
+            GenotypeMap genotypeMap = new GenotypeMap();
+            for ( final Genotype g : genotypes ) {
+                if ( genotypeMap.containsKey(g.getSampleName() ) )
+                    throw new IllegalArgumentException("Duplicate genotype added to VariantContext: " + g);
+                genotypeMap.put(g.getSampleName(), g);
+            }
+            return genotypeMap;
+        }
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java
index d563c5180..5059fc81c 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java
@@ -22,7 +22,7 @@ public class MutableVariantContext extends VariantContext {
         super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
     }
 
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeMap genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
     }
 
@@ -72,7 +72,7 @@ public class MutableVariantContext extends VariantContext {
     }
 
     public void clearGenotypes() {
-        genotypes = new TreeMap<String, Genotype>();
+        genotypes = GenotypeMap.create();
     }
 
     /**
@@ -98,7 +98,6 @@ public class MutableVariantContext extends VariantContext {
      * @param genotypes
      */
     public void addGenotypes(Map<String, Genotype> genotypes) {
-
         for ( Map.Entry<String, Genotype> elt : genotypes.entrySet() ) {
             addGenotype(elt.getValue());
         }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index db398b478..4682aad27 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -184,12 +184,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     final protected List<Allele> alleles;
 
     /** A mapping from sampleName -> genotype objects for all genotypes associated with this context */
-    protected Map<String, Genotype> genotypes = null;
+    protected GenotypeMap genotypes = null;
 
     /** Counts for each of the possible Genotype types in this context */
     protected int[] genotypeCounts = null;
 
-    public final static Map<String, Genotype> NO_GENOTYPES = Collections.unmodifiableMap(new HashMap<String, Genotype>());
+    public final static GenotypeMap NO_GENOTYPES = GenotypeMap.NO_GENOTYPES;
 
     // a fast cached access point to the ref / alt alleles for biallelic case
     private Allele REF = null;
@@ -222,7 +222,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeMap genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
         this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false);
     }
 
@@ -239,7 +239,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeMap genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false);
     }
 
@@ -278,7 +278,9 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes     attributes
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        this(source, contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes, null, false);
+        this(source, contig, start, stop, alleles,
+                GenotypeMap.create(genotypes),
+                negLog10PError, filters, attributes, null, false);
     }
 
     /**
@@ -333,7 +335,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param genotypesAreUnparsed    true if the genotypes have not yet been parsed
      */
     private VariantContext(String source, String contig, long start, long stop,
-                           Collection<Allele> alleles, Map<String, Genotype> genotypes,
+                           Collection<Allele> alleles, GenotypeMap genotypes,
                            double negLog10PError, Set<String> filters, Map<String, Object> attributes,
                            Byte referenceBaseForIndel, boolean genotypesAreUnparsed) {
         if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
@@ -357,9 +359,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         // we need to make this a LinkedHashSet in case the user prefers a given ordering of alleles
         this.alleles = makeAlleles(alleles);
 
-
         if ( genotypes == null ) { genotypes = NO_GENOTYPES; }
-        this.genotypes = Collections.unmodifiableMap(genotypes);
+        this.genotypes = genotypes;
 
         // cache the REF and ALT alleles
         int nAlleles = alleles.size();
@@ -382,7 +383,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    public static VariantContext modifyGenotypes(VariantContext vc, Map<String, Genotype> genotypes) {
+    public static VariantContext modifyGenotypes(VariantContext vc, GenotypeMap genotypes) {
         return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), false);
     }
 
@@ -447,7 +448,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes, Collection<Allele> alleles) {
         return new VariantContext(getSource(), contig, start, stop, alleles,
-                genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null,
+                GenotypeMap.create(genotypes),
                 getNegLog10PError(),
                 filtersWereApplied() ? getFilters() : null,
                 getAttributes(),
@@ -879,7 +880,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     /**
      * @return set of all Genotypes associated with this context
      */
-    public Map<String, Genotype> getGenotypes() {
+    public GenotypeMap getGenotypes() {
         loadGenotypes();
         return genotypes;
     }
@@ -898,7 +899,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
-    public Map<String, Genotype> getGenotypes(String sampleName) {
+    public GenotypeMap getGenotypes(String sampleName) {
         return getGenotypes(Arrays.asList(sampleName));
     }
 
@@ -910,8 +911,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
-    public Map<String, Genotype> getGenotypes(Collection<String> sampleNames) {
-        HashMap<String, Genotype> map = new HashMap<String, Genotype>();
+    public GenotypeMap getGenotypes(Collection<String> sampleNames) {
+        GenotypeMap map = GenotypeMap.create(sampleNames.size());
 
         for ( String name : sampleNames ) {
             if ( map.containsKey(name) ) throw new IllegalArgumentException("Duplicate names detected in requested samples " + sampleNames);
@@ -1402,16 +1403,6 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         return alleleList;
     }
 
-    public static Map<String, Genotype> genotypeCollectionToMap(Map<String, Genotype> dest, Collection<Genotype> genotypes) {
-        for ( Genotype g : genotypes ) {
-            if ( dest.containsKey(g.getSampleName() ) )
-                throw new IllegalArgumentException("Duplicate genotype added to VariantContext: " + g);
-            dest.put(g.getSampleName(), g);
-        }
-
-        return dest;
-    }
-
     // ---------------------------------------------------------------------------------------------------------
     //
     // tribble integration routines -- not for public consumption
@@ -1464,9 +1455,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             Byte refByte = inputVC.getReferenceBaseForIndel();
 
             List<Allele> alleles = new ArrayList<Allele>();
-            Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
-
-            Map<String, Genotype> inputGenotypes = inputVC.getGenotypes();
+            GenotypeMap genotypes = GenotypeMap.create();
+            GenotypeMap inputGenotypes = inputVC.getGenotypes();
 
             for (Allele a : inputVC.getAlleles()) {
                 // get bases for current allele and create a new one with trimmed bases
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 0bb01dbb5..ac28928ff 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -70,7 +70,7 @@ public class VariantContextUtils {
      * @return VariantContext object
      */
     public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes != null ? VariantContext.genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes);
+        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, GenotypeMap.create(genotypes), negLog10PError, filters, attributes);
     }
 
     /**
@@ -404,7 +404,7 @@ public class VariantContextUtils {
      */
     public static VariantContext masterMerge(Collection<VariantContext> unsortedVCs, String masterName) {
         VariantContext master = findMaster(unsortedVCs, masterName);
-        Map<String, Genotype> genotypes = master.getGenotypes();
+        GenotypeMap genotypes = master.getGenotypes();
         for (Genotype g : genotypes.values()) {
             genotypes.put(g.getSampleName(), new MutableGenotype(g));
         }
@@ -526,7 +526,7 @@ public class VariantContextUtils {
         final Map<String, Object> attributesWithMaxAC = new TreeMap<String, Object>();
         double negLog10PError = -1;
         VariantContext vcWithMaxAC = null;
-        Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
+        GenotypeMap genotypes = GenotypeMap.create();
 
         // counting the number of filtered and variant VCs
         int nFiltered = 0;
@@ -716,7 +716,7 @@ public class VariantContextUtils {
         // nothing to do if we don't need to trim bases
         if (trimVC) {
             List<Allele> alleles = new ArrayList<Allele>();
-            Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
+            GenotypeMap genotypes = GenotypeMap.create();
 
             // set the reference base for indels in the attributes
             Map<String,Object> attributes = new TreeMap<String,Object>(inputVC.getAttributes());
@@ -770,8 +770,8 @@ public class VariantContextUtils {
         return inputVC;
     }
 
-    public static Map<String, Genotype> stripPLs(Map<String, Genotype> genotypes) {
-        Map<String, Genotype> newGs = new HashMap<String, Genotype>(genotypes.size());
+    public static GenotypeMap stripPLs(GenotypeMap genotypes) {
+        GenotypeMap newGs = GenotypeMap.create(genotypes.size());
 
         for ( Map.Entry<String, Genotype> g : genotypes.entrySet() ) {
             newGs.put(g.getKey(), g.getValue().hasLikelihoods() ? removePLs(g.getValue()) : g.getValue());
@@ -951,7 +951,7 @@ public class VariantContextUtils {
         }
     }
 
-    private static void mergeGenotypes(Map<String, Genotype> mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
+    private static void mergeGenotypes(GenotypeMap mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
         for ( Genotype g : oneVC.getGenotypes().values() ) {
             String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
             if ( ! mergedGenotypes.containsKey(name) ) {
@@ -992,7 +992,7 @@ public class VariantContextUtils {
         }
 
         // create new Genotype objects
-        Map<String, Genotype> newGenotypes = new HashMap<String, Genotype>(vc.getNSamples());
+        GenotypeMap newGenotypes = GenotypeMap.create(vc.getNSamples());
         for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
             List<Allele> newAlleles = new ArrayList<Allele>();
             for ( Allele allele : genotype.getValue().getAlleles() ) {
@@ -1012,7 +1012,7 @@ public class VariantContextUtils {
         if ( allowedAttributes == null )
             return vc;
 
-        Map<String, Genotype> newGenotypes = new HashMap<String, Genotype>(vc.getNSamples());
+        GenotypeMap newGenotypes = GenotypeMap.create(vc.getNSamples());
         for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
             Map<String, Object> attrs = new HashMap<String, Object>();
             for ( Map.Entry<String, Object> attr : genotype.getValue().getAttributes().entrySet() ) {
@@ -1091,7 +1091,7 @@ public class VariantContextUtils {
         }
         MergedAllelesData mergeData = new MergedAllelesData(intermediateBases, vc1, vc2); // ensures that the reference allele is added
 
-        Map<String, Genotype> mergedGenotypes = new HashMap<String, Genotype>();
+        GenotypeMap mergedGenotypes = GenotypeMap.create();
         for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
             String sample = gt1Entry.getKey();
             Genotype gt1 = gt1Entry.getValue();
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
index 189f643d4..28c0a31a6 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
@@ -32,7 +32,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testHasAnnotsAsking1() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("8e7de435105499cd71ffc099e268a83e"));
+                Arrays.asList("a6687f0d3830fa6e518b7874857f6f70"));
         executeTest("test file has annotations, asking for annotations, #1", spec);
     }
 
@@ -64,7 +64,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testNoAnnotsAsking1() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample2empty.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("fd1ffb669800c2e07df1e2719aa38e49"));
+                Arrays.asList("b59508cf66da6b2de280a79b3b7d85b1"));
         executeTest("test file doesn't have annotations, asking for annotations, #1", spec);
     }
 
@@ -80,7 +80,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testExcludeAnnotations() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard -XA FisherStrand -XA ReadPosRankSumTest --variant:VCF3 " + validationDataLocation + "vcfexample2empty.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("b49fe03aa4b675db80a9db38a3552c95"));
+                Arrays.asList("b8e18b23568e4d2381f51d4430213040"));
         executeTest("test exclude annotations", spec);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
index b80f214b1..0110b847d 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
@@ -30,20 +30,23 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testMultiSamplePilot1() {
         WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -o %s -L 1:10,022,000-10,025,000", 1,
-                Arrays.asList("b27939251539439a382538e507e03507"));
+                Arrays.asList("c93def488de12fb3b8199e001b7a24a8"));
         executeTest("test MultiSample Pilot1", spec);
     }
 
     @Test
-    public void testWithAllelesPassedIn() {
+    public void testWithAllelesPassedIn1() {
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "allelesForUG.vcf -I " + validationDataLocation + "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,025,000", 1,
-                Arrays.asList("8de2602679ffc92388da0b6cb4325ef6"));
+                Arrays.asList("cef4bd72cbbe72f28e9c72e2818b4708"));
         executeTest("test MultiSample Pilot2 with alleles passed in", spec1);
+    }
 
+    @Test
+    public void testWithAllelesPassedIn2() {
         WalkerTest.WalkerTestSpec spec2 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " --output_mode EMIT_ALL_SITES --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "allelesForUG.vcf -I " + validationDataLocation + "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,025,000", 1,
-                Arrays.asList("6458f3b8fe4954e2ffc2af972aaab19e"));
+                Arrays.asList("14f5cdfc6818cbba600cbdf5fe285275"));
         executeTest("test MultiSample Pilot2 with alleles passed in and emitting all sites", spec2);
     }
 
@@ -261,7 +264,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndels + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "indelAllelesForUG.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,100,000", 1,
-                Arrays.asList("118918f2e9e56a3cfc5ccb2856d529c8"));
+                Arrays.asList("81a1035e59cd883e413e62d34265c1a2"));
         executeTest("test MultiSample Pilot2 indels with alleles passed in", spec1);
     }
 
@@ -271,7 +274,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                 baseCommandIndels + " --output_mode EMIT_ALL_SITES --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles "
                         + validationDataLocation + "indelAllelesForUG.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,100,000", 1,
-                Arrays.asList("a20799237accd52c1b8c2ac096309c8f"));
+                Arrays.asList("102b7d915f21dff0a9b6ea64c4c7d409"));
         executeTest("test MultiSample Pilot2 indels with alleles passed in and emitting all sites", spec2);
     }
 
@@ -281,7 +284,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec3 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndels + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "ALL.wgs.union_v2.20101123.indels.sites.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,080,000", 1,
-                Arrays.asList("18ef8181157b4ac3eb8492f538467f92"));
+                Arrays.asList("5900344f97bbac35d147a0a7c2bf1d0c"));
         executeTest("test MultiSample Pilot2 indels with complicated records", spec3);
     }
 
@@ -290,7 +293,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec4 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndelsb37 + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "ALL.wgs.union_v2_chr20_100_110K.20101123.indels.sites.vcf -I " + validationDataLocation +
                         "phase1_GBR_realigned.chr20.100K-110K.bam -o %s -L 20:100,000-110,000", 1,
-                Arrays.asList("ad884e511a751b05e64db5314314365a"));
+                Arrays.asList("45e7bf21cd6358921626404e7ae76c69"));
         executeTest("test MultiSample 1000G Phase1 indels with complicated records emitting all sites", spec4);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
index ea06d897e..b658da1d3 100644
--- a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
@@ -4,6 +4,7 @@ import org.broad.tribble.Tribble;
 import org.broad.tribble.readers.AsciiLineReader;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
@@ -121,7 +122,7 @@ public class VCFWriterUnitTest extends BaseTest {
         List<Allele> alleles = new ArrayList<Allele>();
         Set<String> filters = null;
         Map<String, Object> attributes = new HashMap<String,Object>();
-        Map<String, Genotype> genotypes = new HashMap<String,Genotype>();
+        GenotypeMap genotypes = GenotypeMap.create();
 
         alleles.add(Allele.create("-",true));
         alleles.add(Allele.create("CC",false));
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index 845d9c216..bfda19b6b 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -99,8 +99,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
         int start = 10;
         int stop = start; // alleles.contains(ATC) ? start + 3 : start;
         return new VariantContext(source, "1", start, stop, alleles,
-                genotypes == null ? null : VariantContext.genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes),
-                1.0, filters, null, Cref.getBases()[0]);
+                GenotypeMap.create(genotypes), 1.0, filters, null, Cref.getBases()[0]);
     }
 
     // --------------------------------------------------------------------------------

From 1202a809cb8ac10193a4fb2cd49f3b843e18f82e Mon Sep 17 00:00:00 2001
From: Roger Zurawicki <roger@broadinstitute.org>
Date: Sun, 13 Nov 2011 22:27:49 -0500
Subject: [PATCH 006/113] Added Basic Unit Tests for ReadClipper

Tests some but not all functions
Some tests have been disabled because they are not working
---
 .../utils/clipreads/ReadClipperUnitTest.java  | 152 +++++++++++-------
 1 file changed, 94 insertions(+), 58 deletions(-)

diff --git a/public/java/test/org/broadinstitute/sting/utils/clipreads/ReadClipperUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/clipreads/ReadClipperUnitTest.java
index f625af23c..0c71a845e 100644
--- a/public/java/test/org/broadinstitute/sting/utils/clipreads/ReadClipperUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/clipreads/ReadClipperUnitTest.java
@@ -30,9 +30,12 @@ import org.broadinstitute.sting.BaseTest;
 import org.broadinstitute.sting.utils.sam.ArtificialSAMUtils;
 import org.broadinstitute.sting.utils.sam.GATKSAMRecord;
 import org.testng.Assert;
-import org.testng.annotations.BeforeClass;
+import org.testng.annotations.BeforeTest;
 import org.testng.annotations.Test;
 
+import java.util.LinkedList;
+import java.util.List;
+
 /**
  * Created by IntelliJ IDEA.
  * User: roger
@@ -44,44 +47,57 @@ public class ReadClipperUnitTest extends BaseTest {
 
     // TODO: Add error messages on failed tests
 
+
+    //int debug = 0;
+
     GATKSAMRecord read, expected;
     ReadClipper readClipper;
     final static String BASES = "ACTG";
     final static String QUALS = "!+5?"; //ASCII values = 33,43,53,63
 
-    @BeforeClass
+    // What the test read looks like
+    // Ref:    1 2 3 4 5 6 7 8
+    // Read:   0 1 2 3 - - - -
+    // -----------------------------
+    // Bases:  A C T G - - - -
+    // Quals:  ! + 5 ? - - - -
+
+    @BeforeTest
     public void init() {
         SAMFileHeader header = ArtificialSAMUtils.createArtificialSamHeader(1, 1, 1000);
         read = ArtificialSAMUtils.createArtificialRead(header, "read1", 0, 1, BASES.length());
-        read.setReadUnmappedFlag(true);
         read.setReadBases(new String(BASES).getBytes());
         read.setBaseQualityString(new String(QUALS));
 
         readClipper = new ReadClipper(read);
+        //logger.warn(read.getCigarString());
     }
 
-    @Test ( enabled = false )
+    @Test ( enabled = true )
     public void testHardClipBothEndsByReferenceCoordinates() {
+        init();
         logger.warn("Executing testHardClipBothEndsByReferenceCoordinates");
-
+        //int debug = 1;
         //Clip whole read
-        Assert.assertEquals(readClipper.hardClipBothEndsByReferenceCoordinates(0,0), new GATKSAMRecord(read.getHeader()));
+        Assert.assertEquals(readClipper.hardClipBothEndsByReferenceCoordinates(1,1), new GATKSAMRecord(read.getHeader()));
         //clip 1 base
-        expected = readClipper.hardClipBothEndsByReferenceCoordinates(0,3);
+        expected = readClipper.hardClipBothEndsByReferenceCoordinates(1,4);
         Assert.assertEquals(expected.getReadBases(), BASES.substring(1,3).getBytes());
         Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,3));
         Assert.assertEquals(expected.getCigarString(), "1H2M1H");
 
     }
 
-    @Test ( enabled = false )
+    @Test ( enabled = false ) // TODO This fails at hardClipCigar and returns a NullPointerException
     public void testHardClipByReadCoordinates() {
+        init();
         logger.warn("Executing testHardClipByReadCoordinates");
 
         //Clip whole read
         Assert.assertEquals(readClipper.hardClipByReadCoordinates(0,3), new GATKSAMRecord(read.getHeader()));
 
         //clip 1 base at start
+        System.out.println(readClipper.read.getCigarString());
         expected = readClipper.hardClipByReadCoordinates(0,0);
         Assert.assertEquals(expected.getReadBases(), BASES.substring(1,4).getBytes());
         Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,4));
@@ -107,83 +123,101 @@ public class ReadClipperUnitTest extends BaseTest {
 
     }
 
-    @Test ( enabled = false )
+    public void testIfEqual( GATKSAMRecord read, byte[] readBases, String baseQuals, String cigar) {
+        Assert.assertEquals(read.getReadBases(), readBases);
+        Assert.assertEquals(read.getBaseQualityString(), baseQuals);
+        Assert.assertEquals(read.getCigarString(), cigar);
+    }
+
+    public class testParameter {
+        int inputStart;
+        int inputStop;
+        int substringStart;
+        int substringStop;
+        String cigar;
+
+        public testParameter(int InputStart, int InputStop, int SubstringStart, int SubstringStop, String Cigar) {
+            inputStart = InputStart;
+            inputStop = InputStop;
+            substringStart = SubstringStart;
+            substringStop = SubstringStop;
+            cigar = Cigar;
+            }
+    }
+
+    @Test ( enabled = true )
     public void testHardClipByReferenceCoordinates() {
         logger.warn("Executing testHardClipByReferenceCoordinates");
-
+        //logger.warn(debug);
         //Clip whole read
         Assert.assertEquals(readClipper.hardClipByReferenceCoordinates(1,4), new GATKSAMRecord(read.getHeader()));
 
-        //clip 1 base at start
-        expected = readClipper.hardClipByReferenceCoordinates(-1,1);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(1,4).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,4));
-        Assert.assertEquals(expected.getCigarString(), "1H3M");
+        List<testParameter> testList = new LinkedList<testParameter>();
+        testList.add(new testParameter(-1,1,1,4,"1H3M"));//clip 1 base at start
+        testList.add(new testParameter(4,-1,0,3,"3M1H"));//clip 1 base at end
+        testList.add(new testParameter(-1,2,2,4,"2H2M"));//clip 2 bases at start
+        testList.add(new testParameter(3,-1,0,2,"2M2H"));//clip 2 bases at end
 
-        //clip 1 base at end
-        expected = readClipper.hardClipByReferenceCoordinates(3,-1);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(0,3).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,3));
-        Assert.assertEquals(expected.getCigarString(), "3M1H");
-
-        //clip 2 bases at start
-        expected = readClipper.hardClipByReferenceCoordinates(-1,2);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(2,4).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(2,4));
-        Assert.assertEquals(expected.getCigarString(), "2H2M");
-
-        //clip 2 bases at end
-        expected = readClipper.hardClipByReferenceCoordinates(2,-1);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(0,2).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,2));
-        Assert.assertEquals(expected.getCigarString(), "2M2H");
+        for ( testParameter p : testList ) {
+            init();
+            //logger.warn("Testing Parameters: " + p.inputStart+","+p.inputStop+","+p.substringStart+","+p.substringStop+","+p.cigar);
+            testIfEqual( readClipper.hardClipByReferenceCoordinates(p.inputStart,p.inputStop),
+                    BASES.substring(p.substringStart,p.substringStop).getBytes(),
+                    QUALS.substring(p.substringStart,p.substringStop),
+                    p.cigar );
+        }
 
     }
 
-    @Test ( enabled = false )
+    @Test ( enabled = true )
     public void testHardClipByReferenceCoordinatesLeftTail() {
+        init();
         logger.warn("Executing testHardClipByReferenceCoordinatesLeftTail");
 
         //Clip whole read
         Assert.assertEquals(readClipper.hardClipByReferenceCoordinatesLeftTail(4), new GATKSAMRecord(read.getHeader()));
 
-        //clip 1 base at start
-        expected = readClipper.hardClipByReferenceCoordinatesLeftTail(1);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(1,4).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,4));
-        Assert.assertEquals(expected.getCigarString(), "1H3M");
+        List<testParameter> testList = new LinkedList<testParameter>();
+        testList.add(new testParameter(1,-1,1,4,"1H3M"));//clip 1 base at start
+        testList.add(new testParameter(2,-1,2,4,"2H2M"));//clip 2 bases at start
 
-        //clip 2 bases at start
-        expected = readClipper.hardClipByReferenceCoordinatesLeftTail(2);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(2,4).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(2,4));
-        Assert.assertEquals(expected.getCigarString(), "2H2M");
+        for ( testParameter p : testList ) {
+            init();
+            //logger.warn("Testing Parameters: " + p.inputStart+","+p.substringStart+","+p.substringStop+","+p.cigar);
+            testIfEqual( readClipper.hardClipByReferenceCoordinatesLeftTail(p.inputStart),
+                    BASES.substring(p.substringStart,p.substringStop).getBytes(),
+                    QUALS.substring(p.substringStart,p.substringStop),
+                    p.cigar );
+        }
 
     }
 
-    @Test ( enabled = false )
+    @Test ( enabled = true )
     public void testHardClipByReferenceCoordinatesRightTail() {
+        init();
         logger.warn("Executing testHardClipByReferenceCoordinatesRightTail");
 
         //Clip whole read
         Assert.assertEquals(readClipper.hardClipByReferenceCoordinatesRightTail(1), new GATKSAMRecord(read.getHeader()));
 
-        //clip 1 base at end
-        expected = readClipper.hardClipByReferenceCoordinatesRightTail(3);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(0,3).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,3));
-        Assert.assertEquals(expected.getCigarString(), "3M1H");
+        List<testParameter> testList = new LinkedList<testParameter>();
+        testList.add(new testParameter(-1,4,0,3,"3M1H"));//clip 1 base at end
+        testList.add(new testParameter(-1,3,0,2,"2M2H"));//clip 2 bases at end
 
-        //clip 2 bases at end
-        expected = readClipper.hardClipByReferenceCoordinatesRightTail(2);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(0,2).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,2));
-        Assert.assertEquals(expected.getCigarString(), "2M2H");
+        for ( testParameter p : testList ) {
+            init();
+            //logger.warn("Testing Parameters: " + p.inputStop+","+p.substringStart+","+p.substringStop+","+p.cigar);
+            testIfEqual( readClipper.hardClipByReferenceCoordinatesRightTail(p.inputStop),
+                    BASES.substring(p.substringStart,p.substringStop).getBytes(),
+                    QUALS.substring(p.substringStart,p.substringStop),
+                    p.cigar );
+        }
 
     }
 
-    @Test ( enabled = false )
+    @Test ( enabled = false )  // TODO This function is returning null reads
     public void testHardClipLowQualEnds() {
+        init();
         logger.warn("Executing testHardClipByReferenceCoordinates");
 
 
@@ -192,6 +226,7 @@ public class ReadClipperUnitTest extends BaseTest {
 
         //clip 1 base at start
         expected = readClipper.hardClipLowQualEnds((byte)34);
+        logger.warn(expected.getBaseQualities().toString()+","+expected.getBaseQualityString());
         Assert.assertEquals(expected.getReadBases(), BASES.substring(1,4).getBytes());
         Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,4));
         Assert.assertEquals(expected.getCigarString(), "1H3M");
@@ -203,10 +238,11 @@ public class ReadClipperUnitTest extends BaseTest {
         Assert.assertEquals(expected.getCigarString(), "2H2M");
 
         // Reverse Quals sequence
-        readClipper.getRead().setBaseQualityString("?5+!"); // 63,53,43,33
+        //readClipper.getRead().setBaseQualityString("?5+!"); // 63,53,43,33
 
         //clip 1 base at end
-        expected = readClipper.hardClipLowQualEnds((byte)34);
+        expected = readClipper.hardClipLowQualEnds((byte)'!');
+        logger.warn(expected.getBaseQualities().toString()+","+expected.getBaseQualityString());
         Assert.assertEquals(expected.getReadBases(), BASES.substring(0,3).getBytes());
         Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,3));
         Assert.assertEquals(expected.getCigarString(), "3M1H");
@@ -220,4 +256,4 @@ public class ReadClipperUnitTest extends BaseTest {
         // revert Qual sequence
         readClipper.getRead().setBaseQualityString(QUALS);
     }
-}
+}
\ No newline at end of file

From 3d2970453b79fff8cd89dd5e5984d3cacb9b58ea Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Mon, 14 Nov 2011 09:41:54 -0500
Subject: [PATCH 007/113] Misc minor cleanup

---
 .../sting/gatk/walkers/recalibration/CycleCovariate.java      | 2 --
 .../org/broadinstitute/sting/utils/pileup/PileupElement.java  | 4 ++--
 .../src/org/broadinstitute/sting/utils/sam/ReadUtils.java     | 2 +-
 3 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/recalibration/CycleCovariate.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/recalibration/CycleCovariate.java
index e10334a77..6b4fec04e 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/recalibration/CycleCovariate.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/recalibration/CycleCovariate.java
@@ -6,9 +6,7 @@ import org.broadinstitute.sting.utils.NGSPlatform;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.sam.GATKSAMRecord;
 
-import java.util.Arrays;
 import java.util.EnumSet;
-import java.util.List;
 
 /*
  * Copyright (c) 2009 The Broad Institute
diff --git a/public/java/src/org/broadinstitute/sting/utils/pileup/PileupElement.java b/public/java/src/org/broadinstitute/sting/utils/pileup/PileupElement.java
index daf6606ef..bab20b9e8 100755
--- a/public/java/src/org/broadinstitute/sting/utils/pileup/PileupElement.java
+++ b/public/java/src/org/broadinstitute/sting/utils/pileup/PileupElement.java
@@ -95,11 +95,11 @@ public class PileupElement implements Comparable<PileupElement> {
     // --------------------------------------------------------------------------
 
     public boolean isReducedRead() {
-        return ((GATKSAMRecord)read).isReducedRead();
+        return read.isReducedRead();
     }
 
     public int getRepresentativeCount() {
-        return isReducedRead() ? ((GATKSAMRecord)read).getReducedCount(offset) : 1;
+        return isReducedRead() ? read.getReducedCount(offset) : 1;
     }
 
 }
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/utils/sam/ReadUtils.java b/public/java/src/org/broadinstitute/sting/utils/sam/ReadUtils.java
index e125b8c80..8d9018045 100755
--- a/public/java/src/org/broadinstitute/sting/utils/sam/ReadUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/sam/ReadUtils.java
@@ -243,7 +243,7 @@ public class ReadUtils {
     public static GATKSAMRecord hardClipAdaptorSequence(final GATKSAMRecord read, int adaptorLength) {
 
         Pair<Integer, Integer> adaptorBoundaries = getAdaptorBoundaries(read, adaptorLength);
-        GATKSAMRecord result = (GATKSAMRecord)read;
+        GATKSAMRecord result = read;
 
         if ( adaptorBoundaries != null ) {
             if ( read.getReadNegativeStrandFlag() && adaptorBoundaries.second >= read.getAlignmentStart() && adaptorBoundaries.first < read.getAlignmentEnd() )

From 7aee80cd3b909c4982d932f2a9bea6ab762b408d Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Mon, 14 Nov 2011 12:23:46 -0500
Subject: [PATCH 008/113] Fix to deal with reduced reads containing a deletion

---
 .../org/broadinstitute/sting/utils/pileup/PileupElement.java   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/pileup/PileupElement.java b/public/java/src/org/broadinstitute/sting/utils/pileup/PileupElement.java
index bab20b9e8..2d13d6e59 100755
--- a/public/java/src/org/broadinstitute/sting/utils/pileup/PileupElement.java
+++ b/public/java/src/org/broadinstitute/sting/utils/pileup/PileupElement.java
@@ -99,7 +99,8 @@ public class PileupElement implements Comparable<PileupElement> {
     }
 
     public int getRepresentativeCount() {
-        return isReducedRead() ? read.getReducedCount(offset) : 1;
+        // TODO -- if we ever decide to reduce the representation of deletions then this will need to be fixed
+        return (!isDeletion() && isReducedRead()) ? read.getReducedCount(offset) : 1;
     }
 
 }
\ No newline at end of file

From 79987d685cd76163514fc57e0e5211712ac8e3f6 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 14 Nov 2011 12:55:03 -0500
Subject: [PATCH 009/113] GenotypeMap contains a Map, not extends it

-- On path to replacing it with GenotypeCollection
---
 .../utils/variantcontext/GenotypeMap.java     | 137 +++++++++++++++++-
 .../UnifiedGenotyperIntegrationTest.java      |   2 +-
 2 files changed, 132 insertions(+), 7 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java
index 319a3b8e8..cb7250bdb 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java
@@ -24,21 +24,46 @@
 
 package org.broadinstitute.sting.utils.variantcontext;
 
-import java.util.Collection;
-import java.util.Map;
-import java.util.TreeMap;
+import java.util.*;
 
 /**
  *
  */
-public class GenotypeMap extends TreeMap<String, Genotype> implements Map<String, Genotype> {
+public class GenotypeMap implements Map<String, Genotype> {
+    final TreeMap<String, Genotype> genotypes;
+    boolean immutable = false;
     public final static GenotypeMap NO_GENOTYPES = new GenotypeMap();
 
+    // ---------------------------------------------------------------------------
+    //
+    // private constructors -- you have to use static create methods to make these classes
+    //
+    // ---------------------------------------------------------------------------
+
+    private GenotypeMap() {
+        this(false);
+    }
+
+    private GenotypeMap(boolean immutable) {
+        this(new TreeMap<String, Genotype>(), immutable);
+    }
+
+    private GenotypeMap(final TreeMap<String, Genotype> genotypes, final boolean immutable) {
+        this.genotypes = genotypes;
+        this.immutable = immutable;
+    }
+
+    // ---------------------------------------------------------------------------
+    //
+    // public static factory methods
+    //
+    // ---------------------------------------------------------------------------
+
     public static final GenotypeMap create() {
         return new GenotypeMap();
     }
 
-    public static final GenotypeMap create(int nGenotypes) {
+    public static final GenotypeMap create(final int nGenotypes) {
         return new GenotypeMap();
     }
 
@@ -46,6 +71,9 @@ public class GenotypeMap extends TreeMap<String, Genotype> implements Map<String
         return create(genotypes.values());
     }
 
+    // todo -- differentiate between empty constructor and copy constructor
+    // todo -- create constructor (Genotype ... genotypes)
+
     public static final GenotypeMap create(final Map<String, Genotype> genotypes) {
         return create(genotypes.values());
     }
@@ -54,13 +82,110 @@ public class GenotypeMap extends TreeMap<String, Genotype> implements Map<String
         if ( genotypes == null )
             return null; // todo -- really should return an empty map
         else {
-            GenotypeMap genotypeMap = new GenotypeMap();
+            GenotypeMap genotypeMap = new GenotypeMap().mutable();
             for ( final Genotype g : genotypes ) {
                 if ( genotypeMap.containsKey(g.getSampleName() ) )
                     throw new IllegalArgumentException("Duplicate genotype added to VariantContext: " + g);
                 genotypeMap.put(g.getSampleName(), g);
             }
+
+            //return genotypeMap.immutable();  // todo enable when we have time to dive into mutability issue
             return genotypeMap;
         }
     }
+
+    // ---------------------------------------------------------------------------
+    //
+    // Mutability methods
+    //
+    // ---------------------------------------------------------------------------
+
+    public final GenotypeMap mutable() {
+        immutable = false;
+        return this;
+    }
+
+    public final GenotypeMap immutable() {
+        immutable = true;
+        return this;
+    }
+
+    public boolean isMutable() {
+        return ! immutable;
+    }
+
+    public final void checkImmutability() {
+        if ( immutable )
+            throw new IllegalAccessError("GenotypeMap is currently immutable, but a mutator method was invoked on it");
+    }
+
+    // ---------------------------------------------------------------------------
+    //
+    // Map methods
+    //
+    // ---------------------------------------------------------------------------
+
+    @Override
+    public void clear() {
+        checkImmutability();
+        genotypes.clear();
+    }
+
+    @Override
+    public int size() {
+        return genotypes.size();
+    }
+
+    @Override
+    public boolean isEmpty() {
+        return genotypes.isEmpty();
+    }
+
+    @Override
+    public boolean containsKey(final Object o) {
+        return genotypes.containsKey(o);
+    }
+
+    @Override
+    public boolean containsValue(final Object o) {
+        return genotypes.containsValue(o);
+    }
+
+    @Override
+    public Genotype get(final Object o) {
+        return genotypes.get(o);
+    }
+
+    @Override
+    public Genotype put(final String s, final Genotype genotype) {
+        checkImmutability();
+        return genotypes.put(s, genotype);
+    }
+
+    @Override
+    public Genotype remove(final Object o) {
+        checkImmutability();
+        return genotypes.remove(o);
+    }
+
+    @Override
+    public void putAll(final Map<? extends String, ? extends Genotype> map) {
+        checkImmutability();
+        genotypes.putAll(map);
+    }
+
+    @Override
+    public Set<String> keySet() {
+        return Collections.unmodifiableSet(genotypes.keySet());
+    }
+
+    @Override
+    public Collection<Genotype> values() {
+        return genotypes.values();
+    }
+
+    @Override
+    public Set<Entry<String, Genotype>> entrySet() {
+        return genotypes.entrySet();
+    }
 }
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
index 0110b847d..1c01fbdd4 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
@@ -46,7 +46,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testWithAllelesPassedIn2() {
         WalkerTest.WalkerTestSpec spec2 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " --output_mode EMIT_ALL_SITES --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "allelesForUG.vcf -I " + validationDataLocation + "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,025,000", 1,
-                Arrays.asList("14f5cdfc6818cbba600cbdf5fe285275"));
+                Arrays.asList("9834f0cef1cd6ba4943a5aaee1ee8be8"));
         executeTest("test MultiSample Pilot2 with alleles passed in and emitting all sites", spec2);
     }
 

From b11c5355278275d6a772a930c72be2125ca852b6 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 14 Nov 2011 13:16:36 -0500
Subject: [PATCH 011/113] Deleted MutableGenotype

-- This class wasn't really used anywhere, and so removed to control code bloat.
---
 .../gatk/refdata/VariantContextAdaptors.java  |   7 +-
 .../sting/utils/variantcontext/Genotype.java  |   5 +
 .../utils/variantcontext/MutableGenotype.java |  68 ----------
 .../variantcontext/VariantContextUtils.java   | 121 ++++--------------
 4 files changed, 32 insertions(+), 169 deletions(-)
 delete mode 100755 public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableGenotype.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index cb26f3bf5..c4ba5d6d1 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -259,12 +259,7 @@ public class VariantContextAdaptors {
 
                 Map<String, Object> attributes = new HashMap<String, Object>();
                 Collection<Genotype> genotypes = new ArrayList<Genotype>();
-                MutableGenotype call = new MutableGenotype(name, genotypeAlleles);
-
-                // set the likelihoods, depth, and RMS mapping quality values
-                //call.putAttribute(CalledGenotype.POSTERIORS_ATTRIBUTE_KEY,geli.getLikelihoods());
-                //call.putAttribute(GeliTextWriter.MAXIMUM_MAPPING_QUALITY_ATTRIBUTE_KEY,geli.getMaximumMappingQual());
-                //call.putAttribute(GeliTextWriter.READ_COUNT_ATTRIBUTE_KEY,geli.getDepthOfCoverage());
+                Genotype call = new Genotype(name, genotypeAlleles);
 
                 // add the call to the genotype list, and then use this list to create a VariantContext
                 genotypes.add(call);
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
index c59c002f2..eabd2dbad 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
@@ -59,6 +59,11 @@ public class Genotype {
         this(sampleName, alleles, NO_NEG_LOG_10PERROR, null, null, false);
     }
 
+    public Genotype(String sampleName, Genotype parent) {
+        this(sampleName, parent.getAlleles(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
+    }
+
+
 
     // ---------------------------------------------------------------------------------------------------------
     //
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableGenotype.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableGenotype.java
deleted file mode 100755
index fdffb1e10..000000000
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableGenotype.java
+++ /dev/null
@@ -1,68 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext;
-
-import java.util.*;
-
-/**
- * This class emcompasses all the basic information about a genotype.  It is immutable.
- *
- * @author Mark DePristo
- */
-public class MutableGenotype extends Genotype {
-    public MutableGenotype(Genotype parent) {
-        super(parent.getSampleName(), parent.getAlleles(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
-    }
-
-    public MutableGenotype(String sampleName, Genotype parent) {
-        super(sampleName, parent.getAlleles(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
-    }
-
-
-    public MutableGenotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, boolean genotypesArePhased) {
-        super(sampleName, alleles, negLog10PError, filters, attributes, genotypesArePhased);
-    }
-
-    public MutableGenotype(String sampleName, List<Allele> alleles, double negLog10PError) {
-        super(sampleName, alleles, negLog10PError);
-    }
-
-    public MutableGenotype(String sampleName, List<Allele> alleles) {
-        super(sampleName, alleles);
-    }
-
-    public Genotype unmodifiableGenotype() {
-        return new Genotype(getSampleName(), getAlleles(), getNegLog10PError(), getFilters(), getAttributes(), isPhased());
-    }
-
-
-    /**
-     *
-     * @param alleles list of alleles
-     */
-    public void setAlleles(List<Allele> alleles) {
-        this.alleles = new ArrayList<Allele>(alleles);
-        validate();
-    }
-
-    public void setPhase(boolean isPhased) {
-        super.isPhased = isPhased;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // InferredGeneticContext mutation operators
-    //
-    // ---------------------------------------------------------------------------------------------------------
-    public void setName(String name)                    { commonInfo.setName(name); }
-    public void addFilter(String filter)                { commonInfo.addFilter(filter); }
-    public void addFilters(Collection<String> filters)  { commonInfo.addFilters(filters); }
-    public void clearFilters()                          { commonInfo.clearFilters(); }
-    public void setFilters(Collection<String> filters)  { commonInfo.setFilters(filters); }
-    public void setAttributes(Map<String, ?> map)       { commonInfo.setAttributes(map); }
-    public void clearAttributes()                       { commonInfo.clearAttributes(); }
-    public void putAttribute(String key, Object value)  { commonInfo.putAttribute(key, value); }
-    public void removeAttribute(String key)             { commonInfo.removeAttribute(key); }
-    public void putAttributes(Map<String, ?> map)       { commonInfo.putAttributes(map); }
-    public void setNegLog10PError(double negLog10PError) { commonInfo.setNegLog10PError(negLog10PError); }
-    public void putAttribute(String key, Object value, boolean allowOverwrites) { commonInfo.putAttribute(key, value, allowOverwrites); }
-
-}
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index ac28928ff..996628b23 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -330,35 +330,36 @@ public class VariantContextUtils {
         return pruneVariantContext(vc, null);
     }
 
-    public static VariantContext pruneVariantContext(final VariantContext vc, final Collection<String> keysToPreserve ) {
-        final MutableVariantContext mvc = new MutableVariantContext(vc);
-
-        if ( keysToPreserve == null || keysToPreserve.size() == 0 )
-            mvc.clearAttributes();
-        else {
-            final Map<String, Object> d = mvc.getAttributes();
-            mvc.clearAttributes();
-            for ( String key : keysToPreserve )
-                if ( d.containsKey(key) )
-                    mvc.putAttribute(key, d.get(key));
+    private final static Map<String, Object> subsetAttributes(final InferredGeneticContext igc, final Collection<String> keysToPreserve) {
+        Map<String, Object> attributes = new HashMap<String, Object>(keysToPreserve.size());
+        for ( final String key : keysToPreserve  ) {
+            if ( igc.hasAttribute(key) )
+                attributes.put(key, igc.getAttribute(key));
         }
+        return attributes;
+    }
+
+    public static VariantContext pruneVariantContext(final VariantContext vc, Collection<String> keysToPreserve ) {
+        if ( keysToPreserve == null ) keysToPreserve = Collections.emptyList();
+
+        // VC info
+        final Map<String, Object> attributes = subsetAttributes(vc.commonInfo, keysToPreserve);
 
         // this must be done as the ID is stored in the attributes field
-        if ( vc.hasID() ) mvc.setID(vc.getID());
+        // todo -- remove me when ID becomes a first class field in VC
+        if ( vc.hasID() ) attributes.put(VariantContext.ID_KEY, vc.getID());
 
-        Collection<Genotype> gs = mvc.getGenotypes().values();
-        mvc.clearGenotypes();
-        for ( Genotype g : gs ) {
-            MutableGenotype mg = new MutableGenotype(g);
-            mg.clearAttributes();
-            if ( keysToPreserve != null )
-                for ( String key : keysToPreserve )
-                    if ( g.hasAttribute(key) )
-                        mg.putAttribute(key, g.getAttribute(key));
-            mvc.addGenotype(mg);
+        // Genotypes
+        final GenotypeMap genotypes = GenotypeMap.create(vc.getNSamples());
+        for ( final Genotype g : vc.getGenotypes().values() ) {
+            Map<String, Object> genotypeAttributes = subsetAttributes(g.commonInfo, keysToPreserve);
+            genotypes.put(g.getSampleName(),
+                    new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.getFilters(),
+                            genotypeAttributes, g.isPhased()));
         }
 
-        return mvc;
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(),
+                vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.getFilters(), attributes);
     }
 
     public enum GenotypeMergeType {
@@ -391,75 +392,6 @@ public class VariantContextUtils {
         KEEP_IF_ALL_UNFILTERED
     }
 
-    /**
-     * Performs a master merge on the VCs.  Here there is a master input [contains all of the information] and many
-     * VCs containing partial, extra genotype information which should be added to the master.  For example,
-     * we scatter out the phasing algorithm over some samples in the master, producing a minimal VCF with phasing
-     * information per genotype.  The master merge will add the PQ information from each genotype record, where
-     * appropriate, to the master VC.
-     *
-     * @param unsortedVCs   collection of VCs
-     * @param masterName    name of master VC
-     * @return  master-merged VC
-     */
-    public static VariantContext masterMerge(Collection<VariantContext> unsortedVCs, String masterName) {
-        VariantContext master = findMaster(unsortedVCs, masterName);
-        GenotypeMap genotypes = master.getGenotypes();
-        for (Genotype g : genotypes.values()) {
-            genotypes.put(g.getSampleName(), new MutableGenotype(g));
-        }
-
-        Map<String, Object> masterAttributes = new HashMap<String, Object>(master.getAttributes());
-
-        for (VariantContext vc : unsortedVCs) {
-            if (!vc.getSource().equals(masterName)) {
-                for (Genotype g : vc.getGenotypes().values()) {
-                    MutableGenotype masterG = (MutableGenotype) genotypes.get(g.getSampleName());
-                    for (Map.Entry<String, Object> attr : g.getAttributes().entrySet()) {
-                        if (!masterG.hasAttribute(attr.getKey())) {
-                            //System.out.printf("Adding GT attribute %s to masterG %s, new %s%n", attr, masterG, g);
-                            masterG.putAttribute(attr.getKey(), attr.getValue());
-                        }
-                    }
-
-                    if (masterG.isPhased() != g.isPhased()) {
-                        if (masterG.sameGenotype(g)) {
-                            // System.out.printf("Updating phasing %s to masterG %s, new %s%n", g.isPhased(), masterG, g);
-                            masterG.setAlleles(g.getAlleles());
-                            masterG.setPhase(g.isPhased());
-                        }
-                        //else System.out.println("WARNING: Not updating phase, since genotypes differ between master file and auxiliary info file!");
-                    }
-
-//                    if ( MathUtils.compareDoubles(masterG.getNegLog10PError(), g.getNegLog10PError()) != 0 ) {
-//                        System.out.printf("Updating GQ %s to masterG %s, new %s%n", g.getNegLog10PError(), masterG, g);
-//                        masterG.setNegLog10PError(g.getNegLog10PError());
-//                    }
-
-                }
-
-                for (Map.Entry<String, Object> attr : vc.getAttributes().entrySet()) {
-                    if (!masterAttributes.containsKey(attr.getKey())) {
-                        //System.out.printf("Adding VC attribute %s to master %s, new %s%n", attr, master, vc);
-                        masterAttributes.put(attr.getKey(), attr.getValue());
-                    }
-                }
-            }
-        }
-
-        return new VariantContext(master.getSource(), master.getChr(), master.getStart(), master.getEnd(), master.getAlleles(), genotypes, master.getNegLog10PError(), master.getFilters(), masterAttributes);
-    }
-
-    private static VariantContext findMaster(Collection<VariantContext> unsortedVCs, String masterName) {
-        for (VariantContext vc : unsortedVCs) {
-            if (vc.getSource().equals(masterName)) {
-                return vc;
-            }
-        }
-
-        throw new ReviewedStingException(String.format("Couldn't find master VCF %s at %s", masterName, unsortedVCs.iterator().next()));
-    }
-
     /**
      * Merges VariantContexts into a single hybrid.  Takes genotypes for common samples in priority order, if provided.
      * If uniqifySamples is true, the priority order is ignored and names are created by concatenating the VC name with
@@ -959,9 +891,8 @@ public class VariantContextUtils {
                 Genotype newG = g;
 
                 if ( uniqifySamples || alleleMapping.needsRemapping() ) {
-                    MutableGenotype mutG = new MutableGenotype(name, g);
-                    if ( alleleMapping.needsRemapping() ) mutG.setAlleles(alleleMapping.remap(g.getAlleles()));
-                    newG = mutG;
+                    final List<Allele> alleles = alleleMapping.needsRemapping() ? alleleMapping.remap(g.getAlleles()) : g.getAlleles();
+                    newG = new Genotype(name, alleles, g.getNegLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased());
                 }
 
                 mergedGenotypes.put(name, newG);

From 077397cb4b214c0a9d4a8a9db5fb619b0fd62319 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 14 Nov 2011 14:19:06 -0500
Subject: [PATCH 012/113] Deleted MutableVariantContext

-- All methods that used this capable now use VariantContext directly instead
---
 .../validation/GenotypeAndValidateWalker.java |   5 +-
 .../variantcontext/MutableVariantContext.java | 212 ------------------
 .../utils/variantcontext/VariantContext.java  |  10 +
 .../VariantContextUnitTest.java               |  20 +-
 .../VariantContextUtilsUnitTest.java          |   8 +-
 5 files changed, 22 insertions(+), 233 deletions(-)
 delete mode 100755 public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/GenotypeAndValidateWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/GenotypeAndValidateWalker.java
index e64d00bf5..8f9f3f1af 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/GenotypeAndValidateWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/GenotypeAndValidateWalker.java
@@ -39,7 +39,6 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFHeader;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLine;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFWriter;
-import org.broadinstitute.sting.utils.variantcontext.MutableVariantContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
@@ -466,9 +465,7 @@ public class GenotypeAndValidateWalker extends RodWalker<GenotypeAndValidateWalk
 
         if (vcfWriter != null && writeVariant) {
             if (!vcComp.hasAttribute("callStatus")) {
-                MutableVariantContext mvc = new MutableVariantContext(vcComp);
-                mvc.putAttribute("callStatus", call.isCalledAlt(callConf) ? "ALT" : "REF" );
-                vcfWriter.add(mvc);
+                vcfWriter.add(VariantContext.modifyAttribute(vcComp, "callStatus", call.isCalledAlt(callConf) ? "ALT" : "REF"));
             }
             else
                 vcfWriter.add(vcComp);
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java
deleted file mode 100755
index 5059fc81c..000000000
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/MutableVariantContext.java
+++ /dev/null
@@ -1,212 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext;
-
-
-import java.util.Collection;
-import java.util.Map;
-import java.util.Set;
-import java.util.TreeMap;
-
-/**
- * Mutable version of VariantContext
- *
- * @author depristo
- */
-public class MutableVariantContext extends VariantContext {
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // constructors
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
-    }
-
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeMap genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
-    }
-
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
-        super(source, contig, start, stop, alleles, NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        super(source, contig, start, stop, alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    public MutableVariantContext(VariantContext parent) {
-        super(parent.getSource(), parent.contig, parent.start, parent.stop, parent.getAlleles(), parent.getGenotypes(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.getReferenceBaseForIndel());
-    }
-
-    /**
-     * Sets the alleles segregating in this context to the collect of alleles.  Each of which must be unique according
-     * to equals() in Allele.  Validate() should be called when you are done modifying the context.
-     *
-     * @param alleles
-     */
-    public void setAlleles(Collection<Allele> alleles) {
-        this.alleles.clear();
-        for ( Allele a : alleles )
-            addAllele(a);
-    }
-
-    /**
-     * Adds allele to the segregating allele list in this context to the collection of alleles.  The new
-     * allele must be be unique according to equals() in Allele.
-     * Validate() should be called when you are done modifying the context.
-     *
-     * @param allele
-     */
-    public void addAllele(Allele allele) {
-        final boolean allowDuplicates = false;  // used to be a parameter
-
-        type = null;
-
-        for ( Allele a : alleles ) {
-            if ( a.basesMatch(allele) && ! allowDuplicates )
-                throw new IllegalArgumentException("Duplicate allele added to VariantContext" + this);
-        }
-
-        // we are a novel allele
-        alleles.add(allele);
-    }
-
-    public void clearGenotypes() {
-        genotypes = GenotypeMap.create();
-    }
-
-    /**
-     * Adds this single genotype to the context, not allowing duplicate genotypes to be added
-     * @param genotype
-     */
-    public void addGenotypes(Genotype genotype) {
-        putGenotype(genotype.getSampleName(), genotype, false);
-    }
-
-    /**
-     * Adds these genotypes to the context, not allowing duplicate genotypes to be added
-     * @param genotypes
-     */
-    public void addGenotypes(Collection<Genotype> genotypes) {
-        for ( Genotype g : genotypes ) {
-            addGenotype(g);
-        }
-    }
-
-    /**
-     * Adds these genotype to the context, not allowing duplicate genotypes to be added.
-     * @param genotypes
-     */
-    public void addGenotypes(Map<String, Genotype> genotypes) {
-        for ( Map.Entry<String, Genotype> elt : genotypes.entrySet() ) {
-            addGenotype(elt.getValue());
-        }
-    }
-
-    /**
-     * Adds these genotypes to the context.
-     *
-     * @param genotypes
-     */
-    public void putGenotypes(Map<String, Genotype> genotypes) {
-        for ( Map.Entry<String, Genotype> g : genotypes.entrySet() )
-            putGenotype(g.getKey(), g.getValue());
-    }
-
-    /**
-     * Adds these genotypes to the context.
-     *
-     * @param genotypes
-     */
-    public void putGenotypes(Collection<Genotype> genotypes) {
-        for ( Genotype g : genotypes )
-            putGenotype(g);
-    }
-
-    /**
-     * Adds this genotype to the context, throwing an error if it's already bound.
-     *
-     * @param genotype
-     */
-    public void addGenotype(Genotype genotype) {
-        addGenotype(genotype.getSampleName(), genotype);
-    }
-
-    /**
-     * Adds this genotype to the context, throwing an error if it's already bound.
-     *
-     * @param genotype
-     */
-    public void addGenotype(String sampleName, Genotype genotype) {
-        putGenotype(sampleName, genotype, false);
-    }
-
-    /**
-     * Adds this genotype to the context.
-     *
-     * @param genotype
-     */
-    public void putGenotype(Genotype genotype) {
-        putGenotype(genotype.getSampleName(), genotype);
-    }
-
-    /**
-     * Adds this genotype to the context.
-     *
-     * @param genotype
-     */
-    public void putGenotype(String sampleName, Genotype genotype) {
-        putGenotype(sampleName, genotype, true);
-    }
-
-    private void putGenotype(String sampleName, Genotype genotype, boolean allowOverwrites) {
-        if ( hasGenotype(sampleName) && ! allowOverwrites )
-            throw new IllegalStateException("Attempting to overwrite sample->genotype binding: " + sampleName + " this=" + this);
-
-        if ( ! sampleName.equals(genotype.getSampleName()) )
-            throw new IllegalStateException("Sample name doesn't equal genotype.getSample(): " + sampleName + " genotype=" + genotype);
-
-        this.genotypes.put(sampleName, genotype);
-    }
-
-    /**
-     * Removes the binding from sampleName to genotype.  If this doesn't exist, throws an IllegalArgumentException
-     * @param sampleName
-     */
-    public void removeGenotype(String sampleName) {
-        if ( ! this.genotypes.containsKey(sampleName) )
-            throw new IllegalArgumentException("Sample name isn't contained in genotypes " + sampleName + " genotypes =" + genotypes);
-
-        this.genotypes.remove(sampleName);
-    }
-
-    /**
-     * Removes genotype from the context.  If this doesn't exist, throws an IllegalArgumentException
-     * @param genotype
-     */
-    public void removeGenotype(Genotype genotype) {
-        removeGenotype(genotype.getSampleName());
-    }
-
-    // todo -- add replace genotype routine
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // InferredGeneticContext mutation operators
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public void setSource(String source)                { commonInfo.setName(source); }
-    public void addFilter(String filter)                { commonInfo.addFilter(filter); }
-    public void addFilters(Collection<String> filters)  { commonInfo.addFilters(filters); }
-    public void clearFilters()                          { commonInfo.clearFilters(); }
-    public void setFilters(Collection<String> filters)  { commonInfo.setFilters(filters); }
-    public void setAttributes(Map<String, ?> map)       { commonInfo.setAttributes(map); }
-    public void clearAttributes()                       { commonInfo.clearAttributes(); }
-    public void putAttribute(String key, Object value)  { commonInfo.putAttribute(key, value); }
-    public void removeAttribute(String key)             { commonInfo.removeAttribute(key); }
-    public void putAttributes(Map<String, ?> map)       { commonInfo.putAttributes(map); }
-    public void setNegLog10PError(double negLog10PError) { commonInfo.setNegLog10PError(negLog10PError); }
-    public void putAttribute(String key, Object value, boolean allowOverwrites) { commonInfo.putAttribute(key, value, allowOverwrites); }
-    public void setID(String id) { putAttribute(ID_KEY, id, true); }
-}
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 4682aad27..1766dc2bf 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -399,6 +399,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true);
     }
 
+    public static VariantContext modifyAttribute(VariantContext vc, final String key, final Object value) {
+        Map<String, Object> attributes = new HashMap<String, Object>(vc.getAttributes());
+        attributes.put(key, value);
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true);
+    }
+
     public static VariantContext modifyReferencePadding(VariantContext vc, Byte b) {
         return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), b, true);
     }
@@ -407,6 +413,10 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, negLog10PError, filters, attributes, vc.getReferenceBaseForIndel(), true);
     }
 
+    public static VariantContext modifyID(final VariantContext vc, final String id) {
+        return modifyAttribute(vc, ID_KEY, id);
+    }
+
     // ---------------------------------------------------------------------------------------------------------
     //
     // Selectors
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index a4d78b637..092bd362e 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -11,10 +11,7 @@ import org.testng.annotations.DataProvider;
 import org.testng.annotations.Test;
 import org.testng.Assert;
 
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.Collections;
-import java.util.List;
+import java.util.*;
 
 
 public class VariantContextUnitTest extends BaseTest {
@@ -402,29 +399,26 @@ public class VariantContextUnitTest extends BaseTest {
         List<Allele> alleles = Arrays.asList(Aref, T, del);
         Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
         Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
-        MutableVariantContext vc = new MutableVariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2));
+
+        VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2));
 
         Assert.assertTrue(vc.isNotFiltered());
         Assert.assertFalse(vc.isFiltered());
         Assert.assertEquals(0, vc.getFilters().size());
 
-        vc.addFilter("BAD_SNP_BAD!");
+        Set<String> filters = new HashSet<String>(Arrays.asList("BAD_SNP_BAD!"));
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2), VariantContext.NO_NEG_LOG_10PERROR, filters, null);
 
         Assert.assertFalse(vc.isNotFiltered());
         Assert.assertTrue(vc.isFiltered());
         Assert.assertEquals(1, vc.getFilters().size());
 
-        vc.addFilters(Arrays.asList("REALLY_BAD_SNP", "CHRIST_THIS_IS_TERRIBLE"));
+        filters = new HashSet<String>(Arrays.asList("BAD_SNP_BAD!", "REALLY_BAD_SNP", "CHRIST_THIS_IS_TERRIBLE"));
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2), VariantContext.NO_NEG_LOG_10PERROR, filters, null);
 
         Assert.assertFalse(vc.isNotFiltered());
         Assert.assertTrue(vc.isFiltered());
         Assert.assertEquals(3, vc.getFilters().size());
-
-        vc.clearFilters();
-
-        Assert.assertTrue(vc.isNotFiltered());
-        Assert.assertFalse(vc.isFiltered());
-        Assert.assertEquals(0, vc.getFilters().size());
     }
 
     @Test
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index bfda19b6b..48ddb7efc 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -245,13 +245,13 @@ public class VariantContextUtilsUnitTest extends BaseTest {
 
     @Test(dataProvider = "simplemergersiddata")
     public void testRSIDMerge(SimpleMergeRSIDTest cfg) {
-        final VariantContext snpVC1 = makeVC("snpvc1", Arrays.asList(Aref, T));
+        VariantContext snpVC1 = makeVC("snpvc1", Arrays.asList(Aref, T));
         final List<VariantContext> inputs = new ArrayList<VariantContext>();
 
         for ( final String id : cfg.inputs ) {
-            MutableVariantContext vc = new MutableVariantContext(snpVC1);
-            if ( ! id.equals(".") ) vc.setID(id);
-            inputs.add(vc);
+            if ( id.equals(".") )
+                snpVC1 = VariantContext.modifyID(snpVC1, id);
+            inputs.add(snpVC1);
         }
 
         final VariantContext merged = VariantContextUtils.simpleMerge(genomeLocParser,

From 9b5c79b49de7976fb167fb2c74985e2a3dcd36be Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 14 Nov 2011 14:28:52 -0500
Subject: [PATCH 013/113] Renamed InferredGeneticContext to CommonInfo

-- I have no idea why I named this InferredGeneticContext, a totally meaningless term
-- Renamed to CommonInfo.
-- Made package protected, as no one should use this outside of VariantContext and Genotype
-- UGEngine was using IGC constant, but it's now using the public one in VariantContext.
---
 .../genotyper/UnifiedGenotyperEngine.java     |  2 +-
 ...redGeneticContext.java => CommonInfo.java} |  4 +--
 .../sting/utils/variantcontext/Genotype.java  |  6 ++---
 .../utils/variantcontext/VariantContext.java  | 10 +++----
 .../variantcontext/VariantContextUtils.java   |  6 ++---
 .../VariantContextUnitTest.java               | 26 +++++++++----------
 6 files changed, 27 insertions(+), 27 deletions(-)
 rename public/java/src/org/broadinstitute/sting/utils/variantcontext/{InferredGeneticContext.java => CommonInfo.java} (98%)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
index bc9a5f65b..10bd7c8ae 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
@@ -229,7 +229,7 @@ public class UnifiedGenotyperEngine {
             VariantContext vcInput = UnifiedGenotyperEngine.getVCFromAllelesRod(tracker, ref, rawContext.getLocation(), false, logger, UAC.alleles);
             if ( vcInput == null )
                 return null;
-            vc = new VariantContext("UG_call", vcInput.getChr(), vcInput.getStart(), vcInput.getEnd(), vcInput.getAlleles(), InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, ref.getBase());
+            vc = new VariantContext("UG_call", vcInput.getChr(), vcInput.getStart(), vcInput.getEnd(), vcInput.getAlleles(), VariantContext.NO_NEG_LOG_10PERROR, null, null, ref.getBase());
 
         } else {
             // deal with bad/non-standard reference bases
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/InferredGeneticContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
similarity index 98%
rename from public/java/src/org/broadinstitute/sting/utils/variantcontext/InferredGeneticContext.java
rename to public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
index e7d9b3338..57edbbfcc 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/InferredGeneticContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
@@ -11,7 +11,7 @@ import java.util.*;
  *
  * @author depristo
  */
-public final class InferredGeneticContext {
+final class CommonInfo {
     public static final double NO_NEG_LOG_10PERROR = -1.0;
 
     private static Set<String> NO_FILTERS = Collections.unmodifiableSet(new HashSet<String>());
@@ -22,7 +22,7 @@ public final class InferredGeneticContext {
     private Set<String> filters = NO_FILTERS;
     private Map<String, Object> attributes = NO_ATTRIBUTES;
 
-    public InferredGeneticContext(String name, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+    public CommonInfo(String name, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this.name = name;
         setNegLog10PError(negLog10PError);
         if ( filters != null && ! filters.isEmpty() )
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
index eabd2dbad..28f2d85fc 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
@@ -17,8 +17,8 @@ public class Genotype {
     public final static String PHASED_ALLELE_SEPARATOR = "|";
     public final static String UNPHASED_ALLELE_SEPARATOR = "/";
 
-    protected InferredGeneticContext commonInfo;
-    public final static double NO_NEG_LOG_10PERROR = InferredGeneticContext.NO_NEG_LOG_10PERROR;
+    protected CommonInfo commonInfo;
+    public final static double NO_NEG_LOG_10PERROR = CommonInfo.NO_NEG_LOG_10PERROR;
     protected List<Allele> alleles = null; // new ArrayList<Allele>();
     protected Type type = null;
 
@@ -32,7 +32,7 @@ public class Genotype {
     public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, boolean isPhased, double[] log10Likelihoods) {
         if ( alleles != null )
             this.alleles = Collections.unmodifiableList(alleles);
-        commonInfo = new InferredGeneticContext(sampleName, negLog10PError, filters, attributes);
+        commonInfo = new CommonInfo(sampleName, negLog10PError, filters, attributes);
         if ( log10Likelihoods != null )
             commonInfo.putAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, GenotypeLikelihoods.fromLog10Likelihoods(log10Likelihoods));
         filtersWereAppliedToContext = filters != null;
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 1766dc2bf..47b792e0b 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -162,8 +162,8 @@ import java.util.*;
  * @author depristo
  */
 public class VariantContext implements Feature { // to enable tribble intergration
-    protected InferredGeneticContext commonInfo = null;
-    public final static double NO_NEG_LOG_10PERROR = InferredGeneticContext.NO_NEG_LOG_10PERROR;
+    protected CommonInfo commonInfo = null;
+    public final static double NO_NEG_LOG_10PERROR = CommonInfo.NO_NEG_LOG_10PERROR;
     public final static String UNPARSED_GENOTYPE_MAP_KEY = "_UNPARSED_GENOTYPE_MAP_";
     public final static String UNPARSED_GENOTYPE_PARSER_KEY = "_UNPARSED_GENOTYPE_PARSER_";
     public final static String ID_KEY = "ID";
@@ -293,7 +293,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param alleles alleles
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
-        this(source, contig, start, stop, alleles, NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, null, false);
+        this(source, contig, start, stop, alleles, NO_GENOTYPES, CommonInfo.NO_NEG_LOG_10PERROR, null, null, null, false);
     }
 
     /**
@@ -307,7 +307,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param genotypes genotypes
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        this(source, contig, start, stop, alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
+        this(source, contig, start, stop, alleles, genotypes, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
     }
 
     /**
@@ -350,7 +350,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
                 attributes.remove(UNPARSED_GENOTYPE_PARSER_KEY);
         }
 
-        this.commonInfo = new InferredGeneticContext(source, negLog10PError, filters, attributes);
+        this.commonInfo = new CommonInfo(source, negLog10PError, filters, attributes);
         filtersWereAppliedToContext = filters != null;
         REFERENCE_BASE_FOR_INDEL = referenceBaseForIndel;
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 996628b23..37d8acbe2 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -81,7 +81,7 @@ public class VariantContextUtils {
      * @return VariantContext object
      */
     public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles) {
-        return new VariantContext (name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, VariantContext.NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
+        return new VariantContext (name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, VariantContext.NO_GENOTYPES, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
     }
 
     /**
@@ -93,7 +93,7 @@ public class VariantContextUtils {
      * @return VariantContext object
      */
     public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
+        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
     }
 
     /**
@@ -330,7 +330,7 @@ public class VariantContextUtils {
         return pruneVariantContext(vc, null);
     }
 
-    private final static Map<String, Object> subsetAttributes(final InferredGeneticContext igc, final Collection<String> keysToPreserve) {
+    private final static Map<String, Object> subsetAttributes(final CommonInfo igc, final Collection<String> keysToPreserve) {
         Map<String, Object> attributes = new HashMap<String, Object>(keysToPreserve.size());
         for ( final String key : keysToPreserve  ) {
             if ( igc.hasAttribute(key) )
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index 092bd362e..77980267c 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -90,45 +90,45 @@ public class VariantContextUnitTest extends BaseTest {
 
         // test INDELs
         alleles = Arrays.asList(Aref, ATC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(Tref, TA, TC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A, AC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A, Allele.create("ATCTC"));
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         // test MIXED
         alleles = Arrays.asList(TAref, T, TC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(TAref, T, AC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(ACref, ATC, AT);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(Aref, T, symbolic);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         // test SYMBOLIC
         alleles = Arrays.asList(Tref, symbolic);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.SYMBOLIC);
     }
 
@@ -199,7 +199,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingDeletionVariantContext() {
         List<Allele> alleles = Arrays.asList(ATCref, del);
-        VariantContext vc = new VariantContext("test", delLoc, delLocStart, delLocStop, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        VariantContext vc = new VariantContext("test", delLoc, delLocStart, delLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getChr(), delLoc);
         Assert.assertEquals(vc.getStart(), delLocStart);
@@ -226,7 +226,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingInsertionVariantContext() {
         List<Allele> alleles = Arrays.asList(delRef, ATC);
-        VariantContext vc = new VariantContext("test", insLoc, insLocStart, insLocStop, alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        VariantContext vc = new VariantContext("test", insLoc, insLocStart, insLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getChr(), insLoc);
         Assert.assertEquals(vc.getStart(), insLocStart);
@@ -514,7 +514,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test(dataProvider = "getAlleles")
     public void testMergeAlleles(GetAllelesTest cfg) {
         final List<Allele> altAlleles = cfg.alleles.subList(1, cfg.alleles.size());
-        final VariantContext vc = new VariantContext("test", snpLoc, snpLocStart, snpLocStop, cfg.alleles, null, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        final VariantContext vc = new VariantContext("test", snpLoc, snpLocStart, snpLocStop, cfg.alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getAlleles(), cfg.alleles, "VC alleles not the same as input alleles");
         Assert.assertEquals(vc.getNAlleles(), cfg.alleles.size(), "VC getNAlleles not the same as input alleles size");

From 7b2a7cfbe763cfa8aeca37205dfe9b1ffedee094 Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Mon, 14 Nov 2011 14:31:27 -0500
Subject: [PATCH 014/113] Transfer headers from the resource VCF when possible
 when using expressions.  While there, VA was modified so that it didn't
 assume that the ID field was present in the VC's info map in preparation for
 Mark's upcoming changes.

---
 .../walkers/annotator/VariantAnnotator.java   | 25 +++++++++++++++++--
 .../annotator/VariantAnnotatorEngine.java     | 23 +++++++++++------
 .../VariantAnnotatorIntegrationTest.java      |  2 +-
 3 files changed, 39 insertions(+), 11 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotator.java
index ea11391d9..20e72dd57 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotator.java
@@ -222,8 +222,29 @@ public class VariantAnnotator extends RodWalker<Integer, Integer> implements Ann
             if ( isUniqueHeaderLine(line, hInfo) )
                 hInfo.add(line);
         }
-        for ( String expression : expressionsToUse )
-            hInfo.add(new VCFInfoHeaderLine(expression, VCFHeaderLineCount.UNBOUNDED, VCFHeaderLineType.String, "Value transferred from another external VCF resource"));
+        // for the expressions, pull the info header line from the header of the resource rod
+        for ( VariantAnnotatorEngine.VAExpression expression : engine.getRequestedExpressions() ) {
+            // special case the ID field
+            if ( expression.fieldName.equals("ID") ) {
+                hInfo.add(new VCFInfoHeaderLine(expression.fullName, 1, VCFHeaderLineType.String, "ID field transferred from external VCF resource"));
+                continue;
+            }
+            VCFInfoHeaderLine targetHeaderLine = null;
+            for ( VCFHeaderLine line : VCFUtils.getHeaderFields(getToolkit(), Arrays.asList(expression.binding.getName())) ) {
+                if ( line instanceof VCFInfoHeaderLine ) {
+                    VCFInfoHeaderLine infoline = (VCFInfoHeaderLine)line;
+                    if ( infoline.getName().equals(expression.fieldName) ) {
+                        targetHeaderLine = infoline;
+                        break;
+                    }
+                }
+            }
+
+            if ( targetHeaderLine != null )
+                hInfo.add(new VCFInfoHeaderLine(expression.fullName, targetHeaderLine.getCountType(), targetHeaderLine.getType(), targetHeaderLine.getDescription()));
+            else
+                hInfo.add(new VCFInfoHeaderLine(expression.fullName, VCFHeaderLineCount.UNBOUNDED, VCFHeaderLineType.String, "Value transferred from another external VCF resource"));
+        }
 
         engine.invokeAnnotationInitializationMethods(hInfo);
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
index e4bc0d5d5..20f28007a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
@@ -49,20 +49,20 @@ public class VariantAnnotatorEngine {
     private AnnotatorCompatibleWalker walker;
     private GenomeAnalysisEngine toolkit;
 
-    private static class VAExpression {
+    protected static class VAExpression {
 
         public String fullName, fieldName;
         public RodBinding<VariantContext> binding;
 
-        public VAExpression(String fullEpression, List<RodBinding<VariantContext>> bindings) {
-            int indexOfDot = fullEpression.lastIndexOf(".");
+        public VAExpression(String fullExpression, List<RodBinding<VariantContext>> bindings) {
+            int indexOfDot = fullExpression.lastIndexOf(".");
             if ( indexOfDot == -1 )
-                throw new UserException.BadArgumentValue(fullEpression, "it should be in rodname.value format");
+                throw new UserException.BadArgumentValue(fullExpression, "it should be in rodname.value format");
 
-            fullName = fullEpression;
-            fieldName = fullEpression.substring(indexOfDot+1);
+            fullName = fullExpression;
+            fieldName = fullExpression.substring(indexOfDot+1);
 
-            String bindingName = fullEpression.substring(0, indexOfDot);
+            String bindingName = fullExpression.substring(0, indexOfDot);
             for ( RodBinding<VariantContext> rod : bindings ) {
                 if ( rod.getName().equals(bindingName) ) {
                     binding = rod;
@@ -97,6 +97,8 @@ public class VariantAnnotatorEngine {
             requestedExpressions.add(new VAExpression(expression, walker.getResourceRodBindings()));
     }
 
+    protected List<VAExpression> getRequestedExpressions() { return requestedExpressions; }
+
     private void initializeAnnotations(List<String> annotationGroupsToUse, List<String> annotationsToUse, List<String> annotationsToExclude) {
         AnnotationInterfaceManager.validateAnnotations(annotationGroupsToUse, annotationsToUse);
         requestedInfoAnnotations = AnnotationInterfaceManager.createInfoFieldAnnotations(annotationGroupsToUse, annotationsToUse);
@@ -211,8 +213,13 @@ public class VariantAnnotatorEngine {
                 continue;
 
             VariantContext vc = VCs.iterator().next();
-            if ( vc.hasAttribute(expression.fieldName) )
+            // special-case the ID field
+            if ( expression.fieldName.equals("ID") ) {
+                if ( vc.hasID() )
+                    infoAnnotations.put(expression.fullName, vc.getID());
+            } else if ( vc.hasAttribute(expression.fieldName) ) {
                 infoAnnotations.put(expression.fullName, vc.getAttribute(expression.fieldName));
+            }
         }
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
index 189f643d4..bde4c4a8f 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
@@ -128,7 +128,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testUsingExpressionWithID() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --resource:foo " + validationDataLocation + "targetAnnotations.vcf -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample3empty.vcf -E foo.ID -L " + validationDataLocation + "vcfexample3empty.vcf", 1,
-                Arrays.asList("4a6f0675242f685e9072c1da5ad9e715"));
+                Arrays.asList("1b4921085b26cbfe07d53b7c947de1e5"));
         executeTest("using expression with ID", spec);
     }
 

From 4dc9dbe890480eea992d89f740fe20f06bd2a086 Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Mon, 14 Nov 2011 14:42:12 -0500
Subject: [PATCH 015/113] One quick fix to previous commit

---
 .../sting/gatk/walkers/annotator/VariantAnnotator.java | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotator.java
index 20e72dd57..c9ea7a3b5 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotator.java
@@ -240,10 +240,14 @@ public class VariantAnnotator extends RodWalker<Integer, Integer> implements Ann
                 }
             }
 
-            if ( targetHeaderLine != null )
-                hInfo.add(new VCFInfoHeaderLine(expression.fullName, targetHeaderLine.getCountType(), targetHeaderLine.getType(), targetHeaderLine.getDescription()));
-            else
+            if ( targetHeaderLine != null ) {
+                if ( targetHeaderLine.getCountType() == VCFHeaderLineCount.INTEGER )
+                    hInfo.add(new VCFInfoHeaderLine(expression.fullName, targetHeaderLine.getCount(), targetHeaderLine.getType(), targetHeaderLine.getDescription()));
+                else
+                    hInfo.add(new VCFInfoHeaderLine(expression.fullName, targetHeaderLine.getCountType(), targetHeaderLine.getType(), targetHeaderLine.getDescription()));
+            } else {
                 hInfo.add(new VCFInfoHeaderLine(expression.fullName, VCFHeaderLineCount.UNBOUNDED, VCFHeaderLineType.String, "Value transferred from another external VCF resource"));
+            }
         }
 
         engine.invokeAnnotationInitializationMethods(hInfo);

From 1fbdcb4f43a51ffea081241e8d06be63a9a23a50 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 14 Nov 2011 15:32:03 -0500
Subject: [PATCH 017/113] GenotypeMap -> GenotypeCollection

---
 .../gatk/refdata/VariantContextAdaptors.java  |   4 +-
 .../gatk/walkers/annotator/AlleleBalance.java |  14 +-
 .../gatk/walkers/annotator/HardyWeinberg.java |   8 +-
 .../walkers/annotator/InbreedingCoeff.java    |   4 +-
 .../gatk/walkers/annotator/QualByDepth.java   |   4 +-
 .../gatk/walkers/annotator/RankSumTest.java   |   4 +-
 .../annotator/VariantAnnotatorEngine.java     |   6 +-
 .../beagle/BeagleOutputToVCFWalker.java       |   4 +-
 .../filters/VariantFiltrationWalker.java      |   6 +-
 .../AlleleFrequencyCalculationModel.java      |   7 +-
 .../genotyper/ExactAFCalculationModel.java    |  10 +-
 .../genotyper/GridSearchAFEstimation.java     |   8 +-
 .../walkers/genotyper/UGCallVariants.java     |   4 +-
 .../genotyper/UnifiedGenotyperEngine.java     |   6 +-
 .../indels/SomaticIndelDetectorWalker.java    |   6 +-
 .../walkers/phasing/PhaseByTransmission.java  |  10 +-
 .../phasing/ReadBackedPhasingWalker.java      |   6 +-
 .../evaluators/GenotypePhasingEvaluator.java  |   6 +-
 .../variantutils/LeftAlignVariants.java       |   4 +-
 .../walkers/variantutils/SelectVariants.java  |   4 +-
 .../walkers/variantutils/VariantsToVCF.java   |   2 +-
 .../utils/codecs/vcf/AbstractVCFCodec.java    |   5 +-
 .../sting/utils/codecs/vcf/VCF3Codec.java     |   7 +-
 .../sting/utils/codecs/vcf/VCFCodec.java      |   7 +-
 .../sting/utils/codecs/vcf/VCFParser.java     |   6 +-
 .../broadinstitute/sting/utils/gcf/GCF.java   |   8 +-
 .../variantcontext/GenotypeCollection.java    | 325 ++++++++++++++++++
 .../utils/variantcontext/GenotypeMap.java     | 191 ----------
 .../utils/variantcontext/VariantContext.java  |  28 +-
 .../variantcontext/VariantContextUtils.java   |  20 +-
 .../utils/genotype/vcf/VCFWriterUnitTest.java |   4 +-
 .../VariantContextUtilsUnitTest.java          |   2 +-
 32 files changed, 424 insertions(+), 306 deletions(-)
 create mode 100644 public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index c4ba5d6d1..523da7492 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -194,7 +194,7 @@ public class VariantContextAdaptors {
                     return null; // we weren't given enough reference context to create the VariantContext
                 Byte refBaseForIndel = new Byte(ref.getBases()[index]);
 
-                GenotypeMap genotypes = null;
+                GenotypeCollection genotypes = null;
                 VariantContext vc = new VariantContext(name, dbsnp.getChr(), dbsnp.getStart() - (sawNullAllele ? 1 : 0), dbsnp.getEnd() - (refAllele.isNull() ? 1 : 0), alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, attributes, refBaseForIndel);
                 return vc;
             } else
@@ -324,7 +324,7 @@ public class VariantContextAdaptors {
             String[] samples = hapmap.getSampleIDs();
             String[] genotypeStrings = hapmap.getGenotypes();
 
-            GenotypeMap genotypes = GenotypeMap.create(samples.length);
+            GenotypeCollection genotypes = GenotypeCollection.create(samples.length);
             for ( int i = 0; i < samples.length; i++ ) {
                 // ignore bad genotypes
                 if ( genotypeStrings[i].contains("N") )
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
index 297490172..c345c8741 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
@@ -35,7 +35,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.pileup.ReadBackedExtendedEventPileup;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -55,18 +55,18 @@ public class AlleleBalance extends InfoFieldAnnotation {
         
         if ( !vc.isBiallelic() )
             return null;
-        final GenotypeMap genotypes = vc.getGenotypes();
+        final GenotypeCollection genotypes = vc.getGenotypes();
         if ( !vc.hasGenotypes() )
             return null;
 
         double ratio = 0.0;
         double totalWeights = 0.0;
-        for ( Map.Entry<String, Genotype> genotype : genotypes.entrySet() ) {
+        for ( Genotype genotype : genotypes ) {
             // we care only about het calls
-            if ( !genotype.getValue().isHet() )
+            if ( !genotype.isHet() )
                 continue;
 
-            AlignmentContext context = stratifiedContexts.get(genotype.getKey());
+            AlignmentContext context = stratifiedContexts.get(genotype.getSampleName());
             if ( context == null )
                 continue;
 
@@ -85,8 +85,8 @@ public class AlleleBalance extends InfoFieldAnnotation {
                     continue;
 
                 // weight the allele balance by genotype quality so that e.g. mis-called homs don't affect the ratio too much
-                ratio += genotype.getValue().getNegLog10PError() * ((double)refCount / (double)(refCount + altCount));
-                totalWeights += genotype.getValue().getNegLog10PError();
+                ratio += genotype.getNegLog10PError() * ((double)refCount / (double)(refCount + altCount));
+                totalWeights += genotype.getNegLog10PError();
             } else if ( vc.isIndel() && context.hasExtendedEventPileup() ) {
                 final ReadBackedExtendedEventPileup indelPileup = context.getExtendedEventPileup();
                 if ( indelPileup == null ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
index 6352fcf2a..164c77d1c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
@@ -11,7 +11,7 @@ import org.broadinstitute.sting.utils.QualityUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -31,16 +31,14 @@ public class HardyWeinberg extends InfoFieldAnnotation implements WorkInProgress
 
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
 
-        final GenotypeMap genotypes = vc.getGenotypes();
+        final GenotypeCollection genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() < MIN_SAMPLES )
             return null;
 
         int refCount = 0;
         int hetCount = 0;
         int homCount = 0;
-        for ( Map.Entry<String, Genotype> genotype : genotypes.entrySet() ) {
-            Genotype g = genotype.getValue();
-
+        for ( final Genotype g : genotypes ) {
             if ( g.isNoCall() )
                 continue;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
index 9935eced9..a21d7106c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
@@ -10,7 +10,7 @@ import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -33,7 +33,7 @@ public class InbreedingCoeff extends InfoFieldAnnotation implements StandardAnno
 
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
 
-        final GenotypeMap genotypes = vc.getGenotypes();
+        final GenotypeCollection genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() < MIN_SAMPLES )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
index e34ef5d45..dae041155 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
@@ -9,7 +9,7 @@ import org.broadinstitute.sting.gatk.walkers.annotator.interfaces.StandardAnnota
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -29,7 +29,7 @@ public class QualByDepth extends InfoFieldAnnotation implements StandardAnnotati
         if ( stratifiedContexts.size() == 0 )
             return null;
 
-        final GenotypeMap genotypes = vc.getGenotypes();
+        final GenotypeCollection genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() == 0 )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
index f75997d57..8182747f4 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
@@ -13,7 +13,7 @@ import org.broadinstitute.sting.utils.collections.Pair;
 import org.broadinstitute.sting.utils.pileup.PileupElement;
 import org.broadinstitute.sting.utils.pileup.ReadBackedPileup;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.ArrayList;
@@ -33,7 +33,7 @@ public abstract class RankSumTest extends InfoFieldAnnotation implements Standar
         if ( stratifiedContexts.size() == 0 )
             return null;
          
-        final GenotypeMap genotypes = vc.getGenotypes();
+        final GenotypeCollection genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() == 0 )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
index 87b1366cf..9fb25d605 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
@@ -34,7 +34,7 @@ import org.broadinstitute.sting.gatk.walkers.annotator.interfaces.*;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.*;
@@ -217,11 +217,11 @@ public class VariantAnnotatorEngine {
         }
     }
 
-    private GenotypeMap annotateGenotypes(RefMetaDataTracker tracker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
+    private GenotypeCollection annotateGenotypes(RefMetaDataTracker tracker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
         if ( requestedGenotypeAnnotations.size() == 0 )
             return vc.getGenotypes();
 
-        GenotypeMap genotypes = GenotypeMap.create(vc.getNSamples());
+        GenotypeCollection genotypes = GenotypeCollection.create(vc.getNSamples());
         for ( Map.Entry<String, Genotype> g : vc.getGenotypes().entrySet() ) {
             Genotype genotype = g.getValue();
             AlignmentContext context = stratifiedContexts.get(g.getKey());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index 352b1790e..89dd114cc 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -187,7 +187,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         byte refByte = ref.getBase();
 
         // make new Genotypes based on Beagle results
-        GenotypeMap genotypes = GenotypeMap.create(vc_input.getGenotypes().size());
+        GenotypeCollection genotypes = GenotypeCollection.create(vc_input.getGenotypes().size());
 
         // for each genotype, create a new object with Beagle information on it
 
@@ -196,7 +196,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         Double alleleFrequencyH = 0.0;
         int beagleVarCounts = 0;
 
-        GenotypeMap hapmapGenotypes = null;
+        GenotypeCollection hapmapGenotypes = null;
 
         if (vc_comp != null) {
             hapmapGenotypes = vc_comp.getGenotypes();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
index 9428fd7ee..c1fbc9ac6 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
@@ -37,7 +37,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
@@ -283,11 +283,11 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
         VariantContext vc = context.getVariantContext();
 
         // make new Genotypes based on filters
-        GenotypeMap genotypes;
+        GenotypeCollection genotypes;
         if ( genotypeFilterExps.size() == 0 ) {
             genotypes = null;
         } else {
-            genotypes = GenotypeMap.create(vc.getGenotypes().size());
+            genotypes = GenotypeCollection.create(vc.getGenotypes().size());
 
             // for each genotype, check filters then create a new object
             for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
index 2bee98879..d0f45092b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
@@ -26,17 +26,14 @@
 package org.broadinstitute.sting.gatk.walkers.genotyper;
 
 import org.apache.log4j.Logger;
-import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
-import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
 import java.util.List;
 import java.util.Map;
-import java.util.Set;
 
 
 /**
@@ -86,7 +83,7 @@ public abstract class AlleleFrequencyCalculationModel implements Cloneable {
      *
      * @return calls
      */
-    protected abstract GenotypeMap assignGenotypes(VariantContext vc,
+    protected abstract GenotypeCollection assignGenotypes(VariantContext vc,
                                                    double[] log10AlleleFrequencyPosteriors,
                                                    int AFofMaxLikelihood);
 }
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index 0e3062cfc..bb2516f7c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -26,14 +26,12 @@
 package org.broadinstitute.sting.gatk.walkers.genotyper;
 
 import org.apache.log4j.Logger;
-import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
-import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
 import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.Utils;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
@@ -269,14 +267,14 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
      *
      * @return calls
      */
-    public GenotypeMap assignGenotypes(VariantContext vc,
+    public GenotypeCollection assignGenotypes(VariantContext vc,
                                        double[] log10AlleleFrequencyPosteriors,
                                        int AFofMaxLikelihood) {
         if ( !vc.isVariant() )
             throw new UserException("The VCF record passed in does not contain an ALT allele at " + vc.getChr() + ":" + vc.getStart());
 
 
-        GenotypeMap GLs = vc.getGenotypes();
+        GenotypeCollection GLs = vc.getGenotypes();
         double[][] pathMetricArray = new double[GLs.size()+1][AFofMaxLikelihood+1];
         int[][] tracebackArray = new int[GLs.size()+1][AFofMaxLikelihood+1];
 
@@ -343,7 +341,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
             }
         }
 
-        GenotypeMap calls = GenotypeMap.create();
+        GenotypeCollection calls = GenotypeCollection.create();
 
         int startIdx = AFofMaxLikelihood;
         for (int k = sampleIdx; k > 0; k--) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java
index bb31045a7..48df8dcb9 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java
@@ -26,15 +26,13 @@
 package org.broadinstitute.sting.gatk.walkers.genotyper;
 
 import org.apache.log4j.Logger;
-import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
-import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
 import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.collections.Pair;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
@@ -90,7 +88,7 @@ public class GridSearchAFEstimation extends AlleleFrequencyCalculationModel {
      *
      * @return calls
      */
-    protected GenotypeMap assignGenotypes(VariantContext vc,
+    protected GenotypeCollection assignGenotypes(VariantContext vc,
                                           double[] log10AlleleFrequencyPosteriors,
                                           int AFofMaxLikelihood) {
         if ( !vc.isVariant() )
@@ -98,7 +96,7 @@ public class GridSearchAFEstimation extends AlleleFrequencyCalculationModel {
 
         Allele refAllele = vc.getReference();
         Allele altAllele = vc.getAlternateAllele(0);
-        GenotypeMap calls = GenotypeMap.create();
+        GenotypeCollection calls = GenotypeCollection.create();
 
         // first, the potential alt calls
         for ( String sample : AFMatrix.getSamples() ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
index c54089350..81310f15a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
@@ -36,7 +36,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
@@ -129,7 +129,7 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
             return null;
 
         VariantContext variantVC = null;
-        GenotypeMap genotypes = GenotypeMap.create();
+        GenotypeCollection genotypes = GenotypeCollection.create();
         for ( VariantContext vc : VCs ) {
             if ( variantVC == null && vc.isVariant() )
                 variantVC = vc;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
index 10bd7c8ae..72b88100b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
@@ -265,7 +265,7 @@ public class UnifiedGenotyperEngine {
         alleles.add(refAllele);
         boolean addedAltAlleles = false;
 
-        GenotypeMap genotypes = GenotypeMap.create();
+        GenotypeCollection genotypes = GenotypeCollection.create();
         for ( MultiallelicGenotypeLikelihoods GL : GLs.values() ) {
             if ( !addedAltAlleles ) {
                 addedAltAlleles = true;
@@ -354,7 +354,7 @@ public class UnifiedGenotyperEngine {
         }
 
         // create the genotypes
-        GenotypeMap genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
+        GenotypeCollection genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
 
         // print out stats if we have a writer
         if ( verboseWriter != null )
@@ -491,7 +491,7 @@ public class UnifiedGenotyperEngine {
         }
 
         // create the genotypes
-        GenotypeMap genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
+        GenotypeCollection genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
 
         // *** note that calculating strand bias involves overwriting data structures, so we do that last
         HashMap<String, Object> attributes = new HashMap<String, Object>();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
index ee5562ba2..7425258d4 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
@@ -60,7 +60,7 @@ import org.broadinstitute.sting.utils.sam.AlignmentUtils;
 import org.broadinstitute.sting.utils.sam.GATKSAMRecord;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -1058,7 +1058,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
             stop += event_length;
         }
 
-        GenotypeMap genotypes = GenotypeMap.create();
+        GenotypeCollection genotypes = GenotypeCollection.create();
 
         for ( String sample : normalSamples ) {
 
@@ -1148,7 +1148,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
         homRefAlleles.add( alleles.get(0));
         homRefAlleles.add( alleles.get(0));
 
-        GenotypeMap genotypes = GenotypeMap.create();
+        GenotypeCollection genotypes = GenotypeCollection.create();
 
         for ( String sample : normalSamples ) {
             genotypes.put(sample,new Genotype(sample, homRefN ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsNormal,false));
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
index 6b52fcf62..b35c54f94 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
@@ -293,7 +293,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
         if (tracker != null) {
             VariantContext vc = tracker.getFirstValue(variantCollection.variants, context.getLocation());
 
-            GenotypeMap genotypeMap = vc.getGenotypes();
+            GenotypeCollection genotypeCollection = vc.getGenotypes();
 
             for (Trio trio : trios) {
                 Genotype mother = vc.getGenotype(trio.getMother());
@@ -306,12 +306,12 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
                 Genotype phasedFather = trioGenotypes.get(1);
                 Genotype phasedChild = trioGenotypes.get(2);
 
-                genotypeMap.put(phasedMother.getSampleName(), phasedMother);
-                genotypeMap.put(phasedFather.getSampleName(), phasedFather);
-                genotypeMap.put(phasedChild.getSampleName(), phasedChild);
+                genotypeCollection.put(phasedMother.getSampleName(), phasedMother);
+                genotypeCollection.put(phasedFather.getSampleName(), phasedFather);
+                genotypeCollection.put(phasedChild.getSampleName(), phasedChild);
             }
 
-            VariantContext newvc = VariantContext.modifyGenotypes(vc, genotypeMap);
+            VariantContext newvc = VariantContext.modifyGenotypes(vc, genotypeCollection);
 
             vcfWriter.add(newvc);
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index 2aa96379c..132ed1582 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -352,7 +352,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         UnfinishedVariantContext uvc = uvr.unfinishedVariant;
 
         // Perform per-sample phasing:
-        GenotypeMap sampGenotypes = vc.getGenotypes();
+        GenotypeCollection sampGenotypes = vc.getGenotypes();
         Map<String, PhaseCounts> samplePhaseStats = new TreeMap<String, PhaseCounts>();
         for (Map.Entry<String, Genotype> sampGtEntry : sampGenotypes.entrySet()) {
             String samp = sampGtEntry.getKey();
@@ -1123,7 +1123,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         private int start;
         private int stop;
         private Collection<Allele> alleles;
-        private GenotypeMap genotypes;
+        private GenotypeCollection genotypes;
         private double negLog10PError;
         private Set<String> filters;
         private Map<String, Object> attributes;
@@ -1134,7 +1134,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
             this.start = vc.getStart();
             this.stop = vc.getEnd();
             this.alleles = vc.getAlleles();
-            this.genotypes = GenotypeMap.create(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
+            this.genotypes = GenotypeCollection.create(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
             this.negLog10PError = vc.getNegLog10PError();
             this.filters = vc.filtersWereApplied() ? vc.getFilters() : null;
             this.attributes = new HashMap<String, Object>(vc.getAttributes());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
index ad9ad62b3..08d62154d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
@@ -14,7 +14,7 @@ import org.broadinstitute.sting.gatk.walkers.varianteval.util.TableType;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.HashMap;
@@ -92,13 +92,13 @@ public class GenotypePhasingEvaluator extends VariantEvaluator {
 
         Set<String> allSamples = new HashSet<String>();
 
-        GenotypeMap compSampGenotypes = null;
+        GenotypeCollection compSampGenotypes = null;
         if (isRelevantToPhasing(comp)) {
             allSamples.addAll(comp.getSampleNames());
             compSampGenotypes = comp.getGenotypes();
         }
 
-        GenotypeMap evalSampGenotypes = null;
+        GenotypeCollection evalSampGenotypes = null;
         if (isRelevantToPhasing(eval)) {
             allSamples.addAll(eval.getSampleNames());
             evalSampGenotypes = eval.getGenotypes();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
index 64f54e611..f87ec5d3b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
@@ -40,7 +40,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.sam.AlignmentUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.*;
@@ -211,7 +211,7 @@ public class LeftAlignVariants extends RodWalker<Integer, Integer> {
         }
 
         // create new Genotype objects
-        GenotypeMap newGenotypes = GenotypeMap.create(vc.getNSamples());
+        GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
         for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
             List<Allele> newAlleles = new ArrayList<Allele>();
             for ( Allele allele : genotype.getValue().getAlleles() ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index 3c5a55134..3764a9998 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -24,10 +24,8 @@
 
 package org.broadinstitute.sting.gatk.walkers.variantutils;
 
-import org.apache.poi.hpsf.Variant;
 import org.broadinstitute.sting.commandline.*;
 import org.broadinstitute.sting.gatk.arguments.StandardVariantContextInputArgumentCollection;
-import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.text.XReadLines;
@@ -558,7 +556,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
             return (compVCs == null || compVCs.isEmpty());
 
         // check if we find it in the variant rod
-        GenotypeMap genotypes = vc.getGenotypes(samples);
+        GenotypeCollection genotypes = vc.getGenotypes(samples);
         for (Genotype g : genotypes.values()) {
             if (sampleHasVariant(g)) {
                 // There is a variant called (or filtered with not exclude filtered option set) that is not HomRef for at least one of the samples.
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
index 7f1fc9d16..ff7fb3434 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
@@ -130,7 +130,7 @@ public class VariantsToVCF extends RodWalker<Integer, Integer> {
             // set the appropriate sample name if necessary
             if ( sampleName != null && vc.hasGenotypes() && vc.hasGenotype(variants.getName()) ) {
                 Genotype g = Genotype.modifyName(vc.getGenotype(variants.getName()), sampleName);
-                GenotypeMap genotypes = GenotypeMap.create(1);
+                GenotypeCollection genotypes = GenotypeCollection.create(1);
                 genotypes.put(sampleName, g);
                 vc = VariantContext.modifyGenotypes(vc, genotypes);
             }
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index c285a9f68..ad14e059b 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -11,8 +11,7 @@ import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -77,7 +76,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public abstract GenotypeMap createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+    public abstract GenotypeCollection createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
 
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
index fcfc0c6fc..302b93da7 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
@@ -5,11 +5,10 @@ import org.broad.tribble.readers.LineReader;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.File;
-import java.io.FileReader;
 import java.io.IOException;
 import java.util.*;
 
@@ -119,13 +118,13 @@ public class VCF3Codec extends AbstractVCFCodec {
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public GenotypeMap createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+    public GenotypeCollection createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
         if (genotypeParts == null)
             genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
 
         int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
 
-        GenotypeMap genotypes = GenotypeMap.create(nParts);
+        GenotypeCollection genotypes = GenotypeCollection.create(nParts);
 
         // get the format keys
         int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
index eefb929bb..8256c9cac 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
@@ -5,11 +5,10 @@ import org.broad.tribble.readers.LineReader;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.File;
-import java.io.FileReader;
 import java.io.IOException;
 import java.util.*;
 
@@ -146,13 +145,13 @@ public class VCFCodec extends AbstractVCFCodec {
      * @param alleles the list of alleles
      * @return a mapping of sample name to genotype object
      */
-    public GenotypeMap createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+    public GenotypeCollection createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
         if (genotypeParts == null)
             genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
 
         int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
 
-        GenotypeMap genotypes = GenotypeMap.create(nParts);
+        GenotypeCollection genotypes = GenotypeCollection.create(nParts);
 
         // get the format keys
         int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
index 2887c5360..86dd5d4f7 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
@@ -1,11 +1,9 @@
 package org.broadinstitute.sting.utils.codecs.vcf;
 
 import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 
 import java.util.List;
-import java.util.Map;
 
 
 /**
@@ -21,6 +19,6 @@ public interface VCFParser {
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public GenotypeMap createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+    public GenotypeCollection createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
 
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
index 7f15b4f5e..9a900d734 100644
--- a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
+++ b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
@@ -28,7 +28,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.StandardVCFWriter;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -146,16 +146,16 @@ public class GCF {
         Map<String, Object> attributes = new HashMap<String, Object>();
         attributes.put("INFO", info);
         Byte refPadByte = refPad == 0 ? null : refPad;
-        GenotypeMap genotypes = decodeGenotypes(header);
+        GenotypeCollection genotypes = decodeGenotypes(header);
 
         return new VariantContext(source, contig, start, stop, alleleMap, genotypes, negLog10PError, filters, attributes, refPadByte);
     }
 
-    private GenotypeMap decodeGenotypes(final GCFHeader header) {
+    private GenotypeCollection decodeGenotypes(final GCFHeader header) {
         if ( genotypes.isEmpty() )
             return VariantContext.NO_GENOTYPES;
         else {
-            GenotypeMap map = GenotypeMap.create();
+            GenotypeCollection map = GenotypeCollection.create();
 
             for ( int i = 0; i < genotypes.size(); i++ ) {
                 final String sampleName = header.getSample(i);
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
new file mode 100644
index 000000000..a83356647
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
@@ -0,0 +1,325 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext;
+
+import java.util.*;
+
+/**
+ *
+ */
+public class GenotypeCollection implements List<Genotype> {
+    public final static GenotypeCollection NO_GENOTYPES = new GenotypeCollection();
+
+    Map<String, Integer> sampleNameToOffset = null;
+    boolean cacheIsInvalid = true;
+    final ArrayList<Genotype> genotypes;
+    boolean immutable = false;
+
+    // ---------------------------------------------------------------------------
+    //
+    // private constructors -- you have to use static create methods to make these classes
+    //
+    // ---------------------------------------------------------------------------
+
+    private GenotypeCollection() {
+        this(10, false);
+    }
+
+    private GenotypeCollection(final int n, final boolean immutable) {
+        this(new ArrayList<Genotype>(n), immutable);
+    }
+
+    private GenotypeCollection(final ArrayList<Genotype> genotypes, final boolean immutable) {
+        this.genotypes = genotypes;
+        this.immutable = immutable;
+    }
+
+    // ---------------------------------------------------------------------------
+    //
+    // public static factory methods
+    //
+    // ---------------------------------------------------------------------------
+
+    public static final GenotypeCollection create() {
+        return new GenotypeCollection();
+    }
+
+    public static final GenotypeCollection create(final int nGenotypes) {
+        return new GenotypeCollection(nGenotypes, true);
+    }
+
+    // todo -- differentiate between empty constructor and copy constructor
+    // todo -- create constructor (Genotype ... genotypes)
+
+    public static final GenotypeCollection create(final ArrayList<Genotype> genotypes) {
+        return new GenotypeCollection(genotypes, true);
+    }
+
+    public static final GenotypeCollection copy(final GenotypeCollection toCopy) {
+        return create(toCopy.genotypes);
+    }
+
+//    public static final GenotypeMap create(final Collection<Genotype> genotypes) {
+//        if ( genotypes == null )
+//            return null; // todo -- really should return an empty map
+//        else {
+//            GenotypeMap genotypeMap = new GenotypeMap(genotypes.size(), false);
+//            for ( final Genotype g : genotypes ) {
+//                if ( genotypeMap.containsKey(g.getSampleName() ) )
+//                    throw new IllegalArgumentException("Duplicate genotype added to VariantContext: " + g);
+//                genotypeMap.put(g.getSampleName(), g);
+//            }
+//
+//            //return genotypeMap.immutable();  // todo enable when we have time to dive into mutability issue
+//            return genotypeMap;
+//        }
+//    }
+
+    // ---------------------------------------------------------------------------
+    //
+    // Mutability methods
+    //
+    // ---------------------------------------------------------------------------
+
+    public final GenotypeCollection mutable() {
+        immutable = false;
+        return this;
+    }
+
+    public final GenotypeCollection immutable() {
+        immutable = true;
+        return this;
+    }
+
+    public boolean isMutable() {
+        return ! immutable;
+    }
+
+    public final void checkImmutability() {
+        if ( immutable )
+            throw new IllegalAccessError("GenotypeMap is currently immutable, but a mutator method was invoked on it");
+    }
+
+    // ---------------------------------------------------------------------------
+    //
+    // caches
+    //
+    // ---------------------------------------------------------------------------
+
+    private void invalidateCaches() {
+        cacheIsInvalid = true;
+        if ( sampleNameToOffset != null ) sampleNameToOffset.clear();
+    }
+
+    private void buildCache() {
+        cacheIsInvalid = false;
+
+        if ( sampleNameToOffset == null )
+            sampleNameToOffset = new HashMap<String, Integer>(genotypes.size());
+
+        for ( int i = 0; i < genotypes.size(); i++ )
+            sampleNameToOffset.put(genotypes.get(i).getSampleName(), i);
+    }
+
+
+    // ---------------------------------------------------------------------------
+    //
+    // Map methods
+    //
+    // ---------------------------------------------------------------------------
+
+    @Override
+    public void clear() {
+        checkImmutability();
+        genotypes.clear();
+    }
+
+    @Override
+    public int size() {
+        return genotypes.size();
+    }
+
+    @Override
+    public boolean isEmpty() {
+        return genotypes.isEmpty();
+    }
+
+    @Override
+    public boolean add(final Genotype genotype) {
+        checkImmutability();
+        invalidateCaches();
+        return genotypes.add(genotype);
+    }
+
+    @Override
+    public void add(final int i, final Genotype genotype) {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public boolean addAll(final Collection<? extends Genotype> genotypes) {
+        checkImmutability();
+        invalidateCaches();
+        return this.genotypes.addAll(genotypes);
+    }
+
+    @Override
+    public boolean addAll(final int i, final Collection<? extends Genotype> genotypes) {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public boolean contains(final Object o) {
+        return this.genotypes.contains(o);
+    }
+
+    @Override
+    public boolean containsAll(final Collection<?> objects) {
+        return this.genotypes.containsAll(objects);
+    }
+
+    @Override
+    public Genotype get(final int i) {
+        return genotypes.get(i);
+    }
+
+    public Genotype get(final String sampleName) {
+        buildCache();
+        Integer offset = sampleNameToOffset.get(sampleName);
+        if ( offset == null )
+            throw new IllegalArgumentException("Sample " + sampleName + " not found in this GenotypeCollection");
+        return genotypes.get(offset);
+    }
+
+
+    @Override
+    public int indexOf(final Object o) {
+        return genotypes.indexOf(o);
+    }
+
+    @Override
+    public Iterator<Genotype> iterator() {
+        return genotypes.iterator();
+    }
+
+    @Override
+    public int lastIndexOf(final Object o) {
+        return genotypes.lastIndexOf(o);
+    }
+
+    @Override
+    public ListIterator<Genotype> listIterator() {
+        // todo -- must be immutable
+        return genotypes.listIterator();
+    }
+
+    @Override
+    public ListIterator<Genotype> listIterator(final int i) {
+        // todo -- must be immutable
+        return genotypes.listIterator(i);
+    }
+
+    @Override
+    public Genotype remove(final int i) {
+        checkImmutability();
+        invalidateCaches();
+        return genotypes.remove(i);
+    }
+
+    @Override
+    public boolean remove(final Object o) {
+        checkImmutability();
+        invalidateCaches();
+        return genotypes.remove(o);
+    }
+
+    @Override
+    public boolean removeAll(final Collection<?> objects) {
+        checkImmutability();
+        invalidateCaches();
+        return genotypes.removeAll(objects);
+    }
+
+    @Override
+    public boolean retainAll(final Collection<?> objects) {
+        checkImmutability();
+        invalidateCaches();
+        return genotypes.retainAll(objects);
+    }
+
+    @Override
+    public Genotype set(final int i, final Genotype genotype) {
+        checkImmutability();
+        invalidateCaches();
+        return genotypes.set(i, genotype);
+    }
+
+    @Override
+    public List<Genotype> subList(final int i, final int i1) {
+        return genotypes.subList(i, i1);
+    }
+
+    @Override
+    public Object[] toArray() {
+        return genotypes.toArray();
+    }
+
+    @Override
+    public <T> T[] toArray(final T[] ts) {
+        return genotypes.toArray(ts);
+    }
+
+    public Iterable<Genotype> iterateInOrder(final Iterable<String> sampleNamesInOrder) {
+        return new Iterable<Genotype>() {
+            @Override
+            public Iterator<Genotype> iterator() {
+                return new InOrderIterator(sampleNamesInOrder.iterator());
+            }
+        };
+    }
+
+    private final class InOrderIterator implements Iterator<Genotype> {
+        final Iterator<String> sampleNamesInOrder;
+
+        private InOrderIterator(final Iterator<String> sampleNamesInOrder) {
+            this.sampleNamesInOrder = sampleNamesInOrder;
+        }
+
+        @Override
+        public boolean hasNext() {
+            return sampleNamesInOrder.hasNext();
+        }
+
+        @Override
+        public Genotype next() {
+            return get(sampleNamesInOrder.next());
+        }
+
+        @Override
+        public void remove() {
+            throw new UnsupportedOperationException();
+        }
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java
deleted file mode 100644
index cb7250bdb..000000000
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeMap.java
+++ /dev/null
@@ -1,191 +0,0 @@
-/*
- * Copyright (c) 2011, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext;
-
-import java.util.*;
-
-/**
- *
- */
-public class GenotypeMap implements Map<String, Genotype> {
-    final TreeMap<String, Genotype> genotypes;
-    boolean immutable = false;
-    public final static GenotypeMap NO_GENOTYPES = new GenotypeMap();
-
-    // ---------------------------------------------------------------------------
-    //
-    // private constructors -- you have to use static create methods to make these classes
-    //
-    // ---------------------------------------------------------------------------
-
-    private GenotypeMap() {
-        this(false);
-    }
-
-    private GenotypeMap(boolean immutable) {
-        this(new TreeMap<String, Genotype>(), immutable);
-    }
-
-    private GenotypeMap(final TreeMap<String, Genotype> genotypes, final boolean immutable) {
-        this.genotypes = genotypes;
-        this.immutable = immutable;
-    }
-
-    // ---------------------------------------------------------------------------
-    //
-    // public static factory methods
-    //
-    // ---------------------------------------------------------------------------
-
-    public static final GenotypeMap create() {
-        return new GenotypeMap();
-    }
-
-    public static final GenotypeMap create(final int nGenotypes) {
-        return new GenotypeMap();
-    }
-
-    public static final GenotypeMap create(final GenotypeMap genotypes) {
-        return create(genotypes.values());
-    }
-
-    // todo -- differentiate between empty constructor and copy constructor
-    // todo -- create constructor (Genotype ... genotypes)
-
-    public static final GenotypeMap create(final Map<String, Genotype> genotypes) {
-        return create(genotypes.values());
-    }
-
-    public static final GenotypeMap create(final Collection<Genotype> genotypes) {
-        if ( genotypes == null )
-            return null; // todo -- really should return an empty map
-        else {
-            GenotypeMap genotypeMap = new GenotypeMap().mutable();
-            for ( final Genotype g : genotypes ) {
-                if ( genotypeMap.containsKey(g.getSampleName() ) )
-                    throw new IllegalArgumentException("Duplicate genotype added to VariantContext: " + g);
-                genotypeMap.put(g.getSampleName(), g);
-            }
-
-            //return genotypeMap.immutable();  // todo enable when we have time to dive into mutability issue
-            return genotypeMap;
-        }
-    }
-
-    // ---------------------------------------------------------------------------
-    //
-    // Mutability methods
-    //
-    // ---------------------------------------------------------------------------
-
-    public final GenotypeMap mutable() {
-        immutable = false;
-        return this;
-    }
-
-    public final GenotypeMap immutable() {
-        immutable = true;
-        return this;
-    }
-
-    public boolean isMutable() {
-        return ! immutable;
-    }
-
-    public final void checkImmutability() {
-        if ( immutable )
-            throw new IllegalAccessError("GenotypeMap is currently immutable, but a mutator method was invoked on it");
-    }
-
-    // ---------------------------------------------------------------------------
-    //
-    // Map methods
-    //
-    // ---------------------------------------------------------------------------
-
-    @Override
-    public void clear() {
-        checkImmutability();
-        genotypes.clear();
-    }
-
-    @Override
-    public int size() {
-        return genotypes.size();
-    }
-
-    @Override
-    public boolean isEmpty() {
-        return genotypes.isEmpty();
-    }
-
-    @Override
-    public boolean containsKey(final Object o) {
-        return genotypes.containsKey(o);
-    }
-
-    @Override
-    public boolean containsValue(final Object o) {
-        return genotypes.containsValue(o);
-    }
-
-    @Override
-    public Genotype get(final Object o) {
-        return genotypes.get(o);
-    }
-
-    @Override
-    public Genotype put(final String s, final Genotype genotype) {
-        checkImmutability();
-        return genotypes.put(s, genotype);
-    }
-
-    @Override
-    public Genotype remove(final Object o) {
-        checkImmutability();
-        return genotypes.remove(o);
-    }
-
-    @Override
-    public void putAll(final Map<? extends String, ? extends Genotype> map) {
-        checkImmutability();
-        genotypes.putAll(map);
-    }
-
-    @Override
-    public Set<String> keySet() {
-        return Collections.unmodifiableSet(genotypes.keySet());
-    }
-
-    @Override
-    public Collection<Genotype> values() {
-        return genotypes.values();
-    }
-
-    @Override
-    public Set<Entry<String, Genotype>> entrySet() {
-        return genotypes.entrySet();
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 47b792e0b..5bd29a0ce 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -184,12 +184,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     final protected List<Allele> alleles;
 
     /** A mapping from sampleName -> genotype objects for all genotypes associated with this context */
-    protected GenotypeMap genotypes = null;
+    protected GenotypeCollection genotypes = null;
 
     /** Counts for each of the possible Genotype types in this context */
     protected int[] genotypeCounts = null;
 
-    public final static GenotypeMap NO_GENOTYPES = GenotypeMap.NO_GENOTYPES;
+    public final static GenotypeCollection NO_GENOTYPES = GenotypeCollection.NO_GENOTYPES;
 
     // a fast cached access point to the ref / alt alleles for biallelic case
     private Allele REF = null;
@@ -222,7 +222,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeMap genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
         this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false);
     }
 
@@ -239,7 +239,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeMap genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false);
     }
 
@@ -279,7 +279,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, contig, start, stop, alleles,
-                GenotypeMap.create(genotypes),
+                GenotypeCollection.create(genotypes),
                 negLog10PError, filters, attributes, null, false);
     }
 
@@ -335,7 +335,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param genotypesAreUnparsed    true if the genotypes have not yet been parsed
      */
     private VariantContext(String source, String contig, long start, long stop,
-                           Collection<Allele> alleles, GenotypeMap genotypes,
+                           Collection<Allele> alleles, GenotypeCollection genotypes,
                            double negLog10PError, Set<String> filters, Map<String, Object> attributes,
                            Byte referenceBaseForIndel, boolean genotypesAreUnparsed) {
         if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
@@ -383,7 +383,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    public static VariantContext modifyGenotypes(VariantContext vc, GenotypeMap genotypes) {
+    public static VariantContext modifyGenotypes(VariantContext vc, GenotypeCollection genotypes) {
         return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), false);
     }
 
@@ -458,7 +458,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes, Collection<Allele> alleles) {
         return new VariantContext(getSource(), contig, start, stop, alleles,
-                GenotypeMap.create(genotypes),
+                GenotypeCollection.create(genotypes),
                 getNegLog10PError(),
                 filtersWereApplied() ? getFilters() : null,
                 getAttributes(),
@@ -890,7 +890,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     /**
      * @return set of all Genotypes associated with this context
      */
-    public GenotypeMap getGenotypes() {
+    public GenotypeCollection getGenotypes() {
         loadGenotypes();
         return genotypes;
     }
@@ -909,7 +909,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
-    public GenotypeMap getGenotypes(String sampleName) {
+    public GenotypeCollection getGenotypes(String sampleName) {
         return getGenotypes(Arrays.asList(sampleName));
     }
 
@@ -921,8 +921,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
-    public GenotypeMap getGenotypes(Collection<String> sampleNames) {
-        GenotypeMap map = GenotypeMap.create(sampleNames.size());
+    public GenotypeCollection getGenotypes(Collection<String> sampleNames) {
+        GenotypeCollection map = GenotypeCollection.create(sampleNames.size());
 
         for ( String name : sampleNames ) {
             if ( map.containsKey(name) ) throw new IllegalArgumentException("Duplicate names detected in requested samples " + sampleNames);
@@ -1465,8 +1465,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             Byte refByte = inputVC.getReferenceBaseForIndel();
 
             List<Allele> alleles = new ArrayList<Allele>();
-            GenotypeMap genotypes = GenotypeMap.create();
-            GenotypeMap inputGenotypes = inputVC.getGenotypes();
+            GenotypeCollection genotypes = GenotypeCollection.create();
+            GenotypeCollection inputGenotypes = inputVC.getGenotypes();
 
             for (Allele a : inputVC.getAlleles()) {
                 // get bases for current allele and create a new one with trimmed bases
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 37d8acbe2..89db22bd6 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -70,7 +70,7 @@ public class VariantContextUtils {
      * @return VariantContext object
      */
     public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, GenotypeMap.create(genotypes), negLog10PError, filters, attributes);
+        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, GenotypeCollection.create(genotypes), negLog10PError, filters, attributes);
     }
 
     /**
@@ -350,7 +350,7 @@ public class VariantContextUtils {
         if ( vc.hasID() ) attributes.put(VariantContext.ID_KEY, vc.getID());
 
         // Genotypes
-        final GenotypeMap genotypes = GenotypeMap.create(vc.getNSamples());
+        final GenotypeCollection genotypes = GenotypeCollection.create(vc.getNSamples());
         for ( final Genotype g : vc.getGenotypes().values() ) {
             Map<String, Object> genotypeAttributes = subsetAttributes(g.commonInfo, keysToPreserve);
             genotypes.put(g.getSampleName(),
@@ -458,7 +458,7 @@ public class VariantContextUtils {
         final Map<String, Object> attributesWithMaxAC = new TreeMap<String, Object>();
         double negLog10PError = -1;
         VariantContext vcWithMaxAC = null;
-        GenotypeMap genotypes = GenotypeMap.create();
+        GenotypeCollection genotypes = GenotypeCollection.create();
 
         // counting the number of filtered and variant VCs
         int nFiltered = 0;
@@ -648,7 +648,7 @@ public class VariantContextUtils {
         // nothing to do if we don't need to trim bases
         if (trimVC) {
             List<Allele> alleles = new ArrayList<Allele>();
-            GenotypeMap genotypes = GenotypeMap.create();
+            GenotypeCollection genotypes = GenotypeCollection.create();
 
             // set the reference base for indels in the attributes
             Map<String,Object> attributes = new TreeMap<String,Object>(inputVC.getAttributes());
@@ -702,8 +702,8 @@ public class VariantContextUtils {
         return inputVC;
     }
 
-    public static GenotypeMap stripPLs(GenotypeMap genotypes) {
-        GenotypeMap newGs = GenotypeMap.create(genotypes.size());
+    public static GenotypeCollection stripPLs(GenotypeCollection genotypes) {
+        GenotypeCollection newGs = GenotypeCollection.create(genotypes.size());
 
         for ( Map.Entry<String, Genotype> g : genotypes.entrySet() ) {
             newGs.put(g.getKey(), g.getValue().hasLikelihoods() ? removePLs(g.getValue()) : g.getValue());
@@ -883,7 +883,7 @@ public class VariantContextUtils {
         }
     }
 
-    private static void mergeGenotypes(GenotypeMap mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
+    private static void mergeGenotypes(GenotypeCollection mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
         for ( Genotype g : oneVC.getGenotypes().values() ) {
             String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
             if ( ! mergedGenotypes.containsKey(name) ) {
@@ -923,7 +923,7 @@ public class VariantContextUtils {
         }
 
         // create new Genotype objects
-        GenotypeMap newGenotypes = GenotypeMap.create(vc.getNSamples());
+        GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
         for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
             List<Allele> newAlleles = new ArrayList<Allele>();
             for ( Allele allele : genotype.getValue().getAlleles() ) {
@@ -943,7 +943,7 @@ public class VariantContextUtils {
         if ( allowedAttributes == null )
             return vc;
 
-        GenotypeMap newGenotypes = GenotypeMap.create(vc.getNSamples());
+        GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
         for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
             Map<String, Object> attrs = new HashMap<String, Object>();
             for ( Map.Entry<String, Object> attr : genotype.getValue().getAttributes().entrySet() ) {
@@ -1022,7 +1022,7 @@ public class VariantContextUtils {
         }
         MergedAllelesData mergeData = new MergedAllelesData(intermediateBases, vc1, vc2); // ensures that the reference allele is added
 
-        GenotypeMap mergedGenotypes = GenotypeMap.create();
+        GenotypeCollection mergedGenotypes = GenotypeCollection.create();
         for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
             String sample = gt1Entry.getKey();
             Genotype gt1 = gt1Entry.getValue();
diff --git a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
index b658da1d3..d698d12a3 100644
--- a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
@@ -4,7 +4,7 @@ import org.broad.tribble.Tribble;
 import org.broad.tribble.readers.AsciiLineReader;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeMap;
+import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
@@ -122,7 +122,7 @@ public class VCFWriterUnitTest extends BaseTest {
         List<Allele> alleles = new ArrayList<Allele>();
         Set<String> filters = null;
         Map<String, Object> attributes = new HashMap<String,Object>();
-        GenotypeMap genotypes = GenotypeMap.create();
+        GenotypeCollection genotypes = GenotypeCollection.create();
 
         alleles.add(Allele.create("-",true));
         alleles.add(Allele.create("CC",false));
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index 48ddb7efc..f5e485587 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -99,7 +99,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
         int start = 10;
         int stop = start; // alleles.contains(ATC) ? start + 3 : start;
         return new VariantContext(source, "1", start, stop, alleles,
-                GenotypeMap.create(genotypes), 1.0, filters, null, Cref.getBases()[0]);
+                GenotypeCollection.create(genotypes), 1.0, filters, null, Cref.getBases()[0]);
     }
 
     // --------------------------------------------------------------------------------

From ab0ee9b847f1574e4bf2a6866022e5a959f58072 Mon Sep 17 00:00:00 2001
From: David Roazen <droazen@broadinstitute.org>
Date: Mon, 14 Nov 2011 15:10:50 -0500
Subject: [PATCH 018/113] Perform only necessary validation in VariantContext
 modify methods

---
 .../utils/variantcontext/VariantContext.java  | 48 +++++++++++++------
 1 file changed, 34 insertions(+), 14 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index f52a7087b..204b4b841 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -223,7 +223,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param referenceBaseForIndel   padded reference base
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes, Byte referenceBaseForIndel) {
-        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false);
+        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, true);
     }
 
     /**
@@ -240,7 +240,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
-        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false);
+        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, true);
     }
 
     /**
@@ -261,7 +261,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param referenceBaseForIndel   padded reference base
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, Byte referenceBaseForIndel) {
-        this(source, contig, start, stop, alleles, NO_GENOTYPES, negLog10PError, filters, attributes, referenceBaseForIndel, true);
+        this(source, contig, start, stop, alleles, NO_GENOTYPES, negLog10PError, filters, attributes, referenceBaseForIndel, true, true);
     }
 
     /**
@@ -278,7 +278,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes     attributes
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
-        this(source, contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes, null, false);
+        this(source, contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes, null, false, true);
     }
 
     /**
@@ -291,7 +291,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param alleles alleles
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
-        this(source, contig, start, stop, alleles, NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, null, false);
+        this(source, contig, start, stop, alleles, NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, null, false, true);
     }
 
     /**
@@ -314,7 +314,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param other the VariantContext to copy
      */
     public VariantContext(VariantContext other) {
-        this(other.getSource(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false);
+        this(other.getSource(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, true);
     }
 
     /**
@@ -331,11 +331,13 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      * @param genotypesAreUnparsed    true if the genotypes have not yet been parsed
+     * @param performValidation       if true, call validate() as the final step in construction
      */
     private VariantContext(String source, String contig, long start, long stop,
                            Collection<Allele> alleles, Map<String, Genotype> genotypes,
                            double negLog10PError, Set<String> filters, Map<String, ?> attributes,
-                           Byte referenceBaseForIndel, boolean genotypesAreUnparsed) {
+                           Byte referenceBaseForIndel, boolean genotypesAreUnparsed,
+                           boolean performValidation ) {
         if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
         this.contig = contig;
         this.start = start;
@@ -371,39 +373,57 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             }
         }
 
-        validate();
+        if ( performValidation ) {
+            validate();
+        }
     }
 
     // ---------------------------------------------------------------------------------------------------------
     //
     // Partial-cloning routines (because Variant Context is immutable).
+    //
+    //    IMPORTANT: These routines assume that the VariantContext on which they're called is already valid.
+    //               Due to this assumption, they explicitly tell the constructor NOT to perform validation by
+    //               calling validate(), and instead perform validation only on the data that's changed.
+    //
     //    Note that we don't call vc.getGenotypes() because that triggers the lazy loading.
     //    Also note that we need to create a new attributes map because it's unmodifiable and the constructor may try to modify it.
     //
     // ---------------------------------------------------------------------------------------------------------
 
     public static VariantContext modifyGenotypes(VariantContext vc, Map<String, Genotype> genotypes) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), false);
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), false, false);
+        modifiedVC.validateGenotypes();
+        return modifiedVC;
     }
 
     public static VariantContext modifyLocation(VariantContext vc, String chr, int start, int end) {
-        return new VariantContext(vc.getSource(), chr, start, end, vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true);
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), chr, start, end, vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
+
+        // Since start and end have changed, we need to call both validateAlleles() and validateReferencePadding(),
+        // since those validation routines rely on the values of start and end:
+        modifiedVC.validateAlleles();
+        modifiedVC.validateReferencePadding();
+
+        return modifiedVC;
     }
 
     public static VariantContext modifyFilters(VariantContext vc, Set<String> filters) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), filters, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true);
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), filters, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
     }
 
     public static VariantContext modifyAttributes(VariantContext vc, Map<String, Object> attributes) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true);
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
     }
 
     public static VariantContext modifyReferencePadding(VariantContext vc, Byte b) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), b, true);
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), b, true, false);
+        modifiedVC.validateReferencePadding();
+        return modifiedVC;
     }
 
     public static VariantContext modifyPErrorFiltersAndAttributes(VariantContext vc, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, negLog10PError, filters, attributes, vc.getReferenceBaseForIndel(), true);
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, negLog10PError, filters, attributes, vc.getReferenceBaseForIndel(), true, false);
     }
 
     // ---------------------------------------------------------------------------------------------------------

From f0234ab67f6161db6f5865dcb04ca0dc8cce33da Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 14 Nov 2011 17:42:55 -0500
Subject: [PATCH 019/113] GenotypeMap -> GenotypeCollection part 2

-- Code actually builds
---
 .../gatk/refdata/VariantContextAdaptors.java  |  11 +-
 .../walkers/annotator/HaplotypeScore.java     |   5 +-
 .../walkers/annotator/InbreedingCoeff.java    |   3 +-
 .../gatk/walkers/annotator/QualByDepth.java   |   6 +-
 .../gatk/walkers/annotator/RankSumTest.java   |   8 +-
 .../annotator/VariantAnnotatorEngine.java     |   9 +-
 .../beagle/BeagleOutputToVCFWalker.java       |  11 +-
 .../beagle/ProduceBeagleInputWalker.java      |  13 +-
 .../walkers/diffengine/VCFDiffableReader.java |   2 +-
 .../filters/VariantFiltrationWalker.java      |   9 +-
 .../AlleleFrequencyCalculationModel.java      |   4 +-
 .../genotyper/ExactAFCalculationModel.java    |  31 +-
 .../genotyper/GridSearchAFEstimation.java     | 270 ------------------
 .../walkers/genotyper/UGCallVariants.java     |  13 +-
 .../genotyper/UnifiedGenotyperEngine.java     |   5 +-
 .../indels/SomaticIndelDetectorWalker.java    |   9 +-
 ...eSegregatingAlternateAllelesVCFWriter.java |   2 +-
 .../walkers/phasing/PhaseByTransmission.java  |   6 +-
 .../phasing/ReadBackedPhasingWalker.java      |  16 +-
 .../varianteval/evaluators/CountVariants.java |   4 +-
 .../evaluators/G1KPhaseITable.java            |   2 +-
 .../evaluators/GenotypeConcordance.java       |  21 +-
 .../evaluators/ThetaVariantEvaluator.java     |   2 +-
 .../varianteval/util/VariantEvalUtils.java    |   4 +-
 .../variantutils/LeftAlignVariants.java       |   6 +-
 .../walkers/variantutils/SelectVariants.java  |   2 +-
 .../walkers/variantutils/VariantsToVCF.java   |   3 +-
 .../utils/codecs/vcf/StandardVCFWriter.java   |   2 +-
 .../sting/utils/codecs/vcf/VCF3Codec.java     |   2 +-
 .../sting/utils/codecs/vcf/VCFCodec.java      |   8 +-
 .../broadinstitute/sting/utils/gcf/GCF.java   |   6 +-
 .../variantcontext/GenotypeCollection.java    |  61 +++-
 .../utils/variantcontext/VariantContext.java  | 212 ++++++--------
 .../variantcontext/VariantContextUtils.java   |  66 ++---
 .../walkers/qc/TestVariantContextWalker.java  |  13 +-
 .../utils/genotype/vcf/VCFWriterUnitTest.java |   4 +-
 .../VariantContextUtilsUnitTest.java          |  12 +-
 37 files changed, 282 insertions(+), 581 deletions(-)
 delete mode 100755 public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index 523da7492..164e1f1cb 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -202,15 +202,6 @@ public class VariantContextAdaptors {
         }
     }
 
-    public static VCFHeader createVCFHeader(Set<VCFHeaderLine> hInfo, VariantContext vc) {
-        HashSet<String> names = new LinkedHashSet<String>();
-        for ( Genotype g : vc.getGenotypesSortedByName() ) {
-            names.add(g.getSampleName());
-        }
-
-        return new VCFHeader(hInfo == null ? new HashSet<VCFHeaderLine>() : hInfo, names);
-    }
-
     // --------------------------------------------------------------------------------------------------------------
     //
     // GELI to VariantContext
@@ -353,7 +344,7 @@ public class VariantContextAdaptors {
                 }
 
                 Genotype g = new Genotype(samples[i], myAlleles);
-                genotypes.put(samples[i], g);
+                genotypes.add(g);
             }
 
             HashMap<String, Object> attrs = new HashMap<String, Object>(1);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HaplotypeScore.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HaplotypeScore.java
index 94b0636f4..551f8e2cf 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HaplotypeScore.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HaplotypeScore.java
@@ -89,9 +89,8 @@ public class HaplotypeScore extends InfoFieldAnnotation implements StandardAnnot
 
 	    final MathUtils.RunningAverage scoreRA = new MathUtils.RunningAverage();
         if (haplotypes != null) {
-            final Set<Map.Entry<String, Genotype>> genotypes = vc.getGenotypes().entrySet();
-            for ( final Map.Entry<String, Genotype> genotype : genotypes ) {
-                final AlignmentContext thisContext = stratifiedContexts.get(genotype.getKey());
+            for ( final Genotype genotype : vc.getGenotypes()) {
+                final AlignmentContext thisContext = stratifiedContexts.get(genotype.getSampleName());
                 if ( thisContext != null ) {
                     final ReadBackedPileup thisPileup;
                     if (thisContext.hasExtendedEventPileup())
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
index a21d7106c..917a75294 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
@@ -52,8 +52,7 @@ public class InbreedingCoeff extends InfoFieldAnnotation implements StandardAnno
         double hetCount = 0.0;
         double homCount = 0.0;
         int N = 0; // number of samples that have likelihoods
-        for ( final Map.Entry<String, Genotype> genotypeMap : genotypes.entrySet() ) {
-            Genotype g = genotypeMap.getValue();
+        for ( final Genotype g : genotypes ) {
             if ( g.isNoCall() || !g.hasLikelihoods() )
                 continue;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
index dae041155..3a1f2cc87 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
@@ -35,13 +35,13 @@ public class QualByDepth extends InfoFieldAnnotation implements StandardAnnotati
 
         int depth = 0;
 
-        for ( Map.Entry<String, Genotype> genotype : genotypes.entrySet() ) {
+        for ( final Genotype genotype : genotypes ) {
 
             // we care only about variant calls with likelihoods
-            if ( genotype.getValue().isHomRef() )
+            if ( genotype.isHomRef() )
                 continue;
 
-            AlignmentContext context = stratifiedContexts.get(genotype.getKey());
+            AlignmentContext context = stratifiedContexts.get(genotype.getSampleName());
             if ( context == null )
                 continue;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
index 8182747f4..97e014373 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
@@ -43,8 +43,8 @@ public abstract class RankSumTest extends InfoFieldAnnotation implements Standar
 
         if (vc.isSNP() && vc.isBiallelic()) {
             // todo - no current support for multiallelic snps
-            for ( final Map.Entry<String, Genotype> genotype : genotypes.entrySet() ) {
-                final AlignmentContext context = stratifiedContexts.get(genotype.getKey());
+            for ( final Genotype genotype : genotypes ) {
+                final AlignmentContext context = stratifiedContexts.get(genotype.getSampleName());
                 if ( context == null ) {
                     continue;
                 }
@@ -53,8 +53,8 @@ public abstract class RankSumTest extends InfoFieldAnnotation implements Standar
         }
         else if (vc.isIndel() || vc.isMixed()) {
 
-            for ( final Map.Entry<String, Genotype> genotype : genotypes.entrySet() ) {
-                final AlignmentContext context = stratifiedContexts.get(genotype.getKey());
+            for ( final Genotype genotype : genotypes ) {
+                final AlignmentContext context = stratifiedContexts.get(genotype.getSampleName());
                 if ( context == null ) {
                     continue;
                 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
index 6f481b872..a0bd69be7 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
@@ -229,11 +229,10 @@ public class VariantAnnotatorEngine {
             return vc.getGenotypes();
 
         GenotypeCollection genotypes = GenotypeCollection.create(vc.getNSamples());
-        for ( Map.Entry<String, Genotype> g : vc.getGenotypes().entrySet() ) {
-            Genotype genotype = g.getValue();
-            AlignmentContext context = stratifiedContexts.get(g.getKey());
+        for ( final Genotype genotype : vc.getGenotypes() ) {
+            AlignmentContext context = stratifiedContexts.get(genotype.getSampleName());
             if ( context == null ) {
-                genotypes.put(g.getKey(), genotype);
+                genotypes.add(genotype);
                 continue;
             }
 
@@ -243,7 +242,7 @@ public class VariantAnnotatorEngine {
                 if ( result != null )
                     genotypeAnnotations.putAll(result);
             }
-            genotypes.put(g.getKey(), new Genotype(g.getKey(), genotype.getAlleles(), genotype.getNegLog10PError(), genotype.getFilters(), genotypeAnnotations, genotype.isPhased()));
+            genotypes.add(new Genotype(genotype.getSampleName(), genotype.getAlleles(), genotype.getNegLog10PError(), genotype.getFilters(), genotypeAnnotations, genotype.isPhased()));
         }
 
         return genotypes;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index 89dd114cc..c03621280 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -202,9 +202,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
             hapmapGenotypes = vc_comp.getGenotypes();
         }
 
-        for ( Map.Entry<String, Genotype> originalGenotypes : vc_input.getGenotypes().entrySet() ) {
-
-            Genotype g = originalGenotypes.getValue();
+        for ( final Genotype g : vc_input.getGenotypes() ) {
             Set<String> filters = new LinkedHashSet<String>(g.getFilters());
 
             boolean genotypeIsPhased = true;
@@ -214,7 +212,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
             // use sample as key into genotypes structure
             if (vc_comp != null) {
 
-                if (vc_input.getGenotypes().containsKey(sample) && hapmapGenotypes.containsKey(sample))  {
+                if (vc_input.getGenotypes().containsSample(sample) && hapmapGenotypes.containsSample(sample))  {
 
                     Genotype hapmapGenotype = hapmapGenotypes.get(sample);
                     if (hapmapGenotype.isCalled()){
@@ -325,13 +323,12 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
             else {
                 originalAttributes.put("OG",".");
             }
-            Genotype imputedGenotype = new Genotype(originalGenotypes.getKey(), alleles, genotypeQuality, filters,originalAttributes , genotypeIsPhased);
+            Genotype imputedGenotype = new Genotype(g.getSampleName(), alleles, genotypeQuality, filters,originalAttributes , genotypeIsPhased);
             if ( imputedGenotype.isHet() || imputedGenotype.isHomVar() ) {
                 beagleVarCounts++;
             }
 
-            genotypes.put(originalGenotypes.getKey(), imputedGenotype);
-
+            genotypes.add(imputedGenotype);
         }
 
         VariantContext filteredVC;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
index b722220f9..f7a84ee08 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
@@ -39,10 +39,7 @@ import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.StingException;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.File;
 import java.io.PrintStream;
@@ -245,18 +242,18 @@ public class ProduceBeagleInputWalker extends RodWalker<Integer, Integer> {
         }
         if ( markers != null ) markers.append("\n");
 
-        Map<String,Genotype> preferredGenotypes = preferredVC.getGenotypes();
-        Map<String,Genotype> otherGenotypes = goodSite(otherVC) ? otherVC.getGenotypes() : null;
+        GenotypeCollection preferredGenotypes = preferredVC.getGenotypes();
+        GenotypeCollection otherGenotypes = goodSite(otherVC) ? otherVC.getGenotypes() : null;
         for ( String sample : samples ) {
             boolean isMaleOnChrX = CHECK_IS_MALE_ON_CHR_X && getSample(sample).getGender() == Gender.MALE;
 
             Genotype genotype;
             boolean isValidation;
             // use sample as key into genotypes structure
-            if ( preferredGenotypes.keySet().contains(sample) ) {
+            if ( preferredGenotypes.containsSample(sample) ) {
                 genotype = preferredGenotypes.get(sample);
                 isValidation = isValidationSite;
-            } else if ( otherGenotypes != null && otherGenotypes.keySet().contains(sample) ) {
+            } else if ( otherGenotypes != null && otherGenotypes.containsSample(sample) ) {
                 genotype = otherGenotypes.get(sample);
                 isValidation = ! isValidationSite;
             } else {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
index a447d17af..2587b30ef 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
@@ -102,7 +102,7 @@ public class VCFDiffableReader implements DiffableReader {
                         vcRoot.add(attribute.getKey(), attribute.getValue());
                 }
 
-                for (Genotype g : vc.getGenotypes().values() ) {
+                for (Genotype g : vc.getGenotypes() ) {
                     DiffNode gRoot = DiffNode.empty(g.getSampleName(), vcRoot);
                     gRoot.add("GT", g.getGenotypeString());
                     gRoot.add("GQ", g.hasNegLog10PError() ? g.getNegLog10PError() * 10 : VCFConstants.MISSING_VALUE_v4 );
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
index c1fbc9ac6..81bff7aaa 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
@@ -290,10 +290,7 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
             genotypes = GenotypeCollection.create(vc.getGenotypes().size());
 
             // for each genotype, check filters then create a new object
-            for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
-
-                Genotype g = genotype.getValue();
-
+            for ( final Genotype g : vc.getGenotypes() ) {
                 if ( g.isCalled() ) {
                     Set<String> filters = new LinkedHashSet<String>(g.getFilters());
 
@@ -301,9 +298,9 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
                         if ( VariantContextUtils.match(vc, g, exp) )
                             filters.add(exp.name);
                     }
-                    genotypes.put(genotype.getKey(), new Genotype(genotype.getKey(), g.getAlleles(), g.getNegLog10PError(), filters, g.getAttributes(), g.isPhased()));
+                    genotypes.add(new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), filters, g.getAttributes(), g.isPhased()));
                 } else {
-                    genotypes.put(genotype.getKey(), g);
+                    genotypes.add(g);
                 }
             }
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
index d0f45092b..b81c1d4c3 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
@@ -45,8 +45,6 @@ public abstract class AlleleFrequencyCalculationModel implements Cloneable {
     public enum Model {
         /** The default model with the best performance in all cases */
         EXACT,
-        /** For posterity we have kept around the older GRID_SEARCH model, but this gives inferior results and shouldn't be used. */
-        GRID_SEARCH
     }
 
     protected int N;
@@ -71,7 +69,7 @@ public abstract class AlleleFrequencyCalculationModel implements Cloneable {
      * @param log10AlleleFrequencyPriors      priors
      * @param log10AlleleFrequencyPosteriors  array (pre-allocated) to store results
      */
-    protected abstract void getLog10PNonRef(Map<String, Genotype> GLs,  List<Allele> Alleles,
+    protected abstract void getLog10PNonRef(GenotypeCollection GLs,  List<Allele> Alleles,
                                             double[] log10AlleleFrequencyPriors,
                                             double[] log10AlleleFrequencyPosteriors);
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index bb2516f7c..f0c73cd5f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -50,7 +50,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
         super(UAC, N, logger, verboseWriter);
     }
 
-    public void getLog10PNonRef(Map<String, Genotype> GLs, List<Allele> alleles,
+    public void getLog10PNonRef(GenotypeCollection GLs, List<Allele> alleles,
                                 double[] log10AlleleFrequencyPriors,
                                 double[] log10AlleleFrequencyPosteriors) {
         final int numAlleles = alleles.size();
@@ -94,11 +94,11 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
         }
     }
 
-    private static final ArrayList<double[]> getGLs(Map<String, Genotype> GLs) {
+    private static final ArrayList<double[]> getGLs(GenotypeCollection GLs) {
         ArrayList<double[]> genotypeLikelihoods = new ArrayList<double[]>();
 
         genotypeLikelihoods.add(new double[]{0.0,0.0,0.0}); // dummy
-        for ( Genotype sample : GLs.values() ) {
+        for ( Genotype sample : GLs ) {
             if ( sample.hasLikelihoods() ) {
                 double[] gls = sample.getLikelihoods().getAsVector();
 
@@ -154,7 +154,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
         }
     }
 
-    public int linearExact(Map<String, Genotype> GLs,
+    public int linearExact(GenotypeCollection GLs,
                            double[] log10AlleleFrequencyPriors,
                            double[] log10AlleleFrequencyPosteriors, int idxAA, int idxAB, int idxBB) {
         final ArrayList<double[]> genotypeLikelihoods = getGLs(GLs);
@@ -290,16 +290,16 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
 
         // todo = can't deal with optimal dynamic programming solution with multiallelic records
         if (SIMPLE_GREEDY_GENOTYPER || !vc.isBiallelic()) {
-            sampleIndices.addAll(GLs.keySet());
+            sampleIndices.addAll(GLs.getSampleNames());
             sampleIdx = GLs.size();
         }
         else {
 
-            for ( Map.Entry<String, Genotype> sample : GLs.entrySet() ) {
-                if ( !sample.getValue().hasLikelihoods() )
+            for ( final Genotype genotype : GLs ) {
+                if ( !genotype.hasLikelihoods() )
                     continue;
 
-                double[] likelihoods = sample.getValue().getLikelihoods().getAsVector();
+                double[] likelihoods = genotype.getLikelihoods().getAsVector();
 
                 if (MathUtils.sum(likelihoods) > SUM_GL_THRESH_NOCALL)     {
                     //System.out.print(sample.getKey()+":");
@@ -311,7 +311,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
                     continue;
                 }
 
-                sampleIndices.add(sample.getKey());
+                sampleIndices.add(genotype.getSampleName());
 
                 for (int k=0; k <= AFofMaxLikelihood; k++) {
 
@@ -415,17 +415,16 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
                 qual = -1.0 * Math.log10(1.0 - chosenGenotype);
             }
             //System.out.println(myAlleles.toString());
-            calls.put(sample, new Genotype(sample, myAlleles, qual, null, g.getAttributes(), false));
+            calls.add(new Genotype(sample, myAlleles, qual, null, g.getAttributes(), false));
 
         }
 
-        for ( Map.Entry<String, Genotype> sample : GLs.entrySet() ) {
-
-            if ( !sample.getValue().hasLikelihoods() )
+        for ( final Genotype genotype : GLs ) {
+            if ( !genotype.hasLikelihoods() )
                 continue;
-            Genotype g = GLs.get(sample.getKey());
+            Genotype g = GLs.get(genotype.getSampleName());
 
-            double[] likelihoods = sample.getValue().getLikelihoods().getAsVector();
+            double[] likelihoods = genotype.getLikelihoods().getAsVector();
 
             if (MathUtils.sum(likelihoods) <= SUM_GL_THRESH_NOCALL)
                 continue; // regular likelihoods
@@ -436,7 +435,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
             myAlleles.add(Allele.NO_CALL);
             myAlleles.add(Allele.NO_CALL);
             //System.out.println(myAlleles.toString());
-            calls.put(sample.getKey(), new Genotype(sample.getKey(), myAlleles, qual, null, g.getAttributes(), false));
+            calls.add(new Genotype(genotype.getSampleName(), myAlleles, qual, null, g.getAttributes(), false));
         }
         return calls;
     }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java
deleted file mode 100755
index 48df8dcb9..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GridSearchAFEstimation.java
+++ /dev/null
@@ -1,270 +0,0 @@
-/*
- * Copyright (c) 2010.
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
- * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.walkers.genotyper;
-
-import org.apache.log4j.Logger;
-import org.broadinstitute.sting.utils.MathUtils;
-import org.broadinstitute.sting.utils.collections.Pair;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-
-import java.io.PrintStream;
-import java.util.*;
-
-public class GridSearchAFEstimation extends AlleleFrequencyCalculationModel {
-
-    // for use in optimizing the P(D|AF) calculations:
-    // how much off from the max likelihoods do we need to be before we can quit calculating?
-    protected static final double LOG10_OPTIMIZATION_EPSILON = 8.0;
-
-    private AlleleFrequencyMatrix AFMatrix;
-
-    protected GridSearchAFEstimation(UnifiedArgumentCollection UAC, int N, Logger logger, PrintStream verboseWriter) {
-        super(UAC, N, logger, verboseWriter);
-        AFMatrix = new AlleleFrequencyMatrix(N);
-    }
-
-    protected void getLog10PNonRef(Map<String, Genotype> GLs, List<Allele> alleles,
-                                   double[] log10AlleleFrequencyPriors,
-                                   double[] log10AlleleFrequencyPosteriors) {
-        initializeAFMatrix(GLs);
-
-        // first, calculate for AF=0 (no change to matrix)
-        log10AlleleFrequencyPosteriors[0] = AFMatrix.getLikelihoodsOfFrequency() + log10AlleleFrequencyPriors[0];
-        double maxLikelihoodSeen = log10AlleleFrequencyPosteriors[0];
-
-        int maxAlleleFrequencyToTest = AFMatrix.getSamples().size() * 2;
-
-        // for each minor allele frequency, calculate log10PofDgivenAFi
-        for (int i = 1; i <= maxAlleleFrequencyToTest; i++) {
-            // add one more alternate allele
-            AFMatrix.incrementFrequency();
-
-            // calculate new likelihoods
-            log10AlleleFrequencyPosteriors[i] = AFMatrix.getLikelihoodsOfFrequency() + log10AlleleFrequencyPriors[i];
-
-            // an optimization to speed up the calculation: if we are beyond the local maximum such
-            //  that subsequent likelihoods won't factor into the confidence score, just quit
-            if ( maxLikelihoodSeen - log10AlleleFrequencyPosteriors[i] > LOG10_OPTIMIZATION_EPSILON )
-                return;
-
-            if ( log10AlleleFrequencyPosteriors[i] > maxLikelihoodSeen )
-                maxLikelihoodSeen = log10AlleleFrequencyPosteriors[i];
-        }
-    }
-
-    /**
-     * Overrides the super class
-     * @param vc                   variant context with genotype likelihoods
-     * @param log10AlleleFrequencyPosteriors    allele frequency results
-     * @param AFofMaxLikelihood    allele frequency of max likelihood
-     *
-     * @return calls
-     */
-    protected GenotypeCollection assignGenotypes(VariantContext vc,
-                                          double[] log10AlleleFrequencyPosteriors,
-                                          int AFofMaxLikelihood) {
-        if ( !vc.isVariant() )
-            throw new UserException("The VCF record passed in does not contain an ALT allele at " + vc.getChr() + ":" + vc.getStart());
-
-        Allele refAllele = vc.getReference();
-        Allele altAllele = vc.getAlternateAllele(0);
-        GenotypeCollection calls = GenotypeCollection.create();
-
-        // first, the potential alt calls
-        for ( String sample : AFMatrix.getSamples() ) {
-            Genotype g = vc.getGenotype(sample);
-
-            // set the genotype and confidence
-            Pair<Integer, Double> AFbasedGenotype = AFMatrix.getGenotype(AFofMaxLikelihood, sample);
-            ArrayList<Allele> myAlleles = new ArrayList<Allele>();
-            if ( AFbasedGenotype.first == GenotypeType.AA.ordinal() ) {
-                myAlleles.add(refAllele);
-                myAlleles.add(refAllele);
-            } else if ( AFbasedGenotype.first == GenotypeType.AB.ordinal() ) {
-                myAlleles.add(refAllele);
-                myAlleles.add(altAllele);
-            } else { // ( AFbasedGenotype.first == GenotypeType.BB.ordinal() )
-                myAlleles.add(altAllele);
-                myAlleles.add(altAllele);
-            }
-
-            calls.put(sample, new Genotype(sample, myAlleles, AFbasedGenotype.second, null, g.getAttributes(), false));
-        }
-
-        return calls;
-    }
-
-    private void initializeAFMatrix(Map<String, Genotype> GLs) {
-        AFMatrix.clear();
-
-        for ( Genotype g : GLs.values() ) {
-            if ( g.hasLikelihoods() )
-                AFMatrix.setLikelihoods(g.getLikelihoods().getAsVector(), g.getSampleName());
-        }
-    }
-
-    protected static class AlleleFrequencyMatrix {
-
-        private double[][] matrix;    // allele frequency matrix
-        private int[] indexes;        // matrix to maintain which genotype is active
-        private int maxN;             // total possible frequencies in data
-        private int frequency;        // current frequency
-
-        // data structures necessary to maintain a list of the best genotypes and their scores
-        private ArrayList<String> samples = new ArrayList<String>();
-        private HashMap<Integer, HashMap<String, Pair<Integer, Double>>> samplesToGenotypesPerAF = new HashMap<Integer, HashMap<String, Pair<Integer, Double>>>();
-
-        public AlleleFrequencyMatrix(int N) {
-            maxN = N;
-            matrix = new double[N][3];
-            indexes = new int[N];
-            clear();
-        }
-
-        public List<String> getSamples() { return samples; }
-
-        public void clear() {
-            frequency = 0;
-            for (int i = 0; i < maxN; i++)
-                indexes[i] = 0;
-            samples.clear();
-            samplesToGenotypesPerAF.clear();
-        }
-
-        public void setLikelihoods(double[] GLs, String sample) {
-            int index = samples.size();
-            samples.add(sample);
-            matrix[index][GenotypeType.AA.ordinal()] = GLs[0];
-            matrix[index][GenotypeType.AB.ordinal()] = GLs[1];
-            matrix[index][GenotypeType.BB.ordinal()] = GLs[2];
-        }
-
-        public void incrementFrequency() {
-            int N = samples.size();
-            if ( frequency == 2 * N )
-                throw new ReviewedStingException("Frequency was incremented past N; how is this possible?");
-            frequency++;
-
-            double greedy = VALUE_NOT_CALCULATED;
-            int greedyIndex = -1;
-            for (int i = 0; i < N; i++) {
-
-                if ( indexes[i] == GenotypeType.AB.ordinal() ) {
-                    if ( matrix[i][GenotypeType.BB.ordinal()] - matrix[i][GenotypeType.AB.ordinal()] > greedy ) {
-                        greedy = matrix[i][GenotypeType.BB.ordinal()] - matrix[i][GenotypeType.AB.ordinal()];
-                        greedyIndex = i;
-                    }
-                }
-                else if ( indexes[i] == GenotypeType.AA.ordinal() ) {
-                    if ( matrix[i][GenotypeType.AB.ordinal()] - matrix[i][GenotypeType.AA.ordinal()] > greedy ) {
-                        greedy = matrix[i][GenotypeType.AB.ordinal()] - matrix[i][GenotypeType.AA.ordinal()];
-                        greedyIndex = i;
-                    }
-                    // note that we currently don't bother with breaking ties between samples
-                    // (which would be done by looking at the HOM_VAR value) because it's highly
-                    // unlikely that a collision will both occur and that the difference will
-                    // be significant at HOM_VAR...
-                }
-                // if this person is already hom var, he can't add another alternate allele
-                // so we can ignore that case
-            }
-            if ( greedyIndex == -1 )
-                throw new ReviewedStingException("There is no best choice for a new alternate allele; how is this possible?");
-
-            if ( indexes[greedyIndex] == GenotypeType.AB.ordinal() )
-                indexes[greedyIndex] = GenotypeType.BB.ordinal();
-            else
-                indexes[greedyIndex] = GenotypeType.AB.ordinal();
-        }
-
-        public double getLikelihoodsOfFrequency() {
-            double likelihoods = 0.0;
-            int N = samples.size();
-            for (int i = 0; i < N; i++)
-                likelihoods += matrix[i][indexes[i]];
-
-            /*
-            System.out.println(frequency);
-            for (int i = 0; i < N; i++) {
-                System.out.print(samples.get(i));
-                for (int j=0; j < 3; j++) {
-                    System.out.print(String.valueOf(matrix[i][j]));
-                    System.out.print(indexes[i] == j ? "* " : " ");
-                }
-                System.out.println();
-            }
-            System.out.println(likelihoods);
-            System.out.println();
-            */
-
-            recordGenotypes();
-
-            return likelihoods;
-        }
-
-        public Pair<Integer, Double> getGenotype(int frequency, String sample) {
-            return samplesToGenotypesPerAF.get(frequency).get(sample);
-        }
-
-        private void recordGenotypes() {
-            HashMap<String, Pair<Integer, Double>> samplesToGenotypes = new HashMap<String, Pair<Integer, Double>>();
-
-            int index = 0;
-            for ( String sample : samples ) {
-                int genotype = indexes[index];
-
-                double score;
-
-                int maxEntry = MathUtils.maxElementIndex(matrix[index]);
-                // if the max value is for the most likely genotype, we can compute next vs. next best
-                if ( genotype == maxEntry ) {
-                    if ( genotype == GenotypeType.AA.ordinal() )
-                        score = matrix[index][genotype] - Math.max(matrix[index][GenotypeType.AB.ordinal()], matrix[index][GenotypeType.BB.ordinal()]);
-                    else if ( genotype == GenotypeType.AB.ordinal() )
-                        score = matrix[index][genotype] - Math.max(matrix[index][GenotypeType.AA.ordinal()], matrix[index][GenotypeType.BB.ordinal()]);
-                    else // ( genotype == GenotypeType.HOM.ordinal() )
-                        score = matrix[index][genotype] - Math.max(matrix[index][GenotypeType.AA.ordinal()], matrix[index][GenotypeType.AB.ordinal()]);
-                }
-                // otherwise, we need to calculate the probability of the genotype
-                else {
-                    double[] normalized = MathUtils.normalizeFromLog10(matrix[index]);
-                    double chosenGenotype = normalized[genotype];
-                    score = -1.0 * Math.log10(1.0 - chosenGenotype);
-                }
-
-                samplesToGenotypes.put(sample, new Pair<Integer, Double>(genotype, Math.abs(score)));
-                index++;
-            }
-
-            samplesToGenotypesPerAF.put(frequency, samplesToGenotypes);
-        }
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
index 81310f15a..71ad0d75a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
@@ -133,7 +133,7 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
         for ( VariantContext vc : VCs ) {
             if ( variantVC == null && vc.isVariant() )
                 variantVC = vc;
-            genotypes.putAll(getGenotypesWithGLs(vc.getGenotypes()));
+            genotypes.addAll(getGenotypesWithGLs(vc.getGenotypes()));
         }
 
         if ( variantVC == null ) {
@@ -143,13 +143,12 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
         return new VariantContext("VCwithGLs", variantVC.getChr(), variantVC.getStart(), variantVC.getEnd(), variantVC.getAlleles(), genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, null);
     }
 
-    private static Map<String, Genotype> getGenotypesWithGLs(Map<String, Genotype> genotypes) {
-        Map<String, Genotype> genotypesWithGLs = new HashMap<String, Genotype>();
-        for ( Map.Entry<String, Genotype> g : genotypes.entrySet() ) {
-            if ( g.getValue().hasLikelihoods() && g.getValue().getLikelihoods().getAsVector() != null )
-                genotypesWithGLs.put(g.getKey(), g.getValue());
+    private static GenotypeCollection getGenotypesWithGLs(GenotypeCollection genotypes) {
+        GenotypeCollection genotypesWithGLs = GenotypeCollection.create(genotypes.size());
+        for ( final Genotype g : genotypes ) {
+            if ( g.hasLikelihoods() && g.getLikelihoods().getAsVector() != null )
+                genotypesWithGLs.add(g);
         }
-
         return genotypesWithGLs;
     }
 }
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
index 72b88100b..a89545a66 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
@@ -281,7 +281,7 @@ public class UnifiedGenotyperEngine {
             attributes.put(VCFConstants.DEPTH_KEY, GL.getDepth());
             attributes.put(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, likelihoods);
 
-            genotypes.put(GL.getSample(), new Genotype(GL.getSample(), noCall, Genotype.NO_NEG_LOG_10PERROR, null, attributes, false));
+            genotypes.add(new Genotype(GL.getSample(), noCall, Genotype.NO_NEG_LOG_10PERROR, null, attributes, false));
         }
 
         GenomeLoc loc = refContext.getLocus();
@@ -811,9 +811,6 @@ public class UnifiedGenotyperEngine {
             case EXACT:
                 afcm = new ExactAFCalculationModel(UAC, N, logger, verboseWriter);
                 break;
-            case GRID_SEARCH:
-                afcm = new GridSearchAFEstimation(UAC, N, logger, verboseWriter);
-                break;
             default: throw new IllegalArgumentException("Unexpected AlleleFrequencyCalculationModel " + UAC.AFmodel);
         }
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
index 7425258d4..dda4a7a09 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
@@ -1059,15 +1059,14 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
         }
 
         GenotypeCollection genotypes = GenotypeCollection.create();
-
         for ( String sample : normalSamples ) {
 
             Map<String,Object> attrs = call.makeStatsAttributes(null);
 
             if ( call.isCall() ) // we made a call - put actual het genotype here:
-                genotypes.put(sample,new Genotype(sample,alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrs,false));
+                genotypes.add(new Genotype(sample,alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrs,false));
             else // no call: genotype is ref/ref (but alleles still contain the alt if we observed anything at all) 
-                genotypes.put(sample,new Genotype(sample, homref_alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrs,false));
+                genotypes.add(new Genotype(sample, homref_alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrs,false));
 
         }
         Set<String> filters = null;
@@ -1151,11 +1150,11 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
         GenotypeCollection genotypes = GenotypeCollection.create();
 
         for ( String sample : normalSamples ) {
-            genotypes.put(sample,new Genotype(sample, homRefN ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsNormal,false));
+            genotypes.add(new Genotype(sample, homRefN ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsNormal,false));
         }
 
         for ( String sample : tumorSamples ) {
-            genotypes.put(sample,new Genotype(sample, homRefT ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsTumor,false) );
+            genotypes.add(new Genotype(sample, homRefT ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsTumor,false) );
         }
 
         Set<String> filters = null;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
index 53cfaa3a9..5ae034b0a 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
@@ -122,7 +122,7 @@ public class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
         if (useSingleSample != null) { // only want to output context for one sample
             Genotype sampGt = vc.getGenotype(useSingleSample);
             if (sampGt != null) // TODO: subContextFromGenotypes() does not handle any INFO fields [AB, HaplotypeScore, MQ, etc.].  Note that even SelectVariants.subsetRecord() only handles AC,AN,AF, and DP!
-                vc = vc.subContextFromGenotypes(sampGt);
+                vc = vc.subContextFromSample(sampGt.getSampleName());
             else // asked for a sample that this vc does not contain, so ignore this vc:
                 return;
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
index b35c54f94..2a3e353ef 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
@@ -293,7 +293,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
         if (tracker != null) {
             VariantContext vc = tracker.getFirstValue(variantCollection.variants, context.getLocation());
 
-            GenotypeCollection genotypeCollection = vc.getGenotypes();
+            GenotypeCollection genotypeCollection = GenotypeCollection.create(vc.getGenotypes().size());
 
             for (Trio trio : trios) {
                 Genotype mother = vc.getGenotype(trio.getMother());
@@ -306,9 +306,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
                 Genotype phasedFather = trioGenotypes.get(1);
                 Genotype phasedChild = trioGenotypes.get(2);
 
-                genotypeCollection.put(phasedMother.getSampleName(), phasedMother);
-                genotypeCollection.put(phasedFather.getSampleName(), phasedFather);
-                genotypeCollection.put(phasedChild.getSampleName(), phasedChild);
+                genotypeCollection.add(phasedMother, phasedFather, phasedChild);
             }
 
             VariantContext newvc = VariantContext.modifyGenotypes(vc, genotypeCollection);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index 132ed1582..82adfe96c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -122,7 +122,8 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
     public int MIN_MAPPING_QUALITY_SCORE = 20;
 
     @Argument(fullName = "sampleToPhase", shortName = "sampleToPhase", doc = "Only include these samples when phasing", required = false)
-    protected List<String> samplesToPhase = null;
+    protected Set
+            <String> samplesToPhase = null;
 
     private GenomeLoc mostDownstreamLocusReached = null;
 
@@ -272,10 +273,10 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
 
     private static final Set<String> KEYS_TO_KEEP_IN_REDUCED_VCF = new HashSet<String>(Arrays.asList(PQ_KEY));
 
-    private VariantContext reduceVCToSamples(VariantContext vc, List<String> samplesToPhase) {
+    private VariantContext reduceVCToSamples(VariantContext vc, Set<String> samplesToPhase) {
 //        for ( String sample : samplesToPhase )
 //            logger.debug(String.format("  Sample %s has genotype %s, het = %s", sample, vc.getGenotype(sample), vc.getGenotype(sample).isHet() ));
-        VariantContext subvc = vc.subContextFromGenotypes(vc.getGenotypes(samplesToPhase).values());
+        VariantContext subvc = vc.subContextFromSamples(samplesToPhase);
 //        logger.debug("original VC = " + vc);
 //        logger.debug("sub      VC = " + subvc);
         return VariantContextUtils.pruneVariantContext(subvc, KEYS_TO_KEEP_IN_REDUCED_VCF);
@@ -354,9 +355,8 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         // Perform per-sample phasing:
         GenotypeCollection sampGenotypes = vc.getGenotypes();
         Map<String, PhaseCounts> samplePhaseStats = new TreeMap<String, PhaseCounts>();
-        for (Map.Entry<String, Genotype> sampGtEntry : sampGenotypes.entrySet()) {
-            String samp = sampGtEntry.getKey();
-            Genotype gt = sampGtEntry.getValue();
+        for (final Genotype gt : sampGenotypes) {
+            String samp = gt.getSampleName();
 
             if (DEBUG) logger.debug("sample = " + samp);
             if (isUnfilteredCalledDiploidGenotype(gt)) {
@@ -1134,7 +1134,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
             this.start = vc.getStart();
             this.stop = vc.getEnd();
             this.alleles = vc.getAlleles();
-            this.genotypes = GenotypeCollection.create(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
+            this.genotypes = GenotypeCollection.copy(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
             this.negLog10PError = vc.getNegLog10PError();
             this.filters = vc.filtersWereApplied() ? vc.getFilters() : null;
             this.attributes = new HashMap<String, Object>(vc.getAttributes());
@@ -1153,7 +1153,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         }
 
         public void setGenotype(String sample, Genotype newGt) {
-            genotypes.put(sample, newGt);
+            genotypes.add(newGt);
         }
 
         public void setPhasingInconsistent() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
index cba2781d8..a134ef5aa 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
@@ -157,8 +157,8 @@ public class CountVariants extends VariantEvaluator implements StandardEval {
         // A    C   A
         // A    C   C
 
-        for (Genotype g : vc1.getGenotypes().values()) {
-            String altStr = vc1.getAlternateAlleles().size() > 0 ? vc1.getAlternateAllele(0).getBaseString().toUpperCase() : null;
+        for (final Genotype g : vc1.getGenotypes()) {
+            final String altStr = vc1.getAlternateAlleles().size() > 0 ? vc1.getAlternateAllele(0).getBaseString().toUpperCase() : null;
 
             switch (g.getType()) {
                 case NO_CALL:
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
index 8cc321ef5..417e340b8 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
@@ -118,7 +118,7 @@ public class G1KPhaseITable extends VariantEvaluator {
         }
 
         // count variants per sample
-        for (final Genotype g : eval.getGenotypes().values()) {
+        for (final Genotype g : eval.getGenotypes()) {
             if ( ! g.isNoCall() && ! g.isHomRef() ) {
                 int count = countsPerSample.get(g.getSampleName()).get(eval.getType());
                 countsPerSample.get(g.getSampleName()).put(eval.getType(), count + 1);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypeConcordance.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypeConcordance.java
index bbd3f5f54..70b37f500 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypeConcordance.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypeConcordance.java
@@ -209,7 +209,7 @@ public class GenotypeConcordance extends VariantEvaluator {
 
     //public GenotypeConcordance(VariantEvalWalker parent) {
     //    super(parent);
-	//	discordantInteresting = parent.DISCORDANT_INTERESTING;
+    //	discordantInteresting = parent.DISCORDANT_INTERESTING;
     //}
 
     public String getName() {
@@ -277,8 +277,9 @@ public class GenotypeConcordance extends VariantEvaluator {
 
         // determine concordance for eval data
         if (eval != null) {
-           for (final String sample : eval.getGenotypes().keySet()) {
-                final Genotype.Type called = eval.getGenotype(sample).getType();
+            for (final Genotype g : eval.getGenotypes() ) {
+                final String sample = g.getSampleName();
+                final Genotype.Type called = g.getType();
                 final Genotype.Type truth;
 
                 if (!validationIsValidVC || !validation.hasGenotype(sample)) {
@@ -299,9 +300,9 @@ public class GenotypeConcordance extends VariantEvaluator {
         else {
             final Genotype.Type called = Genotype.Type.NO_CALL;
 
-            for (final String sample : validation.getGenotypes().keySet()) {
-                final Genotype.Type truth = validation.getGenotype(sample).getType();
-                detailedStats.incrValue(sample, truth, called);
+            for (final Genotype g : validation.getGenotypes()) {
+                final Genotype.Type truth = g.getType();
+                detailedStats.incrValue(g.getSampleName(), truth, called);
 
                 // print out interesting sites
                 /*
@@ -410,8 +411,8 @@ class SampleStats implements TableType {
 
     public SampleStats(VariantContext vc, int nGenotypeTypes) {
         this.nGenotypeTypes = nGenotypeTypes;
-        for (String sample : vc.getGenotypes().keySet())
-            concordanceStats.put(sample, new long[nGenotypeTypes][nGenotypeTypes]);
+        for (final Genotype g : vc.getGenotypes())
+            concordanceStats.put(g.getSampleName(), new long[nGenotypeTypes][nGenotypeTypes]);
     }
 
     public SampleStats(int genotypeTypes) {
@@ -511,8 +512,8 @@ class SampleSummaryStats implements TableType {
 
     public SampleSummaryStats(final VariantContext vc) {
         concordanceSummary.put(ALL_SAMPLES_KEY, new double[COLUMN_KEYS.length]);
-        for( final String sample : vc.getGenotypes().keySet() ) {
-            concordanceSummary.put(sample, new double[COLUMN_KEYS.length]);
+        for( final Genotype g : vc.getGenotypes() ) {
+            concordanceSummary.put(g.getSampleName(), new double[COLUMN_KEYS.length]);
         }
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ThetaVariantEvaluator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ThetaVariantEvaluator.java
index e51623c3c..e1069d2d2 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ThetaVariantEvaluator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ThetaVariantEvaluator.java
@@ -48,7 +48,7 @@ public class ThetaVariantEvaluator extends VariantEvaluator {
         float numGenosHere = 0;
         int numIndsHere = 0;
 
-        for (Genotype genotype : vc.getGenotypes().values()) {
+        for (final Genotype genotype : vc.getGenotypes()) {
             numIndsHere++;
             if (!genotype.isNoCall()) {
                 //increment stats for heterozygosity
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
index e700a733c..24caed549 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
@@ -266,7 +266,7 @@ public class VariantEvalUtils {
      * @return a new VariantContext with just the requested sample
      */
     public VariantContext getSubsetOfVariantContext(VariantContext vc, String sampleName) {
-        return getSubsetOfVariantContext(vc, Arrays.asList(sampleName));
+        return getSubsetOfVariantContext(vc, new HashSet<String>(Arrays.asList(sampleName)));
     }
 
     /**
@@ -276,7 +276,7 @@ public class VariantEvalUtils {
      * @param sampleNames the samples to pull out of the VariantContext
      * @return a new VariantContext with just the requested samples
      */
-    public VariantContext getSubsetOfVariantContext(VariantContext vc, Collection<String> sampleNames) {
+    public VariantContext getSubsetOfVariantContext(VariantContext vc, Set<String> sampleNames) {
         VariantContext vcsub = vc.subContextFromSamples(sampleNames, vc.getAlleles());
 
         HashMap<String, Object> newAts = new HashMap<String, Object>(vcsub.getAttributes());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
index f87ec5d3b..0148a71c2 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
@@ -212,15 +212,15 @@ public class LeftAlignVariants extends RodWalker<Integer, Integer> {
 
         // create new Genotype objects
         GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
-        for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
+        for ( final Genotype genotype : vc.getGenotypes() ) {
             List<Allele> newAlleles = new ArrayList<Allele>();
-            for ( Allele allele : genotype.getValue().getAlleles() ) {
+            for ( Allele allele : genotype.getAlleles() ) {
                 Allele newA = alleleMap.get(allele);
                 if ( newA == null )
                     newA = Allele.NO_CALL;
                 newAlleles.add(newA);
             }
-            newGenotypes.put(genotype.getKey(), Genotype.modifyAlleles(genotype.getValue(), newAlleles));
+            newGenotypes.add(Genotype.modifyAlleles(genotype, newAlleles));
         }
 
         return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), refBaseForIndel);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index 3764a9998..3c92bf00f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -557,7 +557,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
 
         // check if we find it in the variant rod
         GenotypeCollection genotypes = vc.getGenotypes(samples);
-        for (Genotype g : genotypes.values()) {
+        for (final Genotype g : genotypes) {
             if (sampleHasVariant(g)) {
                 // There is a variant called (or filtered with not exclude filtered option set) that is not HomRef for at least one of the samples.
                 if (compVCs == null)
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
index ff7fb3434..27eaa7b5d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
@@ -130,8 +130,7 @@ public class VariantsToVCF extends RodWalker<Integer, Integer> {
             // set the appropriate sample name if necessary
             if ( sampleName != null && vc.hasGenotypes() && vc.hasGenotype(variants.getName()) ) {
                 Genotype g = Genotype.modifyName(vc.getGenotype(variants.getName()), sampleName);
-                GenotypeCollection genotypes = GenotypeCollection.create(1);
-                genotypes.put(sampleName, g);
+                GenotypeCollection genotypes = GenotypeCollection.create(g);
                 vc = VariantContext.modifyGenotypes(vc, genotypes);
             }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
index 0da7a100f..d13002642 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
@@ -451,7 +451,7 @@ public class StandardVCFWriter extends IndexingVCFWriter {
         boolean sawGoodGT = false;
         boolean sawGoodQual = false;
         boolean sawGenotypeFilter = false;
-        for ( Genotype g : vc.getGenotypes().values() ) {
+        for ( final Genotype g : vc.getGenotypes() ) {
             keys.addAll(g.getAttributes().keySet());
             if ( g.isAvailable() )
                 sawGoodGT = true;
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
index 302b93da7..4d6f26e87 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
@@ -180,7 +180,7 @@ public class VCF3Codec extends AbstractVCFCodec {
 
             // add it to the list
             try {
-                genotypes.put(sampleName, new Genotype(sampleName,
+                genotypes.add(new Genotype(sampleName,
                         parseGenotypeAlleles(GTValueArray[genotypeAlleleLocation], alleles, alleleMap),
                         GTQual,
                         genotypeFilters,
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
index 8256c9cac..696b35050 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
@@ -209,13 +209,7 @@ public class VCFCodec extends AbstractVCFCodec {
 
             // add it to the list
             try {
-                genotypes.put(sampleName,
-                        new Genotype(sampleName,
-                                GTalleles,
-                                GTQual,
-                                genotypeFilters,
-                                gtAttributes,
-                                phased));
+                genotypes.add(new Genotype(sampleName, GTalleles, GTQual, genotypeFilters, gtAttributes, phased));
             } catch (TribbleException e) {
                 throw new TribbleException.InternalCodecException(e.getMessage() + ", at position " + chr+":"+pos);
             }
diff --git a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
index 9a900d734..a06fe906f 100644
--- a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
+++ b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
@@ -155,12 +155,12 @@ public class GCF {
         if ( genotypes.isEmpty() )
             return VariantContext.NO_GENOTYPES;
         else {
-            GenotypeCollection map = GenotypeCollection.create();
+            GenotypeCollection map = GenotypeCollection.create(genotypes.size());
 
             for ( int i = 0; i < genotypes.size(); i++ ) {
                 final String sampleName = header.getSample(i);
                 final Genotype g = genotypes.get(i).decode(sampleName, header, this, alleleMap);
-                map.put(sampleName, g);
+                map.add(g);
             }
 
             return map;
@@ -173,7 +173,7 @@ public class GCF {
             List<GCFGenotype> genotypes = new ArrayList<GCFGenotype>(nGenotypes);
             for ( int i = 0; i < nGenotypes; i++ ) genotypes.add(null);
 
-            for ( Genotype g : vc.getGenotypes().values() ) {
+            for ( Genotype g : vc.getGenotypes() ) {
                 int i = GCFHeaderBuilder.encodeSample(g.getSampleName());
                 genotypes.set(i, new GCFGenotype(GCFHeaderBuilder, alleleMap, g));
             }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
index a83356647..f12a8e531 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
@@ -67,20 +67,28 @@ public class GenotypeCollection implements List<Genotype> {
     }
 
     public static final GenotypeCollection create(final int nGenotypes) {
-        return new GenotypeCollection(nGenotypes, true);
+        return new GenotypeCollection(nGenotypes, false);
     }
 
     // todo -- differentiate between empty constructor and copy constructor
     // todo -- create constructor (Genotype ... genotypes)
 
     public static final GenotypeCollection create(final ArrayList<Genotype> genotypes) {
-        return new GenotypeCollection(genotypes, true);
+        return new GenotypeCollection(genotypes, false);
+    }
+
+    public static final GenotypeCollection create(final Genotype... genotypes) {
+        return new GenotypeCollection(new ArrayList<Genotype>(Arrays.asList(genotypes)), false);
     }
 
     public static final GenotypeCollection copy(final GenotypeCollection toCopy) {
         return create(toCopy.genotypes);
     }
 
+    public static final GenotypeCollection copy(final Collection<Genotype> toCopy) {
+        return create(new ArrayList<Genotype>(toCopy));
+    }
+
 //    public static final GenotypeMap create(final Collection<Genotype> genotypes) {
 //        if ( genotypes == null )
 //            return null; // todo -- really should return an empty map
@@ -173,6 +181,12 @@ public class GenotypeCollection implements List<Genotype> {
         return genotypes.add(genotype);
     }
 
+    public boolean add(final Genotype ... genotype) {
+        checkImmutability();
+        invalidateCaches();
+        return genotypes.addAll(Arrays.asList(genotype));
+    }
+
     @Override
     public void add(final int i, final Genotype genotype) {
         throw new UnsupportedOperationException();
@@ -291,7 +305,7 @@ public class GenotypeCollection implements List<Genotype> {
         return genotypes.toArray(ts);
     }
 
-    public Iterable<Genotype> iterateInOrder(final Iterable<String> sampleNamesInOrder) {
+    public Iterable<Genotype> iterateInSampleNameOrder(final Iterable<String> sampleNamesInOrder) {
         return new Iterable<Genotype>() {
             @Override
             public Iterator<Genotype> iterator() {
@@ -300,6 +314,10 @@ public class GenotypeCollection implements List<Genotype> {
         };
     }
 
+    public Iterable<Genotype> iterateInSampleNameOrder() {
+        return iterateInSampleNameOrder(getSampleNamesOrderedByName());
+    }
+
     private final class InOrderIterator implements Iterator<Genotype> {
         final Iterator<String> sampleNamesInOrder;
 
@@ -322,4 +340,41 @@ public class GenotypeCollection implements List<Genotype> {
             throw new UnsupportedOperationException();
         }
     }
+
+    public Set<String> getSampleNames() {
+        buildCache();
+        return sampleNameToOffset.keySet();
+    }
+
+    public Set<String> getSampleNamesOrderedByName() {
+        return new TreeSet<String>(getSampleNames());
+    }
+
+    public boolean containsSample(final String sample) {
+        buildCache();
+        return sampleNameToOffset.containsKey(sample);
+    }
+
+    public boolean containsSamples(final Collection<String> samples) {
+        buildCache();
+        return getSampleNames().containsAll(samples);
+    }
+
+    public GenotypeCollection subsetToSamples( final Collection<String> samples ) {
+        return subsetToSamples(new HashSet<String>(samples));
+    }
+
+    public GenotypeCollection subsetToSamples( final Set<String> samples ) {
+        if ( samples.size() == genotypes.size() )
+            return this;
+        else if ( samples.isEmpty() )
+            return NO_GENOTYPES;
+        else {
+            GenotypeCollection subset = create(samples.size());
+            for ( final Genotype g : genotypes )
+                if ( samples.contains(g.getSampleName()) )
+                    subset.add(g);
+            return subset;
+        }
+    }
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 5bd29a0ce..b394517bf 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -7,6 +7,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFParser;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 
+import java.lang.reflect.Array;
 import java.util.*;
 
 /**
@@ -279,7 +280,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, contig, start, stop, alleles,
-                GenotypeCollection.create(genotypes),
+                GenotypeCollection.copy(genotypes),
                 negLog10PError, filters, attributes, null, false);
     }
 
@@ -423,58 +424,73 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    /**
-     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotype
-     * genotype and alleles in genotype.  This is the right way to test if a single genotype is actually
-     * variant or not.
-     *
-     * @param genotype genotype
-     * @return vc subcontext
-     */
-    public VariantContext subContextFromGenotypes(Genotype genotype) {
-        return subContextFromGenotypes(Arrays.asList(genotype));
-    }
+//    /**
+//     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotype
+//     * genotype and alleles in genotype.  This is the right way to test if a single genotype is actually
+//     * variant or not.
+//     *
+//     * @param genotype genotype
+//     * @return vc subcontext
+//     * @deprecated  replaced by {@link #subContextFromSample(String)}
+//     */
+//    public VariantContext subContextFromGenotypes(Genotype genotype) {
+//        return subContextFromGenotypes(Arrays.asList(genotype));
+//    }
+//
+//
+//    /**
+//     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
+//     * genotypes and alleles in these genotypes.  This is the right way to test if a single genotype is actually
+//     * variant or not.
+//     *
+//     * @param genotypes genotypes
+//     * @return vc subcontext
+//     * @deprecated  replaced by {@link #subContextFromSamples(java.util.Collection)}
+//     */
+//    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes) {
+//        return subContextFromGenotypes(genotypes, allelesOfGenotypes(genotypes)) ;
+//    }
+//
+//    /**
+//     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
+//     * genotypes.  Also, the resulting variant context will contain the alleles provided, not only those found in genotypes
+//     *
+//     * @param genotypes genotypes
+//     * @param alleles the set of allele segregating alleles at this site.  Must include those in genotypes, but may be more
+//     * @return vc subcontext
+//     * @deprecated  replaced by {@link #subContextFromSamples(java.util.Collection, java.util.Collection)}
+//     */
+//    @Deprecated
+//    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes, Collection<Allele> alleles) {
+//        return new VariantContext(getSource(), contig, start, stop, alleles,
+//                GenotypeCollection.create(genotypes),
+//                getNegLog10PError(),
+//                filtersWereApplied() ? getFilters() : null,
+//                getAttributes(),
+//                getReferenceBaseForIndel());
+//    }
 
-
-    /**
-     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
-     * genotypes and alleles in these genotypes.  This is the right way to test if a single genotype is actually
-     * variant or not.
-     *
-     * @param genotypes genotypes
-     * @return vc subcontext
-     */
-    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes) {
-        return subContextFromGenotypes(genotypes, allelesOfGenotypes(genotypes)) ;
-    }
-
-    /**
-     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
-     * genotypes.  Also, the resulting variant context will contain the alleles provided, not only those found in genotypes
-     *
-     * @param genotypes genotypes
-     * @param alleles the set of allele segregating alleles at this site.  Must include those in genotypes, but may be more
-     * @return vc subcontext
-     */
-    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes, Collection<Allele> alleles) {
+    public VariantContext subContextFromSamples(Set<String> sampleNames, Collection<Allele> alleles) {
         return new VariantContext(getSource(), contig, start, stop, alleles,
-                GenotypeCollection.create(genotypes),
+                genotypes.subsetToSamples(sampleNames),
                 getNegLog10PError(),
                 filtersWereApplied() ? getFilters() : null,
                 getAttributes(),
                 getReferenceBaseForIndel());
     }
 
-    public VariantContext subContextFromSamples(Collection<String> sampleNames, Collection<Allele> alleles) {
-        return subContextFromGenotypes(getGenotypes(sampleNames).values(), alleles);
-    }
-
-    public VariantContext subContextFromSamples(Collection<String> sampleNames) {
-        return subContextFromGenotypes(getGenotypes(sampleNames).values());
+    public VariantContext subContextFromSamples(Set<String> sampleNames) {
+        GenotypeCollection newGenotypes = genotypes.subsetToSamples(sampleNames);
+        return new VariantContext(getSource(), contig, start, stop, allelesOfGenotypes(newGenotypes),
+                newGenotypes,
+                getNegLog10PError(),
+                filtersWereApplied() ? getFilters() : null,
+                getAttributes(),
+                getReferenceBaseForIndel());
     }
 
     public VariantContext subContextFromSample(String sampleName) {
-        return subContextFromGenotypes(getGenotype(sampleName));
+        return subContextFromSamples(new HashSet<String>(Arrays.asList(sampleName)));
     }
 
     /**
@@ -875,16 +891,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     public boolean hasGenotypes() {
         loadGenotypes();
-        return genotypes.size() > 0;
+        return ! genotypes.isEmpty();
     }
 
     public boolean hasGenotypes(Collection<String> sampleNames) {
         loadGenotypes();
-        for ( String name : sampleNames ) {
-            if ( ! genotypes.containsKey(name) )
-                return false;
-        }
-        return true;
+        return genotypes.containsSamples(sampleNames);
     }
 
     /**
@@ -895,10 +907,9 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         return genotypes;
     }
 
-    public List<Genotype> getGenotypesSortedByName() {
+    public Iterable<Genotype> getGenotypesSortedByName() {
         loadGenotypes();
-        Collection<Genotype> types = new TreeMap<String,Genotype>(genotypes).values();
-        return new ArrayList<Genotype>(types);
+        return genotypes.iterateInSampleNameOrder();
     }
 
     /**
@@ -922,24 +933,23 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
     public GenotypeCollection getGenotypes(Collection<String> sampleNames) {
-        GenotypeCollection map = GenotypeCollection.create(sampleNames.size());
-
-        for ( String name : sampleNames ) {
-            if ( map.containsKey(name) ) throw new IllegalArgumentException("Duplicate names detected in requested samples " + sampleNames);
-            final Genotype g = getGenotype(name);
-            if ( g != null ) {
-                map.put(name, g);
-            }
-        }
-
-        return map;
+        return getGenotypes().subsetToSamples(sampleNames);
     }
 
+    public GenotypeCollection getGenotypes(Set<String> sampleNames) {
+        return getGenotypes().subsetToSamples(sampleNames);
+    }
+
+
     /**
-     * @return the set of all sample names in this context
+     * @return the set of all sample names in this context, not ordered
      */
     public Set<String> getSampleNames() {
-        return getGenotypes().keySet();
+        return getGenotypes().getSampleNames();
+    }
+
+    public Set<String> getSampleNamesOrderedByName() {
+        return getGenotypes().getSampleNamesOrderedByName();
     }
 
     /**
@@ -952,11 +962,11 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     }
 
     public boolean hasGenotype(String sample) {
-        return getGenotypes().containsKey(sample);
+        return getGenotypes().containsSample(sample);
     }
 
     public Genotype getGenotype(int ith) {
-        return getGenotypesSortedByName().get(ith);
+        return genotypes.get(ith);
     }
 
 
@@ -968,7 +978,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     public int getChromosomeCount() {
         int n = 0;
 
-        for ( Genotype g : getGenotypes().values() ) {
+        for ( final Genotype g : getGenotypes() ) {
             n += g.isNoCall() ? 0 : g.getPloidy();
         }
 
@@ -984,7 +994,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     public int getChromosomeCount(Allele a) {
         int n = 0;
 
-        for ( Genotype g : getGenotypes().values() ) {
+        for ( final Genotype g : getGenotypes() ) {
             n += g.getAlleles(a).size();
         }
 
@@ -1015,7 +1025,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         if ( genotypeCounts == null ) {
             genotypeCounts = new int[Genotype.Type.values().length];
 
-            for ( Genotype g : getGenotypes().values() ) {
+            for ( final Genotype g : getGenotypes() ) {
                 if ( g.isNoCall() )
                     genotypeCounts[Genotype.Type.NO_CALL.ordinal()]++;
                 else if ( g.isHomRef() )
@@ -1136,7 +1146,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         List<Allele> reportedAlleles = getAlleles();
         Set<Allele> observedAlleles = new HashSet<Allele>();
         observedAlleles.add(getReference());
-        for ( Genotype g : getGenotypes().values() ) {
+        for ( final Genotype g : getGenotypes() ) {
             if ( g.isCalled() )
                 observedAlleles.addAll(g.getAlleles());
         }
@@ -1285,12 +1295,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     private void validateGenotypes() {
         if ( this.genotypes == null ) throw new IllegalStateException("Genotypes is null");
 
-        for ( Map.Entry<String, Genotype> elt : this.genotypes.entrySet() ) {
-            String name = elt.getKey();
-            Genotype g = elt.getValue();
-
-            if ( ! name.equals(g.getSampleName()) ) throw new IllegalStateException("Bound sample name " + name + " does not equal the name of the genotype " + g.getSampleName());
-
+        for ( final Genotype g : this.genotypes ) {
             if ( g.isAvailable() ) {
                 for ( Allele gAllele : g.getAlleles() ) {
                     if ( ! hasAllele(gAllele) && gAllele.isCalled() )
@@ -1465,8 +1470,6 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             Byte refByte = inputVC.getReferenceBaseForIndel();
 
             List<Allele> alleles = new ArrayList<Allele>();
-            GenotypeCollection genotypes = GenotypeCollection.create();
-            GenotypeCollection inputGenotypes = inputVC.getGenotypes();
 
             for (Allele a : inputVC.getAlleles()) {
                 // get bases for current allele and create a new one with trimmed bases
@@ -1483,11 +1486,10 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             }
 
             // now we can recreate new genotypes with trimmed alleles
-            for (String sample : inputVC.getSampleNames()) {
-                Genotype g = inputGenotypes.get(sample);
-
+            GenotypeCollection genotypes = GenotypeCollection.create(inputVC.getNSamples());
+            for (final Genotype g : inputVC.getGenotypes() ) {
                 List<Allele> inAlleles = g.getAlleles();
-                List<Allele> newGenotypeAlleles = new ArrayList<Allele>();
+                List<Allele> newGenotypeAlleles = new ArrayList<Allele>(g.getAlleles().size());
                 for (Allele a : inAlleles) {
                     if (a.isCalled()) {
                         if (a.isSymbolic()) {
@@ -1506,8 +1508,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
                         newGenotypeAlleles.add(Allele.NO_CALL);
                     }
                 }
-                genotypes.put(sample, new Genotype(sample, newGenotypeAlleles, g.getNegLog10PError(),
-                        g.getFilters(),g.getAttributes(),g.isPhased()));
+                genotypes.add(new Genotype(g.getSampleName(), newGenotypeAlleles, g.getNegLog10PError(),
+                        g.getFilters(), g.getAttributes(), g.isPhased()));
 
             }
 
@@ -1520,48 +1522,6 @@ public class VariantContext implements Feature { // to enable tribble intergrati
 
     }
 
-    public ArrayList<Allele> getTwoAllelesWithHighestAlleleCounts() {
-        // first idea: get two alleles with highest AC
-        int maxAC1 = 0, maxAC2=0,maxAC1ind =0, maxAC2ind = 0;
-        int i=0;
-        int[] alleleCounts = new int[this.getAlleles().size()];
-        ArrayList<Allele> alleleArray = new ArrayList<Allele>();
-        for (Allele a:this.getAlleles()) {
-            int ac = this.getChromosomeCount(a);
-            if (ac >=maxAC1) {
-                maxAC1 = ac;
-                maxAC1ind = i;
-            }
-            alleleArray.add(a);
-            alleleCounts[i++] = ac;
-        }
-        // now get second best allele
-        for (i=0; i < alleleCounts.length; i++) {
-            if (i == maxAC1ind)
-                continue;
-            if (alleleCounts[i] >= maxAC2) {
-                maxAC2 = alleleCounts[i];
-                maxAC2ind = i;
-            }
-        }
-
-        Allele alleleA, alleleB;
-        if (alleleArray.get(maxAC1ind).isReference()) {
-            alleleA = alleleArray.get(maxAC1ind);
-            alleleB = alleleArray.get(maxAC2ind);
-        }
-        else if  (alleleArray.get(maxAC2ind).isReference()) {
-            alleleA = alleleArray.get(maxAC2ind);
-            alleleB = alleleArray.get(maxAC1ind);
-        } else {
-            alleleA = alleleArray.get(maxAC1ind);
-            alleleB = alleleArray.get(maxAC2ind);
-        }
-        ArrayList<Allele> a = new ArrayList<Allele>();
-        a.add(alleleA);
-        a.add(alleleB);
-        return a;
-    }
     public Allele getAltAlleleWithHighestAlleleCount() {
         // first idea: get two alleles with highest AC
         Allele best = null;
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 89db22bd6..afe48f4f5 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -70,7 +70,7 @@ public class VariantContextUtils {
      * @return VariantContext object
      */
     public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, GenotypeCollection.create(genotypes), negLog10PError, filters, attributes);
+        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, GenotypeCollection.copy(genotypes), negLog10PError, filters, attributes);
     }
 
     /**
@@ -351,10 +351,9 @@ public class VariantContextUtils {
 
         // Genotypes
         final GenotypeCollection genotypes = GenotypeCollection.create(vc.getNSamples());
-        for ( final Genotype g : vc.getGenotypes().values() ) {
+        for ( final Genotype g : vc.getGenotypes() ) {
             Map<String, Object> genotypeAttributes = subsetAttributes(g.commonInfo, keysToPreserve);
-            genotypes.put(g.getSampleName(),
-                    new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.getFilters(),
+            genotypes.add(new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.getFilters(),
                             genotypeAttributes, g.isPhased()));
         }
 
@@ -682,9 +681,9 @@ public class VariantContextUtils {
              if (!hasNullAlleles)
                return inputVC;
            // now we can recreate new genotypes with trimmed alleles
-            for ( Map.Entry<String, Genotype> sample : inputVC.getGenotypes().entrySet() ) {
+            for ( final Genotype genotype : inputVC.getGenotypes() ) {
 
-                List<Allele> originalAlleles = sample.getValue().getAlleles();
+                List<Allele> originalAlleles = genotype.getAlleles();
                 List<Allele> trimmedAlleles = new ArrayList<Allele>();
                 for ( Allele a : originalAlleles ) {
                     if ( a.isCalled() )
@@ -692,7 +691,7 @@ public class VariantContextUtils {
                     else
                         trimmedAlleles.add(Allele.NO_CALL);
                 }
-                genotypes.put(sample.getKey(), Genotype.modifyAlleles(sample.getValue(), trimmedAlleles));
+                genotypes.add(Genotype.modifyAlleles(genotype, trimmedAlleles));
 
             }
             return new VariantContext(inputVC.getSource(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVC.filtersWereApplied() ? inputVC.getFilters() : null, attributes, new Byte(inputVC.getReference().getBases()[0]));
@@ -705,8 +704,8 @@ public class VariantContextUtils {
     public static GenotypeCollection stripPLs(GenotypeCollection genotypes) {
         GenotypeCollection newGs = GenotypeCollection.create(genotypes.size());
 
-        for ( Map.Entry<String, Genotype> g : genotypes.entrySet() ) {
-            newGs.put(g.getKey(), g.getValue().hasLikelihoods() ? removePLs(g.getValue()) : g.getValue());
+        for ( final Genotype g : genotypes ) {
+            newGs.add(g.hasLikelihoods() ? removePLs(g) : g);
         }
 
         return newGs;
@@ -884,9 +883,9 @@ public class VariantContextUtils {
     }
 
     private static void mergeGenotypes(GenotypeCollection mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
-        for ( Genotype g : oneVC.getGenotypes().values() ) {
+        for ( Genotype g : oneVC.getGenotypes() ) {
             String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
-            if ( ! mergedGenotypes.containsKey(name) ) {
+            if ( ! mergedGenotypes.containsSample(name) ) {
                 // only add if the name is new
                 Genotype newG = g;
 
@@ -895,7 +894,7 @@ public class VariantContextUtils {
                     newG = new Genotype(name, alleles, g.getNegLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased());
                 }
 
-                mergedGenotypes.put(name, newG);
+                mergedGenotypes.add(newG);
             }
         }
     }
@@ -924,15 +923,15 @@ public class VariantContextUtils {
 
         // create new Genotype objects
         GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
-        for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
+        for ( final Genotype genotype : vc.getGenotypes() ) {
             List<Allele> newAlleles = new ArrayList<Allele>();
-            for ( Allele allele : genotype.getValue().getAlleles() ) {
+            for ( Allele allele : genotype.getAlleles() ) {
                 Allele newAllele = alleleMap.get(allele);
                 if ( newAllele == null )
                     newAllele = Allele.NO_CALL;
                 newAlleles.add(newAllele);
             }
-            newGenotypes.put(genotype.getKey(), Genotype.modifyAlleles(genotype.getValue(), newAlleles));
+            newGenotypes.add(Genotype.modifyAlleles(genotype, newAlleles));
         }
 
         return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes());
@@ -944,13 +943,13 @@ public class VariantContextUtils {
             return vc;
 
         GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
-        for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
+        for ( final Genotype genotype : vc.getGenotypes() ) {
             Map<String, Object> attrs = new HashMap<String, Object>();
-            for ( Map.Entry<String, Object> attr : genotype.getValue().getAttributes().entrySet() ) {
+            for ( Map.Entry<String, Object> attr : genotype.getAttributes().entrySet() ) {
                 if ( allowedAttributes.contains(attr.getKey()) )
                     attrs.put(attr.getKey(), attr.getValue());
             }
-            newGenotypes.put(genotype.getKey(), Genotype.modifyAttributes(genotype.getValue(), attrs));
+            newGenotypes.add(Genotype.modifyAttributes(genotype, attrs));
         }
 
         return VariantContext.modifyGenotypes(vc, newGenotypes);
@@ -1023,10 +1022,8 @@ public class VariantContextUtils {
         MergedAllelesData mergeData = new MergedAllelesData(intermediateBases, vc1, vc2); // ensures that the reference allele is added
 
         GenotypeCollection mergedGenotypes = GenotypeCollection.create();
-        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
-            String sample = gt1Entry.getKey();
-            Genotype gt1 = gt1Entry.getValue();
-            Genotype gt2 = vc2.getGenotype(sample);
+        for (final Genotype gt1 : vc1.getGenotypes()) {
+            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
 
             List<Allele> site1Alleles = gt1.getAlleles();
             List<Allele> site2Alleles = gt2.getAlleles();
@@ -1052,8 +1049,8 @@ public class VariantContextUtils {
             if (phaseQual.PQ != null)
                 mergedGtAttribs.put(ReadBackedPhasingWalker.PQ_KEY, phaseQual.PQ);
 
-            Genotype mergedGt = new Genotype(sample, mergedAllelesForSample, mergedGQ, mergedGtFilters, mergedGtAttribs, phaseQual.isPhased);
-            mergedGenotypes.put(sample, mergedGt);
+            Genotype mergedGt = new Genotype(gt1.getSampleName(), mergedAllelesForSample, mergedGQ, mergedGtFilters, mergedGtAttribs, phaseQual.isPhased);
+            mergedGenotypes.add(mergedGt);
         }
 
         String mergedName = VariantContextUtils.mergeVariantContextNames(vc1.getSource(), vc2.getSource());
@@ -1197,8 +1194,7 @@ public class VariantContextUtils {
     }
 
     private static boolean allGenotypesAreUnfilteredAndCalled(VariantContext vc) {
-        for (Map.Entry<String, Genotype> gtEntry : vc.getGenotypes().entrySet()) {
-            Genotype gt = gtEntry.getValue();
+        for (final Genotype gt : vc.getGenotypes()) {
             if (gt.isNoCall() || gt.isFiltered())
                 return false;
         }
@@ -1210,10 +1206,8 @@ public class VariantContextUtils {
 
     private static boolean allSamplesAreMergeable(VariantContext vc1, VariantContext vc2) {
         // Check that each sample's genotype in vc2 is uniquely appendable onto its genotype in vc1:
-        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
-            String sample = gt1Entry.getKey();
-            Genotype gt1 = gt1Entry.getValue();
-            Genotype gt2 = vc2.getGenotype(sample);
+        for (final Genotype gt1 : vc1.getGenotypes()) {
+            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
 
             if (!alleleSegregationIsKnown(gt1, gt2)) // can merge if: phased, or if either is a hom
                 return false;
@@ -1275,10 +1269,8 @@ public class VariantContextUtils {
      */
 
     public static boolean someSampleHasDoubleNonReferenceAllele(VariantContext vc1, VariantContext vc2) {
-        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
-            String sample = gt1Entry.getKey();
-            Genotype gt1 = gt1Entry.getValue();
-            Genotype gt2 = vc2.getGenotype(sample);
+        for (final Genotype gt1 : vc1.getGenotypes()) {
+            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
 
             List<Allele> site1Alleles = gt1.getAlleles();
             List<Allele> site2Alleles = gt2.getAlleles();
@@ -1309,10 +1301,8 @@ public class VariantContextUtils {
         allele2ToAllele1.put(vc2.getReference(), vc1.getReference());
 
         // Note the segregation of the alleles for each sample (and check that it is consistent with the reference and all previous samples).
-        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
-            String sample = gt1Entry.getKey();
-            Genotype gt1 = gt1Entry.getValue();
-            Genotype gt2 = vc2.getGenotype(sample);
+        for (final Genotype gt1 : vc1.getGenotypes()) {
+            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
 
             List<Allele> site1Alleles = gt1.getAlleles();
             List<Allele> site2Alleles = gt2.getAlleles();
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java
index 7607049db..181516f33 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java
@@ -37,13 +37,14 @@ import org.broadinstitute.sting.gatk.refdata.VariantContextAdaptors;
 import org.broadinstitute.sting.gatk.walkers.Reference;
 import org.broadinstitute.sting.gatk.walkers.RodWalker;
 import org.broadinstitute.sting.gatk.walkers.Window;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFHeader;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLine;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFWriter;
+import org.broadinstitute.sting.utils.variantcontext.Genotype;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
-import java.util.Arrays;
-import java.util.EnumSet;
-import java.util.List;
+import java.util.*;
 
 /**
  * Test routine for new VariantContext object
@@ -93,7 +94,7 @@ public class TestVariantContextWalker extends RodWalker<Integer, Integer> {
 
                     if ( writer != null && n == 0 ) {
                         if ( ! wroteHeader ) {
-                            writer.writeHeader(VariantContextAdaptors.createVCFHeader(null, vc));
+                            writer.writeHeader(createVCFHeader(vc));
                             wroteHeader = true;
                         }
 
@@ -115,6 +116,10 @@ public class TestVariantContextWalker extends RodWalker<Integer, Integer> {
         }
     }
 
+    private static VCFHeader createVCFHeader(VariantContext vc) {
+        return new VCFHeader(new HashSet<VCFHeaderLine>(), vc.getGenotypes().getSampleNamesSorted());
+    }
+
     public Integer reduceInit() {
         return 0;
     }
diff --git a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
index d698d12a3..f60418155 100644
--- a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
@@ -122,7 +122,7 @@ public class VCFWriterUnitTest extends BaseTest {
         List<Allele> alleles = new ArrayList<Allele>();
         Set<String> filters = null;
         Map<String, Object> attributes = new HashMap<String,Object>();
-        GenotypeCollection genotypes = GenotypeCollection.create();
+        GenotypeCollection genotypes = GenotypeCollection.create(header.getGenotypeSamples().size());
 
         alleles.add(Allele.create("-",true));
         alleles.add(Allele.create("CC",false));
@@ -133,7 +133,7 @@ public class VCFWriterUnitTest extends BaseTest {
             gtattributes.put("BB","1");
             Genotype gt = new Genotype(name,alleles.subList(1,2),0,null,gtattributes,true);
 
-            genotypes.put(name,gt);
+            genotypes.add(gt);
             
         }
         return new VariantContext("RANDOM",loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, 0, filters, attributes, (byte)'A');
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index f5e485587..b21a32174 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -99,7 +99,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
         int start = 10;
         int stop = start; // alleles.contains(ATC) ? start + 3 : start;
         return new VariantContext(source, "1", start, stop, alleles,
-                GenotypeCollection.create(genotypes), 1.0, filters, null, Cref.getBases()[0]);
+                GenotypeCollection.copy(genotypes), 1.0, filters, null, Cref.getBases()[0]);
     }
 
     // --------------------------------------------------------------------------------
@@ -509,7 +509,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
     }
 
     // necessary to not overload equals for genotypes
-    private void assertGenotypesAreMostlyEqual(Map<String, Genotype> actual, Map<String, Genotype> expected) {
+    private void assertGenotypesAreMostlyEqual(GenotypeCollection actual, GenotypeCollection expected) {
         if (actual == expected) {
             return;
         }
@@ -522,10 +522,8 @@ public class VariantContextUtilsUnitTest extends BaseTest {
             Assert.fail("Maps do not have the same size:" + actual.size() + " != " + expected.size());
         }
 
-        for (Map.Entry<String, Genotype> entry : actual.entrySet()) {
-            String key = entry.getKey();
-            Genotype value = entry.getValue();
-            Genotype expectedValue = expected.get(key);
+        for (Genotype value : actual) {
+            Genotype expectedValue = expected.get(value.getSampleName());
 
             Assert.assertEquals(value.alleles, expectedValue.alleles, "Alleles in Genotype aren't equal");
             Assert.assertEquals(value.getNegLog10PError(), expectedValue.getNegLog10PError(), "GQ values aren't equal");
@@ -545,7 +543,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
                 VariantContextUtils.GenotypeMergeType.UNIQUIFY, false, false, "set", false, false);
 
         // test genotypes
-        Assert.assertEquals(merged.getGenotypes().keySet(), new HashSet<String>(Arrays.asList("s1.1", "s1.2")));
+        Assert.assertEquals(merged.getSampleNames(), new HashSet<String>(Arrays.asList("s1.1", "s1.2")));
     }
 
     @Test(expectedExceptions = UserException.class)

From 4ff8225d787bbb96cfd472a186068a4d01e66802 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 14 Nov 2011 17:51:41 -0500
Subject: [PATCH 020/113] GenotypeMap -> GenotypeCollection part 3

-- Test code actually builds
---
 .../gatk/walkers/qc/TestVariantContextWalker.java    |  2 +-
 .../variantcontext/VariantContextBenchmark.java      | 12 ++++--------
 .../utils/variantcontext/VariantContextUnitTest.java | 12 ++++++------
 3 files changed, 11 insertions(+), 15 deletions(-)

diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java
index 181516f33..6bb764f44 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java
@@ -117,7 +117,7 @@ public class TestVariantContextWalker extends RodWalker<Integer, Integer> {
     }
 
     private static VCFHeader createVCFHeader(VariantContext vc) {
-        return new VCFHeader(new HashSet<VCFHeaderLine>(), vc.getGenotypes().getSampleNamesSorted());
+        return new VCFHeader(new HashSet<VCFHeaderLine>(), vc.getGenotypes().getSampleNamesOrderedByName());
     }
 
     public Integer reduceInit() {
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
index 7ad2c5c1b..06ce61627 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -49,7 +49,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
     @Param({"READ", "READ_SUBSET"})
     Operation operation; // set automatically by framework
 
-    @Param({"OF_GENOTYPES", "OF_SAMPLES"})
+    @Param({"OF_SAMPLES"})
     SubContextOp subContextOp; // set automatically by framework
 
     private String INPUT_STRING;
@@ -60,7 +60,6 @@ public class VariantContextBenchmark extends SimpleBenchmark {
     }
 
     public enum SubContextOp {
-        OF_GENOTYPES,
         OF_SAMPLES
     }
 
@@ -91,7 +90,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
             codec.readHeader(lineReader);
 
             int counter = 0;
-            List<String> samples = null;
+            Set<String> samples = null;
             while (counter++ < linesToRead ) {
                 String line = lineReader.readLine();
                 if ( line == null )
@@ -99,7 +98,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
 
                 VariantContext vc = (VariantContext)codec.decode(line);
                 if ( samples == null ) {
-                    samples = new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake);
+                    samples = new HashSet<String>(new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake));
                 }
 
                 if ( op == Operation.READ_SUBSET)
@@ -119,13 +118,10 @@ public class VariantContextBenchmark extends SimpleBenchmark {
         CaliperMain.main(VariantContextBenchmark.class, args);
     }
 
-    private static final void processOneVC(VariantContext vc, List<String> samples, SubContextOp subop) {
+    private static final void processOneVC(VariantContext vc, Set<String> samples, SubContextOp subop) {
         VariantContext sub;
 
         switch ( subop ) {
-            case OF_GENOTYPES:
-                sub = vc.subContextFromGenotypes(vc.getGenotypes(samples).values(), vc.getAlleles());
-                break;
             case OF_SAMPLES:
                 sub = vc.subContextFromSamples(samples, vc.getAlleles());
                 break;
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index 77980267c..8d5505c0e 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -431,12 +431,12 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g5 = new Genotype("--", Arrays.asList(del, del), 10);
         VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop , alleles, Arrays.asList(g1,g2,g3,g4,g5));
 
-        VariantContext vc12 = vc.subContextFromGenotypes(Arrays.asList(g1,g2));
-        VariantContext vc1 = vc.subContextFromGenotypes(Arrays.asList(g1));
-        VariantContext vc23 = vc.subContextFromGenotypes(Arrays.asList(g2, g3));
-        VariantContext vc4 = vc.subContextFromGenotypes(Arrays.asList(g4));
-        VariantContext vc14 = vc.subContextFromGenotypes(Arrays.asList(g1, g4));
-        VariantContext vc5 = vc.subContextFromGenotypes(Arrays.asList(g5));
+        VariantContext vc12 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName(),g2.getSampleName())));
+        VariantContext vc1 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName())));
+        VariantContext vc23 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g2.getSampleName(), g3.getSampleName())));
+        VariantContext vc4 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g4.getSampleName())));
+        VariantContext vc14 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName(), g4.getSampleName())));
+        VariantContext vc5 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g5.getSampleName())));
 
         Assert.assertTrue(vc12.isPolymorphic());
         Assert.assertTrue(vc23.isPolymorphic());

From cde829899dd8c2d65edf0efaa9a9757134925c1a Mon Sep 17 00:00:00 2001
From: Mauricio Carneiro <carneiro@broadinstitute.org>
Date: Mon, 14 Nov 2011 18:07:41 -0500
Subject: [PATCH 022/113] compress Reduce Read counts bytes by offset

compressed the representation of the reduce reads counts by offset results in 17% average compression in final BAM file size.

Example compression -->

from : 10, 10, 11, 11, 12, 12, 12, 11, 10
to:      10, 0, 1, 1,2, 2, 2, 1, 0
---
 .../org/broadinstitute/sting/utils/sam/GATKSAMRecord.java    | 4 +++-
 .../org/broadinstitute/sting/utils/ReadUtilsUnitTest.java    | 5 +++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java b/public/java/src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java
index 3fe1060dd..6d7c8dad9 100755
--- a/public/java/src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java
+++ b/public/java/src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java
@@ -188,7 +188,9 @@ public class GATKSAMRecord extends BAMRecord {
     }
 
     public final byte getReducedCount(final int i) {
-        return getReducedReadCounts()[i];
+        byte firstCount = getReducedReadCounts()[0];
+        byte offsetCount = getReducedReadCounts()[i];
+        return (i==0) ? firstCount : (byte) Math.min(firstCount + offsetCount, Byte.MAX_VALUE);
     }
 
 
diff --git a/public/java/test/org/broadinstitute/sting/utils/ReadUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/ReadUtilsUnitTest.java
index 46134cd24..53368c339 100755
--- a/public/java/test/org/broadinstitute/sting/utils/ReadUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/ReadUtilsUnitTest.java
@@ -16,7 +16,8 @@ public class ReadUtilsUnitTest extends BaseTest {
     GATKSAMRecord read, reducedRead;
     final static String BASES = "ACTG";
     final static String QUALS = "!+5?";
-    final private static byte[] REDUCED_READ_COUNTS = new byte[]{10, 20, 30, 40};
+    final private static byte[] REDUCED_READ_COUNTS =     new byte[]{10, 20, 30, 40};
+    final private static byte[] REDUCED_READ_COUNTS_TAG = new byte[]{10, 10, 20, 30};  // just the offsets
 
     @BeforeTest
     public void init() {
@@ -29,7 +30,7 @@ public class ReadUtilsUnitTest extends BaseTest {
         reducedRead = ArtificialSAMUtils.createArtificialRead(header, "reducedRead", 0, 1, BASES.length());
         reducedRead.setReadBases(BASES.getBytes());
         reducedRead.setBaseQualityString(QUALS);
-        reducedRead.setAttribute(GATKSAMRecord.REDUCED_READ_CONSENSUS_TAG, REDUCED_READ_COUNTS);
+        reducedRead.setAttribute(GATKSAMRecord.REDUCED_READ_CONSENSUS_TAG, REDUCED_READ_COUNTS_TAG);
     }
 
     private void testReadBasesAndQuals(GATKSAMRecord read, int expectedStart, int expectedStop) {

From 284430d61dafcdf47177040bbf416b7501e47168 Mon Sep 17 00:00:00 2001
From: Roger Zurawicki <roger@broadinstitute.org>
Date: Tue, 15 Nov 2011 00:13:52 -0500
Subject: [PATCH 023/113] Added more basic UnitTests for ReadClipper

hardClipByReadCoordinatesWorks
hardClipLowQualTailsWorks
---
 .../utils/clipreads/ReadClipperUnitTest.java  | 206 +++++++++---------
 1 file changed, 103 insertions(+), 103 deletions(-)

diff --git a/public/java/test/org/broadinstitute/sting/utils/clipreads/ReadClipperUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/clipreads/ReadClipperUnitTest.java
index 0c71a845e..ecb5a6d33 100644
--- a/public/java/test/org/broadinstitute/sting/utils/clipreads/ReadClipperUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/clipreads/ReadClipperUnitTest.java
@@ -30,8 +30,7 @@ import org.broadinstitute.sting.BaseTest;
 import org.broadinstitute.sting.utils.sam.ArtificialSAMUtils;
 import org.broadinstitute.sting.utils.sam.GATKSAMRecord;
 import org.testng.Assert;
-import org.testng.annotations.BeforeTest;
-import org.testng.annotations.Test;
+import org.testng.annotations.*;
 
 import java.util.LinkedList;
 import java.util.List;
@@ -47,7 +46,6 @@ public class ReadClipperUnitTest extends BaseTest {
 
     // TODO: Add error messages on failed tests
 
-
     //int debug = 0;
 
     GATKSAMRecord read, expected;
@@ -55,73 +53,6 @@ public class ReadClipperUnitTest extends BaseTest {
     final static String BASES = "ACTG";
     final static String QUALS = "!+5?"; //ASCII values = 33,43,53,63
 
-    // What the test read looks like
-    // Ref:    1 2 3 4 5 6 7 8
-    // Read:   0 1 2 3 - - - -
-    // -----------------------------
-    // Bases:  A C T G - - - -
-    // Quals:  ! + 5 ? - - - -
-
-    @BeforeTest
-    public void init() {
-        SAMFileHeader header = ArtificialSAMUtils.createArtificialSamHeader(1, 1, 1000);
-        read = ArtificialSAMUtils.createArtificialRead(header, "read1", 0, 1, BASES.length());
-        read.setReadBases(new String(BASES).getBytes());
-        read.setBaseQualityString(new String(QUALS));
-
-        readClipper = new ReadClipper(read);
-        //logger.warn(read.getCigarString());
-    }
-
-    @Test ( enabled = true )
-    public void testHardClipBothEndsByReferenceCoordinates() {
-        init();
-        logger.warn("Executing testHardClipBothEndsByReferenceCoordinates");
-        //int debug = 1;
-        //Clip whole read
-        Assert.assertEquals(readClipper.hardClipBothEndsByReferenceCoordinates(1,1), new GATKSAMRecord(read.getHeader()));
-        //clip 1 base
-        expected = readClipper.hardClipBothEndsByReferenceCoordinates(1,4);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(1,3).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,3));
-        Assert.assertEquals(expected.getCigarString(), "1H2M1H");
-
-    }
-
-    @Test ( enabled = false ) // TODO This fails at hardClipCigar and returns a NullPointerException
-    public void testHardClipByReadCoordinates() {
-        init();
-        logger.warn("Executing testHardClipByReadCoordinates");
-
-        //Clip whole read
-        Assert.assertEquals(readClipper.hardClipByReadCoordinates(0,3), new GATKSAMRecord(read.getHeader()));
-
-        //clip 1 base at start
-        System.out.println(readClipper.read.getCigarString());
-        expected = readClipper.hardClipByReadCoordinates(0,0);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(1,4).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,4));
-        Assert.assertEquals(expected.getCigarString(), "1H3M");
-
-        //clip 1 base at end
-        expected = readClipper.hardClipByReadCoordinates(3,3);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(0,3).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,3));
-        Assert.assertEquals(expected.getCigarString(), "3M1H");
-
-        //clip 2 bases at start
-        expected = readClipper.hardClipByReadCoordinates(0,1);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(2,4).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(2,4));
-        Assert.assertEquals(expected.getCigarString(), "2H2M");
-
-        //clip 2 bases at end
-        expected = readClipper.hardClipByReadCoordinates(2,3);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(0,2).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,2));
-        Assert.assertEquals(expected.getCigarString(), "2M2H");
-
-    }
 
     public void testIfEqual( GATKSAMRecord read, byte[] readBases, String baseQuals, String cigar) {
         Assert.assertEquals(read.getReadBases(), readBases);
@@ -145,6 +76,65 @@ public class ReadClipperUnitTest extends BaseTest {
             }
     }
 
+    // What the test read looks like
+    // Ref:    1 2 3 4 5 6 7 8
+    // Read:   0 1 2 3 - - - -
+    // -----------------------------
+    // Bases:  A C T G - - - -
+    // Quals:  ! + 5 ? - - - -
+
+    @BeforeMethod
+    public void init() {
+        SAMFileHeader header = ArtificialSAMUtils.createArtificialSamHeader(1, 1, 1000);
+        read = ArtificialSAMUtils.createArtificialRead(header, "read1", 0, 1, BASES.length());
+        read.setReadBases(new String(BASES).getBytes());
+        read.setBaseQualityString(new String(QUALS));
+
+        readClipper = new ReadClipper(read);
+        //logger.warn(read.getCigarString());
+    }
+
+    @Test ( enabled = true )
+    public void testHardClipBothEndsByReferenceCoordinates() {
+
+        logger.warn("Executing testHardClipBothEndsByReferenceCoordinates");
+        //int debug = 1;
+        //Clip whole read
+        Assert.assertEquals(readClipper.hardClipBothEndsByReferenceCoordinates(1,1), new GATKSAMRecord(read.getHeader()));
+
+        //clip 1 base
+        expected = readClipper.hardClipBothEndsByReferenceCoordinates(1,4);
+        Assert.assertEquals(expected.getReadBases(), BASES.substring(1,3).getBytes());
+        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,3));
+        Assert.assertEquals(expected.getCigarString(), "1H2M1H");
+
+    }
+
+    @Test ( enabled = true )
+    public void testHardClipByReadCoordinates() {
+
+        logger.warn("Executing testHardClipByReadCoordinates");
+
+        //Clip whole read
+        Assert.assertEquals(readClipper.hardClipByReadCoordinates(0,3), new GATKSAMRecord(read.getHeader()));
+
+        List<testParameter> testList = new LinkedList<testParameter>();
+        testList.add(new testParameter(0,0,1,4,"1H3M"));//clip 1 base at start
+        testList.add(new testParameter(3,3,0,3,"3M1H"));//clip 1 base at end
+        testList.add(new testParameter(0,1,2,4,"2H2M"));//clip 2 bases at start
+        testList.add(new testParameter(2,3,0,2,"2M2H"));//clip 2 bases at end
+
+        for ( testParameter p : testList ) {
+            init();
+            //logger.warn("Testing Parameters: " + p.inputStart+","+p.inputStop+","+p.substringStart+","+p.substringStop+","+p.cigar);
+            testIfEqual( readClipper.hardClipByReadCoordinates(p.inputStart, p.inputStop),
+                    BASES.substring(p.substringStart,p.substringStop).getBytes(),
+                    QUALS.substring(p.substringStart,p.substringStop),
+                    p.cigar );
+        }
+
+    }
+
     @Test ( enabled = true )
     public void testHardClipByReferenceCoordinates() {
         logger.warn("Executing testHardClipByReferenceCoordinates");
@@ -178,8 +168,8 @@ public class ReadClipperUnitTest extends BaseTest {
         Assert.assertEquals(readClipper.hardClipByReferenceCoordinatesLeftTail(4), new GATKSAMRecord(read.getHeader()));
 
         List<testParameter> testList = new LinkedList<testParameter>();
-        testList.add(new testParameter(1,-1,1,4,"1H3M"));//clip 1 base at start
-        testList.add(new testParameter(2,-1,2,4,"2H2M"));//clip 2 bases at start
+        testList.add(new testParameter(1, -1, 1, 4, "1H3M"));//clip 1 base at start
+        testList.add(new testParameter(2, -1, 2, 4, "2H2M"));//clip 2 bases at start
 
         for ( testParameter p : testList ) {
             init();
@@ -201,8 +191,8 @@ public class ReadClipperUnitTest extends BaseTest {
         Assert.assertEquals(readClipper.hardClipByReferenceCoordinatesRightTail(1), new GATKSAMRecord(read.getHeader()));
 
         List<testParameter> testList = new LinkedList<testParameter>();
-        testList.add(new testParameter(-1,4,0,3,"3M1H"));//clip 1 base at end
-        testList.add(new testParameter(-1,3,0,2,"2M2H"));//clip 2 bases at end
+        testList.add(new testParameter(-1, 4, 0, 3, "3M1H"));//clip 1 base at end
+        testList.add(new testParameter(-1, 3, 0, 2, "2M2H"));//clip 2 bases at end
 
         for ( testParameter p : testList ) {
             init();
@@ -215,45 +205,55 @@ public class ReadClipperUnitTest extends BaseTest {
 
     }
 
-    @Test ( enabled = false )  // TODO This function is returning null reads
+    @Test ( enabled = true )  // TODO This function is returning null reads
     public void testHardClipLowQualEnds() {
-        init();
-        logger.warn("Executing testHardClipByReferenceCoordinates");
 
+        logger.warn("Executing testHardClipByReferenceCoordinates");
 
         //Clip whole read
         Assert.assertEquals(readClipper.hardClipLowQualEnds((byte)64), new GATKSAMRecord(read.getHeader()));
 
-        //clip 1 base at start
-        expected = readClipper.hardClipLowQualEnds((byte)34);
-        logger.warn(expected.getBaseQualities().toString()+","+expected.getBaseQualityString());
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(1,4).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(1,4));
-        Assert.assertEquals(expected.getCigarString(), "1H3M");
-
-        //clip 2 bases at start
-        expected = readClipper.hardClipLowQualEnds((byte)44);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(2,4).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(2,4));
-        Assert.assertEquals(expected.getCigarString(), "2H2M");
+        List<testParameter> testList = new LinkedList<testParameter>();
+        testList.add(new testParameter(1,-1,1,4,"1H3M"));//clip 1 base at start
+        testList.add(new testParameter(11,-1,2,4,"2H2M"));//clip 2 bases at start
 
+        for ( testParameter p : testList ) {
+            init();
+            //logger.warn("Testing Parameters: " + p.inputStart+","+p.substringStart+","+p.substringStop+","+p.cigar);
+            testIfEqual( readClipper.hardClipLowQualEnds( (byte)p.inputStart ),
+                    BASES.substring(p.substringStart,p.substringStop).getBytes(),
+                    QUALS.substring(p.substringStart,p.substringStop),
+                    p.cigar );
+        }
+     /*      todo find a better way to test lowqual tail clipping on both sides
         // Reverse Quals sequence
-        //readClipper.getRead().setBaseQualityString("?5+!"); // 63,53,43,33
+        readClipper.getRead().setBaseQualityString("?5+!"); // 63,53,43,33
 
-        //clip 1 base at end
-        expected = readClipper.hardClipLowQualEnds((byte)'!');
-        logger.warn(expected.getBaseQualities().toString()+","+expected.getBaseQualityString());
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(0,3).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,3));
-        Assert.assertEquals(expected.getCigarString(), "3M1H");
+        testList = new LinkedList<testParameter>();
+        testList.add(new testParameter(1,-1,0,3,"3M1H"));//clip 1 base at end
+        testList.add(new testParameter(11,-1,0,2,"2M2H"));//clip 2 bases at end
 
-        //clip 2 bases at end
-        expected = readClipper.hardClipLowQualEnds((byte)44);
-        Assert.assertEquals(expected.getReadBases(), BASES.substring(0,2).getBytes());
-        Assert.assertEquals(expected.getBaseQualityString(), QUALS.substring(0,2));
-        Assert.assertEquals(expected.getCigarString(), "2M2H");
+        for ( testParameter p : testList ) {
+            init();
+            readClipper.getRead().setBaseQualityString("?5+!"); // 63,53,43,33
+            //logger.warn("Testing Parameters: " + p.inputStart+","+p.substringStart+","+p.substringStop+","+p.cigar);
+            testIfEqual( readClipper.hardClipLowQualEnds( (byte)p.inputStart ),
+                    BASES.substring(p.substringStart,p.substringStop).getBytes(),
+                    QUALS.substring(p.substringStart,p.substringStop),
+                    p.cigar );
+        }
+        */
+    }
 
-        // revert Qual sequence
-        readClipper.getRead().setBaseQualityString(QUALS);
+    public class CigarReadMaker  {
+
+    }
+
+    @Test ( enabled = false )
+    public void testHardClipSoftClippedBases() {
+
+        // Generate a list of cigars to test
+        // We will use testParameter in the following way
+        // Right tail, left tail,
     }
 }
\ No newline at end of file

From 6e1a86bc3eb2a6031a0c40d83a9979c2f9fde97b Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 15 Nov 2011 09:21:30 -0500
Subject: [PATCH 024/113] Bug fixes to VariantContext and GenotypeCollection

---
 .../sting/utils/variantcontext/GenotypeCollection.java     | 4 ++--
 .../sting/utils/variantcontext/VariantContext.java         | 7 +++++--
 .../utils/variantcontext/VariantContextUtilsUnitTest.java  | 6 ++----
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
index f12a8e531..260543031 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
@@ -74,7 +74,7 @@ public class GenotypeCollection implements List<Genotype> {
     // todo -- create constructor (Genotype ... genotypes)
 
     public static final GenotypeCollection create(final ArrayList<Genotype> genotypes) {
-        return new GenotypeCollection(genotypes, false);
+        return genotypes == null ? NO_GENOTYPES : new GenotypeCollection(genotypes, false);
     }
 
     public static final GenotypeCollection create(final Genotype... genotypes) {
@@ -86,7 +86,7 @@ public class GenotypeCollection implements List<Genotype> {
     }
 
     public static final GenotypeCollection copy(final Collection<Genotype> toCopy) {
-        return create(new ArrayList<Genotype>(toCopy));
+        return toCopy == null ? NO_GENOTYPES : create(new ArrayList<Genotype>(toCopy));
     }
 
 //    public static final GenotypeMap create(final Collection<Genotype> genotypes) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index b394517bf..06efd22d3 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -360,8 +360,11 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         // we need to make this a LinkedHashSet in case the user prefers a given ordering of alleles
         this.alleles = makeAlleles(alleles);
 
-        if ( genotypes == null ) { genotypes = NO_GENOTYPES; }
-        this.genotypes = genotypes;
+        if ( genotypes == null ) {
+            genotypes = NO_GENOTYPES;
+        } else {
+            this.genotypes = genotypes.immutable();
+        }
 
         // cache the REF and ALT alleles
         int nAlleles = alleles.size();
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index b21a32174..8aded831a 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -249,16 +249,14 @@ public class VariantContextUtilsUnitTest extends BaseTest {
         final List<VariantContext> inputs = new ArrayList<VariantContext>();
 
         for ( final String id : cfg.inputs ) {
-            if ( id.equals(".") )
-                snpVC1 = VariantContext.modifyID(snpVC1, id);
-            inputs.add(snpVC1);
+            inputs.add(VariantContext.modifyID(snpVC1, id));
         }
 
         final VariantContext merged = VariantContextUtils.simpleMerge(genomeLocParser,
                 inputs, null,
                 VariantContextUtils.FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED,
                 VariantContextUtils.GenotypeMergeType.UNSORTED, false, false, "set", false, false);
-        Assert.assertEquals(merged.getID(), cfg.expected.equals(".") ? null : cfg.expected);
+        Assert.assertEquals(merged.getID(), cfg.expected);
     }
 
     // --------------------------------------------------------------------------------

From b66556f4a0faf3036275741b07e0bace4df34943 Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Tue, 15 Nov 2011 09:22:57 -0500
Subject: [PATCH 025/113] Update error message so that it's clear ReadPair
 Walkers are exceptions

---
 .../src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java b/public/java/src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java
index f8e87aa58..2ceb4ab46 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java
@@ -480,7 +480,7 @@ public class GenomeAnalysisEngine {
             }
         } else if (walker instanceof ReadPairWalker) {
             if(readsDataSource != null && readsDataSource.getSortOrder() != SAMFileHeader.SortOrder.queryname)
-                throw new UserException.MissortedBAM(SAMFileHeader.SortOrder.queryname, "Read pair walkers can only walk over query name-sorted data.  Please resort your input BAM file.");
+                throw new UserException.MissortedBAM(SAMFileHeader.SortOrder.queryname, "Read pair walkers are exceptions in that they cannot be run on coordinate-sorted BAMs but instead require query name-sorted files.  You will need to resort your input BAM file in query name order to use this walker.");
             if(intervals != null && !intervals.isEmpty())
                 throw new UserException.CommandLineException("Pairs traversal cannot be used in conjunction with intervals.");
 

From b45d10e6f1fc3443b9cfada54f4554f5f2e6d34f Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Tue, 15 Nov 2011 10:23:59 -0500
Subject: [PATCH 026/113] The DP in the FORMAT field (per sample) must also use
 the representative count or else it's always 1 for reduced reads.

---
 .../genotyper/GenotypeLikelihoodsCalculationModel.java | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypeLikelihoodsCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypeLikelihoodsCalculationModel.java
index 489e963e8..74c55dbfe 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypeLikelihoodsCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypeLikelihoodsCalculationModel.java
@@ -26,7 +26,6 @@
 package org.broadinstitute.sting.gatk.walkers.genotyper;
 
 import org.apache.log4j.Logger;
-import org.broadinstitute.sting.commandline.RodBinding;
 import org.broadinstitute.sting.gatk.contexts.AlignmentContext;
 import org.broadinstitute.sting.gatk.contexts.AlignmentContextUtils;
 import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
@@ -36,7 +35,6 @@ import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.pileup.PileupElement;
 import org.broadinstitute.sting.utils.pileup.ReadBackedPileup;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Map;
 
@@ -83,8 +81,7 @@ public abstract class GenotypeLikelihoodsCalculationModel implements Cloneable {
      * @param priors               priors to use for GLs
      * @param GLs                  hash of sample->GL to fill in
      * @param alternateAlleleToUse the alternate allele to use, null if not set
-     *
-     * @param useBAQedPileup
+     * @param useBAQedPileup       should we use the BAQed pileup or the raw one?
      * @return genotype likelihoods per sample for AA, AB, BB
      */
     public abstract Allele getLikelihoods(RefMetaDataTracker tracker,
@@ -93,13 +90,14 @@ public abstract class GenotypeLikelihoodsCalculationModel implements Cloneable {
                                           AlignmentContextUtils.ReadOrientation contextType,
                                           GenotypePriors priors,
                                           Map<String, MultiallelicGenotypeLikelihoods> GLs,
-                                          Allele alternateAlleleToUse, boolean useBAQedPileup);
+                                          Allele alternateAlleleToUse,
+                                          boolean useBAQedPileup);
 
     protected int getFilteredDepth(ReadBackedPileup pileup) {
         int count = 0;
         for ( PileupElement p : pileup ) {
             if ( BaseUtils.isRegularBase( p.getBase() ) )
-                count++;
+                count += p.getRepresentativeCount();
         }
 
         return count;

From 7fada320a9dc36b8ff335dcfbc334b20dd81475b Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Tue, 15 Nov 2011 14:53:27 -0500
Subject: [PATCH 028/113] The right fix for this test is just to delete it.

---
 .../org/broadinstitute/sting/utils/SimpleTimerUnitTest.java  | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/public/java/test/org/broadinstitute/sting/utils/SimpleTimerUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/SimpleTimerUnitTest.java
index 3f5d05e66..7a2696b7b 100755
--- a/public/java/test/org/broadinstitute/sting/utils/SimpleTimerUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/SimpleTimerUnitTest.java
@@ -41,11 +41,6 @@ public class SimpleTimerUnitTest extends BaseTest {
         double t6 = t.getElapsedTime();
         Assert.assertTrue(t5 >= t4, "Restarted timer elapsed time should be after elapsed time preceding the restart");
         Assert.assertTrue(t6 >= t5, "Second elapsed time not after the first in restarted timer");
-
-        t.stop().start();
-        Assert.assertTrue(t.isRunning(), "second started timer isn't running");
-        Assert.assertTrue(t.getElapsedTime() >= 0.0, "elapsed time should have been reset");
-        Assert.assertTrue(t.getElapsedTime() < t6, "elapsed time isn't less than time before start call"); // we should have effective no elapsed time
     }
 
     private final static void idleLoop() {

From 460a51f473e549e4c88eb7db6e6ac56294aaba3b Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 15 Nov 2011 14:56:33 -0500
Subject: [PATCH 029/113] ID field now stored in the VariantContext itself, not
 the attributes

---
 .../gatk/refdata/VariantContextAdaptors.java  |  14 +--
 .../annotator/VariantAnnotatorEngine.java     |  11 +-
 .../beagle/BeagleOutputToVCFWalker.java       |   4 +-
 .../walkers/diffengine/VCFDiffableReader.java |   4 +-
 .../filters/VariantFiltrationWalker.java      |   2 +-
 .../walkers/genotyper/UGCallVariants.java     |   2 +-
 .../genotyper/UnifiedGenotyperEngine.java     |  10 +-
 .../indels/SomaticIndelDetectorWalker.java    |   4 +-
 .../phasing/ReadBackedPhasingWalker.java      |   2 +-
 .../variantutils/LeftAlignVariants.java       |   2 +-
 .../walkers/variantutils/VariantsToTable.java |   2 +-
 .../walkers/variantutils/VariantsToVCF.java   |   8 +-
 .../utils/codecs/vcf/AbstractVCFCodec.java    |  11 +-
 .../utils/codecs/vcf/StandardVCFWriter.java   |   4 +-
 .../broadinstitute/sting/utils/gcf/GCF.java   |   5 +-
 .../utils/variantcontext/VariantContext.java  | 109 +++++++++++++-----
 .../variantcontext/VariantContextUtils.java   |  92 +++------------
 .../refdata/RefMetaDataTrackerUnitTest.java   |   7 +-
 .../utils/genotype/vcf/VCFWriterUnitTest.java |   2 +-
 .../VariantContextUnitTest.java               |  77 +++++++------
 .../VariantContextUtilsUnitTest.java          |   3 +-
 .../VariantJEXLContextUnitTest.java           |   3 +-
 22 files changed, 182 insertions(+), 196 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index 164e1f1cb..c5b8b628a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -6,8 +6,10 @@ import org.broad.tribble.annotation.Strand;
 import org.broad.tribble.dbsnp.OldDbSNPFeature;
 import org.broad.tribble.gelitext.GeliTextFeature;
 import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
+import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.classloader.PluginManager;
 import org.broadinstitute.sting.utils.codecs.hapmap.RawHapMapFeature;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeader;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.*;
@@ -187,7 +189,6 @@ public class VariantContextAdaptors {
                 }
 
                 Map<String, Object> attributes = new HashMap<String, Object>();
-                attributes.put(VariantContext.ID_KEY, dbsnp.getRsID());
 
                 int index = dbsnp.getStart() - ref.getWindow().getStart() - 1;
                 if ( index < 0 )
@@ -195,7 +196,7 @@ public class VariantContextAdaptors {
                 Byte refBaseForIndel = new Byte(ref.getBases()[index]);
 
                 GenotypeCollection genotypes = null;
-                VariantContext vc = new VariantContext(name, dbsnp.getChr(), dbsnp.getStart() - (sawNullAllele ? 1 : 0), dbsnp.getEnd() - (refAllele.isNull() ? 1 : 0), alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, attributes, refBaseForIndel);
+                VariantContext vc = new VariantContext(name, dbsnp.getRsID(), dbsnp.getChr(), dbsnp.getStart() - (sawNullAllele ? 1 : 0), dbsnp.getEnd() - (refAllele.isNull() ? 1 : 0), alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, attributes, refBaseForIndel);
                 return vc;
             } else
                 return null; // can't handle anything else
@@ -255,8 +256,8 @@ public class VariantContextAdaptors {
                 // add the call to the genotype list, and then use this list to create a VariantContext
                 genotypes.add(call);
                 alleles.add(refAllele);
-                VariantContext vc = VariantContextUtils.toVC(name, ref.getGenomeLocParser().createGenomeLoc(geli.getChr(),geli.getStart()), alleles, genotypes, geli.getLODBestToReference(), null, attributes);
-                return vc;
+                GenomeLoc loc = ref.getGenomeLocParser().createGenomeLoc(geli.getChr(),geli.getStart());
+                return new VariantContext(name, VCFConstants.EMPTY_ID_FIELD, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, geli.getLODBestToReference(), null, attributes);
             } else
                 return null; // can't handle anything else
         }
@@ -347,13 +348,10 @@ public class VariantContextAdaptors {
                 genotypes.add(g);
             }
 
-            HashMap<String, Object> attrs = new HashMap<String, Object>(1);
-            attrs.put(VariantContext.ID_KEY, hapmap.getName());
-
             long end = hapmap.getEnd();
             if ( deletionLength > 0 )
                 end += deletionLength;
-            VariantContext vc = new VariantContext(name, hapmap.getChr(), hapmap.getStart(), end, alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, attrs, refBaseForIndel);
+            VariantContext vc = new VariantContext(name, hapmap.getName(), hapmap.getChr(), hapmap.getStart(), end, alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, null, refBaseForIndel);
             return vc;
        }
     }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
index a0bd69be7..48fcdec10 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
@@ -163,11 +163,10 @@ public class VariantAnnotatorEngine {
     }
 
     public VariantContext annotateContext(RefMetaDataTracker tracker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
-
         Map<String, Object> infoAnnotations = new LinkedHashMap<String, Object>(vc.getAttributes());
 
         // annotate db occurrences
-        annotateDBs(tracker, ref, vc, infoAnnotations);
+        vc = annotateDBs(tracker, ref, vc, infoAnnotations);
 
         // annotate expressions where available
         annotateExpressions(tracker, ref, infoAnnotations);
@@ -186,14 +185,14 @@ public class VariantAnnotatorEngine {
         return VariantContext.modifyGenotypes(annotatedVC, annotateGenotypes(tracker, ref, stratifiedContexts, vc));
     }
 
-    private void annotateDBs(RefMetaDataTracker tracker, ReferenceContext ref, VariantContext vc, Map<String, Object> infoAnnotations) {
+    private VariantContext annotateDBs(RefMetaDataTracker tracker, ReferenceContext ref, VariantContext vc, Map<String, Object> infoAnnotations) {
         for ( Map.Entry<RodBinding<VariantContext>, String> dbSet : dbAnnotations.entrySet() ) {
             if ( dbSet.getValue().equals(VCFConstants.DBSNP_KEY) ) {
                 String rsID = VCFUtils.rsIDOfFirstRealVariant(tracker.getValues(dbSet.getKey(), ref.getLocus()), vc.getType());
                 infoAnnotations.put(VCFConstants.DBSNP_KEY, rsID != null);
                 // annotate dbsnp id if available and not already there
-                if ( rsID != null && (!vc.hasID() || vc.getID().equals(VCFConstants.EMPTY_ID_FIELD)) )
-                    infoAnnotations.put(VariantContext.ID_KEY, rsID);
+                if ( rsID != null && vc.emptyID() )
+                    vc = VariantContext.modifyID(vc, rsID);
             } else {
                 boolean overlapsComp = false;
                 for ( VariantContext comp : tracker.getValues(dbSet.getKey(), ref.getLocus()) ) {
@@ -205,6 +204,8 @@ public class VariantAnnotatorEngine {
                 infoAnnotations.put(dbSet.getValue(), overlapsComp);
             }
         }
+
+        return vc;
     }
 
     private void annotateExpressions(RefMetaDataTracker tracker, ReferenceContext ref, Map<String, Object> infoAnnotations) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index c03621280..549c26575 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -333,11 +333,11 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
 
         VariantContext filteredVC;
         if ( beagleVarCounts > 0 || DONT_FILTER_MONOMORPHIC_SITES )
-            filteredVC = new VariantContext("outputvcf", vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), vc_input.getAlleles(), genotypes, vc_input.getNegLog10PError(), vc_input.filtersWereApplied() ? vc_input.getFilters() : null, vc_input.getAttributes());
+            filteredVC = new VariantContext("outputvcf", VCFConstants.EMPTY_ID_FIELD, vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), vc_input.getAlleles(), genotypes, vc_input.getNegLog10PError(), vc_input.filtersWereApplied() ? vc_input.getFilters() : null, vc_input.getAttributes());
         else {
             Set<String> removedFilters = vc_input.filtersWereApplied() ? new HashSet<String>(vc_input.getFilters()) : new HashSet<String>(1);
             removedFilters.add(String.format("BGL_RM_WAS_%s",vc_input.getAlternateAllele(0)));
-            filteredVC = new VariantContext("outputvcf", vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), new HashSet<Allele>(Arrays.asList(vc_input.getReference())), genotypes, vc_input.getNegLog10PError(), removedFilters, vc_input.getAttributes());
+            filteredVC = new VariantContext("outputvcf", VCFConstants.EMPTY_ID_FIELD, vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), new HashSet<Allele>(Arrays.asList(vc_input.getReference())), genotypes, vc_input.getNegLog10PError(), removedFilters, vc_input.getAttributes());
         }
 
         HashMap<String, Object> attributes = new HashMap<String, Object>(filteredVC.getAttributes());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
index 2587b30ef..4b8a703a5 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
@@ -90,7 +90,7 @@ public class VCFDiffableReader implements DiffableReader {
                 // add fields
                 vcRoot.add("CHROM", vc.getChr());
                 vcRoot.add("POS", vc.getStart());
-                vcRoot.add("ID", vc.hasID() ? vc.getID() : VCFConstants.MISSING_VALUE_v4);
+                vcRoot.add("ID", vc.getID());
                 vcRoot.add("REF", vc.getReference());
                 vcRoot.add("ALT", vc.getAlternateAlleles());
                 vcRoot.add("QUAL", vc.hasNegLog10PError() ? vc.getNegLog10PError() * 10 : VCFConstants.MISSING_VALUE_v4);
@@ -98,7 +98,7 @@ public class VCFDiffableReader implements DiffableReader {
 
                 // add info fields
                 for (Map.Entry<String, Object> attribute : vc.getAttributes().entrySet()) {
-                    if ( ! attribute.getKey().startsWith("_") && ! attribute.getKey().equals(VariantContext.ID_KEY))
+                    if ( ! attribute.getKey().startsWith("_") )
                         vcRoot.add(attribute.getKey(), attribute.getValue());
                 }
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
index 81bff7aaa..6f482b6f2 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
@@ -327,7 +327,7 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
         if ( genotypes == null )
             filteredVC = VariantContext.modifyFilters(vc, filters);
         else
-            filteredVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), filters, vc.getAttributes());
+            filteredVC = new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), filters, vc.getAttributes());
 
         writer.add(filteredVC);
     }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
index 71ad0d75a..00317eec6 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
@@ -140,7 +140,7 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
             VariantContext vc = VCs.get(0);
             throw new UserException("There is no ALT allele in any of the VCF records passed in at " + vc.getChr() + ":" + vc.getStart());
         }
-        return new VariantContext("VCwithGLs", variantVC.getChr(), variantVC.getStart(), variantVC.getEnd(), variantVC.getAlleles(), genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, null);
+        return new VariantContext("VCwithGLs", VCFConstants.EMPTY_ID_FIELD, variantVC.getChr(), variantVC.getStart(), variantVC.getEnd(), variantVC.getAlleles(), genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, null);
     }
 
     private static GenotypeCollection getGenotypesWithGLs(GenotypeCollection genotypes) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
index a89545a66..4f87f5eb0 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
@@ -229,7 +229,7 @@ public class UnifiedGenotyperEngine {
             VariantContext vcInput = UnifiedGenotyperEngine.getVCFromAllelesRod(tracker, ref, rawContext.getLocation(), false, logger, UAC.alleles);
             if ( vcInput == null )
                 return null;
-            vc = new VariantContext("UG_call", vcInput.getChr(), vcInput.getStart(), vcInput.getEnd(), vcInput.getAlleles(), VariantContext.NO_NEG_LOG_10PERROR, null, null, ref.getBase());
+            vc = new VariantContext("UG_call", VCFConstants.EMPTY_ID_FIELD, vcInput.getChr(), vcInput.getStart(), vcInput.getEnd(), vcInput.getAlleles(), VariantContext.NO_NEG_LOG_10PERROR, null, null, ref.getBase());
 
         } else {
             // deal with bad/non-standard reference bases
@@ -238,7 +238,7 @@ public class UnifiedGenotyperEngine {
 
             Set<Allele> alleles = new HashSet<Allele>();
             alleles.add(Allele.create(ref.getBase(), true));
-            vc = new VariantContext("UG_call", ref.getLocus().getContig(), ref.getLocus().getStart(), ref.getLocus().getStart(), alleles);
+            vc = new VariantContext("UG_call", VCFConstants.EMPTY_ID_FIELD, ref.getLocus().getContig(), ref.getLocus().getStart(), ref.getLocus().getStart(), alleles);
         }
         
         if ( annotationEngine != null ) {
@@ -288,7 +288,7 @@ public class UnifiedGenotyperEngine {
         int endLoc = calculateEndPos(alleles, refAllele, loc);
 
         return new VariantContext("UG_call",
-                loc.getContig(),
+                VCFConstants.EMPTY_ID_FIELD, loc.getContig(),
                 loc.getStart(),
                 endLoc,
                 alleles,
@@ -420,7 +420,7 @@ public class UnifiedGenotyperEngine {
             myAlleles = new HashSet<Allele>(1);
             myAlleles.add(vc.getReference());
         }
-        VariantContext vcCall = new VariantContext("UG_call", loc.getContig(), loc.getStart(), endLoc,
+        VariantContext vcCall = new VariantContext("UG_call", VCFConstants.EMPTY_ID_FIELD, loc.getContig(), loc.getStart(), endLoc,
                 myAlleles, genotypes, phredScaledConfidence/10.0, passesCallThreshold(phredScaledConfidence) ? null : filter, attributes, refContext.getBase());
 
         if ( annotationEngine != null ) {
@@ -504,7 +504,7 @@ public class UnifiedGenotyperEngine {
             myAlleles = new HashSet<Allele>(1);
             myAlleles.add(vc.getReference());
         }
-        VariantContext vcCall = new VariantContext("UG_call", loc.getContig(), loc.getStart(), endLoc,
+        VariantContext vcCall = new VariantContext("UG_call", VCFConstants.EMPTY_ID_FIELD, loc.getContig(), loc.getStart(), endLoc,
                 myAlleles, genotypes, phredScaledConfidence/10.0, passesCallThreshold(phredScaledConfidence) ? null : filter, attributes, vc.getReferenceBaseForIndel());
 
         return new VariantCallContext(vcCall, confidentlyCalled(phredScaledConfidence, PofF));
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
index dda4a7a09..df1d081c6 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
@@ -1074,7 +1074,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
             filters = new HashSet<String>();
             filters.add("NoCall");
         }
-        VariantContext vc = new VariantContext("IGv2_Indel_call", refName, start, stop, alleles, genotypes,
+        VariantContext vc = new VariantContext("IGv2_Indel_call", VCFConstants.EMPTY_ID_FIELD, refName, start, stop, alleles, genotypes,
             -1.0 /* log error */,  filters, null, refBases[(int)start-1]);
         vcf.add(vc);
     }
@@ -1171,7 +1171,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
             filters.add("TCov");
         }
 
-        VariantContext vc = new VariantContext("IGv2_Indel_call", refName, start, stop, alleles, genotypes,
+        VariantContext vc = new VariantContext("IGv2_Indel_call", VCFConstants.EMPTY_ID_FIELD, refName, start, stop, alleles, genotypes,
             -1.0 /* log error */, filters, attrs, refBases[(int)start-1]);
         vcf.add(vc);
     }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index 82adfe96c..94127438d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -1141,7 +1141,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         }
 
         public VariantContext toVariantContext() {
-            return new VariantContext(name, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
+            return new VariantContext(name, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
         }
 
         public GenomeLoc getLocation() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
index 0148a71c2..71e475fe0 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
@@ -223,6 +223,6 @@ public class LeftAlignVariants extends RodWalker<Integer, Integer> {
             newGenotypes.add(Genotype.modifyAlleles(genotype, newAlleles));
         }
 
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), refBaseForIndel);
+        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), refBaseForIndel);
     }
 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToTable.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToTable.java
index 454909634..2d5f0c14f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToTable.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToTable.java
@@ -315,7 +315,7 @@ public class VariantsToTable extends RodWalker<Integer, Integer> {
         getters.put("FILTER", new Getter() { public String get(VariantContext vc) {
             return vc.isNotFiltered() ? "PASS" : Utils.join(",", vc.getFilters()); }
         });
-        getters.put("ID", new Getter() { public String get(VariantContext vc) { return vc.hasID() ? vc.getID() : "."; } });
+        getters.put("ID", new Getter() { public String get(VariantContext vc) { return vc.getID(); } });
         getters.put("HET", new Getter() { public String get(VariantContext vc) { return Integer.toString(vc.getHetCount()); } });
         getters.put("HOM-REF", new Getter() { public String get(VariantContext vc) { return Integer.toString(vc.getHomRefCount()); } });
         getters.put("HOM-VAR", new Getter() { public String get(VariantContext vc) { return Integer.toString(vc.getHomVarCount()); } });
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
index 27eaa7b5d..89322e9f9 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
@@ -121,10 +121,8 @@ public class VariantsToVCF extends RodWalker<Integer, Integer> {
         Collection<VariantContext> contexts = getVariantContexts(tracker, ref);
 
         for ( VariantContext vc : contexts ) {
-            Map<String, Object> attrs = new HashMap<String, Object>(vc.getAttributes());
-            if ( rsID != null && !vc.hasID() ) {
-                attrs.put(VariantContext.ID_KEY, rsID);
-                vc = VariantContext.modifyAttributes(vc, attrs);
+            if ( rsID != null && vc.emptyID() ) {
+                vc = VariantContext.modifyID(vc, rsID);
             }
 
             // set the appropriate sample name if necessary
@@ -203,7 +201,7 @@ public class VariantsToVCF extends RodWalker<Integer, Integer> {
         while ( dbsnpIterator.hasNext() ) {
             GATKFeature feature = dbsnpIterator.next();
             VariantContext vc = (VariantContext)feature.getUnderlyingObject();
-            if ( vc.hasID() && vc.getID().equals(rsID) )
+            if ( vc.getID().equals(rsID) )
                 return vc;
         }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index ad14e059b..816863b5e 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -264,7 +264,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
         else if ( parts[2].equals(VCFConstants.EMPTY_ID_FIELD) )
             id = VCFConstants.EMPTY_ID_FIELD;
         else
-            id = new String(parts[2]);
+            id = parts[2];
         String ref = getCachedString(parts[3].toUpperCase());
         String alts = getCachedString(parts[4].toUpperCase());
         Double qual = parseQual(parts[5]);
@@ -274,7 +274,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
         // get our alleles, filters, and setup an attribute map
         List<Allele> alleles = parseAlleles(ref, alts, lineNo);
         Set<String> filters = parseFilters(filter);
-        Map<String, Object> attributes = parseInfo(info, id);
+        Map<String, Object> attributes = parseInfo(info);
 
         // find out our current location, and clip the alleles down to their minimum length
         int loc = pos;
@@ -295,7 +295,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
 
         VariantContext vc = null;
         try {
-            vc =  new VariantContext(name, contig, pos, loc, alleles, qual, filters, attributes, ref.getBytes()[0]);
+            vc =  new VariantContext(name, id, contig, pos, loc, alleles, qual, filters, attributes, ref.getBytes()[0]);
         } catch (Exception e) {
             generateException(e.getMessage());
         }
@@ -349,10 +349,9 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
     /**
      * parse out the info fields
      * @param infoField the fields
-     * @param id the indentifier
      * @return a mapping of keys to objects
      */
-    private Map<String, Object> parseInfo(String infoField, String id) {
+    private Map<String, Object> parseInfo(String infoField) {
         Map<String, Object> attributes = new HashMap<String, Object>();
 
         if ( infoField.length() == 0 )
@@ -391,8 +390,6 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
             }
         }
 
-        if ( ! id.equals(VCFConstants.EMPTY_ID_FIELD) )
-            attributes.put(VariantContext.ID_KEY, id);
         return attributes;
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
index d13002642..63c61cfaa 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
@@ -182,7 +182,7 @@ public class StandardVCFWriter extends IndexingVCFWriter {
             mWriter.write(VCFConstants.FIELD_SEPARATOR);
 
             // ID
-            String ID = vc.hasID() ? vc.getID() : VCFConstants.EMPTY_ID_FIELD;
+            String ID = vc.getID();
             mWriter.write(ID);
             mWriter.write(VCFConstants.FIELD_SEPARATOR);
 
@@ -227,7 +227,7 @@ public class StandardVCFWriter extends IndexingVCFWriter {
             Map<String, String> infoFields = new TreeMap<String, String>();
             for ( Map.Entry<String, Object> field : vc.getAttributes().entrySet() ) {
                 String key = field.getKey();
-                if ( key.equals(VariantContext.ID_KEY) || key.equals(VariantContext.UNPARSED_GENOTYPE_MAP_KEY) || key.equals(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY) )
+                if ( key.equals(VariantContext.UNPARSED_GENOTYPE_MAP_KEY) || key.equals(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY) )
                     continue;
 
                 String outputValue = formatVCFField(field.getValue());
diff --git a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
index a06fe906f..20cadc469 100644
--- a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
+++ b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
@@ -25,6 +25,7 @@
 package org.broadinstitute.sting.utils.gcf;
 
 import org.broadinstitute.sting.utils.codecs.vcf.StandardVCFWriter;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
@@ -148,7 +149,7 @@ public class GCF {
         Byte refPadByte = refPad == 0 ? null : refPad;
         GenotypeCollection genotypes = decodeGenotypes(header);
 
-        return new VariantContext(source, contig, start, stop, alleleMap, genotypes, negLog10PError, filters, attributes, refPadByte);
+        return new VariantContext(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleleMap, genotypes, negLog10PError, filters, attributes, refPadByte);
     }
 
     private GenotypeCollection decodeGenotypes(final GCFHeader header) {
@@ -193,7 +194,7 @@ public class GCF {
         boolean first = true;
         for ( Map.Entry<String, Object> field : vc.getAttributes().entrySet() ) {
             String key = field.getKey();
-            if ( key.equals(VariantContext.ID_KEY) || key.equals(VariantContext.UNPARSED_GENOTYPE_MAP_KEY) || key.equals(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY) )
+            if ( key.equals(VariantContext.UNPARSED_GENOTYPE_MAP_KEY) || key.equals(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY) )
                 continue;
             int stringIndex = GCFHeaderBuilder.encodeString(key);
             String outputValue = StandardVCFWriter.formatVCFField(field.getValue());
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index ed5ceaa69..661ed2bf4 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -167,16 +167,19 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     public final static double NO_NEG_LOG_10PERROR = CommonInfo.NO_NEG_LOG_10PERROR;
     public final static String UNPARSED_GENOTYPE_MAP_KEY = "_UNPARSED_GENOTYPE_MAP_";
     public final static String UNPARSED_GENOTYPE_PARSER_KEY = "_UNPARSED_GENOTYPE_PARSER_";
-    public final static String ID_KEY = "ID";
+
+    @Deprecated // ID is no longer stored in the attributes map
+    private final static String ID_KEY = "ID";
 
     private final Byte REFERENCE_BASE_FOR_INDEL;
 
     public final static Set<String> PASSES_FILTERS = Collections.unmodifiableSet(new LinkedHashSet<String>());
 
     /** The location of this VariantContext */
-    protected String contig;
-    protected long start;
-    protected long stop;
+    final protected String contig;
+    final protected long start;
+    final protected long stop;
+    private final String ID;
 
     /** The type (cached for performance reasons) of this context */
     protected Type type = null;
@@ -199,7 +202,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     private Allele ALT = null;
 
     // were filters applied?
-    private boolean filtersWereAppliedToContext;
+    final private boolean filtersWereAppliedToContext;
 
     // ---------------------------------------------------------------------------------------------------------
     //
@@ -223,10 +226,16 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
-        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, true);
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+        this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, true);
     }
 
+    @Deprecated
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel);
+    }
+
+
     /**
      * the complete constructor.  Makes a complete VariantContext from its arguments
      *
@@ -240,8 +249,13 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      */
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+        this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, true);
+    }
+
+    @Deprecated
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, true);
+        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
     }
 
     /**
@@ -261,8 +275,13 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      */
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+        this(source, ID, contig, start, stop, alleles, NO_GENOTYPES, negLog10PError, filters, attributes, referenceBaseForIndel, true, true);
+    }
+
+    @Deprecated
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
-        this(source, contig, start, stop, alleles, NO_GENOTYPES, negLog10PError, filters, attributes, referenceBaseForIndel, true, true);
+        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, negLog10PError, filters, attributes, referenceBaseForIndel);
     }
 
     /**
@@ -278,12 +297,19 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters        filters: use null for unfiltered and empty set for passes filters
      * @param attributes     attributes
      */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        this(source, contig, start, stop, alleles,
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+        this(source, ID, contig, start, stop, alleles,
                 GenotypeCollection.copy(genotypes),
                 negLog10PError, filters, attributes, null, false, true);
     }
 
+    @Deprecated
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles,
+                GenotypeCollection.copy(genotypes),
+                negLog10PError, filters, attributes);
+    }
+
     /**
      * Create a new variant context without genotypes and no Perror, no filters, and no attributes
      *
@@ -293,8 +319,13 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param stop            the stop reference base (one based)
      * @param alleles alleles
      */
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles) {
+        this(source, ID, contig, start, stop, alleles, NO_GENOTYPES, CommonInfo.NO_NEG_LOG_10PERROR, null, null, null, false, true);
+    }
+
+    @Deprecated
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
-        this(source, contig, start, stop, alleles, NO_GENOTYPES, CommonInfo.NO_NEG_LOG_10PERROR, null, null, null, false, true);
+        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles);
     }
 
     /**
@@ -307,8 +338,13 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param alleles   alleles
      * @param genotypes genotypes
      */
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
+        this(source, ID, contig, start, stop, alleles, genotypes, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
+    }
+
+    @Deprecated
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        this(source, contig, start, stop, alleles, genotypes, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
+        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
     }
 
     /**
@@ -317,7 +353,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param other the VariantContext to copy
      */
     public VariantContext(VariantContext other) {
-        this(other.getSource(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, true);
+        this(other.getSource(), other.getID(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, true);
     }
 
     /**
@@ -336,7 +372,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param genotypesAreUnparsed    true if the genotypes have not yet been parsed
      * @param performValidation       if true, call validate() as the final step in construction
      */
-    private VariantContext(String source, String contig, long start, long stop,
+    private VariantContext(String source, String ID,
+                           String contig, long start, long stop,
                            Collection<Allele> alleles, GenotypeCollection genotypes,
                            double negLog10PError, Set<String> filters, Map<String, Object> attributes,
                            Byte referenceBaseForIndel, boolean genotypesAreUnparsed,
@@ -346,6 +383,10 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         this.start = start;
         this.stop = stop;
 
+        // intern for efficiency.  equals calls will generate NPE if ID is inappropriately passed in as null
+        this.ID = ID.equals(VCFConstants.EMPTY_ID_FIELD) ? VCFConstants.EMPTY_ID_FIELD : ID;
+        if ( this.ID.equals("") ) throw new IllegalArgumentException("ID field cannot be the empty string");
+
         if ( !genotypesAreUnparsed && attributes != null ) {
             if ( attributes.containsKey(UNPARSED_GENOTYPE_MAP_KEY) )
                 attributes.remove(UNPARSED_GENOTYPE_MAP_KEY);
@@ -357,13 +398,17 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         filtersWereAppliedToContext = filters != null;
         REFERENCE_BASE_FOR_INDEL = referenceBaseForIndel;
 
+        // todo -- remove me when this check is no longer necessary
+        if ( this.commonInfo.hasAttribute(ID_KEY) )
+            throw new IllegalArgumentException("Trying to create a VariantContext with a ID key.  Please use provided constructor argument ID");
+
         if ( alleles == null ) { throw new IllegalArgumentException("Alleles cannot be null"); }
 
         // we need to make this a LinkedHashSet in case the user prefers a given ordering of alleles
         this.alleles = makeAlleles(alleles);
 
         if ( genotypes == null ) {
-            genotypes = NO_GENOTYPES;
+            this.genotypes = NO_GENOTYPES;
         } else {
             this.genotypes = genotypes.immutable();
         }
@@ -397,13 +442,13 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     // ---------------------------------------------------------------------------------------------------------
 
     public static VariantContext modifyGenotypes(VariantContext vc, GenotypeCollection genotypes) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), vc.getReferenceBaseForIndel(), false, false);
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), vc.getReferenceBaseForIndel(), false, false);
         modifiedVC.validateGenotypes();
         return modifiedVC;
     }
 
     public static VariantContext modifyLocation(VariantContext vc, String chr, int start, int end) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), chr, start, end, vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), vc.getReferenceBaseForIndel(), true, false);
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getID(), chr, start, end, vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), vc.getReferenceBaseForIndel(), true, false);
 
         // Since start and end have changed, we need to call both validateAlleles() and validateReferencePadding(),
         // since those validation routines rely on the values of start and end:
@@ -414,31 +459,31 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     }
 
     public static VariantContext modifyFilters(VariantContext vc, Set<String> filters) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), filters, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
+        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), filters, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
     }
 
     public static VariantContext modifyAttributes(VariantContext vc, Map<String, Object> attributes) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
+        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
     }
 
     public static VariantContext modifyAttribute(VariantContext vc, final String key, final Object value) {
         Map<String, Object> attributes = new HashMap<String, Object>(vc.getAttributes());
         attributes.put(key, value);
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
+        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
     }
 
     public static VariantContext modifyReferencePadding(VariantContext vc, Byte b) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), b, true, false);
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), b, true, false);
         modifiedVC.validateReferencePadding();
         return modifiedVC;
     }
 
     public static VariantContext modifyPErrorFiltersAndAttributes(VariantContext vc, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, negLog10PError, filters, attributes, vc.getReferenceBaseForIndel(), true, false);
+        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, negLog10PError, filters, attributes, vc.getReferenceBaseForIndel(), true, false);
     }
 
     public static VariantContext modifyID(final VariantContext vc, final String id) {
-        return modifyAttribute(vc, ID_KEY, id);
+        return new VariantContext(vc.getSource(), id, vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
     }
 
     // ---------------------------------------------------------------------------------------------------------
@@ -494,7 +539,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
 //    }
 
     public VariantContext subContextFromSamples(Set<String> sampleNames, Collection<Allele> alleles) {
-        return new VariantContext(getSource(), contig, start, stop, alleles,
+        return new VariantContext(getSource(), getID(), contig, start, stop, alleles,
                 genotypes.subsetToSamples(sampleNames),
                 getNegLog10PError(),
                 filtersWereApplied() ? getFilters() : null,
@@ -504,7 +549,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
 
     public VariantContext subContextFromSamples(Set<String> sampleNames) {
         GenotypeCollection newGenotypes = genotypes.subsetToSamples(sampleNames);
-        return new VariantContext(getSource(), contig, start, stop, allelesOfGenotypes(newGenotypes),
+        return new VariantContext(getSource(), getID(), contig, start, stop, allelesOfGenotypes(newGenotypes),
                 newGenotypes,
                 getNegLog10PError(),
                 filtersWereApplied() ? getFilters() : null,
@@ -694,11 +739,15 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     // ---------------------------------------------------------------------------------------------------------
 
     public boolean hasID() {
-        return commonInfo.hasAttribute(ID_KEY);
+        return getID() != VCFConstants.EMPTY_ID_FIELD;
+    }
+
+    public boolean emptyID() {
+        return ! hasID();
     }
 
     public String getID() {
-        return (String)commonInfo.getAttribute(ID_KEY);
+        return ID;
     }
 
     public boolean hasReferenceBaseForIndel() {
@@ -1154,7 +1203,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     }
 
     public void validateRSIDs(Set<String> rsIDs) {
-        if ( rsIDs != null && hasAttribute(VariantContext.ID_KEY) ) {
+        if ( rsIDs != null && hasID() ) {
             for ( String id : getID().split(VCFConstants.ID_FIELD_SEPARATOR) ) {
                 if ( id.startsWith("rs") && !rsIDs.contains(id) )
                     throw new TribbleException.InternalCodecException(String.format("the rsID %s for the record at position %s:%d is not in dbSNP", id, getChr(), getStart()));
@@ -1538,7 +1587,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
 
             // Do not change the filter state if filters were not applied to this context
             Set<String> inputVCFilters = inputVC.filtersWereAppliedToContext ? inputVC.getFilters() : null;
-            return new VariantContext(inputVC.getSource(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVCFilters, inputVC.getAttributes(),refByte);
+            return new VariantContext(inputVC.getSource(), inputVC.getID(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVCFilters, inputVC.getAttributes(),refByte);
         }
         else
             return inputVC;
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index afe48f4f5..acd3ac0d2 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -57,55 +57,6 @@ public class VariantContextUtils {
         engine.setLenient(false);
     }
 
-    /**
-     * Create a new VariantContext
-     *
-     * @param name            name
-     * @param loc             location
-     * @param alleles         alleles
-     * @param genotypes       genotypes set
-     * @param negLog10PError  qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     * @return VariantContext object
-     */
-    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, GenotypeCollection.copy(genotypes), negLog10PError, filters, attributes);
-    }
-
-    /**
-     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
-     * @param name            name
-     * @param loc             location
-     * @param alleles         alleles
-     * @return VariantContext object
-     */
-    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles) {
-        return new VariantContext (name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, VariantContext.NO_GENOTYPES, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    /**
-     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
-     * @param name            name
-     * @param loc             location
-     * @param alleles         alleles
-     * @param genotypes       genotypes
-     * @return VariantContext object
-     */
-    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    /**
-     * Copy constructor
-     *
-     * @param other the VariantContext to copy
-     * @return VariantContext object
-     */
-    public static VariantContext toVC(VariantContext other) {
-        return new VariantContext(other.getSource(), other.getChr(), other.getStart(), other.getEnd(), other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.getFilters(), other.getAttributes());
-    }
-
     /**
      * Update the attributes of the attributes map given the VariantContext to reflect the proper chromosome-based VCF tags
      *
@@ -345,19 +296,15 @@ public class VariantContextUtils {
         // VC info
         final Map<String, Object> attributes = subsetAttributes(vc.commonInfo, keysToPreserve);
 
-        // this must be done as the ID is stored in the attributes field
-        // todo -- remove me when ID becomes a first class field in VC
-        if ( vc.hasID() ) attributes.put(VariantContext.ID_KEY, vc.getID());
-
         // Genotypes
         final GenotypeCollection genotypes = GenotypeCollection.create(vc.getNSamples());
         for ( final Genotype g : vc.getGenotypes() ) {
             Map<String, Object> genotypeAttributes = subsetAttributes(g.commonInfo, keysToPreserve);
             genotypes.add(new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.getFilters(),
-                            genotypeAttributes, g.isPhased()));
+                    genotypeAttributes, g.isPhased()));
         }
 
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(),
+        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(),
                 vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.getFilters(), attributes);
     }
 
@@ -494,7 +441,7 @@ public class VariantContextUtils {
             //
             if (vc.hasAttribute(VCFConstants.DEPTH_KEY))
                 depth += vc.getAttributeAsInt(VCFConstants.DEPTH_KEY, 0);
-            if ( vc.hasID() && ! vc.getID().equals(VCFConstants.EMPTY_ID_FIELD) ) rsIDs.add(vc.getID());
+            if ( vc.hasID() ) rsIDs.add(vc.getID());
             if (mergeInfoWithMaxAC && vc.hasAttribute(VCFConstants.ALLELE_COUNT_KEY)) {
                 String rawAlleleCounts = vc.getAttributeAsString(VCFConstants.ALLELE_COUNT_KEY, null);
                 // lets see if the string contains a , separator
@@ -587,11 +534,9 @@ public class VariantContextUtils {
         if ( depth > 0 )
             attributes.put(VCFConstants.DEPTH_KEY, String.valueOf(depth));
 
-        if ( ! rsIDs.isEmpty() ) {
-            attributes.put(VariantContext.ID_KEY, Utils.join(",", rsIDs));
-        }
+        final String ID = rsIDs.isEmpty() ? VCFConstants.EMPTY_ID_FIELD : Utils.join(",", rsIDs);
 
-        VariantContext merged = new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, negLog10PError, filters, (mergeInfoWithMaxAC ? attributesWithMaxAC : attributes) );
+        VariantContext merged = new VariantContext(name, ID, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, negLog10PError, filters, (mergeInfoWithMaxAC ? attributesWithMaxAC : attributes) );
         // Trim the padded bases of all alleles if necessary
         merged = createVariantContextWithTrimmedAlleles(merged);
 
@@ -694,7 +639,7 @@ public class VariantContextUtils {
                 genotypes.add(Genotype.modifyAlleles(genotype, trimmedAlleles));
 
             }
-            return new VariantContext(inputVC.getSource(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVC.filtersWereApplied() ? inputVC.getFilters() : null, attributes, new Byte(inputVC.getReference().getBases()[0]));
+            return new VariantContext(inputVC.getSource(), inputVC.getID(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVC.filtersWereApplied() ? inputVC.getFilters() : null, attributes, new Byte(inputVC.getReference().getBases()[0]));
 
         }
 
@@ -934,7 +879,7 @@ public class VariantContextUtils {
             newGenotypes.add(Genotype.modifyAlleles(genotype, newAlleles));
         }
 
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes());
+        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes());
 
     }
 
@@ -1058,7 +1003,14 @@ public class VariantContextUtils {
         Set<String> mergedFilters = new HashSet<String>(); // Since vc1 and vc2 were unfiltered, the merged record remains unfiltered
         Map<String, Object> mergedAttribs = VariantContextUtils.mergeVariantContextAttributes(vc1, vc2);
 
-        VariantContext mergedVc = new VariantContext(mergedName, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles(), mergedGenotypes, mergedNegLog10PError, mergedFilters, mergedAttribs);
+        // ids
+        List<String> mergedIDs = new ArrayList<String>();
+        if ( vc1.hasID() ) mergedIDs.add(vc1.getID());
+        if ( vc2.hasID() ) mergedIDs.add(vc2.getID());
+        String mergedID = Utils.join(VCFConstants.ID_FIELD_SEPARATOR, mergedIDs);
+
+        // TODO -- FIX ID
+        VariantContext mergedVc = new VariantContext(mergedName, mergedID, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles(), mergedGenotypes, mergedNegLog10PError, mergedFilters, mergedAttribs);
 
         mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
         VariantContextUtils.calculateChromosomeCounts(mergedVc, mergedAttribs, true);
@@ -1154,20 +1106,6 @@ public class VariantContextUtils {
             mergedAttribs.put(orAttrib, attribVal);
         }
 
-        // Merge ID fields:
-        String iDVal = null;
-        for (VariantContext vc : vcList) {
-            String val = vc.getAttributeAsString(VariantContext.ID_KEY, null);
-            if (val != null && !val.equals(VCFConstants.EMPTY_ID_FIELD)) {
-                if (iDVal == null)
-                    iDVal = val;
-                else
-                    iDVal += VCFConstants.ID_FIELD_SEPARATOR + val;
-            }
-        }
-        if (iDVal != null)
-            mergedAttribs.put(VariantContext.ID_KEY, iDVal);
-
         return mergedAttribs;
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/gatk/refdata/RefMetaDataTrackerUnitTest.java b/public/java/test/org/broadinstitute/sting/gatk/refdata/RefMetaDataTrackerUnitTest.java
index 1e39fd26f..43e93de1a 100644
--- a/public/java/test/org/broadinstitute/sting/gatk/refdata/RefMetaDataTrackerUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/refdata/RefMetaDataTrackerUnitTest.java
@@ -36,6 +36,7 @@ import org.broadinstitute.sting.gatk.refdata.utils.GATKFeature;
 import org.broadinstitute.sting.gatk.refdata.utils.RODRecordList;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.GenomeLocParser;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.sam.ArtificialSAMUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
@@ -65,9 +66,9 @@ public class RefMetaDataTrackerUnitTest {
         C = Allele.create("C");
         G = Allele.create("G");
         T = Allele.create("T");
-        AC_SNP = new VariantContext("x", "chr1", START_POS, START_POS, Arrays.asList(A, C));
-        AG_SNP = new VariantContext("x", "chr1", START_POS, START_POS, Arrays.asList(A, G));
-        AT_SNP = new VariantContext("x", "chr1", START_POS, START_POS, Arrays.asList(A, T));
+        AC_SNP = new VariantContext("x", VCFConstants.EMPTY_ID_FIELD, "chr1", START_POS, START_POS, Arrays.asList(A, C));
+        AG_SNP = new VariantContext("x", VCFConstants.EMPTY_ID_FIELD, "chr1", START_POS, START_POS, Arrays.asList(A, G));
+        AT_SNP = new VariantContext("x", VCFConstants.EMPTY_ID_FIELD, "chr1", START_POS, START_POS, Arrays.asList(A, T));
         span10_10 = makeSpan(10, 10);
         span1_20 = makeSpan(1, 20);
         span10_20 = makeSpan(10, 20);
diff --git a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
index f60418155..ad38b46e3 100644
--- a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
@@ -136,7 +136,7 @@ public class VCFWriterUnitTest extends BaseTest {
             genotypes.add(gt);
             
         }
-        return new VariantContext("RANDOM",loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, 0, filters, attributes, (byte)'A');
+        return new VariantContext("RANDOM", VCFConstants.EMPTY_ID_FIELD, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, 0, filters, attributes, (byte)'A');
 
 
     }
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index 8d5505c0e..f63209dc1 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -6,6 +6,7 @@ package org.broadinstitute.sting.utils.variantcontext;
 
 
 import org.broadinstitute.sting.BaseTest;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.testng.annotations.BeforeSuite;
 import org.testng.annotations.DataProvider;
 import org.testng.annotations.Test;
@@ -67,68 +68,68 @@ public class VariantContextUnitTest extends BaseTest {
 
         // test REF
         List<Allele> alleles = Arrays.asList(Tref);
-        VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles);
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
         Assert.assertEquals(vc.getType(), VariantContext.Type.NO_VARIATION);
 
         // test SNPs
         alleles = Arrays.asList(Tref, A);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles);
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
         Assert.assertEquals(vc.getType(), VariantContext.Type.SNP);
 
         alleles = Arrays.asList(Tref, A, C);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles);
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
         Assert.assertEquals(vc.getType(), VariantContext.Type.SNP);
 
         // test MNPs
         alleles = Arrays.asList(ACref, TA);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles);
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles);
         Assert.assertEquals(vc.getType(), VariantContext.Type.MNP);
 
         alleles = Arrays.asList(ATCref, CAT, Allele.create("GGG"));
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles);
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles);
         Assert.assertEquals(vc.getType(), VariantContext.Type.MNP);
 
         // test INDELs
         alleles = Arrays.asList(Aref, ATC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(Tref, TA, TC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A, AC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A, Allele.create("ATCTC"));
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         // test MIXED
         alleles = Arrays.asList(TAref, T, TC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(TAref, T, AC);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(ACref, ATC, AT);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(Aref, T, symbolic);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         // test SYMBOLIC
         alleles = Arrays.asList(Tref, symbolic);
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.SYMBOLIC);
     }
 
@@ -136,8 +137,8 @@ public class VariantContextUnitTest extends BaseTest {
     public void testMultipleSNPAlleleOrdering() {
         final List<Allele> allelesNaturalOrder = Arrays.asList(Aref, C, T);
         final List<Allele> allelesUnnaturalOrder = Arrays.asList(Aref, T, C);
-        VariantContext naturalVC = new VariantContext("natural", snpLoc, snpLocStart, snpLocStop, allelesNaturalOrder);
-        VariantContext unnaturalVC = new VariantContext("unnatural", snpLoc, snpLocStart, snpLocStop, allelesUnnaturalOrder);
+        VariantContext naturalVC = new VariantContext("natural", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, allelesNaturalOrder);
+        VariantContext unnaturalVC = new VariantContext("unnatural", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, allelesUnnaturalOrder);
         Assert.assertEquals(new ArrayList<Allele>(naturalVC.getAlleles()), allelesNaturalOrder);
         Assert.assertEquals(new ArrayList<Allele>(unnaturalVC.getAlleles()), allelesUnnaturalOrder);
     }
@@ -146,7 +147,7 @@ public class VariantContextUnitTest extends BaseTest {
     public void testCreatingSNPVariantContext() {
 
         List<Allele> alleles = Arrays.asList(Aref, T);
-        VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles);
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
 
         Assert.assertEquals(vc.getChr(), snpLoc);
         Assert.assertEquals(vc.getStart(), snpLocStart);
@@ -173,7 +174,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingRefVariantContext() {
          List<Allele> alleles = Arrays.asList(Aref);
-        VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles);
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
 
         Assert.assertEquals(vc.getChr(), snpLoc);
         Assert.assertEquals(vc.getStart(), snpLocStart);
@@ -199,7 +200,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingDeletionVariantContext() {
         List<Allele> alleles = Arrays.asList(ATCref, del);
-        VariantContext vc = new VariantContext("test", delLoc, delLocStart, delLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, delLoc, delLocStart, delLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getChr(), delLoc);
         Assert.assertEquals(vc.getStart(), delLocStart);
@@ -226,7 +227,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingInsertionVariantContext() {
         List<Allele> alleles = Arrays.asList(delRef, ATC);
-        VariantContext vc = new VariantContext("test", insLoc, insLocStart, insLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getChr(), insLoc);
         Assert.assertEquals(vc.getStart(), insLocStart);
@@ -253,7 +254,7 @@ public class VariantContextUnitTest extends BaseTest {
     public void testCreatingPartiallyCalledGenotype() {
         List<Allele> alleles = Arrays.asList(Aref, C);
         Genotype g = new Genotype("foo", Arrays.asList(C, Allele.NO_CALL), 10);
-        VariantContext vc = new VariantContext("test", snpLoc, snpLocStart, snpLocStop, alleles, Arrays.asList(g));
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, alleles, Arrays.asList(g));
 
         Assert.assertTrue(vc.isSNP());
         Assert.assertEquals(vc.getNAlleles(), 2);
@@ -274,38 +275,38 @@ public class VariantContextUnitTest extends BaseTest {
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgs1() {
-        new VariantContext("test", insLoc, insLocStart, insLocStop, Arrays.asList(delRef, ATCref));
+        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(delRef, ATCref));
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgs2() {
-        new VariantContext("test", insLoc, insLocStart, insLocStop, Arrays.asList(delRef, del));
+        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(delRef, del));
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgs3() {
-        new VariantContext("test", insLoc, insLocStart, insLocStop, Arrays.asList(del));
+        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(del));
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgs4() {
-        new VariantContext("test", insLoc, insLocStart, insLocStop, Collections.<Allele>emptyList());
+        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Collections.<Allele>emptyList());
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgsDuplicateAlleles1() {
-        new VariantContext("test", insLoc, insLocStart, insLocStop, Arrays.asList(Aref, T, T));
+        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(Aref, T, T));
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgsDuplicateAlleles2() {
-        new VariantContext("test", insLoc, insLocStart, insLocStop, Arrays.asList(Aref, A));
+        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(Aref, A));
     }
 
     @Test (expectedExceptions = IllegalStateException.class)
     public void testBadLoc1() {
         List<Allele> alleles = Arrays.asList(Aref, T, del);
-        new VariantContext("test", delLoc, delLocStart, delLocStop, alleles);
+        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, delLoc, delLocStart, delLocStop, alleles);
     }
 
     @Test
@@ -316,7 +317,7 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
         Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
 
-        VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3));
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3));
 
         Assert.assertTrue(vc.hasGenotypes());
         Assert.assertFalse(vc.isMonomorphic());
@@ -355,7 +356,7 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g5 = new Genotype("dd", Arrays.asList(del, del), 10);
         Genotype g6 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
 
-        VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3, g4, g5, g6));
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3, g4, g5, g6));
 
         Assert.assertTrue(vc.hasGenotypes());
         Assert.assertFalse(vc.isMonomorphic());
@@ -380,7 +381,7 @@ public class VariantContextUnitTest extends BaseTest {
             Genotype g1 = new Genotype("AA1", Arrays.asList(Aref, Aref), 10);
             Genotype g2 = new Genotype("AA2", Arrays.asList(Aref, Aref), 10);
             Genotype g3 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
-            VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3));
+            VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3));
 
             Assert.assertTrue(vc.hasGenotypes());
             Assert.assertTrue(vc.isMonomorphic());
@@ -400,21 +401,21 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
         Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
 
-        VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2));
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2));
 
         Assert.assertTrue(vc.isNotFiltered());
         Assert.assertFalse(vc.isFiltered());
         Assert.assertEquals(0, vc.getFilters().size());
 
         Set<String> filters = new HashSet<String>(Arrays.asList("BAD_SNP_BAD!"));
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2), VariantContext.NO_NEG_LOG_10PERROR, filters, null);
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2), VariantContext.NO_NEG_LOG_10PERROR, filters, null);
 
         Assert.assertFalse(vc.isNotFiltered());
         Assert.assertTrue(vc.isFiltered());
         Assert.assertEquals(1, vc.getFilters().size());
 
         filters = new HashSet<String>(Arrays.asList("BAD_SNP_BAD!", "REALLY_BAD_SNP", "CHRIST_THIS_IS_TERRIBLE"));
-        vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2), VariantContext.NO_NEG_LOG_10PERROR, filters, null);
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2), VariantContext.NO_NEG_LOG_10PERROR, filters, null);
 
         Assert.assertFalse(vc.isNotFiltered());
         Assert.assertTrue(vc.isFiltered());
@@ -429,9 +430,9 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
         Genotype g4 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
         Genotype g5 = new Genotype("--", Arrays.asList(del, del), 10);
-        VariantContext vc = new VariantContext("test", snpLoc,snpLocStart, snpLocStop , alleles, Arrays.asList(g1,g2,g3,g4,g5));
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop , alleles, Arrays.asList(g1,g2,g3,g4,g5));
 
-        VariantContext vc12 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName(),g2.getSampleName())));
+        VariantContext vc12 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName(), g2.getSampleName())));
         VariantContext vc1 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName())));
         VariantContext vc23 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g2.getSampleName(), g3.getSampleName())));
         VariantContext vc4 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g4.getSampleName())));
@@ -514,7 +515,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test(dataProvider = "getAlleles")
     public void testMergeAlleles(GetAllelesTest cfg) {
         final List<Allele> altAlleles = cfg.alleles.subList(1, cfg.alleles.size());
-        final VariantContext vc = new VariantContext("test", snpLoc, snpLocStart, snpLocStop, cfg.alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        final VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, cfg.alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getAlleles(), cfg.alleles, "VC alleles not the same as input alleles");
         Assert.assertEquals(vc.getNAlleles(), cfg.alleles.size(), "VC getNAlleles not the same as input alleles size");
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index 8aded831a..dbe131a14 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -26,6 +26,7 @@ package org.broadinstitute.sting.utils.variantcontext;
 import net.sf.picard.reference.IndexedFastaSequenceFile;
 import org.broadinstitute.sting.BaseTest;
 import org.broadinstitute.sting.utils.GenomeLocParser;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.fasta.CachingIndexedFastaSequenceFile;
 import org.testng.Assert;
@@ -98,7 +99,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
     private VariantContext makeVC(String source, List<Allele> alleles, Collection<Genotype> genotypes, Set<String> filters) {
         int start = 10;
         int stop = start; // alleles.contains(ATC) ? start + 3 : start;
-        return new VariantContext(source, "1", start, stop, alleles,
+        return new VariantContext(source, VCFConstants.EMPTY_ID_FIELD, "1", start, stop, alleles,
                 GenotypeCollection.copy(genotypes), 1.0, filters, null, Cref.getBases()[0]);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContextUnitTest.java
index b5f6b1b1a..85a2532ef 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContextUnitTest.java
@@ -24,6 +24,7 @@
 package org.broadinstitute.sting.utils.variantcontext;
 
 import net.sf.samtools.SAMFileHeader;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.testng.Assert;
 import org.broadinstitute.sting.BaseTest;
 import org.broadinstitute.sting.utils.GenomeLoc;
@@ -143,7 +144,7 @@ public class VariantJEXLContextUnitTest extends BaseTest {
     private JEXLMap getVarContext() {
         List<Allele> alleles = Arrays.asList(Aref, T);
 
-        VariantContext vc = new VariantContext("test", snpLoc.getContig(), snpLoc.getStart(), snpLoc.getStop(), alleles);
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc.getContig(), snpLoc.getStart(), snpLoc.getStop(), alleles);
         return new JEXLMap(Arrays.asList(exp),vc);
     }
 

From 2b2514dad282bd60d44aec107334776fe0fe9063 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 15 Nov 2011 16:14:50 -0500
Subject: [PATCH 030/113] Moved many unused phasing walkers and utilities to
 archive

---
 .../sting/gatk/walkers/phasing/BaseArray.java |   2 +-
 .../walkers/phasing/CardinalityCounter.java   |   2 +-
 .../phasing/CloneableIteratorLinkedList.java  |   2 +-
 .../walkers/phasing}/DisjointSet.java         |   4 +-
 .../sting/gatk/walkers/phasing/Haplotype.java |   2 +-
 .../gatk/walkers/phasing/MergeMNPsWalker.java | 133 ------
 ...eSegregatingAlternateAllelesVCFWriter.java |  45 +-
 ...ergeSegregatingAlternateAllelesWalker.java | 236 -----------
 .../gatk/walkers/phasing/PhasingGraph.java    |   4 +-
 .../walkers/phasing/PhasingGraphEdge.java     |   2 +-
 .../gatk/walkers/phasing/PhasingRead.java     |   2 +-
 .../gatk/walkers/phasing/PhasingUtils.java    | 387 ++++++++++++++++++
 .../phasing/PreciseNonNegativeDouble.java     |   2 +-
 .../phasing/ReadBackedPhasingWalker.java      |   3 +-
 .../sting/gatk/walkers/phasing/ReadBase.java  |   2 +-
 .../walkers/phasing/ReadBasesAtPosition.java  |   2 +-
 .../walkers/phasing/RefSeqDataParser.java     | 189 ---------
 .../gatk/walkers/phasing/SNPallelePair.java   |   2 +-
 .../sting/gatk/walkers/phasing/WriteVCF.java  |  34 --
 .../variantcontext/VariantContextUtils.java   | 341 +--------------
 20 files changed, 411 insertions(+), 985 deletions(-)
 rename public/java/src/org/broadinstitute/sting/{utils => gatk/walkers/phasing}/DisjointSet.java (97%)
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeMNPsWalker.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesWalker.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/RefSeqDataParser.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/WriteVCF.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/BaseArray.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/BaseArray.java
index 5a32479ab..54838b55e 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/BaseArray.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/BaseArray.java
@@ -29,7 +29,7 @@ import java.util.Arrays;
 import java.util.LinkedList;
 import java.util.List;
 
-public abstract class BaseArray implements Comparable<BaseArray> {
+abstract class BaseArray implements Comparable<BaseArray> {
     protected Byte[] bases;
 
     public BaseArray(byte[] bases) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/CardinalityCounter.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/CardinalityCounter.java
index 06f4d3ab2..45a1ab04c 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/CardinalityCounter.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/CardinalityCounter.java
@@ -30,7 +30,7 @@ import java.util.Iterator;
 /*
 * CardinalityCounter object allows user to iterate over all assignment of arbitrary-cardinality variables.
  */
-public class CardinalityCounter implements Iterator<int[]>, Iterable<int[]> {
+class CardinalityCounter implements Iterator<int[]>, Iterable<int[]> {
     private int[] cards;
     private int[] valList;
     private boolean hasNext;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/CloneableIteratorLinkedList.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/CloneableIteratorLinkedList.java
index 4ec940f4f..e88a7104d 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/CloneableIteratorLinkedList.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/CloneableIteratorLinkedList.java
@@ -30,7 +30,7 @@ import java.util.NoSuchElementException;
   It is UNIQUE in the fact that its iterator (BidirectionalIterator) can be cloned
   to save the current pointer for a later time (while the original iterator can continue to iterate).
  */
-public class CloneableIteratorLinkedList<E> {
+class CloneableIteratorLinkedList<E> {
     private CloneableIteratorDoublyLinkedNode<E> first;
     private CloneableIteratorDoublyLinkedNode<E> last;
     private int size;
diff --git a/public/java/src/org/broadinstitute/sting/utils/DisjointSet.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/DisjointSet.java
similarity index 97%
rename from public/java/src/org/broadinstitute/sting/utils/DisjointSet.java
rename to public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/DisjointSet.java
index 52c18e6d6..c054af5d6 100644
--- a/public/java/src/org/broadinstitute/sting/utils/DisjointSet.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/DisjointSet.java
@@ -21,13 +21,13 @@
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  * OTHER DEALINGS IN THE SOFTWARE.
  */
-package org.broadinstitute.sting.utils;
+package org.broadinstitute.sting.gatk.walkers.phasing;
 
 import java.util.Collection;
 import java.util.Set;
 import java.util.TreeSet;
 
-public class DisjointSet {
+class DisjointSet {
     private ItemNode[] nodes;
 
     public DisjointSet(int numItems) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/Haplotype.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/Haplotype.java
index 3c20a311e..61d5a725e 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/Haplotype.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/Haplotype.java
@@ -27,7 +27,7 @@ import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 
 import java.util.Arrays;
 
-public class Haplotype extends BaseArray implements Cloneable {
+class Haplotype extends BaseArray implements Cloneable {
     public Haplotype(byte[] bases) {
         super(bases);
     }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeMNPsWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeMNPsWalker.java
deleted file mode 100644
index 809772c05..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeMNPsWalker.java
+++ /dev/null
@@ -1,133 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.walkers.phasing;
-
-import org.broadinstitute.sting.commandline.Argument;
-import org.broadinstitute.sting.commandline.Input;
-import org.broadinstitute.sting.commandline.Output;
-import org.broadinstitute.sting.commandline.RodBinding;
-import org.broadinstitute.sting.gatk.contexts.AlignmentContext;
-import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
-import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
-import org.broadinstitute.sting.gatk.walkers.*;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFHeader;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLine;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFUtils;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFWriter;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-
-import java.util.*;
-
-import static org.broadinstitute.sting.utils.codecs.vcf.VCFUtils.getVCFHeadersFromRods;
-
-
-/**
- * Walks along all variant ROD loci, and merges consecutive sites if they segregate in all samples in the ROD.
- */
-@Allows(value = {DataSource.REFERENCE})
-@Requires(value = {DataSource.REFERENCE})
-@By(DataSource.REFERENCE_ORDERED_DATA)
-
-public class MergeMNPsWalker extends RodWalker<Integer, Integer> {
-
-    @Output(doc = "File to which variants should be written", required = true)
-    protected VCFWriter writer = null;
-    private MergeSegregatingAlternateAllelesVCFWriter vcMergerWriter = null;
-
-    @Argument(fullName = "maxGenomicDistanceForMNP", shortName = "maxDistMNP", doc = "The maximum reference-genome distance between consecutive heterozygous sites to permit merging phased VCF records into a MNP record; [default:1]", required = false)
-    protected int maxGenomicDistanceForMNP = 1;
-
-    @Input(fullName="variant", shortName = "V", doc="Select variants from this VCF file", required=true)
-    public RodBinding<VariantContext> variants;
-
-    public void initialize() {
-        initializeVcfWriter();
-    }
-
-    private void initializeVcfWriter() {
-        // false <-> don't take control of writer, since didn't create it:
-        vcMergerWriter = new MergeSegregatingAlternateAllelesVCFWriter(writer, getToolkit().getGenomeLocParser(), getToolkit().getArguments().referenceFile, maxGenomicDistanceForMNP, logger, false);
-        writer = null; // so it can't be accessed directly [i.e., not through vcMergerWriter]
-
-        // setup the header fields:
-        Set<VCFHeaderLine> hInfo = new HashSet<VCFHeaderLine>();
-        hInfo.addAll(VCFUtils.getHeaderFields(getToolkit()));
-        hInfo.add(new VCFHeaderLine("reference", getToolkit().getArguments().referenceFile.getName()));
-
-        Map<String, VCFHeader> rodNameToHeader = getVCFHeadersFromRods(getToolkit(), Arrays.asList(variants.getName()));
-        vcMergerWriter.writeHeader(new VCFHeader(hInfo, new TreeSet<String>(rodNameToHeader.get(variants.getName()).getGenotypeSamples())));
-    }
-
-    public boolean generateExtendedEvents() {
-        return false;
-    }
-
-    public Integer reduceInit() {
-        return 0;
-    }
-
-    /**
-     * For each site, send it to be (possibly) merged with previously observed sites.
-     *
-     * @param tracker the meta-data tracker
-     * @param ref     the reference base
-     * @param context the context for the given locus
-     * @return dummy Integer
-     */
-    public Integer map(RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        if (tracker == null)
-            return null;
-
-        for (VariantContext vc : tracker.getValues(variants, context.getLocation()))
-            writeVCF(vc);
-
-        return 0;
-    }
-
-    private void writeVCF(VariantContext vc) {
-        WriteVCF.writeVCF(vc, vcMergerWriter, logger);
-    }
-
-    public Integer reduce(Integer result, Integer total) {
-        if (result == null)
-            return total;
-
-        return total + result;
-    }
-
-    /**
-     * Release any VariantContexts not yet processed.
-     *
-     * @param result Empty for now...
-     */
-    public void onTraversalDone(Integer result) {
-        vcMergerWriter.close();
-
-        System.out.println("Number of successive pairs of records: " + vcMergerWriter.getNumRecordsAttemptToMerge());
-        System.out.println("Number of potentially merged records (" + vcMergerWriter.getVcMergeRule() + "): " + vcMergerWriter.getNumRecordsSatisfyingMergeRule());
-        System.out.println("Number of records merged ("+ vcMergerWriter.getAlleleMergeRule() + "): " + vcMergerWriter.getNumMergedRecords());
-        System.out.println(vcMergerWriter.getAltAlleleStats());
-    }
-}
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
index 5ae034b0a..b935600b2 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2010, The Broad Institute
+ * Copyright (c) 2011, The Broad Institute
  *
  * Permission is hereby granted, free of charge, to any person
  * obtaining a copy of this software and associated documentation
@@ -44,7 +44,7 @@ import java.util.*;
 
 // Streams in VariantContext objects and streams out VariantContexts produced by merging phased segregating polymorphisms into MNP VariantContexts
 
-public class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
+class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
     private VCFWriter innerWriter;
 
     private GenomeLocParser genomeLocParser;
@@ -52,7 +52,7 @@ public class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
     private ReferenceSequenceFile referenceFileForMNPmerging;
 
     private VariantContextMergeRule vcMergeRule;
-    private VariantContextUtils.AlleleMergeRule alleleMergeRule;
+    private PhasingUtils.AlleleMergeRule alleleMergeRule;
 
     private String useSingleSample = null;
 
@@ -71,7 +71,7 @@ public class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
     // Should we call innerWriter.close() in close()
     private boolean takeOwnershipOfInner;
 
-    public MergeSegregatingAlternateAllelesVCFWriter(VCFWriter innerWriter, GenomeLocParser genomeLocParser, File referenceFile, VariantContextMergeRule vcMergeRule, VariantContextUtils.AlleleMergeRule alleleMergeRule, String singleSample, boolean emitOnlyMergedRecords, Logger logger, boolean takeOwnershipOfInner, boolean trackAltAlleleStats) {
+    public MergeSegregatingAlternateAllelesVCFWriter(VCFWriter innerWriter, GenomeLocParser genomeLocParser, File referenceFile, VariantContextMergeRule vcMergeRule, PhasingUtils.AlleleMergeRule alleleMergeRule, String singleSample, boolean emitOnlyMergedRecords, Logger logger, boolean takeOwnershipOfInner, boolean trackAltAlleleStats) {
         this.innerWriter = innerWriter;
         this.genomeLocParser = genomeLocParser;
         try {
@@ -179,7 +179,7 @@ public class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
                 boolean mergedRecords = false;
                 if (shouldAttemptToMerge) {
                     numRecordsSatisfyingMergeRule++;
-                    VariantContext mergedVc = VariantContextUtils.mergeIntoMNP(genomeLocParser, vcfrWaitingToMerge.vc, vc, referenceFileForMNPmerging, alleleMergeRule);
+                    VariantContext mergedVc = PhasingUtils.mergeIntoMNP(genomeLocParser, vcfrWaitingToMerge.vc, vc, referenceFileForMNPmerging, alleleMergeRule);
 
                     if (mergedVc != null) {
                         mergedRecords = true;
@@ -218,26 +218,6 @@ public class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
         filteredVcfrList.clear();
     }
 
-    public int getNumRecordsAttemptToMerge() {
-        return numRecordsAttemptToMerge;
-    }
-
-    public int getNumRecordsSatisfyingMergeRule() {
-        return numRecordsSatisfyingMergeRule;
-    }
-
-    public int getNumMergedRecords() {
-        return numMergedRecords;
-    }
-
-    public VariantContextMergeRule getVcMergeRule() {
-        return vcMergeRule;
-    }
-
-    public VariantContextUtils.AlleleMergeRule getAlleleMergeRule() {
-        return alleleMergeRule;
-    }
-
     /**
      * Gets a string representation of this object.
      *
@@ -248,13 +228,6 @@ public class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
         return getClass().getName();
     }
 
-    public String getAltAlleleStats() {
-        if (altAlleleStats == null)
-            return "";
-
-        return "\n" + altAlleleStats.toString();
-    }
-
     private static class VCFRecord {
         public VariantContext vc;
         public boolean resultedFromMerge;
@@ -373,7 +346,7 @@ public class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
                     if (shouldAttemptToMerge) {
                         aas.numSuccessiveGenotypesAttemptedToBeMerged++;
 
-                        if (!VariantContextUtils.alleleSegregationIsKnown(gt1, gt2)) {
+                        if (!PhasingUtils.alleleSegregationIsKnown(gt1, gt2)) {
                             aas.segregationUnknown++;
                             logger.debug("Unknown segregation of alleles [not phased] for " + samp + " at " + VariantContextUtils.getLocation(genomeLocParser, vc1) + ", " + VariantContextUtils.getLocation(genomeLocParser, vc2));
                         }
@@ -498,9 +471,9 @@ class DistanceMergeRule extends VariantContextMergeRule {
 }
 
 
-class ExistsDoubleAltAlleleMergeRule extends VariantContextUtils.AlleleMergeRule {
+class ExistsDoubleAltAlleleMergeRule extends PhasingUtils.AlleleMergeRule {
     public boolean allelesShouldBeMerged(VariantContext vc1, VariantContext vc2) {
-        return VariantContextUtils.someSampleHasDoubleNonReferenceAllele(vc1, vc2);
+        return PhasingUtils.someSampleHasDoubleNonReferenceAllele(vc1, vc2);
     }
 
     public String toString() {
@@ -515,7 +488,7 @@ class SegregatingMNPmergeAllelesRule extends ExistsDoubleAltAlleleMergeRule {
 
     public boolean allelesShouldBeMerged(VariantContext vc1, VariantContext vc2) {
         // Must be interesting AND consistent:
-        return super.allelesShouldBeMerged(vc1, vc2) && VariantContextUtils.doubleAllelesSegregatePerfectlyAmongSamples(vc1, vc2);
+        return super.allelesShouldBeMerged(vc1, vc2) && PhasingUtils.doubleAllelesSegregatePerfectlyAmongSamples(vc1, vc2);
     }
 
     public String toString() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesWalker.java
deleted file mode 100644
index 96d5c471f..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesWalker.java
+++ /dev/null
@@ -1,236 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.walkers.phasing;
-
-import org.broadinstitute.sting.commandline.*;
-import org.broadinstitute.sting.gatk.contexts.AlignmentContext;
-import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
-import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
-import org.broadinstitute.sting.gatk.walkers.*;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFHeader;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLine;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFUtils;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFWriter;
-import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
-
-import java.util.*;
-
-import static org.broadinstitute.sting.utils.codecs.vcf.VCFUtils.getVCFHeadersFromRods;
-
-/**
- * Walks along all variant ROD loci, and merges consecutive sites if some sample has segregating alt alleles in the ROD.
- */
-@Allows(value = {DataSource.REFERENCE})
-@Requires(value = {DataSource.REFERENCE})
-@By(DataSource.REFERENCE_ORDERED_DATA)
-
-public class MergeSegregatingAlternateAllelesWalker extends RodWalker<Integer, Integer> {
-
-    @Output(doc = "File to which variants should be written", required = true)
-    protected VCFWriter writer = null;
-    private MergeSegregatingAlternateAllelesVCFWriter vcMergerWriter = null;
-
-    @Argument(fullName = "maxGenomicDistance", shortName = "maxDist", doc = "The maximum reference-genome distance between consecutive heterozygous sites to permit merging phased VCF records; [default:1]", required = false)
-    protected int maxGenomicDistance = 1;
-
-    @Argument(fullName = "useSingleSample", shortName = "useSample", doc = "Only output genotypes for the single sample given; [default:use all samples]", required = false)
-    protected String useSingleSample = null;
-
-    @Hidden
-    @Argument(fullName = "emitOnlyMergedRecords", shortName = "emitOnlyMerged", doc = "Only output records that resulted from merging [For DEBUGGING purposes only - DO NOT USE, since it disregards the semantics of '|' as 'phased relative to previous non-filtered VC']; [default:false]", required = false)
-    protected boolean emitOnlyMergedRecords = false;
-
-    @Argument(fullName = "disablePrintAltAlleleStats", shortName = "noAlleleStats", doc = "Should the print-out of alternate allele statistics be disabled?; [default:false]", required = false)
-    protected boolean disablePrintAlternateAlleleStatistics = false;
-
-    public final static String IGNORE_REFSEQ = "IGNORE";
-    public final static String UNION_REFSEQ = "UNION";
-    public final static String INTERSECT_REFSEQ = "INTERSECT";
-
-    @Argument(fullName = "mergeBasedOnRefSeqAnnotation", shortName = "mergeBasedOnRefSeqAnnotation", doc = "'Should merging be performed if two sites lie on the same RefSeq sequence in the INFO field {" + IGNORE_REFSEQ + ", " + UNION_REFSEQ + ", " + INTERSECT_REFSEQ + "}; [default:" + IGNORE_REFSEQ + "]", required = false)
-    protected String mergeBasedOnRefSeqAnnotation = IGNORE_REFSEQ;
-
-    @Argument(fullName = "dontRequireSomeSampleHasDoubleAltAllele", shortName = "dontRequireSomeSampleHasDoubleAltAllele", doc = "Should the requirement, that SUCCESSIVE records to be merged have at least one sample with a double alternate allele, be relaxed?; [default:false]", required = false)
-    protected boolean dontRequireSomeSampleHasDoubleAltAllele = false;
-
-    @Input(fullName="variant", shortName = "V", doc="Select variants from this VCF file", required=true)
-    public RodBinding<VariantContext> variants;
-
-    public void initialize() {
-        initializeVcfWriter();
-    }
-
-    private void initializeVcfWriter() {
-        GenomeLocParser genomeLocParser = getToolkit().getGenomeLocParser();
-
-        VariantContextMergeRule vcMergeRule;
-        if (mergeBasedOnRefSeqAnnotation.equals(IGNORE_REFSEQ))
-            vcMergeRule = new DistanceMergeRule(maxGenomicDistance, genomeLocParser);
-        else
-            vcMergeRule = new SameGenePlusWithinDistanceMergeRule(maxGenomicDistance, genomeLocParser, mergeBasedOnRefSeqAnnotation);
-
-        VariantContextUtils.AlleleMergeRule alleleMergeRule;
-        if (dontRequireSomeSampleHasDoubleAltAllele) // if a pair of VariantContext passes the vcMergeRule, then always merge them if there is a trailing prefix of polymorphisms (i.e., upstream polymorphic site):
-            alleleMergeRule = new PrefixPolymorphismMergeAllelesRule();
-        else
-            alleleMergeRule = new ExistsDoubleAltAlleleMergeRule();
-
-        // false <-> don't take control of writer, since didn't create it:
-        vcMergerWriter = new MergeSegregatingAlternateAllelesVCFWriter(writer, genomeLocParser, getToolkit().getArguments().referenceFile, vcMergeRule, alleleMergeRule, useSingleSample, emitOnlyMergedRecords, logger, false, !disablePrintAlternateAlleleStatistics);
-        writer = null; // so it can't be accessed directly [i.e., not through vcMergerWriter]
-
-        // setup the header fields:
-        Set<VCFHeaderLine> hInfo = new HashSet<VCFHeaderLine>();
-        hInfo.addAll(VCFUtils.getHeaderFields(getToolkit()));
-        hInfo.add(new VCFHeaderLine("reference", getToolkit().getArguments().referenceFile.getName()));
-
-        Map<String, VCFHeader> rodNameToHeader = getVCFHeadersFromRods(getToolkit(), Arrays.asList(variants.getName()));
-        vcMergerWriter.writeHeader(new VCFHeader(hInfo, new TreeSet<String>(rodNameToHeader.get(variants.getName()).getGenotypeSamples())));
-    }
-
-    public boolean generateExtendedEvents() {
-        return false;
-    }
-
-    public Integer reduceInit() {
-        return 0;
-    }
-
-    /**
-     * For each site, send it to be (possibly) merged with previously observed sites.
-     *
-     * @param tracker the meta-data tracker
-     * @param ref     the reference base
-     * @param context the context for the given locus
-     * @return dummy Integer
-     */
-    public Integer map(RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        if (tracker == null)
-            return null;
-
-        for (VariantContext vc : tracker.getValues(variants, context.getLocation()))
-            writeVCF(vc);
-
-        return 0;
-    }
-
-    private void writeVCF(VariantContext vc) {
-        WriteVCF.writeVCF(vc, vcMergerWriter, logger);
-    }
-
-    public Integer reduce(Integer result, Integer total) {
-        if (result == null)
-            return total;
-
-        return total + result;
-    }
-
-    /**
-     * Release any VariantContexts not yet processed.
-     *
-     * @param result Empty for now...
-     */
-    public void onTraversalDone(Integer result) {
-        vcMergerWriter.close();
-
-        if (useSingleSample != null)
-            System.out.println("Only considered single sample: " + useSingleSample);
-
-        System.out.println("Number of successive pairs of records: " + vcMergerWriter.getNumRecordsAttemptToMerge());
-        System.out.println("Number of potentially merged records (" + vcMergerWriter.getVcMergeRule() + "): " + vcMergerWriter.getNumRecordsSatisfyingMergeRule());
-        System.out.println("Number of records merged ("+ vcMergerWriter.getAlleleMergeRule() + "): " + vcMergerWriter.getNumMergedRecords());
-        System.out.println(vcMergerWriter.getAltAlleleStats());
-    }
-}
-
-
-enum MergeBasedOnRefSeqAnnotation {
-    UNION_WITH_DIST, INTERSECT_WITH_DIST
-}
-
-class SameGenePlusWithinDistanceMergeRule extends DistanceMergeRule {
-    private MergeBasedOnRefSeqAnnotation mergeBasedOnRefSeqAnnotation;
-
-    public SameGenePlusWithinDistanceMergeRule(int maxGenomicDistanceForMNP, GenomeLocParser genomeLocParser, String mergeBasedOnRefSeqAnnotation) {
-        super(maxGenomicDistanceForMNP, genomeLocParser);
-
-        if (mergeBasedOnRefSeqAnnotation.equals(MergeSegregatingAlternateAllelesWalker.UNION_REFSEQ))
-            this.mergeBasedOnRefSeqAnnotation = MergeBasedOnRefSeqAnnotation.UNION_WITH_DIST;
-        else if (mergeBasedOnRefSeqAnnotation.equals(MergeSegregatingAlternateAllelesWalker.INTERSECT_REFSEQ))
-            this.mergeBasedOnRefSeqAnnotation = MergeBasedOnRefSeqAnnotation.INTERSECT_WITH_DIST;
-        else
-            throw new UserException("Must provide " + MergeSegregatingAlternateAllelesWalker.IGNORE_REFSEQ + ", " + MergeSegregatingAlternateAllelesWalker.UNION_REFSEQ + ", or " + MergeSegregatingAlternateAllelesWalker.INTERSECT_REFSEQ + " as argument to mergeBasedOnRefSeqAnnotation!");
-    }
-
-    public boolean shouldAttemptToMerge(VariantContext vc1, VariantContext vc2) {
-        boolean withinDistance = super.shouldAttemptToMerge(vc1, vc2);
-
-        if (mergeBasedOnRefSeqAnnotation == MergeBasedOnRefSeqAnnotation.UNION_WITH_DIST)
-            return withinDistance || sameGene(vc1, vc2);
-        else // mergeBasedOnRefSeqAnnotation == MergeBasedOnRefSeqAnnotation.INTERSECT_WITH_DIST
-            return withinDistance && sameGene(vc1, vc2);
-    }
-
-    private boolean sameGene(VariantContext vc1, VariantContext vc2) {
-        Set<String> names_vc1 = RefSeqDataParser.getRefSeqNames(vc1);
-        Set<String> names_vc2 = RefSeqDataParser.getRefSeqNames(vc2);
-        names_vc1.retainAll(names_vc2);
-
-        if (!names_vc1.isEmpty())
-            return true;
-
-        // Check refseq.name2:
-        Set<String> names2_vc1 = RefSeqDataParser.getRefSeqNames(vc1, true);
-        Set<String> names2_vc2 = RefSeqDataParser.getRefSeqNames(vc2, true);
-        names2_vc1.retainAll(names2_vc2);
-
-        return !names2_vc1.isEmpty();
-    }
-
-    public String toString() {
-        return super.toString() + " " + (mergeBasedOnRefSeqAnnotation == MergeBasedOnRefSeqAnnotation.UNION_WITH_DIST ? "OR" : "AND") + " on the same gene";
-    }
-
-    public Map<String, Object> addToMergedAttributes(VariantContext vc1, VariantContext vc2) {
-        Map<String, Object> addedAttribs = super.addToMergedAttributes(vc1, vc2);
-        addedAttribs.putAll(RefSeqDataParser.getMergedRefSeqNameAttributes(vc1, vc2));
-        return addedAttribs;
-    }
-}
-
-
-
-class PrefixPolymorphismMergeAllelesRule extends VariantContextUtils.AlleleMergeRule {
-    public boolean allelesShouldBeMerged(VariantContext vc1, VariantContext vc2) {
-        return vc1.isPolymorphic();
-    }
-
-    public String toString() {
-        return super.toString() + ", there exists a polymorphism at the start of the merged allele";
-    }
-}
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingGraph.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingGraph.java
index fe2792475..8f980ad72 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingGraph.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingGraph.java
@@ -23,12 +23,10 @@
  */
 package org.broadinstitute.sting.gatk.walkers.phasing;
 
-import org.broadinstitute.sting.utils.DisjointSet;
-
 import java.util.*;
 
 // Represents an undirected graph with no self-edges:
-public class PhasingGraph implements Iterable<PhasingGraphEdge> {
+class PhasingGraph implements Iterable<PhasingGraphEdge> {
     private Neighbors[] adj;
 
     public PhasingGraph(int numVertices) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingGraphEdge.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingGraphEdge.java
index 56197a85f..053b09439 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingGraphEdge.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingGraphEdge.java
@@ -26,7 +26,7 @@ package org.broadinstitute.sting.gatk.walkers.phasing;
 /*
  Edge class for PhasingGraph
  */
-public class PhasingGraphEdge implements Comparable<PhasingGraphEdge> {
+class PhasingGraphEdge implements Comparable<PhasingGraphEdge> {
     protected int v1;
     protected int v2;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingRead.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingRead.java
index 63fb33295..a95b13d68 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingRead.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingRead.java
@@ -29,7 +29,7 @@ import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 
 import java.util.Arrays;
 
-public class PhasingRead extends BaseArray {
+class PhasingRead extends BaseArray {
     private PreciseNonNegativeDouble mappingProb; // the probability that this read is mapped correctly
     private PreciseNonNegativeDouble[] baseProbs; // the probabilities that the base identities are CORRECT
     private PreciseNonNegativeDouble[] baseErrorProbs; // the probabilities that the base identities are INCORRECT
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
new file mode 100644
index 000000000..8b5455e50
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
@@ -0,0 +1,387 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.walkers.phasing;
+
+import net.sf.picard.reference.ReferenceSequenceFile;
+import net.sf.samtools.util.StringUtil;
+import org.broadinstitute.sting.utils.GenomeLoc;
+import org.broadinstitute.sting.utils.GenomeLocParser;
+import org.broadinstitute.sting.utils.Utils;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+import org.broadinstitute.sting.utils.variantcontext.*;
+
+import java.util.*;
+
+/**
+ * [Short one sentence description of this walker]
+ * <p/>
+ * <p>
+ * [Functionality of this walker]
+ * </p>
+ * <p/>
+ * <h2>Input</h2>
+ * <p>
+ * [Input description]
+ * </p>
+ * <p/>
+ * <h2>Output</h2>
+ * <p>
+ * [Output description]
+ * </p>
+ * <p/>
+ * <h2>Examples</h2>
+ * <pre>
+ *    java
+ *      -jar GenomeAnalysisTK.jar
+ *      -T $WalkerName
+ *  </pre>
+ *
+ * @author Your Name
+ * @since Date created
+ */
+class PhasingUtils {
+    static VariantContext mergeIntoMNP(GenomeLocParser genomeLocParser, VariantContext vc1, VariantContext vc2, ReferenceSequenceFile referenceFile, AlleleMergeRule alleleMergeRule) {
+        if (!mergeIntoMNPvalidationCheck(genomeLocParser, vc1, vc2))
+            return null;
+
+        // Check that it's logically possible to merge the VCs:
+        if (!allSamplesAreMergeable(vc1, vc2))
+            return null;
+
+        // Check if there's a "point" in merging the VCs (e.g., annotations could be changed)
+        if (!alleleMergeRule.allelesShouldBeMerged(vc1, vc2))
+            return null;
+
+        return reallyMergeIntoMNP(vc1, vc2, referenceFile);
+    }
+
+    static VariantContext reallyMergeIntoMNP(VariantContext vc1, VariantContext vc2, ReferenceSequenceFile referenceFile) {
+        int startInter = vc1.getEnd() + 1;
+        int endInter = vc2.getStart() - 1;
+        byte[] intermediateBases = null;
+        if (startInter <= endInter) {
+            intermediateBases = referenceFile.getSubsequenceAt(vc1.getChr(), startInter, endInter).getBases();
+            StringUtil.toUpperCase(intermediateBases);
+        }
+        MergedAllelesData mergeData = new MergedAllelesData(intermediateBases, vc1, vc2); // ensures that the reference allele is added
+
+        GenotypeCollection mergedGenotypes = GenotypeCollection.create();
+        for (final Genotype gt1 : vc1.getGenotypes()) {
+            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
+
+            List<Allele> site1Alleles = gt1.getAlleles();
+            List<Allele> site2Alleles = gt2.getAlleles();
+
+            List<Allele> mergedAllelesForSample = new LinkedList<Allele>();
+
+            /* NOTE: Since merged alleles are added to mergedAllelesForSample in the SAME order as in the input VC records,
+               we preserve phase information (if any) relative to whatever precedes vc1:
+             */
+            Iterator<Allele> all2It = site2Alleles.iterator();
+            for (Allele all1 : site1Alleles) {
+                Allele all2 = all2It.next(); // this is OK, since allSamplesAreMergeable()
+
+                Allele mergedAllele = mergeData.ensureMergedAllele(all1, all2);
+                mergedAllelesForSample.add(mergedAllele);
+            }
+
+            double mergedGQ = Math.max(gt1.getNegLog10PError(), gt2.getNegLog10PError());
+            Set<String> mergedGtFilters = new HashSet<String>(); // Since gt1 and gt2 were unfiltered, the Genotype remains unfiltered
+
+            Map<String, Object> mergedGtAttribs = new HashMap<String, Object>();
+            PhaseAndQuality phaseQual = calcPhaseForMergedGenotypes(gt1, gt2);
+            if (phaseQual.PQ != null)
+                mergedGtAttribs.put(ReadBackedPhasingWalker.PQ_KEY, phaseQual.PQ);
+
+            Genotype mergedGt = new Genotype(gt1.getSampleName(), mergedAllelesForSample, mergedGQ, mergedGtFilters, mergedGtAttribs, phaseQual.isPhased);
+            mergedGenotypes.add(mergedGt);
+        }
+
+        String mergedName = mergeVariantContextNames(vc1.getSource(), vc2.getSource());
+        double mergedNegLog10PError = Math.max(vc1.getNegLog10PError(), vc2.getNegLog10PError());
+        Set<String> mergedFilters = new HashSet<String>(); // Since vc1 and vc2 were unfiltered, the merged record remains unfiltered
+        Map<String, Object> mergedAttribs = mergeVariantContextAttributes(vc1, vc2);
+
+        // ids
+        List<String> mergedIDs = new ArrayList<String>();
+        if ( vc1.hasID() ) mergedIDs.add(vc1.getID());
+        if ( vc2.hasID() ) mergedIDs.add(vc2.getID());
+        String mergedID = Utils.join(VCFConstants.ID_FIELD_SEPARATOR, mergedIDs);
+
+        // TODO -- FIX ID
+        VariantContext mergedVc = new VariantContext(mergedName, mergedID, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles(), mergedGenotypes, mergedNegLog10PError, mergedFilters, mergedAttribs);
+
+        mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
+        VariantContextUtils.calculateChromosomeCounts(mergedVc, mergedAttribs, true);
+        mergedVc = VariantContext.modifyAttributes(mergedVc, mergedAttribs);
+
+        return mergedVc;
+    }
+
+    static String mergeVariantContextNames(String name1, String name2) {
+        return name1 + "_" + name2;
+    }
+
+    static Map<String, Object> mergeVariantContextAttributes(VariantContext vc1, VariantContext vc2) {
+        Map<String, Object> mergedAttribs = new HashMap<String, Object>();
+
+        List<VariantContext> vcList = new LinkedList<VariantContext>();
+        vcList.add(vc1);
+        vcList.add(vc2);
+
+        String[] MERGE_OR_ATTRIBS = {VCFConstants.DBSNP_KEY};
+        for (String orAttrib : MERGE_OR_ATTRIBS) {
+            boolean attribVal = false;
+            for (VariantContext vc : vcList) {
+                attribVal = vc.getAttributeAsBoolean(orAttrib, false);
+                if (attribVal) // already true, so no reason to continue:
+                    break;
+            }
+            mergedAttribs.put(orAttrib, attribVal);
+        }
+
+        return mergedAttribs;
+    }
+
+    static boolean mergeIntoMNPvalidationCheck(GenomeLocParser genomeLocParser, VariantContext vc1, VariantContext vc2) {
+        GenomeLoc loc1 = VariantContextUtils.getLocation(genomeLocParser, vc1);
+        GenomeLoc loc2 = VariantContextUtils.getLocation(genomeLocParser, vc2);
+
+        if (!loc1.onSameContig(loc2))
+            throw new ReviewedStingException("Can only merge vc1, vc2 if on the same chromosome");
+
+        if (!loc1.isBefore(loc2))
+            throw new ReviewedStingException("Can only merge if vc1 is BEFORE vc2");
+
+        if (vc1.isFiltered() || vc2.isFiltered())
+            return false;
+
+        if (!vc1.getSampleNames().equals(vc2.getSampleNames())) // vc1, vc2 refer to different sample sets
+            return false;
+
+        if (!allGenotypesAreUnfilteredAndCalled(vc1) || !allGenotypesAreUnfilteredAndCalled(vc2))
+            return false;
+
+        return true;
+    }
+
+    static boolean allGenotypesAreUnfilteredAndCalled(VariantContext vc) {
+        for (final Genotype gt : vc.getGenotypes()) {
+            if (gt.isNoCall() || gt.isFiltered())
+                return false;
+        }
+
+        return true;
+    }
+
+    static boolean allSamplesAreMergeable(VariantContext vc1, VariantContext vc2) {
+        // Check that each sample's genotype in vc2 is uniquely appendable onto its genotype in vc1:
+        for (final Genotype gt1 : vc1.getGenotypes()) {
+            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
+
+            if (!alleleSegregationIsKnown(gt1, gt2)) // can merge if: phased, or if either is a hom
+                return false;
+        }
+
+        return true;
+    }
+
+    static boolean alleleSegregationIsKnown(Genotype gt1, Genotype gt2) {
+        if (gt1.getPloidy() != gt2.getPloidy())
+            return false;
+
+        /* If gt2 is phased or hom, then could even be MERGED with gt1 [This is standard].
+
+           HOWEVER, EVEN if this is not the case, but gt1.isHom(),
+           it is trivially known that each of gt2's alleles segregate with the single allele type present in gt1.
+         */
+        return (gt2.isPhased() || gt2.isHom() || gt1.isHom());
+    }
+
+    static PhaseAndQuality calcPhaseForMergedGenotypes(Genotype gt1, Genotype gt2) {
+        if (gt2.isPhased() || gt2.isHom())
+            return new PhaseAndQuality(gt1); // maintain the phase of gt1
+
+        if (!gt1.isHom())
+            throw new ReviewedStingException("alleleSegregationIsKnown(gt1, gt2) implies: gt2.genotypesArePhased() || gt2.isHom() || gt1.isHom()");
+
+        /* We're dealing with: gt1.isHom(), gt2.isHet(), !gt2.genotypesArePhased(); so, the merged (het) Genotype is not phased relative to the previous Genotype
+
+           For example, if we're merging the third Genotype with the second one:
+           0/1
+           1|1
+           0/1
+
+           Then, we want to output:
+           0/1
+           1/2
+         */
+        return new PhaseAndQuality(gt2); // maintain the phase of gt2 [since !gt2.genotypesArePhased()]
+    }
+
+    static boolean someSampleHasDoubleNonReferenceAllele(VariantContext vc1, VariantContext vc2) {
+        for (final Genotype gt1 : vc1.getGenotypes()) {
+            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
+
+            List<Allele> site1Alleles = gt1.getAlleles();
+            List<Allele> site2Alleles = gt2.getAlleles();
+
+            Iterator<Allele> all2It = site2Alleles.iterator();
+            for (Allele all1 : site1Alleles) {
+                Allele all2 = all2It.next(); // this is OK, since allSamplesAreMergeable()
+
+                if (all1.isNonReference() && all2.isNonReference()) // corresponding alleles are alternate
+                    return true;
+            }
+        }
+
+        return false;
+    }
+
+    static boolean doubleAllelesSegregatePerfectlyAmongSamples(VariantContext vc1, VariantContext vc2) {
+        // Check that Alleles at vc1 and at vc2 always segregate together in all samples (including reference):
+        Map<Allele, Allele> allele1ToAllele2 = new HashMap<Allele, Allele>();
+        Map<Allele, Allele> allele2ToAllele1 = new HashMap<Allele, Allele>();
+
+        // Note the segregation of the alleles for the reference genome:
+        allele1ToAllele2.put(vc1.getReference(), vc2.getReference());
+        allele2ToAllele1.put(vc2.getReference(), vc1.getReference());
+
+        // Note the segregation of the alleles for each sample (and check that it is consistent with the reference and all previous samples).
+        for (final Genotype gt1 : vc1.getGenotypes()) {
+            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
+
+            List<Allele> site1Alleles = gt1.getAlleles();
+            List<Allele> site2Alleles = gt2.getAlleles();
+
+            Iterator<Allele> all2It = site2Alleles.iterator();
+            for (Allele all1 : site1Alleles) {
+                Allele all2 = all2It.next();
+
+                Allele all1To2 = allele1ToAllele2.get(all1);
+                if (all1To2 == null)
+                    allele1ToAllele2.put(all1, all2);
+                else if (!all1To2.equals(all2)) // all1 segregates with two different alleles at site 2
+                    return false;
+
+                Allele all2To1 = allele2ToAllele1.get(all2);
+                if (all2To1 == null)
+                    allele2ToAllele1.put(all2, all1);
+                else if (!all2To1.equals(all1)) // all2 segregates with two different alleles at site 1
+                    return false;
+            }
+        }
+
+        return true;
+    }
+
+    abstract static class AlleleMergeRule {
+        // vc1, vc2 are ONLY passed to allelesShouldBeMerged() if mergeIntoMNPvalidationCheck(genomeLocParser, vc1, vc2) AND allSamplesAreMergeable(vc1, vc2):
+        abstract public boolean allelesShouldBeMerged(VariantContext vc1, VariantContext vc2);
+
+        public String toString() {
+            return "all samples are mergeable";
+        }
+    }
+
+    static class AlleleOneAndTwo {
+        private Allele all1;
+        private Allele all2;
+
+        public AlleleOneAndTwo(Allele all1, Allele all2) {
+            this.all1 = all1;
+            this.all2 = all2;
+        }
+
+        public int hashCode() {
+            return all1.hashCode() + all2.hashCode();
+        }
+
+        public boolean equals(Object other) {
+            if (!(other instanceof AlleleOneAndTwo))
+                return false;
+
+            AlleleOneAndTwo otherAot = (AlleleOneAndTwo) other;
+            return (this.all1.equals(otherAot.all1) && this.all2.equals(otherAot.all2));
+        }
+    }
+
+    static class MergedAllelesData {
+        private Map<AlleleOneAndTwo, Allele> mergedAlleles;
+        private byte[] intermediateBases;
+        private int intermediateLength;
+
+        public MergedAllelesData(byte[] intermediateBases, VariantContext vc1, VariantContext vc2) {
+            this.mergedAlleles = new HashMap<AlleleOneAndTwo, Allele>(); // implemented equals() and hashCode() for AlleleOneAndTwo
+            this.intermediateBases = intermediateBases;
+            this.intermediateLength = this.intermediateBases != null ? this.intermediateBases.length : 0;
+
+            this.ensureMergedAllele(vc1.getReference(), vc2.getReference(), true);
+        }
+
+        public Allele ensureMergedAllele(Allele all1, Allele all2) {
+            return ensureMergedAllele(all1, all2, false); // false <-> since even if all1+all2 = reference, it was already created in the constructor
+        }
+
+        private Allele ensureMergedAllele(Allele all1, Allele all2, boolean creatingReferenceForFirstTime) {
+            AlleleOneAndTwo all12 = new AlleleOneAndTwo(all1, all2);
+            Allele mergedAllele = mergedAlleles.get(all12);
+
+            if (mergedAllele == null) {
+                byte[] bases1 = all1.getBases();
+                byte[] bases2 = all2.getBases();
+
+                byte[] mergedBases = new byte[bases1.length + intermediateLength + bases2.length];
+                System.arraycopy(bases1, 0, mergedBases, 0, bases1.length);
+                if (intermediateBases != null)
+                    System.arraycopy(intermediateBases, 0, mergedBases, bases1.length, intermediateLength);
+                System.arraycopy(bases2, 0, mergedBases, bases1.length + intermediateLength, bases2.length);
+
+                mergedAllele = Allele.create(mergedBases, creatingReferenceForFirstTime);
+                mergedAlleles.put(all12, mergedAllele);
+            }
+
+            return mergedAllele;
+        }
+
+        public Set<Allele> getAllMergedAlleles() {
+            return new HashSet<Allele>(mergedAlleles.values());
+        }
+    }
+
+    static class PhaseAndQuality {
+        public boolean isPhased;
+        public Double PQ = null;
+
+        public PhaseAndQuality(Genotype gt) {
+            this.isPhased = gt.isPhased();
+            if (this.isPhased) {
+                this.PQ = gt.getAttributeAsDouble(ReadBackedPhasingWalker.PQ_KEY, -1);
+                if ( this.PQ == -1 ) this.PQ = null;
+            }
+        }
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PreciseNonNegativeDouble.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PreciseNonNegativeDouble.java
index 99446705e..b68739b48 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PreciseNonNegativeDouble.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PreciseNonNegativeDouble.java
@@ -26,7 +26,7 @@ package org.broadinstitute.sting.gatk.walkers.phasing;
 /* PreciseNonNegativeDouble permits arithmetic operations on NON-NEGATIVE double values
    with precision (prevents underflow by representing in log10 space).
  */
-public class PreciseNonNegativeDouble implements Comparable<PreciseNonNegativeDouble> {
+class PreciseNonNegativeDouble implements Comparable<PreciseNonNegativeDouble> {
     private static final double EQUALS_THRESH = 1e-6;
     private static final double INFINITY = Double.POSITIVE_INFINITY;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index 94127438d..8cc0d8856 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -34,7 +34,6 @@ import org.broadinstitute.sting.gatk.filters.MappingQualityZeroFilter;
 import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
 import org.broadinstitute.sting.gatk.walkers.*;
 import org.broadinstitute.sting.utils.BaseUtils;
-import org.broadinstitute.sting.utils.DisjointSet;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.HasGenomeLocation;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
@@ -1052,7 +1051,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
     private void writeVCF(VariantContext vc) {
         if (samplesToPhase == null || vc.isNotFiltered())
             //if ( samplesToPhase == null || (vc.isVariant() && vc.isNotFiltered())) // if we are only operating on specific samples, don't write out all sites, just those where the VC is variant
-            WriteVCF.writeVCF(vc, writer, logger);
+            writer.add(vc);
     }
 
     public static boolean processVariantInPhasing(VariantContext vc) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBase.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBase.java
index ae15c3f12..bff45de7f 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBase.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBase.java
@@ -23,7 +23,7 @@
  */
 package org.broadinstitute.sting.gatk.walkers.phasing;
 
-public class ReadBase {
+class ReadBase {
     public String readName;
     public byte base;
     public int mappingQual;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBasesAtPosition.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBasesAtPosition.java
index e5652c56e..813bc2e94 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBasesAtPosition.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBasesAtPosition.java
@@ -28,7 +28,7 @@ import org.broadinstitute.sting.utils.pileup.PileupElement;
 import java.util.Iterator;
 import java.util.LinkedList;
 
-public class ReadBasesAtPosition implements Iterable<ReadBase> {
+class ReadBasesAtPosition implements Iterable<ReadBase> {
     // list of: <read name, base>
     private LinkedList<ReadBase> bases;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/RefSeqDataParser.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/RefSeqDataParser.java
deleted file mode 100644
index f94140814..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/RefSeqDataParser.java
+++ /dev/null
@@ -1,189 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.walkers.phasing;
-
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-
-import java.util.*;
-
-/* Some methods for extracting RefSeq-related data from annotated VCF INFO fields:
- */
-public class RefSeqDataParser {
-    private static String REFSEQ_PREFIX = "refseq.";
-
-    private static String NUM_RECORDS_KEY = REFSEQ_PREFIX + "numMatchingRecords";
-    private static String NAME_KEY = REFSEQ_PREFIX + "name";
-    private static String NAME2_KEY = REFSEQ_PREFIX + "name2";
-
-    private static String[] NAME_KEYS = {NAME_KEY, NAME2_KEY};
-
-    private static Map<String, String> getRefSeqEntriesToNames(VariantContext vc, boolean getName2) {
-        String nameKeyToUse = getName2 ? NAME2_KEY : NAME_KEY;
-        String nameKeyToUseMultiplePrefix = nameKeyToUse + "_";
-
-        Map<String, String> entriesToNames = new HashMap<String, String>();
-        int numRecords = vc.getAttributeAsInt(NUM_RECORDS_KEY, -1);
-        if (numRecords != -1) {
-            boolean done = false;
-
-            if (numRecords == 1) { // Check if perhaps the single record doesn't end with "_1":
-                String name = vc.getAttributeAsString(nameKeyToUse, null);
-                if (name != null) {
-                    entriesToNames.put(nameKeyToUse, name);
-                    done = true;
-                }
-            }
-
-            if (!done) {
-                for (int i = 1; i <= numRecords; i++) {
-                    String key = nameKeyToUseMultiplePrefix + i;
-                    String name = vc.getAttributeAsString(key, null);
-                    if (name != null)
-                        entriesToNames.put(key, name);
-                }
-            }
-        }
-        else { // no entry with the # of records:
-            String name = vc.getAttributeAsString(nameKeyToUse, null);
-            if (name != null) {
-                entriesToNames.put(nameKeyToUse, name);
-            }
-            else { // Check all INFO fields for a match (if there are multiple entries):
-                for (Map.Entry<String, Object> entry : vc.getAttributes().entrySet()) {
-                    String key = entry.getKey();
-                    if (key.startsWith(nameKeyToUseMultiplePrefix))
-                        entriesToNames.put(key, entry.getValue().toString());
-                }
-            }
-        }
-        return entriesToNames;
-    }
-
-    private static Map<String, String> getRefSeqEntriesToNames(VariantContext vc) {
-        return getRefSeqEntriesToNames(vc, false);
-    }
-
-    public static Set<String> getRefSeqNames(VariantContext vc, boolean getName2) {
-        return new TreeSet<String>(getRefSeqEntriesToNames(vc, getName2).values());
-    }
-
-    public static Set<String> getRefSeqNames(VariantContext vc) {
-        return getRefSeqNames(vc, false);
-    }
-
-    public static Map<String, Object> getMergedRefSeqNameAttributes(VariantContext vc1, VariantContext vc2) {
-        Map<String, Object> refSeqNameAttribs = new HashMap<String, Object>();
-
-        Map<String, RefSeqEntry> entriesMap1 = getAllRefSeqEntriesByName(vc1);
-        Map<String, RefSeqEntry> entriesMap2 = getAllRefSeqEntriesByName(vc2);
-
-        Set<String> commonNames = entriesMap1.keySet();
-        commonNames.retainAll(entriesMap2.keySet());
-        boolean addSuffix = commonNames.size() > 1;
-        int nextCount = 1;
-
-        for (String name : commonNames) {
-            RefSeqEntry refseq1 = entriesMap1.get(name);
-            RefSeqEntry refseq2 = entriesMap2.get(name);
-
-            String keySuffix = "";
-            if (addSuffix)
-                keySuffix = "_" + nextCount;
-
-            boolean added = false;
-            for (String key : NAME_KEYS) {
-                Object obj1 = refseq1.info.get(key);
-                Object obj2 = refseq2.info.get(key);
-                if (obj1 != null && obj2 != null && obj1.equals(obj2)) {
-                    added = true;
-                    String useKey = key + keySuffix;
-                    refSeqNameAttribs.put(useKey, obj1);
-                }
-            }
-            if (added)
-                nextCount++;
-        }
-        int totalCount = nextCount - 1; // since incremented count one extra time
-        if (totalCount > 1)
-            refSeqNameAttribs.put(NUM_RECORDS_KEY, totalCount);
-
-        return refSeqNameAttribs;
-    }
-
-    public static Map<String, Object> removeRefSeqAttributes(Map<String, Object> attributes) {
-        Map<String, Object> removedRefSeqAttributes = new HashMap<String, Object>(attributes);
-
-        Iterator<Map.Entry<String, Object>> attrIt = removedRefSeqAttributes.entrySet().iterator();
-        while (attrIt.hasNext()) {
-            String key = attrIt.next().getKey();
-            if (key.startsWith(REFSEQ_PREFIX))
-                attrIt.remove();
-        }
-
-        return removedRefSeqAttributes;
-    }
-
-    private static Map<String, RefSeqEntry> getAllRefSeqEntriesByName(VariantContext vc) {
-        Map<String, RefSeqEntry> nameToEntries = new TreeMap<String, RefSeqEntry>();
-
-        List<RefSeqEntry> allEntries = getAllRefSeqEntries(vc);
-        for (RefSeqEntry entry : allEntries) {
-            Object name = entry.info.get(NAME_KEY);
-            if (name != null)
-                nameToEntries.put(name.toString(), entry);
-        }
-
-        return nameToEntries;
-    }
-
-    // Returns a List of SEPARATE Map<refseq.ENTRY, refseq.VALUE> for EACH RefSeq annotation (i.e., each gene), stripping out the "_1", "_2", etc.
-    private static List<RefSeqEntry> getAllRefSeqEntries(VariantContext vc) {
-        List<RefSeqEntry> allRefSeq = new LinkedList<RefSeqEntry>();
-
-        for (Map.Entry<String, String> entryToName : getRefSeqEntriesToNames(vc).entrySet()) {
-            String entry = entryToName.getKey();
-            String entrySuffix = entry.replaceFirst(NAME_KEY, "");
-            allRefSeq.add(new RefSeqEntry(vc, entrySuffix));
-        }
-
-        return allRefSeq;
-    }
-
-    private static class RefSeqEntry {
-        public Map<String, Object> info;
-
-        public RefSeqEntry(VariantContext vc, String entrySuffix) {
-            this.info = new HashMap<String, Object>();
-
-            for (Map.Entry<String, Object> attribEntry : vc.getAttributes().entrySet()) {
-                String key = attribEntry.getKey();
-                if (key.startsWith(REFSEQ_PREFIX) && key.endsWith(entrySuffix)) {
-                    String genericKey = key.replaceAll(entrySuffix, "");
-                    this.info.put(genericKey, attribEntry.getValue());
-                }
-            }
-        }
-    }
-}
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/SNPallelePair.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/SNPallelePair.java
index 153c4a23f..6a2381e29 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/SNPallelePair.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/SNPallelePair.java
@@ -28,7 +28,7 @@ import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
 
-public class SNPallelePair extends AllelePair {
+class SNPallelePair extends AllelePair {
 
     public SNPallelePair(Genotype gt) {
         super(gt);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/WriteVCF.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/WriteVCF.java
deleted file mode 100644
index c10eaa2da..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/WriteVCF.java
+++ /dev/null
@@ -1,34 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-package org.broadinstitute.sting.gatk.walkers.phasing;
-
-import org.apache.log4j.Logger;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFWriter;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-
-public class WriteVCF {
-    public static void writeVCF(VariantContext vc, VCFWriter writer, Logger logger) {
-        writer.add(vc);
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index acd3ac0d2..161800009 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -25,13 +25,10 @@ package org.broadinstitute.sting.utils.variantcontext;
 
 import com.google.java.contract.Ensures;
 import com.google.java.contract.Requires;
-import net.sf.picard.reference.ReferenceSequenceFile;
-import net.sf.samtools.util.StringUtil;
 import org.apache.commons.jexl2.Expression;
 import org.apache.commons.jexl2.JexlEngine;
 import org.apache.log4j.Logger;
 import org.broad.tribble.util.popgen.HardyWeinbergCalculation;
-import org.broadinstitute.sting.gatk.walkers.phasing.ReadBackedPhasingWalker;
 import org.broadinstitute.sting.utils.BaseUtils;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.GenomeLocParser;
@@ -929,340 +926,4 @@ public class VariantContextUtils {
     public static final GenomeLoc getLocation(GenomeLocParser genomeLocParser,VariantContext vc) {
         return genomeLocParser.createGenomeLoc(vc.getChr(), vc.getStart(), vc.getEnd(), true);
     }
-
-    public abstract static class AlleleMergeRule {
-        // vc1, vc2 are ONLY passed to allelesShouldBeMerged() if mergeIntoMNPvalidationCheck(genomeLocParser, vc1, vc2) AND allSamplesAreMergeable(vc1, vc2):
-        abstract public boolean allelesShouldBeMerged(VariantContext vc1, VariantContext vc2);
-
-        public String toString() {
-            return "all samples are mergeable";
-        }
-    }
-
-    // NOTE: returns null if vc1 and vc2 are not merged into a single MNP record
-
-    public static VariantContext mergeIntoMNP(GenomeLocParser genomeLocParser, VariantContext vc1, VariantContext vc2, ReferenceSequenceFile referenceFile, AlleleMergeRule alleleMergeRule) {
-        if (!mergeIntoMNPvalidationCheck(genomeLocParser, vc1, vc2))
-            return null;
-
-        // Check that it's logically possible to merge the VCs:
-        if (!allSamplesAreMergeable(vc1, vc2))
-            return null;
-
-        // Check if there's a "point" in merging the VCs (e.g., annotations could be changed)
-        if (!alleleMergeRule.allelesShouldBeMerged(vc1, vc2))
-            return null;
-
-        return reallyMergeIntoMNP(vc1, vc2, referenceFile);
-    }
-
-    private static VariantContext reallyMergeIntoMNP(VariantContext vc1, VariantContext vc2, ReferenceSequenceFile referenceFile) {
-        int startInter = vc1.getEnd() + 1;
-        int endInter = vc2.getStart() - 1;
-        byte[] intermediateBases = null;
-        if (startInter <= endInter) {
-            intermediateBases = referenceFile.getSubsequenceAt(vc1.getChr(), startInter, endInter).getBases();
-            StringUtil.toUpperCase(intermediateBases);
-        }
-        MergedAllelesData mergeData = new MergedAllelesData(intermediateBases, vc1, vc2); // ensures that the reference allele is added
-
-        GenotypeCollection mergedGenotypes = GenotypeCollection.create();
-        for (final Genotype gt1 : vc1.getGenotypes()) {
-            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
-
-            List<Allele> site1Alleles = gt1.getAlleles();
-            List<Allele> site2Alleles = gt2.getAlleles();
-
-            List<Allele> mergedAllelesForSample = new LinkedList<Allele>();
-
-            /* NOTE: Since merged alleles are added to mergedAllelesForSample in the SAME order as in the input VC records,
-               we preserve phase information (if any) relative to whatever precedes vc1:
-             */
-            Iterator<Allele> all2It = site2Alleles.iterator();
-            for (Allele all1 : site1Alleles) {
-                Allele all2 = all2It.next(); // this is OK, since allSamplesAreMergeable()
-
-                Allele mergedAllele = mergeData.ensureMergedAllele(all1, all2);
-                mergedAllelesForSample.add(mergedAllele);
-            }
-
-            double mergedGQ = Math.max(gt1.getNegLog10PError(), gt2.getNegLog10PError());
-            Set<String> mergedGtFilters = new HashSet<String>(); // Since gt1 and gt2 were unfiltered, the Genotype remains unfiltered
-
-            Map<String, Object> mergedGtAttribs = new HashMap<String, Object>();
-            PhaseAndQuality phaseQual = calcPhaseForMergedGenotypes(gt1, gt2);
-            if (phaseQual.PQ != null)
-                mergedGtAttribs.put(ReadBackedPhasingWalker.PQ_KEY, phaseQual.PQ);
-
-            Genotype mergedGt = new Genotype(gt1.getSampleName(), mergedAllelesForSample, mergedGQ, mergedGtFilters, mergedGtAttribs, phaseQual.isPhased);
-            mergedGenotypes.add(mergedGt);
-        }
-
-        String mergedName = VariantContextUtils.mergeVariantContextNames(vc1.getSource(), vc2.getSource());
-        double mergedNegLog10PError = Math.max(vc1.getNegLog10PError(), vc2.getNegLog10PError());
-        Set<String> mergedFilters = new HashSet<String>(); // Since vc1 and vc2 were unfiltered, the merged record remains unfiltered
-        Map<String, Object> mergedAttribs = VariantContextUtils.mergeVariantContextAttributes(vc1, vc2);
-
-        // ids
-        List<String> mergedIDs = new ArrayList<String>();
-        if ( vc1.hasID() ) mergedIDs.add(vc1.getID());
-        if ( vc2.hasID() ) mergedIDs.add(vc2.getID());
-        String mergedID = Utils.join(VCFConstants.ID_FIELD_SEPARATOR, mergedIDs);
-
-        // TODO -- FIX ID
-        VariantContext mergedVc = new VariantContext(mergedName, mergedID, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles(), mergedGenotypes, mergedNegLog10PError, mergedFilters, mergedAttribs);
-
-        mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
-        VariantContextUtils.calculateChromosomeCounts(mergedVc, mergedAttribs, true);
-        mergedVc = VariantContext.modifyAttributes(mergedVc, mergedAttribs);
-
-        return mergedVc;
-    }
-
-    private static class AlleleOneAndTwo {
-        private Allele all1;
-        private Allele all2;
-
-        public AlleleOneAndTwo(Allele all1, Allele all2) {
-            this.all1 = all1;
-            this.all2 = all2;
-        }
-
-        public int hashCode() {
-            return all1.hashCode() + all2.hashCode();
-        }
-
-        public boolean equals(Object other) {
-            if (!(other instanceof AlleleOneAndTwo))
-                return false;
-
-            AlleleOneAndTwo otherAot = (AlleleOneAndTwo) other;
-            return (this.all1.equals(otherAot.all1) && this.all2.equals(otherAot.all2));
-        }
-    }
-
-    private static class MergedAllelesData {
-        private Map<AlleleOneAndTwo, Allele> mergedAlleles;
-        private byte[] intermediateBases;
-        private int intermediateLength;
-
-        public MergedAllelesData(byte[] intermediateBases, VariantContext vc1, VariantContext vc2) {
-            this.mergedAlleles = new HashMap<AlleleOneAndTwo, Allele>(); // implemented equals() and hashCode() for AlleleOneAndTwo
-            this.intermediateBases = intermediateBases;
-            this.intermediateLength = this.intermediateBases != null ? this.intermediateBases.length : 0;
-
-            this.ensureMergedAllele(vc1.getReference(), vc2.getReference(), true);
-        }
-
-        public Allele ensureMergedAllele(Allele all1, Allele all2) {
-            return ensureMergedAllele(all1, all2, false); // false <-> since even if all1+all2 = reference, it was already created in the constructor
-        }
-
-        private Allele ensureMergedAllele(Allele all1, Allele all2, boolean creatingReferenceForFirstTime) {
-            AlleleOneAndTwo all12 = new AlleleOneAndTwo(all1, all2);
-            Allele mergedAllele = mergedAlleles.get(all12);
-
-            if (mergedAllele == null) {
-                byte[] bases1 = all1.getBases();
-                byte[] bases2 = all2.getBases();
-
-                byte[] mergedBases = new byte[bases1.length + intermediateLength + bases2.length];
-                System.arraycopy(bases1, 0, mergedBases, 0, bases1.length);
-                if (intermediateBases != null)
-                    System.arraycopy(intermediateBases, 0, mergedBases, bases1.length, intermediateLength);
-                System.arraycopy(bases2, 0, mergedBases, bases1.length + intermediateLength, bases2.length);
-
-                mergedAllele = Allele.create(mergedBases, creatingReferenceForFirstTime);
-                mergedAlleles.put(all12, mergedAllele);
-            }
-
-            return mergedAllele;
-        }
-
-        public Set<Allele> getAllMergedAlleles() {
-            return new HashSet<Allele>(mergedAlleles.values());
-        }
-    }
-
-    private static String mergeVariantContextNames(String name1, String name2) {
-        return name1 + "_" + name2;
-    }
-
-    private static Map<String, Object> mergeVariantContextAttributes(VariantContext vc1, VariantContext vc2) {
-        Map<String, Object> mergedAttribs = new HashMap<String, Object>();
-
-        List<VariantContext> vcList = new LinkedList<VariantContext>();
-        vcList.add(vc1);
-        vcList.add(vc2);
-
-        String[] MERGE_OR_ATTRIBS = {VCFConstants.DBSNP_KEY};
-        for (String orAttrib : MERGE_OR_ATTRIBS) {
-            boolean attribVal = false;
-            for (VariantContext vc : vcList) {
-                attribVal = vc.getAttributeAsBoolean(orAttrib, false);
-                if (attribVal) // already true, so no reason to continue:
-                    break;
-            }
-            mergedAttribs.put(orAttrib, attribVal);
-        }
-
-        return mergedAttribs;
-    }
-
-    private static boolean mergeIntoMNPvalidationCheck(GenomeLocParser genomeLocParser, VariantContext vc1, VariantContext vc2) {
-        GenomeLoc loc1 = VariantContextUtils.getLocation(genomeLocParser, vc1);
-        GenomeLoc loc2 = VariantContextUtils.getLocation(genomeLocParser, vc2);
-
-        if (!loc1.onSameContig(loc2))
-            throw new ReviewedStingException("Can only merge vc1, vc2 if on the same chromosome");
-
-        if (!loc1.isBefore(loc2))
-            throw new ReviewedStingException("Can only merge if vc1 is BEFORE vc2");
-
-        if (vc1.isFiltered() || vc2.isFiltered())
-            return false;
-
-        if (!vc1.getSampleNames().equals(vc2.getSampleNames())) // vc1, vc2 refer to different sample sets
-            return false;
-
-        if (!allGenotypesAreUnfilteredAndCalled(vc1) || !allGenotypesAreUnfilteredAndCalled(vc2))
-            return false;
-
-        return true;
-    }
-
-    private static boolean allGenotypesAreUnfilteredAndCalled(VariantContext vc) {
-        for (final Genotype gt : vc.getGenotypes()) {
-            if (gt.isNoCall() || gt.isFiltered())
-                return false;
-        }
-
-        return true;
-    }
-
-    // Assumes that vc1 and vc2 were already checked to have the same sample names:
-
-    private static boolean allSamplesAreMergeable(VariantContext vc1, VariantContext vc2) {
-        // Check that each sample's genotype in vc2 is uniquely appendable onto its genotype in vc1:
-        for (final Genotype gt1 : vc1.getGenotypes()) {
-            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
-
-            if (!alleleSegregationIsKnown(gt1, gt2)) // can merge if: phased, or if either is a hom
-                return false;
-        }
-
-        return true;
-    }
-
-    public static boolean alleleSegregationIsKnown(Genotype gt1, Genotype gt2) {
-        if (gt1.getPloidy() != gt2.getPloidy())
-            return false;
-
-        /* If gt2 is phased or hom, then could even be MERGED with gt1 [This is standard].
-
-           HOWEVER, EVEN if this is not the case, but gt1.isHom(),
-           it is trivially known that each of gt2's alleles segregate with the single allele type present in gt1.
-         */
-        return (gt2.isPhased() || gt2.isHom() || gt1.isHom());
-    }
-
-    private static class PhaseAndQuality {
-        public boolean isPhased;
-        public Double PQ = null;
-
-        public PhaseAndQuality(Genotype gt) {
-            this.isPhased = gt.isPhased();
-            if (this.isPhased) {
-                this.PQ = gt.getAttributeAsDouble(ReadBackedPhasingWalker.PQ_KEY, -1);
-                if ( this.PQ == -1 ) this.PQ = null;
-            }
-        }
-    }
-
-    // Assumes that alleleSegregationIsKnown(gt1, gt2):
-
-    private static PhaseAndQuality calcPhaseForMergedGenotypes(Genotype gt1, Genotype gt2) {
-        if (gt2.isPhased() || gt2.isHom())
-            return new PhaseAndQuality(gt1); // maintain the phase of gt1
-
-        if (!gt1.isHom())
-            throw new ReviewedStingException("alleleSegregationIsKnown(gt1, gt2) implies: gt2.genotypesArePhased() || gt2.isHom() || gt1.isHom()");
-
-        /* We're dealing with: gt1.isHom(), gt2.isHet(), !gt2.genotypesArePhased(); so, the merged (het) Genotype is not phased relative to the previous Genotype
-
-           For example, if we're merging the third Genotype with the second one:
-           0/1
-           1|1
-           0/1
-
-           Then, we want to output:
-           0/1
-           1/2
-         */
-        return new PhaseAndQuality(gt2); // maintain the phase of gt2 [since !gt2.genotypesArePhased()]
-    }
-
-    /* Checks if any sample has a MNP of ALT alleles (segregating together):
-     [Assumes that vc1 and vc2 were already checked to have the same sample names && allSamplesAreMergeable(vc1, vc2)]
-     */
-
-    public static boolean someSampleHasDoubleNonReferenceAllele(VariantContext vc1, VariantContext vc2) {
-        for (final Genotype gt1 : vc1.getGenotypes()) {
-            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
-
-            List<Allele> site1Alleles = gt1.getAlleles();
-            List<Allele> site2Alleles = gt2.getAlleles();
-
-            Iterator<Allele> all2It = site2Alleles.iterator();
-            for (Allele all1 : site1Alleles) {
-                Allele all2 = all2It.next(); // this is OK, since allSamplesAreMergeable()
-
-                if (all1.isNonReference() && all2.isNonReference()) // corresponding alleles are alternate
-                    return true;
-            }
-        }
-
-        return false;
-    }
-
-    /* Checks if all samples are consistent in their haplotypes:
-     [Assumes that vc1 and vc2 were already checked to have the same sample names && allSamplesAreMergeable(vc1, vc2)]
-     */
-
-    public static boolean doubleAllelesSegregatePerfectlyAmongSamples(VariantContext vc1, VariantContext vc2) {
-        // Check that Alleles at vc1 and at vc2 always segregate together in all samples (including reference):
-        Map<Allele, Allele> allele1ToAllele2 = new HashMap<Allele, Allele>();
-        Map<Allele, Allele> allele2ToAllele1 = new HashMap<Allele, Allele>();
-
-        // Note the segregation of the alleles for the reference genome:
-        allele1ToAllele2.put(vc1.getReference(), vc2.getReference());
-        allele2ToAllele1.put(vc2.getReference(), vc1.getReference());
-
-        // Note the segregation of the alleles for each sample (and check that it is consistent with the reference and all previous samples).
-        for (final Genotype gt1 : vc1.getGenotypes()) {
-            Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
-
-            List<Allele> site1Alleles = gt1.getAlleles();
-            List<Allele> site2Alleles = gt2.getAlleles();
-
-            Iterator<Allele> all2It = site2Alleles.iterator();
-            for (Allele all1 : site1Alleles) {
-                Allele all2 = all2It.next();
-
-                Allele all1To2 = allele1ToAllele2.get(all1);
-                if (all1To2 == null)
-                    allele1ToAllele2.put(all1, all2);
-                else if (!all1To2.equals(all2)) // all1 segregates with two different alleles at site 2
-                    return false;
-
-                Allele all2To1 = allele2ToAllele1.get(all2);
-                if (all2To1 == null)
-                    allele2ToAllele1.put(all2, all1);
-                else if (!all2To1.equals(all1)) // all2 segregates with two different alleles at site 1
-                    return false;
-            }
-        }
-
-        return true;
-    }
-}
\ No newline at end of file
+}

From 231c47c039b2cdfcb565c1640e00aa1225f7ff71 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 15 Nov 2011 16:42:50 -0500
Subject: [PATCH 031/113] Bugfixes on way to a working refactored
 VariantContext

---
 .../sting/gatk/walkers/phasing/PhasingUtils.java             | 3 +--
 .../sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java  | 4 +++-
 .../sting/utils/variantcontext/GenotypeCollection.java       | 5 +----
 3 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
index 8b5455e50..ce35baf15 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
@@ -129,9 +129,8 @@ class PhasingUtils {
         List<String> mergedIDs = new ArrayList<String>();
         if ( vc1.hasID() ) mergedIDs.add(vc1.getID());
         if ( vc2.hasID() ) mergedIDs.add(vc2.getID());
-        String mergedID = Utils.join(VCFConstants.ID_FIELD_SEPARATOR, mergedIDs);
+        String mergedID = mergedIDs.isEmpty() ? VCFConstants.EMPTY_ID_FIELD : Utils.join(VCFConstants.ID_FIELD_SEPARATOR, mergedIDs);
 
-        // TODO -- FIX ID
         VariantContext mergedVc = new VariantContext(mergedName, mergedID, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles(), mergedGenotypes, mergedNegLog10PError, mergedFilters, mergedAttribs);
 
         mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index 8cc0d8856..f2d870068 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -1126,9 +1126,11 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         private double negLog10PError;
         private Set<String> filters;
         private Map<String, Object> attributes;
+        private String id;
 
         public UnfinishedVariantContext(VariantContext vc) {
             this.name = vc.getSource();
+            this.id = vc.getID();
             this.contig = vc.getChr();
             this.start = vc.getStart();
             this.stop = vc.getEnd();
@@ -1140,7 +1142,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         }
 
         public VariantContext toVariantContext() {
-            return new VariantContext(name, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
+            return new VariantContext(name, id, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
         }
 
         public GenomeLoc getLocation() {
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
index 260543031..b8c628717 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
@@ -70,9 +70,6 @@ public class GenotypeCollection implements List<Genotype> {
         return new GenotypeCollection(nGenotypes, false);
     }
 
-    // todo -- differentiate between empty constructor and copy constructor
-    // todo -- create constructor (Genotype ... genotypes)
-
     public static final GenotypeCollection create(final ArrayList<Genotype> genotypes) {
         return genotypes == null ? NO_GENOTYPES : new GenotypeCollection(genotypes, false);
     }
@@ -82,7 +79,7 @@ public class GenotypeCollection implements List<Genotype> {
     }
 
     public static final GenotypeCollection copy(final GenotypeCollection toCopy) {
-        return create(toCopy.genotypes);
+        return create(new ArrayList<Genotype>(toCopy.genotypes));
     }
 
     public static final GenotypeCollection copy(final Collection<Genotype> toCopy) {

From 0be23aae4e33a78f6cc56ef15e42f46d7742c1f4 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 15 Nov 2011 17:20:14 -0500
Subject: [PATCH 032/113] Bugfixes on way to a working refactored
 VariantContext

---
 .../sting/gatk/walkers/diffengine/VCFDiffableReader.java  | 8 +++++++-
 .../sting/utils/variantcontext/VariantContext.java        | 8 ++++++--
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
index 4b8a703a5..6b5ffd3ed 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
@@ -24,6 +24,7 @@
 
 package org.broadinstitute.sting.gatk.walkers.diffengine;
 
+import org.apache.log4j.Logger;
 import org.broad.tribble.readers.AsciiLineReader;
 import org.broad.tribble.readers.LineReader;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
@@ -46,6 +47,8 @@ import java.util.Map;
  * Class implementing diffnode reader for VCF
  */
 public class VCFDiffableReader implements DiffableReader {
+    private static Logger logger = Logger.getLogger(VCFDiffableReader.class);
+
     @Override
     public String getName() { return "VCF"; }
 
@@ -68,7 +71,10 @@ public class VCFDiffableReader implements DiffableReader {
                 String key = headerLine.getKey();
                 if ( headerLine instanceof VCFNamedHeaderLine )
                     key += "_" + ((VCFNamedHeaderLine) headerLine).getName();
-                root.add(key, headerLine.toString());
+                if ( root.hasElement(key) )
+                    logger.warn("Skipping duplicate header line: file=" + file + " line=" + headerLine.toString());
+                else
+                    root.add(key, headerLine.toString());
             }
 
             String line = lineReader.readLine();
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 661ed2bf4..77dc88cc5 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -388,10 +388,14 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         if ( this.ID.equals("") ) throw new IllegalArgumentException("ID field cannot be the empty string");
 
         if ( !genotypesAreUnparsed && attributes != null ) {
-            if ( attributes.containsKey(UNPARSED_GENOTYPE_MAP_KEY) )
+            if ( attributes.containsKey(UNPARSED_GENOTYPE_MAP_KEY) ) {
+                attributes = new HashMap<String, Object>(attributes);
                 attributes.remove(UNPARSED_GENOTYPE_MAP_KEY);
-            if ( attributes.containsKey(UNPARSED_GENOTYPE_PARSER_KEY) )
+            }
+            if ( attributes.containsKey(UNPARSED_GENOTYPE_PARSER_KEY) ) {
+                attributes = new HashMap<String, Object>(attributes);
                 attributes.remove(UNPARSED_GENOTYPE_PARSER_KEY);
+            }
         }
 
         this.commonInfo = new CommonInfo(source, negLog10PError, filters, attributes);

From df415da4abd83f55bb59d900ea28f23e04314aca Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 15 Nov 2011 17:38:12 -0500
Subject: [PATCH 033/113] More bug fixes on the way to passing all tests

---
 .../variantcontext/GenotypeCollection.java    |  5 +-
 .../phasing/MergeMNPsIntegrationTest.java     | 51 -------------------
 2 files changed, 1 insertion(+), 55 deletions(-)
 delete mode 100644 public/java/test/org/broadinstitute/sting/gatk/walkers/phasing/MergeMNPsIntegrationTest.java

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
index b8c628717..6ccb2a9ff 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
@@ -219,12 +219,9 @@ public class GenotypeCollection implements List<Genotype> {
     public Genotype get(final String sampleName) {
         buildCache();
         Integer offset = sampleNameToOffset.get(sampleName);
-        if ( offset == null )
-            throw new IllegalArgumentException("Sample " + sampleName + " not found in this GenotypeCollection");
-        return genotypes.get(offset);
+        return offset == null ? null : genotypes.get(offset);
     }
 
-
     @Override
     public int indexOf(final Object o) {
         return genotypes.indexOf(o);
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/phasing/MergeMNPsIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/phasing/MergeMNPsIntegrationTest.java
deleted file mode 100644
index 2e4556af0..000000000
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/phasing/MergeMNPsIntegrationTest.java
+++ /dev/null
@@ -1,51 +0,0 @@
-package org.broadinstitute.sting.gatk.walkers.phasing;
-
-import org.broadinstitute.sting.WalkerTest;
-import org.testng.annotations.Test;
-
-import java.util.Arrays;
-
-public class MergeMNPsIntegrationTest extends WalkerTest {
-
-    public static String baseTestString(String reference, String VCF, int maxDistMNP) {
-        return "-T MergeMNPs" +
-                " -R " + reference +
-                " --variant:vcf " + validationDataLocation + VCF +
-                " --maxGenomicDistanceForMNP " + maxDistMNP +
-                " -o %s" +
-                " -NO_HEADER";
-    }
-
-
-    @Test
-    public void test1() {
-        WalkerTestSpec spec = new WalkerTestSpec(
-                baseTestString(hg18Reference, "merging_test_chr20_556259_756570.vcf", 1)
-                        + " -L chr20:556259-756570",
-                1,
-                Arrays.asList("7f11f7f75d1526077f0173c7ed1fc6c4"));
-        executeTest("Merge MNP sites within genomic distance of 1 [TEST ONE]", spec);
-    }
-
-    @Test
-    public void test2() {
-        WalkerTestSpec spec = new WalkerTestSpec(
-                baseTestString(hg18Reference, "merging_test_chr20_556259_756570.vcf", 10)
-                        + " -L chr20:556259-756570",
-                1,
-                Arrays.asList("53dd312468296826bdd3c22387390c88"));
-        executeTest("Merge MNP sites within genomic distance of 10 [TEST TWO]", spec);
-    }
-
-    @Test
-    public void test3() {
-        WalkerTestSpec spec = new WalkerTestSpec(
-                baseTestString(hg18Reference, "merging_test_chr20_556259_756570.vcf", 100)
-                        + " -L chr20:556259-756570",
-                1,
-                Arrays.asList("e26f92d2fb9f4eaeac7f9d8ee27410ee"));
-        executeTest("Merge MNP sites within genomic distance of 100 [TEST THREE]", spec);
-    }
-
-
-}
\ No newline at end of file

From 0d163e3f52b4de1b54c2213aea5aca14f336acd0 Mon Sep 17 00:00:00 2001
From: David Roazen <droazen@broadinstitute.org>
Date: Tue, 15 Nov 2011 16:05:20 -0500
Subject: [PATCH 034/113] SnpEff 2.0.4 support

-Modified the SnpEff parser to work with the SnpEff 2.0.4 VCF output format
-Assigning functional classes and effect impacts now handled directly
 by SnpEff rather than the GATK
-Removed support for SnpEff 2.0.2, as we no longer trust the output of that
 version since it doesn't exclude effects associated with certain nonsensical
 transcripts. These effects are excluded as of 2.0.4.
-Updated unit and integration tests

This support is based on a *release-candidate* of SnpEff 2.0.4, and so is subject
to change between now and the next GATK release.
---
 .../sting/gatk/walkers/annotator/SnpEff.java  | 180 +++++++++---------
 .../walkers/annotator/SnpEffUnitTest.java     |  20 +-
 .../VariantAnnotatorIntegrationTest.java      |   4 +-
 .../VariantEvalIntegrationTest.java           |   6 +-
 4 files changed, 106 insertions(+), 104 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SnpEff.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SnpEff.java
index 85977bf8e..1956dac6c 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SnpEff.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SnpEff.java
@@ -56,7 +56,7 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
 
     // We refuse to parse SnpEff output files generated by unsupported versions, or
     // lacking a SnpEff version number in the VCF header:
-    public static final String[] SUPPORTED_SNPEFF_VERSIONS = { "2.0.2" };
+    public static final String[] SUPPORTED_SNPEFF_VERSIONS = { "2.0.4" };
     public static final String SNPEFF_VCF_HEADER_VERSION_LINE_KEY = "SnpEffVersion";
     public static final String SNPEFF_VCF_HEADER_COMMAND_LINE_KEY = "SnpEffCmd";
 
@@ -77,13 +77,13 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
     public enum InfoFieldKey {
         EFFECT_KEY            ("SNPEFF_EFFECT",           -1),
         IMPACT_KEY            ("SNPEFF_IMPACT",            0),
-        CODON_CHANGE_KEY      ("SNPEFF_CODON_CHANGE",      1),
-        AMINO_ACID_CHANGE_KEY ("SNPEFF_AMINO_ACID_CHANGE", 2),
-        GENE_NAME_KEY         ("SNPEFF_GENE_NAME",         3),
-        GENE_BIOTYPE_KEY      ("SNPEFF_GENE_BIOTYPE",      4),
-        TRANSCRIPT_ID_KEY     ("SNPEFF_TRANSCRIPT_ID",     6),
-        EXON_ID_KEY           ("SNPEFF_EXON_ID",           7),
-        FUNCTIONAL_CLASS_KEY  ("SNPEFF_FUNCTIONAL_CLASS", -1);
+        FUNCTIONAL_CLASS_KEY  ("SNPEFF_FUNCTIONAL_CLASS",  1),
+        CODON_CHANGE_KEY      ("SNPEFF_CODON_CHANGE",      2),
+        AMINO_ACID_CHANGE_KEY ("SNPEFF_AMINO_ACID_CHANGE", 3),
+        GENE_NAME_KEY         ("SNPEFF_GENE_NAME",         4),
+        GENE_BIOTYPE_KEY      ("SNPEFF_GENE_BIOTYPE",      5),
+        TRANSCRIPT_ID_KEY     ("SNPEFF_TRANSCRIPT_ID",     7),
+        EXON_ID_KEY           ("SNPEFF_EXON_ID",           8);
 
         // Actual text of the key
         private final String keyName;
@@ -110,70 +110,53 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
     // are validated against this list.
     public enum EffectType {
         // High-impact effects:
-        FRAME_SHIFT                           (EffectFunctionalClass.NONE,     false),
-        STOP_GAINED                           (EffectFunctionalClass.NONSENSE, false),
-        START_LOST                            (EffectFunctionalClass.NONE,     false),
-        SPLICE_SITE_ACCEPTOR                  (EffectFunctionalClass.NONE,     false),
-        SPLICE_SITE_DONOR                     (EffectFunctionalClass.NONE,     false),
-        EXON_DELETED                          (EffectFunctionalClass.NONE,     false),
-        STOP_LOST                             (EffectFunctionalClass.NONE,     false),
+        SPLICE_SITE_ACCEPTOR,
+        SPLICE_SITE_DONOR,
+        START_LOST,
+        EXON_DELETED,
+        FRAME_SHIFT,
+        STOP_GAINED,
+        STOP_LOST,
 
         // Moderate-impact effects:
-        NON_SYNONYMOUS_CODING                 (EffectFunctionalClass.MISSENSE, false),
-        CODON_CHANGE                          (EffectFunctionalClass.NONE,     false),
-        CODON_INSERTION                       (EffectFunctionalClass.NONE,     false),
-        CODON_CHANGE_PLUS_CODON_INSERTION     (EffectFunctionalClass.NONE,     false),
-        CODON_DELETION                        (EffectFunctionalClass.NONE,     false),
-        CODON_CHANGE_PLUS_CODON_DELETION      (EffectFunctionalClass.NONE,     false),
-        UTR_5_DELETED                         (EffectFunctionalClass.NONE,     false),
-        UTR_3_DELETED                         (EffectFunctionalClass.NONE,     false),
+        NON_SYNONYMOUS_CODING,
+        CODON_CHANGE,
+        CODON_INSERTION,
+        CODON_CHANGE_PLUS_CODON_INSERTION,
+        CODON_DELETION,
+        CODON_CHANGE_PLUS_CODON_DELETION,
+        UTR_5_DELETED,
+        UTR_3_DELETED,
 
         // Low-impact effects:
-        SYNONYMOUS_CODING                     (EffectFunctionalClass.SILENT,   false),
-        SYNONYMOUS_START                      (EffectFunctionalClass.SILENT,   false),
-        NON_SYNONYMOUS_START                  (EffectFunctionalClass.SILENT,   false),
-        SYNONYMOUS_STOP                       (EffectFunctionalClass.SILENT,   false),
-        NON_SYNONYMOUS_STOP                   (EffectFunctionalClass.SILENT,   false),
-        START_GAINED                          (EffectFunctionalClass.NONE,     false),
+        SYNONYMOUS_START,
+        NON_SYNONYMOUS_START,
+        START_GAINED,
+        SYNONYMOUS_CODING,
+        SYNONYMOUS_STOP,
+        NON_SYNONYMOUS_STOP,
 
         // Modifiers:
-        NONE                                  (EffectFunctionalClass.NONE,     true),
-        CHROMOSOME                            (EffectFunctionalClass.NONE,     true),
-        INTERGENIC                            (EffectFunctionalClass.NONE,     true),
-        UPSTREAM                              (EffectFunctionalClass.NONE,     true),
-        UTR_5_PRIME                           (EffectFunctionalClass.NONE,     true),
-        CDS                                   (EffectFunctionalClass.NONE,     true),
-        GENE                                  (EffectFunctionalClass.NONE,     true),
-        TRANSCRIPT                            (EffectFunctionalClass.NONE,     true),
-        EXON                                  (EffectFunctionalClass.NONE,     true),
-        INTRON                                (EffectFunctionalClass.NONE,     true),
-        UTR_3_PRIME                           (EffectFunctionalClass.NONE,     true),
-        DOWNSTREAM                            (EffectFunctionalClass.NONE,     true),
-        INTRON_CONSERVED                      (EffectFunctionalClass.NONE,     true),
-        INTERGENIC_CONSERVED                  (EffectFunctionalClass.NONE,     true),
-        REGULATION                            (EffectFunctionalClass.NONE,     true),
-        CUSTOM                                (EffectFunctionalClass.NONE,     true),
-        WITHIN_NON_CODING_GENE                (EffectFunctionalClass.NONE,     true);
-
-        private final EffectFunctionalClass functionalClass;
-        private final boolean isModifier;
-
-        EffectType ( EffectFunctionalClass functionalClass, boolean isModifier ) {
-            this.functionalClass = functionalClass;
-            this.isModifier = isModifier;
-        }
-
-        public EffectFunctionalClass getFunctionalClass() {
-            return functionalClass;
-        }
-
-        public boolean isModifier() {
-            return isModifier;
-        }
+        NONE,
+        CHROMOSOME,
+        CUSTOM,
+        CDS,
+        GENE,
+        TRANSCRIPT,
+        EXON,
+        INTRON_CONSERVED,
+        UTR_5_PRIME,
+        UTR_3_PRIME,
+        DOWNSTREAM,
+        INTRAGENIC,
+        INTERGENIC,
+        INTERGENIC_CONSERVED,
+        UPSTREAM,
+        REGULATION,
+        INTRON
     }
 
-    // SnpEff labels each effect as either LOW, MODERATE, or HIGH impact. We take the additional step of
-    // classifying some of the LOW impact effects as MODIFIERs.
+    // SnpEff labels each effect as either LOW, MODERATE, or HIGH impact, or as a MODIFIER.
     public enum EffectImpact {
         MODIFIER  (0),
         LOW       (1),
@@ -202,7 +185,7 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
         UNKNOWN
     }
 
-    // We assign a functional class to each SnpEff effect.
+    // SnpEff assigns a functional class to each effect.
     public enum EffectFunctionalClass {
         NONE     (0),
         SILENT   (1),
@@ -379,13 +362,13 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
     public List<String> getKeyNames() {
         return Arrays.asList( InfoFieldKey.EFFECT_KEY.getKeyName(),
                               InfoFieldKey.IMPACT_KEY.getKeyName(),
+                              InfoFieldKey.FUNCTIONAL_CLASS_KEY.getKeyName(),
                               InfoFieldKey.CODON_CHANGE_KEY.getKeyName(),
                               InfoFieldKey.AMINO_ACID_CHANGE_KEY.getKeyName(),
                               InfoFieldKey.GENE_NAME_KEY.getKeyName(),
                               InfoFieldKey.GENE_BIOTYPE_KEY.getKeyName(),
                               InfoFieldKey.TRANSCRIPT_ID_KEY.getKeyName(),
-                              InfoFieldKey.EXON_ID_KEY.getKeyName(),
-                              InfoFieldKey.FUNCTIONAL_CLASS_KEY.getKeyName()
+                              InfoFieldKey.EXON_ID_KEY.getKeyName()
                             );
     }
 
@@ -393,13 +376,13 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
         return Arrays.asList(
             new VCFInfoHeaderLine(InfoFieldKey.EFFECT_KEY.getKeyName(),            1, VCFHeaderLineType.String,  "The highest-impact effect resulting from the current variant (or one of the highest-impact effects, if there is a tie)"),
             new VCFInfoHeaderLine(InfoFieldKey.IMPACT_KEY.getKeyName(),            1, VCFHeaderLineType.String,  "Impact of the highest-impact effect resulting from the current variant " + Arrays.toString(EffectImpact.values())),
+            new VCFInfoHeaderLine(InfoFieldKey.FUNCTIONAL_CLASS_KEY.getKeyName(),  1, VCFHeaderLineType.String,  "Functional class of the highest-impact effect resulting from the current variant: " + Arrays.toString(EffectFunctionalClass.values())),
             new VCFInfoHeaderLine(InfoFieldKey.CODON_CHANGE_KEY.getKeyName(),      1, VCFHeaderLineType.String,  "Old/New codon for the highest-impact effect resulting from the current variant"),
-            new VCFInfoHeaderLine(InfoFieldKey.AMINO_ACID_CHANGE_KEY.getKeyName(), 1, VCFHeaderLineType.String,  "Old/New amino acid for the highest-impact effect resulting from the current variant"),
+            new VCFInfoHeaderLine(InfoFieldKey.AMINO_ACID_CHANGE_KEY.getKeyName(), 1, VCFHeaderLineType.String,  "Old/New amino acid for the highest-impact effect resulting from the current variant (in HGVS style)"),
             new VCFInfoHeaderLine(InfoFieldKey.GENE_NAME_KEY.getKeyName(),         1, VCFHeaderLineType.String,  "Gene name for the highest-impact effect resulting from the current variant"),
             new VCFInfoHeaderLine(InfoFieldKey.GENE_BIOTYPE_KEY.getKeyName(),      1, VCFHeaderLineType.String,  "Gene biotype for the highest-impact effect resulting from the current variant"),
             new VCFInfoHeaderLine(InfoFieldKey.TRANSCRIPT_ID_KEY.getKeyName(),     1, VCFHeaderLineType.String,  "Transcript ID for the highest-impact effect resulting from the current variant"),
-            new VCFInfoHeaderLine(InfoFieldKey.EXON_ID_KEY.getKeyName(),           1, VCFHeaderLineType.String,  "Exon ID for the highest-impact effect resulting from the current variant"),
-            new VCFInfoHeaderLine(InfoFieldKey.FUNCTIONAL_CLASS_KEY.getKeyName(),  1, VCFHeaderLineType.String,  "Functional class of the highest-impact effect resulting from the current variant: " + Arrays.toString(EffectFunctionalClass.values()))
+            new VCFInfoHeaderLine(InfoFieldKey.EXON_ID_KEY.getKeyName(),           1, VCFHeaderLineType.String,  "Exon ID for the highest-impact effect resulting from the current variant")
         );
     }
 
@@ -409,6 +392,7 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
     protected static class SnpEffEffect {
         private EffectType effect;
         private EffectImpact impact;
+        private EffectFunctionalClass functionalClass;
         private String codonChange;
         private String aminoAcidChange;
         private String geneName;
@@ -420,16 +404,21 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
         private String parseError = null;
         private boolean isWellFormed = true;
 
-        private static final int EXPECTED_NUMBER_OF_METADATA_FIELDS = 8;
-        private static final int NUMBER_OF_METADATA_FIELDS_UPON_WARNING = 9;
-        private static final int NUMBER_OF_METADATA_FIELDS_UPON_ERROR = 10;
+        private static final int EXPECTED_NUMBER_OF_METADATA_FIELDS = 9;
+        private static final int NUMBER_OF_METADATA_FIELDS_UPON_EITHER_WARNING_OR_ERROR = 10;
+        private static final int NUMBER_OF_METADATA_FIELDS_UPON_BOTH_WARNING_AND_ERROR = 11;
 
-        // Note that contrary to the description for the EFF field layout that SnpEff adds to the VCF header,
-        // errors come after warnings, not vice versa:
-        private static final int SNPEFF_WARNING_FIELD_INDEX = NUMBER_OF_METADATA_FIELDS_UPON_WARNING - 1;
-        private static final int SNPEFF_ERROR_FIELD_INDEX = NUMBER_OF_METADATA_FIELDS_UPON_ERROR - 1;
+        // If there is either a warning OR an error, it will be in the last field. If there is both
+        // a warning AND an error, the warning will be in the second-to-last field, and the error will
+        // be in the last field.
+        private static final int SNPEFF_WARNING_OR_ERROR_FIELD_UPON_SINGLE_ERROR = NUMBER_OF_METADATA_FIELDS_UPON_EITHER_WARNING_OR_ERROR - 1;
+        private static final int SNPEFF_WARNING_FIELD_UPON_BOTH_WARNING_AND_ERROR = NUMBER_OF_METADATA_FIELDS_UPON_BOTH_WARNING_AND_ERROR - 2;
+        private static final int SNPEFF_ERROR_FIELD_UPON_BOTH_WARNING_AND_ERROR = NUMBER_OF_METADATA_FIELDS_UPON_BOTH_WARNING_AND_ERROR - 1;
 
-        private static final int SNPEFF_CODING_FIELD_INDEX = 5;
+        // Position of the field indicating whether the effect is coding or non-coding. This field is used
+        // in selecting the most significant effect, but is not included in the annotations we return
+        // since it can be deduced from the SNPEFF_GENE_BIOTYPE field.
+        private static final int SNPEFF_CODING_FIELD_INDEX = 6;
 
         public SnpEffEffect ( String effectName, String[] effectMetadata ) {
             parseEffectName(effectName);
@@ -447,11 +436,14 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
 
         private void parseEffectMetadata ( String[] effectMetadata ) {
             if ( effectMetadata.length != EXPECTED_NUMBER_OF_METADATA_FIELDS ) {
-                if ( effectMetadata.length == NUMBER_OF_METADATA_FIELDS_UPON_WARNING ) {
-                    parseError(String.format("SnpEff issued the following warning: %s", effectMetadata[SNPEFF_WARNING_FIELD_INDEX]));
+                if ( effectMetadata.length == NUMBER_OF_METADATA_FIELDS_UPON_EITHER_WARNING_OR_ERROR ) {
+                    parseError(String.format("SnpEff issued the following warning or error: \"%s\"",
+                                             effectMetadata[SNPEFF_WARNING_OR_ERROR_FIELD_UPON_SINGLE_ERROR]));
                 }
-                else if ( effectMetadata.length == NUMBER_OF_METADATA_FIELDS_UPON_ERROR ) {
-                    parseError(String.format("SnpEff issued the following error: %s", effectMetadata[SNPEFF_ERROR_FIELD_INDEX]));
+                else if ( effectMetadata.length == NUMBER_OF_METADATA_FIELDS_UPON_BOTH_WARNING_AND_ERROR ) {
+                    parseError(String.format("SnpEff issued the following warning: \"%s\", and the following error: \"%s\"",
+                                             effectMetadata[SNPEFF_WARNING_FIELD_UPON_BOTH_WARNING_AND_ERROR],
+                                             effectMetadata[SNPEFF_ERROR_FIELD_UPON_BOTH_WARNING_AND_ERROR]));
                 }
                 else {
                     parseError(String.format("Wrong number of effect metadata fields. Expected %d but found %d",
@@ -461,23 +453,33 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
                 return;
             }
 
-            if ( effect != null && effect.isModifier() ) {
-                impact = EffectImpact.MODIFIER;
+            // The impact field will never be empty, and should always contain one of the enumerated values:
+            try {
+                impact = EffectImpact.valueOf(effectMetadata[InfoFieldKey.IMPACT_KEY.getFieldIndex()]);
             }
-            else {
+            catch ( IllegalArgumentException e ) {
+                parseError(String.format("Unrecognized value for effect impact: %s", effectMetadata[InfoFieldKey.IMPACT_KEY.getFieldIndex()]));
+            }
+
+            // The functional class field will be empty when the effect has no functional class associated with it:
+            if ( effectMetadata[InfoFieldKey.FUNCTIONAL_CLASS_KEY.getFieldIndex()].trim().length() > 0 ) {
                 try {
-                    impact = EffectImpact.valueOf(effectMetadata[InfoFieldKey.IMPACT_KEY.getFieldIndex()]);
+                    functionalClass = EffectFunctionalClass.valueOf(effectMetadata[InfoFieldKey.FUNCTIONAL_CLASS_KEY.getFieldIndex()]);
                 }
                 catch ( IllegalArgumentException e ) {
-                    parseError(String.format("Unrecognized value for effect impact: %s", effectMetadata[InfoFieldKey.IMPACT_KEY.getFieldIndex()]));
+                    parseError(String.format("Unrecognized value for effect functional class: %s", effectMetadata[InfoFieldKey.FUNCTIONAL_CLASS_KEY.getFieldIndex()]));
                 }
             }
+            else {
+                functionalClass = EffectFunctionalClass.NONE;
+            }
 
             codonChange = effectMetadata[InfoFieldKey.CODON_CHANGE_KEY.getFieldIndex()];
             aminoAcidChange = effectMetadata[InfoFieldKey.AMINO_ACID_CHANGE_KEY.getFieldIndex()];
             geneName = effectMetadata[InfoFieldKey.GENE_NAME_KEY.getFieldIndex()];
             geneBiotype = effectMetadata[InfoFieldKey.GENE_BIOTYPE_KEY.getFieldIndex()];
 
+            // The coding field will be empty when SnpEff has no coding info for the effect:
             if ( effectMetadata[SNPEFF_CODING_FIELD_INDEX].trim().length() > 0 ) {
                 try {
                     coding = EffectCoding.valueOf(effectMetadata[SNPEFF_CODING_FIELD_INDEX]);
@@ -534,7 +536,7 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
                 return true;
             }
             else if ( impact.isSameImpactAs(other.impact) ) {
-                return effect.getFunctionalClass().isHigherPriorityThan(other.effect.getFunctionalClass());
+                return functionalClass.isHigherPriorityThan(other.functionalClass);
             }
 
             return false;
@@ -545,13 +547,13 @@ public class SnpEff extends InfoFieldAnnotation implements RodRequiringAnnotatio
 
             addAnnotation(annotations, InfoFieldKey.EFFECT_KEY.getKeyName(), effect.toString());
             addAnnotation(annotations, InfoFieldKey.IMPACT_KEY.getKeyName(), impact.toString());
+            addAnnotation(annotations, InfoFieldKey.FUNCTIONAL_CLASS_KEY.getKeyName(), functionalClass.toString());
             addAnnotation(annotations, InfoFieldKey.CODON_CHANGE_KEY.getKeyName(), codonChange);
             addAnnotation(annotations, InfoFieldKey.AMINO_ACID_CHANGE_KEY.getKeyName(), aminoAcidChange);
             addAnnotation(annotations, InfoFieldKey.GENE_NAME_KEY.getKeyName(), geneName);
             addAnnotation(annotations, InfoFieldKey.GENE_BIOTYPE_KEY.getKeyName(), geneBiotype);
             addAnnotation(annotations, InfoFieldKey.TRANSCRIPT_ID_KEY.getKeyName(), transcriptID);
             addAnnotation(annotations, InfoFieldKey.EXON_ID_KEY.getKeyName(), exonID);
-            addAnnotation(annotations, InfoFieldKey.FUNCTIONAL_CLASS_KEY.getKeyName(), effect.getFunctionalClass().toString());
 
             return annotations;
         }
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/SnpEffUnitTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/SnpEffUnitTest.java
index 462abeba1..5c8fa32a8 100644
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/SnpEffUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/SnpEffUnitTest.java
@@ -33,7 +33,7 @@ public class SnpEffUnitTest {
     @Test
     public void testParseWellFormedEffect() {
         String effectName = "NON_SYNONYMOUS_CODING";
-        String[] effectMetadata = { "MODERATE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829" };
+        String[] effectMetadata = { "MODERATE", "MISSENSE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829" };
 
         SnpEffEffect effect = new SnpEffEffect(effectName, effectMetadata);
         Assert.assertTrue( effect.isWellFormed() && effect.isCoding() );
@@ -42,7 +42,7 @@ public class SnpEffUnitTest {
     @Test
     public void testParseInvalidEffectNameEffect() {
         String effectName = "MADE_UP_EFFECT";
-        String[] effectMetadata = { "MODERATE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829" };
+        String[] effectMetadata = { "MODERATE", "MISSENSE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829" };
 
         SnpEffEffect effect = new SnpEffEffect(effectName, effectMetadata);
         Assert.assertFalse(effect.isWellFormed());
@@ -51,7 +51,7 @@ public class SnpEffUnitTest {
     @Test
     public void testParseInvalidEffectImpactEffect() {
         String effectName = "NON_SYNONYMOUS_CODING";
-        String[] effectMetadata = { "MEDIUM", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829" };
+        String[] effectMetadata = { "MEDIUM", "MISSENSE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829" };
 
         SnpEffEffect effect = new SnpEffEffect(effectName, effectMetadata);
         Assert.assertFalse(effect.isWellFormed());
@@ -60,27 +60,27 @@ public class SnpEffUnitTest {
     @Test
     public void testParseWrongNumberOfMetadataFieldsEffect() {
         String effectName = "NON_SYNONYMOUS_CODING";
-        String[] effectMetadata = { "MODERATE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990" };
+        String[] effectMetadata = { "MODERATE", "MISSENSE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990" };
 
         SnpEffEffect effect = new SnpEffEffect(effectName, effectMetadata);
         Assert.assertFalse(effect.isWellFormed());
     }
 
     @Test
-    public void testParseSnpEffWarningEffect() {
+    public void testParseSnpEffOneWarningOrErrorEffect() {
         String effectName = "NON_SYNONYMOUS_CODING";
-        String[] effectMetadata = { "MODERATE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829", "SNPEFF_WARNING" };
+        String[] effectMetadata = { "MODERATE", "MISSENSE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829", "SNPEFF_WARNING_OR_ERROR_TEXT" };
 
         SnpEffEffect effect = new SnpEffEffect(effectName, effectMetadata);
-        Assert.assertTrue( ! effect.isWellFormed() && effect.getParseError().equals("SnpEff issued the following warning: SNPEFF_WARNING") );
+        Assert.assertTrue( ! effect.isWellFormed() && effect.getParseError().equals("SnpEff issued the following warning or error: \"SNPEFF_WARNING_OR_ERROR_TEXT\"") );
     }
 
     @Test
-    public void testParseSnpEffErrorEffect() {
+    public void testParseSnpEffBothWarningAndErrorEffect() {
         String effectName = "NON_SYNONYMOUS_CODING";
-        String[] effectMetadata = { "MODERATE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829", "", "SNPEFF_ERROR" };
+        String[] effectMetadata = { "MODERATE", "MISSENSE", "Aca/Gca", "T/A", "OR4F5", "protein_coding", "CODING", "ENST00000534990", "exon_1_69037_69829", "SNPEFF_WARNING_TEXT", "SNPEFF_ERROR_TEXT" };
 
         SnpEffEffect effect = new SnpEffEffect(effectName, effectMetadata);
-        Assert.assertTrue( ! effect.isWellFormed() && effect.getParseError().equals("SnpEff issued the following error: SNPEFF_ERROR") );
+        Assert.assertTrue( ! effect.isWellFormed() && effect.getParseError().equals("SnpEff issued the following warning: \"SNPEFF_WARNING_TEXT\", and the following error: \"SNPEFF_ERROR_TEXT\"") );
     }
 }
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
index bde4c4a8f..919e3d9bd 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
@@ -148,9 +148,9 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
         WalkerTestSpec spec = new WalkerTestSpec(
             "-T VariantAnnotator -R " + hg19Reference + " -NO_HEADER -o %s -A SnpEff --variant " +
             validationDataLocation + "1kg_exomes_unfiltered.AFR.unfiltered.vcf --snpEffFile  " + validationDataLocation +
-            "snpEff.AFR.unfiltered.vcf -L 1:1-1,500,000 -L 2:232,325,429",
+            "snpEff2.0.4.AFR.unfiltered.vcf -L 1:1-1,500,000 -L 2:232,325,429",
             1,
-            Arrays.asList("122321a85e448f21679f6ca15c5e22ad")
+            Arrays.asList("51258f5c880bd1ca3eb45a1711335c66")
         );
         executeTest("Testing SnpEff annotations", spec);
     }
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalIntegrationTest.java
index 3dceb9bd2..102d4715e 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalIntegrationTest.java
@@ -21,16 +21,16 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                                         "-T VariantEval",
                                         "-R " + b37KGReference,
                                         "--dbsnp " + b37dbSNP132,
-                                        "--eval " + validationDataLocation + "snpEff.AFR.unfiltered.VariantAnnotator.output.vcf",
+                                        "--eval " + validationDataLocation + "snpEff2.0.4.AFR.unfiltered.VariantAnnotator.output.vcf",
                                         "-noEV",
                                         "-EV TiTvVariantEvaluator",
                                         "-noST",
                                         "-ST FunctionalClass",
-                                        "-L " + validationDataLocation + "snpEff.AFR.unfiltered.VariantAnnotator.output.vcf",
+                                        "-L " + validationDataLocation + "snpEff2.0.4.AFR.unfiltered.VariantAnnotator.output.vcf",
                                         "-o %s"
                                 ),
                                 1,
-                                Arrays.asList("d9dcb352c53106f54fcc981f15d35a90")
+                                Arrays.asList("a36414421621b377d6146d58d2fcecd0")
                               );
         executeTest("testFunctionClassWithSnpeff", spec);
     }

From 7d77fc51f55948510e9d230864dbbe78e1f791b2 Mon Sep 17 00:00:00 2001
From: Laurent Francioli <lfran@broadinstitute.org>
Date: Wed, 16 Nov 2011 03:32:43 -0500
Subject: [PATCH 035/113] Corrected bug causing PhaseByTransmission to crash in
 case of new Genotype.Type

---
 .../walkers/phasing/PhaseByTransmission.java   | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
index 6394e0e24..847165e3e 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
@@ -151,16 +151,16 @@ public class PhaseByTransmission extends RodWalker<HashMap<Byte,Integer>, HashMa
                 alleles.add(VAR);
                 alleles.add(VAR);
             }
-            else if(genotype == Genotype.Type.NO_CALL){
-                alleles.add(NO_CALL);
-                alleles.add(NO_CALL);
-            }
             else{
                 return null;
             }
             return alleles;
         }
 
+        private boolean isPhasable(Genotype.Type genotype){
+            return genotype == Genotype.Type.HOM_REF || genotype == Genotype.Type.HET || genotype == Genotype.Type.HOM_VAR;
+        }
+
         //Create a new Genotype based on information from a single individual
         //Homozygous genotypes will be set as phased, heterozygous won't be
         private void phaseSingleIndividualAlleles(Genotype.Type genotype, FamilyMember familyMember){
@@ -271,21 +271,21 @@ public class PhaseByTransmission extends RodWalker<HashMap<Byte,Integer>, HashMa
         public TrioPhase(Genotype.Type mother, Genotype.Type father, Genotype.Type child){
 
             //Take care of cases where one or more family members are no call
-            if(child == Genotype.Type.NO_CALL || child == Genotype.Type.UNAVAILABLE){
+            if(!isPhasable(child)){
                 phaseSingleIndividualAlleles(mother, FamilyMember.MOTHER);
                 phaseSingleIndividualAlleles(father, FamilyMember.FATHER);
                 phaseSingleIndividualAlleles(child, FamilyMember.CHILD);
             }
-            else if(mother == Genotype.Type.NO_CALL || mother == Genotype.Type.UNAVAILABLE){
+            else if(!isPhasable(mother)){
                 phaseSingleIndividualAlleles(mother, FamilyMember.MOTHER);
-                if(father == Genotype.Type.NO_CALL || father == Genotype.Type.UNAVAILABLE){
+                if(!isPhasable(father)){
                     phaseSingleIndividualAlleles(father, FamilyMember.FATHER);
                     phaseSingleIndividualAlleles(child, FamilyMember.CHILD);
                 }
                 else
                     phasePairAlleles(father, child, FamilyMember.FATHER);
             }
-            else if(father == Genotype.Type.NO_CALL || father == Genotype.Type.UNAVAILABLE){
+            else if(!isPhasable(father)){
                 phasePairAlleles(mother, child, FamilyMember.MOTHER);
                 phaseSingleIndividualAlleles(father, FamilyMember.FATHER);
             }
@@ -327,7 +327,7 @@ public class PhaseByTransmission extends RodWalker<HashMap<Byte,Integer>, HashMa
            //Note that only cases where a null/missing/unavailable genotype was passed in the first place can lead to a null/missing/unavailable
            //genotype so it is safe to return the original genotype in this case.
            //In addition, if the phasing confidence is 0, then return the unphased, original genotypes.
-           if(phredScoreTransmission ==0 || genotype == null || !phasedGenotype.isAvailable() || phasedGenotype.isNoCall())
+           if(phredScoreTransmission ==0 || genotype == null || !isPhasable(genotype.getType()))
                return genotype;
 
            //Add the transmission probability

From 7ac5cf8430e82822d008c35b99d37f35b151230e Mon Sep 17 00:00:00 2001
From: Matt Hanna <hanna@broadinstitute.org>
Date: Wed, 16 Nov 2011 09:53:59 -0500
Subject: [PATCH 036/113] Getting rid of unsupported CountReadPairs walker in
 stable.  Removal of remainder of pairs processing framework to follow in
 unstable.

---
 .../gatk/walkers/qc/CountPairsWalker.java     | 140 ------------------
 1 file changed, 140 deletions(-)
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/walkers/qc/CountPairsWalker.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/qc/CountPairsWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/qc/CountPairsWalker.java
deleted file mode 100644
index e770418c1..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/qc/CountPairsWalker.java
+++ /dev/null
@@ -1,140 +0,0 @@
-/*
- * Copyright (c) 2010.
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
- * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.walkers.qc;
-
-import net.sf.samtools.SAMRecord;
-import org.broadinstitute.sting.commandline.Output;
-import org.broadinstitute.sting.gatk.walkers.ReadPairWalker;
-import org.broadinstitute.sting.utils.collections.ExpandingArrayList;
-
-import java.io.PrintStream;
-import java.util.Collection;
-import java.util.List;
-
-/**
- * Counts the number of read pairs encountered in a file sorted in
- * query name order.  Breaks counts down by total pairs and number
- * of paired reads.
- *
- *
- * <h2>Input</h2>
- * <p>
- * One or more bam files.
- * </p>
- *
- * <h2>Output</h2>
- * <p>
- * Number of pairs seen.
- * </p>
- *
- * <h2>Examples</h2>
- * <pre>
- * java -Xmx2g -jar GenomeAnalysisTK.jar \
- *   -R ref.fasta \
- *   -T CountPairs \
- *   -o output.txt \
- *   -I input.bam
- * </pre>
- *
- * @author mhanna
- */
-public class CountPairsWalker extends ReadPairWalker<Integer,Long> {
-    @Output
-    private PrintStream out;
-
-    /**
-     * How many reads are the first in a pair, based on flag 0x0040 from the SAM spec.
-     */
-    private long firstOfPair = 0;
-
-    /**
-     * How many reads are the second in a pair, based on flag 0x0080 from the SAM spec.
-     */
-    private long secondOfPair = 0;
-
-    /**
-     * A breakdown of the total number of reads seen with exactly the same read name.
-     */
-    private List<Long> pairCountsByType = new ExpandingArrayList<Long>();
-
-    /**
-     * Maps a read pair to a given reduce of type MapType.  Semantics determined by subclasser.
-     * @param reads Collection of reads having the same name.
-     * @return Semantics defined by implementer.
-     */
-    @Override
-    public Integer map(Collection<SAMRecord> reads) {
-        if(pairCountsByType.get(reads.size()) != null)
-            pairCountsByType.set(reads.size(),pairCountsByType.get(reads.size())+1);
-        else
-            pairCountsByType.set(reads.size(),1L);
-
-        for(SAMRecord read: reads) {
-            if(read.getFirstOfPairFlag()) firstOfPair++;
-            if(read.getSecondOfPairFlag()) secondOfPair++;
-        }
-
-        return 1;
-    }
-
-    /**
-     * No pairs at the beginning of a traversal.
-     * @return 0 always.
-     */
-    @Override
-    public Long reduceInit() {
-        return 0L;
-    }
-
-    /**
-     * Combine number of pairs seen in this iteration (always 1) with total number of pairs
-     * seen in previous iterations. 
-     * @param value Pairs in this iteration (1), from the map function.
-     * @param sum Count of all pairs in prior iterations.
-     * @return All pairs encountered in previous iterations + all pairs encountered in this iteration (sum + 1).
-     */
-    @Override
-    public Long reduce(Integer value, Long sum) {
-        return value + sum;    
-    }
-
-    /**
-     * Print summary statistics over the entire traversal.
-     * @param sum A count of all read pairs viewed.
-     */
-    @Override
-    public void onTraversalDone(Long sum) {
-        out.printf("Total number of pairs               : %d%n",sum);
-        out.printf("Total number of first reads in pair : %d%n",firstOfPair);
-        out.printf("Total number of second reads in pair: %d%n",secondOfPair);
-        for(int i = 1; i < pairCountsByType.size(); i++) {
-            if(pairCountsByType.get(i) == null)
-                continue;
-            out.printf("Pairs of size %d: %d%n",i,pairCountsByType.get(i));
-        }
-    }
-
-}

From e56d52006a9a31079960bd55dc9249b10892c93b Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 16 Nov 2011 10:39:17 -0500
Subject: [PATCH 037/113] Continuing bugfixes to get new VC working

---
 .../beagle/BeagleOutputToVCFWalker.java       |  4 +-
 .../walkers/variantutils/SelectVariants.java  |  4 +
 .../variantcontext/GenotypeCollection.java    | 78 +++++++++++++++----
 .../utils/variantcontext/VariantContext.java  | 13 +++-
 ...gatingAlternateAllelesIntegrationTest.java | 51 ------------
 5 files changed, 77 insertions(+), 73 deletions(-)
 delete mode 100644 public/java/test/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesIntegrationTest.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index 549c26575..297203aec 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -333,11 +333,11 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
 
         VariantContext filteredVC;
         if ( beagleVarCounts > 0 || DONT_FILTER_MONOMORPHIC_SITES )
-            filteredVC = new VariantContext("outputvcf", VCFConstants.EMPTY_ID_FIELD, vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), vc_input.getAlleles(), genotypes, vc_input.getNegLog10PError(), vc_input.filtersWereApplied() ? vc_input.getFilters() : null, vc_input.getAttributes());
+            filteredVC = new VariantContext("outputvcf", vc_input.getID(), vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), vc_input.getAlleles(), genotypes, vc_input.getNegLog10PError(), vc_input.filtersWereApplied() ? vc_input.getFilters() : null, vc_input.getAttributes());
         else {
             Set<String> removedFilters = vc_input.filtersWereApplied() ? new HashSet<String>(vc_input.getFilters()) : new HashSet<String>(1);
             removedFilters.add(String.format("BGL_RM_WAS_%s",vc_input.getAlternateAllele(0)));
-            filteredVC = new VariantContext("outputvcf", VCFConstants.EMPTY_ID_FIELD, vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), new HashSet<Allele>(Arrays.asList(vc_input.getReference())), genotypes, vc_input.getNegLog10PError(), removedFilters, vc_input.getAttributes());
+            filteredVC = new VariantContext("outputvcf", vc_input.getID(), vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), new HashSet<Allele>(Arrays.asList(vc_input.getReference())), genotypes, vc_input.getNegLog10PError(), removedFilters, vc_input.getAttributes());
         }
 
         HashMap<String, Object> attributes = new HashMap<String, Object>(filteredVC.getAttributes());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index 3c92bf00f..6fec0fac2 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -654,7 +654,10 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
         if ( samples == null || samples.isEmpty() )
             return vc;
 
+//        logger.info("Genotypes in full  vc: " + vc.getGenotypes());
+//        logger.info("My own sub           : " + vc.getGenotypes().subsetToSamples(samples));
         VariantContext sub = vc.subContextFromSamples(samples, vc.getAlleles());
+//        logger.info("Genotypes in sub   vc: " + sub.getGenotypes());
 
         // if we have fewer alternate alleles in the selected VC than in the original VC, we need to strip out the GL/PLs (because they are no longer accurate)
         if ( vc.getAlleles().size() != sub.getAlleles().size() )
@@ -691,6 +694,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
 
         sub = VariantContext.modifyAttributes(sub, attributes);
 
+//        logger.info("Genotypes in final vc: " + sub.getGenotypes());
         return sub;
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
index 6ccb2a9ff..4dbc23e63 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
@@ -30,11 +30,13 @@ import java.util.*;
  *
  */
 public class GenotypeCollection implements List<Genotype> {
-    public final static GenotypeCollection NO_GENOTYPES = new GenotypeCollection();
+    public final static GenotypeCollection NO_GENOTYPES =
+            new GenotypeCollection(new ArrayList<Genotype>(0), new HashMap<String, Integer>(0), new HashSet<String>(0), true);
 
+    Set<String> sampleNamesInOrder = null;
     Map<String, Integer> sampleNameToOffset = null;
     boolean cacheIsInvalid = true;
-    final ArrayList<Genotype> genotypes;
+    List<Genotype> genotypes;
     boolean immutable = false;
 
     // ---------------------------------------------------------------------------
@@ -54,6 +56,19 @@ public class GenotypeCollection implements List<Genotype> {
     private GenotypeCollection(final ArrayList<Genotype> genotypes, final boolean immutable) {
         this.genotypes = genotypes;
         this.immutable = immutable;
+        this.sampleNameToOffset = null;
+        this.cacheIsInvalid = true;
+    }
+
+    private GenotypeCollection(final ArrayList<Genotype> genotypes,
+                               final Map<String, Integer> sampleNameToOffset,
+                               final Set<String> sampleNamesInOrder,
+                               final boolean immutable) {
+        this.genotypes = genotypes;
+        this.immutable = immutable;
+        this.sampleNameToOffset = sampleNameToOffset;
+        this.sampleNamesInOrder = sampleNamesInOrder;
+        this.cacheIsInvalid = false;
     }
 
     // ---------------------------------------------------------------------------
@@ -108,12 +123,8 @@ public class GenotypeCollection implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
-    public final GenotypeCollection mutable() {
-        immutable = false;
-        return this;
-    }
-
     public final GenotypeCollection immutable() {
+        this.genotypes = Collections.unmodifiableList(genotypes);
         immutable = true;
         return this;
     }
@@ -135,17 +146,20 @@ public class GenotypeCollection implements List<Genotype> {
 
     private void invalidateCaches() {
         cacheIsInvalid = true;
-        if ( sampleNameToOffset != null ) sampleNameToOffset.clear();
+        sampleNamesInOrder = null;
+        sampleNameToOffset = null;
     }
 
     private void buildCache() {
         cacheIsInvalid = false;
+        sampleNamesInOrder = new TreeSet<String>();
+        sampleNameToOffset = new HashMap<String, Integer>(genotypes.size());
 
-        if ( sampleNameToOffset == null )
-            sampleNameToOffset = new HashMap<String, Integer>(genotypes.size());
-
-        for ( int i = 0; i < genotypes.size(); i++ )
-            sampleNameToOffset.put(genotypes.get(i).getSampleName(), i);
+        for ( int i = 0; i < genotypes.size(); i++ ) {
+            final Genotype g = genotypes.get(i);
+            sampleNamesInOrder.add(g.getSampleName());
+            sampleNameToOffset.put(g.getSampleName(), i);
+        }
     }
 
 
@@ -341,7 +355,8 @@ public class GenotypeCollection implements List<Genotype> {
     }
 
     public Set<String> getSampleNamesOrderedByName() {
-        return new TreeSet<String>(getSampleNames());
+        buildCache();
+        return sampleNamesInOrder;
     }
 
     public boolean containsSample(final String sample) {
@@ -365,10 +380,41 @@ public class GenotypeCollection implements List<Genotype> {
             return NO_GENOTYPES;
         else {
             GenotypeCollection subset = create(samples.size());
-            for ( final Genotype g : genotypes )
-                if ( samples.contains(g.getSampleName()) )
+            for ( final Genotype g : genotypes ) {
+                if ( samples.contains(g.getSampleName()) ) {
                     subset.add(g);
+                }
+            }
             return subset;
         }
     }
+
+    @Override
+    public String toString() {
+        final List<String> gS = new ArrayList<String>();
+        for ( final Genotype g : this.iterateInSampleNameOrder() )
+            gS.add(g.toString());
+        return "[" + join(",", gS) + "]";
+    }
+
+    // copied from Utils
+    private static <T> String join(final String separator, final Collection<T> objects) {
+        if (objects.isEmpty()) { // fast path for empty collection
+            return "";
+        } else {
+            final Iterator<T> iter = objects.iterator();
+            final T first = iter.next();
+
+            if ( ! iter.hasNext() ) // fast path for singleton collections
+                return first.toString();
+            else { // full path for 2+ collection that actually need a join
+                final StringBuilder ret = new StringBuilder(first.toString());
+                while(iter.hasNext()) {
+                    ret.append(separator);
+                    ret.append(iter.next().toString());
+                }
+                return ret.toString();
+            }
+        }
+    }
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 77dc88cc5..d0f88e2ec 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -411,7 +411,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         // we need to make this a LinkedHashSet in case the user prefers a given ordering of alleles
         this.alleles = makeAlleles(alleles);
 
-        if ( genotypes == null ) {
+        if ( genotypes == null || genotypes == NO_GENOTYPES ) {
             this.genotypes = NO_GENOTYPES;
         } else {
             this.genotypes = genotypes.immutable();
@@ -543,8 +543,10 @@ public class VariantContext implements Feature { // to enable tribble intergrati
 //    }
 
     public VariantContext subContextFromSamples(Set<String> sampleNames, Collection<Allele> alleles) {
+        loadGenotypes();
+        GenotypeCollection newGenotypes = genotypes.subsetToSamples(sampleNames);
         return new VariantContext(getSource(), getID(), contig, start, stop, alleles,
-                genotypes.subsetToSamples(sampleNames),
+                newGenotypes,
                 getNegLog10PError(),
                 filtersWereApplied() ? getFilters() : null,
                 getAttributes(),
@@ -552,6 +554,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     }
 
     public VariantContext subContextFromSamples(Set<String> sampleNames) {
+        loadGenotypes();
         GenotypeCollection newGenotypes = genotypes.subsetToSamples(sampleNames);
         return new VariantContext(getSource(), getID(), contig, start, stop, allelesOfGenotypes(newGenotypes),
                 newGenotypes,
@@ -562,7 +565,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     }
 
     public VariantContext subContextFromSample(String sampleName) {
-        return subContextFromSamples(new HashSet<String>(Arrays.asList(sampleName)));
+        return subContextFromSamples(Collections.singleton(sampleName));
     }
 
     /**
@@ -1460,7 +1463,9 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     public String toString() {
         return String.format("[VC %s @ %s of type=%s alleles=%s attr=%s GT=%s",
                 getSource(), contig + ":" + (start - stop == 0 ? start : start + "-" + stop), this.getType(),
-                ParsingUtils.sortList(this.getAlleles()), ParsingUtils.sortedString(this.getAttributes()), this.getGenotypesSortedByName());
+                ParsingUtils.sortList(this.getAlleles()),
+                ParsingUtils.sortedString(this.getAttributes()),
+                this.getGenotypes());
     }
 
     // protected basic manipulation routines
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesIntegrationTest.java
deleted file mode 100644
index db1e4a82f..000000000
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesIntegrationTest.java
+++ /dev/null
@@ -1,51 +0,0 @@
-package org.broadinstitute.sting.gatk.walkers.phasing;
-
-import org.broadinstitute.sting.WalkerTest;
-import org.testng.annotations.Test;
-
-import java.util.Arrays;
-
-public class MergeSegregatingAlternateAllelesIntegrationTest extends WalkerTest {
-
-    public static String baseTestString(String reference, String VCF, int maxDist) {
-        return "-T MergeSegregatingAlternateAlleles" +
-                " -R " + reference +
-                " --variant:vcf " + validationDataLocation + VCF +
-                " --maxGenomicDistance " + maxDist +
-                " -o %s" +
-                " -NO_HEADER";
-    }
-
-
-    @Test
-    public void test1() {
-        WalkerTestSpec spec = new WalkerTestSpec(
-                baseTestString(hg18Reference, "merging_test_chr20_556259_756570.vcf", 1)
-                        + " -L chr20:556259-756570",
-                1,
-                Arrays.asList("af5e1370822551c0c6f50f23447dc627"));
-        executeTest("Merge sites within genomic distance of 1 [TEST ONE]", spec);
-    }
-
-    @Test
-    public void test2() {
-        WalkerTestSpec spec = new WalkerTestSpec(
-                baseTestString(hg18Reference, "merging_test_chr20_556259_756570.vcf", 10)
-                        + " -L chr20:556259-756570",
-                1,
-                Arrays.asList("dd8c44ae1ef059a7fe85399467e102eb"));
-        executeTest("Merge sites within genomic distance of 10 [TEST TWO]", spec);
-    }
-
-    @Test
-    public void test3() {
-        WalkerTestSpec spec = new WalkerTestSpec(
-                baseTestString(hg18Reference, "merging_test_chr20_556259_756570.vcf", 100)
-                        + " -L chr20:556259-756570",
-                1,
-                Arrays.asList("f81fd72ecaa57b3215406fcea860bcc5"));
-        executeTest("Merge sites within genomic distance of 100 [TEST THREE]", spec);
-    }
-
-
-}
\ No newline at end of file

From 101ffc4dfd5ce83f7d6bf0b5de4a99ebfac447de Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 16 Nov 2011 13:35:16 -0500
Subject: [PATCH 039/113] Expanded, contrastive VariantContextBenchmark

-- Compares performance across a bunch of common operations with GATK 1.3 version of VariantContext and GATK 1.4
-- 1.3 VC and associated utilities copied wholesale into test directory under v13
---
 .../VariantContextBenchmark.java              |  303 +++-
 .../variantcontext/v13/AbstractVCFCodec.java  |  635 +++++++
 .../utils/variantcontext/v13/Allele.java      |  456 +++++
 .../utils/variantcontext/v13/Genotype.java    |  349 ++++
 .../v13/GenotypeLikelihoods.java              |  196 ++
 .../variantcontext/v13/IndexingVCFWriter.java |  143 ++
 .../v13/InferredGeneticContext.java           |  243 +++
 .../variantcontext/v13/MutableGenotype.java   |   68 +
 .../v13/MutableVariantContext.java            |  213 +++
 .../utils/variantcontext/v13/VCF3Codec.java   |  198 ++
 .../variantcontext/v13/VCFAltHeaderLine.java  |   28 +
 .../utils/variantcontext/v13/VCFCodec.java    |  228 +++
 .../v13/VCFCompoundHeaderLine.java            |  224 +++
 .../variantcontext/v13/VCFConstants.java      |  112 ++
 .../v13/VCFFilterHeaderLine.java              |   28 +
 .../v13/VCFFormatHeaderLine.java              |   32 +
 .../utils/variantcontext/v13/VCFHeader.java   |  198 ++
 .../variantcontext/v13/VCFHeaderLine.java     |  134 ++
 .../v13/VCFHeaderLineCount.java               |    8 +
 .../v13/VCFHeaderLineTranslator.java          |  124 ++
 .../variantcontext/v13/VCFHeaderLineType.java |    8 +
 .../variantcontext/v13/VCFHeaderVersion.java  |   91 +
 .../variantcontext/v13/VCFInfoHeaderLine.java |   29 +
 .../v13/VCFNamedHeaderLine.java               |   30 +
 .../utils/variantcontext/v13/VCFParser.java   |   22 +
 .../v13/VCFSimpleHeaderLine.java              |   81 +
 .../utils/variantcontext/v13/VCFUtils.java    |  227 +++
 .../utils/variantcontext/v13/VCFWriter.java   |   16 +
 .../variantcontext/v13/VariantContext.java    | 1615 +++++++++++++++++
 .../v13/VariantContextUtils.java              | 1407 ++++++++++++++
 .../v13/VariantJEXLContext.java               |  315 ++++
 31 files changed, 7727 insertions(+), 34 deletions(-)
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/AbstractVCFCodec.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Allele.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Genotype.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/GenotypeLikelihoods.java
 create mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/IndexingVCFWriter.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/InferredGeneticContext.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableGenotype.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableVariantContext.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCF3Codec.java
 create mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFAltHeaderLine.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCodec.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCompoundHeaderLine.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFConstants.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFilterHeaderLine.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFormatHeaderLine.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeader.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLine.java
 create mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineCount.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineTranslator.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineType.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderVersion.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFInfoHeaderLine.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFNamedHeaderLine.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFParser.java
 create mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFSimpleHeaderLine.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFUtils.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFWriter.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContext.java
 create mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContextUtils.java
 create mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantJEXLContext.java

diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
index 06ce61627..e16176dff 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -27,8 +27,14 @@ package org.broadinstitute.sting.utils.variantcontext;
 import com.google.caliper.Param;
 import com.google.caliper.SimpleBenchmark;
 import com.google.caliper.runner.CaliperMain;
+import net.sf.picard.reference.ReferenceSequenceFile;
+import org.broad.tribble.Feature;
+import org.broad.tribble.FeatureCodec;
 import org.broad.tribble.readers.AsciiLineReader;
+import org.broadinstitute.sting.BaseTest;
+import org.broadinstitute.sting.utils.GenomeLocParser;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFCodec;
+import org.broadinstitute.sting.utils.fasta.CachingIndexedFastaSequenceFile;
 
 import java.io.*;
 import java.util.*;
@@ -46,24 +52,39 @@ public class VariantContextBenchmark extends SimpleBenchmark {
     @Param({"100"})
     int nSamplesToTake; // set automatically by framework
 
-    @Param({"READ", "READ_SUBSET"})
-    Operation operation; // set automatically by framework
+    @Param({"10"})
+    int dupsToMerge; // set automatically by framework
 
-    @Param({"OF_SAMPLES"})
-    SubContextOp subContextOp; // set automatically by framework
+    @Param
+    Operation operation; // set automatically by framework
 
     private String INPUT_STRING;
 
     public enum Operation {
         READ,
-        READ_SUBSET
+        SUBSET_TO_SAMPLES,
+        GET_TYPE,
+        GET_ID,
+        GET_GENOTYPES,
+        GET_ATTRIBUTE_STRING,
+        GET_ATTRIBUTE_INT,
+        GET_N_SAMPLES,
+        GET_GENOTYPES_FOR_SAMPLES,
+        GET_GENOTYPES_IN_ORDER_OF_NAME,
+        CALC_GENOTYPE_COUNTS,
+        MERGE
     }
 
-    public enum SubContextOp {
-        OF_SAMPLES
-    }
+    private GenomeLocParser b37GenomeLocParser;
 
     @Override protected void setUp() {
+        try {
+            ReferenceSequenceFile seq = new CachingIndexedFastaSequenceFile(new File(BaseTest.b37KGReference));
+            b37GenomeLocParser = new GenomeLocParser(seq);
+        } catch ( FileNotFoundException e) {
+            throw new RuntimeException(e);
+        }
+
         // read it into a String so that we don't try to benchmark IO issues
         try {
             FileInputStream s = new FileInputStream(new File(vcfFile));
@@ -83,52 +104,266 @@ public class VariantContextBenchmark extends SimpleBenchmark {
         }
     }
 
-    private void parseGenotypes(VCFCodec codec, Operation op, SubContextOp subop ) {
+    private interface FunctionToBenchmark<T extends Feature> {
+        public void run(T vc);
+    }
+
+    private <T extends Feature> void runBenchmark(FeatureCodec<T> codec, FunctionToBenchmark<T> func) {
         try {
             InputStream is = new ByteArrayInputStream(INPUT_STRING.getBytes());
             AsciiLineReader lineReader = new AsciiLineReader(is);
             codec.readHeader(lineReader);
 
             int counter = 0;
-            Set<String> samples = null;
             while (counter++ < linesToRead ) {
                 String line = lineReader.readLine();
                 if ( line == null )
                     break;
 
-                VariantContext vc = (VariantContext)codec.decode(line);
-                if ( samples == null ) {
-                    samples = new HashSet<String>(new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake));
-                }
-
-                if ( op == Operation.READ_SUBSET)
-                    processOneVC(vc, samples, subop);
+                T vc = codec.decode(line);
+                func.run(vc);
             }
         } catch (Exception e) {
             System.out.println("Benchmarking run failure because of " + e.getMessage());
         }
     }
 
-    public void timeMe(int rep) {
-        for ( int i = 0; i < rep; i++ )
-            parseGenotypes(new VCFCodec(), operation, subContextOp);
+    public void timeV14(int rep) {
+        for ( int i = 0; i < rep; i++ ) {
+            FunctionToBenchmark<VariantContext> func = getV14FunctionToBenchmark();
+            FeatureCodec<VariantContext> codec = new VCFCodec();
+            runBenchmark(codec, func);
+        }
+    }
+
+    public FunctionToBenchmark<VariantContext> getV14FunctionToBenchmark() {
+        switch ( operation ) {
+            case READ:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        ; // empty operation
+                    }
+                };
+            case SUBSET_TO_SAMPLES:
+                return new FunctionToBenchmark<VariantContext>() {
+                    Set<String> samples;
+                    public void run(final VariantContext vc) {
+                        if ( samples == null )
+                            samples = new HashSet<String>(new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake));
+                        VariantContext sub = vc.subContextFromSamples(samples);
+                        sub.getNSamples();
+                    }
+                };
+            case GET_TYPE:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        vc.getType();
+                    }
+                };
+            case GET_ID:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        vc.getID();
+                    }
+                };
+            case GET_GENOTYPES:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        vc.getGenotypes().size();
+                    }
+                };
+
+            case GET_GENOTYPES_FOR_SAMPLES:
+                return new FunctionToBenchmark<VariantContext>() {
+                    Set<String> samples;
+                    public void run(final VariantContext vc) {
+                        if ( samples == null )
+                            samples = new HashSet<String>(new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake));
+                        vc.getGenotypes(samples).size();
+                    }
+                };
+
+            case GET_ATTRIBUTE_STRING:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        vc.getAttribute("AN", null);
+                    }
+                };
+
+            case GET_ATTRIBUTE_INT:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        vc.getAttributeAsInt("AC", 0);
+                    }
+                };
+
+            case GET_N_SAMPLES:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        vc.getNSamples();
+                    }
+                };
+
+            case GET_GENOTYPES_IN_ORDER_OF_NAME:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        ; // TODO - TEST IS BROKEN
+//                        int n = 0;
+//                        for ( final Genotype g: vc.getGenotypesSortedByName() ) n++;
+                    }
+                };
+
+            case CALC_GENOTYPE_COUNTS:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        vc.getHetCount();
+                    }
+                };
+
+            case MERGE:
+                return new FunctionToBenchmark<VariantContext>() {
+                    public void run(final VariantContext vc) {
+                        List<VariantContext> toMerge = new ArrayList<VariantContext>();
+
+                        for ( int i = 0; i < dupsToMerge; i++ ) {
+                            GenotypeCollection gc = GenotypeCollection.create(vc.getNSamples());
+                            for ( final Genotype g : vc.getGenotypes() ) {
+                                gc.add(new Genotype(g.getSampleName()+"_"+i, g));
+                            }
+                            toMerge.add(VariantContext.modifyGenotypes(vc, gc));
+                        }
+
+                        VariantContextUtils.simpleMerge(b37GenomeLocParser, toMerge, null,
+                                VariantContextUtils.FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED,
+                                VariantContextUtils.GenotypeMergeType.UNSORTED,
+                                true, false, "set", false, true);
+                    }
+                };
+
+            default: throw new IllegalArgumentException("Unexpected operation " + operation);
+        }
+    }
+
+    public void timeV13(int rep) {
+        for ( int i = 0; i < rep; i++ ) {
+            FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> func = getV13FunctionToBenchmark();
+            FeatureCodec<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> codec = new org.broadinstitute.sting.utils.variantcontext.v13.VCFCodec();
+            runBenchmark(codec, func);
+        }
+    }
+
+    public FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> getV13FunctionToBenchmark() {
+        switch ( operation ) {
+            case READ:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        ; // empty operation
+                    }
+                };
+            case SUBSET_TO_SAMPLES:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    List<String> samples;
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        if ( samples == null )
+                            samples = new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake);
+                        org.broadinstitute.sting.utils.variantcontext.v13.VariantContext sub = vc.subContextFromGenotypes(vc.getGenotypes(samples).values());
+                        sub.getNSamples();
+                    }
+                };
+
+            case GET_TYPE:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        vc.getType();
+                    }
+                };
+            case GET_ID:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        vc.getID();
+                    }
+                };
+            case GET_GENOTYPES:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        vc.getGenotypes().size();
+                    }
+                };
+
+            case GET_GENOTYPES_FOR_SAMPLES:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    Set<String> samples;
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        if ( samples == null )
+                            samples = new HashSet<String>(new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake));
+                        vc.getGenotypes(samples).size();
+                    }
+                };
+
+            case GET_ATTRIBUTE_STRING:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        vc.getAttribute("AN", null);
+                    }
+                };
+
+            case GET_ATTRIBUTE_INT:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        vc.getAttributeAsInt("AC", 0);
+                    }
+                };
+
+            case GET_N_SAMPLES:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        vc.getNSamples();
+                    }
+                };
+
+            case GET_GENOTYPES_IN_ORDER_OF_NAME:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        ; // TODO - TEST IS BROKEN
+                        //vc.getGenotypesSortedByName();
+                    }
+                };
+
+            case CALC_GENOTYPE_COUNTS:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        vc.getHetCount();
+                    }
+                };
+
+            case MERGE:
+                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+                        List<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> toMerge = new ArrayList<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>();
+
+                        for ( int i = 0; i < dupsToMerge; i++ ) {
+                            Map<String, org.broadinstitute.sting.utils.variantcontext.v13.Genotype> gc = new HashMap<String, org.broadinstitute.sting.utils.variantcontext.v13.Genotype>();
+                            for ( final org.broadinstitute.sting.utils.variantcontext.v13.Genotype g : vc.getGenotypes().values() ) {
+                                String name = g.getSampleName()+"_"+i;
+                                gc.put(name, new org.broadinstitute.sting.utils.variantcontext.v13.Genotype(name,
+                                        g.getAlleles(), g.getNegLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased(), g.getLikelihoods().getAsVector()));
+                                toMerge.add(org.broadinstitute.sting.utils.variantcontext.v13.VariantContext.modifyGenotypes(vc, gc));
+                            }
+                        }
+
+                        org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.simpleMerge(b37GenomeLocParser,
+                                toMerge, null,
+                                org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED,
+                                org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.GenotypeMergeType.UNSORTED,
+                                true, false, "set", false, true);
+                    }
+                };
+
+            default: throw new IllegalArgumentException("Unexpected operation " + operation);
+        }
     }
 
     public static void main(String[] args) {
         CaliperMain.main(VariantContextBenchmark.class, args);
     }
-
-    private static final void processOneVC(VariantContext vc, Set<String> samples, SubContextOp subop) {
-        VariantContext sub;
-
-        switch ( subop ) {
-            case OF_SAMPLES:
-                sub = vc.subContextFromSamples(samples, vc.getAlleles());
-                break;
-            default:
-                throw new RuntimeException("Unexpected op: " + subop);
-        }
-
-        sub.getNSamples();
-    }
 }
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/AbstractVCFCodec.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/AbstractVCFCodec.java
new file mode 100755
index 000000000..5310313e0
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/AbstractVCFCodec.java
@@ -0,0 +1,635 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.apache.log4j.Logger;
+import org.broad.tribble.Feature;
+import org.broad.tribble.FeatureCodec;
+import org.broad.tribble.NameAwareCodec;
+import org.broad.tribble.TribbleException;
+import org.broad.tribble.readers.LineReader;
+import org.broad.tribble.util.BlockCompressedInputStream;
+import org.broad.tribble.util.ParsingUtils;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+import org.broadinstitute.sting.utils.exceptions.UserException;
+
+import java.io.*;
+import java.util.*;
+import java.util.zip.GZIPInputStream;
+
+
+abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec, VCFParser {
+
+    protected final static Logger log = Logger.getLogger(VCFCodec.class);
+    protected final static int NUM_STANDARD_FIELDS = 8;  // INFO is the 8th column
+
+    protected VCFHeaderVersion version;
+
+    // we have to store the list of strings that make up the header until they're needed
+    protected VCFHeader header = null;
+
+    // a mapping of the allele
+    protected Map<String, List<Allele>> alleleMap = new HashMap<String, List<Allele>>(3);
+
+    // for ParsingUtils.split
+    protected String[] GTValueArray = new String[100];
+    protected String[] genotypeKeyArray = new String[100];
+    protected String[] infoFieldArray = new String[1000];
+    protected String[] infoValueArray = new String[1000];
+
+    // for performance testing purposes
+    public static boolean validate = true;
+
+    // a key optimization -- we need a per thread string parts array, so we don't allocate a big array over and over
+    // todo: make this thread safe?
+    protected String[] parts = null;
+    protected String[] genotypeParts = null;
+
+    // for performance we cache the hashmap of filter encodings for quick lookup
+    protected HashMap<String,LinkedHashSet<String>> filterHash = new HashMap<String,LinkedHashSet<String>>();
+
+    // a mapping of the VCF fields to their type, filter fields, and format fields, for quick lookup to validate against
+    TreeMap<String, VCFHeaderLineType> infoFields = new TreeMap<String, VCFHeaderLineType>();
+    TreeMap<String, VCFHeaderLineType> formatFields = new TreeMap<String, VCFHeaderLineType>();
+    Set<String> filterFields = new HashSet<String>();
+
+    // we store a name to give to each of the variant contexts we emit
+    protected String name = "Unknown";
+
+    protected int lineNo = 0;
+
+    protected Map<String, String> stringCache = new HashMap<String, String>();
+
+
+    /**
+     * @param reader the line reader to take header lines from
+     * @return the number of header lines
+     */
+    public abstract Object readHeader(LineReader reader);
+
+    /**
+     * create a genotype map
+     * @param str the string
+     * @param alleles the list of alleles
+     * @param chr chrom
+     * @param pos position
+     * @return a mapping of sample name to genotype object
+     */
+    public abstract Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+
+
+    /**
+     * parse the filter string, first checking to see if we already have parsed it in a previous attempt
+     * @param filterString the string to parse
+     * @return a set of the filters applied
+     */
+    protected abstract Set<String> parseFilters(String filterString);
+
+    /**
+     * create a VCF header
+     * @param headerStrings a list of strings that represent all the ## entries
+     * @param line the single # line (column names)
+     * @return the count of header lines
+     */
+    protected Object createHeader(List<String> headerStrings, String line) {
+
+        headerStrings.add(line);
+
+        Set<VCFHeaderLine> metaData = new TreeSet<VCFHeaderLine>();
+        Set<String> auxTags = new LinkedHashSet<String>();
+        // iterate over all the passed in strings
+        for ( String str : headerStrings ) {
+            if ( !str.startsWith(VCFHeader.METADATA_INDICATOR) ) {
+                String[] strings = str.substring(1).split(VCFConstants.FIELD_SEPARATOR);
+                if ( strings.length < VCFHeader.HEADER_FIELDS.values().length )
+                    throw new TribbleException.InvalidHeader("there are not enough columns present in the header line: " + str);
+
+                int arrayIndex = 0;
+                for (VCFHeader.HEADER_FIELDS field : VCFHeader.HEADER_FIELDS.values()) {
+                    try {
+                        if (field != VCFHeader.HEADER_FIELDS.valueOf(strings[arrayIndex]))
+                            throw new TribbleException.InvalidHeader("we were expecting column name '" + field + "' but we saw '" + strings[arrayIndex] + "'");
+                    } catch (IllegalArgumentException e) {
+                        throw new TribbleException.InvalidHeader("unknown column name '" + strings[arrayIndex] + "'; it does not match a legal column header name.");
+                    }
+                    arrayIndex++;
+                }
+
+                boolean sawFormatTag = false;
+                if ( arrayIndex < strings.length ) {
+                    if ( !strings[arrayIndex].equals("FORMAT") )
+                        throw new TribbleException.InvalidHeader("we were expecting column name 'FORMAT' but we saw '" + strings[arrayIndex] + "'");
+                    sawFormatTag = true;
+                    arrayIndex++;
+                }
+
+                while ( arrayIndex < strings.length )
+                    auxTags.add(strings[arrayIndex++]);
+
+                if ( sawFormatTag && auxTags.size() == 0 )
+                    throw new UserException.MalformedVCFHeader("The FORMAT field was provided but there is no genotype/sample data");
+
+            } else {
+                if ( str.startsWith("##INFO=") ) {
+                    VCFInfoHeaderLine info = new VCFInfoHeaderLine(str.substring(7),version);
+                    metaData.add(info);
+                    infoFields.put(info.getName(), info.getType());
+                } else if ( str.startsWith("##FILTER=") ) {
+                    VCFFilterHeaderLine filter = new VCFFilterHeaderLine(str.substring(9),version);
+                    metaData.add(filter);
+                    filterFields.add(filter.getName());
+                } else if ( str.startsWith("##FORMAT=") ) {
+                    VCFFormatHeaderLine format = new VCFFormatHeaderLine(str.substring(9),version);
+                    metaData.add(format);
+                    formatFields.put(format.getName(), format.getType());
+                } else {
+                    int equals = str.indexOf("=");
+                    if ( equals != -1 )
+                        metaData.add(new VCFHeaderLine(str.substring(2, equals), str.substring(equals+1)));
+                }
+            }
+        }
+
+        header = new VCFHeader(metaData, auxTags);
+        return header;
+    }
+
+    /**
+     * the fast decode function
+     * @param line the line of text for the record
+     * @return a feature, (not guaranteed complete) that has the correct start and stop
+     */
+    public Feature decodeLoc(String line) {
+        lineNo++;
+
+        // the same line reader is not used for parsing the header and parsing lines, if we see a #, we've seen a header line
+        if (line.startsWith(VCFHeader.HEADER_INDICATOR)) return null;
+
+        // our header cannot be null, we need the genotype sample names and counts
+        if (header == null) throw new ReviewedStingException("VCF Header cannot be null when decoding a record");
+
+        final String[] locParts = new String[6];
+        int nParts = ParsingUtils.split(line, locParts, VCFConstants.FIELD_SEPARATOR_CHAR, true);
+
+        if ( nParts != 6 )
+            throw new UserException.MalformedVCF("there aren't enough columns for line " + line, lineNo);
+
+        // get our alleles (because the end position depends on them)
+        final String ref = getCachedString(locParts[3].toUpperCase());
+        final String alts = getCachedString(locParts[4].toUpperCase());
+        final List<Allele> alleles = parseAlleles(ref, alts, lineNo);
+
+        // find out our location
+        final int start = Integer.valueOf(locParts[1]);
+        int stop = start;
+
+        // ref alleles don't need to be single bases for monomorphic sites
+        if ( alleles.size() == 1 ) {
+            stop = start + alleles.get(0).length() - 1;
+        } else if ( !isSingleNucleotideEvent(alleles) ) {
+            stop = clipAlleles(start, ref, alleles, null, lineNo);
+        }
+
+        return new VCFLocFeature(locParts[0], start, stop);
+    }
+
+    private final static class VCFLocFeature implements Feature {
+
+        final String chr;
+        final int start, stop;
+
+        private VCFLocFeature(String chr, int start, int stop) {
+            this.chr = chr;
+            this.start = start;
+            this.stop = stop;
+        }
+
+        public String getChr() { return chr; }
+        public int getStart() { return start; }
+        public int getEnd() { return stop; }
+    }
+
+
+    /**
+     * decode the line into a feature (VariantContext)
+     * @param line the line
+     * @return a VariantContext
+     */
+    public Feature decode(String line) {
+        // the same line reader is not used for parsing the header and parsing lines, if we see a #, we've seen a header line
+        if (line.startsWith(VCFHeader.HEADER_INDICATOR)) return null;
+
+        // our header cannot be null, we need the genotype sample names and counts
+        if (header == null) throw new ReviewedStingException("VCF Header cannot be null when decoding a record");
+
+        if (parts == null)
+            parts = new String[Math.min(header.getColumnCount(), NUM_STANDARD_FIELDS+1)];
+
+        int nParts = ParsingUtils.split(line, parts, VCFConstants.FIELD_SEPARATOR_CHAR, true);
+
+        // if we have don't have a header, or we have a header with no genotyping data check that we have eight columns.  Otherwise check that we have nine (normal colummns + genotyping data)
+        if (( (header == null || !header.hasGenotypingData()) && nParts != NUM_STANDARD_FIELDS) ||
+             (header != null && header.hasGenotypingData() && nParts != (NUM_STANDARD_FIELDS + 1)) )
+            throw new UserException.MalformedVCF("there aren't enough columns for line " + line + " (we expected " + (header == null ? NUM_STANDARD_FIELDS : NUM_STANDARD_FIELDS + 1) +
+                    " tokens, and saw " + nParts + " )", lineNo);
+
+        return parseVCFLine(parts);
+    }
+
+    protected void generateException(String message) {
+        throw new UserException.MalformedVCF(message, lineNo);
+    }
+
+    protected static void generateException(String message, int lineNo) {
+        throw new UserException.MalformedVCF(message, lineNo);
+    }
+
+    /**
+     * parse out the VCF line
+     *
+     * @param parts the parts split up
+     * @return a variant context object
+     */
+    private VariantContext parseVCFLine(String[] parts) {
+        // increment the line count
+        lineNo++;
+
+        // parse out the required fields
+        String contig = getCachedString(parts[0]);
+        int pos = Integer.valueOf(parts[1]);
+        String id = null;
+        if ( parts[2].length() == 0 )
+            generateException("The VCF specification requires a valid ID field");
+        else if ( parts[2].equals(VCFConstants.EMPTY_ID_FIELD) )
+            id = VCFConstants.EMPTY_ID_FIELD;
+        else
+            id = new String(parts[2]);
+        String ref = getCachedString(parts[3].toUpperCase());
+        String alts = getCachedString(parts[4].toUpperCase());
+        Double qual = parseQual(parts[5]);
+        String filter = getCachedString(parts[6]);
+        String info = new String(parts[7]);
+
+        // get our alleles, filters, and setup an attribute map
+        List<Allele> alleles = parseAlleles(ref, alts, lineNo);
+        Set<String> filters = parseFilters(filter);
+        Map<String, Object> attributes = parseInfo(info, id);
+
+        // find out our current location, and clip the alleles down to their minimum length
+        int loc = pos;
+        // ref alleles don't need to be single bases for monomorphic sites
+        if ( alleles.size() == 1 ) {
+            loc = pos + alleles.get(0).length() - 1;
+        } else if ( !isSingleNucleotideEvent(alleles) ) {
+            ArrayList<Allele> newAlleles = new ArrayList<Allele>();
+            loc = clipAlleles(pos, ref, alleles, newAlleles, lineNo);
+            alleles = newAlleles;
+        }
+
+        // do we have genotyping data
+        if (parts.length > NUM_STANDARD_FIELDS) {
+            attributes.put(VariantContext.UNPARSED_GENOTYPE_MAP_KEY, new String(parts[8]));
+            attributes.put(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY, this);
+        }
+
+        VariantContext vc = null;
+        try {
+            vc =  new VariantContext(name, contig, pos, loc, alleles, qual, filters, attributes, ref.getBytes()[0]);
+        } catch (Exception e) {
+            generateException(e.getMessage());
+        }
+
+        // did we resort the sample names?  If so, we need to load the genotype data
+        if ( !header.samplesWereAlreadySorted() )
+            vc.getGenotypes();
+
+        return vc;
+    }
+
+    /**
+     *
+     * @return the type of record
+     */
+    public Class<VariantContext> getFeatureType() {
+        return VariantContext.class;
+    }
+
+    /**
+     * get the name of this codec
+     * @return our set name
+     */
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * set the name of this codec
+     * @param name new name
+     */
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    /**
+     * Return a cached copy of the supplied string.
+     *
+     * @param str string
+     * @return interned string
+     */
+    protected String getCachedString(String str) {
+        String internedString = stringCache.get(str);
+        if ( internedString == null ) {
+            internedString = new String(str);
+            stringCache.put(internedString, internedString);
+        }
+        return internedString;
+    }
+
+    /**
+     * parse out the info fields
+     * @param infoField the fields
+     * @param id the indentifier
+     * @return a mapping of keys to objects
+     */
+    private Map<String, Object> parseInfo(String infoField, String id) {
+        Map<String, Object> attributes = new HashMap<String, Object>();
+
+        if ( infoField.length() == 0 )
+            generateException("The VCF specification requires a valid info field");
+
+        if ( !infoField.equals(VCFConstants.EMPTY_INFO_FIELD) ) {
+            if ( infoField.indexOf("\t") != -1 || infoField.indexOf(" ") != -1 )
+                generateException("The VCF specification does not allow for whitespace in the INFO field");
+
+            int infoFieldSplitSize = ParsingUtils.split(infoField, infoFieldArray, VCFConstants.INFO_FIELD_SEPARATOR_CHAR, false);
+            for (int i = 0; i < infoFieldSplitSize; i++) {
+                String key;
+                Object value;
+
+                int eqI = infoFieldArray[i].indexOf("=");
+                if ( eqI != -1 ) {
+                    key = infoFieldArray[i].substring(0, eqI);
+                    String str = infoFieldArray[i].substring(eqI+1);
+
+                    // split on the INFO field separator
+                    int infoValueSplitSize = ParsingUtils.split(str, infoValueArray, VCFConstants.INFO_FIELD_ARRAY_SEPARATOR_CHAR, false);
+                    if ( infoValueSplitSize == 1 ) {
+                        value = infoValueArray[0];
+                    } else {
+                        ArrayList<String> valueList = new ArrayList<String>(infoValueSplitSize);
+                        for ( int j = 0; j < infoValueSplitSize; j++ )
+                            valueList.add(infoValueArray[j]);
+                        value = valueList;
+                    }
+                } else {
+                    key = infoFieldArray[i];
+                    value = true;
+                }
+
+                attributes.put(key, value);
+            }
+        }
+
+        if ( ! id.equals(VCFConstants.EMPTY_ID_FIELD) )
+            attributes.put(VariantContext.ID_KEY, id);
+        return attributes;
+    }
+
+    /**
+     * create a an allele from an index and an array of alleles
+     * @param index the index
+     * @param alleles the alleles
+     * @return an Allele
+     */
+    protected static Allele oneAllele(String index, List<Allele> alleles) {
+        if ( index.equals(VCFConstants.EMPTY_ALLELE) )
+            return Allele.NO_CALL;
+        int i = Integer.valueOf(index);
+        if ( i >= alleles.size() )
+            throw new TribbleException.InternalCodecException("The allele with index " + index + " is not defined in the REF/ALT columns in the record");
+        return alleles.get(i);
+    }
+
+
+    /**
+     * parse genotype alleles from the genotype string
+     * @param GT         GT string
+     * @param alleles    list of possible alleles
+     * @param cache      cache of alleles for GT
+     * @return the allele list for the GT string
+     */
+    protected static List<Allele> parseGenotypeAlleles(String GT, List<Allele> alleles, Map<String, List<Allele>> cache) {
+        // cache results [since they are immutable] and return a single object for each genotype
+        List<Allele> GTAlleles = cache.get(GT);
+
+        if ( GTAlleles == null ) {
+            StringTokenizer st = new StringTokenizer(GT, VCFConstants.PHASING_TOKENS);
+            GTAlleles = new ArrayList<Allele>(st.countTokens());
+            while ( st.hasMoreTokens() ) {
+                String genotype = st.nextToken();
+                GTAlleles.add(oneAllele(genotype, alleles));
+            }
+            cache.put(GT, GTAlleles);
+        }
+
+        return GTAlleles;
+    }
+
+    /**
+     * parse out the qual value
+     * @param qualString the quality string
+     * @return return a double
+     */
+    protected static Double parseQual(String qualString) {
+        // if we're the VCF 4 missing char, return immediately
+        if ( qualString.equals(VCFConstants.MISSING_VALUE_v4))
+            return VariantContext.NO_NEG_LOG_10PERROR;
+
+        Double val = Double.valueOf(qualString);
+
+        // check to see if they encoded the missing qual score in VCF 3 style, with either the -1 or -1.0.  check for val < 0 to save some CPU cycles
+        if ((val < 0) && (Math.abs(val - VCFConstants.MISSING_QUALITY_v3_DOUBLE) < VCFConstants.VCF_ENCODING_EPSILON))
+            return VariantContext.NO_NEG_LOG_10PERROR;
+
+        // scale and return the value
+        return val / 10.0;
+    }
+
+    /**
+     * parse out the alleles
+     * @param ref the reference base
+     * @param alts a string of alternates to break into alleles
+     * @param lineNo  the line number for this record
+     * @return a list of alleles, and a pair of the shortest and longest sequence
+     */
+    protected static List<Allele> parseAlleles(String ref, String alts, int lineNo) {
+        List<Allele> alleles = new ArrayList<Allele>(2); // we are almost always biallelic
+        // ref
+        checkAllele(ref, true, lineNo);
+        Allele refAllele = Allele.create(ref, true);
+        alleles.add(refAllele);
+
+        if ( alts.indexOf(",") == -1 ) // only 1 alternatives, don't call string split
+            parseSingleAltAllele(alleles, alts, lineNo);
+        else
+            for ( String alt : alts.split(",") )
+                parseSingleAltAllele(alleles, alt, lineNo);
+
+        return alleles;
+    }
+
+    /**
+     * check to make sure the allele is an acceptable allele
+     * @param allele the allele to check
+     * @param isRef are we the reference allele?
+     * @param lineNo  the line number for this record
+     */
+    private static void checkAllele(String allele, boolean isRef, int lineNo) {
+	if ( allele == null || allele.length() == 0 )
+	    generateException("Empty alleles are not permitted in VCF records", lineNo);
+
+        if ( isSymbolicAllele(allele) ) {
+            if ( isRef ) {
+                generateException("Symbolic alleles not allowed as reference allele: " + allele, lineNo);
+            }
+        } else {
+            // check for VCF3 insertions or deletions
+            if ( (allele.charAt(0) == VCFConstants.DELETION_ALLELE_v3) || (allele.charAt(0) == VCFConstants.INSERTION_ALLELE_v3) )
+                generateException("Insertions/Deletions are not supported when reading 3.x VCF's. Please" +
+                        " convert your file to VCF4 using VCFTools, available at http://vcftools.sourceforge.net/index.html", lineNo);
+
+            if (!Allele.acceptableAlleleBases(allele))
+                generateException("Unparsable vcf record with allele " + allele, lineNo);
+
+            if ( isRef && allele.equals(VCFConstants.EMPTY_ALLELE) )
+                generateException("The reference allele cannot be missing", lineNo);
+        }
+    }
+
+    /**
+     * return true if this is a symbolic allele (e.g. <SOMETAG>) otherwise false
+     * @param allele the allele to check
+     * @return true if the allele is a symbolic allele, otherwise false
+     */
+    private static boolean isSymbolicAllele(String allele) {
+        return (allele != null && allele.startsWith("<") && allele.endsWith(">") && allele.length() > 2);
+    }
+
+    /**
+     * parse a single allele, given the allele list
+     * @param alleles the alleles available
+     * @param alt the allele to parse
+     * @param lineNo  the line number for this record
+     */
+    private static void parseSingleAltAllele(List<Allele> alleles, String alt, int lineNo) {
+        checkAllele(alt, false, lineNo);
+
+        Allele allele = Allele.create(alt, false);
+        if ( ! allele.isNoCall() )
+            alleles.add(allele);
+    }
+
+    protected static boolean isSingleNucleotideEvent(List<Allele> alleles) {
+        for ( Allele a : alleles ) {
+            if ( a.length() != 1 )
+                return false;
+        }
+        return true;
+    }
+
+    public static int computeForwardClipping(List<Allele> unclippedAlleles, String ref) {
+        boolean clipping = true;
+
+        for ( Allele a : unclippedAlleles ) {
+            if ( a.isSymbolic() )
+                continue;
+
+            if ( a.length() < 1 || (a.getBases()[0] != ref.getBytes()[0]) ) {
+                clipping = false;
+                break;
+            }
+        }
+
+        return (clipping) ? 1 : 0;
+    }
+
+    protected static int computeReverseClipping(List<Allele> unclippedAlleles, String ref, int forwardClipping, int lineNo) {
+        int clipping = 0;
+        boolean stillClipping = true;
+
+        while ( stillClipping ) {
+            for ( Allele a : unclippedAlleles ) {
+                if ( a.isSymbolic() )
+                    continue;
+
+                if ( a.length() - clipping <= forwardClipping || a.length() - forwardClipping == 0 )
+                    stillClipping = false;
+                else if ( ref.length() == clipping )
+                    generateException("bad alleles encountered", lineNo);
+                else if ( a.getBases()[a.length()-clipping-1] != ref.getBytes()[ref.length()-clipping-1] )
+                    stillClipping = false;
+            }
+            if ( stillClipping )
+                clipping++;
+        }
+
+        return clipping;
+    }
+    /**
+     * clip the alleles, based on the reference
+     *
+     * @param position the unadjusted start position (pre-clipping)
+     * @param ref the reference string
+     * @param unclippedAlleles the list of unclipped alleles
+     * @param clippedAlleles output list of clipped alleles
+     * @param lineNo the current line number in the file
+     * @return the new reference end position of this event
+     */
+    protected static int clipAlleles(int position, String ref, List<Allele> unclippedAlleles, List<Allele> clippedAlleles, int lineNo) {
+
+        int forwardClipping = computeForwardClipping(unclippedAlleles, ref);
+        int reverseClipping = computeReverseClipping(unclippedAlleles, ref, forwardClipping, lineNo);
+
+        if ( clippedAlleles != null ) {
+            for ( Allele a : unclippedAlleles ) {
+                if ( a.isSymbolic() ) {
+                    clippedAlleles.add(a);
+                } else {
+                    clippedAlleles.add(Allele.create(Arrays.copyOfRange(a.getBases(), forwardClipping, a.getBases().length-reverseClipping), a.isReference()));
+                }
+            }
+        }
+
+        // the new reference length
+        int refLength = ref.length() - reverseClipping;
+
+        return position+Math.max(refLength - 1,0);
+    }
+
+    public final static boolean canDecodeFile(final File potentialInput, final String MAGIC_HEADER_LINE) {
+        try {
+            return isVCFStream(new FileInputStream(potentialInput), MAGIC_HEADER_LINE) ||
+                    isVCFStream(new GZIPInputStream(new FileInputStream(potentialInput)), MAGIC_HEADER_LINE) ||
+                    isVCFStream(new BlockCompressedInputStream(new FileInputStream(potentialInput)), MAGIC_HEADER_LINE);
+        } catch ( FileNotFoundException e ) {
+            return false;
+        } catch ( IOException e ) {
+            return false;
+        }
+    }
+
+    private final static boolean isVCFStream(final InputStream stream, final String MAGIC_HEADER_LINE) {
+        try {
+            byte[] buff = new byte[MAGIC_HEADER_LINE.length()];
+            int nread = stream.read(buff, 0, MAGIC_HEADER_LINE.length());
+            boolean eq = Arrays.equals(buff, MAGIC_HEADER_LINE.getBytes());
+            return eq;
+//            String firstLine = new String(buff);
+//            return firstLine.startsWith(MAGIC_HEADER_LINE);
+        } catch ( IOException e ) {
+            return false;
+        } catch ( RuntimeException e ) {
+            return false;
+        } finally {
+            try { stream.close(); } catch ( IOException e ) {}
+        }
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Allele.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Allele.java
new file mode 100755
index 000000000..f43cd7b98
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Allele.java
@@ -0,0 +1,456 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * Immutable representation of an allele
+ *
+ * Types of alleles:
+ *
+ * Ref: a t C g a // C is the reference base
+ *
+ *    : a t G g a // C base is a G in some individuals
+ *
+ *    : a t - g a // C base is deleted w.r.t. the reference
+ *
+ *    : a t CAg a // A base is inserted w.r.t. the reference sequence
+ *
+ * In these cases, where are the alleles?
+ *
+ * SNP polymorphism of C/G  -> { C , G } -> C is the reference allele
+ * 1 base deletion of C     -> { C , - } -> C is the reference allele
+ * 1 base insertion of A    -> { - ; A } -> Null is the reference allele
+ *
+ * Suppose I see a the following in the population:
+ *
+ * Ref: a t C g a // C is the reference base
+ *    : a t G g a // C base is a G in some individuals
+ *    : a t - g a // C base is deleted w.r.t. the reference
+ *
+ * How do I represent this?  There are three segregating alleles:
+ *
+ *  { C , G , - }
+ *
+ * Now suppose I have this more complex example:
+ *
+ * Ref: a t C g a // C is the reference base
+ *    : a t - g a
+ *    : a t - - a
+ *    : a t CAg a
+ *
+ * There are actually four segregating alleles:
+ *
+ *   { C g , - g, - -, and CAg } over bases 2-4
+ *
+ * However, the molecular equivalence explicitly listed above is usually discarded, so the actual
+ * segregating alleles are:
+ *
+ *   { C g, g, -, C a g }
+ *
+ * Critically, it should be possible to apply an allele to a reference sequence to create the
+ * correct haplotype sequence:
+ *
+ * Allele + reference => haplotype
+ *
+ * For convenience, we are going to create Alleles where the GenomeLoc of the allele is stored outside of the
+ * Allele object itself.  So there's an idea of an A/C polymorphism independent of it's surrounding context.
+ *
+ * Given list of alleles it's possible to determine the "type" of the variation
+ *
+ *      A / C @ loc => SNP with
+ *      - / A => INDEL
+ *
+ * If you know where allele is the reference, you can determine whether the variant is an insertion or deletion.
+ *
+ * Alelle also supports is concept of a NO_CALL allele.  This Allele represents a haplotype that couldn't be
+ * determined. This is usually represented by a '.' allele.
+ *
+ * Note that Alleles store all bases as bytes, in **UPPER CASE**.  So 'atc' == 'ATC' from the perspective of an
+ * Allele.
+
+ * @author ebanks, depristo
+ */
+class Allele implements Comparable<Allele> {
+    private static final byte[] EMPTY_ALLELE_BASES = new byte[0];
+
+    private boolean isRef = false;
+    private boolean isNull = false;
+    private boolean isNoCall = false;
+    private boolean isSymbolic = false;
+
+    private byte[] bases = null;
+
+    public final static String NULL_ALLELE_STRING = "-";
+    public final static String NO_CALL_STRING = ".";
+    /** A generic static NO_CALL allele for use */
+
+    // no public way to create an allele
+    private Allele(byte[] bases, boolean isRef) {
+        // standardize our representation of null allele and bases
+        if ( wouldBeNullAllele(bases) ) {
+            bases = EMPTY_ALLELE_BASES;
+            isNull = true;
+        } else if ( wouldBeNoCallAllele(bases) ) {
+            bases = EMPTY_ALLELE_BASES;
+            isNoCall = true;
+            if ( isRef ) throw new IllegalArgumentException("Cannot tag a NoCall allele as the reference allele");
+        } else if ( wouldBeSymbolicAllele(bases) ) {
+            isSymbolic = true;
+            if ( isRef ) throw new IllegalArgumentException("Cannot tag a symbolic allele as the reference allele");
+        }
+//        else
+//            bases = new String(bases).toUpperCase().getBytes(); // todo -- slow performance
+
+        this.isRef = isRef;
+        this.bases = bases;
+
+        if ( ! acceptableAlleleBases(bases) )
+            throw new IllegalArgumentException("Unexpected base in allele bases \'" + new String(bases)+"\'");
+    }
+
+    private Allele(String bases, boolean isRef) {
+        this(bases.getBytes(), isRef);
+    }
+
+
+    private final static Allele REF_A = new Allele("A", true);
+    private final static Allele ALT_A = new Allele("A", false);
+    private final static Allele REF_C = new Allele("C", true);
+    private final static Allele ALT_C = new Allele("C", false);
+    private final static Allele REF_G = new Allele("G", true);
+    private final static Allele ALT_G = new Allele("G", false);
+    private final static Allele REF_T = new Allele("T", true);
+    private final static Allele ALT_T = new Allele("T", false);
+    private final static Allele REF_N = new Allele("N", true);
+    private final static Allele ALT_N = new Allele("N", false);
+    private final static Allele REF_NULL = new Allele(NULL_ALLELE_STRING, true);
+    private final static Allele ALT_NULL = new Allele(NULL_ALLELE_STRING, false);
+    public final static Allele NO_CALL = new Allele(NO_CALL_STRING, false);
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // creation routines
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    /**
+     * Create a new Allele that includes bases and if tagged as the reference allele if isRef == true.  If bases
+     * == '-', a Null allele is created.  If bases ==  '.', a no call Allele is created.
+     *
+     * @param bases the DNA sequence of this variation, '-', of '.'
+     * @param isRef should we make this a reference allele?
+     * @throws IllegalArgumentException if bases contains illegal characters or is otherwise malformated
+     */
+    public static Allele create(byte[] bases, boolean isRef) {
+        if ( bases == null )
+            throw new IllegalArgumentException("create: the Allele base string cannot be null; use new Allele() or new Allele(\"\") to create a Null allele");
+
+        if ( bases.length == 1 ) {
+            // optimization to return a static constant Allele for each single base object
+            switch (bases[0]) {
+                case '.':
+                    if ( isRef ) throw new IllegalArgumentException("Cannot tag a NoCall allele as the reference allele");
+                    return NO_CALL;
+                case '-': return isRef ? REF_NULL : ALT_NULL;
+                case 'A': case 'a' : return isRef ? REF_A : ALT_A;
+                case 'C': case 'c' : return isRef ? REF_C : ALT_C;
+                case 'G': case 'g' : return isRef ? REF_G : ALT_G;
+                case 'T': case 't' : return isRef ? REF_T : ALT_T;
+                case 'N': case 'n' : return isRef ? REF_N : ALT_N;
+                default: throw new IllegalArgumentException("Illegal base: " + (char)bases[0]);
+            }
+        } else {
+            return new Allele(bases, isRef);
+        }
+    }
+
+    public static Allele create(byte base, boolean isRef) {
+//    public Allele(byte base, boolean isRef) {
+        return create( new byte[]{ base }, isRef);
+    }
+
+    public static Allele create(byte base) {
+        return create( base, false );
+    }
+
+    public static Allele extend(Allele left, byte[] right) {
+        if (left.isSymbolic())
+            throw new IllegalArgumentException("Cannot extend a symbolic allele");
+        byte[] bases = null;
+        if ( left.length() == 0 )
+            bases = right;
+        else {
+            bases = new byte[left.length() + right.length];
+            System.arraycopy(left.getBases(), 0, bases, 0, left.length());
+            System.arraycopy(right, 0, bases, left.length(), right.length);
+        }
+
+        return create(bases, left.isReference());
+    }
+
+    /**
+     * @param bases  bases representing an allele
+     * @return true if the bases represent the null allele
+     */
+    public static boolean wouldBeNullAllele(byte[] bases) {
+        return (bases.length == 1 && bases[0] == '-') || bases.length == 0;
+    }
+
+    /**
+     * @param bases  bases representing an allele
+     * @return true if the bases represent the NO_CALL allele
+     */
+    public static boolean wouldBeNoCallAllele(byte[] bases) {
+        return bases.length == 1 && bases[0] == '.';
+    }
+
+    /**
+     * @param bases  bases representing an allele
+     * @return true if the bases represent a symbolic allele
+     */
+    public static boolean wouldBeSymbolicAllele(byte[] bases) {
+        return bases.length > 2 && bases[0] == '<' && bases[bases.length-1] == '>';
+    }
+
+    /**
+     * @param bases  bases representing an allele
+     * @return true if the bases represent the well formatted allele
+     */
+    public static boolean acceptableAlleleBases(String bases) {
+        return acceptableAlleleBases(bases.getBytes());
+    }
+
+    /**
+     * @param bases  bases representing an allele
+     * @return true if the bases represent the well formatted allele
+     */
+    public static boolean acceptableAlleleBases(byte[] bases) {
+        if ( wouldBeNullAllele(bases) || wouldBeNoCallAllele(bases) || wouldBeSymbolicAllele(bases) )
+            return true;
+
+        for ( int i = 0; i < bases.length; i++ ) {
+            switch (bases[i]) {
+                case 'A': case 'C': case 'G': case 'T': case 'N' : case 'a': case 'c': case 'g': case 't': case 'n' :
+                    break;
+                default:
+                    return false;
+            }
+        }
+
+        return true;
+    }
+
+    /**
+     * @see Allele(byte[], boolean)
+     *
+     * @param bases  bases representing an allele
+     * @param isRef  is this the reference allele?
+     */
+    public static Allele create(String bases, boolean isRef) {
+    //public Allele(String bases, boolean isRef) {
+        return create(bases.getBytes(), isRef);
+    }
+
+
+    /**
+     * Creates a non-Ref allele.  @see Allele(byte[], boolean) for full information
+     *
+     * @param bases  bases representing an allele
+     */
+    public static Allele create(String bases) {
+        return create(bases, false);
+    }
+
+    /**
+     * Creates a non-Ref allele.  @see Allele(byte[], boolean) for full information
+     *
+     * @param bases  bases representing an allele
+     */
+    public static Allele create(byte[] bases) {
+        return create(bases, false);
+        //this(bases, false);
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // accessor routines
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    //Returns true if this is the null allele
+    public boolean isNull()             { return isNull; }
+    // Returns true if this is not the null allele
+    public boolean isNonNull()          { return ! isNull(); }
+
+    // Returns true if this is the NO_CALL allele
+    public boolean isNoCall()           { return isNoCall; }
+    // Returns true if this is not the NO_CALL allele
+    public boolean isCalled()           { return ! isNoCall(); }
+
+    // Returns true if this Allele is the reference allele
+    public boolean isReference()        { return isRef; }
+    // Returns true if this Allele is not the reference allele
+    public boolean isNonReference()     { return ! isReference(); }
+
+    // Returns true if this Allele is symbolic (i.e. no well-defined base sequence)
+    public boolean isSymbolic()         { return isSymbolic; }
+
+    // Returns a nice string representation of this object
+    public String toString() {
+        return (isNull() ? NULL_ALLELE_STRING : ( isNoCall() ? NO_CALL_STRING : getDisplayString() )) + (isReference() ? "*" : "");
+    }
+
+    /**
+     * Return the DNA bases segregating in this allele.  Note this isn't reference polarized,
+     * so the Null allele is represented by a vector of length 0
+     *
+     * @return the segregating bases
+     */
+    public byte[] getBases() { return isSymbolic ? EMPTY_ALLELE_BASES : bases; }
+
+    /**
+     * Return the DNA bases segregating in this allele in String format.
+     * This is useful, because toString() adds a '*' to reference alleles and getBases() returns garbage when you call toString() on it.
+     *
+     * @return the segregating bases
+     */
+    public String getBaseString() { return new String(getBases()); }
+
+    /**
+     * Return the printed representation of this allele.
+     * Same as getBaseString(), except for symbolic alleles.
+     * For symbolic alleles, the base string is empty while the display string contains <TAG>.
+     *
+     * @return the allele string representation
+     */
+    public String getDisplayString() { return new String(bases); }
+
+    /**
+     * @param other  the other allele
+     *
+     * @return true if these alleles are equal
+     */
+    public boolean equals(Object other) {
+        return ( ! (other instanceof Allele) ? false : equals((Allele)other, false) );
+    }
+
+    /**
+     * @return hash code
+     */
+    public int hashCode() {
+        int hash = 1;
+        for (int i = 0; i < bases.length; i++)
+            hash += (i+1) * bases[i];
+        return hash;
+    }
+
+    /**
+     * Returns true if this and other are equal.  If ignoreRefState is true, then doesn't require both alleles has the
+     * same ref tag
+     *
+     * @param other            allele to compare to
+     * @param ignoreRefState   if true, ignore ref state in comparison
+     * @return true if this and other are equal
+     */
+    public boolean equals(Allele other, boolean ignoreRefState) {
+        return this == other || (isRef == other.isRef || ignoreRefState) && isNull == other.isNull && isNoCall == other.isNoCall && (bases == other.bases || Arrays.equals(bases, other.bases));
+    }
+
+    /**
+     * @param test  bases to test against
+     *
+     * @return  true if this Alelle contains the same bases as test, regardless of its reference status; handles Null and NO_CALL alleles
+     */
+    public boolean basesMatch(byte[] test) { return !isSymbolic && (bases == test || Arrays.equals(bases, test)); }
+
+    /**
+     * @param test  bases to test against
+     *
+     * @return  true if this Alelle contains the same bases as test, regardless of its reference status; handles Null and NO_CALL alleles
+     */
+    public boolean basesMatch(String test) { return basesMatch(test.toUpperCase().getBytes()); }
+
+    /**
+     * @param test  allele to test against
+     *
+     * @return  true if this Alelle contains the same bases as test, regardless of its reference status; handles Null and NO_CALL alleles
+     */
+    public boolean basesMatch(Allele test) { return basesMatch(test.getBases()); }
+
+    /**
+     * @return the length of this allele.  Null and NO_CALL alleles have 0 length.
+     */
+    public int length() {
+        return isSymbolic ? 0 : bases.length;
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // useful static functions
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    public static Allele getMatchingAllele(Collection<Allele> allAlleles, String alleleBases) {
+        return getMatchingAllele(allAlleles, alleleBases.getBytes());
+    }
+
+    public static Allele getMatchingAllele(Collection<Allele> allAlleles, byte[] alleleBases) {
+        for ( Allele a : allAlleles ) {
+            if ( a.basesMatch(alleleBases) ) {
+                return a;
+            }
+        }
+
+        if ( wouldBeNoCallAllele(alleleBases) )
+            return NO_CALL;
+        else
+            return null;    // couldn't find anything
+    }
+
+    public static List<Allele> resolveAlleles(List<Allele> possibleAlleles, List<String> alleleStrings) {
+        List<Allele> myAlleles = new ArrayList<Allele>(alleleStrings.size());
+
+        for ( String alleleString : alleleStrings ) {
+            Allele allele = getMatchingAllele(possibleAlleles, alleleString);
+
+            if ( allele == null ) {
+                if ( Allele.wouldBeNoCallAllele(alleleString.getBytes()) ) {
+                    allele = create(alleleString);
+                } else {
+                    throw new IllegalArgumentException("Allele " + alleleString + " not present in the list of alleles " + possibleAlleles);
+                }
+            }
+
+            myAlleles.add(allele);
+        }
+
+        return myAlleles;
+    }
+
+    public int compareTo(Allele other) {
+        if ( isReference() && other.isNonReference() )
+            return -1;
+        else if ( isNonReference() && other.isReference() ) 
+            return 1;
+        else
+            return getBaseString().compareTo(other.getBaseString()); // todo -- potential performance issue
+    }
+
+    public static boolean oneIsPrefixOfOther(Allele a1, Allele a2) {
+        if ( a1.isNull() || a2.isNull() )
+            return true;
+
+        if ( a2.length() >= a1.length() )
+            return firstIsPrefixOfSecond(a1, a2);
+        else
+            return firstIsPrefixOfSecond(a2, a1);
+    }
+
+    private static boolean firstIsPrefixOfSecond(Allele a1, Allele a2) {
+        String a1String = a1.getBaseString();
+        return a2.getBaseString().substring(0, a1String.length()).equals(a1String);
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Genotype.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Genotype.java
new file mode 100755
index 000000000..91aa3b1da
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Genotype.java
@@ -0,0 +1,349 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+
+import org.broad.tribble.util.ParsingUtils;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+
+import java.util.*;
+
+/**
+ * This class encompasses all the basic information about a genotype.  It is immutable.
+ *
+ * @author Mark DePristo
+ */
+public class Genotype {
+
+    public final static String PHASED_ALLELE_SEPARATOR = "|";
+    public final static String UNPHASED_ALLELE_SEPARATOR = "/";
+
+    protected InferredGeneticContext commonInfo;
+    public final static double NO_NEG_LOG_10PERROR = InferredGeneticContext.NO_NEG_LOG_10PERROR;
+    protected List<Allele> alleles = null; // new ArrayList<Allele>();
+    protected Type type = null;
+
+    protected boolean isPhased = false;
+    protected boolean filtersWereAppliedToContext;
+
+    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean isPhased) {
+        this(sampleName, alleles, negLog10PError, filters, attributes, isPhased, null);
+    }
+
+    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean isPhased, double[] log10Likelihoods) {
+        if ( alleles != null )
+            this.alleles = Collections.unmodifiableList(alleles);
+        commonInfo = new InferredGeneticContext(sampleName, negLog10PError, filters, attributes);
+        if ( log10Likelihoods != null )
+            commonInfo.putAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, GenotypeLikelihoods.fromLog10Likelihoods(log10Likelihoods));
+        filtersWereAppliedToContext = filters != null;
+        this.isPhased = isPhased;
+        validate();
+    }
+
+    /**
+     * Creates a new Genotype for sampleName with genotype according to alleles.
+     * @param sampleName
+     * @param alleles
+     * @param negLog10PError the confidence in these alleles
+     * @param log10Likelihoods a log10 likelihoods for each of the genotype combinations possible for alleles, in the standard VCF ordering, or null if not known
+     */
+    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, double[] log10Likelihoods) {
+        this(sampleName, alleles, negLog10PError, null, null, false, log10Likelihoods);
+    }
+
+    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError) {
+        this(sampleName, alleles, negLog10PError, null, null, false);
+    }
+
+    public Genotype(String sampleName, List<Allele> alleles) {
+        this(sampleName, alleles, NO_NEG_LOG_10PERROR, null, null, false);
+    }
+
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Partial-cloning routines (because Genotype is immutable).
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    public static Genotype modifyName(Genotype g, String name) {
+        return new Genotype(name, g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, g.getAttributes(), g.isPhased());
+    }
+
+    public static Genotype modifyAttributes(Genotype g, Map<String, Object> attributes) {
+        return new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attributes, g.isPhased());
+    }
+
+    public static Genotype modifyAlleles(Genotype g, List<Allele> alleles) {
+        return new Genotype(g.getSampleName(), alleles, g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, g.getAttributes(), g.isPhased());
+    }
+
+    /**
+     * @return the alleles for this genotype
+     */
+    public List<Allele> getAlleles() {
+        return alleles;
+    }
+
+    public List<Allele> getAlleles(Allele allele) {
+        if ( getType() == Type.UNAVAILABLE )
+            throw new ReviewedStingException("Requesting alleles for an UNAVAILABLE genotype");
+
+        List<Allele> al = new ArrayList<Allele>();
+        for ( Allele a : alleles )
+            if ( a.equals(allele) )
+                al.add(a);
+
+        return Collections.unmodifiableList(al);
+    }
+
+    public Allele getAllele(int i) {
+        if ( getType() == Type.UNAVAILABLE )
+            throw new ReviewedStingException("Requesting alleles for an UNAVAILABLE genotype");
+        return alleles.get(i);
+    }
+
+    public boolean isPhased() { return isPhased; }
+
+    /**
+     * @return the ploidy of this genotype
+     */
+    public int getPloidy() {
+        if ( alleles == null )
+            throw new ReviewedStingException("Requesting ploidy for an UNAVAILABLE genotype");
+        return alleles.size();
+    }
+
+    public enum Type {
+        NO_CALL,
+        HOM_REF,
+        HET,
+        HOM_VAR,
+        UNAVAILABLE,
+        MIXED  // no-call and call in the same genotype
+    }
+
+    public Type getType() {
+        if ( type == null ) {
+            type = determineType();
+        }
+        return type;
+    }
+
+    protected Type determineType() {
+        if ( alleles == null )
+            return Type.UNAVAILABLE;
+
+        boolean sawNoCall = false, sawMultipleAlleles = false;
+        Allele observedAllele = null;
+
+        for ( Allele allele : alleles ) {
+            if ( allele.isNoCall() )
+                sawNoCall = true;
+            else if ( observedAllele == null )
+                observedAllele = allele;
+            else if ( !allele.equals(observedAllele) )
+                sawMultipleAlleles = true;
+        }
+
+        if ( sawNoCall ) {
+            if ( observedAllele == null )
+                return Type.NO_CALL;
+            return Type.MIXED;
+        }
+
+        if ( observedAllele == null )
+            throw new ReviewedStingException("BUG: there are no alleles present in this genotype but the alleles list is not null");
+
+        return sawMultipleAlleles ? Type.HET : observedAllele.isReference() ? Type.HOM_REF : Type.HOM_VAR;
+    }
+
+    /**
+     * @return true if all observed alleles are the same (regardless of whether they are ref or alt); if any alleles are no-calls, this method will return false.
+     */
+    public boolean isHom()    { return isHomRef() || isHomVar(); }
+
+    /**
+     * @return true if all observed alleles are ref; if any alleles are no-calls, this method will return false.
+     */
+    public boolean isHomRef() { return getType() == Type.HOM_REF; }
+
+    /**
+     * @return true if all observed alleles are alt; if any alleles are no-calls, this method will return false.
+     */
+    public boolean isHomVar() { return getType() == Type.HOM_VAR; }
+    
+    /**
+     * @return true if we're het (observed alleles differ); if the ploidy is less than 2 or if any alleles are no-calls, this method will return false.
+     */
+    public boolean isHet() { return getType() == Type.HET; }
+
+    /**
+     * @return true if this genotype is not actually a genotype but a "no call" (e.g. './.' in VCF); if any alleles are not no-calls (even if some are), this method will return false.
+     */
+    public boolean isNoCall() { return getType() == Type.NO_CALL; }
+
+    /**
+     * @return true if this genotype is comprised of any alleles that are not no-calls (even if some are).
+     */
+    public boolean isCalled() { return getType() != Type.NO_CALL && getType() != Type.UNAVAILABLE; }
+
+    /**
+     * @return true if this genotype is comprised of both calls and no-calls.
+     */
+    public boolean isMixed() { return getType() == Type.MIXED; }
+
+    /**
+     * @return true if the type of this genotype is set.
+     */
+    public boolean isAvailable() { return getType() != Type.UNAVAILABLE; }
+
+    //
+    // Useful methods for getting genotype likelihoods for a genotype object, if present
+    //
+    public boolean hasLikelihoods() {
+        return (hasAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY) && !getAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY).equals(VCFConstants.MISSING_VALUE_v4)) ||
+                (hasAttribute(VCFConstants.GENOTYPE_LIKELIHOODS_KEY) && !getAttribute(VCFConstants.GENOTYPE_LIKELIHOODS_KEY).equals(VCFConstants.MISSING_VALUE_v4));
+    }
+    
+    public GenotypeLikelihoods getLikelihoods() {
+        GenotypeLikelihoods x = getLikelihoods(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, true);
+        if ( x != null )
+            return x;
+        else {
+            x = getLikelihoods(VCFConstants.GENOTYPE_LIKELIHOODS_KEY, false);
+            if ( x != null ) return x;
+            else
+                throw new IllegalStateException("BUG: genotype likelihood field in " + this.getSampleName() + " sample are not either a string or a genotype likelihood class!");
+        }
+    }
+
+    private GenotypeLikelihoods getLikelihoods(String key, boolean asPL) {
+        Object x = getAttribute(key);
+        if ( x instanceof String ) {
+            if ( asPL )
+                return GenotypeLikelihoods.fromPLField((String)x);
+            else
+                return GenotypeLikelihoods.fromGLField((String)x);
+        }
+        else if ( x instanceof GenotypeLikelihoods ) return (GenotypeLikelihoods)x;
+        else return null;
+    }
+
+    public void validate() {
+        if ( alleles == null ) return;
+        if ( alleles.size() == 0) throw new IllegalArgumentException("BUG: alleles cannot be of size 0");
+
+        // int nNoCalls = 0;
+        for ( Allele allele : alleles ) {
+            if ( allele == null )
+                throw new IllegalArgumentException("BUG: allele cannot be null in Genotype");
+            // nNoCalls += allele.isNoCall() ? 1 : 0;
+        }
+
+        // Technically, the spec does allow for the below case so this is not an illegal state
+        //if ( nNoCalls > 0 && nNoCalls != alleles.size() )
+        //    throw new IllegalArgumentException("BUG: alleles include some No Calls and some Calls, an illegal state " + this);
+    }
+
+    public String getGenotypeString() {
+        return getGenotypeString(true);
+    }
+
+    public String getGenotypeString(boolean ignoreRefState) {
+        if ( alleles == null )
+            return null;
+
+        // Notes:
+        // 1. Make sure to use the appropriate separator depending on whether the genotype is phased
+        // 2. If ignoreRefState is true, then we want just the bases of the Alleles (ignoring the '*' indicating a ref Allele)
+        // 3. So that everything is deterministic with regards to integration tests, we sort Alleles (when the genotype isn't phased, of course)
+        return ParsingUtils.join(isPhased() ? PHASED_ALLELE_SEPARATOR : UNPHASED_ALLELE_SEPARATOR,
+                ignoreRefState ? getAlleleStrings() : (isPhased() ? getAlleles() : ParsingUtils.sortList(getAlleles())));
+    }
+
+    private List<String> getAlleleStrings() {
+        List<String> al = new ArrayList<String>();
+        for ( Allele a : alleles )
+            al.add(a.getBaseString());
+
+        return al;
+    }
+
+    public String toString() {
+        int Q = (int)Math.round(getPhredScaledQual());
+        return String.format("[%s %s Q%s %s]", getSampleName(), getGenotypeString(false),
+                Q == -10 ? "." : String.format("%2d",Q), sortedString(getAttributes()));
+    }
+
+    public String toBriefString() {
+        return String.format("%s:Q%.2f", getGenotypeString(false), getPhredScaledQual());
+    }
+
+    public boolean sameGenotype(Genotype other) {
+        return sameGenotype(other, true);
+    }
+
+    public boolean sameGenotype(Genotype other, boolean ignorePhase) {
+        if (getPloidy() != other.getPloidy())
+            return false; // gotta have the same number of allele to be equal
+
+        // By default, compare the elements in the lists of alleles, element-by-element
+        Collection<Allele> thisAlleles = this.getAlleles();
+        Collection<Allele> otherAlleles = other.getAlleles();
+
+        if (ignorePhase) { // do not care about order, only identity of Alleles
+            thisAlleles = new TreeSet<Allele>(thisAlleles);   //implemented Allele.compareTo()
+            otherAlleles = new TreeSet<Allele>(otherAlleles);
+        }
+
+        return thisAlleles.equals(otherAlleles);
+    }
+
+    /**
+     * a utility method for generating sorted strings from a map key set.
+     * @param c the map
+     * @param <T> the key type
+     * @param <V> the value type
+     * @return a sting, enclosed in {}, with comma seperated key value pairs in order of the keys
+     */
+    private static <T extends Comparable<T>, V> String sortedString(Map<T, V> c) {
+        // NOTE -- THIS IS COPIED FROM GATK UTILS TO ALLOW US TO KEEP A SEPARATION BETWEEN THE GATK AND VCF CODECS
+        List<T> t = new ArrayList<T>(c.keySet());
+        Collections.sort(t);
+
+        List<String> pairs = new ArrayList<String>();
+        for (T k : t) {
+            pairs.add(k + "=" + c.get(k));
+        }
+
+        return "{" + ParsingUtils.join(", ", pairs.toArray(new String[pairs.size()])) + "}";
+    }
+
+
+    // ---------------------------------------------------------------------------------------------------------
+    // 
+    // get routines to access context info fields
+    //
+    // ---------------------------------------------------------------------------------------------------------
+    public String getSampleName()       { return commonInfo.getName(); }
+    public Set<String> getFilters()     { return commonInfo.getFilters(); }
+    public boolean isFiltered()         { return commonInfo.isFiltered(); }
+    public boolean isNotFiltered()      { return commonInfo.isNotFiltered(); }
+    public boolean filtersWereApplied() { return filtersWereAppliedToContext; }
+    public boolean hasNegLog10PError()  { return commonInfo.hasNegLog10PError(); }
+    public double getNegLog10PError()   { return commonInfo.getNegLog10PError(); }
+    public double getPhredScaledQual()  { return commonInfo.getPhredScaledQual(); }
+
+    public Map<String, Object> getAttributes()  { return commonInfo.getAttributes(); }
+    public boolean hasAttribute(String key)     { return commonInfo.hasAttribute(key); }
+    public Object getAttribute(String key)      { return commonInfo.getAttribute(key); }
+    
+    public Object getAttribute(String key, Object defaultValue) {
+        return commonInfo.getAttribute(key, defaultValue); 
+    }
+
+    public String getAttributeAsString(String key, String defaultValue)   { return commonInfo.getAttributeAsString(key, defaultValue); }
+    public int getAttributeAsInt(String key, int defaultValue)            { return commonInfo.getAttributeAsInt(key, defaultValue); }
+    public double getAttributeAsDouble(String key, double  defaultValue)  { return commonInfo.getAttributeAsDouble(key, defaultValue); }
+    public boolean getAttributeAsBoolean(String key, boolean  defaultValue)  { return commonInfo.getAttributeAsBoolean(key, defaultValue); }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/GenotypeLikelihoods.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/GenotypeLikelihoods.java
new file mode 100755
index 000000000..02fb32451
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/GenotypeLikelihoods.java
@@ -0,0 +1,196 @@
+/*
+ * Copyright (c) 2010, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.broad.tribble.TribbleException;
+import org.broadinstitute.sting.utils.MathUtils;
+
+import java.util.EnumMap;
+import java.util.Map;
+
+public class GenotypeLikelihoods {
+    public static final boolean CAP_PLS = false;
+    public static final int PL_CAP = 255;
+
+    //
+    // There are two objects here because we are lazy in creating both representations
+    // for this object: a vector of log10 Probs and the PL phred-scaled string.  Supports
+    // having one set during initializating, and dynamic creation of the other, if needed
+    //
+    private double[] log10Likelihoods = null;
+    private String likelihoodsAsString_PLs = null;
+
+    public final static GenotypeLikelihoods fromPLField(String PLs) {
+        return new GenotypeLikelihoods(PLs);
+    }
+
+    public final static GenotypeLikelihoods fromGLField(String GLs) {
+        return new GenotypeLikelihoods(parseDeprecatedGLString(GLs));
+    }
+
+    public final static GenotypeLikelihoods fromLog10Likelihoods(double[] log10Likelihoods) {
+        return new GenotypeLikelihoods(log10Likelihoods);
+    }
+
+    //
+    // You must use the factory methods now
+    //
+    protected GenotypeLikelihoods(String asString) {
+        likelihoodsAsString_PLs = asString;
+    }
+
+    protected GenotypeLikelihoods(double[] asVector) {
+        log10Likelihoods = asVector;
+    }
+
+    /**
+     * Returns the genotypes likelihoods in negative log10 vector format.  pr{AA} = x, this
+     * vector returns math.log10(x) for each of the genotypes.  Can return null if the
+     * genotype likelihoods are "missing".
+     *
+     * @return
+     */
+    public double[] getAsVector() {
+        // assumes one of the likelihoods vector or the string isn't null
+        if ( log10Likelihoods == null ) {
+            // make sure we create the GL string if it doesn't already exist
+            log10Likelihoods = parsePLsIntoLikelihoods(likelihoodsAsString_PLs);
+        }
+
+        return log10Likelihoods;
+    }
+
+    public String toString() {
+        return getAsString();
+    }
+
+    public String getAsString() {
+        if ( likelihoodsAsString_PLs == null ) {
+            // todo -- should we accept null log10Likelihoods and set PLs as MISSING?
+            if ( log10Likelihoods == null )
+                throw new TribbleException("BUG: Attempted to get likelihoods as strings and neither the vector nor the string is set!");
+            likelihoodsAsString_PLs = convertLikelihoodsToPLString(log10Likelihoods);
+        }
+
+        return likelihoodsAsString_PLs;
+    }
+
+    //Return genotype likelihoods as an EnumMap with Genotypes as keys and likelihoods as values
+    //Returns null in case of missing likelihoods
+    public EnumMap<Genotype.Type,Double> getAsMap(boolean normalizeFromLog10){
+        //Make sure that the log10likelihoods are set
+        double[] likelihoods = normalizeFromLog10 ? MathUtils.normalizeFromLog10(getAsVector()) : getAsVector();
+        if(likelihoods == null)
+            return null;
+        EnumMap<Genotype.Type,Double> likelihoodsMap = new EnumMap<Genotype.Type, Double>(Genotype.Type.class);
+        likelihoodsMap.put(Genotype.Type.HOM_REF,likelihoods[Genotype.Type.HOM_REF.ordinal()-1]);
+        likelihoodsMap.put(Genotype.Type.HET,likelihoods[Genotype.Type.HET.ordinal()-1]);
+        likelihoodsMap.put(Genotype.Type.HOM_VAR, likelihoods[Genotype.Type.HOM_VAR.ordinal() - 1]);
+        return likelihoodsMap;
+    }
+
+    //Return the neg log10 Genotype Quality (GQ) for the given genotype
+    //Returns Double.NEGATIVE_INFINITY in case of missing genotype
+    public double getNegLog10GQ(Genotype.Type genotype){
+
+        double qual = Double.NEGATIVE_INFINITY;
+        EnumMap<Genotype.Type,Double> likelihoods = getAsMap(false);
+        if(likelihoods == null)
+            return qual;
+        for(Map.Entry<Genotype.Type,Double> likelihood : likelihoods.entrySet()){
+            if(likelihood.getKey() == genotype)
+                continue;
+            if(likelihood.getValue() > qual)
+                qual = likelihood.getValue();
+
+        }
+
+        //Quality of the most likely genotype = likelihood(most likely) - likelihood (2nd best)
+        qual = likelihoods.get(genotype) - qual;
+
+        //Quality of other genotypes 1-P(G)
+        if (qual < 0) {
+            double[] normalized = MathUtils.normalizeFromLog10(getAsVector());
+            double chosenGenotype = normalized[genotype.ordinal()-1];
+            qual = -1.0 * Math.log10(1.0 - chosenGenotype);
+        }
+        return qual;
+    }
+
+    private final static double[] parsePLsIntoLikelihoods(String likelihoodsAsString_PLs) {
+        if ( !likelihoodsAsString_PLs.equals(VCFConstants.MISSING_VALUE_v4) ) {
+            String[] strings = likelihoodsAsString_PLs.split(",");
+            double[] likelihoodsAsVector = new double[strings.length];
+            for ( int i = 0; i < strings.length; i++ ) {
+                likelihoodsAsVector[i] = Integer.parseInt(strings[i]) / -10.0;
+            }
+            return likelihoodsAsVector;
+        } else
+            return null;
+    }
+
+    /**
+     * Back-compatibility function to read old style GL formatted genotype likelihoods in VCF format
+     * @param GLString
+     * @return
+     */
+    private final static double[] parseDeprecatedGLString(String GLString) {
+        if ( !GLString.equals(VCFConstants.MISSING_VALUE_v4) ) {
+            String[] strings = GLString.split(",");
+            double[] likelihoodsAsVector = new double[strings.length];
+            for ( int i = 0; i < strings.length; i++ ) {
+                likelihoodsAsVector[i] = Double.parseDouble(strings[i]);
+            }
+            return likelihoodsAsVector;
+        }
+
+        return null;
+    }
+
+    private final static String convertLikelihoodsToPLString(double[] GLs) {
+        if ( GLs == null )
+            return VCFConstants.MISSING_VALUE_v4;
+
+        StringBuilder s = new StringBuilder();
+
+        double adjust = Double.NEGATIVE_INFINITY;
+        for ( double l : GLs ) adjust = Math.max(adjust, l);
+
+        boolean first = true;
+        for ( double l : GLs ) {
+            if ( ! first )
+                s.append(",");
+            else
+                first = false;
+
+            long PL = Math.round(-10 * (l - adjust));
+            if ( CAP_PLS )
+                PL = Math.min(PL, PL_CAP);
+            s.append(Long.toString(PL));
+        }
+
+        return s.toString();
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/IndexingVCFWriter.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/IndexingVCFWriter.java
new file mode 100644
index 000000000..85444c325
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/IndexingVCFWriter.java
@@ -0,0 +1,143 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import com.google.java.contract.Ensures;
+import com.google.java.contract.Requires;
+import net.sf.samtools.SAMSequenceDictionary;
+import org.broad.tribble.Tribble;
+import org.broad.tribble.TribbleException;
+import org.broad.tribble.index.DynamicIndexCreator;
+import org.broad.tribble.index.Index;
+import org.broad.tribble.index.IndexFactory;
+import org.broad.tribble.util.LittleEndianOutputStream;
+import org.broad.tribble.util.PositionalStream;
+import org.broadinstitute.sting.gatk.refdata.tracks.IndexDictionaryUtils;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+import org.broadinstitute.sting.utils.exceptions.UserException;
+
+import java.io.*;
+
+/**
+ * this class writes VCF files
+ */
+abstract class IndexingVCFWriter implements VCFWriter {
+    final private String name;
+    private final SAMSequenceDictionary refDict;
+
+    private OutputStream outputStream;
+    private PositionalStream positionalStream = null;
+    private DynamicIndexCreator indexer = null;
+    private LittleEndianOutputStream idxStream = null;
+
+    @Requires({"name != null",
+            "! ( location == null && output == null )",
+            "! ( enableOnTheFlyIndexing && location == null )"})
+    protected IndexingVCFWriter(final String name, final File location, final OutputStream output, final SAMSequenceDictionary refDict, final boolean enableOnTheFlyIndexing) {
+        outputStream = output;
+        this.name = name;
+        this.refDict = refDict;
+
+        if ( enableOnTheFlyIndexing ) {
+            try {
+                idxStream = new LittleEndianOutputStream(new FileOutputStream(Tribble.indexFile(location)));
+                //System.out.println("Creating index on the fly for " + location);
+                indexer = new DynamicIndexCreator(IndexFactory.IndexBalanceApproach.FOR_SEEK_TIME);
+                indexer.initialize(location, indexer.defaultBinSize());
+                positionalStream = new PositionalStream(output);
+                outputStream = positionalStream;
+            } catch ( IOException ex ) {
+                // No matter what we keep going, since we don't care if we can't create the index file
+                idxStream = null;
+                indexer = null;
+                positionalStream = null;
+            }
+        }
+    }
+
+    @Ensures("result != null")
+    public OutputStream getOutputStream() {
+        return outputStream;
+    }
+
+    @Ensures("result != null")
+    public String getStreamName() {
+        return name;
+    }
+
+    public abstract void writeHeader(VCFHeader header);
+
+    /**
+     * attempt to close the VCF file
+     */
+    public void close() {
+        // try to close the index stream (keep it separate to help debugging efforts)
+        if ( indexer != null ) {
+            try {
+                Index index = indexer.finalizeIndex(positionalStream.getPosition());
+                IndexDictionaryUtils.setIndexSequenceDictionary(index, refDict);
+                index.write(idxStream);
+                idxStream.close();
+            } catch (IOException e) {
+                throw new ReviewedStingException("Unable to close index for " + getStreamName(), e);
+            }
+        }
+    }
+
+    /**
+     * add a record to the file
+     *
+     * @param vc      the Variant Context object
+     */
+    public void add(VariantContext vc) {
+        // if we are doing on the fly indexing, add the record ***before*** we write any bytes
+        if ( indexer != null )
+            indexer.addFeature(vc, positionalStream.getPosition());
+    }
+
+    /**
+     * Returns a reasonable "name" for this writer, to display to the user if something goes wrong
+     *
+     * @param location
+     * @param stream
+     * @return
+     */
+    protected static final String writerName(final File location, final OutputStream stream) {
+        return location == null ? stream.toString() : location.getAbsolutePath();
+    }
+
+    /**
+     * Returns a output stream writing to location, or throws a UserException if this fails
+     * @param location
+     * @return
+     */
+    protected static OutputStream openOutputStream(final File location) {
+        try {
+            return new FileOutputStream(location);
+        } catch (FileNotFoundException e) {
+            throw new UserException.CouldNotCreateOutputFile(location, "Unable to create VCF writer", e);
+        }
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/InferredGeneticContext.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/InferredGeneticContext.java
new file mode 100755
index 000000000..43f61343e
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/InferredGeneticContext.java
@@ -0,0 +1,243 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+
+import java.util.*;
+
+
+/**
+ * Common utility routines for VariantContext and Genotype
+ *
+ * @author depristo
+ */
+final class InferredGeneticContext {
+    public static final double NO_NEG_LOG_10PERROR = -1.0;
+
+    private static Set<String> NO_FILTERS = Collections.unmodifiableSet(new HashSet<String>());
+    private static Map<String, Object> NO_ATTRIBUTES = Collections.unmodifiableMap(new HashMap<String, Object>());
+
+    private double negLog10PError = NO_NEG_LOG_10PERROR;
+    private String name = null;
+    private Set<String> filters = NO_FILTERS;
+    private Map<String, Object> attributes = NO_ATTRIBUTES;
+
+//    public InferredGeneticContext(String name) {
+//        this.name = name;
+//    }
+//
+//    public InferredGeneticContext(String name, double negLog10PError) {
+//        this(name);
+//        setNegLog10PError(negLog10PError);
+//    }
+
+    public InferredGeneticContext(String name, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+        this.name = name;
+        setNegLog10PError(negLog10PError);
+        if ( filters != null )
+            setFilters(filters);
+        if ( attributes != null )
+            setAttributes(attributes);
+    }
+
+    /**
+     * @return the name
+     */
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * Sets the name
+     *
+     * @param name    the name associated with this information
+     */
+    public void setName(String name) {
+        if ( name == null ) throw new IllegalArgumentException("Name cannot be null " + this);
+        this.name = name;
+    }
+
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Filter
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    public Set<String> getFilters() {
+        return Collections.unmodifiableSet(filters);
+    }
+
+    public boolean isFiltered() {
+        return filters.size() > 0;
+    }
+
+    public boolean isNotFiltered() {
+        return ! isFiltered();
+    }
+
+    public void addFilter(String filter) {
+        if ( filters == NO_FILTERS ) // immutable -> mutable
+            filters = new HashSet<String>(filters);
+
+        if ( filter == null ) throw new IllegalArgumentException("BUG: Attempting to add null filter " + this);
+        if ( getFilters().contains(filter) ) throw new IllegalArgumentException("BUG: Attempting to add duplicate filter " + filter + " at " + this);
+        filters.add(filter);
+    }
+
+    public void addFilters(Collection<String> filters) {
+        if ( filters == null ) throw new IllegalArgumentException("BUG: Attempting to add null filters at" + this);
+        for ( String f : filters )
+            addFilter(f);
+    }
+
+    public void clearFilters() {
+        filters = new HashSet<String>();
+    }
+
+    public void setFilters(Collection<String> filters) {
+        clearFilters();
+        addFilters(filters);
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Working with log error rates
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    public boolean hasNegLog10PError() {
+        return getNegLog10PError() != NO_NEG_LOG_10PERROR;
+    }
+
+    /**
+     * @return the -1 * log10-based error estimate
+     */
+    public double getNegLog10PError() { return negLog10PError; }
+    public double getPhredScaledQual() { return getNegLog10PError() * 10; }
+
+    public void setNegLog10PError(double negLog10PError) {
+        if ( negLog10PError < 0 && negLog10PError != NO_NEG_LOG_10PERROR ) throw new IllegalArgumentException("BUG: negLog10PError cannot be < than 0 : " + negLog10PError);
+        if ( Double.isInfinite(negLog10PError) ) throw new IllegalArgumentException("BUG: negLog10PError should not be Infinity");
+        if ( Double.isNaN(negLog10PError) ) throw new IllegalArgumentException("BUG: negLog10PError should not be NaN");
+
+        this.negLog10PError = negLog10PError;
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Working with attributes
+    //
+    // ---------------------------------------------------------------------------------------------------------
+    public void clearAttributes() {
+        attributes = new HashMap<String, Object>();
+    }
+
+    /**
+     * @return the attribute map
+     */
+    public Map<String, Object> getAttributes() {
+        return Collections.unmodifiableMap(attributes);
+    }
+
+    // todo -- define common attributes as enum
+
+    public void setAttributes(Map<String, ?> map) {
+        clearAttributes();
+        putAttributes(map);
+    }
+
+    public void putAttribute(String key, Object value) {
+        putAttribute(key, value, false);
+    }
+
+    public void putAttribute(String key, Object value, boolean allowOverwrites) {
+        if ( ! allowOverwrites && hasAttribute(key) )
+            throw new IllegalStateException("Attempting to overwrite key->value binding: key = " + key + " this = " + this);
+
+        if ( attributes == NO_ATTRIBUTES ) // immutable -> mutable
+            attributes = new HashMap<String, Object>();
+        
+        attributes.put(key, value);
+    }
+
+    public void removeAttribute(String key) {
+        if ( attributes == NO_ATTRIBUTES ) // immutable -> mutable
+            attributes = new HashMap<String, Object>();
+        attributes.remove(key);
+    }
+
+    public void putAttributes(Map<String, ?> map) {
+        if ( map != null ) {
+            // for efficiency, we can skip the validation if the map is empty
+            if ( attributes.size() == 0 ) {
+                if ( attributes == NO_ATTRIBUTES ) // immutable -> mutable
+                    attributes = new HashMap<String, Object>();
+                attributes.putAll(map);
+            } else {
+                for ( Map.Entry<String, ?> elt : map.entrySet() ) {
+                    putAttribute(elt.getKey(), elt.getValue(), false);
+                }
+            }
+        }
+    }
+
+    public boolean hasAttribute(String key) {
+        return attributes.containsKey(key);
+    }
+
+    public int getNumAttributes() {
+        return attributes.size();
+    }
+
+    /**
+     * @param key    the attribute key
+     *
+     * @return the attribute value for the given key (or null if not set)
+     */
+    public Object getAttribute(String key) {
+        return attributes.get(key);
+    }
+
+    public Object getAttribute(String key, Object defaultValue) {
+        if ( hasAttribute(key) )
+            return attributes.get(key);
+        else
+            return defaultValue;
+    }
+
+    public String getAttributeAsString(String key, String defaultValue) {
+        Object x = getAttribute(key);
+        if ( x == null ) return defaultValue;
+        if ( x instanceof String ) return (String)x;
+        return String.valueOf(x); // throws an exception if this isn't a string
+    }
+
+    public int getAttributeAsInt(String key, int defaultValue) {
+        Object x = getAttribute(key);
+        if ( x == null || x == VCFConstants.MISSING_VALUE_v4 ) return defaultValue;
+        if ( x instanceof Integer ) return (Integer)x;
+        return Integer.valueOf((String)x); // throws an exception if this isn't a string
+    }
+
+    public double getAttributeAsDouble(String key, double defaultValue) {
+        Object x = getAttribute(key);
+        if ( x == null ) return defaultValue;
+        if ( x instanceof Double ) return (Double)x;
+        return Double.valueOf((String)x); // throws an exception if this isn't a string
+    }
+
+    public boolean getAttributeAsBoolean(String key, boolean defaultValue) {
+        Object x = getAttribute(key);
+        if ( x == null ) return defaultValue;
+        if ( x instanceof Boolean ) return (Boolean)x;
+        return Boolean.valueOf((String)x); // throws an exception if this isn't a string
+    }
+
+//    public String getAttributeAsString(String key)      { return (String.valueOf(getAttribute(key))); } // **NOTE**: will turn a null Object into the String "null"
+//    public int getAttributeAsInt(String key)            { Object x = getAttribute(key); return x instanceof Integer ? (Integer)x : Integer.valueOf((String)x); }
+//    public double getAttributeAsDouble(String key)      { Object x = getAttribute(key); return x instanceof Double ? (Double)x : Double.valueOf((String)x); }
+//    public boolean getAttributeAsBoolean(String key)      { Object x = getAttribute(key); return x instanceof Boolean ? (Boolean)x : Boolean.valueOf((String)x); }
+//    public Integer getAttributeAsIntegerNoException(String key)  { try {return getAttributeAsInt(key);} catch (Exception e) {return null;} }
+//    public Double getAttributeAsDoubleNoException(String key)    { try {return getAttributeAsDouble(key);} catch (Exception e) {return null;} }
+//    public String getAttributeAsStringNoException(String key)    { if (getAttribute(key) == null) return null; return getAttributeAsString(key); }
+//    public Boolean getAttributeAsBooleanNoException(String key)  { try {return getAttributeAsBoolean(key);} catch (Exception e) {return null;} }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableGenotype.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableGenotype.java
new file mode 100755
index 000000000..f5072e040
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableGenotype.java
@@ -0,0 +1,68 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import java.util.*;
+
+/**
+ * This class emcompasses all the basic information about a genotype.  It is immutable.
+ *
+ * @author Mark DePristo
+ */
+class MutableGenotype extends Genotype {
+    public MutableGenotype(Genotype parent) {
+        super(parent.getSampleName(), parent.getAlleles(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
+    }
+
+    public MutableGenotype(String sampleName, Genotype parent) {
+        super(sampleName, parent.getAlleles(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
+    }
+
+
+    public MutableGenotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean genotypesArePhased) {
+        super(sampleName, alleles, negLog10PError, filters, attributes, genotypesArePhased);
+    }
+
+    public MutableGenotype(String sampleName, List<Allele> alleles, double negLog10PError) {
+        super(sampleName, alleles, negLog10PError);
+    }
+
+    public MutableGenotype(String sampleName, List<Allele> alleles) {
+        super(sampleName, alleles);
+    }
+
+    public Genotype unmodifiableGenotype() {
+        return new Genotype(getSampleName(), getAlleles(), getNegLog10PError(), getFilters(), getAttributes(), isPhased());
+    }
+
+
+    /**
+     *
+     * @param alleles list of alleles
+     */
+    public void setAlleles(List<Allele> alleles) {
+        this.alleles = new ArrayList<Allele>(alleles);
+        validate();
+    }
+
+    public void setPhase(boolean isPhased) {
+        super.isPhased = isPhased;
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // InferredGeneticContext mutation operators
+    //
+    // ---------------------------------------------------------------------------------------------------------
+    public void setName(String name)                    { commonInfo.setName(name); }
+    public void addFilter(String filter)                { commonInfo.addFilter(filter); }
+    public void addFilters(Collection<String> filters)  { commonInfo.addFilters(filters); }
+    public void clearFilters()                          { commonInfo.clearFilters(); }
+    public void setFilters(Collection<String> filters)  { commonInfo.setFilters(filters); }
+    public void setAttributes(Map<String, ?> map)       { commonInfo.setAttributes(map); }
+    public void clearAttributes()                       { commonInfo.clearAttributes(); }
+    public void putAttribute(String key, Object value)  { commonInfo.putAttribute(key, value); }
+    public void removeAttribute(String key)             { commonInfo.removeAttribute(key); }
+    public void putAttributes(Map<String, ?> map)       { commonInfo.putAttributes(map); }
+    public void setNegLog10PError(double negLog10PError) { commonInfo.setNegLog10PError(negLog10PError); }
+    public void putAttribute(String key, Object value, boolean allowOverwrites) { commonInfo.putAttribute(key, value, allowOverwrites); }
+
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableVariantContext.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableVariantContext.java
new file mode 100755
index 000000000..24e71ae50
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableVariantContext.java
@@ -0,0 +1,213 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+
+import java.util.Collection;
+import java.util.Map;
+import java.util.Set;
+import java.util.TreeMap;
+
+/**
+ * Mutable version of VariantContext
+ *
+ * @author depristo
+ */
+class MutableVariantContext extends VariantContext {
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // constructors
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+        super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
+    }
+
+    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+        super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
+    }
+
+    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
+        super(source, contig, start, stop, alleles, NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
+    }
+
+    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
+        super(source, contig, start, stop, alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
+    }
+
+    public MutableVariantContext(VariantContext parent) {
+        super(parent.getSource(), parent.contig, parent.start, parent.stop, parent.getAlleles(), parent.getGenotypes(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.getReferenceBaseForIndel());
+    }
+
+    /**
+     * Sets the alleles segregating in this context to the collect of alleles.  Each of which must be unique according
+     * to equals() in Allele.  Validate() should be called when you are done modifying the context.
+     *
+     * @param alleles
+     */
+    public void setAlleles(Collection<Allele> alleles) {
+        this.alleles.clear();
+        for ( Allele a : alleles )
+            addAllele(a);
+    }
+
+    /**
+     * Adds allele to the segregating allele list in this context to the collection of alleles.  The new
+     * allele must be be unique according to equals() in Allele.
+     * Validate() should be called when you are done modifying the context.
+     *
+     * @param allele
+     */
+    public void addAllele(Allele allele) {
+        final boolean allowDuplicates = false;  // used to be a parameter
+
+        type = null;
+
+        for ( Allele a : alleles ) {
+            if ( a.basesMatch(allele) && ! allowDuplicates )
+                throw new IllegalArgumentException("Duplicate allele added to VariantContext" + this);
+        }
+
+        // we are a novel allele
+        alleles.add(allele);
+    }
+
+    public void clearGenotypes() {
+        genotypes = new TreeMap<String, Genotype>();
+    }
+
+    /**
+     * Adds this single genotype to the context, not allowing duplicate genotypes to be added
+     * @param genotype
+     */
+    public void addGenotypes(Genotype genotype) {
+        putGenotype(genotype.getSampleName(), genotype, false);
+    }
+
+    /**
+     * Adds these genotypes to the context, not allowing duplicate genotypes to be added
+     * @param genotypes
+     */
+    public void addGenotypes(Collection<Genotype> genotypes) {
+        for ( Genotype g : genotypes ) {
+            addGenotype(g);
+        }
+    }
+
+    /**
+     * Adds these genotype to the context, not allowing duplicate genotypes to be added.
+     * @param genotypes
+     */
+    public void addGenotypes(Map<String, Genotype> genotypes) {
+
+        for ( Map.Entry<String, Genotype> elt : genotypes.entrySet() ) {
+            addGenotype(elt.getValue());
+        }
+    }
+
+    /**
+     * Adds these genotypes to the context.
+     *
+     * @param genotypes
+     */
+    public void putGenotypes(Map<String, Genotype> genotypes) {
+        for ( Map.Entry<String, Genotype> g : genotypes.entrySet() )
+            putGenotype(g.getKey(), g.getValue());
+    }
+
+    /**
+     * Adds these genotypes to the context.
+     *
+     * @param genotypes
+     */
+    public void putGenotypes(Collection<Genotype> genotypes) {
+        for ( Genotype g : genotypes )
+            putGenotype(g);
+    }
+
+    /**
+     * Adds this genotype to the context, throwing an error if it's already bound.
+     *
+     * @param genotype
+     */
+    public void addGenotype(Genotype genotype) {
+        addGenotype(genotype.getSampleName(), genotype);
+    }
+
+    /**
+     * Adds this genotype to the context, throwing an error if it's already bound.
+     *
+     * @param genotype
+     */
+    public void addGenotype(String sampleName, Genotype genotype) {
+        putGenotype(sampleName, genotype, false);
+    }
+
+    /**
+     * Adds this genotype to the context.
+     *
+     * @param genotype
+     */
+    public void putGenotype(Genotype genotype) {
+        putGenotype(genotype.getSampleName(), genotype);
+    }
+
+    /**
+     * Adds this genotype to the context.
+     *
+     * @param genotype
+     */
+    public void putGenotype(String sampleName, Genotype genotype) {
+        putGenotype(sampleName, genotype, true);
+    }
+
+    private void putGenotype(String sampleName, Genotype genotype, boolean allowOverwrites) {
+        if ( hasGenotype(sampleName) && ! allowOverwrites )
+            throw new IllegalStateException("Attempting to overwrite sample->genotype binding: " + sampleName + " this=" + this);
+
+        if ( ! sampleName.equals(genotype.getSampleName()) )
+            throw new IllegalStateException("Sample name doesn't equal genotype.getSample(): " + sampleName + " genotype=" + genotype);
+
+        this.genotypes.put(sampleName, genotype);
+    }
+
+    /**
+     * Removes the binding from sampleName to genotype.  If this doesn't exist, throws an IllegalArgumentException
+     * @param sampleName
+     */
+    public void removeGenotype(String sampleName) {
+        if ( ! this.genotypes.containsKey(sampleName) )
+            throw new IllegalArgumentException("Sample name isn't contained in genotypes " + sampleName + " genotypes =" + genotypes);
+
+        this.genotypes.remove(sampleName);
+    }
+
+    /**
+     * Removes genotype from the context.  If this doesn't exist, throws an IllegalArgumentException
+     * @param genotype
+     */
+    public void removeGenotype(Genotype genotype) {
+        removeGenotype(genotype.getSampleName());
+    }
+
+    // todo -- add replace genotype routine
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // InferredGeneticContext mutation operators
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    public void setSource(String source)                { commonInfo.setName(source); }
+    public void addFilter(String filter)                { commonInfo.addFilter(filter); }
+    public void addFilters(Collection<String> filters)  { commonInfo.addFilters(filters); }
+    public void clearFilters()                          { commonInfo.clearFilters(); }
+    public void setFilters(Collection<String> filters)  { commonInfo.setFilters(filters); }
+    public void setAttributes(Map<String, ?> map)       { commonInfo.setAttributes(map); }
+    public void clearAttributes()                       { commonInfo.clearAttributes(); }
+    public void putAttribute(String key, Object value)  { commonInfo.putAttribute(key, value); }
+    public void removeAttribute(String key)             { commonInfo.removeAttribute(key); }
+    public void putAttributes(Map<String, ?> map)       { commonInfo.putAttributes(map); }
+    public void setNegLog10PError(double negLog10PError) { commonInfo.setNegLog10PError(negLog10PError); }
+    public void putAttribute(String key, Object value, boolean allowOverwrites) { commonInfo.putAttribute(key, value, allowOverwrites); }
+    public void setID(String id) { putAttribute(ID_KEY, id, true); }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCF3Codec.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCF3Codec.java
new file mode 100755
index 000000000..9f653872a
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCF3Codec.java
@@ -0,0 +1,198 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.broad.tribble.TribbleException;
+import org.broad.tribble.readers.LineReader;
+import org.broad.tribble.util.ParsingUtils;
+
+import java.io.File;
+import java.io.FileReader;
+import java.io.IOException;
+import java.util.*;
+
+
+/**
+ * A feature codec for the VCF3 specification, to read older VCF files.  VCF3 has been
+ * depreciated in favor of VCF4 (See VCF codec for the latest information)
+ *
+ * <p>
+ * Reads historical VCF3 encoded files (1000 Genomes Pilot results, for example)
+ * </p>
+ *
+ * <p>
+ * See also: @see <a href="http://vcftools.sourceforge.net/specs.html">VCF specification</a><br>
+ * See also: @see <a href="http://www.ncbi.nlm.nih.gov/pubmed/21653522">VCF spec. publication</a>
+ * </p>
+ *
+ * @author Mark DePristo
+ * @since 2010
+ */
+class VCF3Codec extends AbstractVCFCodec {
+    public final static String VCF3_MAGIC_HEADER = "##fileformat=VCFv3";
+
+
+    /**
+     * @param reader the line reader to take header lines from
+     * @return the number of header lines
+     */
+    public Object readHeader(LineReader reader) {
+        List<String> headerStrings = new ArrayList<String>();
+
+        String line;
+        try {
+            boolean foundHeaderVersion = false;
+            while ((line = reader.readLine()) != null) {
+                lineNo++;
+                if (line.startsWith(VCFHeader.METADATA_INDICATOR)) {
+                    String[] lineFields = line.substring(2).split("=");
+                    if (lineFields.length == 2 && VCFHeaderVersion.isFormatString(lineFields[0]) ) {
+                        if ( !VCFHeaderVersion.isVersionString(lineFields[1]) )
+                            throw new TribbleException.InvalidHeader(lineFields[1] + " is not a supported version");
+                        foundHeaderVersion = true;
+                        version = VCFHeaderVersion.toHeaderVersion(lineFields[1]);
+                        if ( version != VCFHeaderVersion.VCF3_3 && version != VCFHeaderVersion.VCF3_2 )
+                            throw new TribbleException.InvalidHeader("This codec is strictly for VCFv3 and does not support " + lineFields[1]);
+                    }
+                    headerStrings.add(line);
+                }
+                else if (line.startsWith(VCFHeader.HEADER_INDICATOR)) {
+                    if (!foundHeaderVersion) {
+                        throw new TribbleException.InvalidHeader("We never saw a header line specifying VCF version");
+                    }
+                    return createHeader(headerStrings, line);
+                }
+                else {
+                    throw new TribbleException.InvalidHeader("We never saw the required CHROM header line (starting with one #) for the input VCF file");
+                }
+
+            }
+        } catch (IOException e) {
+            throw new RuntimeException("IO Exception ", e);
+        }
+        throw new TribbleException.InvalidHeader("We never saw the required CHROM header line (starting with one #) for the input VCF file");
+    }
+
+
+    /**
+     * parse the filter string, first checking to see if we already have parsed it in a previous attempt
+     * @param filterString the string to parse
+     * @return a set of the filters applied
+     */
+    protected Set<String> parseFilters(String filterString) {
+
+        // null for unfiltered
+        if ( filterString.equals(VCFConstants.UNFILTERED) )
+            return null;
+
+        // empty set for passes filters
+        LinkedHashSet<String> fFields = new LinkedHashSet<String>();
+
+        if ( filterString.equals(VCFConstants.PASSES_FILTERS_v3) )
+            return fFields;
+
+        if ( filterString.length() == 0 )
+            generateException("The VCF specification requires a valid filter status");
+
+        // do we have the filter string cached?
+        if ( filterHash.containsKey(filterString) )
+            return filterHash.get(filterString);
+
+        // otherwise we have to parse and cache the value
+        if ( filterString.indexOf(VCFConstants.FILTER_CODE_SEPARATOR) == -1 )
+            fFields.add(filterString);
+        else
+            fFields.addAll(Arrays.asList(filterString.split(VCFConstants.FILTER_CODE_SEPARATOR)));
+
+        filterHash.put(filterString, fFields);
+
+        return fFields;
+    }
+
+    /**
+     * create a genotype map
+     * @param str the string
+     * @param alleles the list of alleles
+     * @param chr chrom
+     * @param pos position
+     * @return a mapping of sample name to genotype object
+     */
+    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+        if (genotypeParts == null)
+            genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
+
+        int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
+
+        Map<String, Genotype> genotypes = new LinkedHashMap<String, Genotype>(nParts);
+
+        // get the format keys
+        int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
+
+        // cycle through the sample names
+        Iterator<String> sampleNameIterator = header.getGenotypeSamples().iterator();
+
+        // clear out our allele mapping
+        alleleMap.clear();
+
+        // cycle through the genotype strings
+        for (int genotypeOffset = 1; genotypeOffset < nParts; genotypeOffset++) {
+            int GTValueSplitSize = ParsingUtils.split(genotypeParts[genotypeOffset], GTValueArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
+
+            double GTQual = VariantContext.NO_NEG_LOG_10PERROR;
+            Set<String> genotypeFilters = null;
+            Map<String, String> gtAttributes = null;
+            String sampleName = sampleNameIterator.next();
+
+            // check to see if the value list is longer than the key list, which is a problem
+            if (nGTKeys < GTValueSplitSize)
+                generateException("There are too many keys for the sample " + sampleName + ", keys = " + parts[8] + ", values = " + parts[genotypeOffset]);
+
+            int genotypeAlleleLocation = -1;
+            if (nGTKeys >= 1) {
+                gtAttributes = new HashMap<String, String>(nGTKeys - 1);
+
+                for (int i = 0; i < nGTKeys; i++) {
+                    final String gtKey = new String(genotypeKeyArray[i]);
+                    boolean missing = i >= GTValueSplitSize;
+
+                    if (gtKey.equals(VCFConstants.GENOTYPE_KEY)) {
+                        genotypeAlleleLocation = i;
+                    } else if (gtKey.equals(VCFConstants.GENOTYPE_QUALITY_KEY)) {
+                        GTQual = missing ? parseQual(VCFConstants.MISSING_VALUE_v4) : parseQual(GTValueArray[i]);
+                    } else if (gtKey.equals(VCFConstants.GENOTYPE_FILTER_KEY)) {
+                        genotypeFilters = missing ? parseFilters(VCFConstants.MISSING_VALUE_v4) : parseFilters(getCachedString(GTValueArray[i]));
+                    } else if ( missing || GTValueArray[i].equals(VCFConstants.MISSING_GENOTYPE_QUALITY_v3) ) {
+                        gtAttributes.put(gtKey, VCFConstants.MISSING_VALUE_v4);
+                    } else {
+                        gtAttributes.put(gtKey, new String(GTValueArray[i]));
+                    }
+                }
+            }
+
+            // check to make sure we found a genotype field
+            if ( genotypeAlleleLocation < 0 )
+                generateException("Unable to find the GT field for the record; the GT field is required");
+            if ( genotypeAlleleLocation > 0 )
+                generateException("Saw GT field at position " + genotypeAlleleLocation + ", but it must be at the first position for genotypes");
+
+            boolean phased = GTValueArray[genotypeAlleleLocation].indexOf(VCFConstants.PHASED) != -1;
+
+            // add it to the list
+            try {
+                genotypes.put(sampleName, new Genotype(sampleName,
+                        parseGenotypeAlleles(GTValueArray[genotypeAlleleLocation], alleles, alleleMap),
+                        GTQual,
+                        genotypeFilters,
+                        gtAttributes,
+                        phased));
+            } catch (TribbleException e) {
+                throw new TribbleException.InternalCodecException(e.getMessage() + ", at position " + chr+":"+pos);
+            }
+        }
+
+        return genotypes;
+    }
+
+    @Override
+    public boolean canDecode(final File potentialInput) {
+        return canDecodeFile(potentialInput, VCF3_MAGIC_HEADER);
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFAltHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFAltHeaderLine.java
new file mode 100644
index 000000000..e432fe411
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFAltHeaderLine.java
@@ -0,0 +1,28 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+/**
+ * @author ebanks
+ * A class representing a key=value entry for ALT fields in the VCF header
+ */
+class VCFAltHeaderLine extends VCFSimpleHeaderLine  {
+
+    /**
+     * create a VCF filter header line
+     *
+     * @param name         the name for this header line
+     * @param description  the description for this header line
+     */
+    public VCFAltHeaderLine(String name, String description) {
+        super(name, description, SupportedHeaderLineType.ALT);
+    }
+
+    /**
+     * create a VCF info header line
+     *
+     * @param line      the header line
+     * @param version   the vcf header version
+     */
+    protected VCFAltHeaderLine(String line, VCFHeaderVersion version) {
+        super(line, version, SupportedHeaderLineType.ALT);
+    }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCodec.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCodec.java
new file mode 100755
index 000000000..f873aebcc
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCodec.java
@@ -0,0 +1,228 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.broad.tribble.TribbleException;
+import org.broad.tribble.readers.LineReader;
+import org.broad.tribble.util.ParsingUtils;
+
+import java.io.File;
+import java.io.FileReader;
+import java.io.IOException;
+import java.util.*;
+
+/**
+ * A feature codec for the VCF 4 specification
+ *
+ * <p>
+ * VCF is a text file format (most likely stored in a compressed manner). It contains meta-information lines, a
+ * header line, and then data lines each containing information about a position in the genome.
+ * </p>
+ * <p>One of the main uses of next-generation sequencing is to discover variation amongst large populations
+ * of related samples. Recently the format for storing next-generation read alignments has been
+ * standardised by the SAM/BAM file format specification. This has significantly improved the
+ * interoperability of next-generation tools for alignment, visualisation, and variant calling.
+ * We propose the Variant Call Format (VCF) as a standarised format for storing the most prevalent
+ * types of sequence variation, including SNPs, indels and larger structural variants, together
+ * with rich annotations. VCF is usually stored in a compressed manner and can be indexed for
+ * fast data retrieval of variants from a range of positions on the reference genome.
+ * The format was developed for the 1000 Genomes Project, and has also been adopted by other projects
+ * such as UK10K, dbSNP, or the NHLBI Exome Project. VCFtools is a software suite that implements
+ * various utilities for processing VCF files, including validation, merging and comparing,
+ * and also provides a general Perl and Python API.
+ * The VCF specification and VCFtools are available from http://vcftools.sourceforge.net.</p>
+ *
+ * <p>
+ * See also: @see <a href="http://vcftools.sourceforge.net/specs.html">VCF specification</a><br>
+ * See also: @see <a href="http://www.ncbi.nlm.nih.gov/pubmed/21653522">VCF spec. publication</a>
+ * </p>
+ *
+ * <h2>File format example</h2>
+ * <pre>
+ *     ##fileformat=VCFv4.0
+ *     #CHROM  POS     ID      REF     ALT     QUAL    FILTER  INFO    FORMAT  NA12878
+ *     chr1    109     .       A       T       0       PASS  AC=1    GT:AD:DP:GL:GQ  0/1:610,327:308:-316.30,-95.47,-803.03:99
+ *     chr1    147     .       C       A       0       PASS  AC=1    GT:AD:DP:GL:GQ  0/1:294,49:118:-57.87,-34.96,-338.46:99
+ * </pre>
+ *
+ * @author Mark DePristo
+ * @since 2010
+ */
+public class VCFCodec extends AbstractVCFCodec {
+    // Our aim is to read in the records and convert to VariantContext as quickly as possible, relying on VariantContext to do the validation of any contradictory (or malformed) record parameters.
+
+    public final static String VCF4_MAGIC_HEADER = "##fileformat=VCFv4";
+
+    /**
+     * @param reader the line reader to take header lines from
+     * @return the number of header lines
+     */
+    public Object readHeader(LineReader reader) {
+        List<String> headerStrings = new ArrayList<String>();
+
+        String line;
+        try {
+            boolean foundHeaderVersion = false;
+            while ((line = reader.readLine()) != null) {
+                lineNo++;
+                if (line.startsWith(VCFHeader.METADATA_INDICATOR)) {
+                    String[] lineFields = line.substring(2).split("=");
+                    if (lineFields.length == 2 && VCFHeaderVersion.isFormatString(lineFields[0]) ) {
+                        if ( !VCFHeaderVersion.isVersionString(lineFields[1]) )
+                            throw new TribbleException.InvalidHeader(lineFields[1] + " is not a supported version");
+                        foundHeaderVersion = true;
+                        version = VCFHeaderVersion.toHeaderVersion(lineFields[1]);
+                        if ( version == VCFHeaderVersion.VCF3_3 || version == VCFHeaderVersion.VCF3_2 )
+                            throw new TribbleException.InvalidHeader("This codec is strictly for VCFv4; please use the VCF3 codec for " + lineFields[1]);
+                        if ( version != VCFHeaderVersion.VCF4_0 && version != VCFHeaderVersion.VCF4_1 )
+                            throw new TribbleException.InvalidHeader("This codec is strictly for VCFv4 and does not support " + lineFields[1]);
+                    }
+                    headerStrings.add(line);
+                }
+                else if (line.startsWith(VCFHeader.HEADER_INDICATOR)) {
+                    if (!foundHeaderVersion) {
+                        throw new TribbleException.InvalidHeader("We never saw a header line specifying VCF version");
+                    }
+                    return createHeader(headerStrings, line);
+                }
+                else {
+                    throw new TribbleException.InvalidHeader("We never saw the required CHROM header line (starting with one #) for the input VCF file");
+                }
+
+            }
+        } catch (IOException e) {
+            throw new RuntimeException("IO Exception ", e);
+        }
+        throw new TribbleException.InvalidHeader("We never saw the required CHROM header line (starting with one #) for the input VCF file");
+    }
+
+
+    /**
+     * parse the filter string, first checking to see if we already have parsed it in a previous attempt
+     *
+     * @param filterString the string to parse
+     * @return a set of the filters applied or null if filters were not applied to the record (e.g. as per the missing value in a VCF)
+     */
+    protected Set<String> parseFilters(String filterString) {
+        return parseFilters(filterHash, lineNo, filterString);
+    }
+
+    public static Set<String> parseFilters(final Map<String, LinkedHashSet<String>> cache, final int lineNo, final String filterString) {
+        // null for unfiltered
+        if ( filterString.equals(VCFConstants.UNFILTERED) )
+            return null;
+
+        if ( filterString.equals(VCFConstants.PASSES_FILTERS_v4) )
+            return Collections.emptySet();
+        if ( filterString.equals(VCFConstants.PASSES_FILTERS_v3) )
+            generateException(VCFConstants.PASSES_FILTERS_v3 + " is an invalid filter name in vcf4", lineNo);
+        if ( filterString.length() == 0 )
+            generateException("The VCF specification requires a valid filter status: filter was " + filterString, lineNo);
+
+        // do we have the filter string cached?
+        if ( cache != null && cache.containsKey(filterString) )
+            return Collections.unmodifiableSet(cache.get(filterString));
+
+        // empty set for passes filters
+        LinkedHashSet<String> fFields = new LinkedHashSet<String>();
+        // otherwise we have to parse and cache the value
+        if ( filterString.indexOf(VCFConstants.FILTER_CODE_SEPARATOR) == -1 )
+            fFields.add(filterString);
+        else
+            fFields.addAll(Arrays.asList(filterString.split(VCFConstants.FILTER_CODE_SEPARATOR)));
+
+        fFields = fFields;
+        if ( cache != null ) cache.put(filterString, fFields);
+
+        return Collections.unmodifiableSet(fFields);
+    }
+
+
+    /**
+     * create a genotype map
+     * @param str the string
+     * @param alleles the list of alleles
+     * @return a mapping of sample name to genotype object
+     */
+    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+        if (genotypeParts == null)
+            genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
+
+        int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
+
+        Map<String, Genotype> genotypes = new LinkedHashMap<String, Genotype>(nParts);
+
+        // get the format keys
+        int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
+
+        // cycle through the sample names
+        Iterator<String> sampleNameIterator = header.getGenotypeSamples().iterator();
+
+        // clear out our allele mapping
+        alleleMap.clear();
+
+        // cycle through the genotype strings
+        for (int genotypeOffset = 1; genotypeOffset < nParts; genotypeOffset++) {
+            int GTValueSplitSize = ParsingUtils.split(genotypeParts[genotypeOffset], GTValueArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
+
+            double GTQual = VariantContext.NO_NEG_LOG_10PERROR;
+            Set<String> genotypeFilters = null;
+            Map<String, String> gtAttributes = null;
+            String sampleName = sampleNameIterator.next();
+
+            // check to see if the value list is longer than the key list, which is a problem
+            if (nGTKeys < GTValueSplitSize)
+                generateException("There are too many keys for the sample " + sampleName + ", keys = " + parts[8] + ", values = " + parts[genotypeOffset]);
+
+            int genotypeAlleleLocation = -1;
+            if (nGTKeys >= 1) {
+                gtAttributes = new HashMap<String, String>(nGTKeys - 1);
+
+                for (int i = 0; i < nGTKeys; i++) {
+                    final String gtKey = new String(genotypeKeyArray[i]);
+                    boolean missing = i >= GTValueSplitSize;
+
+                    // todo -- all of these on the fly parsing of the missing value should be static constants
+                    if (gtKey.equals(VCFConstants.GENOTYPE_KEY)) {
+                        genotypeAlleleLocation = i;
+                    } else if (gtKey.equals(VCFConstants.GENOTYPE_QUALITY_KEY)) {
+                        GTQual = missing ? parseQual(VCFConstants.MISSING_VALUE_v4) : parseQual(GTValueArray[i]);
+                    } else if (gtKey.equals(VCFConstants.GENOTYPE_FILTER_KEY)) {
+                        genotypeFilters = missing ? parseFilters(VCFConstants.MISSING_VALUE_v4) : parseFilters(getCachedString(GTValueArray[i]));
+                    } else if ( missing ) {
+                        gtAttributes.put(gtKey, VCFConstants.MISSING_VALUE_v4);
+                    } else {
+                        gtAttributes.put(gtKey, new String(GTValueArray[i]));
+                    }
+                }
+            }
+
+            // check to make sure we found a genotype field if we are a VCF4.0 file
+            if ( version == VCFHeaderVersion.VCF4_0 && genotypeAlleleLocation == -1 )
+                generateException("Unable to find the GT field for the record; the GT field is required in VCF4.0");
+            if ( genotypeAlleleLocation > 0 )
+                generateException("Saw GT field at position " + genotypeAlleleLocation + ", but it must be at the first position for genotypes when present");
+
+            List<Allele> GTalleles = (genotypeAlleleLocation == -1 ? null : parseGenotypeAlleles(GTValueArray[genotypeAlleleLocation], alleles, alleleMap));
+            boolean phased = genotypeAlleleLocation != -1 && GTValueArray[genotypeAlleleLocation].indexOf(VCFConstants.PHASED) != -1;
+
+            // add it to the list
+            try {
+                genotypes.put(sampleName,
+                        new Genotype(sampleName,
+                                GTalleles,
+                                GTQual,
+                                genotypeFilters,
+                                gtAttributes,
+                                phased));
+            } catch (TribbleException e) {
+                throw new TribbleException.InternalCodecException(e.getMessage() + ", at position " + chr+":"+pos);
+            }
+        }
+
+        return genotypes;
+    }
+
+    @Override
+    public boolean canDecode(final File potentialInput) {
+        return canDecodeFile(potentialInput, VCF4_MAGIC_HEADER);
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCompoundHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCompoundHeaderLine.java
new file mode 100755
index 000000000..74d6cf62f
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCompoundHeaderLine.java
@@ -0,0 +1,224 @@
+/*
+ * Copyright (c) 2010, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+
+import java.util.Arrays;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+/**
+ * a base class for compound header lines, which include info lines and format lines (so far)
+ */
+abstract class VCFCompoundHeaderLine extends VCFHeaderLine implements VCFNamedHeaderLine {
+    public enum SupportedHeaderLineType {
+        INFO(true), FORMAT(false);
+
+        public final boolean allowFlagValues;
+        SupportedHeaderLineType(boolean flagValues) {
+            allowFlagValues = flagValues;
+        }
+    }
+
+    // the field types
+    private String name;
+    private int count = -1;
+    private VCFHeaderLineCount countType;
+    private String description;
+    private VCFHeaderLineType type;
+
+    // access methods
+    public String getName() { return name; }
+    public String getDescription() { return description; }
+    public VCFHeaderLineType getType() { return type; }
+    public VCFHeaderLineCount getCountType() { return countType; }
+    public int getCount() {
+        if ( countType != VCFHeaderLineCount.INTEGER )
+            throw new ReviewedStingException("Asking for header line count when type is not an integer");
+        return count;
+    }
+
+    // utility method
+    public int getCount(int numAltAlleles) {
+        int myCount;
+        switch ( countType ) {
+            case INTEGER: myCount = count; break;
+            case UNBOUNDED: myCount = -1; break;
+            case A: myCount = numAltAlleles; break;
+            case G: myCount = ((numAltAlleles + 1) * (numAltAlleles + 2) / 2); break;
+            default: throw new ReviewedStingException("Unknown count type: " + countType);
+        }
+        return myCount;
+    }
+
+    public void setNumberToUnbounded() {
+        countType = VCFHeaderLineCount.UNBOUNDED;
+        count = -1;
+    }
+
+    // our type of line, i.e. format, info, etc
+    private final SupportedHeaderLineType lineType;
+
+    /**
+     * create a VCF format header line
+     *
+     * @param name         the name for this header line
+     * @param count        the count for this header line
+     * @param type         the type for this header line
+     * @param description  the description for this header line
+     * @param lineType     the header line type
+     */
+    protected VCFCompoundHeaderLine(String name, int count, VCFHeaderLineType type, String description, SupportedHeaderLineType lineType) {
+        super(lineType.toString(), "");
+        this.name = name;
+        this.countType = VCFHeaderLineCount.INTEGER;
+        this.count = count;
+        this.type = type;
+        this.description = description;
+        this.lineType = lineType;
+        validate();
+    }
+
+    /**
+     * create a VCF format header line
+     *
+     * @param name         the name for this header line
+     * @param count        the count type for this header line
+     * @param type         the type for this header line
+     * @param description  the description for this header line
+     * @param lineType     the header line type
+     */
+    protected VCFCompoundHeaderLine(String name, VCFHeaderLineCount count, VCFHeaderLineType type, String description, SupportedHeaderLineType lineType) {
+        super(lineType.toString(), "");
+        this.name = name;
+        this.countType = count;
+        this.type = type;
+        this.description = description;
+        this.lineType = lineType;
+        validate();
+    }
+
+    /**
+     * create a VCF format header line
+     *
+     * @param line   the header line
+     * @param version      the VCF header version
+     * @param lineType     the header line type
+     *
+     */
+    protected VCFCompoundHeaderLine(String line, VCFHeaderVersion version, SupportedHeaderLineType lineType) {
+        super(lineType.toString(), "");
+        Map<String,String> mapping = VCFHeaderLineTranslator.parseLine(version,line, Arrays.asList("ID","Number","Type","Description"));
+        name = mapping.get("ID");
+        count = -1;
+        final String numberStr = mapping.get("Number");
+        if ( numberStr.equals(VCFConstants.PER_ALLELE_COUNT) ) {
+            countType = VCFHeaderLineCount.A;
+        } else if ( numberStr.equals(VCFConstants.PER_GENOTYPE_COUNT) ) {
+            countType = VCFHeaderLineCount.G;
+        } else if ( ((version == VCFHeaderVersion.VCF4_0 || version == VCFHeaderVersion.VCF4_1) &&
+                     numberStr.equals(VCFConstants.UNBOUNDED_ENCODING_v4)) ||
+                    ((version == VCFHeaderVersion.VCF3_2 || version == VCFHeaderVersion.VCF3_3) &&
+                     numberStr.equals(VCFConstants.UNBOUNDED_ENCODING_v3)) ) {
+            countType = VCFHeaderLineCount.UNBOUNDED;
+        } else {
+            countType = VCFHeaderLineCount.INTEGER;
+            count = Integer.valueOf(numberStr);
+
+        }
+        type = VCFHeaderLineType.valueOf(mapping.get("Type"));
+        if (type == VCFHeaderLineType.Flag && !allowFlagValues())
+            throw new IllegalArgumentException("Flag is an unsupported type for this kind of field");
+
+        description = mapping.get("Description");
+        if ( description == null && ALLOW_UNBOUND_DESCRIPTIONS ) // handle the case where there's no description provided
+            description = UNBOUND_DESCRIPTION;
+        
+        this.lineType = lineType;
+
+        validate();
+    }
+
+    private void validate() {
+        if ( name == null || type == null || description == null || lineType == null )
+            throw new IllegalArgumentException(String.format("Invalid VCFCompoundHeaderLine: key=%s name=%s type=%s desc=%s lineType=%s", 
+                    super.getKey(), name, type, description, lineType ));
+    }
+
+    /**
+     * make a string representation of this header line
+     * @return a string representation
+     */
+    protected String toStringEncoding() {
+        Map<String,Object> map = new LinkedHashMap<String,Object>();
+        map.put("ID", name);
+        Object number;
+        switch ( countType ) {
+            case A: number = VCFConstants.PER_ALLELE_COUNT; break;
+            case G: number = VCFConstants.PER_GENOTYPE_COUNT; break;
+            case UNBOUNDED: number = VCFConstants.UNBOUNDED_ENCODING_v4; break;
+            case INTEGER:
+            default: number = count;
+        }
+        map.put("Number", number);
+        map.put("Type", type);
+        map.put("Description", description);
+        return lineType.toString() + "=" + toStringEncoding(map);
+    }
+
+    /**
+     * returns true if we're equal to another compounder header line
+     * @param o a compound header line
+     * @return true if equal
+     */
+    public boolean equals(Object o) {
+        if ( !(o instanceof VCFCompoundHeaderLine) )
+            return false;
+        VCFCompoundHeaderLine other = (VCFCompoundHeaderLine)o;
+        return equalsExcludingDescription(other) &&
+                description.equals(other.description);
+    }
+
+    public boolean equalsExcludingDescription(VCFCompoundHeaderLine other) {
+        return count == other.count &&
+                countType == other.countType &&
+                type == other.type &&
+                lineType == other.lineType &&
+                name.equals(other.name);
+    }
+
+    public boolean sameLineTypeAndName(VCFCompoundHeaderLine other) {
+        return  lineType == other.lineType &&
+                name.equals(other.name);
+    }
+
+    /**
+     * do we allow flag (boolean) values? (i.e. booleans where you don't have specify the value, AQ means AQ=true)
+     * @return true if we do, false otherwise
+     */
+    abstract boolean allowFlagValues();
+
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFConstants.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFConstants.java
new file mode 100755
index 000000000..91f6b1ba9
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFConstants.java
@@ -0,0 +1,112 @@
+/*
+ * Copyright (c) 2010.
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+ * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import java.util.Locale;
+
+final class VCFConstants {
+    public static final Locale VCF_LOCALE = Locale.US;
+
+    // reserved INFO/FORMAT field keys
+    public static final String ANCESTRAL_ALLELE_KEY = "AA";
+    public static final String ALLELE_COUNT_KEY = "AC";
+    public static final String ALLELE_FREQUENCY_KEY = "AF";
+    public static final String ALLELE_NUMBER_KEY = "AN";
+    public static final String RMS_BASE_QUALITY_KEY = "BQ";
+    public static final String CIGAR_KEY = "CIGAR";
+    public static final String DBSNP_KEY = "DB";
+    public static final String DEPTH_KEY = "DP";
+    public static final String DOWNSAMPLED_KEY = "DS";
+    public static final String EXPECTED_ALLELE_COUNT_KEY = "EC";
+    public static final String END_KEY = "END";
+    public static final String GENOTYPE_FILTER_KEY = "FT";
+    public static final String GENOTYPE_KEY = "GT";
+    @Deprecated
+    public static final String GENOTYPE_LIKELIHOODS_KEY = "GL";         // log10 scaled genotype likelihoods
+    public static final String GENOTYPE_POSTERIORS_KEY = "GP";
+    public static final String GENOTYPE_QUALITY_KEY = "GQ";
+    public static final String HAPMAP2_KEY = "H2";
+    public static final String HAPMAP3_KEY = "H3";
+    public static final String HAPLOTYPE_QUALITY_KEY = "HQ";
+    public static final String RMS_MAPPING_QUALITY_KEY = "MQ";
+    public static final String MAPPING_QUALITY_ZERO_KEY = "MQ0";
+    public static final String SAMPLE_NUMBER_KEY = "NS";
+    public static final String PHRED_GENOTYPE_LIKELIHOODS_KEY = "PL";   // phred-scaled genotype likelihoods
+    public static final String PHASE_QUALITY_KEY = "PQ";
+    public static final String PHASE_SET_KEY = "PS";
+    public static final String OLD_DEPTH_KEY = "RD";
+    public static final String STRAND_BIAS_KEY = "SB";
+    public static final String SOMATIC_KEY = "SOMATIC";
+    public static final String VALIDATED_KEY = "VALIDATED";
+    public static final String THOUSAND_GENOMES_KEY = "1000G";
+
+    // separators
+    public static final String FORMAT_FIELD_SEPARATOR = ":";
+    public static final String GENOTYPE_FIELD_SEPARATOR = ":";
+    public static final char   GENOTYPE_FIELD_SEPARATOR_CHAR = ':';
+    public static final String FIELD_SEPARATOR = "\t";
+    public static final char   FIELD_SEPARATOR_CHAR = '\t';
+    public static final String FILTER_CODE_SEPARATOR = ";";
+    public static final String INFO_FIELD_ARRAY_SEPARATOR = ",";
+    public static final char INFO_FIELD_ARRAY_SEPARATOR_CHAR = ',';
+    public static final String ID_FIELD_SEPARATOR = ";";
+    public static final String INFO_FIELD_SEPARATOR = ";";
+    public static final char INFO_FIELD_SEPARATOR_CHAR = ';';
+    public static final String UNPHASED = "/";
+    public static final String PHASED = "|";
+    public static final String PHASED_SWITCH_PROB_v3 = "\\";
+    public static final String PHASING_TOKENS = "/|\\";
+
+    // old indel alleles
+    public static final char DELETION_ALLELE_v3 = 'D';
+    public static final char INSERTION_ALLELE_v3 = 'I';
+
+    // missing/default values
+    public static final String UNFILTERED = ".";
+    public static final String PASSES_FILTERS_v3 = "0";
+    public static final String PASSES_FILTERS_v4 = "PASS";
+    public static final String EMPTY_ID_FIELD = ".";
+    public static final String EMPTY_INFO_FIELD = ".";
+    public static final String EMPTY_ALTERNATE_ALLELE_FIELD = ".";
+    public static final String MISSING_VALUE_v4 = ".";
+    public static final String MISSING_QUALITY_v3 = "-1";
+    public static final Double MISSING_QUALITY_v3_DOUBLE = Double.valueOf(MISSING_QUALITY_v3);
+
+    public static final String MISSING_GENOTYPE_QUALITY_v3 = "-1";
+    public static final String MISSING_HAPLOTYPE_QUALITY_v3 = "-1";
+    public static final String MISSING_DEPTH_v3 = "-1";
+    public static final String UNBOUNDED_ENCODING_v4 = ".";
+    public static final String UNBOUNDED_ENCODING_v3 = "-1";
+    public static final String PER_ALLELE_COUNT = "A";
+    public static final String PER_GENOTYPE_COUNT = "G";
+    public static final String EMPTY_ALLELE = ".";
+    public static final String EMPTY_GENOTYPE = "./.";
+    public static final double MAX_GENOTYPE_QUAL = 99.0;
+
+    public static final String DOUBLE_PRECISION_FORMAT_STRING = "%.2f";
+    public static final String DOUBLE_PRECISION_INT_SUFFIX = ".00";
+    public static final Double VCF_ENCODING_EPSILON = 0.00005; // when we consider fields equal(), used in the Qual compare
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFilterHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFilterHeaderLine.java
new file mode 100755
index 000000000..5e16fbed0
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFilterHeaderLine.java
@@ -0,0 +1,28 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+/**
+ * @author ebanks
+ * A class representing a key=value entry for FILTER fields in the VCF header
+ */
+class VCFFilterHeaderLine extends VCFSimpleHeaderLine  {
+
+    /**
+     * create a VCF filter header line
+     *
+     * @param name         the name for this header line
+     * @param description  the description for this header line
+     */
+    public VCFFilterHeaderLine(String name, String description) {
+        super(name, description, SupportedHeaderLineType.FILTER);
+    }
+
+    /**
+     * create a VCF info header line
+     *
+     * @param line      the header line
+     * @param version   the vcf header version
+     */
+    protected VCFFilterHeaderLine(String line, VCFHeaderVersion version) {
+        super(line, version, SupportedHeaderLineType.FILTER);
+    }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFormatHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFormatHeaderLine.java
new file mode 100755
index 000000000..f73c032cc
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFormatHeaderLine.java
@@ -0,0 +1,32 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+
+/**
+ * @author ebanks
+ *         <p/>
+ *         Class VCFFormatHeaderLine
+ *         <p/>
+ *         A class representing a key=value entry for genotype FORMAT fields in the VCF header
+ */
+class VCFFormatHeaderLine extends VCFCompoundHeaderLine {
+
+    public VCFFormatHeaderLine(String name, int count, VCFHeaderLineType type, String description) {
+        super(name, count, type, description, SupportedHeaderLineType.FORMAT);
+        if (type == VCFHeaderLineType.Flag)
+            throw new IllegalArgumentException("Flag is an unsupported type for format fields");
+    }
+
+    public VCFFormatHeaderLine(String name, VCFHeaderLineCount count, VCFHeaderLineType type, String description) {
+        super(name, count, type, description, SupportedHeaderLineType.FORMAT);
+    }
+
+    protected VCFFormatHeaderLine(String line, VCFHeaderVersion version) {
+        super(line, version, SupportedHeaderLineType.FORMAT);
+    }
+
+    // format fields do not allow flag values (that wouldn't make much sense, how would you encode this in the genotype).
+    @Override
+    boolean allowFlagValues() {
+        return false;
+    }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeader.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeader.java
new file mode 100755
index 000000000..be1b49ec1
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeader.java
@@ -0,0 +1,198 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+
+import org.broad.tribble.util.ParsingUtils;
+
+import java.util.*;
+
+
+/**
+ * @author aaron
+ *         <p/>
+ *         Class VCFHeader
+ *         <p/>
+ *         A class representing the VCF header
+ */
+class VCFHeader {
+
+    // the mandatory header fields
+    public enum HEADER_FIELDS {
+        CHROM, POS, ID, REF, ALT, QUAL, FILTER, INFO
+    }
+
+    // the associated meta data
+    private final Set<VCFHeaderLine> mMetaData;
+    private final Map<String, VCFInfoHeaderLine> mInfoMetaData = new HashMap<String, VCFInfoHeaderLine>();
+    private final Map<String, VCFFormatHeaderLine> mFormatMetaData = new HashMap<String, VCFFormatHeaderLine>();
+    private final Map<String, VCFHeaderLine> mOtherMetaData = new HashMap<String, VCFHeaderLine>();
+
+    // the list of auxillary tags
+    private final Set<String> mGenotypeSampleNames = new LinkedHashSet<String>();
+
+    // the character string that indicates meta data
+    public static final String METADATA_INDICATOR = "##";
+
+    // the header string indicator
+    public static final String HEADER_INDICATOR = "#";
+
+    // were the input samples sorted originally (or are we sorting them)?
+    private boolean samplesWereAlreadySorted = true;
+
+
+    /**
+     * create a VCF header, given a list of meta data and auxillary tags
+     *
+     * @param metaData     the meta data associated with this header
+     */
+    public VCFHeader(Set<VCFHeaderLine> metaData) {
+        mMetaData = new TreeSet<VCFHeaderLine>(metaData);
+        loadVCFVersion();
+        loadMetaDataMaps();
+    }
+
+    /**
+     * create a VCF header, given a list of meta data and auxillary tags
+     *
+     * @param metaData            the meta data associated with this header
+     * @param genotypeSampleNames the sample names
+     */
+    public VCFHeader(Set<VCFHeaderLine> metaData, Set<String> genotypeSampleNames) {
+        mMetaData = new TreeSet<VCFHeaderLine>();
+        if ( metaData != null )
+            mMetaData.addAll(metaData);
+
+        mGenotypeSampleNames.addAll(genotypeSampleNames);
+
+        loadVCFVersion();
+        loadMetaDataMaps();
+
+        samplesWereAlreadySorted = ParsingUtils.isSorted(genotypeSampleNames);
+    }
+
+    /**
+     * Adds a header line to the header metadata.
+     *
+     * @param headerLine Line to add to the existing metadata component.
+     */
+    public void addMetaDataLine(VCFHeaderLine headerLine) {
+        mMetaData.add(headerLine);    
+    }
+
+    /**
+     * check our metadata for a VCF version tag, and throw an exception if the version is out of date
+     * or the version is not present
+     */
+    public void loadVCFVersion() {
+        List<VCFHeaderLine> toRemove = new ArrayList<VCFHeaderLine>();
+        for ( VCFHeaderLine line : mMetaData )
+            if ( VCFHeaderVersion.isFormatString(line.getKey())) {
+                toRemove.add(line);
+            }
+        // remove old header lines for now,
+        mMetaData.removeAll(toRemove);
+
+    }
+
+    /**
+     * load the format/info meta data maps (these are used for quick lookup by key name)
+     */
+    private void loadMetaDataMaps() {
+        for ( VCFHeaderLine line : mMetaData ) {
+            if ( line instanceof VCFInfoHeaderLine )  {
+                VCFInfoHeaderLine infoLine = (VCFInfoHeaderLine)line;
+                mInfoMetaData.put(infoLine.getName(), infoLine);
+            }
+            else if ( line instanceof VCFFormatHeaderLine ) {
+                VCFFormatHeaderLine formatLine = (VCFFormatHeaderLine)line;
+                mFormatMetaData.put(formatLine.getName(), formatLine);
+            }
+            else {
+                mOtherMetaData.put(line.getKey(), line);
+            }
+        }
+    }
+
+    /**
+     * get the header fields in order they're presented in the input file (which is now required to be
+     * the order presented in the spec).
+     *
+     * @return a set of the header fields, in order
+     */
+    public Set<HEADER_FIELDS> getHeaderFields() {
+        Set<HEADER_FIELDS> fields = new LinkedHashSet<HEADER_FIELDS>();
+        for (HEADER_FIELDS field : HEADER_FIELDS.values())
+            fields.add(field);
+        return fields;
+    }
+
+    /**
+     * get the meta data, associated with this header
+     *
+     * @return a set of the meta data
+     */
+    public Set<VCFHeaderLine> getMetaData() {
+        Set<VCFHeaderLine> lines = new LinkedHashSet<VCFHeaderLine>();
+        lines.add(new VCFHeaderLine(VCFHeaderVersion.VCF4_0.getFormatString(), VCFHeaderVersion.VCF4_0.getVersionString()));
+        lines.addAll(mMetaData);
+        return Collections.unmodifiableSet(lines);
+    }
+
+    /**
+     * get the genotyping sample names
+     *
+     * @return a list of the genotype column names, which may be empty if hasGenotypingData() returns false
+     */
+    public Set<String> getGenotypeSamples() {
+        return mGenotypeSampleNames;
+    }
+
+    /**
+     * do we have genotyping data?
+     *
+     * @return true if we have genotyping columns, false otherwise
+     */
+    public boolean hasGenotypingData() {
+        return mGenotypeSampleNames.size() > 0;
+    }
+
+    /**
+     * were the input samples sorted originally?
+     *
+     * @return true if the input samples were sorted originally, false otherwise
+     */
+    public boolean samplesWereAlreadySorted() {
+        return samplesWereAlreadySorted;
+    }
+
+    /** @return the column count */
+    public int getColumnCount() {
+        return HEADER_FIELDS.values().length + (hasGenotypingData() ? mGenotypeSampleNames.size() + 1 : 0);
+    }
+
+    /**
+     * @param key    the header key name
+     * @return the meta data line, or null if there is none
+     */
+    public VCFInfoHeaderLine getInfoHeaderLine(String key) {
+        return mInfoMetaData.get(key);
+    }
+
+    /**
+     * @param key    the header key name
+     * @return the meta data line, or null if there is none
+     */
+    public VCFFormatHeaderLine getFormatHeaderLine(String key) {
+        return mFormatMetaData.get(key);
+    }
+
+    /**
+     * @param key    the header key name
+     * @return the meta data line, or null if there is none
+     */
+    public VCFHeaderLine getOtherHeaderLine(String key) {
+        return mOtherMetaData.get(key);
+    }
+}
+
+
+
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLine.java
new file mode 100755
index 000000000..61b0722bd
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLine.java
@@ -0,0 +1,134 @@
+/*
+ * Copyright (c) 2010.
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+ * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.broad.tribble.TribbleException;
+
+import java.util.Map;
+
+
+/**
+ * @author ebanks
+ *         <p/>
+ *         Class VCFHeaderLine
+ *         <p/>
+ *         A class representing a key=value entry in the VCF header
+ */
+class VCFHeaderLine implements Comparable {
+    protected static boolean ALLOW_UNBOUND_DESCRIPTIONS = true;
+    protected static String UNBOUND_DESCRIPTION = "Not provided in original VCF header";
+
+    private String mKey = null;
+    private String mValue = null;
+
+
+    /**
+     * create a VCF header line
+     *
+     * @param key     the key for this header line
+     * @param value   the value for this header line
+     */
+    public VCFHeaderLine(String key, String value) {
+        if ( key == null )
+            throw new IllegalArgumentException("VCFHeaderLine: key cannot be null: key = " + key);
+        mKey = key;
+        mValue = value;
+    }
+
+    /**
+     * Get the key
+     *
+     * @return the key
+     */
+    public String getKey() {
+        return mKey;
+    }
+
+    /**
+     * Get the value
+     *
+     * @return the value
+     */
+    public String getValue() {
+        return mValue;
+    }
+
+    public String toString() {
+        return toStringEncoding();
+    }
+
+    /**
+     * Should be overloaded in sub classes to do subclass specific
+     *
+     * @return the string encoding
+     */
+    protected String toStringEncoding() {
+        return mKey + "=" + mValue;
+    }
+
+    public boolean equals(Object o) {
+        if ( !(o instanceof VCFHeaderLine) )
+            return false;
+        return mKey.equals(((VCFHeaderLine)o).getKey()) && mValue.equals(((VCFHeaderLine)o).getValue());
+    }
+
+    public int compareTo(Object other) {
+        return toString().compareTo(other.toString());
+    }
+
+    /**
+     * @param line    the line
+     * @return true if the line is a VCF meta data line, or false if it is not
+     */
+    public static boolean isHeaderLine(String line) {
+        return line != null && line.length() > 0 && VCFHeader.HEADER_INDICATOR.equals(line.substring(0,1));
+    }
+
+    /**
+     * create a string of a mapping pair for the target VCF version
+     * @param keyValues a mapping of the key->value pairs to output
+     * @return a string, correctly formatted
+     */
+    public static String toStringEncoding(Map<String, ? extends Object> keyValues) {
+        StringBuilder builder = new StringBuilder();
+        builder.append("<");
+        boolean start = true;
+        for (Map.Entry<String,?> entry : keyValues.entrySet()) {
+            if (start) start = false;
+            else builder.append(",");
+
+            if ( entry.getValue() == null ) throw new TribbleException.InternalCodecException("Header problem: unbound value at " + entry + " from " + keyValues);
+
+            builder.append(entry.getKey());
+            builder.append("=");
+            builder.append(entry.getValue().toString().contains(",") ||
+                           entry.getValue().toString().contains(" ") ||
+                           entry.getKey().equals("Description") ? "\""+ entry.getValue() + "\"" : entry.getValue());
+        }
+        builder.append(">");
+        return builder.toString();
+    }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineCount.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineCount.java
new file mode 100644
index 000000000..8fd29d188
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineCount.java
@@ -0,0 +1,8 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+/**
+ * the count encodings we use for fields in VCF header lines
+ */
+public enum VCFHeaderLineCount {
+    INTEGER, A, G, UNBOUNDED;
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineTranslator.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineTranslator.java
new file mode 100755
index 000000000..538b4ff8e
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineTranslator.java
@@ -0,0 +1,124 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import java.util.*;
+
+/**
+ * A class for translating between vcf header versions
+ */
+public class VCFHeaderLineTranslator {
+    private static Map<VCFHeaderVersion,VCFLineParser> mapping;
+
+    static {
+        mapping = new HashMap<VCFHeaderVersion,VCFLineParser>();
+        mapping.put(VCFHeaderVersion.VCF4_0,new VCF4Parser());
+        mapping.put(VCFHeaderVersion.VCF4_1,new VCF4Parser());
+        mapping.put(VCFHeaderVersion.VCF3_3,new VCF3Parser());
+        mapping.put(VCFHeaderVersion.VCF3_2,new VCF3Parser());
+    }
+
+    public static Map<String,String> parseLine(VCFHeaderVersion version, String valueLine, List<String> expectedTagOrder) {
+        return mapping.get(version).parseLine(valueLine,expectedTagOrder);
+    }
+}
+
+
+interface VCFLineParser {
+    public Map<String,String> parseLine(String valueLine, List<String> expectedTagOrder);
+}
+
+
+/**
+ * a class that handles the to and from disk for VCF 4 lines
+ */
+class VCF4Parser implements VCFLineParser {
+    Set<String> bracketed = new HashSet<String>();
+
+    /**
+     * parse a VCF4 line
+     * @param valueLine the line
+     * @return a mapping of the tags parsed out
+     */
+    public Map<String, String> parseLine(String valueLine, List<String> expectedTagOrder) {
+        // our return map
+        Map<String, String> ret = new LinkedHashMap<String, String>();
+
+        // a builder to store up characters as we go
+        StringBuilder builder = new StringBuilder();
+
+        // store the key when we're parsing out the values
+        String key = "";
+
+        // where are we in the stream of characters?
+        int index = 0;
+
+        // are we inside a quotation? we don't special case ',' then
+        boolean inQuote = false;
+
+        // a little switch machine to parse out the tags. Regex ended up being really complicated and ugly [yes, but this machine is getting ugly now... MAD]
+        for (char c: valueLine.toCharArray()) {
+            if ( c == '\"' ) {
+                inQuote = ! inQuote;
+            } else if ( inQuote ) {
+                builder.append(c);
+            } else {
+                switch (c) {
+                    case ('<') : if (index == 0) break; // if we see a open bracket at the beginning, ignore it
+                    case ('>') : if (index == valueLine.length()-1) ret.put(key,builder.toString().trim()); break; // if we see a close bracket, and we're at the end, add an entry to our list
+                    case ('=') : key = builder.toString().trim(); builder = new StringBuilder(); break; // at an equals, copy the key and reset the builder
+                    case (',') : ret.put(key,builder.toString().trim()); builder = new StringBuilder(); break; // drop the current key value to the return map
+                    default: builder.append(c); // otherwise simply append to the current string
+                }
+            }
+            
+            index++;
+        }
+
+        // validate the tags against the expected list
+        index = 0;
+        if (ret.size() > expectedTagOrder.size()) throw new IllegalArgumentException("Unexpected tag count " + ret.size() + " in string " + expectedTagOrder.size());
+        for (String str : ret.keySet()) {
+            if (!expectedTagOrder.get(index).equals(str)) throw new IllegalArgumentException("Unexpected tag " + str + " in string " + valueLine);
+            index++;
+        }
+        return ret;
+    }
+}
+
+class VCF3Parser implements VCFLineParser {
+
+    public Map<String, String> parseLine(String valueLine, List<String> expectedTagOrder) {
+        // our return map
+        Map<String, String> ret = new LinkedHashMap<String, String>();
+
+        // a builder to store up characters as we go
+        StringBuilder builder = new StringBuilder();
+
+        // where are we in the stream of characters?
+        int index = 0;
+        // where in the expected tag order are we?
+        int tagIndex = 0;
+
+        // are we inside a quotation? we don't special case ',' then
+        boolean inQuote = false;
+
+        // a little switch machine to parse out the tags. Regex ended up being really complicated and ugly
+        for (char c: valueLine.toCharArray()) {
+            switch (c) {
+                case ('\"') : inQuote = !inQuote; break; // a quote means we ignore ',' in our strings, keep track of it
+                case (',') : if (!inQuote) { ret.put(expectedTagOrder.get(tagIndex++),builder.toString()); builder = new StringBuilder(); break; } // drop the current key value to the return map
+                default: builder.append(c); // otherwise simply append to the current string
+            }
+            index++;
+        }
+        ret.put(expectedTagOrder.get(tagIndex++),builder.toString());
+        
+        // validate the tags against the expected list
+        index = 0;
+        if (tagIndex != expectedTagOrder.size()) throw new IllegalArgumentException("Unexpected tag count " + tagIndex + ", we expected " + expectedTagOrder.size());
+        for (String str : ret.keySet()){
+            if (!expectedTagOrder.get(index).equals(str)) throw new IllegalArgumentException("Unexpected tag " + str + " in string " + valueLine);
+            index++;
+        }
+        return ret;
+    }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineType.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineType.java
new file mode 100755
index 000000000..65cf1a327
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineType.java
@@ -0,0 +1,8 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+/**
+ * the type encodings we use for fields in VCF header lines
+ */
+enum VCFHeaderLineType {
+    Integer, Float, String, Character, Flag;
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderVersion.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderVersion.java
new file mode 100755
index 000000000..21e737abe
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderVersion.java
@@ -0,0 +1,91 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.broad.tribble.TribbleException;
+
+/**
+ * information that identifies each header version
+ */
+enum VCFHeaderVersion {
+    VCF3_2("VCRv3.2","format"),
+    VCF3_3("VCFv3.3","fileformat"),
+    VCF4_0("VCFv4.0","fileformat"),
+    VCF4_1("VCFv4.1","fileformat");
+
+    private final String versionString;
+    private final String formatString;
+
+    /**
+     * create the enum, privately, using:
+     * @param vString the version string
+     * @param fString the format string
+     */
+    VCFHeaderVersion(String vString, String fString) {
+        this.versionString = vString;
+        this.formatString = fString;
+    }
+
+    /**
+     * get the header version
+     * @param version the version string
+     * @return a VCFHeaderVersion object
+     */
+    public static VCFHeaderVersion toHeaderVersion(String version) {
+        version = clean(version);
+        for (VCFHeaderVersion hv : VCFHeaderVersion.values())
+            if (hv.versionString.equals(version))
+                    return hv;
+        return null;
+    }
+
+    /**
+     * are we a valid version string of some type
+     * @param version the version string
+     * @return true if we're valid of some type, false otherwise
+     */
+    public static boolean isVersionString(String version){
+        return toHeaderVersion(version) != null;
+    }
+
+    /**
+     * are we a valid format string for some type
+     * @param format the format string
+     * @return true if we're valid of some type, false otherwise
+     */
+    public static boolean isFormatString(String format){
+        format = clean(format);
+        for (VCFHeaderVersion hv : VCFHeaderVersion.values())
+            if (hv.formatString.equals(format))
+                    return true;
+        return false;
+    }
+
+    public static VCFHeaderVersion getHeaderVersion(String versionLine) {
+        String[] lineFields = versionLine.split("=");
+        if ( lineFields.length != 2 || !isFormatString(lineFields[0].substring(2)) )
+            throw new TribbleException.InvalidHeader(versionLine + " is not a valid VCF version line");
+
+        if ( !isVersionString(lineFields[1]) )
+            throw new TribbleException.InvalidHeader(lineFields[1] + " is not a supported version");
+
+        return toHeaderVersion(lineFields[1]);
+    }
+
+    /**
+     * Utility function to clean up a VCF header string
+     * 
+     * @param s string
+     * @return  trimmed version of s
+     */
+    private static String clean(String s) {
+        return s.trim();
+    }
+
+
+    public String getVersionString() {
+        return versionString;
+    }
+
+    public String getFormatString() {
+        return formatString;
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFInfoHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFInfoHeaderLine.java
new file mode 100755
index 000000000..642a78b76
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFInfoHeaderLine.java
@@ -0,0 +1,29 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+
+/**
+ * @author ebanks
+ *         <p/>
+ *         Class VCFInfoHeaderLine
+ *         <p/>
+ *         A class representing a key=value entry for INFO fields in the VCF header
+ */
+class VCFInfoHeaderLine extends VCFCompoundHeaderLine {
+    public VCFInfoHeaderLine(String name, int count, VCFHeaderLineType type, String description) {
+        super(name, count, type, description, SupportedHeaderLineType.INFO);
+    }
+
+    public VCFInfoHeaderLine(String name, VCFHeaderLineCount count, VCFHeaderLineType type, String description) {
+        super(name, count, type, description, SupportedHeaderLineType.INFO);
+    }
+
+    protected VCFInfoHeaderLine(String line, VCFHeaderVersion version) {
+        super(line, version, SupportedHeaderLineType.INFO);
+    }
+
+    // info fields allow flag values
+    @Override
+    boolean allowFlagValues() {
+        return true;
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFNamedHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFNamedHeaderLine.java
new file mode 100755
index 000000000..b3ce5d841
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFNamedHeaderLine.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright (c) 2010, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+/** an interface for named header lines **/
+interface VCFNamedHeaderLine {
+    String getName();
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFParser.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFParser.java
new file mode 100755
index 000000000..95a3f7bf1
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFParser.java
@@ -0,0 +1,22 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import java.util.List;
+import java.util.Map;
+
+
+/**
+ * All VCF codecs need to implement this interface so that we can perform lazy loading.
+ */
+interface VCFParser {
+
+    /**
+     * create a genotype map
+     * @param str the string
+     * @param alleles the list of alleles
+     * @param chr chrom
+     * @param pos position
+     * @return a mapping of sample name to genotype object
+     */
+    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFSimpleHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFSimpleHeaderLine.java
new file mode 100644
index 000000000..17706c705
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFSimpleHeaderLine.java
@@ -0,0 +1,81 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import java.util.Arrays;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+
+/**
+ * @author ebanks
+ * A class representing a key=value entry for simple VCF header types
+ */
+abstract class VCFSimpleHeaderLine extends VCFHeaderLine implements VCFNamedHeaderLine  {
+
+    public enum SupportedHeaderLineType {
+        FILTER, ALT;
+    }
+
+    private String name;
+    private String description;
+
+    // our type of line, i.e. filter, alt, etc
+    private final SupportedHeaderLineType lineType;
+
+
+    /**
+     * create a VCF filter header line
+     *
+     * @param name         the name for this header line
+     * @param description  the description for this header line
+     * @param lineType     the header line type
+     */
+    public VCFSimpleHeaderLine(String name, String description, SupportedHeaderLineType lineType) {
+        super(lineType.toString(), "");
+        this.lineType = lineType;
+        this.name = name;
+        this.description = description;
+
+        if ( name == null || description == null )
+            throw new IllegalArgumentException(String.format("Invalid VCFSimpleHeaderLine: key=%s name=%s desc=%s", super.getKey(), name, description ));
+    }
+
+    /**
+     * create a VCF info header line
+     *
+     * @param line      the header line
+     * @param version   the vcf header version
+     * @param lineType     the header line type
+     */
+    protected VCFSimpleHeaderLine(String line, VCFHeaderVersion version, SupportedHeaderLineType lineType) {
+        super(lineType.toString(), "");
+        this.lineType = lineType;
+        Map<String,String> mapping = VCFHeaderLineTranslator.parseLine(version,line, Arrays.asList("ID","Description"));
+        name = mapping.get("ID");
+        description = mapping.get("Description");
+        if ( description == null && ALLOW_UNBOUND_DESCRIPTIONS ) // handle the case where there's no description provided 
+            description = UNBOUND_DESCRIPTION;
+    }
+
+    protected String toStringEncoding() {
+        Map<String,Object> map = new LinkedHashMap<String,Object>();
+        map.put("ID", name);
+        map.put("Description", description);
+        return lineType.toString() + "=" + toStringEncoding(map);
+    }
+
+    public boolean equals(Object o) {
+        if ( !(o instanceof VCFSimpleHeaderLine) )
+            return false;
+        VCFSimpleHeaderLine other = (VCFSimpleHeaderLine)o;
+        return name.equals(other.name) &&
+               description.equals(other.description);
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFUtils.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFUtils.java
new file mode 100755
index 000000000..dc78d40ac
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFUtils.java
@@ -0,0 +1,227 @@
+/*
+ * Copyright (c) 2010 The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+ * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.apache.log4j.Logger;
+import org.broad.tribble.Feature;
+import org.broadinstitute.sting.commandline.RodBinding;
+import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
+import org.broadinstitute.sting.gatk.datasources.rmd.ReferenceOrderedDataSource;
+
+import java.util.*;
+
+/**
+ * A set of static utility methods for common operations on VCF files/records.
+ */
+class VCFUtils {
+    /**
+     * Constructor access disallowed...static utility methods only!
+     */
+    private VCFUtils() { }
+
+    public static <T extends Feature> Map<String, VCFHeader> getVCFHeadersFromRods(GenomeAnalysisEngine toolkit, List<RodBinding<T>> rodBindings) {
+        // Collect the eval rod names
+        final Set<String> names = new TreeSet<String>();
+        for ( final RodBinding<T> evalRod : rodBindings )
+            names.add(evalRod.getName());
+        return getVCFHeadersFromRods(toolkit, names);
+    }
+
+    public static Map<String, VCFHeader> getVCFHeadersFromRods(GenomeAnalysisEngine toolkit) {
+        return getVCFHeadersFromRods(toolkit, (Collection<String>)null);
+    }
+
+    public static Map<String, VCFHeader> getVCFHeadersFromRods(GenomeAnalysisEngine toolkit, Collection<String> rodNames) {
+        Map<String, VCFHeader> data = new HashMap<String, VCFHeader>();
+
+        // iterate to get all of the sample names
+        List<ReferenceOrderedDataSource> dataSources = toolkit.getRodDataSources();
+        for ( ReferenceOrderedDataSource source : dataSources ) {
+            // ignore the rod if it's not in our list
+            if ( rodNames != null && !rodNames.contains(source.getName()) )
+                continue;
+
+            if ( source.getHeader() != null && source.getHeader() instanceof VCFHeader )
+                data.put(source.getName(), (VCFHeader)source.getHeader());
+        }
+
+        return data;
+    }
+
+    public static Map<String,VCFHeader> getVCFHeadersFromRodPrefix(GenomeAnalysisEngine toolkit,String prefix) {
+        Map<String, VCFHeader> data = new HashMap<String, VCFHeader>();
+
+        // iterate to get all of the sample names
+        List<ReferenceOrderedDataSource> dataSources = toolkit.getRodDataSources();
+        for ( ReferenceOrderedDataSource source : dataSources ) {
+            // ignore the rod if lacks the prefix
+            if ( ! source.getName().startsWith(prefix) )
+                continue;
+
+            if ( source.getHeader() != null && source.getHeader() instanceof VCFHeader )
+                data.put(source.getName(), (VCFHeader)source.getHeader());
+        }
+
+        return data;
+    }
+
+    /**
+     * Gets the header fields from all VCF rods input by the user
+     *
+     * @param toolkit    GATK engine
+     *
+     * @return a set of all fields
+     */
+    public static Set<VCFHeaderLine> getHeaderFields(GenomeAnalysisEngine toolkit) {
+        return getHeaderFields(toolkit, null);
+    }
+
+    /**
+     * Gets the header fields from all VCF rods input by the user
+     *
+     * @param toolkit    GATK engine
+     * @param rodNames   names of rods to use, or null if we should use all possible ones
+     *
+     * @return a set of all fields
+     */
+    public static Set<VCFHeaderLine> getHeaderFields(GenomeAnalysisEngine toolkit, Collection<String> rodNames) {
+
+        // keep a map of sample name to occurrences encountered
+        TreeSet<VCFHeaderLine> fields = new TreeSet<VCFHeaderLine>();
+
+        // iterate to get all of the sample names
+        List<ReferenceOrderedDataSource> dataSources = toolkit.getRodDataSources();
+        for ( ReferenceOrderedDataSource source : dataSources ) {
+            // ignore the rod if it's not in our list
+            if ( rodNames != null && !rodNames.contains(source.getName()) )
+                continue;
+
+            if ( source.getRecordType().equals(VariantContext.class)) {
+                VCFHeader header = (VCFHeader)source.getHeader();
+                if ( header != null )
+                    fields.addAll(header.getMetaData());
+            }
+        }
+
+        return fields;
+    }
+
+    /** Only displays a warning if a logger is provided and an identical warning hasn't been already issued */
+    private static final class HeaderConflictWarner {
+        Logger logger;
+        Set<String> alreadyIssued = new HashSet<String>();
+
+        private HeaderConflictWarner(final Logger logger) {
+            this.logger = logger;
+        }
+
+        public void warn(final VCFHeaderLine line, final String msg) {
+            if ( logger != null && ! alreadyIssued.contains(line.getKey()) ) {
+                alreadyIssued.add(line.getKey());
+                logger.warn(msg);
+            }
+        }
+    }
+
+    public static Set<VCFHeaderLine> smartMergeHeaders(Collection<VCFHeader> headers, Logger logger) throws IllegalStateException {
+        HashMap<String, VCFHeaderLine> map = new HashMap<String, VCFHeaderLine>(); // from KEY.NAME -> line
+        HeaderConflictWarner conflictWarner = new HeaderConflictWarner(logger);
+
+        // todo -- needs to remove all version headers from sources and add its own VCF version line
+        for ( VCFHeader source : headers ) {
+            //System.out.printf("Merging in header %s%n", source);
+            for ( VCFHeaderLine line : source.getMetaData()) {
+                String key = line.getKey();
+
+                if ( line instanceof VCFNamedHeaderLine)
+                    key = key + "" + ((VCFNamedHeaderLine) line).getName();
+
+                if ( map.containsKey(key) ) {
+                    VCFHeaderLine other = map.get(key);
+                    if ( line.equals(other) )
+                        continue;
+                    else if ( ! line.getClass().equals(other.getClass()) )
+                        throw new IllegalStateException("Incompatible header types: " + line + " " + other );
+                    else if ( line instanceof VCFFilterHeaderLine) {
+                        String lineName = ((VCFFilterHeaderLine) line).getName();                                                                                                         String otherName = ((VCFFilterHeaderLine) other).getName();
+                        if ( ! lineName.equals(otherName) )
+                            throw new IllegalStateException("Incompatible header types: " + line + " " + other );
+                    } else if ( line instanceof VCFCompoundHeaderLine ) {
+                        VCFCompoundHeaderLine compLine = (VCFCompoundHeaderLine)line;
+                        VCFCompoundHeaderLine compOther = (VCFCompoundHeaderLine)other;
+
+                        // if the names are the same, but the values are different, we need to quit
+                        if (! (compLine).equalsExcludingDescription(compOther) ) {
+                            if ( compLine.getType().equals(compOther.getType()) ) {
+                                // The Number entry is an Integer that describes the number of values that can be
+                                // included with the INFO field. For example, if the INFO field contains a single
+                                // number, then this value should be 1. However, if the INFO field describes a pair
+                                // of numbers, then this value should be 2 and so on. If the number of possible
+                                // values varies, is unknown, or is unbounded, then this value should be '.'.
+                                conflictWarner.warn(line, "Promoting header field Number to . due to number differences in header lines: " + line + " " + other);
+                                compOther.setNumberToUnbounded();
+                            } else if ( compLine.getType() == VCFHeaderLineType.Integer && compOther.getType() == VCFHeaderLineType.Float ) {
+                                // promote key to Float
+                                conflictWarner.warn(line, "Promoting Integer to Float in header: " + compOther);
+                                map.put(key, compOther);
+                            } else if ( compLine.getType() == VCFHeaderLineType.Float && compOther.getType() == VCFHeaderLineType.Integer ) {
+                                // promote key to Float
+                                conflictWarner.warn(line, "Promoting Integer to Float in header: " + compOther);
+                            } else {
+                                throw new IllegalStateException("Incompatible header types, collision between these two types: " + line + " " + other );
+                            }
+                        }
+                        if ( ! compLine.getDescription().equals(compOther) )
+                            conflictWarner.warn(line, "Allowing unequal description fields through: keeping " + compOther + " excluding " + compLine);
+                    } else {
+                        // we are not equal, but we're not anything special either
+                        conflictWarner.warn(line, "Ignoring header line already in map: this header line = " + line + " already present header = " + other);
+                    }
+                } else {
+                    map.put(key, line);
+                    //System.out.printf("Adding header line %s%n", line);
+                }
+            }
+        }
+
+        return new HashSet<VCFHeaderLine>(map.values());
+    }
+
+    public static String rsIDOfFirstRealVariant(List<VariantContext> VCs, VariantContext.Type type) {
+        if ( VCs == null )
+            return null;
+
+        String rsID = null;
+        for ( VariantContext vc : VCs ) {
+            if ( vc.getType() == type ) {
+                rsID = vc.getID();
+                break;
+            }
+        }
+
+        return rsID;
+    }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFWriter.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFWriter.java
new file mode 100755
index 000000000..15bdb5046
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFWriter.java
@@ -0,0 +1,16 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+/**
+ * this class writes VCF files
+ */
+public interface VCFWriter {
+
+    public void writeHeader(VCFHeader header);
+
+    /**
+     * attempt to close the VCF file
+     */
+    public void close();
+
+    public void add(VariantContext vc);
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContext.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContext.java
new file mode 100755
index 000000000..3a193a00a
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContext.java
@@ -0,0 +1,1615 @@
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.broad.tribble.Feature;
+import org.broad.tribble.TribbleException;
+import org.broad.tribble.util.ParsingUtils;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+
+import java.util.*;
+
+/**
+ * Class VariantContext
+ *
+ * == High-level overview ==
+ *
+ * The VariantContext object is a single general class system for representing genetic variation data composed of:
+ *
+ * * Allele: representing single genetic haplotypes (A, T, ATC, -)
+ * * Genotype: an assignment of alleles for each chromosome of a single named sample at a particular locus
+ * * VariantContext: an abstract class holding all segregating alleles at a locus as well as genotypes
+ *    for multiple individuals containing alleles at that locus
+ *
+ * The class system works by defining segregating alleles, creating a variant context representing the segregating
+ * information at a locus, and potentially creating and associating genotypes with individuals in the context.
+ *
+ * All of the classes are highly validating -- call validate() if you modify them -- so you can rely on the
+ * self-consistency of the data once you have a VariantContext in hand.  The system has a rich set of assessor
+ * and manipulator routines, as well as more complex static support routines in VariantContextUtils.
+ *
+ * The VariantContext (and Genotype) objects are attributed (supporting addition of arbitrary key/value pairs) and
+ * filtered (can represent a variation that is viewed as suspect).
+ *
+ * VariantContexts are dynamically typed, so whether a VariantContext is a SNP, Indel, or NoVariant depends
+ * on the properties of the alleles in the context.  See the detailed documentation on the Type parameter below.
+ *
+ * It's also easy to create subcontexts based on selected genotypes.
+ *
+ * == Working with Variant Contexts ==
+ * By default, VariantContexts are immutable.  In order to access (in the rare circumstances where you need them)
+ * setter routines, you need to create MutableVariantContexts and MutableGenotypes.
+ *
+ * === Some example data ===
+ *
+ * Allele A, Aref, T, Tref;
+ * Allele del, delRef, ATC, ATCref;
+ *
+ * A [ref] / T at 10
+ * GenomeLoc snpLoc = GenomeLocParser.createGenomeLoc("chr1", 10, 10);
+ *
+ * - / ATC [ref] from 20-23
+ * GenomeLoc delLoc = GenomeLocParser.createGenomeLoc("chr1", 20, 22);
+ *
+ *  // - [ref] / ATC immediately after 20
+ * GenomeLoc insLoc = GenomeLocParser.createGenomeLoc("chr1", 20, 20);
+ *
+ * === Alleles ===
+ *
+ * See the documentation in the Allele class itself
+ *
+ * What are they?
+ *
+ * Alleles can be either reference or non-reference
+ *
+ * Example alleles used here:
+ *
+ *   del = new Allele("-");
+ *   A = new Allele("A");
+ *   Aref = new Allele("A", true);
+ *   T = new Allele("T");
+ *   ATC = new Allele("ATC");
+ *
+ * === Creating variant contexts ===
+ *
+ * ==== By hand ====
+ *
+ * Here's an example of a A/T polymorphism with the A being reference:
+ *
+ * <pre>
+ * VariantContext vc = new VariantContext(name, snpLoc, Arrays.asList(Aref, T));
+ * </pre>
+ *
+ * If you want to create a non-variant site, just put in a single reference allele
+ *
+ * <pre>
+ * VariantContext vc = new VariantContext(name, snpLoc, Arrays.asList(Aref));
+ * </pre>
+ *
+ * A deletion is just as easy:
+ *
+ * <pre>
+ * VariantContext vc = new VariantContext(name, delLoc, Arrays.asList(ATCref, del));
+ * </pre>
+ *
+ * The only 2 things that distinguishes between a insertion and deletion are the reference allele
+ * and the location of the variation.  An insertion has a Null reference allele and at least
+ * one non-reference Non-Null allele.  Additionally, the location of the insertion is immediately after
+ * a 1-bp GenomeLoc (at say 20).
+ *
+ * <pre>
+ * VariantContext vc = new VariantContext("name", insLoc, Arrays.asList(delRef, ATC));
+ * </pre>
+ *
+ * ==== Converting rods and other data structures to VCs ====
+ *
+ * You can convert many common types into VariantContexts using the general function:
+ *
+ * <pre>
+ * VariantContextAdaptors.convertToVariantContext(name, myObject)
+ * </pre>
+ *
+ * dbSNP and VCFs, for example, can be passed in as myObject and a VariantContext corresponding to that
+ * object will be returned.  A null return type indicates that the type isn't yet supported.  This is the best
+ * and easiest way to create contexts using RODs.
+ *
+ *
+ * === Working with genotypes ===
+ *
+ * <pre>
+ * List<Allele> alleles = Arrays.asList(Aref, T);
+ * Genotype g1 = new Genotype(Arrays.asList(Aref, Aref), "g1", 10);
+ * Genotype g2 = new Genotype(Arrays.asList(Aref, T), "g2", 10);
+ * Genotype g3 = new Genotype(Arrays.asList(T, T), "g3", 10);
+ * VariantContext vc = new VariantContext(snpLoc, alleles, Arrays.asList(g1, g2, g3));
+ * </pre>
+ *
+ * At this point we have 3 genotypes in our context, g1-g3.
+ *
+ * You can assess a good deal of information about the genotypes through the VariantContext:
+ *
+ * <pre>
+ * vc.hasGenotypes()
+ * vc.isMonomorphic()
+ * vc.isPolymorphic()
+ * vc.getSamples().size()
+ *
+ * vc.getGenotypes()
+ * vc.getGenotypes().get("g1")
+ * vc.hasGenotype("g1")
+ *
+ * vc.getChromosomeCount()
+ * vc.getChromosomeCount(Aref)
+ * vc.getChromosomeCount(T)
+ * </pre>
+ *
+ * === NO_CALL alleles ===
+ *
+ * The system allows one to create Genotypes carrying special NO_CALL alleles that aren't present in the
+ * set of context alleles and that represent undetermined alleles in a genotype:
+ *
+ * Genotype g4 = new Genotype(Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), "NO_DATA_FOR_SAMPLE", 10);
+ *
+ *
+ * === subcontexts ===
+ * It's also very easy get subcontext based only the data in a subset of the genotypes:
+ *
+ * <pre>
+ * VariantContext vc12 = vc.subContextFromGenotypes(Arrays.asList(g1,g2));
+ * VariantContext vc1 = vc.subContextFromGenotypes(Arrays.asList(g1));
+ * </pre>
+ *
+ * @author depristo
+ */
+public class VariantContext implements Feature { // to enable tribble intergration
+    protected InferredGeneticContext commonInfo = null;
+    public final static double NO_NEG_LOG_10PERROR = InferredGeneticContext.NO_NEG_LOG_10PERROR;
+    public final static String UNPARSED_GENOTYPE_MAP_KEY = "_UNPARSED_GENOTYPE_MAP_";
+    public final static String UNPARSED_GENOTYPE_PARSER_KEY = "_UNPARSED_GENOTYPE_PARSER_";
+    public final static String ID_KEY = "ID";
+
+    private final Byte REFERENCE_BASE_FOR_INDEL;
+
+    public final static Set<String> PASSES_FILTERS = Collections.unmodifiableSet(new LinkedHashSet<String>());
+
+    /** The location of this VariantContext */
+    protected String contig;
+    protected long start;
+    protected long stop;
+
+    /** The type (cached for performance reasons) of this context */
+    protected Type type = null;
+
+    /** A set of the alleles segregating in this context */
+    final protected List<Allele> alleles;
+
+    /** A mapping from sampleName -> genotype objects for all genotypes associated with this context */
+    protected Map<String, Genotype> genotypes = null;
+
+    /** Counts for each of the possible Genotype types in this context */
+    protected int[] genotypeCounts = null;
+
+    public final static Map<String, Genotype> NO_GENOTYPES = Collections.unmodifiableMap(new HashMap<String, Genotype>());
+
+    // a fast cached access point to the ref / alt alleles for biallelic case
+    private Allele REF = null;
+
+    // set to the alt allele when biallelic, otherwise == null
+    private Allele ALT = null;
+
+    // were filters applied?
+    private boolean filtersWereAppliedToContext;
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // constructors
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+
+    /**
+     * the complete constructor.  Makes a complete VariantContext from its arguments
+     * This is the only constructor that is able to create indels! DO NOT USE THE OTHER ONES.
+     *
+     * @param source          source
+     * @param contig          the contig
+     * @param start           the start base (one based)
+     * @param stop            the stop reference base (one based)
+     * @param alleles         alleles
+     * @param genotypes       genotypes map
+     * @param negLog10PError  qual
+     * @param filters         filters: use null for unfiltered and empty set for passes filters
+     * @param attributes      attributes
+     * @param referenceBaseForIndel   padded reference base
+     */
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes, Byte referenceBaseForIndel) {
+        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, true);
+    }
+
+    /**
+     * the complete constructor.  Makes a complete VariantContext from its arguments
+     *
+     * @param source          source
+     * @param contig          the contig
+     * @param start           the start base (one based)
+     * @param stop            the stop reference base (one based)
+     * @param alleles         alleles
+     * @param genotypes       genotypes map
+     * @param negLog10PError  qual
+     * @param filters         filters: use null for unfiltered and empty set for passes filters
+     * @param attributes      attributes
+     */
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, true);
+    }
+
+    /**
+     * Makes a VariantContext from its arguments without parsing the genotypes.
+     * Note that this constructor assumes that if there is genotype data, then it's been put into
+     * the attributes with the UNPARSED_GENOTYPE_MAP_KEY and that the codec has been added with the
+     * UNPARSED_GENOTYPE_PARSER_KEY.  It doesn't validate that this is the case because it's possible
+     * that there is no genotype data.
+     *
+     * @param source          source
+     * @param contig          the contig
+     * @param start           the start base (one based)
+     * @param stop            the stop reference base (one based)
+     * @param alleles         alleles
+     * @param negLog10PError  qual
+     * @param filters         filters: use null for unfiltered and empty set for passes filters
+     * @param attributes      attributes
+     * @param referenceBaseForIndel   padded reference base
+     */
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, Byte referenceBaseForIndel) {
+        this(source, contig, start, stop, alleles, NO_GENOTYPES, negLog10PError, filters, attributes, referenceBaseForIndel, true, true);
+    }
+
+    /**
+     * Create a new VariantContext
+     *
+     * @param source         source
+     * @param contig         the contig
+     * @param start          the start base (one based)
+     * @param stop           the stop reference base (one based)
+     * @param alleles        alleles
+     * @param genotypes      genotypes set
+     * @param negLog10PError qual
+     * @param filters        filters: use null for unfiltered and empty set for passes filters
+     * @param attributes     attributes
+     */
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+        this(source, contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes, null, false, true);
+    }
+
+    /**
+     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
+     *
+     * @param source          source
+     * @param contig          the contig
+     * @param start           the start base (one based)
+     * @param stop            the stop reference base (one based)
+     * @param alleles alleles
+     */
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
+        this(source, contig, start, stop, alleles, NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, null, false, true);
+    }
+
+    /**
+     * Create a new variant context with genotypes but without Perror, filters, and attributes
+     *
+     * @param source          source
+     * @param contig          the contig
+     * @param start           the start base (one based)
+     * @param stop            the stop reference base (one based)
+     * @param alleles   alleles
+     * @param genotypes genotypes
+     */
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
+        this(source, contig, start, stop, alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
+    }
+
+    /**
+     * Copy constructor
+     *
+     * @param other the VariantContext to copy
+     */
+    public VariantContext(VariantContext other) {
+        this(other.getSource(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, true);
+    }
+
+    /**
+     * the actual constructor.  Private access only
+     *
+     * @param source          source
+     * @param contig          the contig
+     * @param start           the start base (one based)
+     * @param stop            the stop reference base (one based)
+     * @param alleles         alleles
+     * @param genotypes       genotypes map
+     * @param negLog10PError  qual
+     * @param filters         filters: use null for unfiltered and empty set for passes filters
+     * @param attributes      attributes
+     * @param referenceBaseForIndel   padded reference base
+     * @param genotypesAreUnparsed    true if the genotypes have not yet been parsed
+     * @param performValidation       if true, call validate() as the final step in construction
+     */
+    private VariantContext(String source, String contig, long start, long stop,
+                           Collection<Allele> alleles, Map<String, Genotype> genotypes,
+                           double negLog10PError, Set<String> filters, Map<String, ?> attributes,
+                           Byte referenceBaseForIndel, boolean genotypesAreUnparsed,
+                           boolean performValidation ) {
+        if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
+        this.contig = contig;
+        this.start = start;
+        this.stop = stop;
+
+        if ( !genotypesAreUnparsed && attributes != null ) {
+            if ( attributes.containsKey(UNPARSED_GENOTYPE_MAP_KEY) )
+                attributes.remove(UNPARSED_GENOTYPE_MAP_KEY);
+            if ( attributes.containsKey(UNPARSED_GENOTYPE_PARSER_KEY) )
+                attributes.remove(UNPARSED_GENOTYPE_PARSER_KEY);
+        }
+
+        this.commonInfo = new InferredGeneticContext(source, negLog10PError, filters, attributes);
+        filtersWereAppliedToContext = filters != null;
+        REFERENCE_BASE_FOR_INDEL = referenceBaseForIndel;
+
+        if ( alleles == null ) { throw new IllegalArgumentException("Alleles cannot be null"); }
+
+        // we need to make this a LinkedHashSet in case the user prefers a given ordering of alleles
+        this.alleles = makeAlleles(alleles);
+
+
+        if ( genotypes == null ) { genotypes = NO_GENOTYPES; }
+        this.genotypes = Collections.unmodifiableMap(genotypes);
+
+        // cache the REF and ALT alleles
+        int nAlleles = alleles.size();
+        for ( Allele a : alleles ) {
+            if ( a.isReference() ) {
+                REF = a;
+            } else if ( nAlleles == 2 ) { // only cache ALT when biallelic
+                ALT = a;
+            }
+        }
+
+        if ( performValidation ) {
+            validate();
+        }
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Partial-cloning routines (because Variant Context is immutable).
+    //
+    //    IMPORTANT: These routines assume that the VariantContext on which they're called is already valid.
+    //               Due to this assumption, they explicitly tell the constructor NOT to perform validation by
+    //               calling validate(), and instead perform validation only on the data that's changed.
+    //
+    //    Note that we don't call vc.getGenotypes() because that triggers the lazy loading.
+    //    Also note that we need to create a new attributes map because it's unmodifiable and the constructor may try to modify it.
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    public static VariantContext modifyGenotypes(VariantContext vc, Map<String, Genotype> genotypes) {
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), false, false);
+        modifiedVC.validateGenotypes();
+        return modifiedVC;
+    }
+
+    public static VariantContext modifyLocation(VariantContext vc, String chr, int start, int end) {
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), chr, start, end, vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
+
+        // Since start and end have changed, we need to call both validateAlleles() and validateReferencePadding(),
+        // since those validation routines rely on the values of start and end:
+        modifiedVC.validateAlleles();
+        modifiedVC.validateReferencePadding();
+
+        return modifiedVC;
+    }
+
+    public static VariantContext modifyFilters(VariantContext vc, Set<String> filters) {
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), filters, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
+    }
+
+    public static VariantContext modifyAttributes(VariantContext vc, Map<String, Object> attributes) {
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
+    }
+
+    public static VariantContext modifyReferencePadding(VariantContext vc, Byte b) {
+        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), b, true, false);
+        modifiedVC.validateReferencePadding();
+        return modifiedVC;
+    }
+
+    public static VariantContext modifyPErrorFiltersAndAttributes(VariantContext vc, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, negLog10PError, filters, attributes, vc.getReferenceBaseForIndel(), true, false);
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Selectors
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    /**
+     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotype
+     * genotype and alleles in genotype.  This is the right way to test if a single genotype is actually
+     * variant or not.
+     *
+     * @param genotype genotype
+     * @return vc subcontext
+     */
+    public VariantContext subContextFromGenotypes(Genotype genotype) {
+        return subContextFromGenotypes(Arrays.asList(genotype));
+    }
+
+
+    /**
+     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
+     * genotypes and alleles in these genotypes.  This is the right way to test if a single genotype is actually
+     * variant or not.
+     *
+     * @param genotypes genotypes
+     * @return vc subcontext
+     */
+    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes) {
+        return subContextFromGenotypes(genotypes, allelesOfGenotypes(genotypes)) ;
+    }
+
+    /**
+     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
+     * genotypes.  Also, the resulting variant context will contain the alleles provided, not only those found in genotypes
+     *
+     * @param genotypes genotypes
+     * @param alleles the set of allele segregating alleles at this site.  Must include those in genotypes, but may be more
+     * @return vc subcontext
+     */
+    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes, Collection<Allele> alleles) {
+        return new VariantContext(getSource(), contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, getNegLog10PError(), filtersWereApplied() ? getFilters() : null, getAttributes(), getReferenceBaseForIndel());
+    }
+
+
+    /**
+     * helper routine for subcontext
+     * @param genotypes genotypes
+     * @return allele set
+     */
+    private Set<Allele> allelesOfGenotypes(Collection<Genotype> genotypes) {
+        Set<Allele> alleles = new HashSet<Allele>();
+
+        boolean addedref = false;
+        for ( Genotype g : genotypes ) {
+            for ( Allele a : g.getAlleles() ) {
+                addedref = addedref || a.isReference();
+                if ( a.isCalled() )
+                    alleles.add(a);
+            }
+        }
+        if ( ! addedref ) alleles.add(getReference());
+
+        return alleles;
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // type operations
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    /**
+     * see: http://www.ncbi.nlm.nih.gov/bookshelf/br.fcgi?book=handbook&part=ch5&rendertype=table&id=ch5.ch5_t3
+     *
+     * Format:
+     * dbSNP variation class
+     * Rules for assigning allele classes
+     * Sample allele definition
+     *
+     * Single Nucleotide Polymorphisms (SNPs)a
+     *   Strictly defined as single base substitutions involving A, T, C, or G.
+     *   A/T
+     *
+     * Deletion/Insertion Polymorphisms (DIPs)
+     *   Designated using the full sequence of the insertion as one allele, and either a fully
+     *   defined string for the variant allele or a '-' character to specify the deleted allele.
+     *   This class will be assigned to a variation if the variation alleles are of different lengths or
+     *   if one of the alleles is deleted ('-').
+     *   T/-/CCTA/G
+     *
+     * No-variation
+     *   Reports may be submitted for segments of sequence that are assayed and determined to be invariant
+     *   in the sample.
+     *   (NoVariation)
+     *
+     * Mixed
+     *   Mix of other classes
+     *
+     * Also supports NO_VARIATION type, used to indicate that the site isn't polymorphic in the population
+     *
+     *
+     * Not currently supported:
+     *
+     * Heterozygous sequencea
+     * The term heterozygous is used to specify a region detected by certain methods that do not
+     * resolve the polymorphism into a specific sequence motif. In these cases, a unique flanking
+     * sequence must be provided to define a sequence context for the variation.
+     * (heterozygous)
+     *
+     * Microsatellite or short tandem repeat (STR)
+     * Alleles are designated by providing the repeat motif and the copy number for each allele.
+     * Expansion of the allele repeat motif designated in dbSNP into full-length sequence will
+     * be only an approximation of the true genomic sequence because many microsatellite markers are
+     * not fully sequenced and are resolved as size variants only.
+     * (CAC)8/9/10/11
+     *
+     * Named variant
+     * Applies to insertion/deletion polymorphisms of longer sequence features, such as retroposon
+     * dimorphism for Alu or line elements. These variations frequently include a deletion '-' indicator
+     * for the absent allele.
+     * (alu) / -
+     *
+     * Multi-Nucleotide Polymorphism (MNP)
+     *   Assigned to variations that are multi-base variations of a single, common length
+     *   GGA/AGT
+     */
+    public enum Type {
+        NO_VARIATION,
+        SNP,
+        MNP,    // a multi-nucleotide polymorphism
+        INDEL,
+        SYMBOLIC,
+        MIXED,
+    }
+
+    /**
+     * Determines (if necessary) and returns the type of this variation by examining the alleles it contains.
+     *
+     * @return the type of this VariantContext
+     **/
+    public Type getType() {
+        if ( type == null )
+            determineType();
+
+        return type;
+    }
+
+    /**
+     * convenience method for SNPs
+     *
+     * @return true if this is a SNP, false otherwise
+     */
+    public boolean isSNP() { return getType() == Type.SNP; }
+
+
+    /**
+     * convenience method for variants
+     *
+     * @return true if this is a variant allele, false if it's reference
+     */
+    public boolean isVariant() { return getType() != Type.NO_VARIATION; }
+
+    /**
+     * convenience method for point events
+     *
+     * @return true if this is a SNP or ref site, false if it's an indel or mixed event
+     */
+    public boolean isPointEvent() { return isSNP() || !isVariant(); }
+
+    /**
+     * convenience method for indels
+     *
+     * @return true if this is an indel, false otherwise
+     */
+    public boolean isIndel() { return getType() == Type.INDEL; }
+
+    /**
+     * @return true if the alleles indicate a simple insertion (i.e., the reference allele is Null)
+     */
+    public boolean isSimpleInsertion() {
+        // can't just call !isSimpleDeletion() because of complex indels
+        return getType() == Type.INDEL && getReference().isNull() && isBiallelic();
+    }
+
+    /**
+     * @return true if the alleles indicate a simple deletion (i.e., a single alt allele that is Null)
+     */
+    public boolean isSimpleDeletion() {
+        // can't just call !isSimpleInsertion() because of complex indels
+        return getType() == Type.INDEL && getAlternateAllele(0).isNull() && isBiallelic();
+    }
+
+    /**
+     * @return true if the alleles indicate neither a simple deletion nor a simple insertion
+     */
+    public boolean isComplexIndel() {
+        return isIndel() && !isSimpleDeletion() && !isSimpleInsertion();
+    }
+
+    public boolean isSymbolic() {
+        return getType() == Type.SYMBOLIC;
+    }
+
+    public boolean isMNP() {
+        return getType() == Type.MNP;
+    }
+
+    /**
+     * convenience method for indels
+     *
+     * @return true if this is an mixed variation, false otherwise
+     */
+    public boolean isMixed() { return getType() == Type.MIXED; }
+
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Generic accessors
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    public boolean hasID() {
+        return commonInfo.hasAttribute(ID_KEY);
+    }
+
+    public String getID() {
+        return (String)commonInfo.getAttribute(ID_KEY);
+    }
+
+    public boolean hasReferenceBaseForIndel() {
+        return REFERENCE_BASE_FOR_INDEL != null;
+    }
+
+    // the indel base that gets stripped off for indels
+    public Byte getReferenceBaseForIndel() {
+        return REFERENCE_BASE_FOR_INDEL;
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // get routines to access context info fields
+    //
+    // ---------------------------------------------------------------------------------------------------------
+    public String getSource()                   { return commonInfo.getName(); }
+    public Set<String> getFilters()             { return commonInfo.getFilters(); }
+    public boolean isFiltered()                 { return commonInfo.isFiltered(); }
+    public boolean isNotFiltered()              { return commonInfo.isNotFiltered(); }
+    public boolean filtersWereApplied()         { return filtersWereAppliedToContext; }
+    public boolean hasNegLog10PError()          { return commonInfo.hasNegLog10PError(); }
+    public double getNegLog10PError()           { return commonInfo.getNegLog10PError(); }
+    public double getPhredScaledQual()          { return commonInfo.getPhredScaledQual(); }
+
+    public Map<String, Object>  getAttributes() { return commonInfo.getAttributes(); }
+    public boolean hasAttribute(String key)     { return commonInfo.hasAttribute(key); }
+    public Object getAttribute(String key)      { return commonInfo.getAttribute(key); }
+
+    public Object getAttribute(String key, Object defaultValue) {
+        return commonInfo.getAttribute(key, defaultValue);
+    }
+
+    public String getAttributeAsString(String key, String defaultValue)   { return commonInfo.getAttributeAsString(key, defaultValue); }
+    public int getAttributeAsInt(String key, int defaultValue)            { return commonInfo.getAttributeAsInt(key, defaultValue); }
+    public double getAttributeAsDouble(String key, double  defaultValue)  { return commonInfo.getAttributeAsDouble(key, defaultValue); }
+    public boolean getAttributeAsBoolean(String key, boolean  defaultValue)  { return commonInfo.getAttributeAsBoolean(key, defaultValue); }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Working with alleles
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    /**
+     * @return the reference allele for this context
+     */
+    public Allele getReference() {
+        Allele ref = REF;
+        if ( ref == null )
+            throw new IllegalStateException("BUG: no reference allele found at " + this);
+        return ref;
+    }
+
+
+    /**
+     * @return true if the context is strictly bi-allelic
+     */
+    public boolean isBiallelic() {
+        return getNAlleles() == 2;
+    }
+
+    /**
+     * @return The number of segregating alleles in this context
+     */
+    public int getNAlleles() {
+        return alleles.size();
+    }
+
+    /**
+     * @return The allele sharing the same bases as this String.  A convenience method; better to use byte[]
+     */
+    public Allele getAllele(String allele) {
+        return getAllele(allele.getBytes());
+    }
+
+    /**
+     * @return The allele sharing the same bases as this byte[], or null if no such allele is present.
+     */
+    public Allele getAllele(byte[] allele) {
+        return Allele.getMatchingAllele(getAlleles(), allele);
+    }
+
+    /**
+     * @return True if this context contains Allele allele, or false otherwise
+     */
+    public boolean hasAllele(Allele allele) {
+        return hasAllele(allele, false);
+    }
+
+    public boolean hasAllele(Allele allele, boolean ignoreRefState) {
+        if ( allele == REF || allele == ALT ) // optimization for cached cases
+            return true;
+
+        for ( Allele a : getAlleles() ) {
+            if ( a.equals(allele, ignoreRefState) )
+                return true;
+        }
+
+        return false;
+    }
+
+
+    /**
+     * Gets the alleles.  This method should return all of the alleles present at the location,
+     * including the reference allele.  There are no constraints imposed on the ordering of alleles
+     * in the set. If the reference is not an allele in this context it will not be included.
+     *
+     * @return the set of alleles
+     */
+    public List<Allele> getAlleles() { return alleles; }
+
+    /**
+     * Gets the alternate alleles.  This method should return all the alleles present at the location,
+     * NOT including the reference allele.  There are no constraints imposed on the ordering of alleles
+     * in the set.
+     *
+     * @return the set of alternate alleles
+     */
+    public List<Allele> getAlternateAlleles() {
+        return alleles.subList(1, alleles.size());
+    }
+
+    /**
+     * Gets the sizes of the alternate alleles if they are insertion/deletion events, and returns a list of their sizes
+     *
+     * @return a list of indel lengths ( null if not of type indel or mixed )
+     */
+    public List<Integer> getIndelLengths() {
+        if ( getType() != Type.INDEL && getType() != Type.MIXED ) {
+            return null;
+        }
+
+        List<Integer> lengths = new ArrayList<Integer>();
+        for ( Allele a : getAlternateAlleles() ) {
+            lengths.add(a.length() - getReference().length());
+        }
+
+        return lengths;
+    }
+
+    /**
+     * @param i -- the ith allele (from 0 to n - 2 for a context with n alleles including a reference allele)
+     * @return the ith non-reference allele in this context
+     * @throws IllegalArgumentException if i is invalid
+     */
+    public Allele getAlternateAllele(int i) {
+        return alleles.get(i+1);
+    }
+
+    /**
+     * @param  other  VariantContext whose alternate alleles to compare against
+     * @return true if this VariantContext has the same alternate alleles as other,
+     *         regardless of ordering. Otherwise returns false.
+     */
+    public boolean hasSameAlternateAllelesAs ( VariantContext other ) {
+        List<Allele> thisAlternateAlleles = getAlternateAlleles();
+        List<Allele> otherAlternateAlleles = other.getAlternateAlleles();
+
+        if ( thisAlternateAlleles.size() != otherAlternateAlleles.size() ) {
+            return false;
+        }
+
+        for ( Allele allele : thisAlternateAlleles ) {
+            if ( ! otherAlternateAlleles.contains(allele) ) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // Working with genotypes
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    private void loadGenotypes() {
+        if ( !hasAttribute(UNPARSED_GENOTYPE_MAP_KEY) ) {
+            if ( genotypes == null )
+                genotypes = NO_GENOTYPES;
+            return;
+        }
+
+        Object parserObj = getAttribute(UNPARSED_GENOTYPE_PARSER_KEY);
+        if ( parserObj == null || !(parserObj instanceof VCFParser) )
+            throw new IllegalStateException("There is no VCF parser stored to unparse the genotype data");
+        VCFParser parser = (VCFParser)parserObj;
+
+        Object mapObj = getAttribute(UNPARSED_GENOTYPE_MAP_KEY);
+        if ( mapObj == null )
+            throw new IllegalStateException("There is no mapping string stored to unparse the genotype data");
+
+        genotypes = parser.createGenotypeMap(mapObj.toString(), new ArrayList<Allele>(alleles), getChr(), getStart());
+
+        commonInfo.removeAttribute(UNPARSED_GENOTYPE_MAP_KEY);
+        commonInfo.removeAttribute(UNPARSED_GENOTYPE_PARSER_KEY);
+
+        validateGenotypes();
+    }
+
+    /**
+     * @return the number of samples in the context
+     */
+    public int getNSamples() {
+        loadGenotypes();
+        return genotypes.size();
+    }
+
+    /**
+     * @return true if the context has associated genotypes
+     */
+    public boolean hasGenotypes() {
+        loadGenotypes();
+        return genotypes.size() > 0;
+    }
+
+    public boolean hasGenotypes(Collection<String> sampleNames) {
+        loadGenotypes();
+        for ( String name : sampleNames ) {
+            if ( ! genotypes.containsKey(name) )
+                return false;
+        }
+        return true;
+    }
+
+    /**
+     * @return set of all Genotypes associated with this context
+     */
+    public Map<String, Genotype> getGenotypes() {
+        loadGenotypes();
+        return genotypes;
+    }
+
+    public List<Genotype> getGenotypesSortedByName() {
+        loadGenotypes();
+        Collection<Genotype> types = new TreeMap<String,Genotype>(genotypes).values();
+        return new ArrayList<Genotype>(types);
+    }
+
+    /**
+     * Returns a map from sampleName -> Genotype for the genotype associated with sampleName.  Returns a map
+     * for consistency with the multi-get function.
+     *
+     * @param sampleName
+     * @return
+     * @throws IllegalArgumentException if sampleName isn't bound to a genotype
+     */
+    public Map<String, Genotype> getGenotypes(String sampleName) {
+        return getGenotypes(Arrays.asList(sampleName));
+    }
+
+    /**
+     * Returns a map from sampleName -> Genotype for each sampleName in sampleNames.  Returns a map
+     * for consistency with the multi-get function.
+     *
+     * @param sampleNames a unique list of sample names
+     * @return
+     * @throws IllegalArgumentException if sampleName isn't bound to a genotype
+     */
+    public Map<String, Genotype> getGenotypes(Collection<String> sampleNames) {
+        HashMap<String, Genotype> map = new HashMap<String, Genotype>();
+
+        for ( String name : sampleNames ) {
+            if ( map.containsKey(name) ) throw new IllegalArgumentException("Duplicate names detected in requested samples " + sampleNames);
+            final Genotype g = getGenotype(name);
+            if ( g != null ) {
+                map.put(name, g);
+            }
+        }
+
+        return map;
+    }
+
+    /**
+     * @return the set of all sample names in this context
+     */
+    public Set<String> getSampleNames() {
+        return getGenotypes().keySet();
+    }
+
+    /**
+     * @param sample  the sample name
+     *
+     * @return the Genotype associated with the given sample in this context or null if the sample is not in this context
+     */
+    public Genotype getGenotype(String sample) {
+        return getGenotypes().get(sample);
+    }
+
+    public boolean hasGenotype(String sample) {
+        return getGenotypes().containsKey(sample);
+    }
+
+    public Genotype getGenotype(int ith) {
+        return getGenotypesSortedByName().get(ith);
+    }
+
+
+    /**
+     * Returns the number of chromosomes carrying any allele in the genotypes (i.e., excluding NO_CALLS
+     *
+     * @return chromosome count
+     */
+    public int getChromosomeCount() {
+        int n = 0;
+
+        for ( Genotype g : getGenotypes().values() ) {
+            n += g.isNoCall() ? 0 : g.getPloidy();
+        }
+
+        return n;
+    }
+
+    /**
+     * Returns the number of chromosomes carrying allele A in the genotypes
+     *
+     * @param a allele
+     * @return chromosome count
+     */
+    public int getChromosomeCount(Allele a) {
+        int n = 0;
+
+        for ( Genotype g : getGenotypes().values() ) {
+            n += g.getAlleles(a).size();
+        }
+
+        return n;
+    }
+
+    /**
+     * Genotype-specific functions -- are the genotypes monomorphic w.r.t. to the alleles segregating at this
+     * site?  That is, is the number of alternate alleles among all fo the genotype == 0?
+     *
+     * @return true if it's monomorphic
+     */
+    public boolean isMonomorphic() {
+        return ! isVariant() || (hasGenotypes() && getHomRefCount() + getNoCallCount() == getNSamples());
+    }
+
+    /**
+     * Genotype-specific functions -- are the genotypes polymorphic w.r.t. to the alleles segregating at this
+     * site?  That is, is the number of alternate alleles among all fo the genotype > 0?
+     *
+     * @return true if it's polymorphic
+     */
+    public boolean isPolymorphic() {
+        return ! isMonomorphic();
+    }
+
+    private void calculateGenotypeCounts() {
+        if ( genotypeCounts == null ) {
+            genotypeCounts = new int[Genotype.Type.values().length];
+
+            for ( Genotype g : getGenotypes().values() ) {
+                if ( g.isNoCall() )
+                    genotypeCounts[Genotype.Type.NO_CALL.ordinal()]++;
+                else if ( g.isHomRef() )
+                    genotypeCounts[Genotype.Type.HOM_REF.ordinal()]++;
+                else if ( g.isHet() )
+                    genotypeCounts[Genotype.Type.HET.ordinal()]++;
+                else if ( g.isHomVar() )
+                    genotypeCounts[Genotype.Type.HOM_VAR.ordinal()]++;
+                else
+                    genotypeCounts[Genotype.Type.MIXED.ordinal()]++;
+            }
+        }
+    }
+
+    /**
+     * Genotype-specific functions -- how many no-calls are there in the genotypes?
+     *
+     * @return number of no calls
+     */
+    public int getNoCallCount() {
+        calculateGenotypeCounts();
+        return genotypeCounts[Genotype.Type.NO_CALL.ordinal()];
+    }
+
+    /**
+     * Genotype-specific functions -- how many hom ref calls are there in the genotypes?
+     *
+     * @return number of hom ref calls
+     */
+    public int getHomRefCount() {
+        calculateGenotypeCounts();
+        return genotypeCounts[Genotype.Type.HOM_REF.ordinal()];
+    }
+
+    /**
+     * Genotype-specific functions -- how many het calls are there in the genotypes?
+     *
+     * @return number of het calls
+     */
+    public int getHetCount() {
+        calculateGenotypeCounts();
+        return genotypeCounts[Genotype.Type.HET.ordinal()];
+    }
+
+    /**
+     * Genotype-specific functions -- how many hom var calls are there in the genotypes?
+     *
+     * @return number of hom var calls
+     */
+    public int getHomVarCount() {
+        return genotypeCounts[Genotype.Type.HOM_VAR.ordinal()];
+    }
+
+    /**
+     * Genotype-specific functions -- how many mixed calls are there in the genotypes?
+     *
+     * @return number of mixed calls
+     */
+    public int getMixedCount() {
+        return genotypeCounts[Genotype.Type.MIXED.ordinal()];
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // validation: extra-strict validation routines for paranoid users
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    /**
+     * Run all extra-strict validation tests on a Variant Context object
+     *
+     * @param reference        the true reference allele
+     * @param paddedRefBase    the reference base used for padding indels
+     * @param rsIDs            the true dbSNP IDs
+     */
+    public void extraStrictValidation(Allele reference, Byte paddedRefBase, Set<String> rsIDs) {
+        // validate the reference
+        validateReferenceBases(reference, paddedRefBase);
+
+        // validate the RS IDs
+        validateRSIDs(rsIDs);
+
+        // validate the altenate alleles
+        validateAlternateAlleles();
+
+        // validate the AN and AC fields
+        validateChromosomeCounts();
+
+        // TODO: implement me
+        //checkReferenceTrack();
+    }
+
+    public void validateReferenceBases(Allele reference, Byte paddedRefBase) {
+        // don't validate if we're a complex event
+        if ( !isComplexIndel() && !reference.isNull() && !reference.basesMatch(getReference()) ) {
+            throw new TribbleException.InternalCodecException(String.format("the REF allele is incorrect for the record at position %s:%d, fasta says %s vs. VCF says %s", getChr(), getStart(), reference.getBaseString(), getReference().getBaseString()));
+        }
+
+        // we also need to validate the padding base for simple indels
+        if ( hasReferenceBaseForIndel() && !getReferenceBaseForIndel().equals(paddedRefBase) ) {
+            throw new TribbleException.InternalCodecException(String.format("the padded REF base is incorrect for the record at position %s:%d, fasta says %s vs. VCF says %s", getChr(), getStart(), (char)paddedRefBase.byteValue(), (char)getReferenceBaseForIndel().byteValue()));
+        }
+    }
+
+    public void validateRSIDs(Set<String> rsIDs) {
+        if ( rsIDs != null && hasAttribute(VariantContext.ID_KEY) ) {
+            for ( String id : getID().split(VCFConstants.ID_FIELD_SEPARATOR) ) {
+                if ( id.startsWith("rs") && !rsIDs.contains(id) )
+                    throw new TribbleException.InternalCodecException(String.format("the rsID %s for the record at position %s:%d is not in dbSNP", id, getChr(), getStart()));
+            }
+        }
+    }
+
+    public void validateAlternateAlleles() {
+        if ( !hasGenotypes() )
+            return;
+
+        List<Allele> reportedAlleles = getAlleles();
+        Set<Allele> observedAlleles = new HashSet<Allele>();
+        observedAlleles.add(getReference());
+        for ( Genotype g : getGenotypes().values() ) {
+            if ( g.isCalled() )
+                observedAlleles.addAll(g.getAlleles());
+        }
+
+        if ( reportedAlleles.size() != observedAlleles.size() )
+            throw new TribbleException.InternalCodecException(String.format("the ALT allele(s) for the record at position %s:%d do not match what is observed in the per-sample genotypes", getChr(), getStart()));
+
+        int originalSize = reportedAlleles.size();
+        // take the intersection and see if things change
+        observedAlleles.retainAll(reportedAlleles);
+        if ( observedAlleles.size() != originalSize )
+            throw new TribbleException.InternalCodecException(String.format("the ALT allele(s) for the record at position %s:%d do not match what is observed in the per-sample genotypes", getChr(), getStart()));
+    }
+
+    public void validateChromosomeCounts() {
+        Map<String, Object> observedAttrs = calculateChromosomeCounts();
+
+        // AN
+        if ( hasAttribute(VCFConstants.ALLELE_NUMBER_KEY) ) {
+            int reportedAN = Integer.valueOf(getAttribute(VCFConstants.ALLELE_NUMBER_KEY).toString());
+            int observedAN = (Integer)observedAttrs.get(VCFConstants.ALLELE_NUMBER_KEY);
+            if ( reportedAN != observedAN )
+                throw new TribbleException.InternalCodecException(String.format("the Allele Number (AN) tag is incorrect for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedAN, observedAN));
+        }
+
+        // AC
+        if ( hasAttribute(VCFConstants.ALLELE_COUNT_KEY) ) {
+            List<Integer> observedACs = (List<Integer>)observedAttrs.get(VCFConstants.ALLELE_COUNT_KEY);
+            if ( getAttribute(VCFConstants.ALLELE_COUNT_KEY) instanceof List ) {
+                Collections.sort(observedACs);
+                List reportedACs = (List)getAttribute(VCFConstants.ALLELE_COUNT_KEY);
+                Collections.sort(reportedACs);
+                if ( observedACs.size() != reportedACs.size() )
+                    throw new TribbleException.InternalCodecException(String.format("the Allele Count (AC) tag doesn't have the correct number of values for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedACs.size(), observedACs.size()));
+                for (int i = 0; i < observedACs.size(); i++) {
+                    if ( Integer.valueOf(reportedACs.get(i).toString()) != observedACs.get(i) )
+                        throw new TribbleException.InternalCodecException(String.format("the Allele Count (AC) tag is incorrect for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedACs.get(i), observedACs.get(i)));
+                }
+            } else {
+                if ( observedACs.size() != 1 )
+                    throw new TribbleException.InternalCodecException(String.format("the Allele Count (AC) tag doesn't have enough values for the record at position %s:%d", getChr(), getStart()));
+                int reportedAC = Integer.valueOf(getAttribute(VCFConstants.ALLELE_COUNT_KEY).toString());
+                if ( reportedAC != observedACs.get(0) )
+                    throw new TribbleException.InternalCodecException(String.format("the Allele Count (AC) tag is incorrect for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedAC, observedACs.get(0)));
+            }
+        }
+    }
+
+    private Map<String, Object> calculateChromosomeCounts() {
+        Map<String, Object> attributes = new HashMap<String, Object>();
+
+        attributes.put(VCFConstants.ALLELE_NUMBER_KEY, getChromosomeCount());
+        ArrayList<Double> alleleFreqs = new ArrayList<Double>();
+        ArrayList<Integer> alleleCounts = new ArrayList<Integer>();
+
+        // if there are alternate alleles, record the relevant tags
+        if ( getAlternateAlleles().size() > 0 ) {
+            for ( Allele allele : getAlternateAlleles() ) {
+                alleleCounts.add(getChromosomeCount(allele));
+                alleleFreqs.add((double)getChromosomeCount(allele) / (double)getChromosomeCount());
+            }
+        }
+        // otherwise, set them to 0
+        else {
+            alleleCounts.add(0);
+            alleleFreqs.add(0.0);
+        }
+
+        attributes.put(VCFConstants.ALLELE_COUNT_KEY, alleleCounts);
+        attributes.put(VCFConstants.ALLELE_FREQUENCY_KEY, alleleFreqs);
+        return attributes;
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // validation: the normal validation routines are called automatically upon creation of the VC
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    /**
+     * To be called by any modifying routines
+     */
+    private boolean validate() {
+        return validate(true);
+    }
+
+    private boolean validate(boolean throwException) {
+        try {
+            validateReferencePadding();
+            validateAlleles();
+            validateGenotypes();
+        } catch ( IllegalArgumentException e ) {
+            if ( throwException )
+                throw e;
+            else
+                return false;
+        }
+
+        return true;
+    }
+
+    private void validateReferencePadding() {
+        if (hasSymbolicAlleles()) // symbolic alleles don't need padding...
+            return;
+
+        boolean needsPadding = (getReference().length() == getEnd() - getStart()); // off by one because padded base was removed
+
+        if ( needsPadding && !hasReferenceBaseForIndel() )
+            throw new ReviewedStingException("Badly formed variant context at location " + getChr() + ":" + getStart() + "; no padded reference base was provided.");
+    }
+
+    private void validateAlleles() {
+        // check alleles
+        boolean alreadySeenRef = false, alreadySeenNull = false;
+        for ( Allele allele : alleles ) {
+            // make sure there's only one reference allele
+            if ( allele.isReference() ) {
+                if ( alreadySeenRef ) throw new IllegalArgumentException("BUG: Received two reference tagged alleles in VariantContext " + alleles + " this=" + this);
+                alreadySeenRef = true;
+            }
+
+            if ( allele.isNoCall() ) {
+                throw new IllegalArgumentException("BUG: Cannot add a no call allele to a variant context " + alleles + " this=" + this);
+            }
+
+            // make sure there's only one null allele
+            if ( allele.isNull() ) {
+                if ( alreadySeenNull ) throw new IllegalArgumentException("BUG: Received two null alleles in VariantContext " + alleles + " this=" + this);
+                alreadySeenNull = true;
+            }
+        }
+
+        // make sure there's one reference allele
+        if ( ! alreadySeenRef )
+            throw new IllegalArgumentException("No reference allele found in VariantContext");
+
+//        if ( getType() == Type.INDEL ) {
+//            if ( getReference().length() != (getLocation().size()-1) ) {
+        long length = (stop - start) + 1;
+        if ( (getReference().isNull() && length != 1 ) ||
+                (getReference().isNonNull() && (length - getReference().length()  > 1))) {
+            throw new IllegalStateException("BUG: GenomeLoc " + contig + ":" + start + "-" + stop + " has a size == " + length + " but the variation reference allele has length " + getReference().length() + " this = " + this);
+        }
+    }
+
+    private void validateGenotypes() {
+        if ( this.genotypes == null ) throw new IllegalStateException("Genotypes is null");
+
+        for ( Map.Entry<String, Genotype> elt : this.genotypes.entrySet() ) {
+            String name = elt.getKey();
+            Genotype g = elt.getValue();
+
+            if ( ! name.equals(g.getSampleName()) ) throw new IllegalStateException("Bound sample name " + name + " does not equal the name of the genotype " + g.getSampleName());
+
+            if ( g.isAvailable() ) {
+                for ( Allele gAllele : g.getAlleles() ) {
+                    if ( ! hasAllele(gAllele) && gAllele.isCalled() )
+                        throw new IllegalStateException("Allele in genotype " + gAllele + " not in the variant context " + alleles);
+                }
+            }
+        }
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // utility routines
+    //
+    // ---------------------------------------------------------------------------------------------------------
+
+    private void determineType() {
+        if ( type == null ) {
+            switch ( getNAlleles() ) {
+                case 0:
+                    throw new IllegalStateException("Unexpected error: requested type of VariantContext with no alleles!" + this);
+                case 1:
+                    // note that this doesn't require a reference allele.  You can be monomorphic independent of having a
+                    // reference allele
+                    type = Type.NO_VARIATION;
+                    break;
+                default:
+                    determinePolymorphicType();
+            }
+        }
+    }
+
+    private void determinePolymorphicType() {
+        type = null;
+
+        // do a pairwise comparison of all alleles against the reference allele
+        for ( Allele allele : alleles ) {
+            if ( allele == REF )
+                continue;
+
+            // find the type of this allele relative to the reference
+            Type biallelicType = typeOfBiallelicVariant(REF, allele);
+
+            // for the first alternate allele, set the type to be that one
+            if ( type == null ) {
+                type = biallelicType;
+            }
+            // if the type of this allele is different from that of a previous one, assign it the MIXED type and quit
+            else if ( biallelicType != type ) {
+                type = Type.MIXED;
+                return;
+            }
+        }
+    }
+
+    private static Type typeOfBiallelicVariant(Allele ref, Allele allele) {
+        if ( ref.isSymbolic() )
+            throw new IllegalStateException("Unexpected error: encountered a record with a symbolic reference allele");
+
+        if ( allele.isSymbolic() )
+            return Type.SYMBOLIC;
+
+        if ( ref.length() == allele.length() ) {
+            if ( allele.length() == 1 )
+                return Type.SNP;
+            else
+                return Type.MNP;
+        }
+
+        // Important note: previously we were checking that one allele is the prefix of the other.  However, that's not an
+        // appropriate check as can be seen from the following example:
+        // REF = CTTA and ALT = C,CT,CA
+        // This should be assigned the INDEL type but was being marked as a MIXED type because of the prefix check.
+        // In truth, it should be absolutely impossible to return a MIXED type from this method because it simply
+        // performs a pairwise comparison of a single alternate allele against the reference allele (whereas the MIXED type
+        // is reserved for cases of multiple alternate alleles of different types).  Therefore, if we've reached this point
+        // in the code (so we're not a SNP, MNP, or symbolic allele), we absolutely must be an INDEL.
+        return Type.INDEL;
+
+        // old incorrect logic:
+        // if (oneIsPrefixOfOther(ref, allele))
+        //     return Type.INDEL;
+        // else
+        //     return Type.MIXED;
+    }
+
+    public String toString() {
+        return String.format("[VC %s @ %s of type=%s alleles=%s attr=%s GT=%s",
+                getSource(), contig + ":" + (start - stop == 0 ? start : start + "-" + stop), this.getType(),
+                ParsingUtils.sortList(this.getAlleles()), ParsingUtils.sortedString(this.getAttributes()), this.getGenotypesSortedByName());
+    }
+
+    // protected basic manipulation routines
+    private static List<Allele> makeAlleles(Collection<Allele> alleles) {
+        final List<Allele> alleleList = new ArrayList<Allele>(alleles.size());
+
+        boolean sawRef = false;
+        for ( final Allele a : alleles ) {
+            for ( final Allele b : alleleList ) {
+                if ( a.equals(b, true) )
+                    throw new IllegalArgumentException("Duplicate allele added to VariantContext: " + a);
+            }
+
+            // deal with the case where the first allele isn't the reference
+            if ( a.isReference() ) {
+                if ( sawRef )
+                    throw new IllegalArgumentException("Alleles for a VariantContext must contain at most one reference allele: " + alleles);
+                alleleList.add(0, a);
+                sawRef = true;
+            }
+            else
+                alleleList.add(a);
+        }
+
+        if ( alleleList.isEmpty() )
+            throw new IllegalArgumentException("Cannot create a VariantContext with an empty allele list");
+
+        if ( alleleList.get(0).isNonReference() )
+            throw new IllegalArgumentException("Alleles for a VariantContext must contain at least one reference allele: " + alleles);
+
+        return alleleList;
+    }
+
+    public static Map<String, Genotype> genotypeCollectionToMap(Map<String, Genotype> dest, Collection<Genotype> genotypes) {
+        for ( Genotype g : genotypes ) {
+            if ( dest.containsKey(g.getSampleName() ) )
+                throw new IllegalArgumentException("Duplicate genotype added to VariantContext: " + g);
+            dest.put(g.getSampleName(), g);
+        }
+
+        return dest;
+    }
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // tribble integration routines -- not for public consumption
+    //
+    // ---------------------------------------------------------------------------------------------------------
+    public String getChr() {
+        return contig;
+    }
+
+    public int getStart() {
+        return (int)start;
+    }
+
+    public int getEnd() {
+        return (int)stop;
+    }
+
+    private boolean hasSymbolicAlleles() {
+        for (Allele a: getAlleles()) {
+            if (a.isSymbolic()) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    public static VariantContext createVariantContextWithPaddedAlleles(VariantContext inputVC, boolean refBaseShouldBeAppliedToEndOfAlleles) {
+
+        // see if we need to pad common reference base from all alleles
+        boolean padVC;
+
+        // We need to pad a VC with a common base if the length of the reference allele is less than the length of the VariantContext.
+        // This happens because the position of e.g. an indel is always one before the actual event (as per VCF convention).
+        long locLength = (inputVC.getEnd() - inputVC.getStart()) + 1;
+        if (inputVC.hasSymbolicAlleles())
+            padVC = true;
+        else if (inputVC.getReference().length() == locLength)
+            padVC = false;
+        else if (inputVC.getReference().length() == locLength-1)
+            padVC = true;
+        else throw new IllegalArgumentException("Badly formed variant context at location " + String.valueOf(inputVC.getStart()) +
+                    " in contig " + inputVC.getChr() + ". Reference length must be at most one base shorter than location size");
+
+        // nothing to do if we don't need to pad bases
+        if (padVC) {
+
+            if ( !inputVC.hasReferenceBaseForIndel() )
+                throw new ReviewedStingException("Badly formed variant context at location " + inputVC.getChr() + ":" + inputVC.getStart() + "; no padded reference base is available.");
+
+            Byte refByte = inputVC.getReferenceBaseForIndel();
+
+            List<Allele> alleles = new ArrayList<Allele>();
+            Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
+
+            Map<String, Genotype> inputGenotypes = inputVC.getGenotypes();
+
+            for (Allele a : inputVC.getAlleles()) {
+                // get bases for current allele and create a new one with trimmed bases
+                if (a.isSymbolic()) {
+                    alleles.add(a);
+                } else {
+                    String newBases;
+                    if ( refBaseShouldBeAppliedToEndOfAlleles )
+                        newBases = a.getBaseString() + new String(new byte[]{refByte});
+                    else
+                        newBases = new String(new byte[]{refByte}) + a.getBaseString();
+                    alleles.add(Allele.create(newBases,a.isReference()));
+                }
+            }
+
+            // now we can recreate new genotypes with trimmed alleles
+            for (String sample : inputVC.getSampleNames()) {
+                Genotype g = inputGenotypes.get(sample);
+
+                List<Allele> inAlleles = g.getAlleles();
+                List<Allele> newGenotypeAlleles = new ArrayList<Allele>();
+                for (Allele a : inAlleles) {
+                    if (a.isCalled()) {
+                        if (a.isSymbolic()) {
+                            newGenotypeAlleles.add(a);
+                        } else {
+                            String newBases;
+                            if ( refBaseShouldBeAppliedToEndOfAlleles )
+                                newBases = a.getBaseString() + new String(new byte[]{refByte});
+                            else
+                                newBases = new String(new byte[]{refByte}) + a.getBaseString();
+                            newGenotypeAlleles.add(Allele.create(newBases,a.isReference()));
+                        }
+                    }
+                    else {
+                        // add no-call allele
+                        newGenotypeAlleles.add(Allele.NO_CALL);
+                    }
+                }
+                genotypes.put(sample, new Genotype(sample, newGenotypeAlleles, g.getNegLog10PError(),
+                        g.getFilters(),g.getAttributes(),g.isPhased()));
+
+            }
+
+            // Do not change the filter state if filters were not applied to this context
+            Set<String> inputVCFilters = inputVC.filtersWereAppliedToContext ? inputVC.getFilters() : null;
+            return new VariantContext(inputVC.getSource(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVCFilters, inputVC.getAttributes(),refByte);
+        }
+        else
+            return inputVC;
+
+    }
+
+    public ArrayList<Allele> getTwoAllelesWithHighestAlleleCounts() {
+        // first idea: get two alleles with highest AC
+        int maxAC1 = 0, maxAC2=0,maxAC1ind =0, maxAC2ind = 0;
+        int i=0;
+        int[] alleleCounts = new int[this.getAlleles().size()];
+        ArrayList<Allele> alleleArray = new ArrayList<Allele>();
+        for (Allele a:this.getAlleles()) {
+            int ac = this.getChromosomeCount(a);
+            if (ac >=maxAC1) {
+                maxAC1 = ac;
+                maxAC1ind = i;
+            }
+            alleleArray.add(a);
+            alleleCounts[i++] = ac;
+        }
+        // now get second best allele
+        for (i=0; i < alleleCounts.length; i++) {
+            if (i == maxAC1ind)
+                continue;
+            if (alleleCounts[i] >= maxAC2) {
+                maxAC2 = alleleCounts[i];
+                maxAC2ind = i;
+            }
+        }
+
+        Allele alleleA, alleleB;
+        if (alleleArray.get(maxAC1ind).isReference()) {
+            alleleA = alleleArray.get(maxAC1ind);
+            alleleB = alleleArray.get(maxAC2ind);
+        }
+        else if  (alleleArray.get(maxAC2ind).isReference()) {
+            alleleA = alleleArray.get(maxAC2ind);
+            alleleB = alleleArray.get(maxAC1ind);
+        } else {
+            alleleA = alleleArray.get(maxAC1ind);
+            alleleB = alleleArray.get(maxAC2ind);
+        }
+        ArrayList<Allele> a = new ArrayList<Allele>();
+        a.add(alleleA);
+        a.add(alleleB);
+        return a;
+    }
+    public Allele getAltAlleleWithHighestAlleleCount() {
+        // first idea: get two alleles with highest AC
+        Allele best = null;
+        int maxAC1 = 0;
+        for (Allele a:this.getAlternateAlleles()) {
+            int ac = this.getChromosomeCount(a);
+            if (ac >=maxAC1) {
+                maxAC1 = ac;
+                best = a;
+            }
+
+        }
+        return best;
+    }
+
+    public int[] getGLIndecesOfAllele(Allele inputAllele) {
+        int[] idxVector = new int[3];
+        int numAlleles =  this.getAlleles().size();
+
+        int idxDiag = numAlleles;
+        int incr = numAlleles - 1;
+        int k=1;
+        for (Allele a: getAlternateAlleles()) {
+            // multi-allelic approximation, part 1: Ideally
+            // for each alt allele compute marginal (suboptimal) posteriors -
+            // compute indices for AA,AB,BB for current allele - genotype likelihoods are a linear vector that can be thought of
+            // as a row-wise upper triangular matrix of likelihoods.
+            // So, for example, with 2 alt alleles, likelihoods have AA,AB,AC,BB,BC,CC.
+            // 3 alt alleles: AA,AB,AC,AD BB BC BD CC CD DD
+
+            int idxAA = 0;
+            int idxAB = k++;
+            // yy is always element on the diagonal.
+            // 2 alleles: BBelement 2
+            // 3 alleles: BB element  3. CC element 5
+            // 4 alleles:
+            int idxBB = idxDiag;
+
+            if (a.equals(inputAllele)) {
+                idxVector[0] = idxAA;
+                idxVector[1] = idxAB;
+                idxVector[2]  = idxBB;
+                break;
+            }
+            idxDiag += incr--;
+        }
+        return idxVector;
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContextUtils.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContextUtils.java
new file mode 100755
index 000000000..e2cf2ecf0
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContextUtils.java
@@ -0,0 +1,1407 @@
+/*
+ * Copyright (c) 2010.  The Broad Institute
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import com.google.java.contract.Ensures;
+import com.google.java.contract.Requires;
+import net.sf.picard.reference.ReferenceSequenceFile;
+import net.sf.samtools.util.StringUtil;
+import org.apache.commons.jexl2.Expression;
+import org.apache.commons.jexl2.JexlEngine;
+import org.apache.log4j.Logger;
+import org.broad.tribble.util.popgen.HardyWeinbergCalculation;
+import org.broadinstitute.sting.gatk.walkers.phasing.ReadBackedPhasingWalker;
+import org.broadinstitute.sting.utils.BaseUtils;
+import org.broadinstitute.sting.utils.GenomeLoc;
+import org.broadinstitute.sting.utils.GenomeLocParser;
+import org.broadinstitute.sting.utils.Utils;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+import org.broadinstitute.sting.utils.exceptions.UserException;
+
+import java.io.Serializable;
+import java.util.*;
+
+public class VariantContextUtils {
+    private static Logger logger = Logger.getLogger(VariantContextUtils.class);
+    public final static String MERGE_INTERSECTION = "Intersection";
+    public final static String MERGE_FILTER_IN_ALL = "FilteredInAll";
+    public final static String MERGE_REF_IN_ALL = "ReferenceInAll";
+    public final static String MERGE_FILTER_PREFIX = "filterIn";
+
+    final public static JexlEngine engine = new JexlEngine();
+    static {
+        engine.setSilent(false); // will throw errors now for selects that don't evaluate properly
+        engine.setLenient(false);
+    }
+
+    /**
+     * Create a new VariantContext
+     *
+     * @param name            name
+     * @param loc             location
+     * @param alleles         alleles
+     * @param genotypes       genotypes set
+     * @param negLog10PError  qual
+     * @param filters         filters: use null for unfiltered and empty set for passes filters
+     * @param attributes      attributes
+     * @return VariantContext object
+     */
+    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
+        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes != null ? VariantContext.genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes);
+    }
+
+    /**
+     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
+     * @param name            name
+     * @param loc             location
+     * @param alleles         alleles
+     * @return VariantContext object
+     */
+    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles) {
+        return new VariantContext (name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, VariantContext.NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
+    }
+
+    /**
+     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
+     * @param name            name
+     * @param loc             location
+     * @param alleles         alleles
+     * @param genotypes       genotypes
+     * @return VariantContext object
+     */
+    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes) {
+        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
+    }
+
+    /**
+     * Copy constructor
+     *
+     * @param other the VariantContext to copy
+     * @return VariantContext object
+     */
+    public static VariantContext toVC(VariantContext other) {
+        return new VariantContext(other.getSource(), other.getChr(), other.getStart(), other.getEnd(), other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.getFilters(), other.getAttributes());
+    }
+
+    /**
+     * Update the attributes of the attributes map given the VariantContext to reflect the proper chromosome-based VCF tags
+     *
+     * @param vc          the VariantContext
+     * @param attributes  the attributes map to populate; must not be null; may contain old values
+     * @param removeStaleValues should we remove stale values from the mapping?
+     */
+    public static void calculateChromosomeCounts(VariantContext vc, Map<String, Object> attributes, boolean removeStaleValues) {
+        // if everyone is a no-call, remove the old attributes if requested
+        if ( vc.getChromosomeCount() == 0 && removeStaleValues ) {
+            if ( attributes.containsKey(VCFConstants.ALLELE_COUNT_KEY) )
+                attributes.remove(VCFConstants.ALLELE_COUNT_KEY);
+            if ( attributes.containsKey(VCFConstants.ALLELE_FREQUENCY_KEY) )
+                attributes.remove(VCFConstants.ALLELE_FREQUENCY_KEY);
+            if ( attributes.containsKey(VCFConstants.ALLELE_NUMBER_KEY) )
+                attributes.remove(VCFConstants.ALLELE_NUMBER_KEY);
+            return;
+        }
+
+        if ( vc.hasGenotypes() ) {
+            attributes.put(VCFConstants.ALLELE_NUMBER_KEY, vc.getChromosomeCount());
+
+            // if there are alternate alleles, record the relevant tags
+            if ( vc.getAlternateAlleles().size() > 0 ) {
+                ArrayList<String> alleleFreqs = new ArrayList<String>();
+                ArrayList<Integer> alleleCounts = new ArrayList<Integer>();
+                double totalChromosomes = (double)vc.getChromosomeCount();
+                for ( Allele allele : vc.getAlternateAlleles() ) {
+                    int altChromosomes = vc.getChromosomeCount(allele);
+                    alleleCounts.add(altChromosomes);
+                    String freq = String.format(makePrecisionFormatStringFromDenominatorValue(totalChromosomes), ((double)altChromosomes / totalChromosomes));
+                    alleleFreqs.add(freq);
+                }
+
+                attributes.put(VCFConstants.ALLELE_COUNT_KEY, alleleCounts.size() == 1 ? alleleCounts.get(0) : alleleCounts);
+                attributes.put(VCFConstants.ALLELE_FREQUENCY_KEY, alleleFreqs.size() == 1 ? alleleFreqs.get(0) : alleleFreqs);
+            }
+            else {
+                attributes.put(VCFConstants.ALLELE_COUNT_KEY, 0);
+                attributes.put(VCFConstants.ALLELE_FREQUENCY_KEY, 0.0);
+            }
+        }
+    }
+
+    private static String makePrecisionFormatStringFromDenominatorValue(double maxValue) {
+        int precision = 1;
+
+        while ( maxValue > 1 ) {
+            precision++;
+            maxValue /= 10.0;
+        }
+
+        return "%." + precision + "f";
+    }
+
+    public static Genotype removePLs(Genotype g) {
+        Map<String, Object> attrs = new HashMap<String, Object>(g.getAttributes());
+        attrs.remove(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY);
+        attrs.remove(VCFConstants.GENOTYPE_LIKELIHOODS_KEY);
+        return new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attrs, g.isPhased());
+    }
+
+    /**
+     * A simple but common wrapper for matching VariantContext objects using JEXL expressions
+     */
+    public static class JexlVCMatchExp {
+        public String name;
+        public Expression exp;
+
+        /**
+         * Create a new matcher expression with name and JEXL expression exp
+         * @param name name
+         * @param exp  expression
+         */
+        public JexlVCMatchExp(String name, Expression exp) {
+            this.name = name;
+            this.exp = exp;
+        }
+    }
+
+    /**
+     * Method for creating JexlVCMatchExp from input walker arguments names and exps.  These two arrays contain
+     * the name associated with each JEXL expression. initializeMatchExps will parse each expression and return
+     * a list of JexlVCMatchExp, in order, that correspond to the names and exps.  These are suitable input to
+     * match() below.
+     *
+     * @param names names
+     * @param exps  expressions
+     * @return list of matches
+     */
+    public static List<JexlVCMatchExp> initializeMatchExps(String[] names, String[] exps) {
+        if ( names == null || exps == null )
+            throw new ReviewedStingException("BUG: neither names nor exps can be null: names " + Arrays.toString(names) + " exps=" + Arrays.toString(exps) );
+
+        if ( names.length != exps.length )
+            throw new UserException("Inconsistent number of provided filter names and expressions: names=" + Arrays.toString(names) + " exps=" + Arrays.toString(exps));
+
+        Map<String, String> map = new HashMap<String, String>();
+        for ( int i = 0; i < names.length; i++ ) { map.put(names[i], exps[i]); }
+
+        return VariantContextUtils.initializeMatchExps(map);
+    }
+
+    public static List<JexlVCMatchExp> initializeMatchExps(ArrayList<String> names, ArrayList<String> exps) {
+        String[] nameArray = new String[names.size()];
+        String[] expArray = new String[exps.size()];
+        return initializeMatchExps(names.toArray(nameArray), exps.toArray(expArray));
+    }
+
+
+    /**
+     * Method for creating JexlVCMatchExp from input walker arguments mapping from names to exps.  These two arrays contain
+     * the name associated with each JEXL expression. initializeMatchExps will parse each expression and return
+     * a list of JexlVCMatchExp, in order, that correspond to the names and exps.  These are suitable input to
+     * match() below.
+     *
+     * @param names_and_exps mapping of names to expressions
+     * @return list of matches
+     */
+    public static List<JexlVCMatchExp> initializeMatchExps(Map<String, String> names_and_exps) {
+        List<JexlVCMatchExp> exps = new ArrayList<JexlVCMatchExp>();
+
+        for ( Map.Entry<String, String> elt : names_and_exps.entrySet() ) {
+            String name = elt.getKey();
+            String expStr = elt.getValue();
+
+            if ( name == null || expStr == null ) throw new IllegalArgumentException("Cannot create null expressions : " + name +  " " + expStr);
+            try {
+                Expression exp = engine.createExpression(expStr);
+                exps.add(new JexlVCMatchExp(name, exp));
+            } catch (Exception e) {
+                throw new UserException.BadArgumentValue(name, "Invalid expression used (" + expStr + "). Please see the JEXL docs for correct syntax.") ;
+            }
+        }
+
+        return exps;
+    }
+
+    /**
+     * Returns true if exp match VC.  See collection<> version for full docs.
+     * @param vc    variant context
+     * @param exp   expression
+     * @return true if there is a match
+     */
+    public static boolean match(VariantContext vc, JexlVCMatchExp exp) {
+        return match(vc,Arrays.asList(exp)).get(exp);
+    }
+
+    /**
+     * Matches each JexlVCMatchExp exp against the data contained in vc, and returns a map from these
+     * expressions to true (if they matched) or false (if they didn't).  This the best way to apply JEXL
+     * expressions to VariantContext records.  Use initializeMatchExps() to create the list of JexlVCMatchExp
+     * expressions.
+     *
+     * @param vc   variant context
+     * @param exps expressions
+     * @return true if there is a match
+     */
+    public static Map<JexlVCMatchExp, Boolean> match(VariantContext vc, Collection<JexlVCMatchExp> exps) {
+        return new JEXLMap(exps,vc);
+
+    }
+
+    /**
+     * Returns true if exp match VC/g.  See collection<> version for full docs.
+     * @param vc   variant context
+     * @param g    genotype
+     * @param exp   expression
+     * @return true if there is a match
+     */
+    public static boolean match(VariantContext vc, Genotype g, JexlVCMatchExp exp) {
+        return match(vc,g,Arrays.asList(exp)).get(exp);
+    }
+
+    /**
+     * Matches each JexlVCMatchExp exp against the data contained in vc/g, and returns a map from these
+     * expressions to true (if they matched) or false (if they didn't).  This the best way to apply JEXL
+     * expressions to VariantContext records/genotypes.  Use initializeMatchExps() to create the list of JexlVCMatchExp
+     * expressions.
+     *
+     * @param vc   variant context
+     * @param g    genotype
+     * @param exps expressions
+     * @return true if there is a match
+     */
+    public static Map<JexlVCMatchExp, Boolean> match(VariantContext vc, Genotype g, Collection<JexlVCMatchExp> exps) {
+        return new JEXLMap(exps,vc,g);
+    }
+
+    public static double computeHardyWeinbergPvalue(VariantContext vc) {
+        if ( vc.getChromosomeCount() == 0 )
+            return 0.0;
+        return HardyWeinbergCalculation.hwCalculate(vc.getHomRefCount(), vc.getHetCount(), vc.getHomVarCount());
+    }
+
+    /**
+     * Returns a newly allocated VC that is the same as VC, but without genotypes
+     * @param vc  variant context
+     * @return  new VC without genotypes
+     */
+    @Requires("vc != null")
+    @Ensures("result != null")
+    public static VariantContext sitesOnlyVariantContext(VariantContext vc) {
+        return VariantContext.modifyGenotypes(vc, null);
+    }
+
+    /**
+     * Returns a newly allocated list of VC, where each VC is the same as the input VCs, but without genotypes
+     * @param vcs  collection of VCs
+     * @return new VCs without genotypes
+     */
+    @Requires("vcs != null")
+    @Ensures("result != null")
+    public static Collection<VariantContext> sitesOnlyVariantContexts(Collection<VariantContext> vcs) {
+        List<VariantContext> r = new ArrayList<VariantContext>();
+        for ( VariantContext vc : vcs )
+            r.add(sitesOnlyVariantContext(vc));
+        return r;
+    }
+
+    public static VariantContext pruneVariantContext(VariantContext vc) {
+        return pruneVariantContext(vc, null);
+    }
+
+    public static VariantContext pruneVariantContext(final VariantContext vc, final Collection<String> keysToPreserve ) {
+        final MutableVariantContext mvc = new MutableVariantContext(vc);
+
+        if ( keysToPreserve == null || keysToPreserve.size() == 0 )
+            mvc.clearAttributes();
+        else {
+            final Map<String, Object> d = mvc.getAttributes();
+            mvc.clearAttributes();
+            for ( String key : keysToPreserve )
+                if ( d.containsKey(key) )
+                    mvc.putAttribute(key, d.get(key));
+        }
+
+        // this must be done as the ID is stored in the attributes field
+        if ( vc.hasID() ) mvc.setID(vc.getID());
+
+        Collection<Genotype> gs = mvc.getGenotypes().values();
+        mvc.clearGenotypes();
+        for ( Genotype g : gs ) {
+            MutableGenotype mg = new MutableGenotype(g);
+            mg.clearAttributes();
+            if ( keysToPreserve != null )
+                for ( String key : keysToPreserve )
+                    if ( g.hasAttribute(key) )
+                        mg.putAttribute(key, g.getAttribute(key));
+            mvc.addGenotype(mg);
+        }
+
+        return mvc;
+    }
+
+    public enum GenotypeMergeType {
+        /**
+         * Make all sample genotypes unique by file. Each sample shared across RODs gets named sample.ROD.
+         */
+        UNIQUIFY,
+        /**
+         * Take genotypes in priority order (see the priority argument).
+         */
+        PRIORITIZE,
+        /**
+         * Take the genotypes in any order.
+         */
+        UNSORTED,
+        /**
+         * Require that all samples/genotypes be unique between all inputs.
+         */
+        REQUIRE_UNIQUE
+    }
+
+    public enum FilteredRecordMergeType {
+        /**
+         * Union - leaves the record if any record is unfiltered.
+         */
+        KEEP_IF_ANY_UNFILTERED,
+        /**
+         * Requires all records present at site to be unfiltered. VCF files that don't contain the record don't influence this.
+         */
+        KEEP_IF_ALL_UNFILTERED
+    }
+
+    /**
+     * Performs a master merge on the VCs.  Here there is a master input [contains all of the information] and many
+     * VCs containing partial, extra genotype information which should be added to the master.  For example,
+     * we scatter out the phasing algorithm over some samples in the master, producing a minimal VCF with phasing
+     * information per genotype.  The master merge will add the PQ information from each genotype record, where
+     * appropriate, to the master VC.
+     *
+     * @param unsortedVCs   collection of VCs
+     * @param masterName    name of master VC
+     * @return  master-merged VC
+     */
+    public static VariantContext masterMerge(Collection<VariantContext> unsortedVCs, String masterName) {
+        VariantContext master = findMaster(unsortedVCs, masterName);
+        Map<String, Genotype> genotypes = master.getGenotypes();
+        for (Genotype g : genotypes.values()) {
+            genotypes.put(g.getSampleName(), new MutableGenotype(g));
+        }
+
+        Map<String, Object> masterAttributes = new HashMap<String, Object>(master.getAttributes());
+
+        for (VariantContext vc : unsortedVCs) {
+            if (!vc.getSource().equals(masterName)) {
+                for (Genotype g : vc.getGenotypes().values()) {
+                    MutableGenotype masterG = (MutableGenotype) genotypes.get(g.getSampleName());
+                    for (Map.Entry<String, Object> attr : g.getAttributes().entrySet()) {
+                        if (!masterG.hasAttribute(attr.getKey())) {
+                            //System.out.printf("Adding GT attribute %s to masterG %s, new %s%n", attr, masterG, g);
+                            masterG.putAttribute(attr.getKey(), attr.getValue());
+                        }
+                    }
+
+                    if (masterG.isPhased() != g.isPhased()) {
+                        if (masterG.sameGenotype(g)) {
+                            // System.out.printf("Updating phasing %s to masterG %s, new %s%n", g.isPhased(), masterG, g);
+                            masterG.setAlleles(g.getAlleles());
+                            masterG.setPhase(g.isPhased());
+                        }
+                        //else System.out.println("WARNING: Not updating phase, since genotypes differ between master file and auxiliary info file!");
+                    }
+
+//                    if ( MathUtils.compareDoubles(masterG.getNegLog10PError(), g.getNegLog10PError()) != 0 ) {
+//                        System.out.printf("Updating GQ %s to masterG %s, new %s%n", g.getNegLog10PError(), masterG, g);
+//                        masterG.setNegLog10PError(g.getNegLog10PError());
+//                    }
+
+                }
+
+                for (Map.Entry<String, Object> attr : vc.getAttributes().entrySet()) {
+                    if (!masterAttributes.containsKey(attr.getKey())) {
+                        //System.out.printf("Adding VC attribute %s to master %s, new %s%n", attr, master, vc);
+                        masterAttributes.put(attr.getKey(), attr.getValue());
+                    }
+                }
+            }
+        }
+
+        return new VariantContext(master.getSource(), master.getChr(), master.getStart(), master.getEnd(), master.getAlleles(), genotypes, master.getNegLog10PError(), master.getFilters(), masterAttributes);
+    }
+
+    private static VariantContext findMaster(Collection<VariantContext> unsortedVCs, String masterName) {
+        for (VariantContext vc : unsortedVCs) {
+            if (vc.getSource().equals(masterName)) {
+                return vc;
+            }
+        }
+
+        throw new ReviewedStingException(String.format("Couldn't find master VCF %s at %s", masterName, unsortedVCs.iterator().next()));
+    }
+
+    /**
+     * Merges VariantContexts into a single hybrid.  Takes genotypes for common samples in priority order, if provided.
+     * If uniqifySamples is true, the priority order is ignored and names are created by concatenating the VC name with
+     * the sample name
+     *
+     * @param genomeLocParser           loc parser
+     * @param unsortedVCs               collection of unsorted VCs
+     * @param priorityListOfVCs         priority list detailing the order in which we should grab the VCs
+     * @param filteredRecordMergeType   merge type for filtered records
+     * @param genotypeMergeOptions      merge option for genotypes
+     * @param annotateOrigin            should we annotate the set it came from?
+     * @param printMessages             should we print messages?
+     * @param setKey                    the key name of the set
+     * @param filteredAreUncalled       are filtered records uncalled?
+     * @param mergeInfoWithMaxAC        should we merge in info from the VC with maximum allele count?
+     * @return new VariantContext       representing the merge of unsortedVCs
+     */
+    public static VariantContext simpleMerge(final GenomeLocParser genomeLocParser,
+                                             final Collection<VariantContext> unsortedVCs,
+                                             final List<String> priorityListOfVCs,
+                                             final FilteredRecordMergeType filteredRecordMergeType,
+                                             final GenotypeMergeType genotypeMergeOptions,
+                                             final boolean annotateOrigin,
+                                             final boolean printMessages,
+                                             final String setKey,
+                                             final boolean filteredAreUncalled,
+                                             final boolean mergeInfoWithMaxAC ) {
+        if ( unsortedVCs == null || unsortedVCs.size() == 0 )
+            return null;
+
+        if ( annotateOrigin && priorityListOfVCs == null )
+            throw new IllegalArgumentException("Cannot merge calls and annotate their origins without a complete priority list of VariantContexts");
+
+        if ( genotypeMergeOptions == GenotypeMergeType.REQUIRE_UNIQUE )
+            verifyUniqueSampleNames(unsortedVCs);
+
+        List<VariantContext> prepaddedVCs = sortVariantContextsByPriority(unsortedVCs, priorityListOfVCs, genotypeMergeOptions);
+        // Make sure all variant contexts are padded with reference base in case of indels if necessary
+        List<VariantContext> VCs = new ArrayList<VariantContext>();
+
+        for (VariantContext vc : prepaddedVCs) {
+            // also a reasonable place to remove filtered calls, if needed
+            if ( ! filteredAreUncalled || vc.isNotFiltered() )
+                VCs.add(VariantContext.createVariantContextWithPaddedAlleles(vc, false));
+        }
+        if ( VCs.size() == 0 ) // everything is filtered out and we're filteredAreUncalled
+            return null;
+
+        // establish the baseline info from the first VC
+        final VariantContext first = VCs.get(0);
+        final String name = first.getSource();
+        final Allele refAllele = determineReferenceAllele(VCs);
+
+        final Set<Allele> alleles = new LinkedHashSet<Allele>();
+        final Set<String> filters = new TreeSet<String>();
+        final Map<String, Object> attributes = new TreeMap<String, Object>();
+        final Set<String> inconsistentAttributes = new HashSet<String>();
+        final Set<String> variantSources = new HashSet<String>(); // contains the set of sources we found in our set of VCs that are variant
+        final Set<String> rsIDs = new LinkedHashSet<String>(1); // most of the time there's one id
+
+        GenomeLoc loc = getLocation(genomeLocParser,first);
+        int depth = 0;
+        int maxAC = -1;
+        final Map<String, Object> attributesWithMaxAC = new TreeMap<String, Object>();
+        double negLog10PError = -1;
+        VariantContext vcWithMaxAC = null;
+        Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
+
+        // counting the number of filtered and variant VCs
+        int nFiltered = 0;
+
+        boolean remapped = false;
+
+        // cycle through and add info from the other VCs, making sure the loc/reference matches
+
+        for ( VariantContext vc : VCs ) {
+            if ( loc.getStart() != vc.getStart() ) // || !first.getReference().equals(vc.getReference()) )
+                throw new ReviewedStingException("BUG: attempting to merge VariantContexts with different start sites: first="+ first.toString() + " second=" + vc.toString());
+
+            if ( getLocation(genomeLocParser,vc).size() > loc.size() )
+                loc = getLocation(genomeLocParser,vc); // get the longest location
+
+            nFiltered += vc.isFiltered() ? 1 : 0;
+            if ( vc.isVariant() ) variantSources.add(vc.getSource());
+
+            AlleleMapper alleleMapping = resolveIncompatibleAlleles(refAllele, vc, alleles);
+            remapped = remapped || alleleMapping.needsRemapping();
+
+            alleles.addAll(alleleMapping.values());
+
+            mergeGenotypes(genotypes, vc, alleleMapping, genotypeMergeOptions == GenotypeMergeType.UNIQUIFY);
+
+            negLog10PError = Math.max(negLog10PError, vc.isVariant() ? vc.getNegLog10PError() : -1);
+
+            filters.addAll(vc.getFilters());
+
+            //
+            // add attributes
+            //
+            // special case DP (add it up) and ID (just preserve it)
+            //
+            if (vc.hasAttribute(VCFConstants.DEPTH_KEY))
+                depth += vc.getAttributeAsInt(VCFConstants.DEPTH_KEY, 0);
+            if ( vc.hasID() && ! vc.getID().equals(VCFConstants.EMPTY_ID_FIELD) ) rsIDs.add(vc.getID());
+            if (mergeInfoWithMaxAC && vc.hasAttribute(VCFConstants.ALLELE_COUNT_KEY)) {
+                String rawAlleleCounts = vc.getAttributeAsString(VCFConstants.ALLELE_COUNT_KEY, null);
+                // lets see if the string contains a , separator
+                if (rawAlleleCounts.contains(VCFConstants.INFO_FIELD_ARRAY_SEPARATOR)) {
+                    List<String> alleleCountArray = Arrays.asList(rawAlleleCounts.substring(1, rawAlleleCounts.length() - 1).split(VCFConstants.INFO_FIELD_ARRAY_SEPARATOR));
+                    for (String alleleCount : alleleCountArray) {
+                        final int ac = Integer.valueOf(alleleCount.trim());
+                        if (ac > maxAC) {
+                            maxAC = ac;
+                            vcWithMaxAC = vc;
+                        }
+                    }
+                } else {
+                    final int ac = Integer.valueOf(rawAlleleCounts);
+                    if (ac > maxAC) {
+                        maxAC = ac;
+                        vcWithMaxAC = vc;
+                    }
+                }
+            }
+
+            for (Map.Entry<String, Object> p : vc.getAttributes().entrySet()) {
+                String key = p.getKey();
+                // if we don't like the key already, don't go anywhere
+                if ( ! inconsistentAttributes.contains(key) ) {
+                    boolean alreadyFound = attributes.containsKey(key);
+                    Object boundValue = attributes.get(key);
+                    boolean boundIsMissingValue = alreadyFound && boundValue.equals(VCFConstants.MISSING_VALUE_v4);
+
+                    if ( alreadyFound && ! boundValue.equals(p.getValue()) && ! boundIsMissingValue ) {
+                        // we found the value but we're inconsistent, put it in the exclude list
+                        //System.out.printf("Inconsistent INFO values: %s => %s and %s%n", key, boundValue, p.getValue());
+                        inconsistentAttributes.add(key);
+                        attributes.remove(key);
+                    } else if ( ! alreadyFound || boundIsMissingValue )  { // no value
+                        //if ( vc != first ) System.out.printf("Adding key %s => %s%n", p.getKey(), p.getValue());
+                        attributes.put(key, p.getValue());
+                    }
+                }
+            }
+        }
+
+        // if we have more alternate alleles in the merged VC than in one or more of the
+        // original VCs, we need to strip out the GL/PLs (because they are no longer accurate), as well as allele-dependent attributes like AC,AF
+        for ( VariantContext vc : VCs ) {
+            if (vc.alleles.size() == 1)
+                continue;
+            if ( hasPLIncompatibleAlleles(alleles, vc.alleles)) {
+                logger.warn(String.format("Stripping PLs at %s due incompatible alleles merged=%s vs. single=%s",
+                        genomeLocParser.createGenomeLoc(vc), alleles, vc.alleles));
+                genotypes = stripPLs(genotypes);
+                // this will remove stale AC,AF attributed from vc
+                calculateChromosomeCounts(vc, attributes, true);
+                break;
+            }
+        }
+
+        // take the VC with the maxAC and pull the attributes into a modifiable map
+        if ( mergeInfoWithMaxAC && vcWithMaxAC != null ) {
+            attributesWithMaxAC.putAll(vcWithMaxAC.getAttributes());
+        }
+
+        // if at least one record was unfiltered and we want a union, clear all of the filters
+        if ( filteredRecordMergeType == FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED && nFiltered != VCs.size() )
+            filters.clear();
+
+
+        if ( annotateOrigin ) { // we care about where the call came from
+            String setValue;
+            if ( nFiltered == 0 && variantSources.size() == priorityListOfVCs.size() ) // nothing was unfiltered
+                setValue = MERGE_INTERSECTION;
+            else if ( nFiltered == VCs.size() )     // everything was filtered out
+                setValue = MERGE_FILTER_IN_ALL;
+            else if ( variantSources.isEmpty() )               // everyone was reference
+                setValue = MERGE_REF_IN_ALL;
+            else {
+                LinkedHashSet<String> s = new LinkedHashSet<String>();
+                for ( VariantContext vc : VCs )
+                    if ( vc.isVariant() )
+                        s.add( vc.isFiltered() ? MERGE_FILTER_PREFIX + vc.getSource() : vc.getSource() );
+                setValue = Utils.join("-", s);
+            }
+
+            if ( setKey != null ) {
+                attributes.put(setKey, setValue);
+                if( mergeInfoWithMaxAC && vcWithMaxAC != null ) { attributesWithMaxAC.put(setKey, vcWithMaxAC.getSource()); }
+            }
+        }
+
+        if ( depth > 0 )
+            attributes.put(VCFConstants.DEPTH_KEY, String.valueOf(depth));
+
+        if ( ! rsIDs.isEmpty() ) {
+            attributes.put(VariantContext.ID_KEY, Utils.join(",", rsIDs));
+        }
+
+        VariantContext merged = new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, negLog10PError, filters, (mergeInfoWithMaxAC ? attributesWithMaxAC : attributes) );
+        // Trim the padded bases of all alleles if necessary
+        merged = createVariantContextWithTrimmedAlleles(merged);
+
+        if ( printMessages && remapped ) System.out.printf("Remapped => %s%n", merged);
+        return merged;
+    }
+
+    private static final boolean hasPLIncompatibleAlleles(final Collection<Allele> alleleSet1, final Collection<Allele> alleleSet2) {
+        final Iterator<Allele> it1 = alleleSet1.iterator();
+        final Iterator<Allele> it2 = alleleSet2.iterator();
+
+        while ( it1.hasNext() && it2.hasNext() ) {
+            final Allele a1 = it1.next();
+            final Allele a2 = it2.next();
+            if ( ! a1.equals(a2) )
+                return true;
+        }
+
+        // by this point, at least one of the iterators is empty.  All of the elements
+        // we've compared are equal up until this point.  But it's possible that the
+        // sets aren't the same size, which is indicated by the test below.  If they
+        // are of the same size, though, the sets are compatible
+        return it1.hasNext() || it2.hasNext();
+    }
+
+    public static boolean allelesAreSubset(VariantContext vc1, VariantContext vc2) {
+        // if all alleles of vc1 are a contained in alleles of vc2, return true
+        if (!vc1.getReference().equals(vc2.getReference()))
+            return false;
+
+        for (Allele a :vc1.getAlternateAlleles()) {
+            if (!vc2.getAlternateAlleles().contains(a))
+                return false;
+        }
+
+        return true;
+    }
+    public static VariantContext createVariantContextWithTrimmedAlleles(VariantContext inputVC) {
+        // see if we need to trim common reference base from all alleles
+        boolean trimVC;
+
+        // We need to trim common reference base from all alleles in all genotypes if a ref base is common to all alleles
+        Allele refAllele = inputVC.getReference();
+        if (!inputVC.isVariant())
+            trimVC = false;
+        else if (refAllele.isNull())
+            trimVC = false;
+        else {
+            trimVC = (AbstractVCFCodec.computeForwardClipping(new ArrayList<Allele>(inputVC.getAlternateAlleles()),
+                    inputVC.getReference().getDisplayString()) > 0);
+         }
+
+        // nothing to do if we don't need to trim bases
+        if (trimVC) {
+            List<Allele> alleles = new ArrayList<Allele>();
+            Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
+
+            // set the reference base for indels in the attributes
+            Map<String,Object> attributes = new TreeMap<String,Object>(inputVC.getAttributes());
+
+            Map<Allele, Allele> originalToTrimmedAlleleMap = new HashMap<Allele, Allele>();
+
+            for (Allele a : inputVC.getAlleles()) {
+                if (a.isSymbolic()) {
+                    alleles.add(a);
+                    originalToTrimmedAlleleMap.put(a, a);
+                } else {
+                    // get bases for current allele and create a new one with trimmed bases
+                    byte[] newBases = Arrays.copyOfRange(a.getBases(), 1, a.length());
+                    Allele trimmedAllele = Allele.create(newBases, a.isReference());
+                    alleles.add(trimmedAllele);
+                    originalToTrimmedAlleleMap.put(a, trimmedAllele);
+                }
+            }
+
+            // detect case where we're trimming bases but resulting vc doesn't have any null allele. In that case, we keep original representation
+            // example: mixed records such as {TA*,TGA,TG}
+            boolean hasNullAlleles = false;
+
+            for (Allele a: originalToTrimmedAlleleMap.values()) {
+                if (a.isNull())
+                    hasNullAlleles = true;
+                if (a.isReference())
+                    refAllele = a;
+             }
+
+             if (!hasNullAlleles)
+               return inputVC;
+           // now we can recreate new genotypes with trimmed alleles
+            for ( Map.Entry<String, Genotype> sample : inputVC.getGenotypes().entrySet() ) {
+
+                List<Allele> originalAlleles = sample.getValue().getAlleles();
+                List<Allele> trimmedAlleles = new ArrayList<Allele>();
+                for ( Allele a : originalAlleles ) {
+                    if ( a.isCalled() )
+                        trimmedAlleles.add(originalToTrimmedAlleleMap.get(a));
+                    else
+                        trimmedAlleles.add(Allele.NO_CALL);
+                }
+                genotypes.put(sample.getKey(), Genotype.modifyAlleles(sample.getValue(), trimmedAlleles));
+
+            }
+            return new VariantContext(inputVC.getSource(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVC.filtersWereApplied() ? inputVC.getFilters() : null, attributes, new Byte(inputVC.getReference().getBases()[0]));
+
+        }
+
+        return inputVC;
+    }
+
+    public static Map<String, Genotype> stripPLs(Map<String, Genotype> genotypes) {
+        Map<String, Genotype> newGs = new HashMap<String, Genotype>(genotypes.size());
+
+        for ( Map.Entry<String, Genotype> g : genotypes.entrySet() ) {
+            newGs.put(g.getKey(), g.getValue().hasLikelihoods() ? removePLs(g.getValue()) : g.getValue());
+        }
+
+        return newGs;
+    }
+
+    public static Map<VariantContext.Type, List<VariantContext>> separateVariantContextsByType(Collection<VariantContext> VCs) {
+        HashMap<VariantContext.Type, List<VariantContext>> mappedVCs = new HashMap<VariantContext.Type, List<VariantContext>>();
+        for ( VariantContext vc : VCs ) {
+
+            // look at previous variant contexts of different type. If:
+            // a) otherVC has alleles which are subset of vc, remove otherVC from its list and add otherVC to  vc's list
+            // b) vc has alleles which are subset of otherVC. Then, add vc to otherVC's type list (rather, do nothing since vc will be added automatically to its list)
+            // c) neither: do nothing, just add vc to its own list
+            boolean addtoOwnList = true;
+            for (VariantContext.Type type : VariantContext.Type.values()) {
+                if (type.equals(vc.getType()))
+                    continue;
+
+                if (!mappedVCs.containsKey(type))
+                    continue;
+
+                List<VariantContext> vcList = mappedVCs.get(type);
+                for (int k=0; k <  vcList.size(); k++) {
+                    VariantContext otherVC = vcList.get(k);
+                    if (allelesAreSubset(otherVC,vc)) {
+                        // otherVC has a type different than vc and its alleles are a subset of vc: remove otherVC from its list and add it to vc's type list
+                        vcList.remove(k);
+                        // avoid having empty lists
+                        if (vcList.size() == 0)
+                            mappedVCs.remove(vcList);
+                        if ( !mappedVCs.containsKey(vc.getType()) )
+                            mappedVCs.put(vc.getType(), new ArrayList<VariantContext>());
+                        mappedVCs.get(vc.getType()).add(otherVC);
+                        break;
+                    }
+                    else if (allelesAreSubset(vc,otherVC)) {
+                        // vc has a type different than otherVC and its alleles are a subset of VC: add vc to otherVC's type list and don't add to its own
+                        mappedVCs.get(type).add(vc);
+                        addtoOwnList = false;
+                        break;
+                    }
+                }
+            }
+            if (addtoOwnList) {
+                if ( !mappedVCs.containsKey(vc.getType()) )
+                    mappedVCs.put(vc.getType(), new ArrayList<VariantContext>());
+                mappedVCs.get(vc.getType()).add(vc);
+                }
+        }
+
+        return mappedVCs;
+    }
+
+    private static class AlleleMapper {
+        private VariantContext vc = null;
+        private Map<Allele, Allele> map = null;
+        public AlleleMapper(VariantContext vc)          { this.vc = vc; }
+        public AlleleMapper(Map<Allele, Allele> map)    { this.map = map; }
+        public boolean needsRemapping()                 { return this.map != null; }
+        public Collection<Allele> values()              { return map != null ? map.values() : vc.getAlleles(); }
+
+        public Allele remap(Allele a)                   { return map != null && map.containsKey(a) ? map.get(a) : a; }
+
+        public List<Allele> remap(List<Allele> as) {
+            List<Allele> newAs = new ArrayList<Allele>();
+            for ( Allele a : as ) {
+                //System.out.printf("  Remapping %s => %s%n", a, remap(a));
+                newAs.add(remap(a));
+            }
+            return newAs;
+        }
+    }
+
+    static private void verifyUniqueSampleNames(Collection<VariantContext> unsortedVCs) {
+        Set<String> names = new HashSet<String>();
+        for ( VariantContext vc : unsortedVCs ) {
+            for ( String name : vc.getSampleNames() ) {
+                //System.out.printf("Checking %s %b%n", name, names.contains(name));
+                if ( names.contains(name) )
+                    throw new UserException("REQUIRE_UNIQUE sample names is true but duplicate names were discovered " + name);
+            }
+
+            names.addAll(vc.getSampleNames());
+        }
+    }
+
+
+    static private Allele determineReferenceAllele(List<VariantContext> VCs) {
+        Allele ref = null;
+
+        for ( VariantContext vc : VCs ) {
+            Allele myRef = vc.getReference();
+            if ( ref == null || ref.length() < myRef.length() )
+                ref = myRef;
+            else if ( ref.length() == myRef.length() && ! ref.equals(myRef) )
+                throw new UserException.BadInput(String.format("The provided variant file(s) have inconsistent references for the same position(s) at %s:%d, %s vs. %s", vc.getChr(), vc.getStart(), ref, myRef));
+        }
+
+        return ref;
+    }
+
+    static private AlleleMapper resolveIncompatibleAlleles(Allele refAllele, VariantContext vc, Set<Allele> allAlleles) {
+        if ( refAllele.equals(vc.getReference()) )
+            return new AlleleMapper(vc);
+        else {
+            // we really need to do some work.  The refAllele is the longest reference allele seen at this
+            // start site.  So imagine it is:
+            //
+            // refAllele: ACGTGA
+            // myRef:     ACGT
+            // myAlt:     -
+            //
+            // We need to remap all of the alleles in vc to include the extra GA so that
+            // myRef => refAllele and myAlt => GA
+            //
+
+            Allele myRef = vc.getReference();
+            if ( refAllele.length() <= myRef.length() ) throw new ReviewedStingException("BUG: myRef="+myRef+" is longer than refAllele="+refAllele);
+            byte[] extraBases = Arrays.copyOfRange(refAllele.getBases(), myRef.length(), refAllele.length());
+
+//            System.out.printf("Remapping allele at %s%n", vc);
+//            System.out.printf("ref   %s%n", refAllele);
+//            System.out.printf("myref %s%n", myRef );
+//            System.out.printf("extrabases %s%n", new String(extraBases));
+
+            Map<Allele, Allele> map = new HashMap<Allele, Allele>();
+            for ( Allele a : vc.getAlleles() ) {
+                if ( a.isReference() )
+                    map.put(a, refAllele);
+                else {
+                    Allele extended = Allele.extend(a, extraBases);
+                    for ( Allele b : allAlleles )
+                        if ( extended.equals(b) )
+                            extended = b;
+//                    System.out.printf("  Extending %s => %s%n", a, extended);
+                    map.put(a, extended);
+                }
+            }
+
+            // debugging
+//            System.out.printf("mapping %s%n", map);
+
+            return new AlleleMapper(map);
+        }
+    }
+
+    static class CompareByPriority implements Comparator<VariantContext>, Serializable {
+        List<String> priorityListOfVCs;
+        public CompareByPriority(List<String> priorityListOfVCs) {
+            this.priorityListOfVCs = priorityListOfVCs;
+        }
+
+        private int getIndex(VariantContext vc) {
+            int i = priorityListOfVCs.indexOf(vc.getSource());
+            if ( i == -1 ) throw new UserException.BadArgumentValue(Utils.join(",", priorityListOfVCs), "Priority list " + priorityListOfVCs + " doesn't contain variant context " + vc.getSource());
+            return i;
+        }
+
+        public int compare(VariantContext vc1, VariantContext vc2) {
+            return Integer.valueOf(getIndex(vc1)).compareTo(getIndex(vc2));
+        }
+    }
+
+    public static List<VariantContext> sortVariantContextsByPriority(Collection<VariantContext> unsortedVCs, List<String> priorityListOfVCs, GenotypeMergeType mergeOption ) {
+        if ( mergeOption == GenotypeMergeType.PRIORITIZE && priorityListOfVCs == null )
+            throw new IllegalArgumentException("Cannot merge calls by priority with a null priority list");
+
+        if ( priorityListOfVCs == null || mergeOption == GenotypeMergeType.UNSORTED )
+            return new ArrayList<VariantContext>(unsortedVCs);
+        else {
+            ArrayList<VariantContext> sorted = new ArrayList<VariantContext>(unsortedVCs);
+            Collections.sort(sorted, new CompareByPriority(priorityListOfVCs));
+            return sorted;
+        }
+    }
+
+    private static void mergeGenotypes(Map<String, Genotype> mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
+        for ( Genotype g : oneVC.getGenotypes().values() ) {
+            String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
+            if ( ! mergedGenotypes.containsKey(name) ) {
+                // only add if the name is new
+                Genotype newG = g;
+
+                if ( uniqifySamples || alleleMapping.needsRemapping() ) {
+                    MutableGenotype mutG = new MutableGenotype(name, g);
+                    if ( alleleMapping.needsRemapping() ) mutG.setAlleles(alleleMapping.remap(g.getAlleles()));
+                    newG = mutG;
+                }
+
+                mergedGenotypes.put(name, newG);
+            }
+        }
+    }
+
+    public static String mergedSampleName(String trackName, String sampleName, boolean uniqify ) {
+        return uniqify ? sampleName + "." + trackName : sampleName;
+    }
+
+    /**
+     * Returns a context identical to this with the REF and ALT alleles reverse complemented.
+     *
+     * @param vc        variant context
+     * @return new vc
+     */
+    public static VariantContext reverseComplement(VariantContext vc) {
+        // create a mapping from original allele to reverse complemented allele
+        HashMap<Allele, Allele> alleleMap = new HashMap<Allele, Allele>(vc.getAlleles().size());
+        for ( Allele originalAllele : vc.getAlleles() ) {
+            Allele newAllele;
+            if ( originalAllele.isNoCall() || originalAllele.isNull() )
+                newAllele = originalAllele;
+            else
+                newAllele = Allele.create(BaseUtils.simpleReverseComplement(originalAllele.getBases()), originalAllele.isReference());
+            alleleMap.put(originalAllele, newAllele);
+        }
+
+        // create new Genotype objects
+        Map<String, Genotype> newGenotypes = new HashMap<String, Genotype>(vc.getNSamples());
+        for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
+            List<Allele> newAlleles = new ArrayList<Allele>();
+            for ( Allele allele : genotype.getValue().getAlleles() ) {
+                Allele newAllele = alleleMap.get(allele);
+                if ( newAllele == null )
+                    newAllele = Allele.NO_CALL;
+                newAlleles.add(newAllele);
+            }
+            newGenotypes.put(genotype.getKey(), Genotype.modifyAlleles(genotype.getValue(), newAlleles));
+        }
+
+        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes());
+
+    }
+
+    public static VariantContext purgeUnallowedGenotypeAttributes(VariantContext vc, Set<String> allowedAttributes) {
+        if ( allowedAttributes == null )
+            return vc;
+
+        Map<String, Genotype> newGenotypes = new HashMap<String, Genotype>(vc.getNSamples());
+        for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
+            Map<String, Object> attrs = new HashMap<String, Object>();
+            for ( Map.Entry<String, Object> attr : genotype.getValue().getAttributes().entrySet() ) {
+                if ( allowedAttributes.contains(attr.getKey()) )
+                    attrs.put(attr.getKey(), attr.getValue());
+            }
+            newGenotypes.put(genotype.getKey(), Genotype.modifyAttributes(genotype.getValue(), attrs));
+        }
+
+        return VariantContext.modifyGenotypes(vc, newGenotypes);
+    }
+
+    public static BaseUtils.BaseSubstitutionType getSNPSubstitutionType(VariantContext context) {
+        if (!context.isSNP() || !context.isBiallelic())
+            throw new IllegalStateException("Requested SNP substitution type for bialleic non-SNP " + context);
+        return BaseUtils.SNPSubstitutionType(context.getReference().getBases()[0], context.getAlternateAllele(0).getBases()[0]);
+    }
+
+    /**
+     * If this is a BiAlleic SNP, is it a transition?
+     */
+    public static boolean isTransition(VariantContext context) {
+        return getSNPSubstitutionType(context) == BaseUtils.BaseSubstitutionType.TRANSITION;
+    }
+
+    /**
+     * If this is a BiAlleic SNP, is it a transversion?
+     */
+    public static boolean isTransversion(VariantContext context) {
+        return getSNPSubstitutionType(context) == BaseUtils.BaseSubstitutionType.TRANSVERSION;
+    }
+
+    /**
+     * create a genome location, given a variant context
+     * @param genomeLocParser parser
+     * @param vc the variant context
+     * @return the genomeLoc
+     */
+    public static final GenomeLoc getLocation(GenomeLocParser genomeLocParser,VariantContext vc) {
+        return genomeLocParser.createGenomeLoc(vc.getChr(), vc.getStart(), vc.getEnd(), true);
+    }
+
+    public abstract static class AlleleMergeRule {
+        // vc1, vc2 are ONLY passed to allelesShouldBeMerged() if mergeIntoMNPvalidationCheck(genomeLocParser, vc1, vc2) AND allSamplesAreMergeable(vc1, vc2):
+        abstract public boolean allelesShouldBeMerged(VariantContext vc1, VariantContext vc2);
+
+        public String toString() {
+            return "all samples are mergeable";
+        }
+    }
+
+    // NOTE: returns null if vc1 and vc2 are not merged into a single MNP record
+
+    public static VariantContext mergeIntoMNP(GenomeLocParser genomeLocParser, VariantContext vc1, VariantContext vc2, ReferenceSequenceFile referenceFile, AlleleMergeRule alleleMergeRule) {
+        if (!mergeIntoMNPvalidationCheck(genomeLocParser, vc1, vc2))
+            return null;
+
+        // Check that it's logically possible to merge the VCs:
+        if (!allSamplesAreMergeable(vc1, vc2))
+            return null;
+
+        // Check if there's a "point" in merging the VCs (e.g., annotations could be changed)
+        if (!alleleMergeRule.allelesShouldBeMerged(vc1, vc2))
+            return null;
+
+        return reallyMergeIntoMNP(vc1, vc2, referenceFile);
+    }
+
+    private static VariantContext reallyMergeIntoMNP(VariantContext vc1, VariantContext vc2, ReferenceSequenceFile referenceFile) {
+        int startInter = vc1.getEnd() + 1;
+        int endInter = vc2.getStart() - 1;
+        byte[] intermediateBases = null;
+        if (startInter <= endInter) {
+            intermediateBases = referenceFile.getSubsequenceAt(vc1.getChr(), startInter, endInter).getBases();
+            StringUtil.toUpperCase(intermediateBases);
+        }
+        MergedAllelesData mergeData = new MergedAllelesData(intermediateBases, vc1, vc2); // ensures that the reference allele is added
+
+        Map<String, Genotype> mergedGenotypes = new HashMap<String, Genotype>();
+        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
+            String sample = gt1Entry.getKey();
+            Genotype gt1 = gt1Entry.getValue();
+            Genotype gt2 = vc2.getGenotype(sample);
+
+            List<Allele> site1Alleles = gt1.getAlleles();
+            List<Allele> site2Alleles = gt2.getAlleles();
+
+            List<Allele> mergedAllelesForSample = new LinkedList<Allele>();
+
+            /* NOTE: Since merged alleles are added to mergedAllelesForSample in the SAME order as in the input VC records,
+               we preserve phase information (if any) relative to whatever precedes vc1:
+             */
+            Iterator<Allele> all2It = site2Alleles.iterator();
+            for (Allele all1 : site1Alleles) {
+                Allele all2 = all2It.next(); // this is OK, since allSamplesAreMergeable()
+
+                Allele mergedAllele = mergeData.ensureMergedAllele(all1, all2);
+                mergedAllelesForSample.add(mergedAllele);
+            }
+
+            double mergedGQ = Math.max(gt1.getNegLog10PError(), gt2.getNegLog10PError());
+            Set<String> mergedGtFilters = new HashSet<String>(); // Since gt1 and gt2 were unfiltered, the Genotype remains unfiltered
+
+            Map<String, Object> mergedGtAttribs = new HashMap<String, Object>();
+            PhaseAndQuality phaseQual = calcPhaseForMergedGenotypes(gt1, gt2);
+            if (phaseQual.PQ != null)
+                mergedGtAttribs.put(ReadBackedPhasingWalker.PQ_KEY, phaseQual.PQ);
+
+            Genotype mergedGt = new Genotype(sample, mergedAllelesForSample, mergedGQ, mergedGtFilters, mergedGtAttribs, phaseQual.isPhased);
+            mergedGenotypes.put(sample, mergedGt);
+        }
+
+        String mergedName = VariantContextUtils.mergeVariantContextNames(vc1.getSource(), vc2.getSource());
+        double mergedNegLog10PError = Math.max(vc1.getNegLog10PError(), vc2.getNegLog10PError());
+        Set<String> mergedFilters = new HashSet<String>(); // Since vc1 and vc2 were unfiltered, the merged record remains unfiltered
+        Map<String, Object> mergedAttribs = VariantContextUtils.mergeVariantContextAttributes(vc1, vc2);
+
+        VariantContext mergedVc = new VariantContext(mergedName, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles(), mergedGenotypes, mergedNegLog10PError, mergedFilters, mergedAttribs);
+
+        mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
+        VariantContextUtils.calculateChromosomeCounts(mergedVc, mergedAttribs, true);
+        mergedVc = VariantContext.modifyAttributes(mergedVc, mergedAttribs);
+
+        return mergedVc;
+    }
+
+    private static class AlleleOneAndTwo {
+        private Allele all1;
+        private Allele all2;
+
+        public AlleleOneAndTwo(Allele all1, Allele all2) {
+            this.all1 = all1;
+            this.all2 = all2;
+        }
+
+        public int hashCode() {
+            return all1.hashCode() + all2.hashCode();
+        }
+
+        public boolean equals(Object other) {
+            if (!(other instanceof AlleleOneAndTwo))
+                return false;
+
+            AlleleOneAndTwo otherAot = (AlleleOneAndTwo) other;
+            return (this.all1.equals(otherAot.all1) && this.all2.equals(otherAot.all2));
+        }
+    }
+
+    private static class MergedAllelesData {
+        private Map<AlleleOneAndTwo, Allele> mergedAlleles;
+        private byte[] intermediateBases;
+        private int intermediateLength;
+
+        public MergedAllelesData(byte[] intermediateBases, VariantContext vc1, VariantContext vc2) {
+            this.mergedAlleles = new HashMap<AlleleOneAndTwo, Allele>(); // implemented equals() and hashCode() for AlleleOneAndTwo
+            this.intermediateBases = intermediateBases;
+            this.intermediateLength = this.intermediateBases != null ? this.intermediateBases.length : 0;
+
+            this.ensureMergedAllele(vc1.getReference(), vc2.getReference(), true);
+        }
+
+        public Allele ensureMergedAllele(Allele all1, Allele all2) {
+            return ensureMergedAllele(all1, all2, false); // false <-> since even if all1+all2 = reference, it was already created in the constructor
+        }
+
+        private Allele ensureMergedAllele(Allele all1, Allele all2, boolean creatingReferenceForFirstTime) {
+            AlleleOneAndTwo all12 = new AlleleOneAndTwo(all1, all2);
+            Allele mergedAllele = mergedAlleles.get(all12);
+
+            if (mergedAllele == null) {
+                byte[] bases1 = all1.getBases();
+                byte[] bases2 = all2.getBases();
+
+                byte[] mergedBases = new byte[bases1.length + intermediateLength + bases2.length];
+                System.arraycopy(bases1, 0, mergedBases, 0, bases1.length);
+                if (intermediateBases != null)
+                    System.arraycopy(intermediateBases, 0, mergedBases, bases1.length, intermediateLength);
+                System.arraycopy(bases2, 0, mergedBases, bases1.length + intermediateLength, bases2.length);
+
+                mergedAllele = Allele.create(mergedBases, creatingReferenceForFirstTime);
+                mergedAlleles.put(all12, mergedAllele);
+            }
+
+            return mergedAllele;
+        }
+
+        public Set<Allele> getAllMergedAlleles() {
+            return new HashSet<Allele>(mergedAlleles.values());
+        }
+    }
+
+    private static String mergeVariantContextNames(String name1, String name2) {
+        return name1 + "_" + name2;
+    }
+
+    private static Map<String, Object> mergeVariantContextAttributes(VariantContext vc1, VariantContext vc2) {
+        Map<String, Object> mergedAttribs = new HashMap<String, Object>();
+
+        List<VariantContext> vcList = new LinkedList<VariantContext>();
+        vcList.add(vc1);
+        vcList.add(vc2);
+
+        String[] MERGE_OR_ATTRIBS = {VCFConstants.DBSNP_KEY};
+        for (String orAttrib : MERGE_OR_ATTRIBS) {
+            boolean attribVal = false;
+            for (VariantContext vc : vcList) {
+                attribVal = vc.getAttributeAsBoolean(orAttrib, false);
+                if (attribVal) // already true, so no reason to continue:
+                    break;
+            }
+            mergedAttribs.put(orAttrib, attribVal);
+        }
+
+        // Merge ID fields:
+        String iDVal = null;
+        for (VariantContext vc : vcList) {
+            String val = vc.getAttributeAsString(VariantContext.ID_KEY, null);
+            if (val != null && !val.equals(VCFConstants.EMPTY_ID_FIELD)) {
+                if (iDVal == null)
+                    iDVal = val;
+                else
+                    iDVal += VCFConstants.ID_FIELD_SEPARATOR + val;
+            }
+        }
+        if (iDVal != null)
+            mergedAttribs.put(VariantContext.ID_KEY, iDVal);
+
+        return mergedAttribs;
+    }
+
+    private static boolean mergeIntoMNPvalidationCheck(GenomeLocParser genomeLocParser, VariantContext vc1, VariantContext vc2) {
+        GenomeLoc loc1 = VariantContextUtils.getLocation(genomeLocParser, vc1);
+        GenomeLoc loc2 = VariantContextUtils.getLocation(genomeLocParser, vc2);
+
+        if (!loc1.onSameContig(loc2))
+            throw new ReviewedStingException("Can only merge vc1, vc2 if on the same chromosome");
+
+        if (!loc1.isBefore(loc2))
+            throw new ReviewedStingException("Can only merge if vc1 is BEFORE vc2");
+
+        if (vc1.isFiltered() || vc2.isFiltered())
+            return false;
+
+        if (!vc1.getSampleNames().equals(vc2.getSampleNames())) // vc1, vc2 refer to different sample sets
+            return false;
+
+        if (!allGenotypesAreUnfilteredAndCalled(vc1) || !allGenotypesAreUnfilteredAndCalled(vc2))
+            return false;
+
+        return true;
+    }
+
+    private static boolean allGenotypesAreUnfilteredAndCalled(VariantContext vc) {
+        for (Map.Entry<String, Genotype> gtEntry : vc.getGenotypes().entrySet()) {
+            Genotype gt = gtEntry.getValue();
+            if (gt.isNoCall() || gt.isFiltered())
+                return false;
+        }
+
+        return true;
+    }
+
+    // Assumes that vc1 and vc2 were already checked to have the same sample names:
+
+    private static boolean allSamplesAreMergeable(VariantContext vc1, VariantContext vc2) {
+        // Check that each sample's genotype in vc2 is uniquely appendable onto its genotype in vc1:
+        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
+            String sample = gt1Entry.getKey();
+            Genotype gt1 = gt1Entry.getValue();
+            Genotype gt2 = vc2.getGenotype(sample);
+
+            if (!alleleSegregationIsKnown(gt1, gt2)) // can merge if: phased, or if either is a hom
+                return false;
+        }
+
+        return true;
+    }
+
+    public static boolean alleleSegregationIsKnown(Genotype gt1, Genotype gt2) {
+        if (gt1.getPloidy() != gt2.getPloidy())
+            return false;
+
+        /* If gt2 is phased or hom, then could even be MERGED with gt1 [This is standard].
+
+           HOWEVER, EVEN if this is not the case, but gt1.isHom(),
+           it is trivially known that each of gt2's alleles segregate with the single allele type present in gt1.
+         */
+        return (gt2.isPhased() || gt2.isHom() || gt1.isHom());
+    }
+
+    private static class PhaseAndQuality {
+        public boolean isPhased;
+        public Double PQ = null;
+
+        public PhaseAndQuality(Genotype gt) {
+            this.isPhased = gt.isPhased();
+            if (this.isPhased) {
+                this.PQ = gt.getAttributeAsDouble(ReadBackedPhasingWalker.PQ_KEY, -1);
+                if ( this.PQ == -1 ) this.PQ = null;
+            }
+        }
+    }
+
+    // Assumes that alleleSegregationIsKnown(gt1, gt2):
+
+    private static PhaseAndQuality calcPhaseForMergedGenotypes(Genotype gt1, Genotype gt2) {
+        if (gt2.isPhased() || gt2.isHom())
+            return new PhaseAndQuality(gt1); // maintain the phase of gt1
+
+        if (!gt1.isHom())
+            throw new ReviewedStingException("alleleSegregationIsKnown(gt1, gt2) implies: gt2.genotypesArePhased() || gt2.isHom() || gt1.isHom()");
+
+        /* We're dealing with: gt1.isHom(), gt2.isHet(), !gt2.genotypesArePhased(); so, the merged (het) Genotype is not phased relative to the previous Genotype
+
+           For example, if we're merging the third Genotype with the second one:
+           0/1
+           1|1
+           0/1
+
+           Then, we want to output:
+           0/1
+           1/2
+         */
+        return new PhaseAndQuality(gt2); // maintain the phase of gt2 [since !gt2.genotypesArePhased()]
+    }
+
+    /* Checks if any sample has a MNP of ALT alleles (segregating together):
+     [Assumes that vc1 and vc2 were already checked to have the same sample names && allSamplesAreMergeable(vc1, vc2)]
+     */
+
+    public static boolean someSampleHasDoubleNonReferenceAllele(VariantContext vc1, VariantContext vc2) {
+        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
+            String sample = gt1Entry.getKey();
+            Genotype gt1 = gt1Entry.getValue();
+            Genotype gt2 = vc2.getGenotype(sample);
+
+            List<Allele> site1Alleles = gt1.getAlleles();
+            List<Allele> site2Alleles = gt2.getAlleles();
+
+            Iterator<Allele> all2It = site2Alleles.iterator();
+            for (Allele all1 : site1Alleles) {
+                Allele all2 = all2It.next(); // this is OK, since allSamplesAreMergeable()
+
+                if (all1.isNonReference() && all2.isNonReference()) // corresponding alleles are alternate
+                    return true;
+            }
+        }
+
+        return false;
+    }
+
+    /* Checks if all samples are consistent in their haplotypes:
+     [Assumes that vc1 and vc2 were already checked to have the same sample names && allSamplesAreMergeable(vc1, vc2)]
+     */
+
+    public static boolean doubleAllelesSegregatePerfectlyAmongSamples(VariantContext vc1, VariantContext vc2) {
+        // Check that Alleles at vc1 and at vc2 always segregate together in all samples (including reference):
+        Map<Allele, Allele> allele1ToAllele2 = new HashMap<Allele, Allele>();
+        Map<Allele, Allele> allele2ToAllele1 = new HashMap<Allele, Allele>();
+
+        // Note the segregation of the alleles for the reference genome:
+        allele1ToAllele2.put(vc1.getReference(), vc2.getReference());
+        allele2ToAllele1.put(vc2.getReference(), vc1.getReference());
+
+        // Note the segregation of the alleles for each sample (and check that it is consistent with the reference and all previous samples).
+        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
+            String sample = gt1Entry.getKey();
+            Genotype gt1 = gt1Entry.getValue();
+            Genotype gt2 = vc2.getGenotype(sample);
+
+            List<Allele> site1Alleles = gt1.getAlleles();
+            List<Allele> site2Alleles = gt2.getAlleles();
+
+            Iterator<Allele> all2It = site2Alleles.iterator();
+            for (Allele all1 : site1Alleles) {
+                Allele all2 = all2It.next();
+
+                Allele all1To2 = allele1ToAllele2.get(all1);
+                if (all1To2 == null)
+                    allele1ToAllele2.put(all1, all2);
+                else if (!all1To2.equals(all2)) // all1 segregates with two different alleles at site 2
+                    return false;
+
+                Allele all2To1 = allele2ToAllele1.get(all2);
+                if (all2To1 == null)
+                    allele2ToAllele1.put(all2, all1);
+                else if (!all2To1.equals(all1)) // all2 segregates with two different alleles at site 1
+                    return false;
+            }
+        }
+
+        return true;
+    }
+}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantJEXLContext.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantJEXLContext.java
new file mode 100644
index 000000000..f16861f30
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantJEXLContext.java
@@ -0,0 +1,315 @@
+/*
+ * Copyright (c) 2010.  The Broad Institute
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext.v13;
+
+import org.apache.commons.jexl2.JexlContext;
+import org.apache.commons.jexl2.MapContext;
+import org.broadinstitute.sting.utils.Utils;
+import org.broadinstitute.sting.utils.exceptions.UserException;
+
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ *
+ * @author aaron
+ * @author depristo
+ *
+ * Class VariantJEXLContext
+ *
+ * implements the JEXML context for VariantContext; this saves us from
+ * having to generate a JEXML context lookup map everytime we want to evaluate an expression.
+ *
+ * This is package protected, only classes in variantcontext should have access to it.
+ *
+ * // todo -- clean up to remove or better support genotype filtering 
+ */
+
+class VariantJEXLContext implements JexlContext {
+    // our stored variant context
+    private VariantContext vc;
+
+    private interface AttributeGetter {
+        public Object get(VariantContext vc);
+    }
+
+    private static Map<String, AttributeGetter> x = new HashMap<String, AttributeGetter>();
+
+    static {
+        x.put("vc",   new AttributeGetter() { public Object get(VariantContext vc) { return vc; }});
+        x.put("CHROM",   new AttributeGetter() { public Object get(VariantContext vc) { return vc.getChr(); }});
+        x.put("POS",     new AttributeGetter() { public Object get(VariantContext vc) { return vc.getStart(); }});
+        x.put("TYPE",    new AttributeGetter() { public Object get(VariantContext vc) { return vc.getType().toString(); }});
+        x.put("QUAL",    new AttributeGetter() { public Object get(VariantContext vc) { return 10 * vc.getNegLog10PError(); }});
+        x.put("ALLELES", new AttributeGetter() { public Object get(VariantContext vc) { return vc.getAlleles(); }});
+        x.put("N_ALLELES", new AttributeGetter() { public Object get(VariantContext vc) { return vc.getNAlleles(); }});
+        x.put("FILTER",    new AttributeGetter() { public Object get(VariantContext vc) { return vc.isFiltered() ? "1" : "0"; }});
+
+//        x.put("GT",        new AttributeGetter() { public Object get(VariantContext vc) { return g.getGenotypeString(); }});
+        x.put("homRefCount",  new AttributeGetter() { public Object get(VariantContext vc) { return vc.getHomRefCount(); }});
+        x.put("hetCount",     new AttributeGetter() { public Object get(VariantContext vc) { return vc.getHetCount(); }});
+        x.put("homVarCount",  new AttributeGetter() { public Object get(VariantContext vc) { return vc.getHomVarCount(); }});
+    }
+
+    public VariantJEXLContext(VariantContext vc) {
+        this.vc = vc;
+    }
+
+    public Object get(String name) {
+        Object result = null;
+        if ( x.containsKey(name) ) { // dynamic resolution of name -> value via map
+            result = x.get(name).get(vc);
+        } else if ( vc.hasAttribute(name)) {
+            result = vc.getAttribute(name);
+        } else if ( vc.getFilters().contains(name) ) {
+            result = "1";
+        }
+
+        //System.out.printf("dynamic lookup %s => %s%n", name, result);
+
+        return result;
+    }
+
+    public boolean has(String name) {
+        return get(name) != null;
+    }
+
+    public void	set(String name, Object value) {
+        throw new UnsupportedOperationException("remove() not supported on a VariantJEXLContext");
+    }
+}
+
+
+
+
+/**
+ * this is an implementation of a Map of JexlVCMatchExp to true or false values.  It lazy initializes each value
+ * as requested to save as much processing time as possible.
+ *
+ * Compatible with JEXL 1.1 (this code will be easier if we move to 2.0, all of the functionality can go into the
+ * JexlContext's get()
+ * 
+ */
+
+class JEXLMap implements Map<VariantContextUtils.JexlVCMatchExp, Boolean> {
+    // our variant context and/or Genotype
+    private final VariantContext vc;
+    private final Genotype g;
+
+    // our context
+    private JexlContext jContext = null;
+
+    // our mapping from JEXLVCMatchExp to Booleans, which will be set to NULL for previously uncached JexlVCMatchExp
+    private Map<VariantContextUtils.JexlVCMatchExp,Boolean> jexl;
+
+
+    public JEXLMap(Collection<VariantContextUtils.JexlVCMatchExp> jexlCollection, VariantContext vc, Genotype g) {
+        this.vc = vc;
+        this.g = g;
+        initialize(jexlCollection);
+    }
+
+    public JEXLMap(Collection<VariantContextUtils.JexlVCMatchExp> jexlCollection, VariantContext vc) {
+        this(jexlCollection, vc, null);
+    }
+
+    private void initialize(Collection<VariantContextUtils.JexlVCMatchExp> jexlCollection) {
+        jexl = new HashMap<VariantContextUtils.JexlVCMatchExp,Boolean>();
+        for (VariantContextUtils.JexlVCMatchExp exp: jexlCollection) {
+            jexl.put(exp, null);
+        }
+    }
+
+    /**
+     * create the internal JexlContext, only when required.  This code is where new JEXL context variables
+     * should get added.
+     *
+     */
+    private void createContext() {
+        if ( g == null ) {
+            // todo -- remove dependancy on g to the entire system
+            jContext = new VariantJEXLContext(vc);
+        } else {
+            //
+            // this whole branch is here just to support G jexl operations
+            //
+            Map<String, Object> infoMap = new HashMap<String, Object>();
+
+            if ( vc != null ) {
+                // create a mapping of what we know about the variant context, its Chromosome, positions, etc.
+                infoMap.put("CHROM", vc.getChr());
+                infoMap.put("POS", vc.getStart());
+                infoMap.put("TYPE", vc.getType().toString());
+                infoMap.put("QUAL", String.valueOf(vc.getPhredScaledQual()));
+
+                // add alleles
+                infoMap.put("ALLELES", Utils.join(";", vc.getAlleles()));
+                infoMap.put("N_ALLELES", String.valueOf(vc.getNAlleles()));
+
+                // add attributes
+                addAttributesToMap(infoMap, vc.getAttributes());
+
+                // add filter fields
+                infoMap.put("FILTER", vc.isFiltered() ? "1" : "0");
+                for ( Object filterCode : vc.getFilters() ) {
+                    infoMap.put(String.valueOf(filterCode), "1");
+                }
+
+                // add genotype-specific fields
+                // TODO -- implement me when we figure out a good way to represent this
+                //    for ( Genotype g : vc.getGenotypes().values() ) {
+                //        String prefix = g.getSampleName() + ".";
+                //        addAttributesToMap(infoMap, g.getAttributes(), prefix);
+                //        infoMap.put(prefix + "GT", g.getGenotypeString());
+                //    }
+
+                // add specific genotype if one is provided
+                infoMap.put(VCFConstants.GENOTYPE_KEY, g.getGenotypeString());
+                infoMap.put("isHomRef", g.isHomRef() ? "1" : "0");
+                infoMap.put("isHet", g.isHet() ? "1" : "0");
+                infoMap.put("isHomVar", g.isHomVar() ? "1" : "0");
+                infoMap.put(VCFConstants.GENOTYPE_QUALITY_KEY, new Double(g.getPhredScaledQual()));
+                for ( Map.Entry<String, Object> e : g.getAttributes().entrySet() ) {
+                    if ( e.getValue() != null && !e.getValue().equals(VCFConstants.MISSING_VALUE_v4) )
+                        infoMap.put(e.getKey(), e.getValue());
+                }
+            }
+
+            // create the internal context that we can evaluate expressions against
+
+            jContext = new MapContext(infoMap);
+        }
+    }
+
+    /**
+     * @return the size of the internal data structure
+     */
+    public int size() {
+        return jexl.size();
+    }
+
+    /**
+     * @return true if we're empty
+     */
+    public boolean isEmpty() { return this.jexl.isEmpty(); }
+
+    /**
+     * do we contain the specified key
+     * @param o the key
+     * @return true if we have a value for that key
+     */
+    public boolean containsKey(Object o) { return jexl.containsKey(o); }
+
+    public Boolean get(Object o) {
+        // if we've already determined the value, return it
+        if (jexl.containsKey(o) && jexl.get(o) != null) return jexl.get(o);
+
+        // try and cast the expression
+        VariantContextUtils.JexlVCMatchExp e = (VariantContextUtils.JexlVCMatchExp) o;
+        evaluateExpression(e);
+        return jexl.get(e);
+    }
+
+    /**
+     * get the keyset of map
+     * @return a set of keys of type JexlVCMatchExp
+     */
+    public Set<VariantContextUtils.JexlVCMatchExp> keySet() {
+        return jexl.keySet();
+    }
+
+    /**
+     * get all the values of the map.  This is an expensive call, since it evaluates all keys that haven't
+     * been evaluated yet.  This is fine if you truely want all the keys, but if you only want a portion, or  know
+     * the keys you want, you would be better off using get() to get them by name.
+     * @return a collection of boolean values, representing the results of all the variants evaluated
+     */
+    public Collection<Boolean> values() {
+        // this is an expensive call
+        for (VariantContextUtils.JexlVCMatchExp exp : jexl.keySet())
+            if (jexl.get(exp) == null)
+                evaluateExpression(exp);
+        return jexl.values();
+    }
+
+    /**
+     * evaulate a JexlVCMatchExp's expression, given the current context (and setup the context if it's null)
+     * @param exp the JexlVCMatchExp to evaluate
+     */
+    private void evaluateExpression(VariantContextUtils.JexlVCMatchExp exp) {
+        // if the context is null, we need to create it to evaluate the JEXL expression
+        if (this.jContext == null) createContext();
+        try {
+            jexl.put (exp, (Boolean) exp.exp.evaluate(jContext));
+        } catch (Exception e) {
+            throw new UserException.CommandLineException(String.format("Invalid JEXL expression detected for %s with message %s", exp.name, e.getMessage()));
+        }
+    }
+
+    /**
+     * helper function: adds the list of attributes to the information map we're building
+     * @param infoMap the map
+     * @param attributes the attributes
+     */
+    private static void addAttributesToMap(Map<String, Object> infoMap, Map<String, ?> attributes ) {
+        for (Map.Entry<String, ?> e : attributes.entrySet()) {
+            infoMap.put(e.getKey(), String.valueOf(e.getValue()));
+        }
+    }
+
+    public Boolean put(VariantContextUtils.JexlVCMatchExp jexlVCMatchExp, Boolean aBoolean) {
+        return jexl.put(jexlVCMatchExp,aBoolean);
+    }
+
+    public void putAll(Map<? extends VariantContextUtils.JexlVCMatchExp, ? extends Boolean> map) {
+        jexl.putAll(map);
+    }
+
+    // //////////////////////////////////////////////////////////////////////////////////////
+    // The Following are unsupported at the moment
+    // //////////////////////////////////////////////////////////////////////////////////////
+
+    // this doesn't make much sense to implement, boolean doesn't offer too much variety to deal
+    // with evaluating every key in the internal map.
+    public boolean containsValue(Object o) {
+        throw new UnsupportedOperationException("containsValue() not supported on a JEXLMap");
+    }
+
+    // this doesn't make much sense
+    public Boolean remove(Object o) {
+        throw new UnsupportedOperationException("remove() not supported on a JEXLMap");
+    }
+
+
+    public Set<Entry<VariantContextUtils.JexlVCMatchExp, Boolean>> entrySet() {
+        throw new UnsupportedOperationException("clear() not supported on a JEXLMap");
+    }
+
+    // nope
+    public void clear() {
+        throw new UnsupportedOperationException("clear() not supported on a JEXLMap");
+    }
+}

From caf60804028bfcd17ca0234ce3a07678e3ec722c Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 16 Nov 2011 15:17:33 -0500
Subject: [PATCH 040/113] Better algorithm for merging genotypes in
 CombineVariants

---
 .../sting/utils/variantcontext/VariantContextUtils.java   | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 161800009..238cf4b3b 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -401,6 +401,7 @@ public class VariantContextUtils {
         final Map<String, Object> attributesWithMaxAC = new TreeMap<String, Object>();
         double negLog10PError = -1;
         VariantContext vcWithMaxAC = null;
+        Set<String> addedSamples = new HashSet<String>(first.getNSamples());
         GenotypeCollection genotypes = GenotypeCollection.create();
 
         // counting the number of filtered and variant VCs
@@ -425,7 +426,7 @@ public class VariantContextUtils {
 
             alleles.addAll(alleleMapping.values());
 
-            mergeGenotypes(genotypes, vc, alleleMapping, genotypeMergeOptions == GenotypeMergeType.UNIQUIFY);
+            mergeGenotypes(genotypes, addedSamples, vc, alleleMapping, genotypeMergeOptions == GenotypeMergeType.UNIQUIFY);
 
             negLog10PError = Math.max(negLog10PError, vc.isVariant() ? vc.getNegLog10PError() : -1);
 
@@ -824,10 +825,10 @@ public class VariantContextUtils {
         }
     }
 
-    private static void mergeGenotypes(GenotypeCollection mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
+    private static void mergeGenotypes(GenotypeCollection mergedGenotypes, Set<String> addedSamples, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
         for ( Genotype g : oneVC.getGenotypes() ) {
             String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
-            if ( ! mergedGenotypes.containsSample(name) ) {
+            if ( ! addedSamples.contains(name) ) {
                 // only add if the name is new
                 Genotype newG = g;
 
@@ -837,6 +838,7 @@ public class VariantContextUtils {
                 }
 
                 mergedGenotypes.add(newG);
+                addedSamples.add(name);
             }
         }
     }

From 974daaca4d9955d8ef862c7796561c08d08f0975 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 16 Nov 2011 16:08:46 -0500
Subject: [PATCH 041/113] V13 version in archive.  Can you pulled out wholesale
 for performance testing

---
 .../VariantContextBenchmark.java              |  244 +--
 .../variantcontext/v13/AbstractVCFCodec.java  |  635 -------
 .../utils/variantcontext/v13/Allele.java      |  456 -----
 .../utils/variantcontext/v13/Genotype.java    |  349 ----
 .../v13/GenotypeLikelihoods.java              |  196 --
 .../variantcontext/v13/IndexingVCFWriter.java |  143 --
 .../v13/InferredGeneticContext.java           |  243 ---
 .../variantcontext/v13/MutableGenotype.java   |   68 -
 .../v13/MutableVariantContext.java            |  213 ---
 .../utils/variantcontext/v13/VCF3Codec.java   |  198 --
 .../variantcontext/v13/VCFAltHeaderLine.java  |   28 -
 .../utils/variantcontext/v13/VCFCodec.java    |  228 ---
 .../v13/VCFCompoundHeaderLine.java            |  224 ---
 .../variantcontext/v13/VCFConstants.java      |  112 --
 .../v13/VCFFilterHeaderLine.java              |   28 -
 .../v13/VCFFormatHeaderLine.java              |   32 -
 .../utils/variantcontext/v13/VCFHeader.java   |  198 --
 .../variantcontext/v13/VCFHeaderLine.java     |  134 --
 .../v13/VCFHeaderLineCount.java               |    8 -
 .../v13/VCFHeaderLineTranslator.java          |  124 --
 .../variantcontext/v13/VCFHeaderLineType.java |    8 -
 .../variantcontext/v13/VCFHeaderVersion.java  |   91 -
 .../variantcontext/v13/VCFInfoHeaderLine.java |   29 -
 .../v13/VCFNamedHeaderLine.java               |   30 -
 .../utils/variantcontext/v13/VCFParser.java   |   22 -
 .../v13/VCFSimpleHeaderLine.java              |   81 -
 .../utils/variantcontext/v13/VCFUtils.java    |  227 ---
 .../utils/variantcontext/v13/VCFWriter.java   |   16 -
 .../variantcontext/v13/VariantContext.java    | 1615 -----------------
 .../v13/VariantContextUtils.java              | 1407 --------------
 .../v13/VariantJEXLContext.java               |  315 ----
 31 files changed, 127 insertions(+), 7575 deletions(-)
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/AbstractVCFCodec.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Allele.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Genotype.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/GenotypeLikelihoods.java
 delete mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/IndexingVCFWriter.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/InferredGeneticContext.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableGenotype.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableVariantContext.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCF3Codec.java
 delete mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFAltHeaderLine.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCodec.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCompoundHeaderLine.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFConstants.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFilterHeaderLine.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFormatHeaderLine.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeader.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLine.java
 delete mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineCount.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineTranslator.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineType.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderVersion.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFInfoHeaderLine.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFNamedHeaderLine.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFParser.java
 delete mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFSimpleHeaderLine.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFUtils.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFWriter.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContext.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContextUtils.java
 delete mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantJEXLContext.java

diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
index e16176dff..eda74a965 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -244,124 +244,134 @@ public class VariantContextBenchmark extends SimpleBenchmark {
         }
     }
 
-    public void timeV13(int rep) {
-        for ( int i = 0; i < rep; i++ ) {
-            FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> func = getV13FunctionToBenchmark();
-            FeatureCodec<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> codec = new org.broadinstitute.sting.utils.variantcontext.v13.VCFCodec();
-            runBenchmark(codec, func);
-        }
-    }
+    // --------------------------------------------------------------------------------
+    //
+    // V13
+    //
+    // In order to use this, you must move the v13 version from archive and uncomment
+    //
+    // git mv private/archive/java/src/org/broadinstitute/sting/utils/variantcontext/v13 public/java/test/org/broadinstitute/sting/utils/variantcontext/v13
+    //
+    // --------------------------------------------------------------------------------
 
-    public FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> getV13FunctionToBenchmark() {
-        switch ( operation ) {
-            case READ:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        ; // empty operation
-                    }
-                };
-            case SUBSET_TO_SAMPLES:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    List<String> samples;
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        if ( samples == null )
-                            samples = new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake);
-                        org.broadinstitute.sting.utils.variantcontext.v13.VariantContext sub = vc.subContextFromGenotypes(vc.getGenotypes(samples).values());
-                        sub.getNSamples();
-                    }
-                };
-
-            case GET_TYPE:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        vc.getType();
-                    }
-                };
-            case GET_ID:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        vc.getID();
-                    }
-                };
-            case GET_GENOTYPES:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        vc.getGenotypes().size();
-                    }
-                };
-
-            case GET_GENOTYPES_FOR_SAMPLES:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    Set<String> samples;
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        if ( samples == null )
-                            samples = new HashSet<String>(new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake));
-                        vc.getGenotypes(samples).size();
-                    }
-                };
-
-            case GET_ATTRIBUTE_STRING:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        vc.getAttribute("AN", null);
-                    }
-                };
-
-            case GET_ATTRIBUTE_INT:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        vc.getAttributeAsInt("AC", 0);
-                    }
-                };
-
-            case GET_N_SAMPLES:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        vc.getNSamples();
-                    }
-                };
-
-            case GET_GENOTYPES_IN_ORDER_OF_NAME:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        ; // TODO - TEST IS BROKEN
-                        //vc.getGenotypesSortedByName();
-                    }
-                };
-
-            case CALC_GENOTYPE_COUNTS:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        vc.getHetCount();
-                    }
-                };
-
-            case MERGE:
-                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
-                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
-                        List<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> toMerge = new ArrayList<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>();
-
-                        for ( int i = 0; i < dupsToMerge; i++ ) {
-                            Map<String, org.broadinstitute.sting.utils.variantcontext.v13.Genotype> gc = new HashMap<String, org.broadinstitute.sting.utils.variantcontext.v13.Genotype>();
-                            for ( final org.broadinstitute.sting.utils.variantcontext.v13.Genotype g : vc.getGenotypes().values() ) {
-                                String name = g.getSampleName()+"_"+i;
-                                gc.put(name, new org.broadinstitute.sting.utils.variantcontext.v13.Genotype(name,
-                                        g.getAlleles(), g.getNegLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased(), g.getLikelihoods().getAsVector()));
-                                toMerge.add(org.broadinstitute.sting.utils.variantcontext.v13.VariantContext.modifyGenotypes(vc, gc));
-                            }
-                        }
-
-                        org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.simpleMerge(b37GenomeLocParser,
-                                toMerge, null,
-                                org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED,
-                                org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.GenotypeMergeType.UNSORTED,
-                                true, false, "set", false, true);
-                    }
-                };
-
-            default: throw new IllegalArgumentException("Unexpected operation " + operation);
-        }
-    }
+//    public void timeV13(int rep) {
+//        for ( int i = 0; i < rep; i++ ) {
+//            FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> func = getV13FunctionToBenchmark();
+//            FeatureCodec<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> codec = new org.broadinstitute.sting.utils.variantcontext.v13.VCFCodec();
+//            runBenchmark(codec, func);
+//        }
+//    }
+//
+//    public FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> getV13FunctionToBenchmark() {
+//        switch ( operation ) {
+//            case READ:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        ; // empty operation
+//                    }
+//                };
+//            case SUBSET_TO_SAMPLES:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    List<String> samples;
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        if ( samples == null )
+//                            samples = new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake);
+//                        org.broadinstitute.sting.utils.variantcontext.v13.VariantContext sub = vc.subContextFromGenotypes(vc.getGenotypes(samples).values());
+//                        sub.getNSamples();
+//                    }
+//                };
+//
+//            case GET_TYPE:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        vc.getType();
+//                    }
+//                };
+//            case GET_ID:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        vc.getID();
+//                    }
+//                };
+//            case GET_GENOTYPES:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        vc.getGenotypes().size();
+//                    }
+//                };
+//
+//            case GET_GENOTYPES_FOR_SAMPLES:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    Set<String> samples;
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        if ( samples == null )
+//                            samples = new HashSet<String>(new ArrayList<String>(vc.getSampleNames()).subList(0, nSamplesToTake));
+//                        vc.getGenotypes(samples).size();
+//                    }
+//                };
+//
+//            case GET_ATTRIBUTE_STRING:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        vc.getAttribute("AN", null);
+//                    }
+//                };
+//
+//            case GET_ATTRIBUTE_INT:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        vc.getAttributeAsInt("AC", 0);
+//                    }
+//                };
+//
+//            case GET_N_SAMPLES:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        vc.getNSamples();
+//                    }
+//                };
+//
+//            case GET_GENOTYPES_IN_ORDER_OF_NAME:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        ; // TODO - TEST IS BROKEN
+//                        //vc.getGenotypesSortedByName();
+//                    }
+//                };
+//
+//            case CALC_GENOTYPE_COUNTS:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        vc.getHetCount();
+//                    }
+//                };
+//
+//            case MERGE:
+//                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
+//                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
+//                        List<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext> toMerge = new ArrayList<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>();
+//
+//                        for ( int i = 0; i < dupsToMerge; i++ ) {
+//                            Map<String, org.broadinstitute.sting.utils.variantcontext.v13.Genotype> gc = new HashMap<String, org.broadinstitute.sting.utils.variantcontext.v13.Genotype>();
+//                            for ( final org.broadinstitute.sting.utils.variantcontext.v13.Genotype g : vc.getGenotypes().values() ) {
+//                                String name = g.getSampleName()+"_"+i;
+//                                gc.put(name, new org.broadinstitute.sting.utils.variantcontext.v13.Genotype(name,
+//                                        g.getAlleles(), g.getNegLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased(), g.getLikelihoods().getAsVector()));
+//                                toMerge.add(org.broadinstitute.sting.utils.variantcontext.v13.VariantContext.modifyGenotypes(vc, gc));
+//                            }
+//                        }
+//
+//                        org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.simpleMerge(b37GenomeLocParser,
+//                                toMerge, null,
+//                                org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED,
+//                                org.broadinstitute.sting.utils.variantcontext.v13.VariantContextUtils.GenotypeMergeType.UNSORTED,
+//                                true, false, "set", false, true);
+//                    }
+//                };
+//
+//            default: throw new IllegalArgumentException("Unexpected operation " + operation);
+//        }
+//    }
 
     public static void main(String[] args) {
         CaliperMain.main(VariantContextBenchmark.class, args);
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/AbstractVCFCodec.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/AbstractVCFCodec.java
deleted file mode 100755
index 5310313e0..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/AbstractVCFCodec.java
+++ /dev/null
@@ -1,635 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.apache.log4j.Logger;
-import org.broad.tribble.Feature;
-import org.broad.tribble.FeatureCodec;
-import org.broad.tribble.NameAwareCodec;
-import org.broad.tribble.TribbleException;
-import org.broad.tribble.readers.LineReader;
-import org.broad.tribble.util.BlockCompressedInputStream;
-import org.broad.tribble.util.ParsingUtils;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-import org.broadinstitute.sting.utils.exceptions.UserException;
-
-import java.io.*;
-import java.util.*;
-import java.util.zip.GZIPInputStream;
-
-
-abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec, VCFParser {
-
-    protected final static Logger log = Logger.getLogger(VCFCodec.class);
-    protected final static int NUM_STANDARD_FIELDS = 8;  // INFO is the 8th column
-
-    protected VCFHeaderVersion version;
-
-    // we have to store the list of strings that make up the header until they're needed
-    protected VCFHeader header = null;
-
-    // a mapping of the allele
-    protected Map<String, List<Allele>> alleleMap = new HashMap<String, List<Allele>>(3);
-
-    // for ParsingUtils.split
-    protected String[] GTValueArray = new String[100];
-    protected String[] genotypeKeyArray = new String[100];
-    protected String[] infoFieldArray = new String[1000];
-    protected String[] infoValueArray = new String[1000];
-
-    // for performance testing purposes
-    public static boolean validate = true;
-
-    // a key optimization -- we need a per thread string parts array, so we don't allocate a big array over and over
-    // todo: make this thread safe?
-    protected String[] parts = null;
-    protected String[] genotypeParts = null;
-
-    // for performance we cache the hashmap of filter encodings for quick lookup
-    protected HashMap<String,LinkedHashSet<String>> filterHash = new HashMap<String,LinkedHashSet<String>>();
-
-    // a mapping of the VCF fields to their type, filter fields, and format fields, for quick lookup to validate against
-    TreeMap<String, VCFHeaderLineType> infoFields = new TreeMap<String, VCFHeaderLineType>();
-    TreeMap<String, VCFHeaderLineType> formatFields = new TreeMap<String, VCFHeaderLineType>();
-    Set<String> filterFields = new HashSet<String>();
-
-    // we store a name to give to each of the variant contexts we emit
-    protected String name = "Unknown";
-
-    protected int lineNo = 0;
-
-    protected Map<String, String> stringCache = new HashMap<String, String>();
-
-
-    /**
-     * @param reader the line reader to take header lines from
-     * @return the number of header lines
-     */
-    public abstract Object readHeader(LineReader reader);
-
-    /**
-     * create a genotype map
-     * @param str the string
-     * @param alleles the list of alleles
-     * @param chr chrom
-     * @param pos position
-     * @return a mapping of sample name to genotype object
-     */
-    public abstract Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
-
-
-    /**
-     * parse the filter string, first checking to see if we already have parsed it in a previous attempt
-     * @param filterString the string to parse
-     * @return a set of the filters applied
-     */
-    protected abstract Set<String> parseFilters(String filterString);
-
-    /**
-     * create a VCF header
-     * @param headerStrings a list of strings that represent all the ## entries
-     * @param line the single # line (column names)
-     * @return the count of header lines
-     */
-    protected Object createHeader(List<String> headerStrings, String line) {
-
-        headerStrings.add(line);
-
-        Set<VCFHeaderLine> metaData = new TreeSet<VCFHeaderLine>();
-        Set<String> auxTags = new LinkedHashSet<String>();
-        // iterate over all the passed in strings
-        for ( String str : headerStrings ) {
-            if ( !str.startsWith(VCFHeader.METADATA_INDICATOR) ) {
-                String[] strings = str.substring(1).split(VCFConstants.FIELD_SEPARATOR);
-                if ( strings.length < VCFHeader.HEADER_FIELDS.values().length )
-                    throw new TribbleException.InvalidHeader("there are not enough columns present in the header line: " + str);
-
-                int arrayIndex = 0;
-                for (VCFHeader.HEADER_FIELDS field : VCFHeader.HEADER_FIELDS.values()) {
-                    try {
-                        if (field != VCFHeader.HEADER_FIELDS.valueOf(strings[arrayIndex]))
-                            throw new TribbleException.InvalidHeader("we were expecting column name '" + field + "' but we saw '" + strings[arrayIndex] + "'");
-                    } catch (IllegalArgumentException e) {
-                        throw new TribbleException.InvalidHeader("unknown column name '" + strings[arrayIndex] + "'; it does not match a legal column header name.");
-                    }
-                    arrayIndex++;
-                }
-
-                boolean sawFormatTag = false;
-                if ( arrayIndex < strings.length ) {
-                    if ( !strings[arrayIndex].equals("FORMAT") )
-                        throw new TribbleException.InvalidHeader("we were expecting column name 'FORMAT' but we saw '" + strings[arrayIndex] + "'");
-                    sawFormatTag = true;
-                    arrayIndex++;
-                }
-
-                while ( arrayIndex < strings.length )
-                    auxTags.add(strings[arrayIndex++]);
-
-                if ( sawFormatTag && auxTags.size() == 0 )
-                    throw new UserException.MalformedVCFHeader("The FORMAT field was provided but there is no genotype/sample data");
-
-            } else {
-                if ( str.startsWith("##INFO=") ) {
-                    VCFInfoHeaderLine info = new VCFInfoHeaderLine(str.substring(7),version);
-                    metaData.add(info);
-                    infoFields.put(info.getName(), info.getType());
-                } else if ( str.startsWith("##FILTER=") ) {
-                    VCFFilterHeaderLine filter = new VCFFilterHeaderLine(str.substring(9),version);
-                    metaData.add(filter);
-                    filterFields.add(filter.getName());
-                } else if ( str.startsWith("##FORMAT=") ) {
-                    VCFFormatHeaderLine format = new VCFFormatHeaderLine(str.substring(9),version);
-                    metaData.add(format);
-                    formatFields.put(format.getName(), format.getType());
-                } else {
-                    int equals = str.indexOf("=");
-                    if ( equals != -1 )
-                        metaData.add(new VCFHeaderLine(str.substring(2, equals), str.substring(equals+1)));
-                }
-            }
-        }
-
-        header = new VCFHeader(metaData, auxTags);
-        return header;
-    }
-
-    /**
-     * the fast decode function
-     * @param line the line of text for the record
-     * @return a feature, (not guaranteed complete) that has the correct start and stop
-     */
-    public Feature decodeLoc(String line) {
-        lineNo++;
-
-        // the same line reader is not used for parsing the header and parsing lines, if we see a #, we've seen a header line
-        if (line.startsWith(VCFHeader.HEADER_INDICATOR)) return null;
-
-        // our header cannot be null, we need the genotype sample names and counts
-        if (header == null) throw new ReviewedStingException("VCF Header cannot be null when decoding a record");
-
-        final String[] locParts = new String[6];
-        int nParts = ParsingUtils.split(line, locParts, VCFConstants.FIELD_SEPARATOR_CHAR, true);
-
-        if ( nParts != 6 )
-            throw new UserException.MalformedVCF("there aren't enough columns for line " + line, lineNo);
-
-        // get our alleles (because the end position depends on them)
-        final String ref = getCachedString(locParts[3].toUpperCase());
-        final String alts = getCachedString(locParts[4].toUpperCase());
-        final List<Allele> alleles = parseAlleles(ref, alts, lineNo);
-
-        // find out our location
-        final int start = Integer.valueOf(locParts[1]);
-        int stop = start;
-
-        // ref alleles don't need to be single bases for monomorphic sites
-        if ( alleles.size() == 1 ) {
-            stop = start + alleles.get(0).length() - 1;
-        } else if ( !isSingleNucleotideEvent(alleles) ) {
-            stop = clipAlleles(start, ref, alleles, null, lineNo);
-        }
-
-        return new VCFLocFeature(locParts[0], start, stop);
-    }
-
-    private final static class VCFLocFeature implements Feature {
-
-        final String chr;
-        final int start, stop;
-
-        private VCFLocFeature(String chr, int start, int stop) {
-            this.chr = chr;
-            this.start = start;
-            this.stop = stop;
-        }
-
-        public String getChr() { return chr; }
-        public int getStart() { return start; }
-        public int getEnd() { return stop; }
-    }
-
-
-    /**
-     * decode the line into a feature (VariantContext)
-     * @param line the line
-     * @return a VariantContext
-     */
-    public Feature decode(String line) {
-        // the same line reader is not used for parsing the header and parsing lines, if we see a #, we've seen a header line
-        if (line.startsWith(VCFHeader.HEADER_INDICATOR)) return null;
-
-        // our header cannot be null, we need the genotype sample names and counts
-        if (header == null) throw new ReviewedStingException("VCF Header cannot be null when decoding a record");
-
-        if (parts == null)
-            parts = new String[Math.min(header.getColumnCount(), NUM_STANDARD_FIELDS+1)];
-
-        int nParts = ParsingUtils.split(line, parts, VCFConstants.FIELD_SEPARATOR_CHAR, true);
-
-        // if we have don't have a header, or we have a header with no genotyping data check that we have eight columns.  Otherwise check that we have nine (normal colummns + genotyping data)
-        if (( (header == null || !header.hasGenotypingData()) && nParts != NUM_STANDARD_FIELDS) ||
-             (header != null && header.hasGenotypingData() && nParts != (NUM_STANDARD_FIELDS + 1)) )
-            throw new UserException.MalformedVCF("there aren't enough columns for line " + line + " (we expected " + (header == null ? NUM_STANDARD_FIELDS : NUM_STANDARD_FIELDS + 1) +
-                    " tokens, and saw " + nParts + " )", lineNo);
-
-        return parseVCFLine(parts);
-    }
-
-    protected void generateException(String message) {
-        throw new UserException.MalformedVCF(message, lineNo);
-    }
-
-    protected static void generateException(String message, int lineNo) {
-        throw new UserException.MalformedVCF(message, lineNo);
-    }
-
-    /**
-     * parse out the VCF line
-     *
-     * @param parts the parts split up
-     * @return a variant context object
-     */
-    private VariantContext parseVCFLine(String[] parts) {
-        // increment the line count
-        lineNo++;
-
-        // parse out the required fields
-        String contig = getCachedString(parts[0]);
-        int pos = Integer.valueOf(parts[1]);
-        String id = null;
-        if ( parts[2].length() == 0 )
-            generateException("The VCF specification requires a valid ID field");
-        else if ( parts[2].equals(VCFConstants.EMPTY_ID_FIELD) )
-            id = VCFConstants.EMPTY_ID_FIELD;
-        else
-            id = new String(parts[2]);
-        String ref = getCachedString(parts[3].toUpperCase());
-        String alts = getCachedString(parts[4].toUpperCase());
-        Double qual = parseQual(parts[5]);
-        String filter = getCachedString(parts[6]);
-        String info = new String(parts[7]);
-
-        // get our alleles, filters, and setup an attribute map
-        List<Allele> alleles = parseAlleles(ref, alts, lineNo);
-        Set<String> filters = parseFilters(filter);
-        Map<String, Object> attributes = parseInfo(info, id);
-
-        // find out our current location, and clip the alleles down to their minimum length
-        int loc = pos;
-        // ref alleles don't need to be single bases for monomorphic sites
-        if ( alleles.size() == 1 ) {
-            loc = pos + alleles.get(0).length() - 1;
-        } else if ( !isSingleNucleotideEvent(alleles) ) {
-            ArrayList<Allele> newAlleles = new ArrayList<Allele>();
-            loc = clipAlleles(pos, ref, alleles, newAlleles, lineNo);
-            alleles = newAlleles;
-        }
-
-        // do we have genotyping data
-        if (parts.length > NUM_STANDARD_FIELDS) {
-            attributes.put(VariantContext.UNPARSED_GENOTYPE_MAP_KEY, new String(parts[8]));
-            attributes.put(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY, this);
-        }
-
-        VariantContext vc = null;
-        try {
-            vc =  new VariantContext(name, contig, pos, loc, alleles, qual, filters, attributes, ref.getBytes()[0]);
-        } catch (Exception e) {
-            generateException(e.getMessage());
-        }
-
-        // did we resort the sample names?  If so, we need to load the genotype data
-        if ( !header.samplesWereAlreadySorted() )
-            vc.getGenotypes();
-
-        return vc;
-    }
-
-    /**
-     *
-     * @return the type of record
-     */
-    public Class<VariantContext> getFeatureType() {
-        return VariantContext.class;
-    }
-
-    /**
-     * get the name of this codec
-     * @return our set name
-     */
-    public String getName() {
-        return name;
-    }
-
-    /**
-     * set the name of this codec
-     * @param name new name
-     */
-    public void setName(String name) {
-        this.name = name;
-    }
-
-    /**
-     * Return a cached copy of the supplied string.
-     *
-     * @param str string
-     * @return interned string
-     */
-    protected String getCachedString(String str) {
-        String internedString = stringCache.get(str);
-        if ( internedString == null ) {
-            internedString = new String(str);
-            stringCache.put(internedString, internedString);
-        }
-        return internedString;
-    }
-
-    /**
-     * parse out the info fields
-     * @param infoField the fields
-     * @param id the indentifier
-     * @return a mapping of keys to objects
-     */
-    private Map<String, Object> parseInfo(String infoField, String id) {
-        Map<String, Object> attributes = new HashMap<String, Object>();
-
-        if ( infoField.length() == 0 )
-            generateException("The VCF specification requires a valid info field");
-
-        if ( !infoField.equals(VCFConstants.EMPTY_INFO_FIELD) ) {
-            if ( infoField.indexOf("\t") != -1 || infoField.indexOf(" ") != -1 )
-                generateException("The VCF specification does not allow for whitespace in the INFO field");
-
-            int infoFieldSplitSize = ParsingUtils.split(infoField, infoFieldArray, VCFConstants.INFO_FIELD_SEPARATOR_CHAR, false);
-            for (int i = 0; i < infoFieldSplitSize; i++) {
-                String key;
-                Object value;
-
-                int eqI = infoFieldArray[i].indexOf("=");
-                if ( eqI != -1 ) {
-                    key = infoFieldArray[i].substring(0, eqI);
-                    String str = infoFieldArray[i].substring(eqI+1);
-
-                    // split on the INFO field separator
-                    int infoValueSplitSize = ParsingUtils.split(str, infoValueArray, VCFConstants.INFO_FIELD_ARRAY_SEPARATOR_CHAR, false);
-                    if ( infoValueSplitSize == 1 ) {
-                        value = infoValueArray[0];
-                    } else {
-                        ArrayList<String> valueList = new ArrayList<String>(infoValueSplitSize);
-                        for ( int j = 0; j < infoValueSplitSize; j++ )
-                            valueList.add(infoValueArray[j]);
-                        value = valueList;
-                    }
-                } else {
-                    key = infoFieldArray[i];
-                    value = true;
-                }
-
-                attributes.put(key, value);
-            }
-        }
-
-        if ( ! id.equals(VCFConstants.EMPTY_ID_FIELD) )
-            attributes.put(VariantContext.ID_KEY, id);
-        return attributes;
-    }
-
-    /**
-     * create a an allele from an index and an array of alleles
-     * @param index the index
-     * @param alleles the alleles
-     * @return an Allele
-     */
-    protected static Allele oneAllele(String index, List<Allele> alleles) {
-        if ( index.equals(VCFConstants.EMPTY_ALLELE) )
-            return Allele.NO_CALL;
-        int i = Integer.valueOf(index);
-        if ( i >= alleles.size() )
-            throw new TribbleException.InternalCodecException("The allele with index " + index + " is not defined in the REF/ALT columns in the record");
-        return alleles.get(i);
-    }
-
-
-    /**
-     * parse genotype alleles from the genotype string
-     * @param GT         GT string
-     * @param alleles    list of possible alleles
-     * @param cache      cache of alleles for GT
-     * @return the allele list for the GT string
-     */
-    protected static List<Allele> parseGenotypeAlleles(String GT, List<Allele> alleles, Map<String, List<Allele>> cache) {
-        // cache results [since they are immutable] and return a single object for each genotype
-        List<Allele> GTAlleles = cache.get(GT);
-
-        if ( GTAlleles == null ) {
-            StringTokenizer st = new StringTokenizer(GT, VCFConstants.PHASING_TOKENS);
-            GTAlleles = new ArrayList<Allele>(st.countTokens());
-            while ( st.hasMoreTokens() ) {
-                String genotype = st.nextToken();
-                GTAlleles.add(oneAllele(genotype, alleles));
-            }
-            cache.put(GT, GTAlleles);
-        }
-
-        return GTAlleles;
-    }
-
-    /**
-     * parse out the qual value
-     * @param qualString the quality string
-     * @return return a double
-     */
-    protected static Double parseQual(String qualString) {
-        // if we're the VCF 4 missing char, return immediately
-        if ( qualString.equals(VCFConstants.MISSING_VALUE_v4))
-            return VariantContext.NO_NEG_LOG_10PERROR;
-
-        Double val = Double.valueOf(qualString);
-
-        // check to see if they encoded the missing qual score in VCF 3 style, with either the -1 or -1.0.  check for val < 0 to save some CPU cycles
-        if ((val < 0) && (Math.abs(val - VCFConstants.MISSING_QUALITY_v3_DOUBLE) < VCFConstants.VCF_ENCODING_EPSILON))
-            return VariantContext.NO_NEG_LOG_10PERROR;
-
-        // scale and return the value
-        return val / 10.0;
-    }
-
-    /**
-     * parse out the alleles
-     * @param ref the reference base
-     * @param alts a string of alternates to break into alleles
-     * @param lineNo  the line number for this record
-     * @return a list of alleles, and a pair of the shortest and longest sequence
-     */
-    protected static List<Allele> parseAlleles(String ref, String alts, int lineNo) {
-        List<Allele> alleles = new ArrayList<Allele>(2); // we are almost always biallelic
-        // ref
-        checkAllele(ref, true, lineNo);
-        Allele refAllele = Allele.create(ref, true);
-        alleles.add(refAllele);
-
-        if ( alts.indexOf(",") == -1 ) // only 1 alternatives, don't call string split
-            parseSingleAltAllele(alleles, alts, lineNo);
-        else
-            for ( String alt : alts.split(",") )
-                parseSingleAltAllele(alleles, alt, lineNo);
-
-        return alleles;
-    }
-
-    /**
-     * check to make sure the allele is an acceptable allele
-     * @param allele the allele to check
-     * @param isRef are we the reference allele?
-     * @param lineNo  the line number for this record
-     */
-    private static void checkAllele(String allele, boolean isRef, int lineNo) {
-	if ( allele == null || allele.length() == 0 )
-	    generateException("Empty alleles are not permitted in VCF records", lineNo);
-
-        if ( isSymbolicAllele(allele) ) {
-            if ( isRef ) {
-                generateException("Symbolic alleles not allowed as reference allele: " + allele, lineNo);
-            }
-        } else {
-            // check for VCF3 insertions or deletions
-            if ( (allele.charAt(0) == VCFConstants.DELETION_ALLELE_v3) || (allele.charAt(0) == VCFConstants.INSERTION_ALLELE_v3) )
-                generateException("Insertions/Deletions are not supported when reading 3.x VCF's. Please" +
-                        " convert your file to VCF4 using VCFTools, available at http://vcftools.sourceforge.net/index.html", lineNo);
-
-            if (!Allele.acceptableAlleleBases(allele))
-                generateException("Unparsable vcf record with allele " + allele, lineNo);
-
-            if ( isRef && allele.equals(VCFConstants.EMPTY_ALLELE) )
-                generateException("The reference allele cannot be missing", lineNo);
-        }
-    }
-
-    /**
-     * return true if this is a symbolic allele (e.g. <SOMETAG>) otherwise false
-     * @param allele the allele to check
-     * @return true if the allele is a symbolic allele, otherwise false
-     */
-    private static boolean isSymbolicAllele(String allele) {
-        return (allele != null && allele.startsWith("<") && allele.endsWith(">") && allele.length() > 2);
-    }
-
-    /**
-     * parse a single allele, given the allele list
-     * @param alleles the alleles available
-     * @param alt the allele to parse
-     * @param lineNo  the line number for this record
-     */
-    private static void parseSingleAltAllele(List<Allele> alleles, String alt, int lineNo) {
-        checkAllele(alt, false, lineNo);
-
-        Allele allele = Allele.create(alt, false);
-        if ( ! allele.isNoCall() )
-            alleles.add(allele);
-    }
-
-    protected static boolean isSingleNucleotideEvent(List<Allele> alleles) {
-        for ( Allele a : alleles ) {
-            if ( a.length() != 1 )
-                return false;
-        }
-        return true;
-    }
-
-    public static int computeForwardClipping(List<Allele> unclippedAlleles, String ref) {
-        boolean clipping = true;
-
-        for ( Allele a : unclippedAlleles ) {
-            if ( a.isSymbolic() )
-                continue;
-
-            if ( a.length() < 1 || (a.getBases()[0] != ref.getBytes()[0]) ) {
-                clipping = false;
-                break;
-            }
-        }
-
-        return (clipping) ? 1 : 0;
-    }
-
-    protected static int computeReverseClipping(List<Allele> unclippedAlleles, String ref, int forwardClipping, int lineNo) {
-        int clipping = 0;
-        boolean stillClipping = true;
-
-        while ( stillClipping ) {
-            for ( Allele a : unclippedAlleles ) {
-                if ( a.isSymbolic() )
-                    continue;
-
-                if ( a.length() - clipping <= forwardClipping || a.length() - forwardClipping == 0 )
-                    stillClipping = false;
-                else if ( ref.length() == clipping )
-                    generateException("bad alleles encountered", lineNo);
-                else if ( a.getBases()[a.length()-clipping-1] != ref.getBytes()[ref.length()-clipping-1] )
-                    stillClipping = false;
-            }
-            if ( stillClipping )
-                clipping++;
-        }
-
-        return clipping;
-    }
-    /**
-     * clip the alleles, based on the reference
-     *
-     * @param position the unadjusted start position (pre-clipping)
-     * @param ref the reference string
-     * @param unclippedAlleles the list of unclipped alleles
-     * @param clippedAlleles output list of clipped alleles
-     * @param lineNo the current line number in the file
-     * @return the new reference end position of this event
-     */
-    protected static int clipAlleles(int position, String ref, List<Allele> unclippedAlleles, List<Allele> clippedAlleles, int lineNo) {
-
-        int forwardClipping = computeForwardClipping(unclippedAlleles, ref);
-        int reverseClipping = computeReverseClipping(unclippedAlleles, ref, forwardClipping, lineNo);
-
-        if ( clippedAlleles != null ) {
-            for ( Allele a : unclippedAlleles ) {
-                if ( a.isSymbolic() ) {
-                    clippedAlleles.add(a);
-                } else {
-                    clippedAlleles.add(Allele.create(Arrays.copyOfRange(a.getBases(), forwardClipping, a.getBases().length-reverseClipping), a.isReference()));
-                }
-            }
-        }
-
-        // the new reference length
-        int refLength = ref.length() - reverseClipping;
-
-        return position+Math.max(refLength - 1,0);
-    }
-
-    public final static boolean canDecodeFile(final File potentialInput, final String MAGIC_HEADER_LINE) {
-        try {
-            return isVCFStream(new FileInputStream(potentialInput), MAGIC_HEADER_LINE) ||
-                    isVCFStream(new GZIPInputStream(new FileInputStream(potentialInput)), MAGIC_HEADER_LINE) ||
-                    isVCFStream(new BlockCompressedInputStream(new FileInputStream(potentialInput)), MAGIC_HEADER_LINE);
-        } catch ( FileNotFoundException e ) {
-            return false;
-        } catch ( IOException e ) {
-            return false;
-        }
-    }
-
-    private final static boolean isVCFStream(final InputStream stream, final String MAGIC_HEADER_LINE) {
-        try {
-            byte[] buff = new byte[MAGIC_HEADER_LINE.length()];
-            int nread = stream.read(buff, 0, MAGIC_HEADER_LINE.length());
-            boolean eq = Arrays.equals(buff, MAGIC_HEADER_LINE.getBytes());
-            return eq;
-//            String firstLine = new String(buff);
-//            return firstLine.startsWith(MAGIC_HEADER_LINE);
-        } catch ( IOException e ) {
-            return false;
-        } catch ( RuntimeException e ) {
-            return false;
-        } finally {
-            try { stream.close(); } catch ( IOException e ) {}
-        }
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Allele.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Allele.java
deleted file mode 100755
index f43cd7b98..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Allele.java
+++ /dev/null
@@ -1,456 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.Collection;
-import java.util.List;
-
-/**
- * Immutable representation of an allele
- *
- * Types of alleles:
- *
- * Ref: a t C g a // C is the reference base
- *
- *    : a t G g a // C base is a G in some individuals
- *
- *    : a t - g a // C base is deleted w.r.t. the reference
- *
- *    : a t CAg a // A base is inserted w.r.t. the reference sequence
- *
- * In these cases, where are the alleles?
- *
- * SNP polymorphism of C/G  -> { C , G } -> C is the reference allele
- * 1 base deletion of C     -> { C , - } -> C is the reference allele
- * 1 base insertion of A    -> { - ; A } -> Null is the reference allele
- *
- * Suppose I see a the following in the population:
- *
- * Ref: a t C g a // C is the reference base
- *    : a t G g a // C base is a G in some individuals
- *    : a t - g a // C base is deleted w.r.t. the reference
- *
- * How do I represent this?  There are three segregating alleles:
- *
- *  { C , G , - }
- *
- * Now suppose I have this more complex example:
- *
- * Ref: a t C g a // C is the reference base
- *    : a t - g a
- *    : a t - - a
- *    : a t CAg a
- *
- * There are actually four segregating alleles:
- *
- *   { C g , - g, - -, and CAg } over bases 2-4
- *
- * However, the molecular equivalence explicitly listed above is usually discarded, so the actual
- * segregating alleles are:
- *
- *   { C g, g, -, C a g }
- *
- * Critically, it should be possible to apply an allele to a reference sequence to create the
- * correct haplotype sequence:
- *
- * Allele + reference => haplotype
- *
- * For convenience, we are going to create Alleles where the GenomeLoc of the allele is stored outside of the
- * Allele object itself.  So there's an idea of an A/C polymorphism independent of it's surrounding context.
- *
- * Given list of alleles it's possible to determine the "type" of the variation
- *
- *      A / C @ loc => SNP with
- *      - / A => INDEL
- *
- * If you know where allele is the reference, you can determine whether the variant is an insertion or deletion.
- *
- * Alelle also supports is concept of a NO_CALL allele.  This Allele represents a haplotype that couldn't be
- * determined. This is usually represented by a '.' allele.
- *
- * Note that Alleles store all bases as bytes, in **UPPER CASE**.  So 'atc' == 'ATC' from the perspective of an
- * Allele.
-
- * @author ebanks, depristo
- */
-class Allele implements Comparable<Allele> {
-    private static final byte[] EMPTY_ALLELE_BASES = new byte[0];
-
-    private boolean isRef = false;
-    private boolean isNull = false;
-    private boolean isNoCall = false;
-    private boolean isSymbolic = false;
-
-    private byte[] bases = null;
-
-    public final static String NULL_ALLELE_STRING = "-";
-    public final static String NO_CALL_STRING = ".";
-    /** A generic static NO_CALL allele for use */
-
-    // no public way to create an allele
-    private Allele(byte[] bases, boolean isRef) {
-        // standardize our representation of null allele and bases
-        if ( wouldBeNullAllele(bases) ) {
-            bases = EMPTY_ALLELE_BASES;
-            isNull = true;
-        } else if ( wouldBeNoCallAllele(bases) ) {
-            bases = EMPTY_ALLELE_BASES;
-            isNoCall = true;
-            if ( isRef ) throw new IllegalArgumentException("Cannot tag a NoCall allele as the reference allele");
-        } else if ( wouldBeSymbolicAllele(bases) ) {
-            isSymbolic = true;
-            if ( isRef ) throw new IllegalArgumentException("Cannot tag a symbolic allele as the reference allele");
-        }
-//        else
-//            bases = new String(bases).toUpperCase().getBytes(); // todo -- slow performance
-
-        this.isRef = isRef;
-        this.bases = bases;
-
-        if ( ! acceptableAlleleBases(bases) )
-            throw new IllegalArgumentException("Unexpected base in allele bases \'" + new String(bases)+"\'");
-    }
-
-    private Allele(String bases, boolean isRef) {
-        this(bases.getBytes(), isRef);
-    }
-
-
-    private final static Allele REF_A = new Allele("A", true);
-    private final static Allele ALT_A = new Allele("A", false);
-    private final static Allele REF_C = new Allele("C", true);
-    private final static Allele ALT_C = new Allele("C", false);
-    private final static Allele REF_G = new Allele("G", true);
-    private final static Allele ALT_G = new Allele("G", false);
-    private final static Allele REF_T = new Allele("T", true);
-    private final static Allele ALT_T = new Allele("T", false);
-    private final static Allele REF_N = new Allele("N", true);
-    private final static Allele ALT_N = new Allele("N", false);
-    private final static Allele REF_NULL = new Allele(NULL_ALLELE_STRING, true);
-    private final static Allele ALT_NULL = new Allele(NULL_ALLELE_STRING, false);
-    public final static Allele NO_CALL = new Allele(NO_CALL_STRING, false);
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // creation routines
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    /**
-     * Create a new Allele that includes bases and if tagged as the reference allele if isRef == true.  If bases
-     * == '-', a Null allele is created.  If bases ==  '.', a no call Allele is created.
-     *
-     * @param bases the DNA sequence of this variation, '-', of '.'
-     * @param isRef should we make this a reference allele?
-     * @throws IllegalArgumentException if bases contains illegal characters or is otherwise malformated
-     */
-    public static Allele create(byte[] bases, boolean isRef) {
-        if ( bases == null )
-            throw new IllegalArgumentException("create: the Allele base string cannot be null; use new Allele() or new Allele(\"\") to create a Null allele");
-
-        if ( bases.length == 1 ) {
-            // optimization to return a static constant Allele for each single base object
-            switch (bases[0]) {
-                case '.':
-                    if ( isRef ) throw new IllegalArgumentException("Cannot tag a NoCall allele as the reference allele");
-                    return NO_CALL;
-                case '-': return isRef ? REF_NULL : ALT_NULL;
-                case 'A': case 'a' : return isRef ? REF_A : ALT_A;
-                case 'C': case 'c' : return isRef ? REF_C : ALT_C;
-                case 'G': case 'g' : return isRef ? REF_G : ALT_G;
-                case 'T': case 't' : return isRef ? REF_T : ALT_T;
-                case 'N': case 'n' : return isRef ? REF_N : ALT_N;
-                default: throw new IllegalArgumentException("Illegal base: " + (char)bases[0]);
-            }
-        } else {
-            return new Allele(bases, isRef);
-        }
-    }
-
-    public static Allele create(byte base, boolean isRef) {
-//    public Allele(byte base, boolean isRef) {
-        return create( new byte[]{ base }, isRef);
-    }
-
-    public static Allele create(byte base) {
-        return create( base, false );
-    }
-
-    public static Allele extend(Allele left, byte[] right) {
-        if (left.isSymbolic())
-            throw new IllegalArgumentException("Cannot extend a symbolic allele");
-        byte[] bases = null;
-        if ( left.length() == 0 )
-            bases = right;
-        else {
-            bases = new byte[left.length() + right.length];
-            System.arraycopy(left.getBases(), 0, bases, 0, left.length());
-            System.arraycopy(right, 0, bases, left.length(), right.length);
-        }
-
-        return create(bases, left.isReference());
-    }
-
-    /**
-     * @param bases  bases representing an allele
-     * @return true if the bases represent the null allele
-     */
-    public static boolean wouldBeNullAllele(byte[] bases) {
-        return (bases.length == 1 && bases[0] == '-') || bases.length == 0;
-    }
-
-    /**
-     * @param bases  bases representing an allele
-     * @return true if the bases represent the NO_CALL allele
-     */
-    public static boolean wouldBeNoCallAllele(byte[] bases) {
-        return bases.length == 1 && bases[0] == '.';
-    }
-
-    /**
-     * @param bases  bases representing an allele
-     * @return true if the bases represent a symbolic allele
-     */
-    public static boolean wouldBeSymbolicAllele(byte[] bases) {
-        return bases.length > 2 && bases[0] == '<' && bases[bases.length-1] == '>';
-    }
-
-    /**
-     * @param bases  bases representing an allele
-     * @return true if the bases represent the well formatted allele
-     */
-    public static boolean acceptableAlleleBases(String bases) {
-        return acceptableAlleleBases(bases.getBytes());
-    }
-
-    /**
-     * @param bases  bases representing an allele
-     * @return true if the bases represent the well formatted allele
-     */
-    public static boolean acceptableAlleleBases(byte[] bases) {
-        if ( wouldBeNullAllele(bases) || wouldBeNoCallAllele(bases) || wouldBeSymbolicAllele(bases) )
-            return true;
-
-        for ( int i = 0; i < bases.length; i++ ) {
-            switch (bases[i]) {
-                case 'A': case 'C': case 'G': case 'T': case 'N' : case 'a': case 'c': case 'g': case 't': case 'n' :
-                    break;
-                default:
-                    return false;
-            }
-        }
-
-        return true;
-    }
-
-    /**
-     * @see Allele(byte[], boolean)
-     *
-     * @param bases  bases representing an allele
-     * @param isRef  is this the reference allele?
-     */
-    public static Allele create(String bases, boolean isRef) {
-    //public Allele(String bases, boolean isRef) {
-        return create(bases.getBytes(), isRef);
-    }
-
-
-    /**
-     * Creates a non-Ref allele.  @see Allele(byte[], boolean) for full information
-     *
-     * @param bases  bases representing an allele
-     */
-    public static Allele create(String bases) {
-        return create(bases, false);
-    }
-
-    /**
-     * Creates a non-Ref allele.  @see Allele(byte[], boolean) for full information
-     *
-     * @param bases  bases representing an allele
-     */
-    public static Allele create(byte[] bases) {
-        return create(bases, false);
-        //this(bases, false);
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // accessor routines
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    //Returns true if this is the null allele
-    public boolean isNull()             { return isNull; }
-    // Returns true if this is not the null allele
-    public boolean isNonNull()          { return ! isNull(); }
-
-    // Returns true if this is the NO_CALL allele
-    public boolean isNoCall()           { return isNoCall; }
-    // Returns true if this is not the NO_CALL allele
-    public boolean isCalled()           { return ! isNoCall(); }
-
-    // Returns true if this Allele is the reference allele
-    public boolean isReference()        { return isRef; }
-    // Returns true if this Allele is not the reference allele
-    public boolean isNonReference()     { return ! isReference(); }
-
-    // Returns true if this Allele is symbolic (i.e. no well-defined base sequence)
-    public boolean isSymbolic()         { return isSymbolic; }
-
-    // Returns a nice string representation of this object
-    public String toString() {
-        return (isNull() ? NULL_ALLELE_STRING : ( isNoCall() ? NO_CALL_STRING : getDisplayString() )) + (isReference() ? "*" : "");
-    }
-
-    /**
-     * Return the DNA bases segregating in this allele.  Note this isn't reference polarized,
-     * so the Null allele is represented by a vector of length 0
-     *
-     * @return the segregating bases
-     */
-    public byte[] getBases() { return isSymbolic ? EMPTY_ALLELE_BASES : bases; }
-
-    /**
-     * Return the DNA bases segregating in this allele in String format.
-     * This is useful, because toString() adds a '*' to reference alleles and getBases() returns garbage when you call toString() on it.
-     *
-     * @return the segregating bases
-     */
-    public String getBaseString() { return new String(getBases()); }
-
-    /**
-     * Return the printed representation of this allele.
-     * Same as getBaseString(), except for symbolic alleles.
-     * For symbolic alleles, the base string is empty while the display string contains <TAG>.
-     *
-     * @return the allele string representation
-     */
-    public String getDisplayString() { return new String(bases); }
-
-    /**
-     * @param other  the other allele
-     *
-     * @return true if these alleles are equal
-     */
-    public boolean equals(Object other) {
-        return ( ! (other instanceof Allele) ? false : equals((Allele)other, false) );
-    }
-
-    /**
-     * @return hash code
-     */
-    public int hashCode() {
-        int hash = 1;
-        for (int i = 0; i < bases.length; i++)
-            hash += (i+1) * bases[i];
-        return hash;
-    }
-
-    /**
-     * Returns true if this and other are equal.  If ignoreRefState is true, then doesn't require both alleles has the
-     * same ref tag
-     *
-     * @param other            allele to compare to
-     * @param ignoreRefState   if true, ignore ref state in comparison
-     * @return true if this and other are equal
-     */
-    public boolean equals(Allele other, boolean ignoreRefState) {
-        return this == other || (isRef == other.isRef || ignoreRefState) && isNull == other.isNull && isNoCall == other.isNoCall && (bases == other.bases || Arrays.equals(bases, other.bases));
-    }
-
-    /**
-     * @param test  bases to test against
-     *
-     * @return  true if this Alelle contains the same bases as test, regardless of its reference status; handles Null and NO_CALL alleles
-     */
-    public boolean basesMatch(byte[] test) { return !isSymbolic && (bases == test || Arrays.equals(bases, test)); }
-
-    /**
-     * @param test  bases to test against
-     *
-     * @return  true if this Alelle contains the same bases as test, regardless of its reference status; handles Null and NO_CALL alleles
-     */
-    public boolean basesMatch(String test) { return basesMatch(test.toUpperCase().getBytes()); }
-
-    /**
-     * @param test  allele to test against
-     *
-     * @return  true if this Alelle contains the same bases as test, regardless of its reference status; handles Null and NO_CALL alleles
-     */
-    public boolean basesMatch(Allele test) { return basesMatch(test.getBases()); }
-
-    /**
-     * @return the length of this allele.  Null and NO_CALL alleles have 0 length.
-     */
-    public int length() {
-        return isSymbolic ? 0 : bases.length;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // useful static functions
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public static Allele getMatchingAllele(Collection<Allele> allAlleles, String alleleBases) {
-        return getMatchingAllele(allAlleles, alleleBases.getBytes());
-    }
-
-    public static Allele getMatchingAllele(Collection<Allele> allAlleles, byte[] alleleBases) {
-        for ( Allele a : allAlleles ) {
-            if ( a.basesMatch(alleleBases) ) {
-                return a;
-            }
-        }
-
-        if ( wouldBeNoCallAllele(alleleBases) )
-            return NO_CALL;
-        else
-            return null;    // couldn't find anything
-    }
-
-    public static List<Allele> resolveAlleles(List<Allele> possibleAlleles, List<String> alleleStrings) {
-        List<Allele> myAlleles = new ArrayList<Allele>(alleleStrings.size());
-
-        for ( String alleleString : alleleStrings ) {
-            Allele allele = getMatchingAllele(possibleAlleles, alleleString);
-
-            if ( allele == null ) {
-                if ( Allele.wouldBeNoCallAllele(alleleString.getBytes()) ) {
-                    allele = create(alleleString);
-                } else {
-                    throw new IllegalArgumentException("Allele " + alleleString + " not present in the list of alleles " + possibleAlleles);
-                }
-            }
-
-            myAlleles.add(allele);
-        }
-
-        return myAlleles;
-    }
-
-    public int compareTo(Allele other) {
-        if ( isReference() && other.isNonReference() )
-            return -1;
-        else if ( isNonReference() && other.isReference() ) 
-            return 1;
-        else
-            return getBaseString().compareTo(other.getBaseString()); // todo -- potential performance issue
-    }
-
-    public static boolean oneIsPrefixOfOther(Allele a1, Allele a2) {
-        if ( a1.isNull() || a2.isNull() )
-            return true;
-
-        if ( a2.length() >= a1.length() )
-            return firstIsPrefixOfSecond(a1, a2);
-        else
-            return firstIsPrefixOfSecond(a2, a1);
-    }
-
-    private static boolean firstIsPrefixOfSecond(Allele a1, Allele a2) {
-        String a1String = a1.getBaseString();
-        return a2.getBaseString().substring(0, a1String.length()).equals(a1String);
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Genotype.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Genotype.java
deleted file mode 100755
index 91aa3b1da..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/Genotype.java
+++ /dev/null
@@ -1,349 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-
-import org.broad.tribble.util.ParsingUtils;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-
-import java.util.*;
-
-/**
- * This class encompasses all the basic information about a genotype.  It is immutable.
- *
- * @author Mark DePristo
- */
-public class Genotype {
-
-    public final static String PHASED_ALLELE_SEPARATOR = "|";
-    public final static String UNPHASED_ALLELE_SEPARATOR = "/";
-
-    protected InferredGeneticContext commonInfo;
-    public final static double NO_NEG_LOG_10PERROR = InferredGeneticContext.NO_NEG_LOG_10PERROR;
-    protected List<Allele> alleles = null; // new ArrayList<Allele>();
-    protected Type type = null;
-
-    protected boolean isPhased = false;
-    protected boolean filtersWereAppliedToContext;
-
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean isPhased) {
-        this(sampleName, alleles, negLog10PError, filters, attributes, isPhased, null);
-    }
-
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean isPhased, double[] log10Likelihoods) {
-        if ( alleles != null )
-            this.alleles = Collections.unmodifiableList(alleles);
-        commonInfo = new InferredGeneticContext(sampleName, negLog10PError, filters, attributes);
-        if ( log10Likelihoods != null )
-            commonInfo.putAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, GenotypeLikelihoods.fromLog10Likelihoods(log10Likelihoods));
-        filtersWereAppliedToContext = filters != null;
-        this.isPhased = isPhased;
-        validate();
-    }
-
-    /**
-     * Creates a new Genotype for sampleName with genotype according to alleles.
-     * @param sampleName
-     * @param alleles
-     * @param negLog10PError the confidence in these alleles
-     * @param log10Likelihoods a log10 likelihoods for each of the genotype combinations possible for alleles, in the standard VCF ordering, or null if not known
-     */
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, double[] log10Likelihoods) {
-        this(sampleName, alleles, negLog10PError, null, null, false, log10Likelihoods);
-    }
-
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError) {
-        this(sampleName, alleles, negLog10PError, null, null, false);
-    }
-
-    public Genotype(String sampleName, List<Allele> alleles) {
-        this(sampleName, alleles, NO_NEG_LOG_10PERROR, null, null, false);
-    }
-
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Partial-cloning routines (because Genotype is immutable).
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public static Genotype modifyName(Genotype g, String name) {
-        return new Genotype(name, g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, g.getAttributes(), g.isPhased());
-    }
-
-    public static Genotype modifyAttributes(Genotype g, Map<String, Object> attributes) {
-        return new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attributes, g.isPhased());
-    }
-
-    public static Genotype modifyAlleles(Genotype g, List<Allele> alleles) {
-        return new Genotype(g.getSampleName(), alleles, g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, g.getAttributes(), g.isPhased());
-    }
-
-    /**
-     * @return the alleles for this genotype
-     */
-    public List<Allele> getAlleles() {
-        return alleles;
-    }
-
-    public List<Allele> getAlleles(Allele allele) {
-        if ( getType() == Type.UNAVAILABLE )
-            throw new ReviewedStingException("Requesting alleles for an UNAVAILABLE genotype");
-
-        List<Allele> al = new ArrayList<Allele>();
-        for ( Allele a : alleles )
-            if ( a.equals(allele) )
-                al.add(a);
-
-        return Collections.unmodifiableList(al);
-    }
-
-    public Allele getAllele(int i) {
-        if ( getType() == Type.UNAVAILABLE )
-            throw new ReviewedStingException("Requesting alleles for an UNAVAILABLE genotype");
-        return alleles.get(i);
-    }
-
-    public boolean isPhased() { return isPhased; }
-
-    /**
-     * @return the ploidy of this genotype
-     */
-    public int getPloidy() {
-        if ( alleles == null )
-            throw new ReviewedStingException("Requesting ploidy for an UNAVAILABLE genotype");
-        return alleles.size();
-    }
-
-    public enum Type {
-        NO_CALL,
-        HOM_REF,
-        HET,
-        HOM_VAR,
-        UNAVAILABLE,
-        MIXED  // no-call and call in the same genotype
-    }
-
-    public Type getType() {
-        if ( type == null ) {
-            type = determineType();
-        }
-        return type;
-    }
-
-    protected Type determineType() {
-        if ( alleles == null )
-            return Type.UNAVAILABLE;
-
-        boolean sawNoCall = false, sawMultipleAlleles = false;
-        Allele observedAllele = null;
-
-        for ( Allele allele : alleles ) {
-            if ( allele.isNoCall() )
-                sawNoCall = true;
-            else if ( observedAllele == null )
-                observedAllele = allele;
-            else if ( !allele.equals(observedAllele) )
-                sawMultipleAlleles = true;
-        }
-
-        if ( sawNoCall ) {
-            if ( observedAllele == null )
-                return Type.NO_CALL;
-            return Type.MIXED;
-        }
-
-        if ( observedAllele == null )
-            throw new ReviewedStingException("BUG: there are no alleles present in this genotype but the alleles list is not null");
-
-        return sawMultipleAlleles ? Type.HET : observedAllele.isReference() ? Type.HOM_REF : Type.HOM_VAR;
-    }
-
-    /**
-     * @return true if all observed alleles are the same (regardless of whether they are ref or alt); if any alleles are no-calls, this method will return false.
-     */
-    public boolean isHom()    { return isHomRef() || isHomVar(); }
-
-    /**
-     * @return true if all observed alleles are ref; if any alleles are no-calls, this method will return false.
-     */
-    public boolean isHomRef() { return getType() == Type.HOM_REF; }
-
-    /**
-     * @return true if all observed alleles are alt; if any alleles are no-calls, this method will return false.
-     */
-    public boolean isHomVar() { return getType() == Type.HOM_VAR; }
-    
-    /**
-     * @return true if we're het (observed alleles differ); if the ploidy is less than 2 or if any alleles are no-calls, this method will return false.
-     */
-    public boolean isHet() { return getType() == Type.HET; }
-
-    /**
-     * @return true if this genotype is not actually a genotype but a "no call" (e.g. './.' in VCF); if any alleles are not no-calls (even if some are), this method will return false.
-     */
-    public boolean isNoCall() { return getType() == Type.NO_CALL; }
-
-    /**
-     * @return true if this genotype is comprised of any alleles that are not no-calls (even if some are).
-     */
-    public boolean isCalled() { return getType() != Type.NO_CALL && getType() != Type.UNAVAILABLE; }
-
-    /**
-     * @return true if this genotype is comprised of both calls and no-calls.
-     */
-    public boolean isMixed() { return getType() == Type.MIXED; }
-
-    /**
-     * @return true if the type of this genotype is set.
-     */
-    public boolean isAvailable() { return getType() != Type.UNAVAILABLE; }
-
-    //
-    // Useful methods for getting genotype likelihoods for a genotype object, if present
-    //
-    public boolean hasLikelihoods() {
-        return (hasAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY) && !getAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY).equals(VCFConstants.MISSING_VALUE_v4)) ||
-                (hasAttribute(VCFConstants.GENOTYPE_LIKELIHOODS_KEY) && !getAttribute(VCFConstants.GENOTYPE_LIKELIHOODS_KEY).equals(VCFConstants.MISSING_VALUE_v4));
-    }
-    
-    public GenotypeLikelihoods getLikelihoods() {
-        GenotypeLikelihoods x = getLikelihoods(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, true);
-        if ( x != null )
-            return x;
-        else {
-            x = getLikelihoods(VCFConstants.GENOTYPE_LIKELIHOODS_KEY, false);
-            if ( x != null ) return x;
-            else
-                throw new IllegalStateException("BUG: genotype likelihood field in " + this.getSampleName() + " sample are not either a string or a genotype likelihood class!");
-        }
-    }
-
-    private GenotypeLikelihoods getLikelihoods(String key, boolean asPL) {
-        Object x = getAttribute(key);
-        if ( x instanceof String ) {
-            if ( asPL )
-                return GenotypeLikelihoods.fromPLField((String)x);
-            else
-                return GenotypeLikelihoods.fromGLField((String)x);
-        }
-        else if ( x instanceof GenotypeLikelihoods ) return (GenotypeLikelihoods)x;
-        else return null;
-    }
-
-    public void validate() {
-        if ( alleles == null ) return;
-        if ( alleles.size() == 0) throw new IllegalArgumentException("BUG: alleles cannot be of size 0");
-
-        // int nNoCalls = 0;
-        for ( Allele allele : alleles ) {
-            if ( allele == null )
-                throw new IllegalArgumentException("BUG: allele cannot be null in Genotype");
-            // nNoCalls += allele.isNoCall() ? 1 : 0;
-        }
-
-        // Technically, the spec does allow for the below case so this is not an illegal state
-        //if ( nNoCalls > 0 && nNoCalls != alleles.size() )
-        //    throw new IllegalArgumentException("BUG: alleles include some No Calls and some Calls, an illegal state " + this);
-    }
-
-    public String getGenotypeString() {
-        return getGenotypeString(true);
-    }
-
-    public String getGenotypeString(boolean ignoreRefState) {
-        if ( alleles == null )
-            return null;
-
-        // Notes:
-        // 1. Make sure to use the appropriate separator depending on whether the genotype is phased
-        // 2. If ignoreRefState is true, then we want just the bases of the Alleles (ignoring the '*' indicating a ref Allele)
-        // 3. So that everything is deterministic with regards to integration tests, we sort Alleles (when the genotype isn't phased, of course)
-        return ParsingUtils.join(isPhased() ? PHASED_ALLELE_SEPARATOR : UNPHASED_ALLELE_SEPARATOR,
-                ignoreRefState ? getAlleleStrings() : (isPhased() ? getAlleles() : ParsingUtils.sortList(getAlleles())));
-    }
-
-    private List<String> getAlleleStrings() {
-        List<String> al = new ArrayList<String>();
-        for ( Allele a : alleles )
-            al.add(a.getBaseString());
-
-        return al;
-    }
-
-    public String toString() {
-        int Q = (int)Math.round(getPhredScaledQual());
-        return String.format("[%s %s Q%s %s]", getSampleName(), getGenotypeString(false),
-                Q == -10 ? "." : String.format("%2d",Q), sortedString(getAttributes()));
-    }
-
-    public String toBriefString() {
-        return String.format("%s:Q%.2f", getGenotypeString(false), getPhredScaledQual());
-    }
-
-    public boolean sameGenotype(Genotype other) {
-        return sameGenotype(other, true);
-    }
-
-    public boolean sameGenotype(Genotype other, boolean ignorePhase) {
-        if (getPloidy() != other.getPloidy())
-            return false; // gotta have the same number of allele to be equal
-
-        // By default, compare the elements in the lists of alleles, element-by-element
-        Collection<Allele> thisAlleles = this.getAlleles();
-        Collection<Allele> otherAlleles = other.getAlleles();
-
-        if (ignorePhase) { // do not care about order, only identity of Alleles
-            thisAlleles = new TreeSet<Allele>(thisAlleles);   //implemented Allele.compareTo()
-            otherAlleles = new TreeSet<Allele>(otherAlleles);
-        }
-
-        return thisAlleles.equals(otherAlleles);
-    }
-
-    /**
-     * a utility method for generating sorted strings from a map key set.
-     * @param c the map
-     * @param <T> the key type
-     * @param <V> the value type
-     * @return a sting, enclosed in {}, with comma seperated key value pairs in order of the keys
-     */
-    private static <T extends Comparable<T>, V> String sortedString(Map<T, V> c) {
-        // NOTE -- THIS IS COPIED FROM GATK UTILS TO ALLOW US TO KEEP A SEPARATION BETWEEN THE GATK AND VCF CODECS
-        List<T> t = new ArrayList<T>(c.keySet());
-        Collections.sort(t);
-
-        List<String> pairs = new ArrayList<String>();
-        for (T k : t) {
-            pairs.add(k + "=" + c.get(k));
-        }
-
-        return "{" + ParsingUtils.join(", ", pairs.toArray(new String[pairs.size()])) + "}";
-    }
-
-
-    // ---------------------------------------------------------------------------------------------------------
-    // 
-    // get routines to access context info fields
-    //
-    // ---------------------------------------------------------------------------------------------------------
-    public String getSampleName()       { return commonInfo.getName(); }
-    public Set<String> getFilters()     { return commonInfo.getFilters(); }
-    public boolean isFiltered()         { return commonInfo.isFiltered(); }
-    public boolean isNotFiltered()      { return commonInfo.isNotFiltered(); }
-    public boolean filtersWereApplied() { return filtersWereAppliedToContext; }
-    public boolean hasNegLog10PError()  { return commonInfo.hasNegLog10PError(); }
-    public double getNegLog10PError()   { return commonInfo.getNegLog10PError(); }
-    public double getPhredScaledQual()  { return commonInfo.getPhredScaledQual(); }
-
-    public Map<String, Object> getAttributes()  { return commonInfo.getAttributes(); }
-    public boolean hasAttribute(String key)     { return commonInfo.hasAttribute(key); }
-    public Object getAttribute(String key)      { return commonInfo.getAttribute(key); }
-    
-    public Object getAttribute(String key, Object defaultValue) {
-        return commonInfo.getAttribute(key, defaultValue); 
-    }
-
-    public String getAttributeAsString(String key, String defaultValue)   { return commonInfo.getAttributeAsString(key, defaultValue); }
-    public int getAttributeAsInt(String key, int defaultValue)            { return commonInfo.getAttributeAsInt(key, defaultValue); }
-    public double getAttributeAsDouble(String key, double  defaultValue)  { return commonInfo.getAttributeAsDouble(key, defaultValue); }
-    public boolean getAttributeAsBoolean(String key, boolean  defaultValue)  { return commonInfo.getAttributeAsBoolean(key, defaultValue); }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/GenotypeLikelihoods.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/GenotypeLikelihoods.java
deleted file mode 100755
index 02fb32451..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/GenotypeLikelihoods.java
+++ /dev/null
@@ -1,196 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.broad.tribble.TribbleException;
-import org.broadinstitute.sting.utils.MathUtils;
-
-import java.util.EnumMap;
-import java.util.Map;
-
-public class GenotypeLikelihoods {
-    public static final boolean CAP_PLS = false;
-    public static final int PL_CAP = 255;
-
-    //
-    // There are two objects here because we are lazy in creating both representations
-    // for this object: a vector of log10 Probs and the PL phred-scaled string.  Supports
-    // having one set during initializating, and dynamic creation of the other, if needed
-    //
-    private double[] log10Likelihoods = null;
-    private String likelihoodsAsString_PLs = null;
-
-    public final static GenotypeLikelihoods fromPLField(String PLs) {
-        return new GenotypeLikelihoods(PLs);
-    }
-
-    public final static GenotypeLikelihoods fromGLField(String GLs) {
-        return new GenotypeLikelihoods(parseDeprecatedGLString(GLs));
-    }
-
-    public final static GenotypeLikelihoods fromLog10Likelihoods(double[] log10Likelihoods) {
-        return new GenotypeLikelihoods(log10Likelihoods);
-    }
-
-    //
-    // You must use the factory methods now
-    //
-    protected GenotypeLikelihoods(String asString) {
-        likelihoodsAsString_PLs = asString;
-    }
-
-    protected GenotypeLikelihoods(double[] asVector) {
-        log10Likelihoods = asVector;
-    }
-
-    /**
-     * Returns the genotypes likelihoods in negative log10 vector format.  pr{AA} = x, this
-     * vector returns math.log10(x) for each of the genotypes.  Can return null if the
-     * genotype likelihoods are "missing".
-     *
-     * @return
-     */
-    public double[] getAsVector() {
-        // assumes one of the likelihoods vector or the string isn't null
-        if ( log10Likelihoods == null ) {
-            // make sure we create the GL string if it doesn't already exist
-            log10Likelihoods = parsePLsIntoLikelihoods(likelihoodsAsString_PLs);
-        }
-
-        return log10Likelihoods;
-    }
-
-    public String toString() {
-        return getAsString();
-    }
-
-    public String getAsString() {
-        if ( likelihoodsAsString_PLs == null ) {
-            // todo -- should we accept null log10Likelihoods and set PLs as MISSING?
-            if ( log10Likelihoods == null )
-                throw new TribbleException("BUG: Attempted to get likelihoods as strings and neither the vector nor the string is set!");
-            likelihoodsAsString_PLs = convertLikelihoodsToPLString(log10Likelihoods);
-        }
-
-        return likelihoodsAsString_PLs;
-    }
-
-    //Return genotype likelihoods as an EnumMap with Genotypes as keys and likelihoods as values
-    //Returns null in case of missing likelihoods
-    public EnumMap<Genotype.Type,Double> getAsMap(boolean normalizeFromLog10){
-        //Make sure that the log10likelihoods are set
-        double[] likelihoods = normalizeFromLog10 ? MathUtils.normalizeFromLog10(getAsVector()) : getAsVector();
-        if(likelihoods == null)
-            return null;
-        EnumMap<Genotype.Type,Double> likelihoodsMap = new EnumMap<Genotype.Type, Double>(Genotype.Type.class);
-        likelihoodsMap.put(Genotype.Type.HOM_REF,likelihoods[Genotype.Type.HOM_REF.ordinal()-1]);
-        likelihoodsMap.put(Genotype.Type.HET,likelihoods[Genotype.Type.HET.ordinal()-1]);
-        likelihoodsMap.put(Genotype.Type.HOM_VAR, likelihoods[Genotype.Type.HOM_VAR.ordinal() - 1]);
-        return likelihoodsMap;
-    }
-
-    //Return the neg log10 Genotype Quality (GQ) for the given genotype
-    //Returns Double.NEGATIVE_INFINITY in case of missing genotype
-    public double getNegLog10GQ(Genotype.Type genotype){
-
-        double qual = Double.NEGATIVE_INFINITY;
-        EnumMap<Genotype.Type,Double> likelihoods = getAsMap(false);
-        if(likelihoods == null)
-            return qual;
-        for(Map.Entry<Genotype.Type,Double> likelihood : likelihoods.entrySet()){
-            if(likelihood.getKey() == genotype)
-                continue;
-            if(likelihood.getValue() > qual)
-                qual = likelihood.getValue();
-
-        }
-
-        //Quality of the most likely genotype = likelihood(most likely) - likelihood (2nd best)
-        qual = likelihoods.get(genotype) - qual;
-
-        //Quality of other genotypes 1-P(G)
-        if (qual < 0) {
-            double[] normalized = MathUtils.normalizeFromLog10(getAsVector());
-            double chosenGenotype = normalized[genotype.ordinal()-1];
-            qual = -1.0 * Math.log10(1.0 - chosenGenotype);
-        }
-        return qual;
-    }
-
-    private final static double[] parsePLsIntoLikelihoods(String likelihoodsAsString_PLs) {
-        if ( !likelihoodsAsString_PLs.equals(VCFConstants.MISSING_VALUE_v4) ) {
-            String[] strings = likelihoodsAsString_PLs.split(",");
-            double[] likelihoodsAsVector = new double[strings.length];
-            for ( int i = 0; i < strings.length; i++ ) {
-                likelihoodsAsVector[i] = Integer.parseInt(strings[i]) / -10.0;
-            }
-            return likelihoodsAsVector;
-        } else
-            return null;
-    }
-
-    /**
-     * Back-compatibility function to read old style GL formatted genotype likelihoods in VCF format
-     * @param GLString
-     * @return
-     */
-    private final static double[] parseDeprecatedGLString(String GLString) {
-        if ( !GLString.equals(VCFConstants.MISSING_VALUE_v4) ) {
-            String[] strings = GLString.split(",");
-            double[] likelihoodsAsVector = new double[strings.length];
-            for ( int i = 0; i < strings.length; i++ ) {
-                likelihoodsAsVector[i] = Double.parseDouble(strings[i]);
-            }
-            return likelihoodsAsVector;
-        }
-
-        return null;
-    }
-
-    private final static String convertLikelihoodsToPLString(double[] GLs) {
-        if ( GLs == null )
-            return VCFConstants.MISSING_VALUE_v4;
-
-        StringBuilder s = new StringBuilder();
-
-        double adjust = Double.NEGATIVE_INFINITY;
-        for ( double l : GLs ) adjust = Math.max(adjust, l);
-
-        boolean first = true;
-        for ( double l : GLs ) {
-            if ( ! first )
-                s.append(",");
-            else
-                first = false;
-
-            long PL = Math.round(-10 * (l - adjust));
-            if ( CAP_PLS )
-                PL = Math.min(PL, PL_CAP);
-            s.append(Long.toString(PL));
-        }
-
-        return s.toString();
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/IndexingVCFWriter.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/IndexingVCFWriter.java
deleted file mode 100644
index 85444c325..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/IndexingVCFWriter.java
+++ /dev/null
@@ -1,143 +0,0 @@
-/*
- * Copyright (c) 2011, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import com.google.java.contract.Ensures;
-import com.google.java.contract.Requires;
-import net.sf.samtools.SAMSequenceDictionary;
-import org.broad.tribble.Tribble;
-import org.broad.tribble.TribbleException;
-import org.broad.tribble.index.DynamicIndexCreator;
-import org.broad.tribble.index.Index;
-import org.broad.tribble.index.IndexFactory;
-import org.broad.tribble.util.LittleEndianOutputStream;
-import org.broad.tribble.util.PositionalStream;
-import org.broadinstitute.sting.gatk.refdata.tracks.IndexDictionaryUtils;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-import org.broadinstitute.sting.utils.exceptions.UserException;
-
-import java.io.*;
-
-/**
- * this class writes VCF files
- */
-abstract class IndexingVCFWriter implements VCFWriter {
-    final private String name;
-    private final SAMSequenceDictionary refDict;
-
-    private OutputStream outputStream;
-    private PositionalStream positionalStream = null;
-    private DynamicIndexCreator indexer = null;
-    private LittleEndianOutputStream idxStream = null;
-
-    @Requires({"name != null",
-            "! ( location == null && output == null )",
-            "! ( enableOnTheFlyIndexing && location == null )"})
-    protected IndexingVCFWriter(final String name, final File location, final OutputStream output, final SAMSequenceDictionary refDict, final boolean enableOnTheFlyIndexing) {
-        outputStream = output;
-        this.name = name;
-        this.refDict = refDict;
-
-        if ( enableOnTheFlyIndexing ) {
-            try {
-                idxStream = new LittleEndianOutputStream(new FileOutputStream(Tribble.indexFile(location)));
-                //System.out.println("Creating index on the fly for " + location);
-                indexer = new DynamicIndexCreator(IndexFactory.IndexBalanceApproach.FOR_SEEK_TIME);
-                indexer.initialize(location, indexer.defaultBinSize());
-                positionalStream = new PositionalStream(output);
-                outputStream = positionalStream;
-            } catch ( IOException ex ) {
-                // No matter what we keep going, since we don't care if we can't create the index file
-                idxStream = null;
-                indexer = null;
-                positionalStream = null;
-            }
-        }
-    }
-
-    @Ensures("result != null")
-    public OutputStream getOutputStream() {
-        return outputStream;
-    }
-
-    @Ensures("result != null")
-    public String getStreamName() {
-        return name;
-    }
-
-    public abstract void writeHeader(VCFHeader header);
-
-    /**
-     * attempt to close the VCF file
-     */
-    public void close() {
-        // try to close the index stream (keep it separate to help debugging efforts)
-        if ( indexer != null ) {
-            try {
-                Index index = indexer.finalizeIndex(positionalStream.getPosition());
-                IndexDictionaryUtils.setIndexSequenceDictionary(index, refDict);
-                index.write(idxStream);
-                idxStream.close();
-            } catch (IOException e) {
-                throw new ReviewedStingException("Unable to close index for " + getStreamName(), e);
-            }
-        }
-    }
-
-    /**
-     * add a record to the file
-     *
-     * @param vc      the Variant Context object
-     */
-    public void add(VariantContext vc) {
-        // if we are doing on the fly indexing, add the record ***before*** we write any bytes
-        if ( indexer != null )
-            indexer.addFeature(vc, positionalStream.getPosition());
-    }
-
-    /**
-     * Returns a reasonable "name" for this writer, to display to the user if something goes wrong
-     *
-     * @param location
-     * @param stream
-     * @return
-     */
-    protected static final String writerName(final File location, final OutputStream stream) {
-        return location == null ? stream.toString() : location.getAbsolutePath();
-    }
-
-    /**
-     * Returns a output stream writing to location, or throws a UserException if this fails
-     * @param location
-     * @return
-     */
-    protected static OutputStream openOutputStream(final File location) {
-        try {
-            return new FileOutputStream(location);
-        } catch (FileNotFoundException e) {
-            throw new UserException.CouldNotCreateOutputFile(location, "Unable to create VCF writer", e);
-        }
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/InferredGeneticContext.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/InferredGeneticContext.java
deleted file mode 100755
index 43f61343e..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/InferredGeneticContext.java
+++ /dev/null
@@ -1,243 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-
-import java.util.*;
-
-
-/**
- * Common utility routines for VariantContext and Genotype
- *
- * @author depristo
- */
-final class InferredGeneticContext {
-    public static final double NO_NEG_LOG_10PERROR = -1.0;
-
-    private static Set<String> NO_FILTERS = Collections.unmodifiableSet(new HashSet<String>());
-    private static Map<String, Object> NO_ATTRIBUTES = Collections.unmodifiableMap(new HashMap<String, Object>());
-
-    private double negLog10PError = NO_NEG_LOG_10PERROR;
-    private String name = null;
-    private Set<String> filters = NO_FILTERS;
-    private Map<String, Object> attributes = NO_ATTRIBUTES;
-
-//    public InferredGeneticContext(String name) {
-//        this.name = name;
-//    }
-//
-//    public InferredGeneticContext(String name, double negLog10PError) {
-//        this(name);
-//        setNegLog10PError(negLog10PError);
-//    }
-
-    public InferredGeneticContext(String name, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
-        this.name = name;
-        setNegLog10PError(negLog10PError);
-        if ( filters != null )
-            setFilters(filters);
-        if ( attributes != null )
-            setAttributes(attributes);
-    }
-
-    /**
-     * @return the name
-     */
-    public String getName() {
-        return name;
-    }
-
-    /**
-     * Sets the name
-     *
-     * @param name    the name associated with this information
-     */
-    public void setName(String name) {
-        if ( name == null ) throw new IllegalArgumentException("Name cannot be null " + this);
-        this.name = name;
-    }
-
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Filter
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public Set<String> getFilters() {
-        return Collections.unmodifiableSet(filters);
-    }
-
-    public boolean isFiltered() {
-        return filters.size() > 0;
-    }
-
-    public boolean isNotFiltered() {
-        return ! isFiltered();
-    }
-
-    public void addFilter(String filter) {
-        if ( filters == NO_FILTERS ) // immutable -> mutable
-            filters = new HashSet<String>(filters);
-
-        if ( filter == null ) throw new IllegalArgumentException("BUG: Attempting to add null filter " + this);
-        if ( getFilters().contains(filter) ) throw new IllegalArgumentException("BUG: Attempting to add duplicate filter " + filter + " at " + this);
-        filters.add(filter);
-    }
-
-    public void addFilters(Collection<String> filters) {
-        if ( filters == null ) throw new IllegalArgumentException("BUG: Attempting to add null filters at" + this);
-        for ( String f : filters )
-            addFilter(f);
-    }
-
-    public void clearFilters() {
-        filters = new HashSet<String>();
-    }
-
-    public void setFilters(Collection<String> filters) {
-        clearFilters();
-        addFilters(filters);
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Working with log error rates
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public boolean hasNegLog10PError() {
-        return getNegLog10PError() != NO_NEG_LOG_10PERROR;
-    }
-
-    /**
-     * @return the -1 * log10-based error estimate
-     */
-    public double getNegLog10PError() { return negLog10PError; }
-    public double getPhredScaledQual() { return getNegLog10PError() * 10; }
-
-    public void setNegLog10PError(double negLog10PError) {
-        if ( negLog10PError < 0 && negLog10PError != NO_NEG_LOG_10PERROR ) throw new IllegalArgumentException("BUG: negLog10PError cannot be < than 0 : " + negLog10PError);
-        if ( Double.isInfinite(negLog10PError) ) throw new IllegalArgumentException("BUG: negLog10PError should not be Infinity");
-        if ( Double.isNaN(negLog10PError) ) throw new IllegalArgumentException("BUG: negLog10PError should not be NaN");
-
-        this.negLog10PError = negLog10PError;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Working with attributes
-    //
-    // ---------------------------------------------------------------------------------------------------------
-    public void clearAttributes() {
-        attributes = new HashMap<String, Object>();
-    }
-
-    /**
-     * @return the attribute map
-     */
-    public Map<String, Object> getAttributes() {
-        return Collections.unmodifiableMap(attributes);
-    }
-
-    // todo -- define common attributes as enum
-
-    public void setAttributes(Map<String, ?> map) {
-        clearAttributes();
-        putAttributes(map);
-    }
-
-    public void putAttribute(String key, Object value) {
-        putAttribute(key, value, false);
-    }
-
-    public void putAttribute(String key, Object value, boolean allowOverwrites) {
-        if ( ! allowOverwrites && hasAttribute(key) )
-            throw new IllegalStateException("Attempting to overwrite key->value binding: key = " + key + " this = " + this);
-
-        if ( attributes == NO_ATTRIBUTES ) // immutable -> mutable
-            attributes = new HashMap<String, Object>();
-        
-        attributes.put(key, value);
-    }
-
-    public void removeAttribute(String key) {
-        if ( attributes == NO_ATTRIBUTES ) // immutable -> mutable
-            attributes = new HashMap<String, Object>();
-        attributes.remove(key);
-    }
-
-    public void putAttributes(Map<String, ?> map) {
-        if ( map != null ) {
-            // for efficiency, we can skip the validation if the map is empty
-            if ( attributes.size() == 0 ) {
-                if ( attributes == NO_ATTRIBUTES ) // immutable -> mutable
-                    attributes = new HashMap<String, Object>();
-                attributes.putAll(map);
-            } else {
-                for ( Map.Entry<String, ?> elt : map.entrySet() ) {
-                    putAttribute(elt.getKey(), elt.getValue(), false);
-                }
-            }
-        }
-    }
-
-    public boolean hasAttribute(String key) {
-        return attributes.containsKey(key);
-    }
-
-    public int getNumAttributes() {
-        return attributes.size();
-    }
-
-    /**
-     * @param key    the attribute key
-     *
-     * @return the attribute value for the given key (or null if not set)
-     */
-    public Object getAttribute(String key) {
-        return attributes.get(key);
-    }
-
-    public Object getAttribute(String key, Object defaultValue) {
-        if ( hasAttribute(key) )
-            return attributes.get(key);
-        else
-            return defaultValue;
-    }
-
-    public String getAttributeAsString(String key, String defaultValue) {
-        Object x = getAttribute(key);
-        if ( x == null ) return defaultValue;
-        if ( x instanceof String ) return (String)x;
-        return String.valueOf(x); // throws an exception if this isn't a string
-    }
-
-    public int getAttributeAsInt(String key, int defaultValue) {
-        Object x = getAttribute(key);
-        if ( x == null || x == VCFConstants.MISSING_VALUE_v4 ) return defaultValue;
-        if ( x instanceof Integer ) return (Integer)x;
-        return Integer.valueOf((String)x); // throws an exception if this isn't a string
-    }
-
-    public double getAttributeAsDouble(String key, double defaultValue) {
-        Object x = getAttribute(key);
-        if ( x == null ) return defaultValue;
-        if ( x instanceof Double ) return (Double)x;
-        return Double.valueOf((String)x); // throws an exception if this isn't a string
-    }
-
-    public boolean getAttributeAsBoolean(String key, boolean defaultValue) {
-        Object x = getAttribute(key);
-        if ( x == null ) return defaultValue;
-        if ( x instanceof Boolean ) return (Boolean)x;
-        return Boolean.valueOf((String)x); // throws an exception if this isn't a string
-    }
-
-//    public String getAttributeAsString(String key)      { return (String.valueOf(getAttribute(key))); } // **NOTE**: will turn a null Object into the String "null"
-//    public int getAttributeAsInt(String key)            { Object x = getAttribute(key); return x instanceof Integer ? (Integer)x : Integer.valueOf((String)x); }
-//    public double getAttributeAsDouble(String key)      { Object x = getAttribute(key); return x instanceof Double ? (Double)x : Double.valueOf((String)x); }
-//    public boolean getAttributeAsBoolean(String key)      { Object x = getAttribute(key); return x instanceof Boolean ? (Boolean)x : Boolean.valueOf((String)x); }
-//    public Integer getAttributeAsIntegerNoException(String key)  { try {return getAttributeAsInt(key);} catch (Exception e) {return null;} }
-//    public Double getAttributeAsDoubleNoException(String key)    { try {return getAttributeAsDouble(key);} catch (Exception e) {return null;} }
-//    public String getAttributeAsStringNoException(String key)    { if (getAttribute(key) == null) return null; return getAttributeAsString(key); }
-//    public Boolean getAttributeAsBooleanNoException(String key)  { try {return getAttributeAsBoolean(key);} catch (Exception e) {return null;} }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableGenotype.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableGenotype.java
deleted file mode 100755
index f5072e040..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableGenotype.java
+++ /dev/null
@@ -1,68 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import java.util.*;
-
-/**
- * This class emcompasses all the basic information about a genotype.  It is immutable.
- *
- * @author Mark DePristo
- */
-class MutableGenotype extends Genotype {
-    public MutableGenotype(Genotype parent) {
-        super(parent.getSampleName(), parent.getAlleles(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
-    }
-
-    public MutableGenotype(String sampleName, Genotype parent) {
-        super(sampleName, parent.getAlleles(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
-    }
-
-
-    public MutableGenotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, boolean genotypesArePhased) {
-        super(sampleName, alleles, negLog10PError, filters, attributes, genotypesArePhased);
-    }
-
-    public MutableGenotype(String sampleName, List<Allele> alleles, double negLog10PError) {
-        super(sampleName, alleles, negLog10PError);
-    }
-
-    public MutableGenotype(String sampleName, List<Allele> alleles) {
-        super(sampleName, alleles);
-    }
-
-    public Genotype unmodifiableGenotype() {
-        return new Genotype(getSampleName(), getAlleles(), getNegLog10PError(), getFilters(), getAttributes(), isPhased());
-    }
-
-
-    /**
-     *
-     * @param alleles list of alleles
-     */
-    public void setAlleles(List<Allele> alleles) {
-        this.alleles = new ArrayList<Allele>(alleles);
-        validate();
-    }
-
-    public void setPhase(boolean isPhased) {
-        super.isPhased = isPhased;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // InferredGeneticContext mutation operators
-    //
-    // ---------------------------------------------------------------------------------------------------------
-    public void setName(String name)                    { commonInfo.setName(name); }
-    public void addFilter(String filter)                { commonInfo.addFilter(filter); }
-    public void addFilters(Collection<String> filters)  { commonInfo.addFilters(filters); }
-    public void clearFilters()                          { commonInfo.clearFilters(); }
-    public void setFilters(Collection<String> filters)  { commonInfo.setFilters(filters); }
-    public void setAttributes(Map<String, ?> map)       { commonInfo.setAttributes(map); }
-    public void clearAttributes()                       { commonInfo.clearAttributes(); }
-    public void putAttribute(String key, Object value)  { commonInfo.putAttribute(key, value); }
-    public void removeAttribute(String key)             { commonInfo.removeAttribute(key); }
-    public void putAttributes(Map<String, ?> map)       { commonInfo.putAttributes(map); }
-    public void setNegLog10PError(double negLog10PError) { commonInfo.setNegLog10PError(negLog10PError); }
-    public void putAttribute(String key, Object value, boolean allowOverwrites) { commonInfo.putAttribute(key, value, allowOverwrites); }
-
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableVariantContext.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableVariantContext.java
deleted file mode 100755
index 24e71ae50..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/MutableVariantContext.java
+++ /dev/null
@@ -1,213 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-
-import java.util.Collection;
-import java.util.Map;
-import java.util.Set;
-import java.util.TreeMap;
-
-/**
- * Mutable version of VariantContext
- *
- * @author depristo
- */
-class MutableVariantContext extends VariantContext {
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // constructors
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
-        super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
-    }
-
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
-        super(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
-    }
-
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
-        super(source, contig, start, stop, alleles, NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    public MutableVariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        super(source, contig, start, stop, alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    public MutableVariantContext(VariantContext parent) {
-        super(parent.getSource(), parent.contig, parent.start, parent.stop, parent.getAlleles(), parent.getGenotypes(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.getReferenceBaseForIndel());
-    }
-
-    /**
-     * Sets the alleles segregating in this context to the collect of alleles.  Each of which must be unique according
-     * to equals() in Allele.  Validate() should be called when you are done modifying the context.
-     *
-     * @param alleles
-     */
-    public void setAlleles(Collection<Allele> alleles) {
-        this.alleles.clear();
-        for ( Allele a : alleles )
-            addAllele(a);
-    }
-
-    /**
-     * Adds allele to the segregating allele list in this context to the collection of alleles.  The new
-     * allele must be be unique according to equals() in Allele.
-     * Validate() should be called when you are done modifying the context.
-     *
-     * @param allele
-     */
-    public void addAllele(Allele allele) {
-        final boolean allowDuplicates = false;  // used to be a parameter
-
-        type = null;
-
-        for ( Allele a : alleles ) {
-            if ( a.basesMatch(allele) && ! allowDuplicates )
-                throw new IllegalArgumentException("Duplicate allele added to VariantContext" + this);
-        }
-
-        // we are a novel allele
-        alleles.add(allele);
-    }
-
-    public void clearGenotypes() {
-        genotypes = new TreeMap<String, Genotype>();
-    }
-
-    /**
-     * Adds this single genotype to the context, not allowing duplicate genotypes to be added
-     * @param genotype
-     */
-    public void addGenotypes(Genotype genotype) {
-        putGenotype(genotype.getSampleName(), genotype, false);
-    }
-
-    /**
-     * Adds these genotypes to the context, not allowing duplicate genotypes to be added
-     * @param genotypes
-     */
-    public void addGenotypes(Collection<Genotype> genotypes) {
-        for ( Genotype g : genotypes ) {
-            addGenotype(g);
-        }
-    }
-
-    /**
-     * Adds these genotype to the context, not allowing duplicate genotypes to be added.
-     * @param genotypes
-     */
-    public void addGenotypes(Map<String, Genotype> genotypes) {
-
-        for ( Map.Entry<String, Genotype> elt : genotypes.entrySet() ) {
-            addGenotype(elt.getValue());
-        }
-    }
-
-    /**
-     * Adds these genotypes to the context.
-     *
-     * @param genotypes
-     */
-    public void putGenotypes(Map<String, Genotype> genotypes) {
-        for ( Map.Entry<String, Genotype> g : genotypes.entrySet() )
-            putGenotype(g.getKey(), g.getValue());
-    }
-
-    /**
-     * Adds these genotypes to the context.
-     *
-     * @param genotypes
-     */
-    public void putGenotypes(Collection<Genotype> genotypes) {
-        for ( Genotype g : genotypes )
-            putGenotype(g);
-    }
-
-    /**
-     * Adds this genotype to the context, throwing an error if it's already bound.
-     *
-     * @param genotype
-     */
-    public void addGenotype(Genotype genotype) {
-        addGenotype(genotype.getSampleName(), genotype);
-    }
-
-    /**
-     * Adds this genotype to the context, throwing an error if it's already bound.
-     *
-     * @param genotype
-     */
-    public void addGenotype(String sampleName, Genotype genotype) {
-        putGenotype(sampleName, genotype, false);
-    }
-
-    /**
-     * Adds this genotype to the context.
-     *
-     * @param genotype
-     */
-    public void putGenotype(Genotype genotype) {
-        putGenotype(genotype.getSampleName(), genotype);
-    }
-
-    /**
-     * Adds this genotype to the context.
-     *
-     * @param genotype
-     */
-    public void putGenotype(String sampleName, Genotype genotype) {
-        putGenotype(sampleName, genotype, true);
-    }
-
-    private void putGenotype(String sampleName, Genotype genotype, boolean allowOverwrites) {
-        if ( hasGenotype(sampleName) && ! allowOverwrites )
-            throw new IllegalStateException("Attempting to overwrite sample->genotype binding: " + sampleName + " this=" + this);
-
-        if ( ! sampleName.equals(genotype.getSampleName()) )
-            throw new IllegalStateException("Sample name doesn't equal genotype.getSample(): " + sampleName + " genotype=" + genotype);
-
-        this.genotypes.put(sampleName, genotype);
-    }
-
-    /**
-     * Removes the binding from sampleName to genotype.  If this doesn't exist, throws an IllegalArgumentException
-     * @param sampleName
-     */
-    public void removeGenotype(String sampleName) {
-        if ( ! this.genotypes.containsKey(sampleName) )
-            throw new IllegalArgumentException("Sample name isn't contained in genotypes " + sampleName + " genotypes =" + genotypes);
-
-        this.genotypes.remove(sampleName);
-    }
-
-    /**
-     * Removes genotype from the context.  If this doesn't exist, throws an IllegalArgumentException
-     * @param genotype
-     */
-    public void removeGenotype(Genotype genotype) {
-        removeGenotype(genotype.getSampleName());
-    }
-
-    // todo -- add replace genotype routine
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // InferredGeneticContext mutation operators
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public void setSource(String source)                { commonInfo.setName(source); }
-    public void addFilter(String filter)                { commonInfo.addFilter(filter); }
-    public void addFilters(Collection<String> filters)  { commonInfo.addFilters(filters); }
-    public void clearFilters()                          { commonInfo.clearFilters(); }
-    public void setFilters(Collection<String> filters)  { commonInfo.setFilters(filters); }
-    public void setAttributes(Map<String, ?> map)       { commonInfo.setAttributes(map); }
-    public void clearAttributes()                       { commonInfo.clearAttributes(); }
-    public void putAttribute(String key, Object value)  { commonInfo.putAttribute(key, value); }
-    public void removeAttribute(String key)             { commonInfo.removeAttribute(key); }
-    public void putAttributes(Map<String, ?> map)       { commonInfo.putAttributes(map); }
-    public void setNegLog10PError(double negLog10PError) { commonInfo.setNegLog10PError(negLog10PError); }
-    public void putAttribute(String key, Object value, boolean allowOverwrites) { commonInfo.putAttribute(key, value, allowOverwrites); }
-    public void setID(String id) { putAttribute(ID_KEY, id, true); }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCF3Codec.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCF3Codec.java
deleted file mode 100755
index 9f653872a..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCF3Codec.java
+++ /dev/null
@@ -1,198 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.broad.tribble.TribbleException;
-import org.broad.tribble.readers.LineReader;
-import org.broad.tribble.util.ParsingUtils;
-
-import java.io.File;
-import java.io.FileReader;
-import java.io.IOException;
-import java.util.*;
-
-
-/**
- * A feature codec for the VCF3 specification, to read older VCF files.  VCF3 has been
- * depreciated in favor of VCF4 (See VCF codec for the latest information)
- *
- * <p>
- * Reads historical VCF3 encoded files (1000 Genomes Pilot results, for example)
- * </p>
- *
- * <p>
- * See also: @see <a href="http://vcftools.sourceforge.net/specs.html">VCF specification</a><br>
- * See also: @see <a href="http://www.ncbi.nlm.nih.gov/pubmed/21653522">VCF spec. publication</a>
- * </p>
- *
- * @author Mark DePristo
- * @since 2010
- */
-class VCF3Codec extends AbstractVCFCodec {
-    public final static String VCF3_MAGIC_HEADER = "##fileformat=VCFv3";
-
-
-    /**
-     * @param reader the line reader to take header lines from
-     * @return the number of header lines
-     */
-    public Object readHeader(LineReader reader) {
-        List<String> headerStrings = new ArrayList<String>();
-
-        String line;
-        try {
-            boolean foundHeaderVersion = false;
-            while ((line = reader.readLine()) != null) {
-                lineNo++;
-                if (line.startsWith(VCFHeader.METADATA_INDICATOR)) {
-                    String[] lineFields = line.substring(2).split("=");
-                    if (lineFields.length == 2 && VCFHeaderVersion.isFormatString(lineFields[0]) ) {
-                        if ( !VCFHeaderVersion.isVersionString(lineFields[1]) )
-                            throw new TribbleException.InvalidHeader(lineFields[1] + " is not a supported version");
-                        foundHeaderVersion = true;
-                        version = VCFHeaderVersion.toHeaderVersion(lineFields[1]);
-                        if ( version != VCFHeaderVersion.VCF3_3 && version != VCFHeaderVersion.VCF3_2 )
-                            throw new TribbleException.InvalidHeader("This codec is strictly for VCFv3 and does not support " + lineFields[1]);
-                    }
-                    headerStrings.add(line);
-                }
-                else if (line.startsWith(VCFHeader.HEADER_INDICATOR)) {
-                    if (!foundHeaderVersion) {
-                        throw new TribbleException.InvalidHeader("We never saw a header line specifying VCF version");
-                    }
-                    return createHeader(headerStrings, line);
-                }
-                else {
-                    throw new TribbleException.InvalidHeader("We never saw the required CHROM header line (starting with one #) for the input VCF file");
-                }
-
-            }
-        } catch (IOException e) {
-            throw new RuntimeException("IO Exception ", e);
-        }
-        throw new TribbleException.InvalidHeader("We never saw the required CHROM header line (starting with one #) for the input VCF file");
-    }
-
-
-    /**
-     * parse the filter string, first checking to see if we already have parsed it in a previous attempt
-     * @param filterString the string to parse
-     * @return a set of the filters applied
-     */
-    protected Set<String> parseFilters(String filterString) {
-
-        // null for unfiltered
-        if ( filterString.equals(VCFConstants.UNFILTERED) )
-            return null;
-
-        // empty set for passes filters
-        LinkedHashSet<String> fFields = new LinkedHashSet<String>();
-
-        if ( filterString.equals(VCFConstants.PASSES_FILTERS_v3) )
-            return fFields;
-
-        if ( filterString.length() == 0 )
-            generateException("The VCF specification requires a valid filter status");
-
-        // do we have the filter string cached?
-        if ( filterHash.containsKey(filterString) )
-            return filterHash.get(filterString);
-
-        // otherwise we have to parse and cache the value
-        if ( filterString.indexOf(VCFConstants.FILTER_CODE_SEPARATOR) == -1 )
-            fFields.add(filterString);
-        else
-            fFields.addAll(Arrays.asList(filterString.split(VCFConstants.FILTER_CODE_SEPARATOR)));
-
-        filterHash.put(filterString, fFields);
-
-        return fFields;
-    }
-
-    /**
-     * create a genotype map
-     * @param str the string
-     * @param alleles the list of alleles
-     * @param chr chrom
-     * @param pos position
-     * @return a mapping of sample name to genotype object
-     */
-    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
-        if (genotypeParts == null)
-            genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
-
-        int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
-
-        Map<String, Genotype> genotypes = new LinkedHashMap<String, Genotype>(nParts);
-
-        // get the format keys
-        int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
-
-        // cycle through the sample names
-        Iterator<String> sampleNameIterator = header.getGenotypeSamples().iterator();
-
-        // clear out our allele mapping
-        alleleMap.clear();
-
-        // cycle through the genotype strings
-        for (int genotypeOffset = 1; genotypeOffset < nParts; genotypeOffset++) {
-            int GTValueSplitSize = ParsingUtils.split(genotypeParts[genotypeOffset], GTValueArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
-
-            double GTQual = VariantContext.NO_NEG_LOG_10PERROR;
-            Set<String> genotypeFilters = null;
-            Map<String, String> gtAttributes = null;
-            String sampleName = sampleNameIterator.next();
-
-            // check to see if the value list is longer than the key list, which is a problem
-            if (nGTKeys < GTValueSplitSize)
-                generateException("There are too many keys for the sample " + sampleName + ", keys = " + parts[8] + ", values = " + parts[genotypeOffset]);
-
-            int genotypeAlleleLocation = -1;
-            if (nGTKeys >= 1) {
-                gtAttributes = new HashMap<String, String>(nGTKeys - 1);
-
-                for (int i = 0; i < nGTKeys; i++) {
-                    final String gtKey = new String(genotypeKeyArray[i]);
-                    boolean missing = i >= GTValueSplitSize;
-
-                    if (gtKey.equals(VCFConstants.GENOTYPE_KEY)) {
-                        genotypeAlleleLocation = i;
-                    } else if (gtKey.equals(VCFConstants.GENOTYPE_QUALITY_KEY)) {
-                        GTQual = missing ? parseQual(VCFConstants.MISSING_VALUE_v4) : parseQual(GTValueArray[i]);
-                    } else if (gtKey.equals(VCFConstants.GENOTYPE_FILTER_KEY)) {
-                        genotypeFilters = missing ? parseFilters(VCFConstants.MISSING_VALUE_v4) : parseFilters(getCachedString(GTValueArray[i]));
-                    } else if ( missing || GTValueArray[i].equals(VCFConstants.MISSING_GENOTYPE_QUALITY_v3) ) {
-                        gtAttributes.put(gtKey, VCFConstants.MISSING_VALUE_v4);
-                    } else {
-                        gtAttributes.put(gtKey, new String(GTValueArray[i]));
-                    }
-                }
-            }
-
-            // check to make sure we found a genotype field
-            if ( genotypeAlleleLocation < 0 )
-                generateException("Unable to find the GT field for the record; the GT field is required");
-            if ( genotypeAlleleLocation > 0 )
-                generateException("Saw GT field at position " + genotypeAlleleLocation + ", but it must be at the first position for genotypes");
-
-            boolean phased = GTValueArray[genotypeAlleleLocation].indexOf(VCFConstants.PHASED) != -1;
-
-            // add it to the list
-            try {
-                genotypes.put(sampleName, new Genotype(sampleName,
-                        parseGenotypeAlleles(GTValueArray[genotypeAlleleLocation], alleles, alleleMap),
-                        GTQual,
-                        genotypeFilters,
-                        gtAttributes,
-                        phased));
-            } catch (TribbleException e) {
-                throw new TribbleException.InternalCodecException(e.getMessage() + ", at position " + chr+":"+pos);
-            }
-        }
-
-        return genotypes;
-    }
-
-    @Override
-    public boolean canDecode(final File potentialInput) {
-        return canDecodeFile(potentialInput, VCF3_MAGIC_HEADER);
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFAltHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFAltHeaderLine.java
deleted file mode 100644
index e432fe411..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFAltHeaderLine.java
+++ /dev/null
@@ -1,28 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-/**
- * @author ebanks
- * A class representing a key=value entry for ALT fields in the VCF header
- */
-class VCFAltHeaderLine extends VCFSimpleHeaderLine  {
-
-    /**
-     * create a VCF filter header line
-     *
-     * @param name         the name for this header line
-     * @param description  the description for this header line
-     */
-    public VCFAltHeaderLine(String name, String description) {
-        super(name, description, SupportedHeaderLineType.ALT);
-    }
-
-    /**
-     * create a VCF info header line
-     *
-     * @param line      the header line
-     * @param version   the vcf header version
-     */
-    protected VCFAltHeaderLine(String line, VCFHeaderVersion version) {
-        super(line, version, SupportedHeaderLineType.ALT);
-    }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCodec.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCodec.java
deleted file mode 100755
index f873aebcc..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCodec.java
+++ /dev/null
@@ -1,228 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.broad.tribble.TribbleException;
-import org.broad.tribble.readers.LineReader;
-import org.broad.tribble.util.ParsingUtils;
-
-import java.io.File;
-import java.io.FileReader;
-import java.io.IOException;
-import java.util.*;
-
-/**
- * A feature codec for the VCF 4 specification
- *
- * <p>
- * VCF is a text file format (most likely stored in a compressed manner). It contains meta-information lines, a
- * header line, and then data lines each containing information about a position in the genome.
- * </p>
- * <p>One of the main uses of next-generation sequencing is to discover variation amongst large populations
- * of related samples. Recently the format for storing next-generation read alignments has been
- * standardised by the SAM/BAM file format specification. This has significantly improved the
- * interoperability of next-generation tools for alignment, visualisation, and variant calling.
- * We propose the Variant Call Format (VCF) as a standarised format for storing the most prevalent
- * types of sequence variation, including SNPs, indels and larger structural variants, together
- * with rich annotations. VCF is usually stored in a compressed manner and can be indexed for
- * fast data retrieval of variants from a range of positions on the reference genome.
- * The format was developed for the 1000 Genomes Project, and has also been adopted by other projects
- * such as UK10K, dbSNP, or the NHLBI Exome Project. VCFtools is a software suite that implements
- * various utilities for processing VCF files, including validation, merging and comparing,
- * and also provides a general Perl and Python API.
- * The VCF specification and VCFtools are available from http://vcftools.sourceforge.net.</p>
- *
- * <p>
- * See also: @see <a href="http://vcftools.sourceforge.net/specs.html">VCF specification</a><br>
- * See also: @see <a href="http://www.ncbi.nlm.nih.gov/pubmed/21653522">VCF spec. publication</a>
- * </p>
- *
- * <h2>File format example</h2>
- * <pre>
- *     ##fileformat=VCFv4.0
- *     #CHROM  POS     ID      REF     ALT     QUAL    FILTER  INFO    FORMAT  NA12878
- *     chr1    109     .       A       T       0       PASS  AC=1    GT:AD:DP:GL:GQ  0/1:610,327:308:-316.30,-95.47,-803.03:99
- *     chr1    147     .       C       A       0       PASS  AC=1    GT:AD:DP:GL:GQ  0/1:294,49:118:-57.87,-34.96,-338.46:99
- * </pre>
- *
- * @author Mark DePristo
- * @since 2010
- */
-public class VCFCodec extends AbstractVCFCodec {
-    // Our aim is to read in the records and convert to VariantContext as quickly as possible, relying on VariantContext to do the validation of any contradictory (or malformed) record parameters.
-
-    public final static String VCF4_MAGIC_HEADER = "##fileformat=VCFv4";
-
-    /**
-     * @param reader the line reader to take header lines from
-     * @return the number of header lines
-     */
-    public Object readHeader(LineReader reader) {
-        List<String> headerStrings = new ArrayList<String>();
-
-        String line;
-        try {
-            boolean foundHeaderVersion = false;
-            while ((line = reader.readLine()) != null) {
-                lineNo++;
-                if (line.startsWith(VCFHeader.METADATA_INDICATOR)) {
-                    String[] lineFields = line.substring(2).split("=");
-                    if (lineFields.length == 2 && VCFHeaderVersion.isFormatString(lineFields[0]) ) {
-                        if ( !VCFHeaderVersion.isVersionString(lineFields[1]) )
-                            throw new TribbleException.InvalidHeader(lineFields[1] + " is not a supported version");
-                        foundHeaderVersion = true;
-                        version = VCFHeaderVersion.toHeaderVersion(lineFields[1]);
-                        if ( version == VCFHeaderVersion.VCF3_3 || version == VCFHeaderVersion.VCF3_2 )
-                            throw new TribbleException.InvalidHeader("This codec is strictly for VCFv4; please use the VCF3 codec for " + lineFields[1]);
-                        if ( version != VCFHeaderVersion.VCF4_0 && version != VCFHeaderVersion.VCF4_1 )
-                            throw new TribbleException.InvalidHeader("This codec is strictly for VCFv4 and does not support " + lineFields[1]);
-                    }
-                    headerStrings.add(line);
-                }
-                else if (line.startsWith(VCFHeader.HEADER_INDICATOR)) {
-                    if (!foundHeaderVersion) {
-                        throw new TribbleException.InvalidHeader("We never saw a header line specifying VCF version");
-                    }
-                    return createHeader(headerStrings, line);
-                }
-                else {
-                    throw new TribbleException.InvalidHeader("We never saw the required CHROM header line (starting with one #) for the input VCF file");
-                }
-
-            }
-        } catch (IOException e) {
-            throw new RuntimeException("IO Exception ", e);
-        }
-        throw new TribbleException.InvalidHeader("We never saw the required CHROM header line (starting with one #) for the input VCF file");
-    }
-
-
-    /**
-     * parse the filter string, first checking to see if we already have parsed it in a previous attempt
-     *
-     * @param filterString the string to parse
-     * @return a set of the filters applied or null if filters were not applied to the record (e.g. as per the missing value in a VCF)
-     */
-    protected Set<String> parseFilters(String filterString) {
-        return parseFilters(filterHash, lineNo, filterString);
-    }
-
-    public static Set<String> parseFilters(final Map<String, LinkedHashSet<String>> cache, final int lineNo, final String filterString) {
-        // null for unfiltered
-        if ( filterString.equals(VCFConstants.UNFILTERED) )
-            return null;
-
-        if ( filterString.equals(VCFConstants.PASSES_FILTERS_v4) )
-            return Collections.emptySet();
-        if ( filterString.equals(VCFConstants.PASSES_FILTERS_v3) )
-            generateException(VCFConstants.PASSES_FILTERS_v3 + " is an invalid filter name in vcf4", lineNo);
-        if ( filterString.length() == 0 )
-            generateException("The VCF specification requires a valid filter status: filter was " + filterString, lineNo);
-
-        // do we have the filter string cached?
-        if ( cache != null && cache.containsKey(filterString) )
-            return Collections.unmodifiableSet(cache.get(filterString));
-
-        // empty set for passes filters
-        LinkedHashSet<String> fFields = new LinkedHashSet<String>();
-        // otherwise we have to parse and cache the value
-        if ( filterString.indexOf(VCFConstants.FILTER_CODE_SEPARATOR) == -1 )
-            fFields.add(filterString);
-        else
-            fFields.addAll(Arrays.asList(filterString.split(VCFConstants.FILTER_CODE_SEPARATOR)));
-
-        fFields = fFields;
-        if ( cache != null ) cache.put(filterString, fFields);
-
-        return Collections.unmodifiableSet(fFields);
-    }
-
-
-    /**
-     * create a genotype map
-     * @param str the string
-     * @param alleles the list of alleles
-     * @return a mapping of sample name to genotype object
-     */
-    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
-        if (genotypeParts == null)
-            genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
-
-        int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
-
-        Map<String, Genotype> genotypes = new LinkedHashMap<String, Genotype>(nParts);
-
-        // get the format keys
-        int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
-
-        // cycle through the sample names
-        Iterator<String> sampleNameIterator = header.getGenotypeSamples().iterator();
-
-        // clear out our allele mapping
-        alleleMap.clear();
-
-        // cycle through the genotype strings
-        for (int genotypeOffset = 1; genotypeOffset < nParts; genotypeOffset++) {
-            int GTValueSplitSize = ParsingUtils.split(genotypeParts[genotypeOffset], GTValueArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
-
-            double GTQual = VariantContext.NO_NEG_LOG_10PERROR;
-            Set<String> genotypeFilters = null;
-            Map<String, String> gtAttributes = null;
-            String sampleName = sampleNameIterator.next();
-
-            // check to see if the value list is longer than the key list, which is a problem
-            if (nGTKeys < GTValueSplitSize)
-                generateException("There are too many keys for the sample " + sampleName + ", keys = " + parts[8] + ", values = " + parts[genotypeOffset]);
-
-            int genotypeAlleleLocation = -1;
-            if (nGTKeys >= 1) {
-                gtAttributes = new HashMap<String, String>(nGTKeys - 1);
-
-                for (int i = 0; i < nGTKeys; i++) {
-                    final String gtKey = new String(genotypeKeyArray[i]);
-                    boolean missing = i >= GTValueSplitSize;
-
-                    // todo -- all of these on the fly parsing of the missing value should be static constants
-                    if (gtKey.equals(VCFConstants.GENOTYPE_KEY)) {
-                        genotypeAlleleLocation = i;
-                    } else if (gtKey.equals(VCFConstants.GENOTYPE_QUALITY_KEY)) {
-                        GTQual = missing ? parseQual(VCFConstants.MISSING_VALUE_v4) : parseQual(GTValueArray[i]);
-                    } else if (gtKey.equals(VCFConstants.GENOTYPE_FILTER_KEY)) {
-                        genotypeFilters = missing ? parseFilters(VCFConstants.MISSING_VALUE_v4) : parseFilters(getCachedString(GTValueArray[i]));
-                    } else if ( missing ) {
-                        gtAttributes.put(gtKey, VCFConstants.MISSING_VALUE_v4);
-                    } else {
-                        gtAttributes.put(gtKey, new String(GTValueArray[i]));
-                    }
-                }
-            }
-
-            // check to make sure we found a genotype field if we are a VCF4.0 file
-            if ( version == VCFHeaderVersion.VCF4_0 && genotypeAlleleLocation == -1 )
-                generateException("Unable to find the GT field for the record; the GT field is required in VCF4.0");
-            if ( genotypeAlleleLocation > 0 )
-                generateException("Saw GT field at position " + genotypeAlleleLocation + ", but it must be at the first position for genotypes when present");
-
-            List<Allele> GTalleles = (genotypeAlleleLocation == -1 ? null : parseGenotypeAlleles(GTValueArray[genotypeAlleleLocation], alleles, alleleMap));
-            boolean phased = genotypeAlleleLocation != -1 && GTValueArray[genotypeAlleleLocation].indexOf(VCFConstants.PHASED) != -1;
-
-            // add it to the list
-            try {
-                genotypes.put(sampleName,
-                        new Genotype(sampleName,
-                                GTalleles,
-                                GTQual,
-                                genotypeFilters,
-                                gtAttributes,
-                                phased));
-            } catch (TribbleException e) {
-                throw new TribbleException.InternalCodecException(e.getMessage() + ", at position " + chr+":"+pos);
-            }
-        }
-
-        return genotypes;
-    }
-
-    @Override
-    public boolean canDecode(final File potentialInput) {
-        return canDecodeFile(potentialInput, VCF4_MAGIC_HEADER);
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCompoundHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCompoundHeaderLine.java
deleted file mode 100755
index 74d6cf62f..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFCompoundHeaderLine.java
+++ /dev/null
@@ -1,224 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-
-import java.util.Arrays;
-import java.util.LinkedHashMap;
-import java.util.Map;
-
-/**
- * a base class for compound header lines, which include info lines and format lines (so far)
- */
-abstract class VCFCompoundHeaderLine extends VCFHeaderLine implements VCFNamedHeaderLine {
-    public enum SupportedHeaderLineType {
-        INFO(true), FORMAT(false);
-
-        public final boolean allowFlagValues;
-        SupportedHeaderLineType(boolean flagValues) {
-            allowFlagValues = flagValues;
-        }
-    }
-
-    // the field types
-    private String name;
-    private int count = -1;
-    private VCFHeaderLineCount countType;
-    private String description;
-    private VCFHeaderLineType type;
-
-    // access methods
-    public String getName() { return name; }
-    public String getDescription() { return description; }
-    public VCFHeaderLineType getType() { return type; }
-    public VCFHeaderLineCount getCountType() { return countType; }
-    public int getCount() {
-        if ( countType != VCFHeaderLineCount.INTEGER )
-            throw new ReviewedStingException("Asking for header line count when type is not an integer");
-        return count;
-    }
-
-    // utility method
-    public int getCount(int numAltAlleles) {
-        int myCount;
-        switch ( countType ) {
-            case INTEGER: myCount = count; break;
-            case UNBOUNDED: myCount = -1; break;
-            case A: myCount = numAltAlleles; break;
-            case G: myCount = ((numAltAlleles + 1) * (numAltAlleles + 2) / 2); break;
-            default: throw new ReviewedStingException("Unknown count type: " + countType);
-        }
-        return myCount;
-    }
-
-    public void setNumberToUnbounded() {
-        countType = VCFHeaderLineCount.UNBOUNDED;
-        count = -1;
-    }
-
-    // our type of line, i.e. format, info, etc
-    private final SupportedHeaderLineType lineType;
-
-    /**
-     * create a VCF format header line
-     *
-     * @param name         the name for this header line
-     * @param count        the count for this header line
-     * @param type         the type for this header line
-     * @param description  the description for this header line
-     * @param lineType     the header line type
-     */
-    protected VCFCompoundHeaderLine(String name, int count, VCFHeaderLineType type, String description, SupportedHeaderLineType lineType) {
-        super(lineType.toString(), "");
-        this.name = name;
-        this.countType = VCFHeaderLineCount.INTEGER;
-        this.count = count;
-        this.type = type;
-        this.description = description;
-        this.lineType = lineType;
-        validate();
-    }
-
-    /**
-     * create a VCF format header line
-     *
-     * @param name         the name for this header line
-     * @param count        the count type for this header line
-     * @param type         the type for this header line
-     * @param description  the description for this header line
-     * @param lineType     the header line type
-     */
-    protected VCFCompoundHeaderLine(String name, VCFHeaderLineCount count, VCFHeaderLineType type, String description, SupportedHeaderLineType lineType) {
-        super(lineType.toString(), "");
-        this.name = name;
-        this.countType = count;
-        this.type = type;
-        this.description = description;
-        this.lineType = lineType;
-        validate();
-    }
-
-    /**
-     * create a VCF format header line
-     *
-     * @param line   the header line
-     * @param version      the VCF header version
-     * @param lineType     the header line type
-     *
-     */
-    protected VCFCompoundHeaderLine(String line, VCFHeaderVersion version, SupportedHeaderLineType lineType) {
-        super(lineType.toString(), "");
-        Map<String,String> mapping = VCFHeaderLineTranslator.parseLine(version,line, Arrays.asList("ID","Number","Type","Description"));
-        name = mapping.get("ID");
-        count = -1;
-        final String numberStr = mapping.get("Number");
-        if ( numberStr.equals(VCFConstants.PER_ALLELE_COUNT) ) {
-            countType = VCFHeaderLineCount.A;
-        } else if ( numberStr.equals(VCFConstants.PER_GENOTYPE_COUNT) ) {
-            countType = VCFHeaderLineCount.G;
-        } else if ( ((version == VCFHeaderVersion.VCF4_0 || version == VCFHeaderVersion.VCF4_1) &&
-                     numberStr.equals(VCFConstants.UNBOUNDED_ENCODING_v4)) ||
-                    ((version == VCFHeaderVersion.VCF3_2 || version == VCFHeaderVersion.VCF3_3) &&
-                     numberStr.equals(VCFConstants.UNBOUNDED_ENCODING_v3)) ) {
-            countType = VCFHeaderLineCount.UNBOUNDED;
-        } else {
-            countType = VCFHeaderLineCount.INTEGER;
-            count = Integer.valueOf(numberStr);
-
-        }
-        type = VCFHeaderLineType.valueOf(mapping.get("Type"));
-        if (type == VCFHeaderLineType.Flag && !allowFlagValues())
-            throw new IllegalArgumentException("Flag is an unsupported type for this kind of field");
-
-        description = mapping.get("Description");
-        if ( description == null && ALLOW_UNBOUND_DESCRIPTIONS ) // handle the case where there's no description provided
-            description = UNBOUND_DESCRIPTION;
-        
-        this.lineType = lineType;
-
-        validate();
-    }
-
-    private void validate() {
-        if ( name == null || type == null || description == null || lineType == null )
-            throw new IllegalArgumentException(String.format("Invalid VCFCompoundHeaderLine: key=%s name=%s type=%s desc=%s lineType=%s", 
-                    super.getKey(), name, type, description, lineType ));
-    }
-
-    /**
-     * make a string representation of this header line
-     * @return a string representation
-     */
-    protected String toStringEncoding() {
-        Map<String,Object> map = new LinkedHashMap<String,Object>();
-        map.put("ID", name);
-        Object number;
-        switch ( countType ) {
-            case A: number = VCFConstants.PER_ALLELE_COUNT; break;
-            case G: number = VCFConstants.PER_GENOTYPE_COUNT; break;
-            case UNBOUNDED: number = VCFConstants.UNBOUNDED_ENCODING_v4; break;
-            case INTEGER:
-            default: number = count;
-        }
-        map.put("Number", number);
-        map.put("Type", type);
-        map.put("Description", description);
-        return lineType.toString() + "=" + toStringEncoding(map);
-    }
-
-    /**
-     * returns true if we're equal to another compounder header line
-     * @param o a compound header line
-     * @return true if equal
-     */
-    public boolean equals(Object o) {
-        if ( !(o instanceof VCFCompoundHeaderLine) )
-            return false;
-        VCFCompoundHeaderLine other = (VCFCompoundHeaderLine)o;
-        return equalsExcludingDescription(other) &&
-                description.equals(other.description);
-    }
-
-    public boolean equalsExcludingDescription(VCFCompoundHeaderLine other) {
-        return count == other.count &&
-                countType == other.countType &&
-                type == other.type &&
-                lineType == other.lineType &&
-                name.equals(other.name);
-    }
-
-    public boolean sameLineTypeAndName(VCFCompoundHeaderLine other) {
-        return  lineType == other.lineType &&
-                name.equals(other.name);
-    }
-
-    /**
-     * do we allow flag (boolean) values? (i.e. booleans where you don't have specify the value, AQ means AQ=true)
-     * @return true if we do, false otherwise
-     */
-    abstract boolean allowFlagValues();
-
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFConstants.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFConstants.java
deleted file mode 100755
index 91f6b1ba9..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFConstants.java
+++ /dev/null
@@ -1,112 +0,0 @@
-/*
- * Copyright (c) 2010.
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
- * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import java.util.Locale;
-
-final class VCFConstants {
-    public static final Locale VCF_LOCALE = Locale.US;
-
-    // reserved INFO/FORMAT field keys
-    public static final String ANCESTRAL_ALLELE_KEY = "AA";
-    public static final String ALLELE_COUNT_KEY = "AC";
-    public static final String ALLELE_FREQUENCY_KEY = "AF";
-    public static final String ALLELE_NUMBER_KEY = "AN";
-    public static final String RMS_BASE_QUALITY_KEY = "BQ";
-    public static final String CIGAR_KEY = "CIGAR";
-    public static final String DBSNP_KEY = "DB";
-    public static final String DEPTH_KEY = "DP";
-    public static final String DOWNSAMPLED_KEY = "DS";
-    public static final String EXPECTED_ALLELE_COUNT_KEY = "EC";
-    public static final String END_KEY = "END";
-    public static final String GENOTYPE_FILTER_KEY = "FT";
-    public static final String GENOTYPE_KEY = "GT";
-    @Deprecated
-    public static final String GENOTYPE_LIKELIHOODS_KEY = "GL";         // log10 scaled genotype likelihoods
-    public static final String GENOTYPE_POSTERIORS_KEY = "GP";
-    public static final String GENOTYPE_QUALITY_KEY = "GQ";
-    public static final String HAPMAP2_KEY = "H2";
-    public static final String HAPMAP3_KEY = "H3";
-    public static final String HAPLOTYPE_QUALITY_KEY = "HQ";
-    public static final String RMS_MAPPING_QUALITY_KEY = "MQ";
-    public static final String MAPPING_QUALITY_ZERO_KEY = "MQ0";
-    public static final String SAMPLE_NUMBER_KEY = "NS";
-    public static final String PHRED_GENOTYPE_LIKELIHOODS_KEY = "PL";   // phred-scaled genotype likelihoods
-    public static final String PHASE_QUALITY_KEY = "PQ";
-    public static final String PHASE_SET_KEY = "PS";
-    public static final String OLD_DEPTH_KEY = "RD";
-    public static final String STRAND_BIAS_KEY = "SB";
-    public static final String SOMATIC_KEY = "SOMATIC";
-    public static final String VALIDATED_KEY = "VALIDATED";
-    public static final String THOUSAND_GENOMES_KEY = "1000G";
-
-    // separators
-    public static final String FORMAT_FIELD_SEPARATOR = ":";
-    public static final String GENOTYPE_FIELD_SEPARATOR = ":";
-    public static final char   GENOTYPE_FIELD_SEPARATOR_CHAR = ':';
-    public static final String FIELD_SEPARATOR = "\t";
-    public static final char   FIELD_SEPARATOR_CHAR = '\t';
-    public static final String FILTER_CODE_SEPARATOR = ";";
-    public static final String INFO_FIELD_ARRAY_SEPARATOR = ",";
-    public static final char INFO_FIELD_ARRAY_SEPARATOR_CHAR = ',';
-    public static final String ID_FIELD_SEPARATOR = ";";
-    public static final String INFO_FIELD_SEPARATOR = ";";
-    public static final char INFO_FIELD_SEPARATOR_CHAR = ';';
-    public static final String UNPHASED = "/";
-    public static final String PHASED = "|";
-    public static final String PHASED_SWITCH_PROB_v3 = "\\";
-    public static final String PHASING_TOKENS = "/|\\";
-
-    // old indel alleles
-    public static final char DELETION_ALLELE_v3 = 'D';
-    public static final char INSERTION_ALLELE_v3 = 'I';
-
-    // missing/default values
-    public static final String UNFILTERED = ".";
-    public static final String PASSES_FILTERS_v3 = "0";
-    public static final String PASSES_FILTERS_v4 = "PASS";
-    public static final String EMPTY_ID_FIELD = ".";
-    public static final String EMPTY_INFO_FIELD = ".";
-    public static final String EMPTY_ALTERNATE_ALLELE_FIELD = ".";
-    public static final String MISSING_VALUE_v4 = ".";
-    public static final String MISSING_QUALITY_v3 = "-1";
-    public static final Double MISSING_QUALITY_v3_DOUBLE = Double.valueOf(MISSING_QUALITY_v3);
-
-    public static final String MISSING_GENOTYPE_QUALITY_v3 = "-1";
-    public static final String MISSING_HAPLOTYPE_QUALITY_v3 = "-1";
-    public static final String MISSING_DEPTH_v3 = "-1";
-    public static final String UNBOUNDED_ENCODING_v4 = ".";
-    public static final String UNBOUNDED_ENCODING_v3 = "-1";
-    public static final String PER_ALLELE_COUNT = "A";
-    public static final String PER_GENOTYPE_COUNT = "G";
-    public static final String EMPTY_ALLELE = ".";
-    public static final String EMPTY_GENOTYPE = "./.";
-    public static final double MAX_GENOTYPE_QUAL = 99.0;
-
-    public static final String DOUBLE_PRECISION_FORMAT_STRING = "%.2f";
-    public static final String DOUBLE_PRECISION_INT_SUFFIX = ".00";
-    public static final Double VCF_ENCODING_EPSILON = 0.00005; // when we consider fields equal(), used in the Qual compare
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFilterHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFilterHeaderLine.java
deleted file mode 100755
index 5e16fbed0..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFilterHeaderLine.java
+++ /dev/null
@@ -1,28 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-/**
- * @author ebanks
- * A class representing a key=value entry for FILTER fields in the VCF header
- */
-class VCFFilterHeaderLine extends VCFSimpleHeaderLine  {
-
-    /**
-     * create a VCF filter header line
-     *
-     * @param name         the name for this header line
-     * @param description  the description for this header line
-     */
-    public VCFFilterHeaderLine(String name, String description) {
-        super(name, description, SupportedHeaderLineType.FILTER);
-    }
-
-    /**
-     * create a VCF info header line
-     *
-     * @param line      the header line
-     * @param version   the vcf header version
-     */
-    protected VCFFilterHeaderLine(String line, VCFHeaderVersion version) {
-        super(line, version, SupportedHeaderLineType.FILTER);
-    }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFormatHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFormatHeaderLine.java
deleted file mode 100755
index f73c032cc..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFFormatHeaderLine.java
+++ /dev/null
@@ -1,32 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-
-/**
- * @author ebanks
- *         <p/>
- *         Class VCFFormatHeaderLine
- *         <p/>
- *         A class representing a key=value entry for genotype FORMAT fields in the VCF header
- */
-class VCFFormatHeaderLine extends VCFCompoundHeaderLine {
-
-    public VCFFormatHeaderLine(String name, int count, VCFHeaderLineType type, String description) {
-        super(name, count, type, description, SupportedHeaderLineType.FORMAT);
-        if (type == VCFHeaderLineType.Flag)
-            throw new IllegalArgumentException("Flag is an unsupported type for format fields");
-    }
-
-    public VCFFormatHeaderLine(String name, VCFHeaderLineCount count, VCFHeaderLineType type, String description) {
-        super(name, count, type, description, SupportedHeaderLineType.FORMAT);
-    }
-
-    protected VCFFormatHeaderLine(String line, VCFHeaderVersion version) {
-        super(line, version, SupportedHeaderLineType.FORMAT);
-    }
-
-    // format fields do not allow flag values (that wouldn't make much sense, how would you encode this in the genotype).
-    @Override
-    boolean allowFlagValues() {
-        return false;
-    }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeader.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeader.java
deleted file mode 100755
index be1b49ec1..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeader.java
+++ /dev/null
@@ -1,198 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-
-import org.broad.tribble.util.ParsingUtils;
-
-import java.util.*;
-
-
-/**
- * @author aaron
- *         <p/>
- *         Class VCFHeader
- *         <p/>
- *         A class representing the VCF header
- */
-class VCFHeader {
-
-    // the mandatory header fields
-    public enum HEADER_FIELDS {
-        CHROM, POS, ID, REF, ALT, QUAL, FILTER, INFO
-    }
-
-    // the associated meta data
-    private final Set<VCFHeaderLine> mMetaData;
-    private final Map<String, VCFInfoHeaderLine> mInfoMetaData = new HashMap<String, VCFInfoHeaderLine>();
-    private final Map<String, VCFFormatHeaderLine> mFormatMetaData = new HashMap<String, VCFFormatHeaderLine>();
-    private final Map<String, VCFHeaderLine> mOtherMetaData = new HashMap<String, VCFHeaderLine>();
-
-    // the list of auxillary tags
-    private final Set<String> mGenotypeSampleNames = new LinkedHashSet<String>();
-
-    // the character string that indicates meta data
-    public static final String METADATA_INDICATOR = "##";
-
-    // the header string indicator
-    public static final String HEADER_INDICATOR = "#";
-
-    // were the input samples sorted originally (or are we sorting them)?
-    private boolean samplesWereAlreadySorted = true;
-
-
-    /**
-     * create a VCF header, given a list of meta data and auxillary tags
-     *
-     * @param metaData     the meta data associated with this header
-     */
-    public VCFHeader(Set<VCFHeaderLine> metaData) {
-        mMetaData = new TreeSet<VCFHeaderLine>(metaData);
-        loadVCFVersion();
-        loadMetaDataMaps();
-    }
-
-    /**
-     * create a VCF header, given a list of meta data and auxillary tags
-     *
-     * @param metaData            the meta data associated with this header
-     * @param genotypeSampleNames the sample names
-     */
-    public VCFHeader(Set<VCFHeaderLine> metaData, Set<String> genotypeSampleNames) {
-        mMetaData = new TreeSet<VCFHeaderLine>();
-        if ( metaData != null )
-            mMetaData.addAll(metaData);
-
-        mGenotypeSampleNames.addAll(genotypeSampleNames);
-
-        loadVCFVersion();
-        loadMetaDataMaps();
-
-        samplesWereAlreadySorted = ParsingUtils.isSorted(genotypeSampleNames);
-    }
-
-    /**
-     * Adds a header line to the header metadata.
-     *
-     * @param headerLine Line to add to the existing metadata component.
-     */
-    public void addMetaDataLine(VCFHeaderLine headerLine) {
-        mMetaData.add(headerLine);    
-    }
-
-    /**
-     * check our metadata for a VCF version tag, and throw an exception if the version is out of date
-     * or the version is not present
-     */
-    public void loadVCFVersion() {
-        List<VCFHeaderLine> toRemove = new ArrayList<VCFHeaderLine>();
-        for ( VCFHeaderLine line : mMetaData )
-            if ( VCFHeaderVersion.isFormatString(line.getKey())) {
-                toRemove.add(line);
-            }
-        // remove old header lines for now,
-        mMetaData.removeAll(toRemove);
-
-    }
-
-    /**
-     * load the format/info meta data maps (these are used for quick lookup by key name)
-     */
-    private void loadMetaDataMaps() {
-        for ( VCFHeaderLine line : mMetaData ) {
-            if ( line instanceof VCFInfoHeaderLine )  {
-                VCFInfoHeaderLine infoLine = (VCFInfoHeaderLine)line;
-                mInfoMetaData.put(infoLine.getName(), infoLine);
-            }
-            else if ( line instanceof VCFFormatHeaderLine ) {
-                VCFFormatHeaderLine formatLine = (VCFFormatHeaderLine)line;
-                mFormatMetaData.put(formatLine.getName(), formatLine);
-            }
-            else {
-                mOtherMetaData.put(line.getKey(), line);
-            }
-        }
-    }
-
-    /**
-     * get the header fields in order they're presented in the input file (which is now required to be
-     * the order presented in the spec).
-     *
-     * @return a set of the header fields, in order
-     */
-    public Set<HEADER_FIELDS> getHeaderFields() {
-        Set<HEADER_FIELDS> fields = new LinkedHashSet<HEADER_FIELDS>();
-        for (HEADER_FIELDS field : HEADER_FIELDS.values())
-            fields.add(field);
-        return fields;
-    }
-
-    /**
-     * get the meta data, associated with this header
-     *
-     * @return a set of the meta data
-     */
-    public Set<VCFHeaderLine> getMetaData() {
-        Set<VCFHeaderLine> lines = new LinkedHashSet<VCFHeaderLine>();
-        lines.add(new VCFHeaderLine(VCFHeaderVersion.VCF4_0.getFormatString(), VCFHeaderVersion.VCF4_0.getVersionString()));
-        lines.addAll(mMetaData);
-        return Collections.unmodifiableSet(lines);
-    }
-
-    /**
-     * get the genotyping sample names
-     *
-     * @return a list of the genotype column names, which may be empty if hasGenotypingData() returns false
-     */
-    public Set<String> getGenotypeSamples() {
-        return mGenotypeSampleNames;
-    }
-
-    /**
-     * do we have genotyping data?
-     *
-     * @return true if we have genotyping columns, false otherwise
-     */
-    public boolean hasGenotypingData() {
-        return mGenotypeSampleNames.size() > 0;
-    }
-
-    /**
-     * were the input samples sorted originally?
-     *
-     * @return true if the input samples were sorted originally, false otherwise
-     */
-    public boolean samplesWereAlreadySorted() {
-        return samplesWereAlreadySorted;
-    }
-
-    /** @return the column count */
-    public int getColumnCount() {
-        return HEADER_FIELDS.values().length + (hasGenotypingData() ? mGenotypeSampleNames.size() + 1 : 0);
-    }
-
-    /**
-     * @param key    the header key name
-     * @return the meta data line, or null if there is none
-     */
-    public VCFInfoHeaderLine getInfoHeaderLine(String key) {
-        return mInfoMetaData.get(key);
-    }
-
-    /**
-     * @param key    the header key name
-     * @return the meta data line, or null if there is none
-     */
-    public VCFFormatHeaderLine getFormatHeaderLine(String key) {
-        return mFormatMetaData.get(key);
-    }
-
-    /**
-     * @param key    the header key name
-     * @return the meta data line, or null if there is none
-     */
-    public VCFHeaderLine getOtherHeaderLine(String key) {
-        return mOtherMetaData.get(key);
-    }
-}
-
-
-
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLine.java
deleted file mode 100755
index 61b0722bd..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLine.java
+++ /dev/null
@@ -1,134 +0,0 @@
-/*
- * Copyright (c) 2010.
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
- * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.broad.tribble.TribbleException;
-
-import java.util.Map;
-
-
-/**
- * @author ebanks
- *         <p/>
- *         Class VCFHeaderLine
- *         <p/>
- *         A class representing a key=value entry in the VCF header
- */
-class VCFHeaderLine implements Comparable {
-    protected static boolean ALLOW_UNBOUND_DESCRIPTIONS = true;
-    protected static String UNBOUND_DESCRIPTION = "Not provided in original VCF header";
-
-    private String mKey = null;
-    private String mValue = null;
-
-
-    /**
-     * create a VCF header line
-     *
-     * @param key     the key for this header line
-     * @param value   the value for this header line
-     */
-    public VCFHeaderLine(String key, String value) {
-        if ( key == null )
-            throw new IllegalArgumentException("VCFHeaderLine: key cannot be null: key = " + key);
-        mKey = key;
-        mValue = value;
-    }
-
-    /**
-     * Get the key
-     *
-     * @return the key
-     */
-    public String getKey() {
-        return mKey;
-    }
-
-    /**
-     * Get the value
-     *
-     * @return the value
-     */
-    public String getValue() {
-        return mValue;
-    }
-
-    public String toString() {
-        return toStringEncoding();
-    }
-
-    /**
-     * Should be overloaded in sub classes to do subclass specific
-     *
-     * @return the string encoding
-     */
-    protected String toStringEncoding() {
-        return mKey + "=" + mValue;
-    }
-
-    public boolean equals(Object o) {
-        if ( !(o instanceof VCFHeaderLine) )
-            return false;
-        return mKey.equals(((VCFHeaderLine)o).getKey()) && mValue.equals(((VCFHeaderLine)o).getValue());
-    }
-
-    public int compareTo(Object other) {
-        return toString().compareTo(other.toString());
-    }
-
-    /**
-     * @param line    the line
-     * @return true if the line is a VCF meta data line, or false if it is not
-     */
-    public static boolean isHeaderLine(String line) {
-        return line != null && line.length() > 0 && VCFHeader.HEADER_INDICATOR.equals(line.substring(0,1));
-    }
-
-    /**
-     * create a string of a mapping pair for the target VCF version
-     * @param keyValues a mapping of the key->value pairs to output
-     * @return a string, correctly formatted
-     */
-    public static String toStringEncoding(Map<String, ? extends Object> keyValues) {
-        StringBuilder builder = new StringBuilder();
-        builder.append("<");
-        boolean start = true;
-        for (Map.Entry<String,?> entry : keyValues.entrySet()) {
-            if (start) start = false;
-            else builder.append(",");
-
-            if ( entry.getValue() == null ) throw new TribbleException.InternalCodecException("Header problem: unbound value at " + entry + " from " + keyValues);
-
-            builder.append(entry.getKey());
-            builder.append("=");
-            builder.append(entry.getValue().toString().contains(",") ||
-                           entry.getValue().toString().contains(" ") ||
-                           entry.getKey().equals("Description") ? "\""+ entry.getValue() + "\"" : entry.getValue());
-        }
-        builder.append(">");
-        return builder.toString();
-    }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineCount.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineCount.java
deleted file mode 100644
index 8fd29d188..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineCount.java
+++ /dev/null
@@ -1,8 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-/**
- * the count encodings we use for fields in VCF header lines
- */
-public enum VCFHeaderLineCount {
-    INTEGER, A, G, UNBOUNDED;
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineTranslator.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineTranslator.java
deleted file mode 100755
index 538b4ff8e..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineTranslator.java
+++ /dev/null
@@ -1,124 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import java.util.*;
-
-/**
- * A class for translating between vcf header versions
- */
-public class VCFHeaderLineTranslator {
-    private static Map<VCFHeaderVersion,VCFLineParser> mapping;
-
-    static {
-        mapping = new HashMap<VCFHeaderVersion,VCFLineParser>();
-        mapping.put(VCFHeaderVersion.VCF4_0,new VCF4Parser());
-        mapping.put(VCFHeaderVersion.VCF4_1,new VCF4Parser());
-        mapping.put(VCFHeaderVersion.VCF3_3,new VCF3Parser());
-        mapping.put(VCFHeaderVersion.VCF3_2,new VCF3Parser());
-    }
-
-    public static Map<String,String> parseLine(VCFHeaderVersion version, String valueLine, List<String> expectedTagOrder) {
-        return mapping.get(version).parseLine(valueLine,expectedTagOrder);
-    }
-}
-
-
-interface VCFLineParser {
-    public Map<String,String> parseLine(String valueLine, List<String> expectedTagOrder);
-}
-
-
-/**
- * a class that handles the to and from disk for VCF 4 lines
- */
-class VCF4Parser implements VCFLineParser {
-    Set<String> bracketed = new HashSet<String>();
-
-    /**
-     * parse a VCF4 line
-     * @param valueLine the line
-     * @return a mapping of the tags parsed out
-     */
-    public Map<String, String> parseLine(String valueLine, List<String> expectedTagOrder) {
-        // our return map
-        Map<String, String> ret = new LinkedHashMap<String, String>();
-
-        // a builder to store up characters as we go
-        StringBuilder builder = new StringBuilder();
-
-        // store the key when we're parsing out the values
-        String key = "";
-
-        // where are we in the stream of characters?
-        int index = 0;
-
-        // are we inside a quotation? we don't special case ',' then
-        boolean inQuote = false;
-
-        // a little switch machine to parse out the tags. Regex ended up being really complicated and ugly [yes, but this machine is getting ugly now... MAD]
-        for (char c: valueLine.toCharArray()) {
-            if ( c == '\"' ) {
-                inQuote = ! inQuote;
-            } else if ( inQuote ) {
-                builder.append(c);
-            } else {
-                switch (c) {
-                    case ('<') : if (index == 0) break; // if we see a open bracket at the beginning, ignore it
-                    case ('>') : if (index == valueLine.length()-1) ret.put(key,builder.toString().trim()); break; // if we see a close bracket, and we're at the end, add an entry to our list
-                    case ('=') : key = builder.toString().trim(); builder = new StringBuilder(); break; // at an equals, copy the key and reset the builder
-                    case (',') : ret.put(key,builder.toString().trim()); builder = new StringBuilder(); break; // drop the current key value to the return map
-                    default: builder.append(c); // otherwise simply append to the current string
-                }
-            }
-            
-            index++;
-        }
-
-        // validate the tags against the expected list
-        index = 0;
-        if (ret.size() > expectedTagOrder.size()) throw new IllegalArgumentException("Unexpected tag count " + ret.size() + " in string " + expectedTagOrder.size());
-        for (String str : ret.keySet()) {
-            if (!expectedTagOrder.get(index).equals(str)) throw new IllegalArgumentException("Unexpected tag " + str + " in string " + valueLine);
-            index++;
-        }
-        return ret;
-    }
-}
-
-class VCF3Parser implements VCFLineParser {
-
-    public Map<String, String> parseLine(String valueLine, List<String> expectedTagOrder) {
-        // our return map
-        Map<String, String> ret = new LinkedHashMap<String, String>();
-
-        // a builder to store up characters as we go
-        StringBuilder builder = new StringBuilder();
-
-        // where are we in the stream of characters?
-        int index = 0;
-        // where in the expected tag order are we?
-        int tagIndex = 0;
-
-        // are we inside a quotation? we don't special case ',' then
-        boolean inQuote = false;
-
-        // a little switch machine to parse out the tags. Regex ended up being really complicated and ugly
-        for (char c: valueLine.toCharArray()) {
-            switch (c) {
-                case ('\"') : inQuote = !inQuote; break; // a quote means we ignore ',' in our strings, keep track of it
-                case (',') : if (!inQuote) { ret.put(expectedTagOrder.get(tagIndex++),builder.toString()); builder = new StringBuilder(); break; } // drop the current key value to the return map
-                default: builder.append(c); // otherwise simply append to the current string
-            }
-            index++;
-        }
-        ret.put(expectedTagOrder.get(tagIndex++),builder.toString());
-        
-        // validate the tags against the expected list
-        index = 0;
-        if (tagIndex != expectedTagOrder.size()) throw new IllegalArgumentException("Unexpected tag count " + tagIndex + ", we expected " + expectedTagOrder.size());
-        for (String str : ret.keySet()){
-            if (!expectedTagOrder.get(index).equals(str)) throw new IllegalArgumentException("Unexpected tag " + str + " in string " + valueLine);
-            index++;
-        }
-        return ret;
-    }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineType.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineType.java
deleted file mode 100755
index 65cf1a327..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderLineType.java
+++ /dev/null
@@ -1,8 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-/**
- * the type encodings we use for fields in VCF header lines
- */
-enum VCFHeaderLineType {
-    Integer, Float, String, Character, Flag;
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderVersion.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderVersion.java
deleted file mode 100755
index 21e737abe..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFHeaderVersion.java
+++ /dev/null
@@ -1,91 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.broad.tribble.TribbleException;
-
-/**
- * information that identifies each header version
- */
-enum VCFHeaderVersion {
-    VCF3_2("VCRv3.2","format"),
-    VCF3_3("VCFv3.3","fileformat"),
-    VCF4_0("VCFv4.0","fileformat"),
-    VCF4_1("VCFv4.1","fileformat");
-
-    private final String versionString;
-    private final String formatString;
-
-    /**
-     * create the enum, privately, using:
-     * @param vString the version string
-     * @param fString the format string
-     */
-    VCFHeaderVersion(String vString, String fString) {
-        this.versionString = vString;
-        this.formatString = fString;
-    }
-
-    /**
-     * get the header version
-     * @param version the version string
-     * @return a VCFHeaderVersion object
-     */
-    public static VCFHeaderVersion toHeaderVersion(String version) {
-        version = clean(version);
-        for (VCFHeaderVersion hv : VCFHeaderVersion.values())
-            if (hv.versionString.equals(version))
-                    return hv;
-        return null;
-    }
-
-    /**
-     * are we a valid version string of some type
-     * @param version the version string
-     * @return true if we're valid of some type, false otherwise
-     */
-    public static boolean isVersionString(String version){
-        return toHeaderVersion(version) != null;
-    }
-
-    /**
-     * are we a valid format string for some type
-     * @param format the format string
-     * @return true if we're valid of some type, false otherwise
-     */
-    public static boolean isFormatString(String format){
-        format = clean(format);
-        for (VCFHeaderVersion hv : VCFHeaderVersion.values())
-            if (hv.formatString.equals(format))
-                    return true;
-        return false;
-    }
-
-    public static VCFHeaderVersion getHeaderVersion(String versionLine) {
-        String[] lineFields = versionLine.split("=");
-        if ( lineFields.length != 2 || !isFormatString(lineFields[0].substring(2)) )
-            throw new TribbleException.InvalidHeader(versionLine + " is not a valid VCF version line");
-
-        if ( !isVersionString(lineFields[1]) )
-            throw new TribbleException.InvalidHeader(lineFields[1] + " is not a supported version");
-
-        return toHeaderVersion(lineFields[1]);
-    }
-
-    /**
-     * Utility function to clean up a VCF header string
-     * 
-     * @param s string
-     * @return  trimmed version of s
-     */
-    private static String clean(String s) {
-        return s.trim();
-    }
-
-
-    public String getVersionString() {
-        return versionString;
-    }
-
-    public String getFormatString() {
-        return formatString;
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFInfoHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFInfoHeaderLine.java
deleted file mode 100755
index 642a78b76..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFInfoHeaderLine.java
+++ /dev/null
@@ -1,29 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-
-/**
- * @author ebanks
- *         <p/>
- *         Class VCFInfoHeaderLine
- *         <p/>
- *         A class representing a key=value entry for INFO fields in the VCF header
- */
-class VCFInfoHeaderLine extends VCFCompoundHeaderLine {
-    public VCFInfoHeaderLine(String name, int count, VCFHeaderLineType type, String description) {
-        super(name, count, type, description, SupportedHeaderLineType.INFO);
-    }
-
-    public VCFInfoHeaderLine(String name, VCFHeaderLineCount count, VCFHeaderLineType type, String description) {
-        super(name, count, type, description, SupportedHeaderLineType.INFO);
-    }
-
-    protected VCFInfoHeaderLine(String line, VCFHeaderVersion version) {
-        super(line, version, SupportedHeaderLineType.INFO);
-    }
-
-    // info fields allow flag values
-    @Override
-    boolean allowFlagValues() {
-        return true;
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFNamedHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFNamedHeaderLine.java
deleted file mode 100755
index b3ce5d841..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFNamedHeaderLine.java
+++ /dev/null
@@ -1,30 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-/** an interface for named header lines **/
-interface VCFNamedHeaderLine {
-    String getName();
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFParser.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFParser.java
deleted file mode 100755
index 95a3f7bf1..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFParser.java
+++ /dev/null
@@ -1,22 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import java.util.List;
-import java.util.Map;
-
-
-/**
- * All VCF codecs need to implement this interface so that we can perform lazy loading.
- */
-interface VCFParser {
-
-    /**
-     * create a genotype map
-     * @param str the string
-     * @param alleles the list of alleles
-     * @param chr chrom
-     * @param pos position
-     * @return a mapping of sample name to genotype object
-     */
-    public Map<String, Genotype> createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
-
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFSimpleHeaderLine.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFSimpleHeaderLine.java
deleted file mode 100644
index 17706c705..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFSimpleHeaderLine.java
+++ /dev/null
@@ -1,81 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import java.util.Arrays;
-import java.util.LinkedHashMap;
-import java.util.Map;
-
-
-/**
- * @author ebanks
- * A class representing a key=value entry for simple VCF header types
- */
-abstract class VCFSimpleHeaderLine extends VCFHeaderLine implements VCFNamedHeaderLine  {
-
-    public enum SupportedHeaderLineType {
-        FILTER, ALT;
-    }
-
-    private String name;
-    private String description;
-
-    // our type of line, i.e. filter, alt, etc
-    private final SupportedHeaderLineType lineType;
-
-
-    /**
-     * create a VCF filter header line
-     *
-     * @param name         the name for this header line
-     * @param description  the description for this header line
-     * @param lineType     the header line type
-     */
-    public VCFSimpleHeaderLine(String name, String description, SupportedHeaderLineType lineType) {
-        super(lineType.toString(), "");
-        this.lineType = lineType;
-        this.name = name;
-        this.description = description;
-
-        if ( name == null || description == null )
-            throw new IllegalArgumentException(String.format("Invalid VCFSimpleHeaderLine: key=%s name=%s desc=%s", super.getKey(), name, description ));
-    }
-
-    /**
-     * create a VCF info header line
-     *
-     * @param line      the header line
-     * @param version   the vcf header version
-     * @param lineType     the header line type
-     */
-    protected VCFSimpleHeaderLine(String line, VCFHeaderVersion version, SupportedHeaderLineType lineType) {
-        super(lineType.toString(), "");
-        this.lineType = lineType;
-        Map<String,String> mapping = VCFHeaderLineTranslator.parseLine(version,line, Arrays.asList("ID","Description"));
-        name = mapping.get("ID");
-        description = mapping.get("Description");
-        if ( description == null && ALLOW_UNBOUND_DESCRIPTIONS ) // handle the case where there's no description provided 
-            description = UNBOUND_DESCRIPTION;
-    }
-
-    protected String toStringEncoding() {
-        Map<String,Object> map = new LinkedHashMap<String,Object>();
-        map.put("ID", name);
-        map.put("Description", description);
-        return lineType.toString() + "=" + toStringEncoding(map);
-    }
-
-    public boolean equals(Object o) {
-        if ( !(o instanceof VCFSimpleHeaderLine) )
-            return false;
-        VCFSimpleHeaderLine other = (VCFSimpleHeaderLine)o;
-        return name.equals(other.name) &&
-               description.equals(other.description);
-    }
-
-    public String getName() {
-        return name;
-    }
-
-    public String getDescription() {
-        return description;
-    }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFUtils.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFUtils.java
deleted file mode 100755
index dc78d40ac..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFUtils.java
+++ /dev/null
@@ -1,227 +0,0 @@
-/*
- * Copyright (c) 2010 The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
- * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.apache.log4j.Logger;
-import org.broad.tribble.Feature;
-import org.broadinstitute.sting.commandline.RodBinding;
-import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
-import org.broadinstitute.sting.gatk.datasources.rmd.ReferenceOrderedDataSource;
-
-import java.util.*;
-
-/**
- * A set of static utility methods for common operations on VCF files/records.
- */
-class VCFUtils {
-    /**
-     * Constructor access disallowed...static utility methods only!
-     */
-    private VCFUtils() { }
-
-    public static <T extends Feature> Map<String, VCFHeader> getVCFHeadersFromRods(GenomeAnalysisEngine toolkit, List<RodBinding<T>> rodBindings) {
-        // Collect the eval rod names
-        final Set<String> names = new TreeSet<String>();
-        for ( final RodBinding<T> evalRod : rodBindings )
-            names.add(evalRod.getName());
-        return getVCFHeadersFromRods(toolkit, names);
-    }
-
-    public static Map<String, VCFHeader> getVCFHeadersFromRods(GenomeAnalysisEngine toolkit) {
-        return getVCFHeadersFromRods(toolkit, (Collection<String>)null);
-    }
-
-    public static Map<String, VCFHeader> getVCFHeadersFromRods(GenomeAnalysisEngine toolkit, Collection<String> rodNames) {
-        Map<String, VCFHeader> data = new HashMap<String, VCFHeader>();
-
-        // iterate to get all of the sample names
-        List<ReferenceOrderedDataSource> dataSources = toolkit.getRodDataSources();
-        for ( ReferenceOrderedDataSource source : dataSources ) {
-            // ignore the rod if it's not in our list
-            if ( rodNames != null && !rodNames.contains(source.getName()) )
-                continue;
-
-            if ( source.getHeader() != null && source.getHeader() instanceof VCFHeader )
-                data.put(source.getName(), (VCFHeader)source.getHeader());
-        }
-
-        return data;
-    }
-
-    public static Map<String,VCFHeader> getVCFHeadersFromRodPrefix(GenomeAnalysisEngine toolkit,String prefix) {
-        Map<String, VCFHeader> data = new HashMap<String, VCFHeader>();
-
-        // iterate to get all of the sample names
-        List<ReferenceOrderedDataSource> dataSources = toolkit.getRodDataSources();
-        for ( ReferenceOrderedDataSource source : dataSources ) {
-            // ignore the rod if lacks the prefix
-            if ( ! source.getName().startsWith(prefix) )
-                continue;
-
-            if ( source.getHeader() != null && source.getHeader() instanceof VCFHeader )
-                data.put(source.getName(), (VCFHeader)source.getHeader());
-        }
-
-        return data;
-    }
-
-    /**
-     * Gets the header fields from all VCF rods input by the user
-     *
-     * @param toolkit    GATK engine
-     *
-     * @return a set of all fields
-     */
-    public static Set<VCFHeaderLine> getHeaderFields(GenomeAnalysisEngine toolkit) {
-        return getHeaderFields(toolkit, null);
-    }
-
-    /**
-     * Gets the header fields from all VCF rods input by the user
-     *
-     * @param toolkit    GATK engine
-     * @param rodNames   names of rods to use, or null if we should use all possible ones
-     *
-     * @return a set of all fields
-     */
-    public static Set<VCFHeaderLine> getHeaderFields(GenomeAnalysisEngine toolkit, Collection<String> rodNames) {
-
-        // keep a map of sample name to occurrences encountered
-        TreeSet<VCFHeaderLine> fields = new TreeSet<VCFHeaderLine>();
-
-        // iterate to get all of the sample names
-        List<ReferenceOrderedDataSource> dataSources = toolkit.getRodDataSources();
-        for ( ReferenceOrderedDataSource source : dataSources ) {
-            // ignore the rod if it's not in our list
-            if ( rodNames != null && !rodNames.contains(source.getName()) )
-                continue;
-
-            if ( source.getRecordType().equals(VariantContext.class)) {
-                VCFHeader header = (VCFHeader)source.getHeader();
-                if ( header != null )
-                    fields.addAll(header.getMetaData());
-            }
-        }
-
-        return fields;
-    }
-
-    /** Only displays a warning if a logger is provided and an identical warning hasn't been already issued */
-    private static final class HeaderConflictWarner {
-        Logger logger;
-        Set<String> alreadyIssued = new HashSet<String>();
-
-        private HeaderConflictWarner(final Logger logger) {
-            this.logger = logger;
-        }
-
-        public void warn(final VCFHeaderLine line, final String msg) {
-            if ( logger != null && ! alreadyIssued.contains(line.getKey()) ) {
-                alreadyIssued.add(line.getKey());
-                logger.warn(msg);
-            }
-        }
-    }
-
-    public static Set<VCFHeaderLine> smartMergeHeaders(Collection<VCFHeader> headers, Logger logger) throws IllegalStateException {
-        HashMap<String, VCFHeaderLine> map = new HashMap<String, VCFHeaderLine>(); // from KEY.NAME -> line
-        HeaderConflictWarner conflictWarner = new HeaderConflictWarner(logger);
-
-        // todo -- needs to remove all version headers from sources and add its own VCF version line
-        for ( VCFHeader source : headers ) {
-            //System.out.printf("Merging in header %s%n", source);
-            for ( VCFHeaderLine line : source.getMetaData()) {
-                String key = line.getKey();
-
-                if ( line instanceof VCFNamedHeaderLine)
-                    key = key + "" + ((VCFNamedHeaderLine) line).getName();
-
-                if ( map.containsKey(key) ) {
-                    VCFHeaderLine other = map.get(key);
-                    if ( line.equals(other) )
-                        continue;
-                    else if ( ! line.getClass().equals(other.getClass()) )
-                        throw new IllegalStateException("Incompatible header types: " + line + " " + other );
-                    else if ( line instanceof VCFFilterHeaderLine) {
-                        String lineName = ((VCFFilterHeaderLine) line).getName();                                                                                                         String otherName = ((VCFFilterHeaderLine) other).getName();
-                        if ( ! lineName.equals(otherName) )
-                            throw new IllegalStateException("Incompatible header types: " + line + " " + other );
-                    } else if ( line instanceof VCFCompoundHeaderLine ) {
-                        VCFCompoundHeaderLine compLine = (VCFCompoundHeaderLine)line;
-                        VCFCompoundHeaderLine compOther = (VCFCompoundHeaderLine)other;
-
-                        // if the names are the same, but the values are different, we need to quit
-                        if (! (compLine).equalsExcludingDescription(compOther) ) {
-                            if ( compLine.getType().equals(compOther.getType()) ) {
-                                // The Number entry is an Integer that describes the number of values that can be
-                                // included with the INFO field. For example, if the INFO field contains a single
-                                // number, then this value should be 1. However, if the INFO field describes a pair
-                                // of numbers, then this value should be 2 and so on. If the number of possible
-                                // values varies, is unknown, or is unbounded, then this value should be '.'.
-                                conflictWarner.warn(line, "Promoting header field Number to . due to number differences in header lines: " + line + " " + other);
-                                compOther.setNumberToUnbounded();
-                            } else if ( compLine.getType() == VCFHeaderLineType.Integer && compOther.getType() == VCFHeaderLineType.Float ) {
-                                // promote key to Float
-                                conflictWarner.warn(line, "Promoting Integer to Float in header: " + compOther);
-                                map.put(key, compOther);
-                            } else if ( compLine.getType() == VCFHeaderLineType.Float && compOther.getType() == VCFHeaderLineType.Integer ) {
-                                // promote key to Float
-                                conflictWarner.warn(line, "Promoting Integer to Float in header: " + compOther);
-                            } else {
-                                throw new IllegalStateException("Incompatible header types, collision between these two types: " + line + " " + other );
-                            }
-                        }
-                        if ( ! compLine.getDescription().equals(compOther) )
-                            conflictWarner.warn(line, "Allowing unequal description fields through: keeping " + compOther + " excluding " + compLine);
-                    } else {
-                        // we are not equal, but we're not anything special either
-                        conflictWarner.warn(line, "Ignoring header line already in map: this header line = " + line + " already present header = " + other);
-                    }
-                } else {
-                    map.put(key, line);
-                    //System.out.printf("Adding header line %s%n", line);
-                }
-            }
-        }
-
-        return new HashSet<VCFHeaderLine>(map.values());
-    }
-
-    public static String rsIDOfFirstRealVariant(List<VariantContext> VCs, VariantContext.Type type) {
-        if ( VCs == null )
-            return null;
-
-        String rsID = null;
-        for ( VariantContext vc : VCs ) {
-            if ( vc.getType() == type ) {
-                rsID = vc.getID();
-                break;
-            }
-        }
-
-        return rsID;
-    }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFWriter.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFWriter.java
deleted file mode 100755
index 15bdb5046..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VCFWriter.java
+++ /dev/null
@@ -1,16 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-/**
- * this class writes VCF files
- */
-public interface VCFWriter {
-
-    public void writeHeader(VCFHeader header);
-
-    /**
-     * attempt to close the VCF file
-     */
-    public void close();
-
-    public void add(VariantContext vc);
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContext.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContext.java
deleted file mode 100755
index 3a193a00a..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContext.java
+++ /dev/null
@@ -1,1615 +0,0 @@
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.broad.tribble.Feature;
-import org.broad.tribble.TribbleException;
-import org.broad.tribble.util.ParsingUtils;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-
-import java.util.*;
-
-/**
- * Class VariantContext
- *
- * == High-level overview ==
- *
- * The VariantContext object is a single general class system for representing genetic variation data composed of:
- *
- * * Allele: representing single genetic haplotypes (A, T, ATC, -)
- * * Genotype: an assignment of alleles for each chromosome of a single named sample at a particular locus
- * * VariantContext: an abstract class holding all segregating alleles at a locus as well as genotypes
- *    for multiple individuals containing alleles at that locus
- *
- * The class system works by defining segregating alleles, creating a variant context representing the segregating
- * information at a locus, and potentially creating and associating genotypes with individuals in the context.
- *
- * All of the classes are highly validating -- call validate() if you modify them -- so you can rely on the
- * self-consistency of the data once you have a VariantContext in hand.  The system has a rich set of assessor
- * and manipulator routines, as well as more complex static support routines in VariantContextUtils.
- *
- * The VariantContext (and Genotype) objects are attributed (supporting addition of arbitrary key/value pairs) and
- * filtered (can represent a variation that is viewed as suspect).
- *
- * VariantContexts are dynamically typed, so whether a VariantContext is a SNP, Indel, or NoVariant depends
- * on the properties of the alleles in the context.  See the detailed documentation on the Type parameter below.
- *
- * It's also easy to create subcontexts based on selected genotypes.
- *
- * == Working with Variant Contexts ==
- * By default, VariantContexts are immutable.  In order to access (in the rare circumstances where you need them)
- * setter routines, you need to create MutableVariantContexts and MutableGenotypes.
- *
- * === Some example data ===
- *
- * Allele A, Aref, T, Tref;
- * Allele del, delRef, ATC, ATCref;
- *
- * A [ref] / T at 10
- * GenomeLoc snpLoc = GenomeLocParser.createGenomeLoc("chr1", 10, 10);
- *
- * - / ATC [ref] from 20-23
- * GenomeLoc delLoc = GenomeLocParser.createGenomeLoc("chr1", 20, 22);
- *
- *  // - [ref] / ATC immediately after 20
- * GenomeLoc insLoc = GenomeLocParser.createGenomeLoc("chr1", 20, 20);
- *
- * === Alleles ===
- *
- * See the documentation in the Allele class itself
- *
- * What are they?
- *
- * Alleles can be either reference or non-reference
- *
- * Example alleles used here:
- *
- *   del = new Allele("-");
- *   A = new Allele("A");
- *   Aref = new Allele("A", true);
- *   T = new Allele("T");
- *   ATC = new Allele("ATC");
- *
- * === Creating variant contexts ===
- *
- * ==== By hand ====
- *
- * Here's an example of a A/T polymorphism with the A being reference:
- *
- * <pre>
- * VariantContext vc = new VariantContext(name, snpLoc, Arrays.asList(Aref, T));
- * </pre>
- *
- * If you want to create a non-variant site, just put in a single reference allele
- *
- * <pre>
- * VariantContext vc = new VariantContext(name, snpLoc, Arrays.asList(Aref));
- * </pre>
- *
- * A deletion is just as easy:
- *
- * <pre>
- * VariantContext vc = new VariantContext(name, delLoc, Arrays.asList(ATCref, del));
- * </pre>
- *
- * The only 2 things that distinguishes between a insertion and deletion are the reference allele
- * and the location of the variation.  An insertion has a Null reference allele and at least
- * one non-reference Non-Null allele.  Additionally, the location of the insertion is immediately after
- * a 1-bp GenomeLoc (at say 20).
- *
- * <pre>
- * VariantContext vc = new VariantContext("name", insLoc, Arrays.asList(delRef, ATC));
- * </pre>
- *
- * ==== Converting rods and other data structures to VCs ====
- *
- * You can convert many common types into VariantContexts using the general function:
- *
- * <pre>
- * VariantContextAdaptors.convertToVariantContext(name, myObject)
- * </pre>
- *
- * dbSNP and VCFs, for example, can be passed in as myObject and a VariantContext corresponding to that
- * object will be returned.  A null return type indicates that the type isn't yet supported.  This is the best
- * and easiest way to create contexts using RODs.
- *
- *
- * === Working with genotypes ===
- *
- * <pre>
- * List<Allele> alleles = Arrays.asList(Aref, T);
- * Genotype g1 = new Genotype(Arrays.asList(Aref, Aref), "g1", 10);
- * Genotype g2 = new Genotype(Arrays.asList(Aref, T), "g2", 10);
- * Genotype g3 = new Genotype(Arrays.asList(T, T), "g3", 10);
- * VariantContext vc = new VariantContext(snpLoc, alleles, Arrays.asList(g1, g2, g3));
- * </pre>
- *
- * At this point we have 3 genotypes in our context, g1-g3.
- *
- * You can assess a good deal of information about the genotypes through the VariantContext:
- *
- * <pre>
- * vc.hasGenotypes()
- * vc.isMonomorphic()
- * vc.isPolymorphic()
- * vc.getSamples().size()
- *
- * vc.getGenotypes()
- * vc.getGenotypes().get("g1")
- * vc.hasGenotype("g1")
- *
- * vc.getChromosomeCount()
- * vc.getChromosomeCount(Aref)
- * vc.getChromosomeCount(T)
- * </pre>
- *
- * === NO_CALL alleles ===
- *
- * The system allows one to create Genotypes carrying special NO_CALL alleles that aren't present in the
- * set of context alleles and that represent undetermined alleles in a genotype:
- *
- * Genotype g4 = new Genotype(Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), "NO_DATA_FOR_SAMPLE", 10);
- *
- *
- * === subcontexts ===
- * It's also very easy get subcontext based only the data in a subset of the genotypes:
- *
- * <pre>
- * VariantContext vc12 = vc.subContextFromGenotypes(Arrays.asList(g1,g2));
- * VariantContext vc1 = vc.subContextFromGenotypes(Arrays.asList(g1));
- * </pre>
- *
- * @author depristo
- */
-public class VariantContext implements Feature { // to enable tribble intergration
-    protected InferredGeneticContext commonInfo = null;
-    public final static double NO_NEG_LOG_10PERROR = InferredGeneticContext.NO_NEG_LOG_10PERROR;
-    public final static String UNPARSED_GENOTYPE_MAP_KEY = "_UNPARSED_GENOTYPE_MAP_";
-    public final static String UNPARSED_GENOTYPE_PARSER_KEY = "_UNPARSED_GENOTYPE_PARSER_";
-    public final static String ID_KEY = "ID";
-
-    private final Byte REFERENCE_BASE_FOR_INDEL;
-
-    public final static Set<String> PASSES_FILTERS = Collections.unmodifiableSet(new LinkedHashSet<String>());
-
-    /** The location of this VariantContext */
-    protected String contig;
-    protected long start;
-    protected long stop;
-
-    /** The type (cached for performance reasons) of this context */
-    protected Type type = null;
-
-    /** A set of the alleles segregating in this context */
-    final protected List<Allele> alleles;
-
-    /** A mapping from sampleName -> genotype objects for all genotypes associated with this context */
-    protected Map<String, Genotype> genotypes = null;
-
-    /** Counts for each of the possible Genotype types in this context */
-    protected int[] genotypeCounts = null;
-
-    public final static Map<String, Genotype> NO_GENOTYPES = Collections.unmodifiableMap(new HashMap<String, Genotype>());
-
-    // a fast cached access point to the ref / alt alleles for biallelic case
-    private Allele REF = null;
-
-    // set to the alt allele when biallelic, otherwise == null
-    private Allele ALT = null;
-
-    // were filters applied?
-    private boolean filtersWereAppliedToContext;
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // constructors
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-
-    /**
-     * the complete constructor.  Makes a complete VariantContext from its arguments
-     * This is the only constructor that is able to create indels! DO NOT USE THE OTHER ONES.
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles         alleles
-     * @param genotypes       genotypes map
-     * @param negLog10PError  qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     * @param referenceBaseForIndel   padded reference base
-     */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes, Byte referenceBaseForIndel) {
-        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, true);
-    }
-
-    /**
-     * the complete constructor.  Makes a complete VariantContext from its arguments
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles         alleles
-     * @param genotypes       genotypes map
-     * @param negLog10PError  qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Map<String, Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
-        this(source, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, true);
-    }
-
-    /**
-     * Makes a VariantContext from its arguments without parsing the genotypes.
-     * Note that this constructor assumes that if there is genotype data, then it's been put into
-     * the attributes with the UNPARSED_GENOTYPE_MAP_KEY and that the codec has been added with the
-     * UNPARSED_GENOTYPE_PARSER_KEY.  It doesn't validate that this is the case because it's possible
-     * that there is no genotype data.
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles         alleles
-     * @param negLog10PError  qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     * @param referenceBaseForIndel   padded reference base
-     */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, ?> attributes, Byte referenceBaseForIndel) {
-        this(source, contig, start, stop, alleles, NO_GENOTYPES, negLog10PError, filters, attributes, referenceBaseForIndel, true, true);
-    }
-
-    /**
-     * Create a new VariantContext
-     *
-     * @param source         source
-     * @param contig         the contig
-     * @param start          the start base (one based)
-     * @param stop           the stop reference base (one based)
-     * @param alleles        alleles
-     * @param genotypes      genotypes set
-     * @param negLog10PError qual
-     * @param filters        filters: use null for unfiltered and empty set for passes filters
-     * @param attributes     attributes
-     */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
-        this(source, contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes, null, false, true);
-    }
-
-    /**
-     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles alleles
-     */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
-        this(source, contig, start, stop, alleles, NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null, null, false, true);
-    }
-
-    /**
-     * Create a new variant context with genotypes but without Perror, filters, and attributes
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles   alleles
-     * @param genotypes genotypes
-     */
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        this(source, contig, start, stop, alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    /**
-     * Copy constructor
-     *
-     * @param other the VariantContext to copy
-     */
-    public VariantContext(VariantContext other) {
-        this(other.getSource(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, true);
-    }
-
-    /**
-     * the actual constructor.  Private access only
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles         alleles
-     * @param genotypes       genotypes map
-     * @param negLog10PError  qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     * @param referenceBaseForIndel   padded reference base
-     * @param genotypesAreUnparsed    true if the genotypes have not yet been parsed
-     * @param performValidation       if true, call validate() as the final step in construction
-     */
-    private VariantContext(String source, String contig, long start, long stop,
-                           Collection<Allele> alleles, Map<String, Genotype> genotypes,
-                           double negLog10PError, Set<String> filters, Map<String, ?> attributes,
-                           Byte referenceBaseForIndel, boolean genotypesAreUnparsed,
-                           boolean performValidation ) {
-        if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
-        this.contig = contig;
-        this.start = start;
-        this.stop = stop;
-
-        if ( !genotypesAreUnparsed && attributes != null ) {
-            if ( attributes.containsKey(UNPARSED_GENOTYPE_MAP_KEY) )
-                attributes.remove(UNPARSED_GENOTYPE_MAP_KEY);
-            if ( attributes.containsKey(UNPARSED_GENOTYPE_PARSER_KEY) )
-                attributes.remove(UNPARSED_GENOTYPE_PARSER_KEY);
-        }
-
-        this.commonInfo = new InferredGeneticContext(source, negLog10PError, filters, attributes);
-        filtersWereAppliedToContext = filters != null;
-        REFERENCE_BASE_FOR_INDEL = referenceBaseForIndel;
-
-        if ( alleles == null ) { throw new IllegalArgumentException("Alleles cannot be null"); }
-
-        // we need to make this a LinkedHashSet in case the user prefers a given ordering of alleles
-        this.alleles = makeAlleles(alleles);
-
-
-        if ( genotypes == null ) { genotypes = NO_GENOTYPES; }
-        this.genotypes = Collections.unmodifiableMap(genotypes);
-
-        // cache the REF and ALT alleles
-        int nAlleles = alleles.size();
-        for ( Allele a : alleles ) {
-            if ( a.isReference() ) {
-                REF = a;
-            } else if ( nAlleles == 2 ) { // only cache ALT when biallelic
-                ALT = a;
-            }
-        }
-
-        if ( performValidation ) {
-            validate();
-        }
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Partial-cloning routines (because Variant Context is immutable).
-    //
-    //    IMPORTANT: These routines assume that the VariantContext on which they're called is already valid.
-    //               Due to this assumption, they explicitly tell the constructor NOT to perform validation by
-    //               calling validate(), and instead perform validation only on the data that's changed.
-    //
-    //    Note that we don't call vc.getGenotypes() because that triggers the lazy loading.
-    //    Also note that we need to create a new attributes map because it's unmodifiable and the constructor may try to modify it.
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public static VariantContext modifyGenotypes(VariantContext vc, Map<String, Genotype> genotypes) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), false, false);
-        modifiedVC.validateGenotypes();
-        return modifiedVC;
-    }
-
-    public static VariantContext modifyLocation(VariantContext vc, String chr, int start, int end) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), chr, start, end, vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
-
-        // Since start and end have changed, we need to call both validateAlleles() and validateReferencePadding(),
-        // since those validation routines rely on the values of start and end:
-        modifiedVC.validateAlleles();
-        modifiedVC.validateReferencePadding();
-
-        return modifiedVC;
-    }
-
-    public static VariantContext modifyFilters(VariantContext vc, Set<String> filters) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), filters, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
-    }
-
-    public static VariantContext modifyAttributes(VariantContext vc, Map<String, Object> attributes) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
-    }
-
-    public static VariantContext modifyReferencePadding(VariantContext vc, Byte b) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), b, true, false);
-        modifiedVC.validateReferencePadding();
-        return modifiedVC;
-    }
-
-    public static VariantContext modifyPErrorFiltersAndAttributes(VariantContext vc, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, negLog10PError, filters, attributes, vc.getReferenceBaseForIndel(), true, false);
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Selectors
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    /**
-     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotype
-     * genotype and alleles in genotype.  This is the right way to test if a single genotype is actually
-     * variant or not.
-     *
-     * @param genotype genotype
-     * @return vc subcontext
-     */
-    public VariantContext subContextFromGenotypes(Genotype genotype) {
-        return subContextFromGenotypes(Arrays.asList(genotype));
-    }
-
-
-    /**
-     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
-     * genotypes and alleles in these genotypes.  This is the right way to test if a single genotype is actually
-     * variant or not.
-     *
-     * @param genotypes genotypes
-     * @return vc subcontext
-     */
-    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes) {
-        return subContextFromGenotypes(genotypes, allelesOfGenotypes(genotypes)) ;
-    }
-
-    /**
-     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
-     * genotypes.  Also, the resulting variant context will contain the alleles provided, not only those found in genotypes
-     *
-     * @param genotypes genotypes
-     * @param alleles the set of allele segregating alleles at this site.  Must include those in genotypes, but may be more
-     * @return vc subcontext
-     */
-    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes, Collection<Allele> alleles) {
-        return new VariantContext(getSource(), contig, start, stop, alleles, genotypes != null ? genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, getNegLog10PError(), filtersWereApplied() ? getFilters() : null, getAttributes(), getReferenceBaseForIndel());
-    }
-
-
-    /**
-     * helper routine for subcontext
-     * @param genotypes genotypes
-     * @return allele set
-     */
-    private Set<Allele> allelesOfGenotypes(Collection<Genotype> genotypes) {
-        Set<Allele> alleles = new HashSet<Allele>();
-
-        boolean addedref = false;
-        for ( Genotype g : genotypes ) {
-            for ( Allele a : g.getAlleles() ) {
-                addedref = addedref || a.isReference();
-                if ( a.isCalled() )
-                    alleles.add(a);
-            }
-        }
-        if ( ! addedref ) alleles.add(getReference());
-
-        return alleles;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // type operations
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    /**
-     * see: http://www.ncbi.nlm.nih.gov/bookshelf/br.fcgi?book=handbook&part=ch5&rendertype=table&id=ch5.ch5_t3
-     *
-     * Format:
-     * dbSNP variation class
-     * Rules for assigning allele classes
-     * Sample allele definition
-     *
-     * Single Nucleotide Polymorphisms (SNPs)a
-     *   Strictly defined as single base substitutions involving A, T, C, or G.
-     *   A/T
-     *
-     * Deletion/Insertion Polymorphisms (DIPs)
-     *   Designated using the full sequence of the insertion as one allele, and either a fully
-     *   defined string for the variant allele or a '-' character to specify the deleted allele.
-     *   This class will be assigned to a variation if the variation alleles are of different lengths or
-     *   if one of the alleles is deleted ('-').
-     *   T/-/CCTA/G
-     *
-     * No-variation
-     *   Reports may be submitted for segments of sequence that are assayed and determined to be invariant
-     *   in the sample.
-     *   (NoVariation)
-     *
-     * Mixed
-     *   Mix of other classes
-     *
-     * Also supports NO_VARIATION type, used to indicate that the site isn't polymorphic in the population
-     *
-     *
-     * Not currently supported:
-     *
-     * Heterozygous sequencea
-     * The term heterozygous is used to specify a region detected by certain methods that do not
-     * resolve the polymorphism into a specific sequence motif. In these cases, a unique flanking
-     * sequence must be provided to define a sequence context for the variation.
-     * (heterozygous)
-     *
-     * Microsatellite or short tandem repeat (STR)
-     * Alleles are designated by providing the repeat motif and the copy number for each allele.
-     * Expansion of the allele repeat motif designated in dbSNP into full-length sequence will
-     * be only an approximation of the true genomic sequence because many microsatellite markers are
-     * not fully sequenced and are resolved as size variants only.
-     * (CAC)8/9/10/11
-     *
-     * Named variant
-     * Applies to insertion/deletion polymorphisms of longer sequence features, such as retroposon
-     * dimorphism for Alu or line elements. These variations frequently include a deletion '-' indicator
-     * for the absent allele.
-     * (alu) / -
-     *
-     * Multi-Nucleotide Polymorphism (MNP)
-     *   Assigned to variations that are multi-base variations of a single, common length
-     *   GGA/AGT
-     */
-    public enum Type {
-        NO_VARIATION,
-        SNP,
-        MNP,    // a multi-nucleotide polymorphism
-        INDEL,
-        SYMBOLIC,
-        MIXED,
-    }
-
-    /**
-     * Determines (if necessary) and returns the type of this variation by examining the alleles it contains.
-     *
-     * @return the type of this VariantContext
-     **/
-    public Type getType() {
-        if ( type == null )
-            determineType();
-
-        return type;
-    }
-
-    /**
-     * convenience method for SNPs
-     *
-     * @return true if this is a SNP, false otherwise
-     */
-    public boolean isSNP() { return getType() == Type.SNP; }
-
-
-    /**
-     * convenience method for variants
-     *
-     * @return true if this is a variant allele, false if it's reference
-     */
-    public boolean isVariant() { return getType() != Type.NO_VARIATION; }
-
-    /**
-     * convenience method for point events
-     *
-     * @return true if this is a SNP or ref site, false if it's an indel or mixed event
-     */
-    public boolean isPointEvent() { return isSNP() || !isVariant(); }
-
-    /**
-     * convenience method for indels
-     *
-     * @return true if this is an indel, false otherwise
-     */
-    public boolean isIndel() { return getType() == Type.INDEL; }
-
-    /**
-     * @return true if the alleles indicate a simple insertion (i.e., the reference allele is Null)
-     */
-    public boolean isSimpleInsertion() {
-        // can't just call !isSimpleDeletion() because of complex indels
-        return getType() == Type.INDEL && getReference().isNull() && isBiallelic();
-    }
-
-    /**
-     * @return true if the alleles indicate a simple deletion (i.e., a single alt allele that is Null)
-     */
-    public boolean isSimpleDeletion() {
-        // can't just call !isSimpleInsertion() because of complex indels
-        return getType() == Type.INDEL && getAlternateAllele(0).isNull() && isBiallelic();
-    }
-
-    /**
-     * @return true if the alleles indicate neither a simple deletion nor a simple insertion
-     */
-    public boolean isComplexIndel() {
-        return isIndel() && !isSimpleDeletion() && !isSimpleInsertion();
-    }
-
-    public boolean isSymbolic() {
-        return getType() == Type.SYMBOLIC;
-    }
-
-    public boolean isMNP() {
-        return getType() == Type.MNP;
-    }
-
-    /**
-     * convenience method for indels
-     *
-     * @return true if this is an mixed variation, false otherwise
-     */
-    public boolean isMixed() { return getType() == Type.MIXED; }
-
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Generic accessors
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public boolean hasID() {
-        return commonInfo.hasAttribute(ID_KEY);
-    }
-
-    public String getID() {
-        return (String)commonInfo.getAttribute(ID_KEY);
-    }
-
-    public boolean hasReferenceBaseForIndel() {
-        return REFERENCE_BASE_FOR_INDEL != null;
-    }
-
-    // the indel base that gets stripped off for indels
-    public Byte getReferenceBaseForIndel() {
-        return REFERENCE_BASE_FOR_INDEL;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // get routines to access context info fields
-    //
-    // ---------------------------------------------------------------------------------------------------------
-    public String getSource()                   { return commonInfo.getName(); }
-    public Set<String> getFilters()             { return commonInfo.getFilters(); }
-    public boolean isFiltered()                 { return commonInfo.isFiltered(); }
-    public boolean isNotFiltered()              { return commonInfo.isNotFiltered(); }
-    public boolean filtersWereApplied()         { return filtersWereAppliedToContext; }
-    public boolean hasNegLog10PError()          { return commonInfo.hasNegLog10PError(); }
-    public double getNegLog10PError()           { return commonInfo.getNegLog10PError(); }
-    public double getPhredScaledQual()          { return commonInfo.getPhredScaledQual(); }
-
-    public Map<String, Object>  getAttributes() { return commonInfo.getAttributes(); }
-    public boolean hasAttribute(String key)     { return commonInfo.hasAttribute(key); }
-    public Object getAttribute(String key)      { return commonInfo.getAttribute(key); }
-
-    public Object getAttribute(String key, Object defaultValue) {
-        return commonInfo.getAttribute(key, defaultValue);
-    }
-
-    public String getAttributeAsString(String key, String defaultValue)   { return commonInfo.getAttributeAsString(key, defaultValue); }
-    public int getAttributeAsInt(String key, int defaultValue)            { return commonInfo.getAttributeAsInt(key, defaultValue); }
-    public double getAttributeAsDouble(String key, double  defaultValue)  { return commonInfo.getAttributeAsDouble(key, defaultValue); }
-    public boolean getAttributeAsBoolean(String key, boolean  defaultValue)  { return commonInfo.getAttributeAsBoolean(key, defaultValue); }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Working with alleles
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    /**
-     * @return the reference allele for this context
-     */
-    public Allele getReference() {
-        Allele ref = REF;
-        if ( ref == null )
-            throw new IllegalStateException("BUG: no reference allele found at " + this);
-        return ref;
-    }
-
-
-    /**
-     * @return true if the context is strictly bi-allelic
-     */
-    public boolean isBiallelic() {
-        return getNAlleles() == 2;
-    }
-
-    /**
-     * @return The number of segregating alleles in this context
-     */
-    public int getNAlleles() {
-        return alleles.size();
-    }
-
-    /**
-     * @return The allele sharing the same bases as this String.  A convenience method; better to use byte[]
-     */
-    public Allele getAllele(String allele) {
-        return getAllele(allele.getBytes());
-    }
-
-    /**
-     * @return The allele sharing the same bases as this byte[], or null if no such allele is present.
-     */
-    public Allele getAllele(byte[] allele) {
-        return Allele.getMatchingAllele(getAlleles(), allele);
-    }
-
-    /**
-     * @return True if this context contains Allele allele, or false otherwise
-     */
-    public boolean hasAllele(Allele allele) {
-        return hasAllele(allele, false);
-    }
-
-    public boolean hasAllele(Allele allele, boolean ignoreRefState) {
-        if ( allele == REF || allele == ALT ) // optimization for cached cases
-            return true;
-
-        for ( Allele a : getAlleles() ) {
-            if ( a.equals(allele, ignoreRefState) )
-                return true;
-        }
-
-        return false;
-    }
-
-
-    /**
-     * Gets the alleles.  This method should return all of the alleles present at the location,
-     * including the reference allele.  There are no constraints imposed on the ordering of alleles
-     * in the set. If the reference is not an allele in this context it will not be included.
-     *
-     * @return the set of alleles
-     */
-    public List<Allele> getAlleles() { return alleles; }
-
-    /**
-     * Gets the alternate alleles.  This method should return all the alleles present at the location,
-     * NOT including the reference allele.  There are no constraints imposed on the ordering of alleles
-     * in the set.
-     *
-     * @return the set of alternate alleles
-     */
-    public List<Allele> getAlternateAlleles() {
-        return alleles.subList(1, alleles.size());
-    }
-
-    /**
-     * Gets the sizes of the alternate alleles if they are insertion/deletion events, and returns a list of their sizes
-     *
-     * @return a list of indel lengths ( null if not of type indel or mixed )
-     */
-    public List<Integer> getIndelLengths() {
-        if ( getType() != Type.INDEL && getType() != Type.MIXED ) {
-            return null;
-        }
-
-        List<Integer> lengths = new ArrayList<Integer>();
-        for ( Allele a : getAlternateAlleles() ) {
-            lengths.add(a.length() - getReference().length());
-        }
-
-        return lengths;
-    }
-
-    /**
-     * @param i -- the ith allele (from 0 to n - 2 for a context with n alleles including a reference allele)
-     * @return the ith non-reference allele in this context
-     * @throws IllegalArgumentException if i is invalid
-     */
-    public Allele getAlternateAllele(int i) {
-        return alleles.get(i+1);
-    }
-
-    /**
-     * @param  other  VariantContext whose alternate alleles to compare against
-     * @return true if this VariantContext has the same alternate alleles as other,
-     *         regardless of ordering. Otherwise returns false.
-     */
-    public boolean hasSameAlternateAllelesAs ( VariantContext other ) {
-        List<Allele> thisAlternateAlleles = getAlternateAlleles();
-        List<Allele> otherAlternateAlleles = other.getAlternateAlleles();
-
-        if ( thisAlternateAlleles.size() != otherAlternateAlleles.size() ) {
-            return false;
-        }
-
-        for ( Allele allele : thisAlternateAlleles ) {
-            if ( ! otherAlternateAlleles.contains(allele) ) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Working with genotypes
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    private void loadGenotypes() {
-        if ( !hasAttribute(UNPARSED_GENOTYPE_MAP_KEY) ) {
-            if ( genotypes == null )
-                genotypes = NO_GENOTYPES;
-            return;
-        }
-
-        Object parserObj = getAttribute(UNPARSED_GENOTYPE_PARSER_KEY);
-        if ( parserObj == null || !(parserObj instanceof VCFParser) )
-            throw new IllegalStateException("There is no VCF parser stored to unparse the genotype data");
-        VCFParser parser = (VCFParser)parserObj;
-
-        Object mapObj = getAttribute(UNPARSED_GENOTYPE_MAP_KEY);
-        if ( mapObj == null )
-            throw new IllegalStateException("There is no mapping string stored to unparse the genotype data");
-
-        genotypes = parser.createGenotypeMap(mapObj.toString(), new ArrayList<Allele>(alleles), getChr(), getStart());
-
-        commonInfo.removeAttribute(UNPARSED_GENOTYPE_MAP_KEY);
-        commonInfo.removeAttribute(UNPARSED_GENOTYPE_PARSER_KEY);
-
-        validateGenotypes();
-    }
-
-    /**
-     * @return the number of samples in the context
-     */
-    public int getNSamples() {
-        loadGenotypes();
-        return genotypes.size();
-    }
-
-    /**
-     * @return true if the context has associated genotypes
-     */
-    public boolean hasGenotypes() {
-        loadGenotypes();
-        return genotypes.size() > 0;
-    }
-
-    public boolean hasGenotypes(Collection<String> sampleNames) {
-        loadGenotypes();
-        for ( String name : sampleNames ) {
-            if ( ! genotypes.containsKey(name) )
-                return false;
-        }
-        return true;
-    }
-
-    /**
-     * @return set of all Genotypes associated with this context
-     */
-    public Map<String, Genotype> getGenotypes() {
-        loadGenotypes();
-        return genotypes;
-    }
-
-    public List<Genotype> getGenotypesSortedByName() {
-        loadGenotypes();
-        Collection<Genotype> types = new TreeMap<String,Genotype>(genotypes).values();
-        return new ArrayList<Genotype>(types);
-    }
-
-    /**
-     * Returns a map from sampleName -> Genotype for the genotype associated with sampleName.  Returns a map
-     * for consistency with the multi-get function.
-     *
-     * @param sampleName
-     * @return
-     * @throws IllegalArgumentException if sampleName isn't bound to a genotype
-     */
-    public Map<String, Genotype> getGenotypes(String sampleName) {
-        return getGenotypes(Arrays.asList(sampleName));
-    }
-
-    /**
-     * Returns a map from sampleName -> Genotype for each sampleName in sampleNames.  Returns a map
-     * for consistency with the multi-get function.
-     *
-     * @param sampleNames a unique list of sample names
-     * @return
-     * @throws IllegalArgumentException if sampleName isn't bound to a genotype
-     */
-    public Map<String, Genotype> getGenotypes(Collection<String> sampleNames) {
-        HashMap<String, Genotype> map = new HashMap<String, Genotype>();
-
-        for ( String name : sampleNames ) {
-            if ( map.containsKey(name) ) throw new IllegalArgumentException("Duplicate names detected in requested samples " + sampleNames);
-            final Genotype g = getGenotype(name);
-            if ( g != null ) {
-                map.put(name, g);
-            }
-        }
-
-        return map;
-    }
-
-    /**
-     * @return the set of all sample names in this context
-     */
-    public Set<String> getSampleNames() {
-        return getGenotypes().keySet();
-    }
-
-    /**
-     * @param sample  the sample name
-     *
-     * @return the Genotype associated with the given sample in this context or null if the sample is not in this context
-     */
-    public Genotype getGenotype(String sample) {
-        return getGenotypes().get(sample);
-    }
-
-    public boolean hasGenotype(String sample) {
-        return getGenotypes().containsKey(sample);
-    }
-
-    public Genotype getGenotype(int ith) {
-        return getGenotypesSortedByName().get(ith);
-    }
-
-
-    /**
-     * Returns the number of chromosomes carrying any allele in the genotypes (i.e., excluding NO_CALLS
-     *
-     * @return chromosome count
-     */
-    public int getChromosomeCount() {
-        int n = 0;
-
-        for ( Genotype g : getGenotypes().values() ) {
-            n += g.isNoCall() ? 0 : g.getPloidy();
-        }
-
-        return n;
-    }
-
-    /**
-     * Returns the number of chromosomes carrying allele A in the genotypes
-     *
-     * @param a allele
-     * @return chromosome count
-     */
-    public int getChromosomeCount(Allele a) {
-        int n = 0;
-
-        for ( Genotype g : getGenotypes().values() ) {
-            n += g.getAlleles(a).size();
-        }
-
-        return n;
-    }
-
-    /**
-     * Genotype-specific functions -- are the genotypes monomorphic w.r.t. to the alleles segregating at this
-     * site?  That is, is the number of alternate alleles among all fo the genotype == 0?
-     *
-     * @return true if it's monomorphic
-     */
-    public boolean isMonomorphic() {
-        return ! isVariant() || (hasGenotypes() && getHomRefCount() + getNoCallCount() == getNSamples());
-    }
-
-    /**
-     * Genotype-specific functions -- are the genotypes polymorphic w.r.t. to the alleles segregating at this
-     * site?  That is, is the number of alternate alleles among all fo the genotype > 0?
-     *
-     * @return true if it's polymorphic
-     */
-    public boolean isPolymorphic() {
-        return ! isMonomorphic();
-    }
-
-    private void calculateGenotypeCounts() {
-        if ( genotypeCounts == null ) {
-            genotypeCounts = new int[Genotype.Type.values().length];
-
-            for ( Genotype g : getGenotypes().values() ) {
-                if ( g.isNoCall() )
-                    genotypeCounts[Genotype.Type.NO_CALL.ordinal()]++;
-                else if ( g.isHomRef() )
-                    genotypeCounts[Genotype.Type.HOM_REF.ordinal()]++;
-                else if ( g.isHet() )
-                    genotypeCounts[Genotype.Type.HET.ordinal()]++;
-                else if ( g.isHomVar() )
-                    genotypeCounts[Genotype.Type.HOM_VAR.ordinal()]++;
-                else
-                    genotypeCounts[Genotype.Type.MIXED.ordinal()]++;
-            }
-        }
-    }
-
-    /**
-     * Genotype-specific functions -- how many no-calls are there in the genotypes?
-     *
-     * @return number of no calls
-     */
-    public int getNoCallCount() {
-        calculateGenotypeCounts();
-        return genotypeCounts[Genotype.Type.NO_CALL.ordinal()];
-    }
-
-    /**
-     * Genotype-specific functions -- how many hom ref calls are there in the genotypes?
-     *
-     * @return number of hom ref calls
-     */
-    public int getHomRefCount() {
-        calculateGenotypeCounts();
-        return genotypeCounts[Genotype.Type.HOM_REF.ordinal()];
-    }
-
-    /**
-     * Genotype-specific functions -- how many het calls are there in the genotypes?
-     *
-     * @return number of het calls
-     */
-    public int getHetCount() {
-        calculateGenotypeCounts();
-        return genotypeCounts[Genotype.Type.HET.ordinal()];
-    }
-
-    /**
-     * Genotype-specific functions -- how many hom var calls are there in the genotypes?
-     *
-     * @return number of hom var calls
-     */
-    public int getHomVarCount() {
-        return genotypeCounts[Genotype.Type.HOM_VAR.ordinal()];
-    }
-
-    /**
-     * Genotype-specific functions -- how many mixed calls are there in the genotypes?
-     *
-     * @return number of mixed calls
-     */
-    public int getMixedCount() {
-        return genotypeCounts[Genotype.Type.MIXED.ordinal()];
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // validation: extra-strict validation routines for paranoid users
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    /**
-     * Run all extra-strict validation tests on a Variant Context object
-     *
-     * @param reference        the true reference allele
-     * @param paddedRefBase    the reference base used for padding indels
-     * @param rsIDs            the true dbSNP IDs
-     */
-    public void extraStrictValidation(Allele reference, Byte paddedRefBase, Set<String> rsIDs) {
-        // validate the reference
-        validateReferenceBases(reference, paddedRefBase);
-
-        // validate the RS IDs
-        validateRSIDs(rsIDs);
-
-        // validate the altenate alleles
-        validateAlternateAlleles();
-
-        // validate the AN and AC fields
-        validateChromosomeCounts();
-
-        // TODO: implement me
-        //checkReferenceTrack();
-    }
-
-    public void validateReferenceBases(Allele reference, Byte paddedRefBase) {
-        // don't validate if we're a complex event
-        if ( !isComplexIndel() && !reference.isNull() && !reference.basesMatch(getReference()) ) {
-            throw new TribbleException.InternalCodecException(String.format("the REF allele is incorrect for the record at position %s:%d, fasta says %s vs. VCF says %s", getChr(), getStart(), reference.getBaseString(), getReference().getBaseString()));
-        }
-
-        // we also need to validate the padding base for simple indels
-        if ( hasReferenceBaseForIndel() && !getReferenceBaseForIndel().equals(paddedRefBase) ) {
-            throw new TribbleException.InternalCodecException(String.format("the padded REF base is incorrect for the record at position %s:%d, fasta says %s vs. VCF says %s", getChr(), getStart(), (char)paddedRefBase.byteValue(), (char)getReferenceBaseForIndel().byteValue()));
-        }
-    }
-
-    public void validateRSIDs(Set<String> rsIDs) {
-        if ( rsIDs != null && hasAttribute(VariantContext.ID_KEY) ) {
-            for ( String id : getID().split(VCFConstants.ID_FIELD_SEPARATOR) ) {
-                if ( id.startsWith("rs") && !rsIDs.contains(id) )
-                    throw new TribbleException.InternalCodecException(String.format("the rsID %s for the record at position %s:%d is not in dbSNP", id, getChr(), getStart()));
-            }
-        }
-    }
-
-    public void validateAlternateAlleles() {
-        if ( !hasGenotypes() )
-            return;
-
-        List<Allele> reportedAlleles = getAlleles();
-        Set<Allele> observedAlleles = new HashSet<Allele>();
-        observedAlleles.add(getReference());
-        for ( Genotype g : getGenotypes().values() ) {
-            if ( g.isCalled() )
-                observedAlleles.addAll(g.getAlleles());
-        }
-
-        if ( reportedAlleles.size() != observedAlleles.size() )
-            throw new TribbleException.InternalCodecException(String.format("the ALT allele(s) for the record at position %s:%d do not match what is observed in the per-sample genotypes", getChr(), getStart()));
-
-        int originalSize = reportedAlleles.size();
-        // take the intersection and see if things change
-        observedAlleles.retainAll(reportedAlleles);
-        if ( observedAlleles.size() != originalSize )
-            throw new TribbleException.InternalCodecException(String.format("the ALT allele(s) for the record at position %s:%d do not match what is observed in the per-sample genotypes", getChr(), getStart()));
-    }
-
-    public void validateChromosomeCounts() {
-        Map<String, Object> observedAttrs = calculateChromosomeCounts();
-
-        // AN
-        if ( hasAttribute(VCFConstants.ALLELE_NUMBER_KEY) ) {
-            int reportedAN = Integer.valueOf(getAttribute(VCFConstants.ALLELE_NUMBER_KEY).toString());
-            int observedAN = (Integer)observedAttrs.get(VCFConstants.ALLELE_NUMBER_KEY);
-            if ( reportedAN != observedAN )
-                throw new TribbleException.InternalCodecException(String.format("the Allele Number (AN) tag is incorrect for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedAN, observedAN));
-        }
-
-        // AC
-        if ( hasAttribute(VCFConstants.ALLELE_COUNT_KEY) ) {
-            List<Integer> observedACs = (List<Integer>)observedAttrs.get(VCFConstants.ALLELE_COUNT_KEY);
-            if ( getAttribute(VCFConstants.ALLELE_COUNT_KEY) instanceof List ) {
-                Collections.sort(observedACs);
-                List reportedACs = (List)getAttribute(VCFConstants.ALLELE_COUNT_KEY);
-                Collections.sort(reportedACs);
-                if ( observedACs.size() != reportedACs.size() )
-                    throw new TribbleException.InternalCodecException(String.format("the Allele Count (AC) tag doesn't have the correct number of values for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedACs.size(), observedACs.size()));
-                for (int i = 0; i < observedACs.size(); i++) {
-                    if ( Integer.valueOf(reportedACs.get(i).toString()) != observedACs.get(i) )
-                        throw new TribbleException.InternalCodecException(String.format("the Allele Count (AC) tag is incorrect for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedACs.get(i), observedACs.get(i)));
-                }
-            } else {
-                if ( observedACs.size() != 1 )
-                    throw new TribbleException.InternalCodecException(String.format("the Allele Count (AC) tag doesn't have enough values for the record at position %s:%d", getChr(), getStart()));
-                int reportedAC = Integer.valueOf(getAttribute(VCFConstants.ALLELE_COUNT_KEY).toString());
-                if ( reportedAC != observedACs.get(0) )
-                    throw new TribbleException.InternalCodecException(String.format("the Allele Count (AC) tag is incorrect for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedAC, observedACs.get(0)));
-            }
-        }
-    }
-
-    private Map<String, Object> calculateChromosomeCounts() {
-        Map<String, Object> attributes = new HashMap<String, Object>();
-
-        attributes.put(VCFConstants.ALLELE_NUMBER_KEY, getChromosomeCount());
-        ArrayList<Double> alleleFreqs = new ArrayList<Double>();
-        ArrayList<Integer> alleleCounts = new ArrayList<Integer>();
-
-        // if there are alternate alleles, record the relevant tags
-        if ( getAlternateAlleles().size() > 0 ) {
-            for ( Allele allele : getAlternateAlleles() ) {
-                alleleCounts.add(getChromosomeCount(allele));
-                alleleFreqs.add((double)getChromosomeCount(allele) / (double)getChromosomeCount());
-            }
-        }
-        // otherwise, set them to 0
-        else {
-            alleleCounts.add(0);
-            alleleFreqs.add(0.0);
-        }
-
-        attributes.put(VCFConstants.ALLELE_COUNT_KEY, alleleCounts);
-        attributes.put(VCFConstants.ALLELE_FREQUENCY_KEY, alleleFreqs);
-        return attributes;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // validation: the normal validation routines are called automatically upon creation of the VC
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    /**
-     * To be called by any modifying routines
-     */
-    private boolean validate() {
-        return validate(true);
-    }
-
-    private boolean validate(boolean throwException) {
-        try {
-            validateReferencePadding();
-            validateAlleles();
-            validateGenotypes();
-        } catch ( IllegalArgumentException e ) {
-            if ( throwException )
-                throw e;
-            else
-                return false;
-        }
-
-        return true;
-    }
-
-    private void validateReferencePadding() {
-        if (hasSymbolicAlleles()) // symbolic alleles don't need padding...
-            return;
-
-        boolean needsPadding = (getReference().length() == getEnd() - getStart()); // off by one because padded base was removed
-
-        if ( needsPadding && !hasReferenceBaseForIndel() )
-            throw new ReviewedStingException("Badly formed variant context at location " + getChr() + ":" + getStart() + "; no padded reference base was provided.");
-    }
-
-    private void validateAlleles() {
-        // check alleles
-        boolean alreadySeenRef = false, alreadySeenNull = false;
-        for ( Allele allele : alleles ) {
-            // make sure there's only one reference allele
-            if ( allele.isReference() ) {
-                if ( alreadySeenRef ) throw new IllegalArgumentException("BUG: Received two reference tagged alleles in VariantContext " + alleles + " this=" + this);
-                alreadySeenRef = true;
-            }
-
-            if ( allele.isNoCall() ) {
-                throw new IllegalArgumentException("BUG: Cannot add a no call allele to a variant context " + alleles + " this=" + this);
-            }
-
-            // make sure there's only one null allele
-            if ( allele.isNull() ) {
-                if ( alreadySeenNull ) throw new IllegalArgumentException("BUG: Received two null alleles in VariantContext " + alleles + " this=" + this);
-                alreadySeenNull = true;
-            }
-        }
-
-        // make sure there's one reference allele
-        if ( ! alreadySeenRef )
-            throw new IllegalArgumentException("No reference allele found in VariantContext");
-
-//        if ( getType() == Type.INDEL ) {
-//            if ( getReference().length() != (getLocation().size()-1) ) {
-        long length = (stop - start) + 1;
-        if ( (getReference().isNull() && length != 1 ) ||
-                (getReference().isNonNull() && (length - getReference().length()  > 1))) {
-            throw new IllegalStateException("BUG: GenomeLoc " + contig + ":" + start + "-" + stop + " has a size == " + length + " but the variation reference allele has length " + getReference().length() + " this = " + this);
-        }
-    }
-
-    private void validateGenotypes() {
-        if ( this.genotypes == null ) throw new IllegalStateException("Genotypes is null");
-
-        for ( Map.Entry<String, Genotype> elt : this.genotypes.entrySet() ) {
-            String name = elt.getKey();
-            Genotype g = elt.getValue();
-
-            if ( ! name.equals(g.getSampleName()) ) throw new IllegalStateException("Bound sample name " + name + " does not equal the name of the genotype " + g.getSampleName());
-
-            if ( g.isAvailable() ) {
-                for ( Allele gAllele : g.getAlleles() ) {
-                    if ( ! hasAllele(gAllele) && gAllele.isCalled() )
-                        throw new IllegalStateException("Allele in genotype " + gAllele + " not in the variant context " + alleles);
-                }
-            }
-        }
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // utility routines
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    private void determineType() {
-        if ( type == null ) {
-            switch ( getNAlleles() ) {
-                case 0:
-                    throw new IllegalStateException("Unexpected error: requested type of VariantContext with no alleles!" + this);
-                case 1:
-                    // note that this doesn't require a reference allele.  You can be monomorphic independent of having a
-                    // reference allele
-                    type = Type.NO_VARIATION;
-                    break;
-                default:
-                    determinePolymorphicType();
-            }
-        }
-    }
-
-    private void determinePolymorphicType() {
-        type = null;
-
-        // do a pairwise comparison of all alleles against the reference allele
-        for ( Allele allele : alleles ) {
-            if ( allele == REF )
-                continue;
-
-            // find the type of this allele relative to the reference
-            Type biallelicType = typeOfBiallelicVariant(REF, allele);
-
-            // for the first alternate allele, set the type to be that one
-            if ( type == null ) {
-                type = biallelicType;
-            }
-            // if the type of this allele is different from that of a previous one, assign it the MIXED type and quit
-            else if ( biallelicType != type ) {
-                type = Type.MIXED;
-                return;
-            }
-        }
-    }
-
-    private static Type typeOfBiallelicVariant(Allele ref, Allele allele) {
-        if ( ref.isSymbolic() )
-            throw new IllegalStateException("Unexpected error: encountered a record with a symbolic reference allele");
-
-        if ( allele.isSymbolic() )
-            return Type.SYMBOLIC;
-
-        if ( ref.length() == allele.length() ) {
-            if ( allele.length() == 1 )
-                return Type.SNP;
-            else
-                return Type.MNP;
-        }
-
-        // Important note: previously we were checking that one allele is the prefix of the other.  However, that's not an
-        // appropriate check as can be seen from the following example:
-        // REF = CTTA and ALT = C,CT,CA
-        // This should be assigned the INDEL type but was being marked as a MIXED type because of the prefix check.
-        // In truth, it should be absolutely impossible to return a MIXED type from this method because it simply
-        // performs a pairwise comparison of a single alternate allele against the reference allele (whereas the MIXED type
-        // is reserved for cases of multiple alternate alleles of different types).  Therefore, if we've reached this point
-        // in the code (so we're not a SNP, MNP, or symbolic allele), we absolutely must be an INDEL.
-        return Type.INDEL;
-
-        // old incorrect logic:
-        // if (oneIsPrefixOfOther(ref, allele))
-        //     return Type.INDEL;
-        // else
-        //     return Type.MIXED;
-    }
-
-    public String toString() {
-        return String.format("[VC %s @ %s of type=%s alleles=%s attr=%s GT=%s",
-                getSource(), contig + ":" + (start - stop == 0 ? start : start + "-" + stop), this.getType(),
-                ParsingUtils.sortList(this.getAlleles()), ParsingUtils.sortedString(this.getAttributes()), this.getGenotypesSortedByName());
-    }
-
-    // protected basic manipulation routines
-    private static List<Allele> makeAlleles(Collection<Allele> alleles) {
-        final List<Allele> alleleList = new ArrayList<Allele>(alleles.size());
-
-        boolean sawRef = false;
-        for ( final Allele a : alleles ) {
-            for ( final Allele b : alleleList ) {
-                if ( a.equals(b, true) )
-                    throw new IllegalArgumentException("Duplicate allele added to VariantContext: " + a);
-            }
-
-            // deal with the case where the first allele isn't the reference
-            if ( a.isReference() ) {
-                if ( sawRef )
-                    throw new IllegalArgumentException("Alleles for a VariantContext must contain at most one reference allele: " + alleles);
-                alleleList.add(0, a);
-                sawRef = true;
-            }
-            else
-                alleleList.add(a);
-        }
-
-        if ( alleleList.isEmpty() )
-            throw new IllegalArgumentException("Cannot create a VariantContext with an empty allele list");
-
-        if ( alleleList.get(0).isNonReference() )
-            throw new IllegalArgumentException("Alleles for a VariantContext must contain at least one reference allele: " + alleles);
-
-        return alleleList;
-    }
-
-    public static Map<String, Genotype> genotypeCollectionToMap(Map<String, Genotype> dest, Collection<Genotype> genotypes) {
-        for ( Genotype g : genotypes ) {
-            if ( dest.containsKey(g.getSampleName() ) )
-                throw new IllegalArgumentException("Duplicate genotype added to VariantContext: " + g);
-            dest.put(g.getSampleName(), g);
-        }
-
-        return dest;
-    }
-
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // tribble integration routines -- not for public consumption
-    //
-    // ---------------------------------------------------------------------------------------------------------
-    public String getChr() {
-        return contig;
-    }
-
-    public int getStart() {
-        return (int)start;
-    }
-
-    public int getEnd() {
-        return (int)stop;
-    }
-
-    private boolean hasSymbolicAlleles() {
-        for (Allele a: getAlleles()) {
-            if (a.isSymbolic()) {
-                return true;
-            }
-        }
-        return false;
-    }
-
-    public static VariantContext createVariantContextWithPaddedAlleles(VariantContext inputVC, boolean refBaseShouldBeAppliedToEndOfAlleles) {
-
-        // see if we need to pad common reference base from all alleles
-        boolean padVC;
-
-        // We need to pad a VC with a common base if the length of the reference allele is less than the length of the VariantContext.
-        // This happens because the position of e.g. an indel is always one before the actual event (as per VCF convention).
-        long locLength = (inputVC.getEnd() - inputVC.getStart()) + 1;
-        if (inputVC.hasSymbolicAlleles())
-            padVC = true;
-        else if (inputVC.getReference().length() == locLength)
-            padVC = false;
-        else if (inputVC.getReference().length() == locLength-1)
-            padVC = true;
-        else throw new IllegalArgumentException("Badly formed variant context at location " + String.valueOf(inputVC.getStart()) +
-                    " in contig " + inputVC.getChr() + ". Reference length must be at most one base shorter than location size");
-
-        // nothing to do if we don't need to pad bases
-        if (padVC) {
-
-            if ( !inputVC.hasReferenceBaseForIndel() )
-                throw new ReviewedStingException("Badly formed variant context at location " + inputVC.getChr() + ":" + inputVC.getStart() + "; no padded reference base is available.");
-
-            Byte refByte = inputVC.getReferenceBaseForIndel();
-
-            List<Allele> alleles = new ArrayList<Allele>();
-            Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
-
-            Map<String, Genotype> inputGenotypes = inputVC.getGenotypes();
-
-            for (Allele a : inputVC.getAlleles()) {
-                // get bases for current allele and create a new one with trimmed bases
-                if (a.isSymbolic()) {
-                    alleles.add(a);
-                } else {
-                    String newBases;
-                    if ( refBaseShouldBeAppliedToEndOfAlleles )
-                        newBases = a.getBaseString() + new String(new byte[]{refByte});
-                    else
-                        newBases = new String(new byte[]{refByte}) + a.getBaseString();
-                    alleles.add(Allele.create(newBases,a.isReference()));
-                }
-            }
-
-            // now we can recreate new genotypes with trimmed alleles
-            for (String sample : inputVC.getSampleNames()) {
-                Genotype g = inputGenotypes.get(sample);
-
-                List<Allele> inAlleles = g.getAlleles();
-                List<Allele> newGenotypeAlleles = new ArrayList<Allele>();
-                for (Allele a : inAlleles) {
-                    if (a.isCalled()) {
-                        if (a.isSymbolic()) {
-                            newGenotypeAlleles.add(a);
-                        } else {
-                            String newBases;
-                            if ( refBaseShouldBeAppliedToEndOfAlleles )
-                                newBases = a.getBaseString() + new String(new byte[]{refByte});
-                            else
-                                newBases = new String(new byte[]{refByte}) + a.getBaseString();
-                            newGenotypeAlleles.add(Allele.create(newBases,a.isReference()));
-                        }
-                    }
-                    else {
-                        // add no-call allele
-                        newGenotypeAlleles.add(Allele.NO_CALL);
-                    }
-                }
-                genotypes.put(sample, new Genotype(sample, newGenotypeAlleles, g.getNegLog10PError(),
-                        g.getFilters(),g.getAttributes(),g.isPhased()));
-
-            }
-
-            // Do not change the filter state if filters were not applied to this context
-            Set<String> inputVCFilters = inputVC.filtersWereAppliedToContext ? inputVC.getFilters() : null;
-            return new VariantContext(inputVC.getSource(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVCFilters, inputVC.getAttributes(),refByte);
-        }
-        else
-            return inputVC;
-
-    }
-
-    public ArrayList<Allele> getTwoAllelesWithHighestAlleleCounts() {
-        // first idea: get two alleles with highest AC
-        int maxAC1 = 0, maxAC2=0,maxAC1ind =0, maxAC2ind = 0;
-        int i=0;
-        int[] alleleCounts = new int[this.getAlleles().size()];
-        ArrayList<Allele> alleleArray = new ArrayList<Allele>();
-        for (Allele a:this.getAlleles()) {
-            int ac = this.getChromosomeCount(a);
-            if (ac >=maxAC1) {
-                maxAC1 = ac;
-                maxAC1ind = i;
-            }
-            alleleArray.add(a);
-            alleleCounts[i++] = ac;
-        }
-        // now get second best allele
-        for (i=0; i < alleleCounts.length; i++) {
-            if (i == maxAC1ind)
-                continue;
-            if (alleleCounts[i] >= maxAC2) {
-                maxAC2 = alleleCounts[i];
-                maxAC2ind = i;
-            }
-        }
-
-        Allele alleleA, alleleB;
-        if (alleleArray.get(maxAC1ind).isReference()) {
-            alleleA = alleleArray.get(maxAC1ind);
-            alleleB = alleleArray.get(maxAC2ind);
-        }
-        else if  (alleleArray.get(maxAC2ind).isReference()) {
-            alleleA = alleleArray.get(maxAC2ind);
-            alleleB = alleleArray.get(maxAC1ind);
-        } else {
-            alleleA = alleleArray.get(maxAC1ind);
-            alleleB = alleleArray.get(maxAC2ind);
-        }
-        ArrayList<Allele> a = new ArrayList<Allele>();
-        a.add(alleleA);
-        a.add(alleleB);
-        return a;
-    }
-    public Allele getAltAlleleWithHighestAlleleCount() {
-        // first idea: get two alleles with highest AC
-        Allele best = null;
-        int maxAC1 = 0;
-        for (Allele a:this.getAlternateAlleles()) {
-            int ac = this.getChromosomeCount(a);
-            if (ac >=maxAC1) {
-                maxAC1 = ac;
-                best = a;
-            }
-
-        }
-        return best;
-    }
-
-    public int[] getGLIndecesOfAllele(Allele inputAllele) {
-        int[] idxVector = new int[3];
-        int numAlleles =  this.getAlleles().size();
-
-        int idxDiag = numAlleles;
-        int incr = numAlleles - 1;
-        int k=1;
-        for (Allele a: getAlternateAlleles()) {
-            // multi-allelic approximation, part 1: Ideally
-            // for each alt allele compute marginal (suboptimal) posteriors -
-            // compute indices for AA,AB,BB for current allele - genotype likelihoods are a linear vector that can be thought of
-            // as a row-wise upper triangular matrix of likelihoods.
-            // So, for example, with 2 alt alleles, likelihoods have AA,AB,AC,BB,BC,CC.
-            // 3 alt alleles: AA,AB,AC,AD BB BC BD CC CD DD
-
-            int idxAA = 0;
-            int idxAB = k++;
-            // yy is always element on the diagonal.
-            // 2 alleles: BBelement 2
-            // 3 alleles: BB element  3. CC element 5
-            // 4 alleles:
-            int idxBB = idxDiag;
-
-            if (a.equals(inputAllele)) {
-                idxVector[0] = idxAA;
-                idxVector[1] = idxAB;
-                idxVector[2]  = idxBB;
-                break;
-            }
-            idxDiag += incr--;
-        }
-        return idxVector;
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContextUtils.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContextUtils.java
deleted file mode 100755
index e2cf2ecf0..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantContextUtils.java
+++ /dev/null
@@ -1,1407 +0,0 @@
-/*
- * Copyright (c) 2010.  The Broad Institute
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import com.google.java.contract.Ensures;
-import com.google.java.contract.Requires;
-import net.sf.picard.reference.ReferenceSequenceFile;
-import net.sf.samtools.util.StringUtil;
-import org.apache.commons.jexl2.Expression;
-import org.apache.commons.jexl2.JexlEngine;
-import org.apache.log4j.Logger;
-import org.broad.tribble.util.popgen.HardyWeinbergCalculation;
-import org.broadinstitute.sting.gatk.walkers.phasing.ReadBackedPhasingWalker;
-import org.broadinstitute.sting.utils.BaseUtils;
-import org.broadinstitute.sting.utils.GenomeLoc;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-import org.broadinstitute.sting.utils.Utils;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-import org.broadinstitute.sting.utils.exceptions.UserException;
-
-import java.io.Serializable;
-import java.util.*;
-
-public class VariantContextUtils {
-    private static Logger logger = Logger.getLogger(VariantContextUtils.class);
-    public final static String MERGE_INTERSECTION = "Intersection";
-    public final static String MERGE_FILTER_IN_ALL = "FilteredInAll";
-    public final static String MERGE_REF_IN_ALL = "ReferenceInAll";
-    public final static String MERGE_FILTER_PREFIX = "filterIn";
-
-    final public static JexlEngine engine = new JexlEngine();
-    static {
-        engine.setSilent(false); // will throw errors now for selects that don't evaluate properly
-        engine.setLenient(false);
-    }
-
-    /**
-     * Create a new VariantContext
-     *
-     * @param name            name
-     * @param loc             location
-     * @param alleles         alleles
-     * @param genotypes       genotypes set
-     * @param negLog10PError  qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     * @return VariantContext object
-     */
-    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, ?> attributes) {
-        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes != null ? VariantContext.genotypeCollectionToMap(new TreeMap<String, Genotype>(), genotypes) : null, negLog10PError, filters, attributes);
-    }
-
-    /**
-     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
-     * @param name            name
-     * @param loc             location
-     * @param alleles         alleles
-     * @return VariantContext object
-     */
-    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles) {
-        return new VariantContext (name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, VariantContext.NO_GENOTYPES, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    /**
-     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
-     * @param name            name
-     * @param loc             location
-     * @param alleles         alleles
-     * @param genotypes       genotypes
-     * @return VariantContext object
-     */
-    public static VariantContext toVC(String name, GenomeLoc loc, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        return new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, InferredGeneticContext.NO_NEG_LOG_10PERROR, null, null);
-    }
-
-    /**
-     * Copy constructor
-     *
-     * @param other the VariantContext to copy
-     * @return VariantContext object
-     */
-    public static VariantContext toVC(VariantContext other) {
-        return new VariantContext(other.getSource(), other.getChr(), other.getStart(), other.getEnd(), other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.getFilters(), other.getAttributes());
-    }
-
-    /**
-     * Update the attributes of the attributes map given the VariantContext to reflect the proper chromosome-based VCF tags
-     *
-     * @param vc          the VariantContext
-     * @param attributes  the attributes map to populate; must not be null; may contain old values
-     * @param removeStaleValues should we remove stale values from the mapping?
-     */
-    public static void calculateChromosomeCounts(VariantContext vc, Map<String, Object> attributes, boolean removeStaleValues) {
-        // if everyone is a no-call, remove the old attributes if requested
-        if ( vc.getChromosomeCount() == 0 && removeStaleValues ) {
-            if ( attributes.containsKey(VCFConstants.ALLELE_COUNT_KEY) )
-                attributes.remove(VCFConstants.ALLELE_COUNT_KEY);
-            if ( attributes.containsKey(VCFConstants.ALLELE_FREQUENCY_KEY) )
-                attributes.remove(VCFConstants.ALLELE_FREQUENCY_KEY);
-            if ( attributes.containsKey(VCFConstants.ALLELE_NUMBER_KEY) )
-                attributes.remove(VCFConstants.ALLELE_NUMBER_KEY);
-            return;
-        }
-
-        if ( vc.hasGenotypes() ) {
-            attributes.put(VCFConstants.ALLELE_NUMBER_KEY, vc.getChromosomeCount());
-
-            // if there are alternate alleles, record the relevant tags
-            if ( vc.getAlternateAlleles().size() > 0 ) {
-                ArrayList<String> alleleFreqs = new ArrayList<String>();
-                ArrayList<Integer> alleleCounts = new ArrayList<Integer>();
-                double totalChromosomes = (double)vc.getChromosomeCount();
-                for ( Allele allele : vc.getAlternateAlleles() ) {
-                    int altChromosomes = vc.getChromosomeCount(allele);
-                    alleleCounts.add(altChromosomes);
-                    String freq = String.format(makePrecisionFormatStringFromDenominatorValue(totalChromosomes), ((double)altChromosomes / totalChromosomes));
-                    alleleFreqs.add(freq);
-                }
-
-                attributes.put(VCFConstants.ALLELE_COUNT_KEY, alleleCounts.size() == 1 ? alleleCounts.get(0) : alleleCounts);
-                attributes.put(VCFConstants.ALLELE_FREQUENCY_KEY, alleleFreqs.size() == 1 ? alleleFreqs.get(0) : alleleFreqs);
-            }
-            else {
-                attributes.put(VCFConstants.ALLELE_COUNT_KEY, 0);
-                attributes.put(VCFConstants.ALLELE_FREQUENCY_KEY, 0.0);
-            }
-        }
-    }
-
-    private static String makePrecisionFormatStringFromDenominatorValue(double maxValue) {
-        int precision = 1;
-
-        while ( maxValue > 1 ) {
-            precision++;
-            maxValue /= 10.0;
-        }
-
-        return "%." + precision + "f";
-    }
-
-    public static Genotype removePLs(Genotype g) {
-        Map<String, Object> attrs = new HashMap<String, Object>(g.getAttributes());
-        attrs.remove(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY);
-        attrs.remove(VCFConstants.GENOTYPE_LIKELIHOODS_KEY);
-        return new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attrs, g.isPhased());
-    }
-
-    /**
-     * A simple but common wrapper for matching VariantContext objects using JEXL expressions
-     */
-    public static class JexlVCMatchExp {
-        public String name;
-        public Expression exp;
-
-        /**
-         * Create a new matcher expression with name and JEXL expression exp
-         * @param name name
-         * @param exp  expression
-         */
-        public JexlVCMatchExp(String name, Expression exp) {
-            this.name = name;
-            this.exp = exp;
-        }
-    }
-
-    /**
-     * Method for creating JexlVCMatchExp from input walker arguments names and exps.  These two arrays contain
-     * the name associated with each JEXL expression. initializeMatchExps will parse each expression and return
-     * a list of JexlVCMatchExp, in order, that correspond to the names and exps.  These are suitable input to
-     * match() below.
-     *
-     * @param names names
-     * @param exps  expressions
-     * @return list of matches
-     */
-    public static List<JexlVCMatchExp> initializeMatchExps(String[] names, String[] exps) {
-        if ( names == null || exps == null )
-            throw new ReviewedStingException("BUG: neither names nor exps can be null: names " + Arrays.toString(names) + " exps=" + Arrays.toString(exps) );
-
-        if ( names.length != exps.length )
-            throw new UserException("Inconsistent number of provided filter names and expressions: names=" + Arrays.toString(names) + " exps=" + Arrays.toString(exps));
-
-        Map<String, String> map = new HashMap<String, String>();
-        for ( int i = 0; i < names.length; i++ ) { map.put(names[i], exps[i]); }
-
-        return VariantContextUtils.initializeMatchExps(map);
-    }
-
-    public static List<JexlVCMatchExp> initializeMatchExps(ArrayList<String> names, ArrayList<String> exps) {
-        String[] nameArray = new String[names.size()];
-        String[] expArray = new String[exps.size()];
-        return initializeMatchExps(names.toArray(nameArray), exps.toArray(expArray));
-    }
-
-
-    /**
-     * Method for creating JexlVCMatchExp from input walker arguments mapping from names to exps.  These two arrays contain
-     * the name associated with each JEXL expression. initializeMatchExps will parse each expression and return
-     * a list of JexlVCMatchExp, in order, that correspond to the names and exps.  These are suitable input to
-     * match() below.
-     *
-     * @param names_and_exps mapping of names to expressions
-     * @return list of matches
-     */
-    public static List<JexlVCMatchExp> initializeMatchExps(Map<String, String> names_and_exps) {
-        List<JexlVCMatchExp> exps = new ArrayList<JexlVCMatchExp>();
-
-        for ( Map.Entry<String, String> elt : names_and_exps.entrySet() ) {
-            String name = elt.getKey();
-            String expStr = elt.getValue();
-
-            if ( name == null || expStr == null ) throw new IllegalArgumentException("Cannot create null expressions : " + name +  " " + expStr);
-            try {
-                Expression exp = engine.createExpression(expStr);
-                exps.add(new JexlVCMatchExp(name, exp));
-            } catch (Exception e) {
-                throw new UserException.BadArgumentValue(name, "Invalid expression used (" + expStr + "). Please see the JEXL docs for correct syntax.") ;
-            }
-        }
-
-        return exps;
-    }
-
-    /**
-     * Returns true if exp match VC.  See collection<> version for full docs.
-     * @param vc    variant context
-     * @param exp   expression
-     * @return true if there is a match
-     */
-    public static boolean match(VariantContext vc, JexlVCMatchExp exp) {
-        return match(vc,Arrays.asList(exp)).get(exp);
-    }
-
-    /**
-     * Matches each JexlVCMatchExp exp against the data contained in vc, and returns a map from these
-     * expressions to true (if they matched) or false (if they didn't).  This the best way to apply JEXL
-     * expressions to VariantContext records.  Use initializeMatchExps() to create the list of JexlVCMatchExp
-     * expressions.
-     *
-     * @param vc   variant context
-     * @param exps expressions
-     * @return true if there is a match
-     */
-    public static Map<JexlVCMatchExp, Boolean> match(VariantContext vc, Collection<JexlVCMatchExp> exps) {
-        return new JEXLMap(exps,vc);
-
-    }
-
-    /**
-     * Returns true if exp match VC/g.  See collection<> version for full docs.
-     * @param vc   variant context
-     * @param g    genotype
-     * @param exp   expression
-     * @return true if there is a match
-     */
-    public static boolean match(VariantContext vc, Genotype g, JexlVCMatchExp exp) {
-        return match(vc,g,Arrays.asList(exp)).get(exp);
-    }
-
-    /**
-     * Matches each JexlVCMatchExp exp against the data contained in vc/g, and returns a map from these
-     * expressions to true (if they matched) or false (if they didn't).  This the best way to apply JEXL
-     * expressions to VariantContext records/genotypes.  Use initializeMatchExps() to create the list of JexlVCMatchExp
-     * expressions.
-     *
-     * @param vc   variant context
-     * @param g    genotype
-     * @param exps expressions
-     * @return true if there is a match
-     */
-    public static Map<JexlVCMatchExp, Boolean> match(VariantContext vc, Genotype g, Collection<JexlVCMatchExp> exps) {
-        return new JEXLMap(exps,vc,g);
-    }
-
-    public static double computeHardyWeinbergPvalue(VariantContext vc) {
-        if ( vc.getChromosomeCount() == 0 )
-            return 0.0;
-        return HardyWeinbergCalculation.hwCalculate(vc.getHomRefCount(), vc.getHetCount(), vc.getHomVarCount());
-    }
-
-    /**
-     * Returns a newly allocated VC that is the same as VC, but without genotypes
-     * @param vc  variant context
-     * @return  new VC without genotypes
-     */
-    @Requires("vc != null")
-    @Ensures("result != null")
-    public static VariantContext sitesOnlyVariantContext(VariantContext vc) {
-        return VariantContext.modifyGenotypes(vc, null);
-    }
-
-    /**
-     * Returns a newly allocated list of VC, where each VC is the same as the input VCs, but without genotypes
-     * @param vcs  collection of VCs
-     * @return new VCs without genotypes
-     */
-    @Requires("vcs != null")
-    @Ensures("result != null")
-    public static Collection<VariantContext> sitesOnlyVariantContexts(Collection<VariantContext> vcs) {
-        List<VariantContext> r = new ArrayList<VariantContext>();
-        for ( VariantContext vc : vcs )
-            r.add(sitesOnlyVariantContext(vc));
-        return r;
-    }
-
-    public static VariantContext pruneVariantContext(VariantContext vc) {
-        return pruneVariantContext(vc, null);
-    }
-
-    public static VariantContext pruneVariantContext(final VariantContext vc, final Collection<String> keysToPreserve ) {
-        final MutableVariantContext mvc = new MutableVariantContext(vc);
-
-        if ( keysToPreserve == null || keysToPreserve.size() == 0 )
-            mvc.clearAttributes();
-        else {
-            final Map<String, Object> d = mvc.getAttributes();
-            mvc.clearAttributes();
-            for ( String key : keysToPreserve )
-                if ( d.containsKey(key) )
-                    mvc.putAttribute(key, d.get(key));
-        }
-
-        // this must be done as the ID is stored in the attributes field
-        if ( vc.hasID() ) mvc.setID(vc.getID());
-
-        Collection<Genotype> gs = mvc.getGenotypes().values();
-        mvc.clearGenotypes();
-        for ( Genotype g : gs ) {
-            MutableGenotype mg = new MutableGenotype(g);
-            mg.clearAttributes();
-            if ( keysToPreserve != null )
-                for ( String key : keysToPreserve )
-                    if ( g.hasAttribute(key) )
-                        mg.putAttribute(key, g.getAttribute(key));
-            mvc.addGenotype(mg);
-        }
-
-        return mvc;
-    }
-
-    public enum GenotypeMergeType {
-        /**
-         * Make all sample genotypes unique by file. Each sample shared across RODs gets named sample.ROD.
-         */
-        UNIQUIFY,
-        /**
-         * Take genotypes in priority order (see the priority argument).
-         */
-        PRIORITIZE,
-        /**
-         * Take the genotypes in any order.
-         */
-        UNSORTED,
-        /**
-         * Require that all samples/genotypes be unique between all inputs.
-         */
-        REQUIRE_UNIQUE
-    }
-
-    public enum FilteredRecordMergeType {
-        /**
-         * Union - leaves the record if any record is unfiltered.
-         */
-        KEEP_IF_ANY_UNFILTERED,
-        /**
-         * Requires all records present at site to be unfiltered. VCF files that don't contain the record don't influence this.
-         */
-        KEEP_IF_ALL_UNFILTERED
-    }
-
-    /**
-     * Performs a master merge on the VCs.  Here there is a master input [contains all of the information] and many
-     * VCs containing partial, extra genotype information which should be added to the master.  For example,
-     * we scatter out the phasing algorithm over some samples in the master, producing a minimal VCF with phasing
-     * information per genotype.  The master merge will add the PQ information from each genotype record, where
-     * appropriate, to the master VC.
-     *
-     * @param unsortedVCs   collection of VCs
-     * @param masterName    name of master VC
-     * @return  master-merged VC
-     */
-    public static VariantContext masterMerge(Collection<VariantContext> unsortedVCs, String masterName) {
-        VariantContext master = findMaster(unsortedVCs, masterName);
-        Map<String, Genotype> genotypes = master.getGenotypes();
-        for (Genotype g : genotypes.values()) {
-            genotypes.put(g.getSampleName(), new MutableGenotype(g));
-        }
-
-        Map<String, Object> masterAttributes = new HashMap<String, Object>(master.getAttributes());
-
-        for (VariantContext vc : unsortedVCs) {
-            if (!vc.getSource().equals(masterName)) {
-                for (Genotype g : vc.getGenotypes().values()) {
-                    MutableGenotype masterG = (MutableGenotype) genotypes.get(g.getSampleName());
-                    for (Map.Entry<String, Object> attr : g.getAttributes().entrySet()) {
-                        if (!masterG.hasAttribute(attr.getKey())) {
-                            //System.out.printf("Adding GT attribute %s to masterG %s, new %s%n", attr, masterG, g);
-                            masterG.putAttribute(attr.getKey(), attr.getValue());
-                        }
-                    }
-
-                    if (masterG.isPhased() != g.isPhased()) {
-                        if (masterG.sameGenotype(g)) {
-                            // System.out.printf("Updating phasing %s to masterG %s, new %s%n", g.isPhased(), masterG, g);
-                            masterG.setAlleles(g.getAlleles());
-                            masterG.setPhase(g.isPhased());
-                        }
-                        //else System.out.println("WARNING: Not updating phase, since genotypes differ between master file and auxiliary info file!");
-                    }
-
-//                    if ( MathUtils.compareDoubles(masterG.getNegLog10PError(), g.getNegLog10PError()) != 0 ) {
-//                        System.out.printf("Updating GQ %s to masterG %s, new %s%n", g.getNegLog10PError(), masterG, g);
-//                        masterG.setNegLog10PError(g.getNegLog10PError());
-//                    }
-
-                }
-
-                for (Map.Entry<String, Object> attr : vc.getAttributes().entrySet()) {
-                    if (!masterAttributes.containsKey(attr.getKey())) {
-                        //System.out.printf("Adding VC attribute %s to master %s, new %s%n", attr, master, vc);
-                        masterAttributes.put(attr.getKey(), attr.getValue());
-                    }
-                }
-            }
-        }
-
-        return new VariantContext(master.getSource(), master.getChr(), master.getStart(), master.getEnd(), master.getAlleles(), genotypes, master.getNegLog10PError(), master.getFilters(), masterAttributes);
-    }
-
-    private static VariantContext findMaster(Collection<VariantContext> unsortedVCs, String masterName) {
-        for (VariantContext vc : unsortedVCs) {
-            if (vc.getSource().equals(masterName)) {
-                return vc;
-            }
-        }
-
-        throw new ReviewedStingException(String.format("Couldn't find master VCF %s at %s", masterName, unsortedVCs.iterator().next()));
-    }
-
-    /**
-     * Merges VariantContexts into a single hybrid.  Takes genotypes for common samples in priority order, if provided.
-     * If uniqifySamples is true, the priority order is ignored and names are created by concatenating the VC name with
-     * the sample name
-     *
-     * @param genomeLocParser           loc parser
-     * @param unsortedVCs               collection of unsorted VCs
-     * @param priorityListOfVCs         priority list detailing the order in which we should grab the VCs
-     * @param filteredRecordMergeType   merge type for filtered records
-     * @param genotypeMergeOptions      merge option for genotypes
-     * @param annotateOrigin            should we annotate the set it came from?
-     * @param printMessages             should we print messages?
-     * @param setKey                    the key name of the set
-     * @param filteredAreUncalled       are filtered records uncalled?
-     * @param mergeInfoWithMaxAC        should we merge in info from the VC with maximum allele count?
-     * @return new VariantContext       representing the merge of unsortedVCs
-     */
-    public static VariantContext simpleMerge(final GenomeLocParser genomeLocParser,
-                                             final Collection<VariantContext> unsortedVCs,
-                                             final List<String> priorityListOfVCs,
-                                             final FilteredRecordMergeType filteredRecordMergeType,
-                                             final GenotypeMergeType genotypeMergeOptions,
-                                             final boolean annotateOrigin,
-                                             final boolean printMessages,
-                                             final String setKey,
-                                             final boolean filteredAreUncalled,
-                                             final boolean mergeInfoWithMaxAC ) {
-        if ( unsortedVCs == null || unsortedVCs.size() == 0 )
-            return null;
-
-        if ( annotateOrigin && priorityListOfVCs == null )
-            throw new IllegalArgumentException("Cannot merge calls and annotate their origins without a complete priority list of VariantContexts");
-
-        if ( genotypeMergeOptions == GenotypeMergeType.REQUIRE_UNIQUE )
-            verifyUniqueSampleNames(unsortedVCs);
-
-        List<VariantContext> prepaddedVCs = sortVariantContextsByPriority(unsortedVCs, priorityListOfVCs, genotypeMergeOptions);
-        // Make sure all variant contexts are padded with reference base in case of indels if necessary
-        List<VariantContext> VCs = new ArrayList<VariantContext>();
-
-        for (VariantContext vc : prepaddedVCs) {
-            // also a reasonable place to remove filtered calls, if needed
-            if ( ! filteredAreUncalled || vc.isNotFiltered() )
-                VCs.add(VariantContext.createVariantContextWithPaddedAlleles(vc, false));
-        }
-        if ( VCs.size() == 0 ) // everything is filtered out and we're filteredAreUncalled
-            return null;
-
-        // establish the baseline info from the first VC
-        final VariantContext first = VCs.get(0);
-        final String name = first.getSource();
-        final Allele refAllele = determineReferenceAllele(VCs);
-
-        final Set<Allele> alleles = new LinkedHashSet<Allele>();
-        final Set<String> filters = new TreeSet<String>();
-        final Map<String, Object> attributes = new TreeMap<String, Object>();
-        final Set<String> inconsistentAttributes = new HashSet<String>();
-        final Set<String> variantSources = new HashSet<String>(); // contains the set of sources we found in our set of VCs that are variant
-        final Set<String> rsIDs = new LinkedHashSet<String>(1); // most of the time there's one id
-
-        GenomeLoc loc = getLocation(genomeLocParser,first);
-        int depth = 0;
-        int maxAC = -1;
-        final Map<String, Object> attributesWithMaxAC = new TreeMap<String, Object>();
-        double negLog10PError = -1;
-        VariantContext vcWithMaxAC = null;
-        Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
-
-        // counting the number of filtered and variant VCs
-        int nFiltered = 0;
-
-        boolean remapped = false;
-
-        // cycle through and add info from the other VCs, making sure the loc/reference matches
-
-        for ( VariantContext vc : VCs ) {
-            if ( loc.getStart() != vc.getStart() ) // || !first.getReference().equals(vc.getReference()) )
-                throw new ReviewedStingException("BUG: attempting to merge VariantContexts with different start sites: first="+ first.toString() + " second=" + vc.toString());
-
-            if ( getLocation(genomeLocParser,vc).size() > loc.size() )
-                loc = getLocation(genomeLocParser,vc); // get the longest location
-
-            nFiltered += vc.isFiltered() ? 1 : 0;
-            if ( vc.isVariant() ) variantSources.add(vc.getSource());
-
-            AlleleMapper alleleMapping = resolveIncompatibleAlleles(refAllele, vc, alleles);
-            remapped = remapped || alleleMapping.needsRemapping();
-
-            alleles.addAll(alleleMapping.values());
-
-            mergeGenotypes(genotypes, vc, alleleMapping, genotypeMergeOptions == GenotypeMergeType.UNIQUIFY);
-
-            negLog10PError = Math.max(negLog10PError, vc.isVariant() ? vc.getNegLog10PError() : -1);
-
-            filters.addAll(vc.getFilters());
-
-            //
-            // add attributes
-            //
-            // special case DP (add it up) and ID (just preserve it)
-            //
-            if (vc.hasAttribute(VCFConstants.DEPTH_KEY))
-                depth += vc.getAttributeAsInt(VCFConstants.DEPTH_KEY, 0);
-            if ( vc.hasID() && ! vc.getID().equals(VCFConstants.EMPTY_ID_FIELD) ) rsIDs.add(vc.getID());
-            if (mergeInfoWithMaxAC && vc.hasAttribute(VCFConstants.ALLELE_COUNT_KEY)) {
-                String rawAlleleCounts = vc.getAttributeAsString(VCFConstants.ALLELE_COUNT_KEY, null);
-                // lets see if the string contains a , separator
-                if (rawAlleleCounts.contains(VCFConstants.INFO_FIELD_ARRAY_SEPARATOR)) {
-                    List<String> alleleCountArray = Arrays.asList(rawAlleleCounts.substring(1, rawAlleleCounts.length() - 1).split(VCFConstants.INFO_FIELD_ARRAY_SEPARATOR));
-                    for (String alleleCount : alleleCountArray) {
-                        final int ac = Integer.valueOf(alleleCount.trim());
-                        if (ac > maxAC) {
-                            maxAC = ac;
-                            vcWithMaxAC = vc;
-                        }
-                    }
-                } else {
-                    final int ac = Integer.valueOf(rawAlleleCounts);
-                    if (ac > maxAC) {
-                        maxAC = ac;
-                        vcWithMaxAC = vc;
-                    }
-                }
-            }
-
-            for (Map.Entry<String, Object> p : vc.getAttributes().entrySet()) {
-                String key = p.getKey();
-                // if we don't like the key already, don't go anywhere
-                if ( ! inconsistentAttributes.contains(key) ) {
-                    boolean alreadyFound = attributes.containsKey(key);
-                    Object boundValue = attributes.get(key);
-                    boolean boundIsMissingValue = alreadyFound && boundValue.equals(VCFConstants.MISSING_VALUE_v4);
-
-                    if ( alreadyFound && ! boundValue.equals(p.getValue()) && ! boundIsMissingValue ) {
-                        // we found the value but we're inconsistent, put it in the exclude list
-                        //System.out.printf("Inconsistent INFO values: %s => %s and %s%n", key, boundValue, p.getValue());
-                        inconsistentAttributes.add(key);
-                        attributes.remove(key);
-                    } else if ( ! alreadyFound || boundIsMissingValue )  { // no value
-                        //if ( vc != first ) System.out.printf("Adding key %s => %s%n", p.getKey(), p.getValue());
-                        attributes.put(key, p.getValue());
-                    }
-                }
-            }
-        }
-
-        // if we have more alternate alleles in the merged VC than in one or more of the
-        // original VCs, we need to strip out the GL/PLs (because they are no longer accurate), as well as allele-dependent attributes like AC,AF
-        for ( VariantContext vc : VCs ) {
-            if (vc.alleles.size() == 1)
-                continue;
-            if ( hasPLIncompatibleAlleles(alleles, vc.alleles)) {
-                logger.warn(String.format("Stripping PLs at %s due incompatible alleles merged=%s vs. single=%s",
-                        genomeLocParser.createGenomeLoc(vc), alleles, vc.alleles));
-                genotypes = stripPLs(genotypes);
-                // this will remove stale AC,AF attributed from vc
-                calculateChromosomeCounts(vc, attributes, true);
-                break;
-            }
-        }
-
-        // take the VC with the maxAC and pull the attributes into a modifiable map
-        if ( mergeInfoWithMaxAC && vcWithMaxAC != null ) {
-            attributesWithMaxAC.putAll(vcWithMaxAC.getAttributes());
-        }
-
-        // if at least one record was unfiltered and we want a union, clear all of the filters
-        if ( filteredRecordMergeType == FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED && nFiltered != VCs.size() )
-            filters.clear();
-
-
-        if ( annotateOrigin ) { // we care about where the call came from
-            String setValue;
-            if ( nFiltered == 0 && variantSources.size() == priorityListOfVCs.size() ) // nothing was unfiltered
-                setValue = MERGE_INTERSECTION;
-            else if ( nFiltered == VCs.size() )     // everything was filtered out
-                setValue = MERGE_FILTER_IN_ALL;
-            else if ( variantSources.isEmpty() )               // everyone was reference
-                setValue = MERGE_REF_IN_ALL;
-            else {
-                LinkedHashSet<String> s = new LinkedHashSet<String>();
-                for ( VariantContext vc : VCs )
-                    if ( vc.isVariant() )
-                        s.add( vc.isFiltered() ? MERGE_FILTER_PREFIX + vc.getSource() : vc.getSource() );
-                setValue = Utils.join("-", s);
-            }
-
-            if ( setKey != null ) {
-                attributes.put(setKey, setValue);
-                if( mergeInfoWithMaxAC && vcWithMaxAC != null ) { attributesWithMaxAC.put(setKey, vcWithMaxAC.getSource()); }
-            }
-        }
-
-        if ( depth > 0 )
-            attributes.put(VCFConstants.DEPTH_KEY, String.valueOf(depth));
-
-        if ( ! rsIDs.isEmpty() ) {
-            attributes.put(VariantContext.ID_KEY, Utils.join(",", rsIDs));
-        }
-
-        VariantContext merged = new VariantContext(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, negLog10PError, filters, (mergeInfoWithMaxAC ? attributesWithMaxAC : attributes) );
-        // Trim the padded bases of all alleles if necessary
-        merged = createVariantContextWithTrimmedAlleles(merged);
-
-        if ( printMessages && remapped ) System.out.printf("Remapped => %s%n", merged);
-        return merged;
-    }
-
-    private static final boolean hasPLIncompatibleAlleles(final Collection<Allele> alleleSet1, final Collection<Allele> alleleSet2) {
-        final Iterator<Allele> it1 = alleleSet1.iterator();
-        final Iterator<Allele> it2 = alleleSet2.iterator();
-
-        while ( it1.hasNext() && it2.hasNext() ) {
-            final Allele a1 = it1.next();
-            final Allele a2 = it2.next();
-            if ( ! a1.equals(a2) )
-                return true;
-        }
-
-        // by this point, at least one of the iterators is empty.  All of the elements
-        // we've compared are equal up until this point.  But it's possible that the
-        // sets aren't the same size, which is indicated by the test below.  If they
-        // are of the same size, though, the sets are compatible
-        return it1.hasNext() || it2.hasNext();
-    }
-
-    public static boolean allelesAreSubset(VariantContext vc1, VariantContext vc2) {
-        // if all alleles of vc1 are a contained in alleles of vc2, return true
-        if (!vc1.getReference().equals(vc2.getReference()))
-            return false;
-
-        for (Allele a :vc1.getAlternateAlleles()) {
-            if (!vc2.getAlternateAlleles().contains(a))
-                return false;
-        }
-
-        return true;
-    }
-    public static VariantContext createVariantContextWithTrimmedAlleles(VariantContext inputVC) {
-        // see if we need to trim common reference base from all alleles
-        boolean trimVC;
-
-        // We need to trim common reference base from all alleles in all genotypes if a ref base is common to all alleles
-        Allele refAllele = inputVC.getReference();
-        if (!inputVC.isVariant())
-            trimVC = false;
-        else if (refAllele.isNull())
-            trimVC = false;
-        else {
-            trimVC = (AbstractVCFCodec.computeForwardClipping(new ArrayList<Allele>(inputVC.getAlternateAlleles()),
-                    inputVC.getReference().getDisplayString()) > 0);
-         }
-
-        // nothing to do if we don't need to trim bases
-        if (trimVC) {
-            List<Allele> alleles = new ArrayList<Allele>();
-            Map<String, Genotype> genotypes = new TreeMap<String, Genotype>();
-
-            // set the reference base for indels in the attributes
-            Map<String,Object> attributes = new TreeMap<String,Object>(inputVC.getAttributes());
-
-            Map<Allele, Allele> originalToTrimmedAlleleMap = new HashMap<Allele, Allele>();
-
-            for (Allele a : inputVC.getAlleles()) {
-                if (a.isSymbolic()) {
-                    alleles.add(a);
-                    originalToTrimmedAlleleMap.put(a, a);
-                } else {
-                    // get bases for current allele and create a new one with trimmed bases
-                    byte[] newBases = Arrays.copyOfRange(a.getBases(), 1, a.length());
-                    Allele trimmedAllele = Allele.create(newBases, a.isReference());
-                    alleles.add(trimmedAllele);
-                    originalToTrimmedAlleleMap.put(a, trimmedAllele);
-                }
-            }
-
-            // detect case where we're trimming bases but resulting vc doesn't have any null allele. In that case, we keep original representation
-            // example: mixed records such as {TA*,TGA,TG}
-            boolean hasNullAlleles = false;
-
-            for (Allele a: originalToTrimmedAlleleMap.values()) {
-                if (a.isNull())
-                    hasNullAlleles = true;
-                if (a.isReference())
-                    refAllele = a;
-             }
-
-             if (!hasNullAlleles)
-               return inputVC;
-           // now we can recreate new genotypes with trimmed alleles
-            for ( Map.Entry<String, Genotype> sample : inputVC.getGenotypes().entrySet() ) {
-
-                List<Allele> originalAlleles = sample.getValue().getAlleles();
-                List<Allele> trimmedAlleles = new ArrayList<Allele>();
-                for ( Allele a : originalAlleles ) {
-                    if ( a.isCalled() )
-                        trimmedAlleles.add(originalToTrimmedAlleleMap.get(a));
-                    else
-                        trimmedAlleles.add(Allele.NO_CALL);
-                }
-                genotypes.put(sample.getKey(), Genotype.modifyAlleles(sample.getValue(), trimmedAlleles));
-
-            }
-            return new VariantContext(inputVC.getSource(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVC.filtersWereApplied() ? inputVC.getFilters() : null, attributes, new Byte(inputVC.getReference().getBases()[0]));
-
-        }
-
-        return inputVC;
-    }
-
-    public static Map<String, Genotype> stripPLs(Map<String, Genotype> genotypes) {
-        Map<String, Genotype> newGs = new HashMap<String, Genotype>(genotypes.size());
-
-        for ( Map.Entry<String, Genotype> g : genotypes.entrySet() ) {
-            newGs.put(g.getKey(), g.getValue().hasLikelihoods() ? removePLs(g.getValue()) : g.getValue());
-        }
-
-        return newGs;
-    }
-
-    public static Map<VariantContext.Type, List<VariantContext>> separateVariantContextsByType(Collection<VariantContext> VCs) {
-        HashMap<VariantContext.Type, List<VariantContext>> mappedVCs = new HashMap<VariantContext.Type, List<VariantContext>>();
-        for ( VariantContext vc : VCs ) {
-
-            // look at previous variant contexts of different type. If:
-            // a) otherVC has alleles which are subset of vc, remove otherVC from its list and add otherVC to  vc's list
-            // b) vc has alleles which are subset of otherVC. Then, add vc to otherVC's type list (rather, do nothing since vc will be added automatically to its list)
-            // c) neither: do nothing, just add vc to its own list
-            boolean addtoOwnList = true;
-            for (VariantContext.Type type : VariantContext.Type.values()) {
-                if (type.equals(vc.getType()))
-                    continue;
-
-                if (!mappedVCs.containsKey(type))
-                    continue;
-
-                List<VariantContext> vcList = mappedVCs.get(type);
-                for (int k=0; k <  vcList.size(); k++) {
-                    VariantContext otherVC = vcList.get(k);
-                    if (allelesAreSubset(otherVC,vc)) {
-                        // otherVC has a type different than vc and its alleles are a subset of vc: remove otherVC from its list and add it to vc's type list
-                        vcList.remove(k);
-                        // avoid having empty lists
-                        if (vcList.size() == 0)
-                            mappedVCs.remove(vcList);
-                        if ( !mappedVCs.containsKey(vc.getType()) )
-                            mappedVCs.put(vc.getType(), new ArrayList<VariantContext>());
-                        mappedVCs.get(vc.getType()).add(otherVC);
-                        break;
-                    }
-                    else if (allelesAreSubset(vc,otherVC)) {
-                        // vc has a type different than otherVC and its alleles are a subset of VC: add vc to otherVC's type list and don't add to its own
-                        mappedVCs.get(type).add(vc);
-                        addtoOwnList = false;
-                        break;
-                    }
-                }
-            }
-            if (addtoOwnList) {
-                if ( !mappedVCs.containsKey(vc.getType()) )
-                    mappedVCs.put(vc.getType(), new ArrayList<VariantContext>());
-                mappedVCs.get(vc.getType()).add(vc);
-                }
-        }
-
-        return mappedVCs;
-    }
-
-    private static class AlleleMapper {
-        private VariantContext vc = null;
-        private Map<Allele, Allele> map = null;
-        public AlleleMapper(VariantContext vc)          { this.vc = vc; }
-        public AlleleMapper(Map<Allele, Allele> map)    { this.map = map; }
-        public boolean needsRemapping()                 { return this.map != null; }
-        public Collection<Allele> values()              { return map != null ? map.values() : vc.getAlleles(); }
-
-        public Allele remap(Allele a)                   { return map != null && map.containsKey(a) ? map.get(a) : a; }
-
-        public List<Allele> remap(List<Allele> as) {
-            List<Allele> newAs = new ArrayList<Allele>();
-            for ( Allele a : as ) {
-                //System.out.printf("  Remapping %s => %s%n", a, remap(a));
-                newAs.add(remap(a));
-            }
-            return newAs;
-        }
-    }
-
-    static private void verifyUniqueSampleNames(Collection<VariantContext> unsortedVCs) {
-        Set<String> names = new HashSet<String>();
-        for ( VariantContext vc : unsortedVCs ) {
-            for ( String name : vc.getSampleNames() ) {
-                //System.out.printf("Checking %s %b%n", name, names.contains(name));
-                if ( names.contains(name) )
-                    throw new UserException("REQUIRE_UNIQUE sample names is true but duplicate names were discovered " + name);
-            }
-
-            names.addAll(vc.getSampleNames());
-        }
-    }
-
-
-    static private Allele determineReferenceAllele(List<VariantContext> VCs) {
-        Allele ref = null;
-
-        for ( VariantContext vc : VCs ) {
-            Allele myRef = vc.getReference();
-            if ( ref == null || ref.length() < myRef.length() )
-                ref = myRef;
-            else if ( ref.length() == myRef.length() && ! ref.equals(myRef) )
-                throw new UserException.BadInput(String.format("The provided variant file(s) have inconsistent references for the same position(s) at %s:%d, %s vs. %s", vc.getChr(), vc.getStart(), ref, myRef));
-        }
-
-        return ref;
-    }
-
-    static private AlleleMapper resolveIncompatibleAlleles(Allele refAllele, VariantContext vc, Set<Allele> allAlleles) {
-        if ( refAllele.equals(vc.getReference()) )
-            return new AlleleMapper(vc);
-        else {
-            // we really need to do some work.  The refAllele is the longest reference allele seen at this
-            // start site.  So imagine it is:
-            //
-            // refAllele: ACGTGA
-            // myRef:     ACGT
-            // myAlt:     -
-            //
-            // We need to remap all of the alleles in vc to include the extra GA so that
-            // myRef => refAllele and myAlt => GA
-            //
-
-            Allele myRef = vc.getReference();
-            if ( refAllele.length() <= myRef.length() ) throw new ReviewedStingException("BUG: myRef="+myRef+" is longer than refAllele="+refAllele);
-            byte[] extraBases = Arrays.copyOfRange(refAllele.getBases(), myRef.length(), refAllele.length());
-
-//            System.out.printf("Remapping allele at %s%n", vc);
-//            System.out.printf("ref   %s%n", refAllele);
-//            System.out.printf("myref %s%n", myRef );
-//            System.out.printf("extrabases %s%n", new String(extraBases));
-
-            Map<Allele, Allele> map = new HashMap<Allele, Allele>();
-            for ( Allele a : vc.getAlleles() ) {
-                if ( a.isReference() )
-                    map.put(a, refAllele);
-                else {
-                    Allele extended = Allele.extend(a, extraBases);
-                    for ( Allele b : allAlleles )
-                        if ( extended.equals(b) )
-                            extended = b;
-//                    System.out.printf("  Extending %s => %s%n", a, extended);
-                    map.put(a, extended);
-                }
-            }
-
-            // debugging
-//            System.out.printf("mapping %s%n", map);
-
-            return new AlleleMapper(map);
-        }
-    }
-
-    static class CompareByPriority implements Comparator<VariantContext>, Serializable {
-        List<String> priorityListOfVCs;
-        public CompareByPriority(List<String> priorityListOfVCs) {
-            this.priorityListOfVCs = priorityListOfVCs;
-        }
-
-        private int getIndex(VariantContext vc) {
-            int i = priorityListOfVCs.indexOf(vc.getSource());
-            if ( i == -1 ) throw new UserException.BadArgumentValue(Utils.join(",", priorityListOfVCs), "Priority list " + priorityListOfVCs + " doesn't contain variant context " + vc.getSource());
-            return i;
-        }
-
-        public int compare(VariantContext vc1, VariantContext vc2) {
-            return Integer.valueOf(getIndex(vc1)).compareTo(getIndex(vc2));
-        }
-    }
-
-    public static List<VariantContext> sortVariantContextsByPriority(Collection<VariantContext> unsortedVCs, List<String> priorityListOfVCs, GenotypeMergeType mergeOption ) {
-        if ( mergeOption == GenotypeMergeType.PRIORITIZE && priorityListOfVCs == null )
-            throw new IllegalArgumentException("Cannot merge calls by priority with a null priority list");
-
-        if ( priorityListOfVCs == null || mergeOption == GenotypeMergeType.UNSORTED )
-            return new ArrayList<VariantContext>(unsortedVCs);
-        else {
-            ArrayList<VariantContext> sorted = new ArrayList<VariantContext>(unsortedVCs);
-            Collections.sort(sorted, new CompareByPriority(priorityListOfVCs));
-            return sorted;
-        }
-    }
-
-    private static void mergeGenotypes(Map<String, Genotype> mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
-        for ( Genotype g : oneVC.getGenotypes().values() ) {
-            String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
-            if ( ! mergedGenotypes.containsKey(name) ) {
-                // only add if the name is new
-                Genotype newG = g;
-
-                if ( uniqifySamples || alleleMapping.needsRemapping() ) {
-                    MutableGenotype mutG = new MutableGenotype(name, g);
-                    if ( alleleMapping.needsRemapping() ) mutG.setAlleles(alleleMapping.remap(g.getAlleles()));
-                    newG = mutG;
-                }
-
-                mergedGenotypes.put(name, newG);
-            }
-        }
-    }
-
-    public static String mergedSampleName(String trackName, String sampleName, boolean uniqify ) {
-        return uniqify ? sampleName + "." + trackName : sampleName;
-    }
-
-    /**
-     * Returns a context identical to this with the REF and ALT alleles reverse complemented.
-     *
-     * @param vc        variant context
-     * @return new vc
-     */
-    public static VariantContext reverseComplement(VariantContext vc) {
-        // create a mapping from original allele to reverse complemented allele
-        HashMap<Allele, Allele> alleleMap = new HashMap<Allele, Allele>(vc.getAlleles().size());
-        for ( Allele originalAllele : vc.getAlleles() ) {
-            Allele newAllele;
-            if ( originalAllele.isNoCall() || originalAllele.isNull() )
-                newAllele = originalAllele;
-            else
-                newAllele = Allele.create(BaseUtils.simpleReverseComplement(originalAllele.getBases()), originalAllele.isReference());
-            alleleMap.put(originalAllele, newAllele);
-        }
-
-        // create new Genotype objects
-        Map<String, Genotype> newGenotypes = new HashMap<String, Genotype>(vc.getNSamples());
-        for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
-            List<Allele> newAlleles = new ArrayList<Allele>();
-            for ( Allele allele : genotype.getValue().getAlleles() ) {
-                Allele newAllele = alleleMap.get(allele);
-                if ( newAllele == null )
-                    newAllele = Allele.NO_CALL;
-                newAlleles.add(newAllele);
-            }
-            newGenotypes.put(genotype.getKey(), Genotype.modifyAlleles(genotype.getValue(), newAlleles));
-        }
-
-        return new VariantContext(vc.getSource(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes());
-
-    }
-
-    public static VariantContext purgeUnallowedGenotypeAttributes(VariantContext vc, Set<String> allowedAttributes) {
-        if ( allowedAttributes == null )
-            return vc;
-
-        Map<String, Genotype> newGenotypes = new HashMap<String, Genotype>(vc.getNSamples());
-        for ( Map.Entry<String, Genotype> genotype : vc.getGenotypes().entrySet() ) {
-            Map<String, Object> attrs = new HashMap<String, Object>();
-            for ( Map.Entry<String, Object> attr : genotype.getValue().getAttributes().entrySet() ) {
-                if ( allowedAttributes.contains(attr.getKey()) )
-                    attrs.put(attr.getKey(), attr.getValue());
-            }
-            newGenotypes.put(genotype.getKey(), Genotype.modifyAttributes(genotype.getValue(), attrs));
-        }
-
-        return VariantContext.modifyGenotypes(vc, newGenotypes);
-    }
-
-    public static BaseUtils.BaseSubstitutionType getSNPSubstitutionType(VariantContext context) {
-        if (!context.isSNP() || !context.isBiallelic())
-            throw new IllegalStateException("Requested SNP substitution type for bialleic non-SNP " + context);
-        return BaseUtils.SNPSubstitutionType(context.getReference().getBases()[0], context.getAlternateAllele(0).getBases()[0]);
-    }
-
-    /**
-     * If this is a BiAlleic SNP, is it a transition?
-     */
-    public static boolean isTransition(VariantContext context) {
-        return getSNPSubstitutionType(context) == BaseUtils.BaseSubstitutionType.TRANSITION;
-    }
-
-    /**
-     * If this is a BiAlleic SNP, is it a transversion?
-     */
-    public static boolean isTransversion(VariantContext context) {
-        return getSNPSubstitutionType(context) == BaseUtils.BaseSubstitutionType.TRANSVERSION;
-    }
-
-    /**
-     * create a genome location, given a variant context
-     * @param genomeLocParser parser
-     * @param vc the variant context
-     * @return the genomeLoc
-     */
-    public static final GenomeLoc getLocation(GenomeLocParser genomeLocParser,VariantContext vc) {
-        return genomeLocParser.createGenomeLoc(vc.getChr(), vc.getStart(), vc.getEnd(), true);
-    }
-
-    public abstract static class AlleleMergeRule {
-        // vc1, vc2 are ONLY passed to allelesShouldBeMerged() if mergeIntoMNPvalidationCheck(genomeLocParser, vc1, vc2) AND allSamplesAreMergeable(vc1, vc2):
-        abstract public boolean allelesShouldBeMerged(VariantContext vc1, VariantContext vc2);
-
-        public String toString() {
-            return "all samples are mergeable";
-        }
-    }
-
-    // NOTE: returns null if vc1 and vc2 are not merged into a single MNP record
-
-    public static VariantContext mergeIntoMNP(GenomeLocParser genomeLocParser, VariantContext vc1, VariantContext vc2, ReferenceSequenceFile referenceFile, AlleleMergeRule alleleMergeRule) {
-        if (!mergeIntoMNPvalidationCheck(genomeLocParser, vc1, vc2))
-            return null;
-
-        // Check that it's logically possible to merge the VCs:
-        if (!allSamplesAreMergeable(vc1, vc2))
-            return null;
-
-        // Check if there's a "point" in merging the VCs (e.g., annotations could be changed)
-        if (!alleleMergeRule.allelesShouldBeMerged(vc1, vc2))
-            return null;
-
-        return reallyMergeIntoMNP(vc1, vc2, referenceFile);
-    }
-
-    private static VariantContext reallyMergeIntoMNP(VariantContext vc1, VariantContext vc2, ReferenceSequenceFile referenceFile) {
-        int startInter = vc1.getEnd() + 1;
-        int endInter = vc2.getStart() - 1;
-        byte[] intermediateBases = null;
-        if (startInter <= endInter) {
-            intermediateBases = referenceFile.getSubsequenceAt(vc1.getChr(), startInter, endInter).getBases();
-            StringUtil.toUpperCase(intermediateBases);
-        }
-        MergedAllelesData mergeData = new MergedAllelesData(intermediateBases, vc1, vc2); // ensures that the reference allele is added
-
-        Map<String, Genotype> mergedGenotypes = new HashMap<String, Genotype>();
-        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
-            String sample = gt1Entry.getKey();
-            Genotype gt1 = gt1Entry.getValue();
-            Genotype gt2 = vc2.getGenotype(sample);
-
-            List<Allele> site1Alleles = gt1.getAlleles();
-            List<Allele> site2Alleles = gt2.getAlleles();
-
-            List<Allele> mergedAllelesForSample = new LinkedList<Allele>();
-
-            /* NOTE: Since merged alleles are added to mergedAllelesForSample in the SAME order as in the input VC records,
-               we preserve phase information (if any) relative to whatever precedes vc1:
-             */
-            Iterator<Allele> all2It = site2Alleles.iterator();
-            for (Allele all1 : site1Alleles) {
-                Allele all2 = all2It.next(); // this is OK, since allSamplesAreMergeable()
-
-                Allele mergedAllele = mergeData.ensureMergedAllele(all1, all2);
-                mergedAllelesForSample.add(mergedAllele);
-            }
-
-            double mergedGQ = Math.max(gt1.getNegLog10PError(), gt2.getNegLog10PError());
-            Set<String> mergedGtFilters = new HashSet<String>(); // Since gt1 and gt2 were unfiltered, the Genotype remains unfiltered
-
-            Map<String, Object> mergedGtAttribs = new HashMap<String, Object>();
-            PhaseAndQuality phaseQual = calcPhaseForMergedGenotypes(gt1, gt2);
-            if (phaseQual.PQ != null)
-                mergedGtAttribs.put(ReadBackedPhasingWalker.PQ_KEY, phaseQual.PQ);
-
-            Genotype mergedGt = new Genotype(sample, mergedAllelesForSample, mergedGQ, mergedGtFilters, mergedGtAttribs, phaseQual.isPhased);
-            mergedGenotypes.put(sample, mergedGt);
-        }
-
-        String mergedName = VariantContextUtils.mergeVariantContextNames(vc1.getSource(), vc2.getSource());
-        double mergedNegLog10PError = Math.max(vc1.getNegLog10PError(), vc2.getNegLog10PError());
-        Set<String> mergedFilters = new HashSet<String>(); // Since vc1 and vc2 were unfiltered, the merged record remains unfiltered
-        Map<String, Object> mergedAttribs = VariantContextUtils.mergeVariantContextAttributes(vc1, vc2);
-
-        VariantContext mergedVc = new VariantContext(mergedName, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles(), mergedGenotypes, mergedNegLog10PError, mergedFilters, mergedAttribs);
-
-        mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
-        VariantContextUtils.calculateChromosomeCounts(mergedVc, mergedAttribs, true);
-        mergedVc = VariantContext.modifyAttributes(mergedVc, mergedAttribs);
-
-        return mergedVc;
-    }
-
-    private static class AlleleOneAndTwo {
-        private Allele all1;
-        private Allele all2;
-
-        public AlleleOneAndTwo(Allele all1, Allele all2) {
-            this.all1 = all1;
-            this.all2 = all2;
-        }
-
-        public int hashCode() {
-            return all1.hashCode() + all2.hashCode();
-        }
-
-        public boolean equals(Object other) {
-            if (!(other instanceof AlleleOneAndTwo))
-                return false;
-
-            AlleleOneAndTwo otherAot = (AlleleOneAndTwo) other;
-            return (this.all1.equals(otherAot.all1) && this.all2.equals(otherAot.all2));
-        }
-    }
-
-    private static class MergedAllelesData {
-        private Map<AlleleOneAndTwo, Allele> mergedAlleles;
-        private byte[] intermediateBases;
-        private int intermediateLength;
-
-        public MergedAllelesData(byte[] intermediateBases, VariantContext vc1, VariantContext vc2) {
-            this.mergedAlleles = new HashMap<AlleleOneAndTwo, Allele>(); // implemented equals() and hashCode() for AlleleOneAndTwo
-            this.intermediateBases = intermediateBases;
-            this.intermediateLength = this.intermediateBases != null ? this.intermediateBases.length : 0;
-
-            this.ensureMergedAllele(vc1.getReference(), vc2.getReference(), true);
-        }
-
-        public Allele ensureMergedAllele(Allele all1, Allele all2) {
-            return ensureMergedAllele(all1, all2, false); // false <-> since even if all1+all2 = reference, it was already created in the constructor
-        }
-
-        private Allele ensureMergedAllele(Allele all1, Allele all2, boolean creatingReferenceForFirstTime) {
-            AlleleOneAndTwo all12 = new AlleleOneAndTwo(all1, all2);
-            Allele mergedAllele = mergedAlleles.get(all12);
-
-            if (mergedAllele == null) {
-                byte[] bases1 = all1.getBases();
-                byte[] bases2 = all2.getBases();
-
-                byte[] mergedBases = new byte[bases1.length + intermediateLength + bases2.length];
-                System.arraycopy(bases1, 0, mergedBases, 0, bases1.length);
-                if (intermediateBases != null)
-                    System.arraycopy(intermediateBases, 0, mergedBases, bases1.length, intermediateLength);
-                System.arraycopy(bases2, 0, mergedBases, bases1.length + intermediateLength, bases2.length);
-
-                mergedAllele = Allele.create(mergedBases, creatingReferenceForFirstTime);
-                mergedAlleles.put(all12, mergedAllele);
-            }
-
-            return mergedAllele;
-        }
-
-        public Set<Allele> getAllMergedAlleles() {
-            return new HashSet<Allele>(mergedAlleles.values());
-        }
-    }
-
-    private static String mergeVariantContextNames(String name1, String name2) {
-        return name1 + "_" + name2;
-    }
-
-    private static Map<String, Object> mergeVariantContextAttributes(VariantContext vc1, VariantContext vc2) {
-        Map<String, Object> mergedAttribs = new HashMap<String, Object>();
-
-        List<VariantContext> vcList = new LinkedList<VariantContext>();
-        vcList.add(vc1);
-        vcList.add(vc2);
-
-        String[] MERGE_OR_ATTRIBS = {VCFConstants.DBSNP_KEY};
-        for (String orAttrib : MERGE_OR_ATTRIBS) {
-            boolean attribVal = false;
-            for (VariantContext vc : vcList) {
-                attribVal = vc.getAttributeAsBoolean(orAttrib, false);
-                if (attribVal) // already true, so no reason to continue:
-                    break;
-            }
-            mergedAttribs.put(orAttrib, attribVal);
-        }
-
-        // Merge ID fields:
-        String iDVal = null;
-        for (VariantContext vc : vcList) {
-            String val = vc.getAttributeAsString(VariantContext.ID_KEY, null);
-            if (val != null && !val.equals(VCFConstants.EMPTY_ID_FIELD)) {
-                if (iDVal == null)
-                    iDVal = val;
-                else
-                    iDVal += VCFConstants.ID_FIELD_SEPARATOR + val;
-            }
-        }
-        if (iDVal != null)
-            mergedAttribs.put(VariantContext.ID_KEY, iDVal);
-
-        return mergedAttribs;
-    }
-
-    private static boolean mergeIntoMNPvalidationCheck(GenomeLocParser genomeLocParser, VariantContext vc1, VariantContext vc2) {
-        GenomeLoc loc1 = VariantContextUtils.getLocation(genomeLocParser, vc1);
-        GenomeLoc loc2 = VariantContextUtils.getLocation(genomeLocParser, vc2);
-
-        if (!loc1.onSameContig(loc2))
-            throw new ReviewedStingException("Can only merge vc1, vc2 if on the same chromosome");
-
-        if (!loc1.isBefore(loc2))
-            throw new ReviewedStingException("Can only merge if vc1 is BEFORE vc2");
-
-        if (vc1.isFiltered() || vc2.isFiltered())
-            return false;
-
-        if (!vc1.getSampleNames().equals(vc2.getSampleNames())) // vc1, vc2 refer to different sample sets
-            return false;
-
-        if (!allGenotypesAreUnfilteredAndCalled(vc1) || !allGenotypesAreUnfilteredAndCalled(vc2))
-            return false;
-
-        return true;
-    }
-
-    private static boolean allGenotypesAreUnfilteredAndCalled(VariantContext vc) {
-        for (Map.Entry<String, Genotype> gtEntry : vc.getGenotypes().entrySet()) {
-            Genotype gt = gtEntry.getValue();
-            if (gt.isNoCall() || gt.isFiltered())
-                return false;
-        }
-
-        return true;
-    }
-
-    // Assumes that vc1 and vc2 were already checked to have the same sample names:
-
-    private static boolean allSamplesAreMergeable(VariantContext vc1, VariantContext vc2) {
-        // Check that each sample's genotype in vc2 is uniquely appendable onto its genotype in vc1:
-        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
-            String sample = gt1Entry.getKey();
-            Genotype gt1 = gt1Entry.getValue();
-            Genotype gt2 = vc2.getGenotype(sample);
-
-            if (!alleleSegregationIsKnown(gt1, gt2)) // can merge if: phased, or if either is a hom
-                return false;
-        }
-
-        return true;
-    }
-
-    public static boolean alleleSegregationIsKnown(Genotype gt1, Genotype gt2) {
-        if (gt1.getPloidy() != gt2.getPloidy())
-            return false;
-
-        /* If gt2 is phased or hom, then could even be MERGED with gt1 [This is standard].
-
-           HOWEVER, EVEN if this is not the case, but gt1.isHom(),
-           it is trivially known that each of gt2's alleles segregate with the single allele type present in gt1.
-         */
-        return (gt2.isPhased() || gt2.isHom() || gt1.isHom());
-    }
-
-    private static class PhaseAndQuality {
-        public boolean isPhased;
-        public Double PQ = null;
-
-        public PhaseAndQuality(Genotype gt) {
-            this.isPhased = gt.isPhased();
-            if (this.isPhased) {
-                this.PQ = gt.getAttributeAsDouble(ReadBackedPhasingWalker.PQ_KEY, -1);
-                if ( this.PQ == -1 ) this.PQ = null;
-            }
-        }
-    }
-
-    // Assumes that alleleSegregationIsKnown(gt1, gt2):
-
-    private static PhaseAndQuality calcPhaseForMergedGenotypes(Genotype gt1, Genotype gt2) {
-        if (gt2.isPhased() || gt2.isHom())
-            return new PhaseAndQuality(gt1); // maintain the phase of gt1
-
-        if (!gt1.isHom())
-            throw new ReviewedStingException("alleleSegregationIsKnown(gt1, gt2) implies: gt2.genotypesArePhased() || gt2.isHom() || gt1.isHom()");
-
-        /* We're dealing with: gt1.isHom(), gt2.isHet(), !gt2.genotypesArePhased(); so, the merged (het) Genotype is not phased relative to the previous Genotype
-
-           For example, if we're merging the third Genotype with the second one:
-           0/1
-           1|1
-           0/1
-
-           Then, we want to output:
-           0/1
-           1/2
-         */
-        return new PhaseAndQuality(gt2); // maintain the phase of gt2 [since !gt2.genotypesArePhased()]
-    }
-
-    /* Checks if any sample has a MNP of ALT alleles (segregating together):
-     [Assumes that vc1 and vc2 were already checked to have the same sample names && allSamplesAreMergeable(vc1, vc2)]
-     */
-
-    public static boolean someSampleHasDoubleNonReferenceAllele(VariantContext vc1, VariantContext vc2) {
-        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
-            String sample = gt1Entry.getKey();
-            Genotype gt1 = gt1Entry.getValue();
-            Genotype gt2 = vc2.getGenotype(sample);
-
-            List<Allele> site1Alleles = gt1.getAlleles();
-            List<Allele> site2Alleles = gt2.getAlleles();
-
-            Iterator<Allele> all2It = site2Alleles.iterator();
-            for (Allele all1 : site1Alleles) {
-                Allele all2 = all2It.next(); // this is OK, since allSamplesAreMergeable()
-
-                if (all1.isNonReference() && all2.isNonReference()) // corresponding alleles are alternate
-                    return true;
-            }
-        }
-
-        return false;
-    }
-
-    /* Checks if all samples are consistent in their haplotypes:
-     [Assumes that vc1 and vc2 were already checked to have the same sample names && allSamplesAreMergeable(vc1, vc2)]
-     */
-
-    public static boolean doubleAllelesSegregatePerfectlyAmongSamples(VariantContext vc1, VariantContext vc2) {
-        // Check that Alleles at vc1 and at vc2 always segregate together in all samples (including reference):
-        Map<Allele, Allele> allele1ToAllele2 = new HashMap<Allele, Allele>();
-        Map<Allele, Allele> allele2ToAllele1 = new HashMap<Allele, Allele>();
-
-        // Note the segregation of the alleles for the reference genome:
-        allele1ToAllele2.put(vc1.getReference(), vc2.getReference());
-        allele2ToAllele1.put(vc2.getReference(), vc1.getReference());
-
-        // Note the segregation of the alleles for each sample (and check that it is consistent with the reference and all previous samples).
-        for (Map.Entry<String, Genotype> gt1Entry : vc1.getGenotypes().entrySet()) {
-            String sample = gt1Entry.getKey();
-            Genotype gt1 = gt1Entry.getValue();
-            Genotype gt2 = vc2.getGenotype(sample);
-
-            List<Allele> site1Alleles = gt1.getAlleles();
-            List<Allele> site2Alleles = gt2.getAlleles();
-
-            Iterator<Allele> all2It = site2Alleles.iterator();
-            for (Allele all1 : site1Alleles) {
-                Allele all2 = all2It.next();
-
-                Allele all1To2 = allele1ToAllele2.get(all1);
-                if (all1To2 == null)
-                    allele1ToAllele2.put(all1, all2);
-                else if (!all1To2.equals(all2)) // all1 segregates with two different alleles at site 2
-                    return false;
-
-                Allele all2To1 = allele2ToAllele1.get(all2);
-                if (all2To1 == null)
-                    allele2ToAllele1.put(all2, all1);
-                else if (!all2To1.equals(all1)) // all2 segregates with two different alleles at site 1
-                    return false;
-            }
-        }
-
-        return true;
-    }
-}
\ No newline at end of file
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantJEXLContext.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantJEXLContext.java
deleted file mode 100644
index f16861f30..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/v13/VariantJEXLContext.java
+++ /dev/null
@@ -1,315 +0,0 @@
-/*
- * Copyright (c) 2010.  The Broad Institute
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.utils.variantcontext.v13;
-
-import org.apache.commons.jexl2.JexlContext;
-import org.apache.commons.jexl2.MapContext;
-import org.broadinstitute.sting.utils.Utils;
-import org.broadinstitute.sting.utils.exceptions.UserException;
-
-import java.util.Collection;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.Set;
-
-/**
- *
- * @author aaron
- * @author depristo
- *
- * Class VariantJEXLContext
- *
- * implements the JEXML context for VariantContext; this saves us from
- * having to generate a JEXML context lookup map everytime we want to evaluate an expression.
- *
- * This is package protected, only classes in variantcontext should have access to it.
- *
- * // todo -- clean up to remove or better support genotype filtering 
- */
-
-class VariantJEXLContext implements JexlContext {
-    // our stored variant context
-    private VariantContext vc;
-
-    private interface AttributeGetter {
-        public Object get(VariantContext vc);
-    }
-
-    private static Map<String, AttributeGetter> x = new HashMap<String, AttributeGetter>();
-
-    static {
-        x.put("vc",   new AttributeGetter() { public Object get(VariantContext vc) { return vc; }});
-        x.put("CHROM",   new AttributeGetter() { public Object get(VariantContext vc) { return vc.getChr(); }});
-        x.put("POS",     new AttributeGetter() { public Object get(VariantContext vc) { return vc.getStart(); }});
-        x.put("TYPE",    new AttributeGetter() { public Object get(VariantContext vc) { return vc.getType().toString(); }});
-        x.put("QUAL",    new AttributeGetter() { public Object get(VariantContext vc) { return 10 * vc.getNegLog10PError(); }});
-        x.put("ALLELES", new AttributeGetter() { public Object get(VariantContext vc) { return vc.getAlleles(); }});
-        x.put("N_ALLELES", new AttributeGetter() { public Object get(VariantContext vc) { return vc.getNAlleles(); }});
-        x.put("FILTER",    new AttributeGetter() { public Object get(VariantContext vc) { return vc.isFiltered() ? "1" : "0"; }});
-
-//        x.put("GT",        new AttributeGetter() { public Object get(VariantContext vc) { return g.getGenotypeString(); }});
-        x.put("homRefCount",  new AttributeGetter() { public Object get(VariantContext vc) { return vc.getHomRefCount(); }});
-        x.put("hetCount",     new AttributeGetter() { public Object get(VariantContext vc) { return vc.getHetCount(); }});
-        x.put("homVarCount",  new AttributeGetter() { public Object get(VariantContext vc) { return vc.getHomVarCount(); }});
-    }
-
-    public VariantJEXLContext(VariantContext vc) {
-        this.vc = vc;
-    }
-
-    public Object get(String name) {
-        Object result = null;
-        if ( x.containsKey(name) ) { // dynamic resolution of name -> value via map
-            result = x.get(name).get(vc);
-        } else if ( vc.hasAttribute(name)) {
-            result = vc.getAttribute(name);
-        } else if ( vc.getFilters().contains(name) ) {
-            result = "1";
-        }
-
-        //System.out.printf("dynamic lookup %s => %s%n", name, result);
-
-        return result;
-    }
-
-    public boolean has(String name) {
-        return get(name) != null;
-    }
-
-    public void	set(String name, Object value) {
-        throw new UnsupportedOperationException("remove() not supported on a VariantJEXLContext");
-    }
-}
-
-
-
-
-/**
- * this is an implementation of a Map of JexlVCMatchExp to true or false values.  It lazy initializes each value
- * as requested to save as much processing time as possible.
- *
- * Compatible with JEXL 1.1 (this code will be easier if we move to 2.0, all of the functionality can go into the
- * JexlContext's get()
- * 
- */
-
-class JEXLMap implements Map<VariantContextUtils.JexlVCMatchExp, Boolean> {
-    // our variant context and/or Genotype
-    private final VariantContext vc;
-    private final Genotype g;
-
-    // our context
-    private JexlContext jContext = null;
-
-    // our mapping from JEXLVCMatchExp to Booleans, which will be set to NULL for previously uncached JexlVCMatchExp
-    private Map<VariantContextUtils.JexlVCMatchExp,Boolean> jexl;
-
-
-    public JEXLMap(Collection<VariantContextUtils.JexlVCMatchExp> jexlCollection, VariantContext vc, Genotype g) {
-        this.vc = vc;
-        this.g = g;
-        initialize(jexlCollection);
-    }
-
-    public JEXLMap(Collection<VariantContextUtils.JexlVCMatchExp> jexlCollection, VariantContext vc) {
-        this(jexlCollection, vc, null);
-    }
-
-    private void initialize(Collection<VariantContextUtils.JexlVCMatchExp> jexlCollection) {
-        jexl = new HashMap<VariantContextUtils.JexlVCMatchExp,Boolean>();
-        for (VariantContextUtils.JexlVCMatchExp exp: jexlCollection) {
-            jexl.put(exp, null);
-        }
-    }
-
-    /**
-     * create the internal JexlContext, only when required.  This code is where new JEXL context variables
-     * should get added.
-     *
-     */
-    private void createContext() {
-        if ( g == null ) {
-            // todo -- remove dependancy on g to the entire system
-            jContext = new VariantJEXLContext(vc);
-        } else {
-            //
-            // this whole branch is here just to support G jexl operations
-            //
-            Map<String, Object> infoMap = new HashMap<String, Object>();
-
-            if ( vc != null ) {
-                // create a mapping of what we know about the variant context, its Chromosome, positions, etc.
-                infoMap.put("CHROM", vc.getChr());
-                infoMap.put("POS", vc.getStart());
-                infoMap.put("TYPE", vc.getType().toString());
-                infoMap.put("QUAL", String.valueOf(vc.getPhredScaledQual()));
-
-                // add alleles
-                infoMap.put("ALLELES", Utils.join(";", vc.getAlleles()));
-                infoMap.put("N_ALLELES", String.valueOf(vc.getNAlleles()));
-
-                // add attributes
-                addAttributesToMap(infoMap, vc.getAttributes());
-
-                // add filter fields
-                infoMap.put("FILTER", vc.isFiltered() ? "1" : "0");
-                for ( Object filterCode : vc.getFilters() ) {
-                    infoMap.put(String.valueOf(filterCode), "1");
-                }
-
-                // add genotype-specific fields
-                // TODO -- implement me when we figure out a good way to represent this
-                //    for ( Genotype g : vc.getGenotypes().values() ) {
-                //        String prefix = g.getSampleName() + ".";
-                //        addAttributesToMap(infoMap, g.getAttributes(), prefix);
-                //        infoMap.put(prefix + "GT", g.getGenotypeString());
-                //    }
-
-                // add specific genotype if one is provided
-                infoMap.put(VCFConstants.GENOTYPE_KEY, g.getGenotypeString());
-                infoMap.put("isHomRef", g.isHomRef() ? "1" : "0");
-                infoMap.put("isHet", g.isHet() ? "1" : "0");
-                infoMap.put("isHomVar", g.isHomVar() ? "1" : "0");
-                infoMap.put(VCFConstants.GENOTYPE_QUALITY_KEY, new Double(g.getPhredScaledQual()));
-                for ( Map.Entry<String, Object> e : g.getAttributes().entrySet() ) {
-                    if ( e.getValue() != null && !e.getValue().equals(VCFConstants.MISSING_VALUE_v4) )
-                        infoMap.put(e.getKey(), e.getValue());
-                }
-            }
-
-            // create the internal context that we can evaluate expressions against
-
-            jContext = new MapContext(infoMap);
-        }
-    }
-
-    /**
-     * @return the size of the internal data structure
-     */
-    public int size() {
-        return jexl.size();
-    }
-
-    /**
-     * @return true if we're empty
-     */
-    public boolean isEmpty() { return this.jexl.isEmpty(); }
-
-    /**
-     * do we contain the specified key
-     * @param o the key
-     * @return true if we have a value for that key
-     */
-    public boolean containsKey(Object o) { return jexl.containsKey(o); }
-
-    public Boolean get(Object o) {
-        // if we've already determined the value, return it
-        if (jexl.containsKey(o) && jexl.get(o) != null) return jexl.get(o);
-
-        // try and cast the expression
-        VariantContextUtils.JexlVCMatchExp e = (VariantContextUtils.JexlVCMatchExp) o;
-        evaluateExpression(e);
-        return jexl.get(e);
-    }
-
-    /**
-     * get the keyset of map
-     * @return a set of keys of type JexlVCMatchExp
-     */
-    public Set<VariantContextUtils.JexlVCMatchExp> keySet() {
-        return jexl.keySet();
-    }
-
-    /**
-     * get all the values of the map.  This is an expensive call, since it evaluates all keys that haven't
-     * been evaluated yet.  This is fine if you truely want all the keys, but if you only want a portion, or  know
-     * the keys you want, you would be better off using get() to get them by name.
-     * @return a collection of boolean values, representing the results of all the variants evaluated
-     */
-    public Collection<Boolean> values() {
-        // this is an expensive call
-        for (VariantContextUtils.JexlVCMatchExp exp : jexl.keySet())
-            if (jexl.get(exp) == null)
-                evaluateExpression(exp);
-        return jexl.values();
-    }
-
-    /**
-     * evaulate a JexlVCMatchExp's expression, given the current context (and setup the context if it's null)
-     * @param exp the JexlVCMatchExp to evaluate
-     */
-    private void evaluateExpression(VariantContextUtils.JexlVCMatchExp exp) {
-        // if the context is null, we need to create it to evaluate the JEXL expression
-        if (this.jContext == null) createContext();
-        try {
-            jexl.put (exp, (Boolean) exp.exp.evaluate(jContext));
-        } catch (Exception e) {
-            throw new UserException.CommandLineException(String.format("Invalid JEXL expression detected for %s with message %s", exp.name, e.getMessage()));
-        }
-    }
-
-    /**
-     * helper function: adds the list of attributes to the information map we're building
-     * @param infoMap the map
-     * @param attributes the attributes
-     */
-    private static void addAttributesToMap(Map<String, Object> infoMap, Map<String, ?> attributes ) {
-        for (Map.Entry<String, ?> e : attributes.entrySet()) {
-            infoMap.put(e.getKey(), String.valueOf(e.getValue()));
-        }
-    }
-
-    public Boolean put(VariantContextUtils.JexlVCMatchExp jexlVCMatchExp, Boolean aBoolean) {
-        return jexl.put(jexlVCMatchExp,aBoolean);
-    }
-
-    public void putAll(Map<? extends VariantContextUtils.JexlVCMatchExp, ? extends Boolean> map) {
-        jexl.putAll(map);
-    }
-
-    // //////////////////////////////////////////////////////////////////////////////////////
-    // The Following are unsupported at the moment
-    // //////////////////////////////////////////////////////////////////////////////////////
-
-    // this doesn't make much sense to implement, boolean doesn't offer too much variety to deal
-    // with evaluating every key in the internal map.
-    public boolean containsValue(Object o) {
-        throw new UnsupportedOperationException("containsValue() not supported on a JEXLMap");
-    }
-
-    // this doesn't make much sense
-    public Boolean remove(Object o) {
-        throw new UnsupportedOperationException("remove() not supported on a JEXLMap");
-    }
-
-
-    public Set<Entry<VariantContextUtils.JexlVCMatchExp, Boolean>> entrySet() {
-        throw new UnsupportedOperationException("clear() not supported on a JEXLMap");
-    }
-
-    // nope
-    public void clear() {
-        throw new UnsupportedOperationException("clear() not supported on a JEXLMap");
-    }
-}

From aa0610ea929f98a4ee4e8a56eec195be8e37abd2 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 16 Nov 2011 16:24:05 -0500
Subject: [PATCH 042/113] GenotypeCollection renamed to GenotypesContext

---
 .../gatk/refdata/VariantContextAdaptors.java  |  6 +--
 .../gatk/walkers/annotator/AlleleBalance.java |  4 +-
 .../gatk/walkers/annotator/HardyWeinberg.java |  4 +-
 .../walkers/annotator/InbreedingCoeff.java    |  4 +-
 .../gatk/walkers/annotator/QualByDepth.java   |  4 +-
 .../gatk/walkers/annotator/RankSumTest.java   |  4 +-
 .../annotator/VariantAnnotatorEngine.java     |  6 +--
 .../beagle/BeagleOutputToVCFWalker.java       |  4 +-
 .../beagle/ProduceBeagleInputWalker.java      |  4 +-
 .../filters/VariantFiltrationWalker.java      |  6 +--
 .../AlleleFrequencyCalculationModel.java      |  8 ++--
 .../genotyper/ExactAFCalculationModel.java    | 14 +++---
 .../walkers/genotyper/UGCallVariants.java     |  8 ++--
 .../genotyper/UnifiedGenotyperEngine.java     |  6 +--
 .../indels/SomaticIndelDetectorWalker.java    |  6 +--
 .../walkers/phasing/PhaseByTransmission.java  |  6 +--
 .../gatk/walkers/phasing/PhasingUtils.java    |  2 +-
 .../phasing/ReadBackedPhasingWalker.java      |  6 +--
 .../evaluators/GenotypePhasingEvaluator.java  |  6 +--
 .../variantutils/LeftAlignVariants.java       |  4 +-
 .../walkers/variantutils/SelectVariants.java  |  2 +-
 .../walkers/variantutils/VariantsToVCF.java   |  2 +-
 .../utils/codecs/vcf/AbstractVCFCodec.java    |  4 +-
 .../sting/utils/codecs/vcf/VCF3Codec.java     |  6 +--
 .../sting/utils/codecs/vcf/VCFCodec.java      |  6 +--
 .../sting/utils/codecs/vcf/VCFParser.java     |  4 +-
 .../broadinstitute/sting/utils/gcf/GCF.java   |  8 ++--
 ...eCollection.java => GenotypesContext.java} | 48 +++++++++----------
 .../utils/variantcontext/VariantContext.java  | 35 +++++++-------
 .../variantcontext/VariantContextUtils.java   | 16 +++----
 .../utils/genotype/vcf/VCFWriterUnitTest.java |  4 +-
 .../VariantContextBenchmark.java              |  2 +-
 .../VariantContextUtilsUnitTest.java          |  4 +-
 33 files changed, 124 insertions(+), 129 deletions(-)
 rename public/java/src/org/broadinstitute/sting/utils/variantcontext/{GenotypeCollection.java => GenotypesContext.java} (86%)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index c5b8b628a..081f86ab9 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -10,8 +10,6 @@ import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.classloader.PluginManager;
 import org.broadinstitute.sting.utils.codecs.hapmap.RawHapMapFeature;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFHeader;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.util.*;
@@ -195,7 +193,7 @@ public class VariantContextAdaptors {
                     return null; // we weren't given enough reference context to create the VariantContext
                 Byte refBaseForIndel = new Byte(ref.getBases()[index]);
 
-                GenotypeCollection genotypes = null;
+                GenotypesContext genotypes = null;
                 VariantContext vc = new VariantContext(name, dbsnp.getRsID(), dbsnp.getChr(), dbsnp.getStart() - (sawNullAllele ? 1 : 0), dbsnp.getEnd() - (refAllele.isNull() ? 1 : 0), alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, attributes, refBaseForIndel);
                 return vc;
             } else
@@ -316,7 +314,7 @@ public class VariantContextAdaptors {
             String[] samples = hapmap.getSampleIDs();
             String[] genotypeStrings = hapmap.getGenotypes();
 
-            GenotypeCollection genotypes = GenotypeCollection.create(samples.length);
+            GenotypesContext genotypes = GenotypesContext.create(samples.length);
             for ( int i = 0; i < samples.length; i++ ) {
                 // ignore bad genotypes
                 if ( genotypeStrings[i].contains("N") )
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
index c345c8741..4a13fccc6 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
@@ -35,7 +35,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.pileup.ReadBackedExtendedEventPileup;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -55,7 +55,7 @@ public class AlleleBalance extends InfoFieldAnnotation {
         
         if ( !vc.isBiallelic() )
             return null;
-        final GenotypeCollection genotypes = vc.getGenotypes();
+        final GenotypesContext genotypes = vc.getGenotypes();
         if ( !vc.hasGenotypes() )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
index 164c77d1c..33f2f1dd3 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
@@ -11,7 +11,7 @@ import org.broadinstitute.sting.utils.QualityUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -31,7 +31,7 @@ public class HardyWeinberg extends InfoFieldAnnotation implements WorkInProgress
 
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
 
-        final GenotypeCollection genotypes = vc.getGenotypes();
+        final GenotypesContext genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() < MIN_SAMPLES )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
index 917a75294..640ab036b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/InbreedingCoeff.java
@@ -10,7 +10,7 @@ import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -33,7 +33,7 @@ public class InbreedingCoeff extends InfoFieldAnnotation implements StandardAnno
 
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
 
-        final GenotypeCollection genotypes = vc.getGenotypes();
+        final GenotypesContext genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() < MIN_SAMPLES )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
index 3a1f2cc87..0653b6015 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
@@ -9,7 +9,7 @@ import org.broadinstitute.sting.gatk.walkers.annotator.interfaces.StandardAnnota
 import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLineType;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFInfoHeaderLine;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Arrays;
@@ -29,7 +29,7 @@ public class QualByDepth extends InfoFieldAnnotation implements StandardAnnotati
         if ( stratifiedContexts.size() == 0 )
             return null;
 
-        final GenotypeCollection genotypes = vc.getGenotypes();
+        final GenotypesContext genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() == 0 )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
index 97e014373..ebf33496f 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
@@ -13,7 +13,7 @@ import org.broadinstitute.sting.utils.collections.Pair;
 import org.broadinstitute.sting.utils.pileup.PileupElement;
 import org.broadinstitute.sting.utils.pileup.ReadBackedPileup;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.ArrayList;
@@ -33,7 +33,7 @@ public abstract class RankSumTest extends InfoFieldAnnotation implements Standar
         if ( stratifiedContexts.size() == 0 )
             return null;
          
-        final GenotypeCollection genotypes = vc.getGenotypes();
+        final GenotypesContext genotypes = vc.getGenotypes();
         if ( genotypes == null || genotypes.size() == 0 )
             return null;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
index 48fcdec10..9f0353eb9 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
@@ -34,7 +34,7 @@ import org.broadinstitute.sting.gatk.walkers.annotator.interfaces.*;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.*;
@@ -225,11 +225,11 @@ public class VariantAnnotatorEngine {
         }
     }
 
-    private GenotypeCollection annotateGenotypes(RefMetaDataTracker tracker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
+    private GenotypesContext annotateGenotypes(RefMetaDataTracker tracker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
         if ( requestedGenotypeAnnotations.size() == 0 )
             return vc.getGenotypes();
 
-        GenotypeCollection genotypes = GenotypeCollection.create(vc.getNSamples());
+        GenotypesContext genotypes = GenotypesContext.create(vc.getNSamples());
         for ( final Genotype genotype : vc.getGenotypes() ) {
             AlignmentContext context = stratifiedContexts.get(genotype.getSampleName());
             if ( context == null ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index 297203aec..649b7621b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -187,7 +187,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         byte refByte = ref.getBase();
 
         // make new Genotypes based on Beagle results
-        GenotypeCollection genotypes = GenotypeCollection.create(vc_input.getGenotypes().size());
+        GenotypesContext genotypes = GenotypesContext.create(vc_input.getGenotypes().size());
 
         // for each genotype, create a new object with Beagle information on it
 
@@ -196,7 +196,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         Double alleleFrequencyH = 0.0;
         int beagleVarCounts = 0;
 
-        GenotypeCollection hapmapGenotypes = null;
+        GenotypesContext hapmapGenotypes = null;
 
         if (vc_comp != null) {
             hapmapGenotypes = vc_comp.getGenotypes();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
index f7a84ee08..1d6eb4b64 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
@@ -242,8 +242,8 @@ public class ProduceBeagleInputWalker extends RodWalker<Integer, Integer> {
         }
         if ( markers != null ) markers.append("\n");
 
-        GenotypeCollection preferredGenotypes = preferredVC.getGenotypes();
-        GenotypeCollection otherGenotypes = goodSite(otherVC) ? otherVC.getGenotypes() : null;
+        GenotypesContext preferredGenotypes = preferredVC.getGenotypes();
+        GenotypesContext otherGenotypes = goodSite(otherVC) ? otherVC.getGenotypes() : null;
         for ( String sample : samples ) {
             boolean isMaleOnChrX = CHECK_IS_MALE_ON_CHR_X && getSample(sample).getGender() == Gender.MALE;
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
index 6f482b6f2..409e180ae 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
@@ -37,7 +37,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
@@ -283,11 +283,11 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
         VariantContext vc = context.getVariantContext();
 
         // make new Genotypes based on filters
-        GenotypeCollection genotypes;
+        GenotypesContext genotypes;
         if ( genotypeFilterExps.size() == 0 ) {
             genotypes = null;
         } else {
-            genotypes = GenotypeCollection.create(vc.getGenotypes().size());
+            genotypes = GenotypesContext.create(vc.getGenotypes().size());
 
             // for each genotype, check filters then create a new object
             for ( final Genotype g : vc.getGenotypes() ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
index b81c1d4c3..a8ce98945 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/AlleleFrequencyCalculationModel.java
@@ -27,13 +27,11 @@ package org.broadinstitute.sting.gatk.walkers.genotyper;
 
 import org.apache.log4j.Logger;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
 import java.util.List;
-import java.util.Map;
 
 
 /**
@@ -69,7 +67,7 @@ public abstract class AlleleFrequencyCalculationModel implements Cloneable {
      * @param log10AlleleFrequencyPriors      priors
      * @param log10AlleleFrequencyPosteriors  array (pre-allocated) to store results
      */
-    protected abstract void getLog10PNonRef(GenotypeCollection GLs,  List<Allele> Alleles,
+    protected abstract void getLog10PNonRef(GenotypesContext GLs,  List<Allele> Alleles,
                                             double[] log10AlleleFrequencyPriors,
                                             double[] log10AlleleFrequencyPosteriors);
 
@@ -81,7 +79,7 @@ public abstract class AlleleFrequencyCalculationModel implements Cloneable {
      *
      * @return calls
      */
-    protected abstract GenotypeCollection assignGenotypes(VariantContext vc,
+    protected abstract GenotypesContext assignGenotypes(VariantContext vc,
                                                    double[] log10AlleleFrequencyPosteriors,
                                                    int AFofMaxLikelihood);
 }
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index f0c73cd5f..980088305 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -31,7 +31,7 @@ import org.broadinstitute.sting.utils.Utils;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.PrintStream;
@@ -50,7 +50,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
         super(UAC, N, logger, verboseWriter);
     }
 
-    public void getLog10PNonRef(GenotypeCollection GLs, List<Allele> alleles,
+    public void getLog10PNonRef(GenotypesContext GLs, List<Allele> alleles,
                                 double[] log10AlleleFrequencyPriors,
                                 double[] log10AlleleFrequencyPosteriors) {
         final int numAlleles = alleles.size();
@@ -94,7 +94,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
         }
     }
 
-    private static final ArrayList<double[]> getGLs(GenotypeCollection GLs) {
+    private static final ArrayList<double[]> getGLs(GenotypesContext GLs) {
         ArrayList<double[]> genotypeLikelihoods = new ArrayList<double[]>();
 
         genotypeLikelihoods.add(new double[]{0.0,0.0,0.0}); // dummy
@@ -154,7 +154,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
         }
     }
 
-    public int linearExact(GenotypeCollection GLs,
+    public int linearExact(GenotypesContext GLs,
                            double[] log10AlleleFrequencyPriors,
                            double[] log10AlleleFrequencyPosteriors, int idxAA, int idxAB, int idxBB) {
         final ArrayList<double[]> genotypeLikelihoods = getGLs(GLs);
@@ -267,14 +267,14 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
      *
      * @return calls
      */
-    public GenotypeCollection assignGenotypes(VariantContext vc,
+    public GenotypesContext assignGenotypes(VariantContext vc,
                                        double[] log10AlleleFrequencyPosteriors,
                                        int AFofMaxLikelihood) {
         if ( !vc.isVariant() )
             throw new UserException("The VCF record passed in does not contain an ALT allele at " + vc.getChr() + ":" + vc.getStart());
 
 
-        GenotypeCollection GLs = vc.getGenotypes();
+        GenotypesContext GLs = vc.getGenotypes();
         double[][] pathMetricArray = new double[GLs.size()+1][AFofMaxLikelihood+1];
         int[][] tracebackArray = new int[GLs.size()+1][AFofMaxLikelihood+1];
 
@@ -341,7 +341,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
             }
         }
 
-        GenotypeCollection calls = GenotypeCollection.create();
+        GenotypesContext calls = GenotypesContext.create();
 
         int startIdx = AFofMaxLikelihood;
         for (int k = sampleIdx; k > 0; k--) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
index 00317eec6..6dc31edb8 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
@@ -36,7 +36,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
@@ -129,7 +129,7 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
             return null;
 
         VariantContext variantVC = null;
-        GenotypeCollection genotypes = GenotypeCollection.create();
+        GenotypesContext genotypes = GenotypesContext.create();
         for ( VariantContext vc : VCs ) {
             if ( variantVC == null && vc.isVariant() )
                 variantVC = vc;
@@ -143,8 +143,8 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
         return new VariantContext("VCwithGLs", VCFConstants.EMPTY_ID_FIELD, variantVC.getChr(), variantVC.getStart(), variantVC.getEnd(), variantVC.getAlleles(), genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, null);
     }
 
-    private static GenotypeCollection getGenotypesWithGLs(GenotypeCollection genotypes) {
-        GenotypeCollection genotypesWithGLs = GenotypeCollection.create(genotypes.size());
+    private static GenotypesContext getGenotypesWithGLs(GenotypesContext genotypes) {
+        GenotypesContext genotypesWithGLs = GenotypesContext.create(genotypes.size());
         for ( final Genotype g : genotypes ) {
             if ( g.hasLikelihoods() && g.getLikelihoods().getAsVector() != null )
                 genotypesWithGLs.add(g);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
index 4f87f5eb0..5692c2525 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
@@ -265,7 +265,7 @@ public class UnifiedGenotyperEngine {
         alleles.add(refAllele);
         boolean addedAltAlleles = false;
 
-        GenotypeCollection genotypes = GenotypeCollection.create();
+        GenotypesContext genotypes = GenotypesContext.create();
         for ( MultiallelicGenotypeLikelihoods GL : GLs.values() ) {
             if ( !addedAltAlleles ) {
                 addedAltAlleles = true;
@@ -354,7 +354,7 @@ public class UnifiedGenotyperEngine {
         }
 
         // create the genotypes
-        GenotypeCollection genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
+        GenotypesContext genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
 
         // print out stats if we have a writer
         if ( verboseWriter != null )
@@ -491,7 +491,7 @@ public class UnifiedGenotyperEngine {
         }
 
         // create the genotypes
-        GenotypeCollection genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
+        GenotypesContext genotypes = afcm.get().assignGenotypes(vc, log10AlleleFrequencyPosteriors.get(), bestAFguess);
 
         // *** note that calculating strand bias involves overwriting data structures, so we do that last
         HashMap<String, Object> attributes = new HashMap<String, Object>();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
index df1d081c6..e3dc59b19 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
@@ -60,7 +60,7 @@ import org.broadinstitute.sting.utils.sam.AlignmentUtils;
 import org.broadinstitute.sting.utils.sam.GATKSAMRecord;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -1058,7 +1058,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
             stop += event_length;
         }
 
-        GenotypeCollection genotypes = GenotypeCollection.create();
+        GenotypesContext genotypes = GenotypesContext.create();
         for ( String sample : normalSamples ) {
 
             Map<String,Object> attrs = call.makeStatsAttributes(null);
@@ -1147,7 +1147,7 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
         homRefAlleles.add( alleles.get(0));
         homRefAlleles.add( alleles.get(0));
 
-        GenotypeCollection genotypes = GenotypeCollection.create();
+        GenotypesContext genotypes = GenotypesContext.create();
 
         for ( String sample : normalSamples ) {
             genotypes.add(new Genotype(sample, homRefN ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsNormal,false));
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
index 2a3e353ef..0b28459d4 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
@@ -293,7 +293,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
         if (tracker != null) {
             VariantContext vc = tracker.getFirstValue(variantCollection.variants, context.getLocation());
 
-            GenotypeCollection genotypeCollection = GenotypeCollection.create(vc.getGenotypes().size());
+            GenotypesContext genotypesContext = GenotypesContext.create(vc.getGenotypes().size());
 
             for (Trio trio : trios) {
                 Genotype mother = vc.getGenotype(trio.getMother());
@@ -306,10 +306,10 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
                 Genotype phasedFather = trioGenotypes.get(1);
                 Genotype phasedChild = trioGenotypes.get(2);
 
-                genotypeCollection.add(phasedMother, phasedFather, phasedChild);
+                genotypesContext.add(phasedMother, phasedFather, phasedChild);
             }
 
-            VariantContext newvc = VariantContext.modifyGenotypes(vc, genotypeCollection);
+            VariantContext newvc = VariantContext.modifyGenotypes(vc, genotypesContext);
 
             vcfWriter.add(newvc);
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
index ce35baf15..fddef5129 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
@@ -88,7 +88,7 @@ class PhasingUtils {
         }
         MergedAllelesData mergeData = new MergedAllelesData(intermediateBases, vc1, vc2); // ensures that the reference allele is added
 
-        GenotypeCollection mergedGenotypes = GenotypeCollection.create();
+        GenotypesContext mergedGenotypes = GenotypesContext.create();
         for (final Genotype gt1 : vc1.getGenotypes()) {
             Genotype gt2 = vc2.getGenotype(gt1.getSampleName());
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index f2d870068..155b37af2 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -352,7 +352,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         UnfinishedVariantContext uvc = uvr.unfinishedVariant;
 
         // Perform per-sample phasing:
-        GenotypeCollection sampGenotypes = vc.getGenotypes();
+        GenotypesContext sampGenotypes = vc.getGenotypes();
         Map<String, PhaseCounts> samplePhaseStats = new TreeMap<String, PhaseCounts>();
         for (final Genotype gt : sampGenotypes) {
             String samp = gt.getSampleName();
@@ -1122,7 +1122,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         private int start;
         private int stop;
         private Collection<Allele> alleles;
-        private GenotypeCollection genotypes;
+        private GenotypesContext genotypes;
         private double negLog10PError;
         private Set<String> filters;
         private Map<String, Object> attributes;
@@ -1135,7 +1135,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
             this.start = vc.getStart();
             this.stop = vc.getEnd();
             this.alleles = vc.getAlleles();
-            this.genotypes = GenotypeCollection.copy(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
+            this.genotypes = GenotypesContext.copy(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
             this.negLog10PError = vc.getNegLog10PError();
             this.filters = vc.filtersWereApplied() ? vc.getFilters() : null;
             this.attributes = new HashMap<String, Object>(vc.getAttributes());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
index 08d62154d..ea12ada48 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypePhasingEvaluator.java
@@ -14,7 +14,7 @@ import org.broadinstitute.sting.gatk.walkers.varianteval.util.TableType;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.HashMap;
@@ -92,13 +92,13 @@ public class GenotypePhasingEvaluator extends VariantEvaluator {
 
         Set<String> allSamples = new HashSet<String>();
 
-        GenotypeCollection compSampGenotypes = null;
+        GenotypesContext compSampGenotypes = null;
         if (isRelevantToPhasing(comp)) {
             allSamples.addAll(comp.getSampleNames());
             compSampGenotypes = comp.getGenotypes();
         }
 
-        GenotypeCollection evalSampGenotypes = null;
+        GenotypesContext evalSampGenotypes = null;
         if (isRelevantToPhasing(eval)) {
             allSamples.addAll(eval.getSampleNames());
             evalSampGenotypes = eval.getGenotypes();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
index 71e475fe0..4b3271ba6 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
@@ -40,7 +40,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.sam.AlignmentUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.*;
@@ -211,7 +211,7 @@ public class LeftAlignVariants extends RodWalker<Integer, Integer> {
         }
 
         // create new Genotype objects
-        GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
+        GenotypesContext newGenotypes = GenotypesContext.create(vc.getNSamples());
         for ( final Genotype genotype : vc.getGenotypes() ) {
             List<Allele> newAlleles = new ArrayList<Allele>();
             for ( Allele allele : genotype.getAlleles() ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index 6fec0fac2..7f6e605e7 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -556,7 +556,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
             return (compVCs == null || compVCs.isEmpty());
 
         // check if we find it in the variant rod
-        GenotypeCollection genotypes = vc.getGenotypes(samples);
+        GenotypesContext genotypes = vc.getGenotypes(samples);
         for (final Genotype g : genotypes) {
             if (sampleHasVariant(g)) {
                 // There is a variant called (or filtered with not exclude filtered option set) that is not HomRef for at least one of the samples.
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
index 89322e9f9..78cfde1bd 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
@@ -128,7 +128,7 @@ public class VariantsToVCF extends RodWalker<Integer, Integer> {
             // set the appropriate sample name if necessary
             if ( sampleName != null && vc.hasGenotypes() && vc.hasGenotype(variants.getName()) ) {
                 Genotype g = Genotype.modifyName(vc.getGenotype(variants.getName()), sampleName);
-                GenotypeCollection genotypes = GenotypeCollection.create(g);
+                GenotypesContext genotypes = GenotypesContext.create(g);
                 vc = VariantContext.modifyGenotypes(vc, genotypes);
             }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index 816863b5e..725cc8109 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -11,7 +11,7 @@ import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -76,7 +76,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public abstract GenotypeCollection createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+    public abstract GenotypesContext createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
 
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
index 4d6f26e87..971400ca0 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
@@ -5,7 +5,7 @@ import org.broad.tribble.readers.LineReader;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.File;
@@ -118,13 +118,13 @@ public class VCF3Codec extends AbstractVCFCodec {
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public GenotypeCollection createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+    public GenotypesContext createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
         if (genotypeParts == null)
             genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
 
         int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
 
-        GenotypeCollection genotypes = GenotypeCollection.create(nParts);
+        GenotypesContext genotypes = GenotypesContext.create(nParts);
 
         // get the format keys
         int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
index 696b35050..53b3d5fd4 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
@@ -5,7 +5,7 @@ import org.broad.tribble.readers.LineReader;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.File;
@@ -145,13 +145,13 @@ public class VCFCodec extends AbstractVCFCodec {
      * @param alleles the list of alleles
      * @return a mapping of sample name to genotype object
      */
-    public GenotypeCollection createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+    public GenotypesContext createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
         if (genotypeParts == null)
             genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
 
         int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
 
-        GenotypeCollection genotypes = GenotypeCollection.create(nParts);
+        GenotypesContext genotypes = GenotypesContext.create(nParts);
 
         // get the format keys
         int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
index 86dd5d4f7..8903a176a 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
@@ -1,7 +1,7 @@
 package org.broadinstitute.sting.utils.codecs.vcf;
 
 import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 
 import java.util.List;
 
@@ -19,6 +19,6 @@ public interface VCFParser {
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public GenotypeCollection createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+    public GenotypesContext createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
 
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
index 20cadc469..b8672a7bd 100644
--- a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
+++ b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
@@ -29,7 +29,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.io.*;
@@ -147,16 +147,16 @@ public class GCF {
         Map<String, Object> attributes = new HashMap<String, Object>();
         attributes.put("INFO", info);
         Byte refPadByte = refPad == 0 ? null : refPad;
-        GenotypeCollection genotypes = decodeGenotypes(header);
+        GenotypesContext genotypes = decodeGenotypes(header);
 
         return new VariantContext(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleleMap, genotypes, negLog10PError, filters, attributes, refPadByte);
     }
 
-    private GenotypeCollection decodeGenotypes(final GCFHeader header) {
+    private GenotypesContext decodeGenotypes(final GCFHeader header) {
         if ( genotypes.isEmpty() )
             return VariantContext.NO_GENOTYPES;
         else {
-            GenotypeCollection map = GenotypeCollection.create(genotypes.size());
+            GenotypesContext map = GenotypesContext.create(genotypes.size());
 
             for ( int i = 0; i < genotypes.size(); i++ ) {
                 final String sampleName = header.getSample(i);
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
similarity index 86%
rename from public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
rename to public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 4dbc23e63..3b2de4769 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeCollection.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -29,9 +29,9 @@ import java.util.*;
 /**
  *
  */
-public class GenotypeCollection implements List<Genotype> {
-    public final static GenotypeCollection NO_GENOTYPES =
-            new GenotypeCollection(new ArrayList<Genotype>(0), new HashMap<String, Integer>(0), new HashSet<String>(0), true);
+public class GenotypesContext implements List<Genotype> {
+    public final static GenotypesContext NO_GENOTYPES =
+            new GenotypesContext(new ArrayList<Genotype>(0), new HashMap<String, Integer>(0), new HashSet<String>(0), true);
 
     Set<String> sampleNamesInOrder = null;
     Map<String, Integer> sampleNameToOffset = null;
@@ -45,25 +45,25 @@ public class GenotypeCollection implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
-    private GenotypeCollection() {
+    private GenotypesContext() {
         this(10, false);
     }
 
-    private GenotypeCollection(final int n, final boolean immutable) {
+    private GenotypesContext(final int n, final boolean immutable) {
         this(new ArrayList<Genotype>(n), immutable);
     }
 
-    private GenotypeCollection(final ArrayList<Genotype> genotypes, final boolean immutable) {
+    private GenotypesContext(final ArrayList<Genotype> genotypes, final boolean immutable) {
         this.genotypes = genotypes;
         this.immutable = immutable;
         this.sampleNameToOffset = null;
         this.cacheIsInvalid = true;
     }
 
-    private GenotypeCollection(final ArrayList<Genotype> genotypes,
-                               final Map<String, Integer> sampleNameToOffset,
-                               final Set<String> sampleNamesInOrder,
-                               final boolean immutable) {
+    private GenotypesContext(final ArrayList<Genotype> genotypes,
+                             final Map<String, Integer> sampleNameToOffset,
+                             final Set<String> sampleNamesInOrder,
+                             final boolean immutable) {
         this.genotypes = genotypes;
         this.immutable = immutable;
         this.sampleNameToOffset = sampleNameToOffset;
@@ -77,27 +77,27 @@ public class GenotypeCollection implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
-    public static final GenotypeCollection create() {
-        return new GenotypeCollection();
+    public static final GenotypesContext create() {
+        return new GenotypesContext();
     }
 
-    public static final GenotypeCollection create(final int nGenotypes) {
-        return new GenotypeCollection(nGenotypes, false);
+    public static final GenotypesContext create(final int nGenotypes) {
+        return new GenotypesContext(nGenotypes, false);
     }
 
-    public static final GenotypeCollection create(final ArrayList<Genotype> genotypes) {
-        return genotypes == null ? NO_GENOTYPES : new GenotypeCollection(genotypes, false);
+    public static final GenotypesContext create(final ArrayList<Genotype> genotypes) {
+        return genotypes == null ? NO_GENOTYPES : new GenotypesContext(genotypes, false);
     }
 
-    public static final GenotypeCollection create(final Genotype... genotypes) {
-        return new GenotypeCollection(new ArrayList<Genotype>(Arrays.asList(genotypes)), false);
+    public static final GenotypesContext create(final Genotype... genotypes) {
+        return new GenotypesContext(new ArrayList<Genotype>(Arrays.asList(genotypes)), false);
     }
 
-    public static final GenotypeCollection copy(final GenotypeCollection toCopy) {
+    public static final GenotypesContext copy(final GenotypesContext toCopy) {
         return create(new ArrayList<Genotype>(toCopy.genotypes));
     }
 
-    public static final GenotypeCollection copy(final Collection<Genotype> toCopy) {
+    public static final GenotypesContext copy(final Collection<Genotype> toCopy) {
         return toCopy == null ? NO_GENOTYPES : create(new ArrayList<Genotype>(toCopy));
     }
 
@@ -123,7 +123,7 @@ public class GenotypeCollection implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
-    public final GenotypeCollection immutable() {
+    public final GenotypesContext immutable() {
         this.genotypes = Collections.unmodifiableList(genotypes);
         immutable = true;
         return this;
@@ -369,17 +369,17 @@ public class GenotypeCollection implements List<Genotype> {
         return getSampleNames().containsAll(samples);
     }
 
-    public GenotypeCollection subsetToSamples( final Collection<String> samples ) {
+    public GenotypesContext subsetToSamples( final Collection<String> samples ) {
         return subsetToSamples(new HashSet<String>(samples));
     }
 
-    public GenotypeCollection subsetToSamples( final Set<String> samples ) {
+    public GenotypesContext subsetToSamples( final Set<String> samples ) {
         if ( samples.size() == genotypes.size() )
             return this;
         else if ( samples.isEmpty() )
             return NO_GENOTYPES;
         else {
-            GenotypeCollection subset = create(samples.size());
+            GenotypesContext subset = create(samples.size());
             for ( final Genotype g : genotypes ) {
                 if ( samples.contains(g.getSampleName()) ) {
                     subset.add(g);
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index d0f88e2ec..0a193f59a 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -7,7 +7,6 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFParser;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 
-import java.lang.reflect.Array;
 import java.util.*;
 
 /**
@@ -188,12 +187,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     final protected List<Allele> alleles;
 
     /** A mapping from sampleName -> genotype objects for all genotypes associated with this context */
-    protected GenotypeCollection genotypes = null;
+    protected GenotypesContext genotypes = null;
 
     /** Counts for each of the possible Genotype types in this context */
     protected int[] genotypeCounts = null;
 
-    public final static GenotypeCollection NO_GENOTYPES = GenotypeCollection.NO_GENOTYPES;
+    public final static GenotypesContext NO_GENOTYPES = GenotypesContext.NO_GENOTYPES;
 
     // a fast cached access point to the ref / alt alleles for biallelic case
     private Allele REF = null;
@@ -226,12 +225,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      */
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
         this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, true);
     }
 
     @Deprecated
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
         this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel);
     }
 
@@ -249,12 +248,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      */
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, true);
     }
 
     @Deprecated
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypeCollection genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
     }
 
@@ -299,14 +298,14 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, ID, contig, start, stop, alleles,
-                GenotypeCollection.copy(genotypes),
+                GenotypesContext.copy(genotypes),
                 negLog10PError, filters, attributes, null, false, true);
     }
 
     @Deprecated
     public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
         this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles,
-                GenotypeCollection.copy(genotypes),
+                GenotypesContext.copy(genotypes),
                 negLog10PError, filters, attributes);
     }
 
@@ -374,7 +373,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     private VariantContext(String source, String ID,
                            String contig, long start, long stop,
-                           Collection<Allele> alleles, GenotypeCollection genotypes,
+                           Collection<Allele> alleles, GenotypesContext genotypes,
                            double negLog10PError, Set<String> filters, Map<String, Object> attributes,
                            Byte referenceBaseForIndel, boolean genotypesAreUnparsed,
                            boolean performValidation ) {
@@ -445,7 +444,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    public static VariantContext modifyGenotypes(VariantContext vc, GenotypeCollection genotypes) {
+    public static VariantContext modifyGenotypes(VariantContext vc, GenotypesContext genotypes) {
         VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), vc.getReferenceBaseForIndel(), false, false);
         modifiedVC.validateGenotypes();
         return modifiedVC;
@@ -544,7 +543,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
 
     public VariantContext subContextFromSamples(Set<String> sampleNames, Collection<Allele> alleles) {
         loadGenotypes();
-        GenotypeCollection newGenotypes = genotypes.subsetToSamples(sampleNames);
+        GenotypesContext newGenotypes = genotypes.subsetToSamples(sampleNames);
         return new VariantContext(getSource(), getID(), contig, start, stop, alleles,
                 newGenotypes,
                 getNegLog10PError(),
@@ -555,7 +554,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
 
     public VariantContext subContextFromSamples(Set<String> sampleNames) {
         loadGenotypes();
-        GenotypeCollection newGenotypes = genotypes.subsetToSamples(sampleNames);
+        GenotypesContext newGenotypes = genotypes.subsetToSamples(sampleNames);
         return new VariantContext(getSource(), getID(), contig, start, stop, allelesOfGenotypes(newGenotypes),
                 newGenotypes,
                 getNegLog10PError(),
@@ -981,7 +980,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     /**
      * @return set of all Genotypes associated with this context
      */
-    public GenotypeCollection getGenotypes() {
+    public GenotypesContext getGenotypes() {
         loadGenotypes();
         return genotypes;
     }
@@ -999,7 +998,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
-    public GenotypeCollection getGenotypes(String sampleName) {
+    public GenotypesContext getGenotypes(String sampleName) {
         return getGenotypes(Arrays.asList(sampleName));
     }
 
@@ -1011,11 +1010,11 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
-    public GenotypeCollection getGenotypes(Collection<String> sampleNames) {
+    public GenotypesContext getGenotypes(Collection<String> sampleNames) {
         return getGenotypes().subsetToSamples(sampleNames);
     }
 
-    public GenotypeCollection getGenotypes(Set<String> sampleNames) {
+    public GenotypesContext getGenotypes(Set<String> sampleNames) {
         return getGenotypes().subsetToSamples(sampleNames);
     }
 
@@ -1567,7 +1566,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             }
 
             // now we can recreate new genotypes with trimmed alleles
-            GenotypeCollection genotypes = GenotypeCollection.create(inputVC.getNSamples());
+            GenotypesContext genotypes = GenotypesContext.create(inputVC.getNSamples());
             for (final Genotype g : inputVC.getGenotypes() ) {
                 List<Allele> inAlleles = g.getAlleles();
                 List<Allele> newGenotypeAlleles = new ArrayList<Allele>(g.getAlleles().size());
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 238cf4b3b..b77f606f5 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -294,7 +294,7 @@ public class VariantContextUtils {
         final Map<String, Object> attributes = subsetAttributes(vc.commonInfo, keysToPreserve);
 
         // Genotypes
-        final GenotypeCollection genotypes = GenotypeCollection.create(vc.getNSamples());
+        final GenotypesContext genotypes = GenotypesContext.create(vc.getNSamples());
         for ( final Genotype g : vc.getGenotypes() ) {
             Map<String, Object> genotypeAttributes = subsetAttributes(g.commonInfo, keysToPreserve);
             genotypes.add(new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.getFilters(),
@@ -402,7 +402,7 @@ public class VariantContextUtils {
         double negLog10PError = -1;
         VariantContext vcWithMaxAC = null;
         Set<String> addedSamples = new HashSet<String>(first.getNSamples());
-        GenotypeCollection genotypes = GenotypeCollection.create();
+        GenotypesContext genotypes = GenotypesContext.create();
 
         // counting the number of filtered and variant VCs
         int nFiltered = 0;
@@ -590,7 +590,7 @@ public class VariantContextUtils {
         // nothing to do if we don't need to trim bases
         if (trimVC) {
             List<Allele> alleles = new ArrayList<Allele>();
-            GenotypeCollection genotypes = GenotypeCollection.create();
+            GenotypesContext genotypes = GenotypesContext.create();
 
             // set the reference base for indels in the attributes
             Map<String,Object> attributes = new TreeMap<String,Object>(inputVC.getAttributes());
@@ -644,8 +644,8 @@ public class VariantContextUtils {
         return inputVC;
     }
 
-    public static GenotypeCollection stripPLs(GenotypeCollection genotypes) {
-        GenotypeCollection newGs = GenotypeCollection.create(genotypes.size());
+    public static GenotypesContext stripPLs(GenotypesContext genotypes) {
+        GenotypesContext newGs = GenotypesContext.create(genotypes.size());
 
         for ( final Genotype g : genotypes ) {
             newGs.add(g.hasLikelihoods() ? removePLs(g) : g);
@@ -825,7 +825,7 @@ public class VariantContextUtils {
         }
     }
 
-    private static void mergeGenotypes(GenotypeCollection mergedGenotypes, Set<String> addedSamples, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
+    private static void mergeGenotypes(GenotypesContext mergedGenotypes, Set<String> addedSamples, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
         for ( Genotype g : oneVC.getGenotypes() ) {
             String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
             if ( ! addedSamples.contains(name) ) {
@@ -866,7 +866,7 @@ public class VariantContextUtils {
         }
 
         // create new Genotype objects
-        GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
+        GenotypesContext newGenotypes = GenotypesContext.create(vc.getNSamples());
         for ( final Genotype genotype : vc.getGenotypes() ) {
             List<Allele> newAlleles = new ArrayList<Allele>();
             for ( Allele allele : genotype.getAlleles() ) {
@@ -886,7 +886,7 @@ public class VariantContextUtils {
         if ( allowedAttributes == null )
             return vc;
 
-        GenotypeCollection newGenotypes = GenotypeCollection.create(vc.getNSamples());
+        GenotypesContext newGenotypes = GenotypesContext.create(vc.getNSamples());
         for ( final Genotype genotype : vc.getGenotypes() ) {
             Map<String, Object> attrs = new HashMap<String, Object>();
             for ( Map.Entry<String, Object> attr : genotype.getAttributes().entrySet() ) {
diff --git a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
index ad38b46e3..4b21e09e3 100644
--- a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
@@ -4,7 +4,7 @@ import org.broad.tribble.Tribble;
 import org.broad.tribble.readers.AsciiLineReader;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypeCollection;
+import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
@@ -122,7 +122,7 @@ public class VCFWriterUnitTest extends BaseTest {
         List<Allele> alleles = new ArrayList<Allele>();
         Set<String> filters = null;
         Map<String, Object> attributes = new HashMap<String,Object>();
-        GenotypeCollection genotypes = GenotypeCollection.create(header.getGenotypeSamples().size());
+        GenotypesContext genotypes = GenotypesContext.create(header.getGenotypeSamples().size());
 
         alleles.add(Allele.create("-",true));
         alleles.add(Allele.create("CC",false));
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
index eda74a965..273b8fdf7 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -226,7 +226,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
                         List<VariantContext> toMerge = new ArrayList<VariantContext>();
 
                         for ( int i = 0; i < dupsToMerge; i++ ) {
-                            GenotypeCollection gc = GenotypeCollection.create(vc.getNSamples());
+                            GenotypesContext gc = GenotypesContext.create(vc.getNSamples());
                             for ( final Genotype g : vc.getGenotypes() ) {
                                 gc.add(new Genotype(g.getSampleName()+"_"+i, g));
                             }
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index dbe131a14..805781fe0 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -100,7 +100,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
         int start = 10;
         int stop = start; // alleles.contains(ATC) ? start + 3 : start;
         return new VariantContext(source, VCFConstants.EMPTY_ID_FIELD, "1", start, stop, alleles,
-                GenotypeCollection.copy(genotypes), 1.0, filters, null, Cref.getBases()[0]);
+                GenotypesContext.copy(genotypes), 1.0, filters, null, Cref.getBases()[0]);
     }
 
     // --------------------------------------------------------------------------------
@@ -508,7 +508,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
     }
 
     // necessary to not overload equals for genotypes
-    private void assertGenotypesAreMostlyEqual(GenotypeCollection actual, GenotypeCollection expected) {
+    private void assertGenotypesAreMostlyEqual(GenotypesContext actual, GenotypesContext expected) {
         if (actual == expected) {
             return;
         }

From 7e666777691896edb76fa0eb95ae06ef5e66a50e Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 16 Nov 2011 20:45:15 -0500
Subject: [PATCH 043/113] Expanded UnitTests for VariantContext

Tests for
-- getGenotype and getGenotypes
-- subContextBySample
-- modify routines
---
 .../utils/variantcontext/VariantContext.java  |   2 +-
 .../VariantContextUnitTest.java               | 195 +++++++++++++++++-
 2 files changed, 193 insertions(+), 4 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 0a193f59a..75e3aac58 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -383,8 +383,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         this.stop = stop;
 
         // intern for efficiency.  equals calls will generate NPE if ID is inappropriately passed in as null
+        if ( ID == null || ID.equals("") ) throw new IllegalArgumentException("ID field cannot be the null or the empty string");
         this.ID = ID.equals(VCFConstants.EMPTY_ID_FIELD) ? VCFConstants.EMPTY_ID_FIELD : ID;
-        if ( this.ID.equals("") ) throw new IllegalArgumentException("ID field cannot be the empty string");
 
         if ( !genotypesAreUnparsed && attributes != null ) {
             if ( attributes.containsKey(UNPARSED_GENOTYPE_MAP_KEY) ) {
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index f63209dc1..f2eb2dd57 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -12,6 +12,7 @@ import org.testng.annotations.DataProvider;
 import org.testng.annotations.Test;
 import org.testng.Assert;
 
+import java.lang.reflect.Array;
 import java.util.*;
 
 
@@ -173,7 +174,7 @@ public class VariantContextUnitTest extends BaseTest {
 
     @Test
     public void testCreatingRefVariantContext() {
-         List<Allele> alleles = Arrays.asList(Aref);
+        List<Allele> alleles = Arrays.asList(Aref);
         VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
 
         Assert.assertEquals(vc.getChr(), snpLoc);
@@ -309,6 +310,16 @@ public class VariantContextUnitTest extends BaseTest {
         new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, delLoc, delLocStart, delLocStop, alleles);
     }
 
+    @Test (expectedExceptions = IllegalArgumentException.class)
+    public void testBadID1() {
+        new VariantContext("test", null, delLoc, delLocStart, delLocStop, Arrays.asList(Aref, T));
+    }
+
+    @Test (expectedExceptions = IllegalArgumentException.class)
+    public void testBadID2() {
+        new VariantContext("test", "", delLoc, delLocStart, delLocStop, Arrays.asList(Aref, T));
+    }
+
     @Test
     public void testAccessingSimpleSNPGenotypes() {
         List<Allele> alleles = Arrays.asList(Aref, T);
@@ -423,7 +434,7 @@ public class VariantContextUnitTest extends BaseTest {
     }
 
     @Test
-    public void testVCromGenotypes() {
+    public void testVCFfromGenotypes() {
         List<Allele> alleles = Arrays.asList(Aref, T, del);
         Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
         Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
@@ -479,6 +490,29 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertEquals(0, vc5.getChromosomeCount(Aref));
     }
 
+    public void testGetGenotypeMethods() {
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
+        GenotypesContext gc = GenotypesContext.create(g1, g2, g3);
+        VariantContext vc = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T), gc);
+
+        Assert.assertEquals(vc.getGenotype("AA"), g1);
+        Assert.assertEquals(vc.getGenotype("AT"), g2);
+        Assert.assertEquals(vc.getGenotype("TT"), g3);
+        Assert.assertEquals(vc.getGenotype("CC"), null);
+
+        Assert.assertEquals(vc.getGenotypes(), gc);
+        Assert.assertEquals(vc.getGenotypes(Arrays.asList("AA", "AT")), Arrays.asList(g1, g2));
+        Assert.assertEquals(vc.getGenotypes(Arrays.asList("AA", "TT")), Arrays.asList(g1, g3));
+        Assert.assertEquals(vc.getGenotypes(Arrays.asList("AA", "AT", "TT")), Arrays.asList(g1, g2, g3));
+        Assert.assertEquals(vc.getGenotypes(Arrays.asList("AA", "AT", "CC")), Arrays.asList(g1, g2));
+
+        Assert.assertEquals(vc.getGenotype(0), g1);
+        Assert.assertEquals(vc.getGenotype(1), g2);
+        Assert.assertEquals(vc.getGenotype(2), g3);
+    }
+
     // --------------------------------------------------------------------------------
     //
     // Test allele merging
@@ -545,4 +579,159 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertFalse(vc.hasAllele(missingAllele));
         Assert.assertFalse(vc.hasAllele(missingAllele, true));
     }
-}
+
+    private class SitesAndGenotypesVC extends TestDataProvider {
+        VariantContext vc, copy;
+
+        private SitesAndGenotypesVC(String name, VariantContext original) {
+            super(SitesAndGenotypesVC.class, name);
+            this.vc = original;
+            this.copy = new VariantContext(original);
+        }
+
+        public String toString() {
+            return String.format("%s input=%s", super.toString(), vc);
+        }
+    }
+
+    @DataProvider(name = "SitesAndGenotypesVC")
+    public Object[][] MakeSitesAndGenotypesVCs() {
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
+
+        VariantContext sites = new VariantContext("sites", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T));
+        VariantContext genotypes = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T), Arrays.asList(g1, g2, g3));
+
+        new SitesAndGenotypesVC("sites", sites);
+        new SitesAndGenotypesVC("genotypes", genotypes);
+
+        return SitesAndGenotypesVC.getTests(SitesAndGenotypesVC.class);
+    }
+
+    // --------------------------------------------------------------------------------
+    //
+    // Test modifying routines
+    //
+    // --------------------------------------------------------------------------------
+    @Test(dataProvider = "SitesAndGenotypesVC")
+    public void runModifyVCTests(SitesAndGenotypesVC cfg) {
+        VariantContext modified = VariantContext.modifyLocation(cfg.vc, "chr2", 123, 123);
+        Assert.assertEquals(modified.getChr(), "chr2");
+        Assert.assertEquals(modified.getStart(), 123);
+        Assert.assertEquals(modified.getEnd(), 123);
+
+        modified = VariantContext.modifyID(cfg.vc, "newID");
+        Assert.assertEquals(modified.getID(), "newID");
+
+        Set<String> newFilters = Collections.singleton("newFilter");
+        modified = VariantContext.modifyFilters(cfg.vc, newFilters);
+        Assert.assertEquals(modified.getFilters(), newFilters);
+
+        modified = VariantContext.modifyAttribute(cfg.vc, "AC", 1);
+        Assert.assertEquals(modified.getAttribute("AC"), 1);
+        modified = VariantContext.modifyAttribute(modified, "AC", 2);
+        Assert.assertEquals(modified.getAttribute("AC"), 2);
+        modified = VariantContext.modifyAttributes(modified, null);
+        Assert.assertTrue(modified.getAttributes().isEmpty());
+
+        Genotype g1 = new Genotype("AA2", Arrays.asList(Aref, Aref), 10);
+        Genotype g2 = new Genotype("AT2", Arrays.asList(Aref, T), 10);
+        Genotype g3 = new Genotype("TT2", Arrays.asList(T, T), 10);
+        GenotypesContext gc = GenotypesContext.create(g1,g2,g3);
+        modified = VariantContext.modifyGenotypes(cfg.vc, gc);
+        Assert.assertEquals(modified.getGenotypes(), gc);
+        modified = VariantContext.modifyGenotypes(cfg.vc, null);
+        Assert.assertTrue(modified.getGenotypes().isEmpty());
+
+        // test that original hasn't changed
+        Assert.assertEquals(cfg.vc.getChr(), cfg.copy.getChr());
+        Assert.assertEquals(cfg.vc.getStart(), cfg.copy.getStart());
+        Assert.assertEquals(cfg.vc.getEnd(), cfg.copy.getEnd());
+        Assert.assertEquals(cfg.vc.getAlleles(), cfg.copy.getAlleles());
+        Assert.assertEquals(cfg.vc.getAttributes(), cfg.copy.getAttributes());
+        Assert.assertEquals(cfg.vc.getID(), cfg.copy.getID());
+        Assert.assertEquals(cfg.vc.getGenotypes(), cfg.copy.getGenotypes());
+        Assert.assertEquals(cfg.vc.getNegLog10PError(), cfg.copy.getNegLog10PError());
+        Assert.assertEquals(cfg.vc.getFilters(), cfg.copy.getFilters());
+    }
+
+    // --------------------------------------------------------------------------------
+    //
+    // Test subcontext
+    //
+    // --------------------------------------------------------------------------------
+    private class SubContextTest extends TestDataProvider {
+        Set<String> samples;
+        boolean updateAlleles;
+
+        private SubContextTest(Collection<String> samples, boolean updateAlleles) {
+            super(SubContextTest.class);
+            this.samples = new HashSet<String>(samples);
+            this.updateAlleles = updateAlleles;
+        }
+
+        public String toString() {
+            return String.format("%s samples=%s updateAlleles=%b", super.toString(), samples, updateAlleles);
+        }
+    }
+
+    @DataProvider(name = "SubContextTest")
+    public Object[][] MakeSubContextTest() {
+        for ( boolean updateAlleles : Arrays.asList(true, false)) {
+            new SubContextTest(Collections.<String>emptySet(), updateAlleles);
+            new SubContextTest(Collections.singleton("AA"), updateAlleles);
+            new SubContextTest(Collections.singleton("AT"), updateAlleles);
+            new SubContextTest(Collections.singleton("TT"), updateAlleles);
+            new SubContextTest(Arrays.asList("AA", "AT"), updateAlleles);
+            new SubContextTest(Arrays.asList("AA", "AT", "TT"), updateAlleles);
+        }
+
+        return SubContextTest.getTests(SubContextTest.class);
+    }
+
+    private final static void SubContextTest() {
+    }
+
+    @Test(dataProvider = "SubContextTest")
+    public void runSubContextTest(SubContextTest cfg) {
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
+
+        GenotypesContext gc = GenotypesContext.create(g1, g2, g3);
+        VariantContext vc = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T), gc);
+        VariantContext sub = cfg.updateAlleles ? vc.subContextFromSamples(cfg.samples) : vc.subContextFromSamples(cfg.samples, vc.getAlleles());
+
+        // unchanged attributes should be the same
+        Assert.assertEquals(sub.getChr(), vc.getChr());
+        Assert.assertEquals(sub.getStart(), vc.getStart());
+        Assert.assertEquals(sub.getEnd(), vc.getEnd());
+        Assert.assertEquals(sub.getNegLog10PError(), vc.getNegLog10PError());
+        Assert.assertEquals(sub.getFilters(), vc.getFilters());
+        Assert.assertEquals(sub.getID(), vc.getID());
+        Assert.assertEquals(sub.getReferenceBaseForIndel(), vc.getReferenceBaseForIndel());
+        Assert.assertEquals(sub.getAttributes(), vc.getAttributes());
+
+        Set<Genotype> expectedGenotypes = new HashSet<Genotype>();
+        if ( cfg.samples.contains(g1.getSampleName()) ) expectedGenotypes.add(g1);
+        if ( cfg.samples.contains(g2.getSampleName()) ) expectedGenotypes.add(g2);
+        if ( cfg.samples.contains(g3.getSampleName()) ) expectedGenotypes.add(g3);
+        GenotypesContext expectedGC = GenotypesContext.copy(expectedGenotypes);
+
+        // these values depend on the results of sub
+        if ( cfg.updateAlleles ) {
+            // do the work to see what alleles should be here, and which not
+            Set<Allele> alleles = new HashSet<Allele>();
+            for ( final Genotype g : expectedGC ) alleles.addAll(g.getAlleles());
+            if ( ! alleles.contains(Aref) ) alleles.add(Aref); // always have the reference
+            Assert.assertEquals(new HashSet<Allele>(sub.getAlleles()), alleles);
+        } else {
+            // not updating alleles -- should be the same
+            Assert.assertEquals(sub.getAlleles(), vc.getAlleles());
+        }
+
+        // same sample names => success
+        Assert.assertEquals(sub.getGenotypes().getSampleNames(), expectedGC.getSampleNames());
+    }
+}
\ No newline at end of file

From e7d41d8d334221c12dc89a080a3ec55bb9cc4bfb Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Thu, 17 Nov 2011 12:00:28 -0500
Subject: [PATCH 044/113] Minor cleanup

---
 .../gatk/walkers/variantutils/SelectVariants.java      | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index 609593acc..b92b1cee0 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -24,10 +24,8 @@
 
 package org.broadinstitute.sting.gatk.walkers.variantutils;
 
-import org.apache.poi.hpsf.Variant;
 import org.broadinstitute.sting.commandline.*;
 import org.broadinstitute.sting.gatk.arguments.StandardVariantContextInputArgumentCollection;
-import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.text.XReadLines;
@@ -275,8 +273,8 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
     private double MENDELIAN_VIOLATION_QUAL_THRESHOLD = 0;
 
     /**
-     * Variants are kept in memory to guarantee that exactly n variants will be chosen randomly, so use it only for a reasonable
-     * number of variants.  Use --select_random_fraction for larger numbers of variants.
+     * Variants are kept in memory to guarantee that exactly n variants will be chosen randomly, so make sure you supply the program with enough memory
+     * given your input set.  This option will NOT work well for large callsets; use --select_random_fraction for sets with a large numbers of variants.
      */
     @Argument(fullName="select_random_number", shortName="number", doc="Selects a number of variants at random from the variant track", required=false)
     private int numRandom = 0;
@@ -532,7 +530,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
                     }
                 }
                 if (SELECT_RANDOM_NUMBER) {
-                    randomlyAddVariant(++variantNumber, sub, ref.getBase());
+                    randomlyAddVariant(++variantNumber, sub);
                 }
                 else if (!SELECT_RANDOM_FRACTION || ( GenomeAnalysisEngine.getRandomGenerator().nextDouble() < fractionRandom)) {
                     vcfWriter.add(sub);
@@ -705,7 +703,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
         return sub;
     }
 
-    private void randomlyAddVariant(int rank, VariantContext vc, byte refBase) {
+    private void randomlyAddVariant(int rank, VariantContext vc) {
         if (nVariantsAdded < numRandom)
             variantArray[nVariantsAdded++] = new RandomVariantStructure(vc);
 

From 16a021992bf51bb5bbac5a9ebb8f4206fd4c314c Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Thu, 17 Nov 2011 13:17:53 -0500
Subject: [PATCH 045/113] Updated header description for the INFO and FORMAT DP
 fields to be more accurate.

---
 .../walkers/annotator/DepthOfCoverage.java    |  2 +-
 .../walkers/genotyper/UnifiedGenotyper.java   |  2 +-
 .../VariantAnnotatorIntegrationTest.java      | 22 ++++----
 .../UnifiedGenotyperIntegrationTest.java      | 50 +++++++++----------
 4 files changed, 37 insertions(+), 39 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/DepthOfCoverage.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/DepthOfCoverage.java
index 8098de5b1..ab38b69cd 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/DepthOfCoverage.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/DepthOfCoverage.java
@@ -49,5 +49,5 @@ public class DepthOfCoverage extends InfoFieldAnnotation implements StandardAnno
 
     public List<String> getKeyNames() { return Arrays.asList(VCFConstants.DEPTH_KEY); }
 
-    public List<VCFInfoHeaderLine> getDescriptions() { return Arrays.asList(new VCFInfoHeaderLine(getKeyNames().get(0), 1, VCFHeaderLineType.Integer, "Filtered Depth")); }
+    public List<VCFInfoHeaderLine> getDescriptions() { return Arrays.asList(new VCFInfoHeaderLine(getKeyNames().get(0), 1, VCFHeaderLineType.Integer, "Approximate read depth; some reads may have been filtered")); }
 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyper.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyper.java
index bdd4e2c65..369c2d0c6 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyper.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyper.java
@@ -258,7 +258,7 @@ public class UnifiedGenotyper extends LocusWalker<VariantCallContext, UnifiedGen
         Set<VCFFormatHeaderLine> result = new HashSet<VCFFormatHeaderLine>();
         result.add(new VCFFormatHeaderLine(VCFConstants.GENOTYPE_KEY, 1, VCFHeaderLineType.String, "Genotype"));
         result.add(new VCFFormatHeaderLine(VCFConstants.GENOTYPE_QUALITY_KEY, 1, VCFHeaderLineType.Float, "Genotype Quality"));
-        result.add(new VCFFormatHeaderLine(VCFConstants.DEPTH_KEY, 1, VCFHeaderLineType.Integer, "Read Depth (only filtered reads used for calling)"));
+        result.add(new VCFFormatHeaderLine(VCFConstants.DEPTH_KEY, 1, VCFHeaderLineType.Integer, "Approximate read depth (reads with MQ=255 or with bad mates are filtered)"));
         result.add(new VCFFormatHeaderLine(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, VCFHeaderLineCount.G, VCFHeaderLineType.Integer, "Normalized, Phred-scaled likelihoods for genotypes as defined in the VCF specification"));
 
         return result;
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
index 919e3d9bd..3bfb81dd0 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
@@ -32,7 +32,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testHasAnnotsAsking1() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("8e7de435105499cd71ffc099e268a83e"));
+                Arrays.asList("9beb795536e95954f810835c6058f2ad"));
         executeTest("test file has annotations, asking for annotations, #1", spec);
     }
 
@@ -40,7 +40,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testHasAnnotsAsking2() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample3.vcf -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -L 1:10,000,000-10,050,000", 1,
-                Arrays.asList("64b6804cb1e27826e3a47089349be581"));
+                Arrays.asList("2977bb30c8b84a5f4094fe6090658561"));
         executeTest("test file has annotations, asking for annotations, #2", spec);
     }
 
@@ -64,7 +64,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testNoAnnotsAsking1() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample2empty.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("fd1ffb669800c2e07df1e2719aa38e49"));
+                Arrays.asList("49d989f467b8d6d8f98f7c1b67cd4a05"));
         executeTest("test file doesn't have annotations, asking for annotations, #1", spec);
     }
 
@@ -72,7 +72,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testNoAnnotsAsking2() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample3empty.vcf -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -L 1:10,000,000-10,050,000", 1,
-                Arrays.asList("09f8e840770a9411ff77508e0ed0837f"));
+                Arrays.asList("0948cd1dba7d61f283cc4cf2a7757d92"));
         executeTest("test file doesn't have annotations, asking for annotations, #2", spec);
     }
 
@@ -80,7 +80,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testExcludeAnnotations() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard -XA FisherStrand -XA ReadPosRankSumTest --variant:VCF3 " + validationDataLocation + "vcfexample2empty.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("b49fe03aa4b675db80a9db38a3552c95"));
+                Arrays.asList("33062eccd6eb73bc49440365430454c4"));
         executeTest("test exclude annotations", spec);
     }
 
@@ -88,7 +88,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testOverwritingHeader() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant " + validationDataLocation + "vcfexample4.vcf -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -L 1:10,001,292", 1,
-                Arrays.asList("78d2c19f8107d865970dbaf3e12edd92"));
+                Arrays.asList("062155edec46a8c52243475fbf3a2943"));
         executeTest("test overwriting header", spec);
     }
 
@@ -96,7 +96,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testNoReads() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant " + validationDataLocation + "vcfexample3empty.vcf -L " + validationDataLocation + "vcfexample3empty.vcf", 1,
-                Arrays.asList("16e3a1403fc376320d7c69492cad9345"));
+                Arrays.asList("06635f2dd91b539bfbce9bf7914d8e43"));
         executeTest("not passing it any reads", spec);
     }
 
@@ -104,7 +104,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testDBTagWithDbsnp() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --dbsnp " + b36dbSNP129 + " -G Standard --variant " + validationDataLocation + "vcfexample3empty.vcf -L " + validationDataLocation + "vcfexample3empty.vcf", 1,
-                Arrays.asList("3da8ca2b6bdaf6e92d94a8c77a71313d"));
+                Arrays.asList("820eeba1f6e3a0758a69d937c524a38e"));
         executeTest("getting DB tag with dbSNP", spec);
     }
 
@@ -112,7 +112,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testDBTagWithHapMap() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --comp:H3 " + validationDataLocation + "fakeHM3.vcf -G Standard --variant " + validationDataLocation + "vcfexample3empty.vcf -L " + validationDataLocation + "vcfexample3empty.vcf", 1,
-                Arrays.asList("1bc01c5b3bd0b7aef75230310c3ce688"));
+                Arrays.asList("31cc2ce157dd20771418c08d6b3be1fa"));
         executeTest("getting DB tag with HM3", spec);
     }
 
@@ -120,7 +120,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testUsingExpression() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --resource:foo " + validationDataLocation + "targetAnnotations.vcf -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample3empty.vcf -E foo.AF -L " + validationDataLocation + "vcfexample3empty.vcf", 1,
-                Arrays.asList("ae30a1ac7bfbc3d22a327f8b689cad31"));
+                Arrays.asList("074865f8f8c0ca7bfd58681f396c49e9"));
         executeTest("using expression", spec);
     }
 
@@ -128,7 +128,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testUsingExpressionWithID() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --resource:foo " + validationDataLocation + "targetAnnotations.vcf -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample3empty.vcf -E foo.ID -L " + validationDataLocation + "vcfexample3empty.vcf", 1,
-                Arrays.asList("1b4921085b26cbfe07d53b7c947de1e5"));
+                Arrays.asList("97b26db8135d083566fb585a677fbe8a"));
         executeTest("using expression with ID", spec);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
index b80f214b1..0197f94e5 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
@@ -5,10 +5,8 @@ import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.testng.annotations.Test;
 
-import java.io.File;
 import java.util.Arrays;
 import java.util.HashMap;
-import java.util.List;
 import java.util.Map;
 
 // ********************************************************************************** //
@@ -30,7 +28,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testMultiSamplePilot1() {
         WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -o %s -L 1:10,022,000-10,025,000", 1,
-                Arrays.asList("b27939251539439a382538e507e03507"));
+                Arrays.asList("364a6112e6034571a896d4c68b6ff02a"));
         executeTest("test MultiSample Pilot1", spec);
     }
 
@@ -38,12 +36,12 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testWithAllelesPassedIn() {
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "allelesForUG.vcf -I " + validationDataLocation + "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,025,000", 1,
-                Arrays.asList("8de2602679ffc92388da0b6cb4325ef6"));
+                Arrays.asList("6cce55734ecd1a56c33f0ecba67d1258"));
         executeTest("test MultiSample Pilot2 with alleles passed in", spec1);
 
         WalkerTest.WalkerTestSpec spec2 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " --output_mode EMIT_ALL_SITES --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "allelesForUG.vcf -I " + validationDataLocation + "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,025,000", 1,
-                Arrays.asList("6458f3b8fe4954e2ffc2af972aaab19e"));
+                Arrays.asList("b2a00130a4b6f9a3c31288a236f5d159"));
         executeTest("test MultiSample Pilot2 with alleles passed in and emitting all sites", spec2);
     }
 
@@ -51,7 +49,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testSingleSamplePilot2() {
         WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -o %s -L 1:10,000,000-10,100,000", 1,
-                Arrays.asList("6762b72ae60155ad71738d7c76b80e4b"));
+                Arrays.asList("3ccce5d909f8f128e496f6841836e5f7"));
         executeTest("test SingleSample Pilot2", spec);
     }
 
@@ -61,7 +59,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     //
     // --------------------------------------------------------------------------------------------------------------
 
-    private final static String COMPRESSED_OUTPUT_MD5 = "bc71dba7bbdb23e7d5cc60461fdd897b";
+    private final static String COMPRESSED_OUTPUT_MD5 = "890143b366050e78d6c6ba6b2c6b6864";
 
     @Test
     public void testCompressedOutput() {
@@ -82,7 +80,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
 
         // Note that we need to turn off any randomization for this to work, so no downsampling and no annotations
 
-        String md5 = "b9504e446b9313559c3ed97add7e8dc1";
+        String md5 = "95614280c565ad90f8c000376fef822c";
 
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -dt NONE -G none -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -o %s -L 1:10,000,000-10,075,000", 1,
@@ -113,8 +111,8 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     @Test
     public void testCallingParameters() {
         HashMap<String, String> e = new HashMap<String, String>();
-        e.put( "--min_base_quality_score 26", "bb3f294eab3e2cf52c70e63b23aac5ee" );
-        e.put( "--computeSLOD", "eb34979efaadba1e34bd82bcacf5c722" );
+        e.put( "--min_base_quality_score 26", "7acb1a5aee5fdadb0cc0ea07a212efc6" );
+        e.put( "--computeSLOD", "e9d23a08472e4e27b4f25e844f5bad57" );
 
         for ( Map.Entry<String, String> entry : e.entrySet() ) {
             WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
@@ -127,9 +125,9 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     @Test
     public void testOutputParameter() {
         HashMap<String, String> e = new HashMap<String, String>();
-        e.put( "-sites_only", "d40114aa201aa33ff5f174f15b6b73af" );
-        e.put( "--output_mode EMIT_ALL_CONFIDENT_SITES", "3c681b053fd2280f3c42041d24243752" );
-        e.put( "--output_mode EMIT_ALL_SITES", "eafa6d71c5ecd64dfee5d7a3f60e392e" );
+        e.put( "-sites_only", "44f3b5b40e6ad44486cddfdb7e0bfcd8" );
+        e.put( "--output_mode EMIT_ALL_CONFIDENT_SITES", "94e53320f14c5ff29d62f68d36b46fcd" );
+        e.put( "--output_mode EMIT_ALL_SITES", "73ad1cc41786b12c5f0e6f3e9ec2b728" );
 
         for ( Map.Entry<String, String> entry : e.entrySet() ) {
             WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
@@ -143,12 +141,12 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testConfidence() {
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -o %s -L 1:10,000,000-10,010,000 -stand_call_conf 10 ", 1,
-                Arrays.asList("c71ca370947739cb7d87b59452be7a07"));
+                Arrays.asList("902327e8a45fe585c8dfd1a7c4fcf60f"));
         executeTest("test confidence 1", spec1);
 
         WalkerTest.WalkerTestSpec spec2 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -o %s -L 1:10,000,000-10,010,000 -stand_emit_conf 10 ", 1,
-                Arrays.asList("1c0a599d475cc7d5e745df6e9b6c0d29"));
+                Arrays.asList("9ef66764a0ecfe89c3e4e1a93a69e349"));
         executeTest("test confidence 2", spec2);
     }
 
@@ -160,8 +158,8 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     @Test
     public void testHeterozyosity() {
         HashMap<Double, String> e = new HashMap<Double, String>();
-        e.put( 0.01, "f84da90c310367bd51f2ab6e346fa3d8" );
-        e.put( 1.0 / 1850, "5791e7fef40d4412b6d8f84e0a809c6c" );
+        e.put( 0.01, "46243ecc2b9dc716f48ea280c9bb7e72" );
+        e.put( 1.0 / 1850, "6b2a59dbc76984db6d4d6d6b5ee5d62c" );
 
         for ( Map.Entry<Double, String> entry : e.entrySet() ) {
             WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
@@ -185,7 +183,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                         " -o %s" +
                         " -L 1:10,000,000-10,100,000",
                 1,
-                Arrays.asList("9cc9538ac83770e12bd0830d285bfbd0"));
+                Arrays.asList("f0fbe472f155baf594b1eeb58166edef"));
 
         executeTest(String.format("test multiple technologies"), spec);
     }
@@ -204,7 +202,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                         " -L 1:10,000,000-10,100,000" +
                         " -baq CALCULATE_AS_NECESSARY",
                 1,
-                Arrays.asList("eaf8043edb46dfbe9f97ae03baa797ed"));
+                Arrays.asList("8c87c749a7bb5a76ed8504d4ec254272"));
 
         executeTest(String.format("test calling with BAQ"), spec);
     }
@@ -223,7 +221,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                         " -o %s" +
                         " -L 1:10,000,000-10,500,000",
                 1,
-                Arrays.asList("eeba568272f9b42d5450da75c7cc6d2d"));
+                Arrays.asList("a64d2e65b5927260e4ce0d948760cc5c"));
 
         executeTest(String.format("test indel caller in SLX"), spec);
     }
@@ -238,7 +236,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                         " -minIndelCnt 1" +
                         " -L 1:10,000,000-10,100,000",
                 1,
-                Arrays.asList("5fe98ee853586dc9db58f0bc97daea63"));
+                Arrays.asList("2ad52c2e75b3ffbfd8f03237c444e8e6"));
 
         executeTest(String.format("test indel caller in SLX with low min allele count"), spec);
     }
@@ -251,7 +249,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                          " -o %s" +
                          " -L 1:10,000,000-10,500,000",
                  1,
-                 Arrays.asList("19ff9bd3139480bdf79dcbf117cf2b24"));
+                 Arrays.asList("69107157632714150fc068d412e31939"));
 
          executeTest(String.format("test indel calling, multiple technologies"), spec);
      }
@@ -261,7 +259,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndels + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "indelAllelesForUG.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,100,000", 1,
-                Arrays.asList("118918f2e9e56a3cfc5ccb2856d529c8"));
+                Arrays.asList("84f065e115004e4c9d9d62f1bf6b4f44"));
         executeTest("test MultiSample Pilot2 indels with alleles passed in", spec1);
     }
 
@@ -271,7 +269,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                 baseCommandIndels + " --output_mode EMIT_ALL_SITES --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles "
                         + validationDataLocation + "indelAllelesForUG.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,100,000", 1,
-                Arrays.asList("a20799237accd52c1b8c2ac096309c8f"));
+                Arrays.asList("7ea8372e4074f90ec942f964e1863351"));
         executeTest("test MultiSample Pilot2 indels with alleles passed in and emitting all sites", spec2);
     }
 
@@ -281,7 +279,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec3 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndels + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "ALL.wgs.union_v2.20101123.indels.sites.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,080,000", 1,
-                Arrays.asList("18ef8181157b4ac3eb8492f538467f92"));
+                Arrays.asList("94afa8c011b47af7323c821bf19106b4"));
         executeTest("test MultiSample Pilot2 indels with complicated records", spec3);
     }
 
@@ -290,7 +288,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec4 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndelsb37 + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "ALL.wgs.union_v2_chr20_100_110K.20101123.indels.sites.vcf -I " + validationDataLocation +
                         "phase1_GBR_realigned.chr20.100K-110K.bam -o %s -L 20:100,000-110,000", 1,
-                Arrays.asList("ad884e511a751b05e64db5314314365a"));
+                Arrays.asList("1e02f57fafaa41db71c531eb25e148e1"));
         executeTest("test MultiSample 1000G Phase1 indels with complicated records emitting all sites", spec4);
     }
 

From c50274e02e8bd381a2f7995a77b22f0ac8e0b00b Mon Sep 17 00:00:00 2001
From: Khalid Shakir <kshakir@broadinstitute.org>
Date: Thu, 17 Nov 2011 13:53:46 -0500
Subject: [PATCH 046/113] During flanking interval creation merging overlapping
 flanks so that on scatter the list doesn't accidentally genotype the same
 site twice. Moved flanking interval utilies to IntervalUtils with UnitTests.

---
 .../sting/utils/GenomeLocParser.java          |  50 ++++
 .../sting/utils/interval/IntervalUtils.java   | 119 ++++++++--
 .../sting/utils/GenomeLocParserUnitTest.java  | 104 +++++++-
 .../utils/interval/IntervalUtilsUnitTest.java | 223 +++++++++++++++++-
 .../gatk/WriteFlankingIntervalsFunction.scala |  48 ++++
 .../ipf/intervals/ExpandIntervals.scala       | 135 -----------
 .../ipf/intervals/IntersectIntervals.scala    |  70 ------
 7 files changed, 519 insertions(+), 230 deletions(-)
 create mode 100644 public/scala/src/org/broadinstitute/sting/queue/extensions/gatk/WriteFlankingIntervalsFunction.scala
 delete mode 100755 public/scala/src/org/broadinstitute/sting/queue/library/ipf/intervals/ExpandIntervals.scala
 delete mode 100755 public/scala/src/org/broadinstitute/sting/queue/library/ipf/intervals/IntersectIntervals.scala

diff --git a/public/java/src/org/broadinstitute/sting/utils/GenomeLocParser.java b/public/java/src/org/broadinstitute/sting/utils/GenomeLocParser.java
index e10bcbaa0..8cba183da 100644
--- a/public/java/src/org/broadinstitute/sting/utils/GenomeLocParser.java
+++ b/public/java/src/org/broadinstitute/sting/utils/GenomeLocParser.java
@@ -554,4 +554,54 @@ public class GenomeLocParser {
         return createGenomeLoc(contigName,contig.getSequenceIndex(),1,contig.getSequenceLength(), true);
     }
 
+    /**
+     * Creates a loc to the left (starting at the loc start + 1) of maxBasePairs size.
+     * @param loc The original loc
+     * @param maxBasePairs The maximum number of basePairs
+     * @return The contiguous loc of up to maxBasePairs length or null if the loc is already at the start of the contig.
+     */
+    @Requires({"loc != null", "maxBasePairs > 0"})
+    public GenomeLoc createGenomeLocAtStart(GenomeLoc loc, int maxBasePairs) {
+        if (GenomeLoc.isUnmapped(loc))
+            return null;
+        String contigName = loc.getContig();
+        SAMSequenceRecord contig = contigInfo.getSequence(contigName);
+        int contigIndex = contig.getSequenceIndex();
+
+        int start = loc.getStart() - maxBasePairs;
+        int stop = loc.getStart() - 1;
+
+        if (start < 1)
+            start = 1;
+        if (stop < 1)
+            return null;
+
+        return createGenomeLoc(contigName, contigIndex, start, stop, true);
+    }
+
+    /**
+     * Creates a loc to the right (starting at the loc stop + 1) of maxBasePairs size.
+     * @param loc The original loc
+     * @param maxBasePairs The maximum number of basePairs
+     * @return The contiguous loc of up to maxBasePairs length or null if the loc is already at the end of the contig.
+     */
+    @Requires({"loc != null", "maxBasePairs > 0"})
+    public GenomeLoc createGenomeLocAtStop(GenomeLoc loc, int maxBasePairs) {
+        if (GenomeLoc.isUnmapped(loc))
+            return null;
+        String contigName = loc.getContig();
+        SAMSequenceRecord contig = contigInfo.getSequence(contigName);
+        int contigIndex = contig.getSequenceIndex();
+        int contigLength = contig.getSequenceLength();
+
+        int start = loc.getStop() + 1;
+        int stop = loc.getStop() + maxBasePairs;
+
+        if (start > contigLength)
+            return null;
+        if (stop > contigLength)
+            stop = contigLength;
+
+        return createGenomeLoc(contigName, contigIndex, start, stop, true);
+    }
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/interval/IntervalUtils.java b/public/java/src/org/broadinstitute/sting/utils/interval/IntervalUtils.java
index f0e164c87..159b145a0 100644
--- a/public/java/src/org/broadinstitute/sting/utils/interval/IntervalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/interval/IntervalUtils.java
@@ -233,8 +233,12 @@ public class IntervalUtils {
      *
      * Returns a null string if there are no differences, otherwise returns a string describing the difference
      * (useful for UnitTests).  Assumes both lists are sorted
+     *
+     * @param masterArg sorted master genome locs
+     * @param testArg sorted test genome locs
+     * @return null string if there are no difference, otherwise a string describing the difference
      */
-    public static final String equateIntervals(List<GenomeLoc> masterArg, List<GenomeLoc> testArg) {
+    public static String equateIntervals(List<GenomeLoc> masterArg, List<GenomeLoc> testArg) {
         LinkedList<GenomeLoc> master = new LinkedList<GenomeLoc>(masterArg);
         LinkedList<GenomeLoc> test = new LinkedList<GenomeLoc>(testArg);
 
@@ -317,23 +321,6 @@ public class IntervalUtils {
         return lengths;
     }
 
-    /**
-     * Counts the number of interval files an interval list can be split into using scatterIntervalArguments.
-     * @param locs The genome locs.
-     * @return The maximum number of parts the intervals can be split into.
-     */
-    public static int countContigIntervals(List<GenomeLoc> locs) {
-        int maxFiles = 0;
-        String contig = null;
-        for (GenomeLoc loc: locs) {
-            if (contig == null || !contig.equals(loc.getContig())) {
-                maxFiles++;
-                contig = loc.getContig();
-            }
-        }
-        return maxFiles;
-    }
-
     /**
      * Splits an interval list into multiple files.
      * @param fileHeader The sam file header.
@@ -373,7 +360,6 @@ public class IntervalUtils {
      * @return A list of lists of genome locs, split according to splits
      */
     public static List<List<GenomeLoc>> splitIntervalsToSubLists(List<GenomeLoc> locs, List<Integer> splits) {
-        int locIndex = 1;
         int start = 0;
         List<List<GenomeLoc>> sublists = new ArrayList<List<GenomeLoc>>(splits.size());
         for (Integer stop: splits) {
@@ -465,7 +451,7 @@ public class IntervalUtils {
 
     @Requires({"remaining != null", "!remaining.isEmpty()", "idealSplitSize > 0"})
     @Ensures({"result != null"})
-    final static SplitLocusRecursive splitLocusIntervals1(LinkedList<GenomeLoc> remaining, long idealSplitSize) {
+    static SplitLocusRecursive splitLocusIntervals1(LinkedList<GenomeLoc> remaining, long idealSplitSize) {
         final List<GenomeLoc> split = new ArrayList<GenomeLoc>();
         long size = 0;
 
@@ -579,10 +565,101 @@ public class IntervalUtils {
         }
     }
 
-    public static final long intervalSize(final List<GenomeLoc> locs) {
+    public static long intervalSize(final List<GenomeLoc> locs) {
         long size = 0;
         for ( final GenomeLoc loc : locs )
             size += loc.size();
         return size;
     }
+
+    public static void writeFlankingIntervals(File reference, File inputIntervals, File flankingIntervals, int basePairs) {
+        ReferenceDataSource referenceDataSource = new ReferenceDataSource(reference);
+        GenomeLocParser parser = new GenomeLocParser(referenceDataSource.getReference());
+        List<GenomeLoc> originalList = intervalFileToList(parser, inputIntervals.getAbsolutePath());
+
+        if (originalList.isEmpty())
+            throw new UserException.MalformedFile(inputIntervals, "File contains no intervals");
+
+        List<GenomeLoc> flankingList = getFlankingIntervals(parser, originalList, basePairs);
+
+        if (flankingList.isEmpty())
+            throw new UserException.MalformedFile(inputIntervals, "Unable to produce any flanks for the intervals");
+
+        SAMFileHeader samFileHeader = new SAMFileHeader();
+        samFileHeader.setSequenceDictionary(referenceDataSource.getReference().getSequenceDictionary());
+        IntervalList intervalList = new IntervalList(samFileHeader);
+        int i = 0;
+        for (GenomeLoc loc: flankingList)
+            intervalList.add(toInterval(loc, ++i));
+        intervalList.write(flankingIntervals);
+    }
+
+    /**
+     * Returns a list of intervals between the passed int locs. Does not extend UNMAPPED locs.
+     * @param parser A genome loc parser for creating the new intervals
+     * @param locs Original genome locs
+     * @param basePairs Number of base pairs on each side of loc
+     * @return The list of intervals between the locs
+     */
+    public static List<GenomeLoc> getFlankingIntervals(final GenomeLocParser parser, final List<GenomeLoc> locs, final int basePairs) {
+        List<GenomeLoc> sorted = sortAndMergeIntervals(parser, locs, IntervalMergingRule.ALL).toList();
+
+        if (sorted.size() == 0)
+            return Collections.emptyList();
+
+        LinkedHashMap<String, List<GenomeLoc>> locsByContig = splitByContig(sorted);
+        List<GenomeLoc> expanded = new ArrayList<GenomeLoc>();
+        for (String contig: locsByContig.keySet()) {
+            List<GenomeLoc> contigLocs = locsByContig.get(contig);
+            int contigLocsSize = contigLocs.size();
+
+            GenomeLoc startLoc, stopLoc;
+
+            // Create loc at start of the list
+            startLoc = parser.createGenomeLocAtStart(contigLocs.get(0), basePairs);
+            if (startLoc != null)
+                expanded.add(startLoc);
+
+            // Create locs between each loc[i] and loc[i+1]
+            for (int i = 0; i < contigLocsSize - 1; i++) {
+                stopLoc = parser.createGenomeLocAtStop(contigLocs.get(i), basePairs);
+                startLoc = parser.createGenomeLocAtStart(contigLocs.get(i + 1), basePairs);
+                if (stopLoc.getStop() + 1 >= startLoc.getStart()) {
+                    // NOTE: This is different than GenomeLoc.merge()
+                    // merge() returns a loc which covers the entire range of stop and start,
+                    // possibly returning positions inside loc(i) or loc(i+1)
+                    // We want to make sure that the start of the stopLoc is used, and the stop of the startLoc
+                    GenomeLoc merged = parser.createGenomeLoc(
+                            stopLoc.getContig(), stopLoc.getStart(), startLoc.getStop());
+                    expanded.add(merged);
+                } else {
+                    expanded.add(stopLoc);
+                    expanded.add(startLoc);
+                }
+            }
+
+            // Create loc at the end of the list
+            stopLoc = parser.createGenomeLocAtStop(contigLocs.get(contigLocsSize - 1), basePairs);
+            if (stopLoc != null)
+                expanded.add(stopLoc);
+        }
+        return expanded;
+    }
+
+    private static LinkedHashMap<String, List<GenomeLoc>> splitByContig(List<GenomeLoc> sorted) {
+        LinkedHashMap<String, List<GenomeLoc>> splits = new LinkedHashMap<String, List<GenomeLoc>>();
+        GenomeLoc last = null;
+        List<GenomeLoc> contigLocs = null;
+        for (GenomeLoc loc: sorted) {
+            if (GenomeLoc.isUnmapped(loc))
+                continue;
+            if (last == null || !last.onSameContig(loc)) {
+                contigLocs = new ArrayList<GenomeLoc>();
+                splits.put(loc.getContig(), contigLocs);
+            }
+            contigLocs.add(loc);
+            last = loc;
+        }
+        return splits;
+    }
 }
diff --git a/public/java/test/org/broadinstitute/sting/utils/GenomeLocParserUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/GenomeLocParserUnitTest.java
index f1f849bf5..e9f138a0e 100644
--- a/public/java/test/org/broadinstitute/sting/utils/GenomeLocParserUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/GenomeLocParserUnitTest.java
@@ -2,7 +2,6 @@ package org.broadinstitute.sting.utils;
 
 
 import net.sf.samtools.SAMFileHeader;
-import net.sf.samtools.SAMSequenceDictionary;
 import org.broadinstitute.sting.BaseTest;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
@@ -11,6 +10,7 @@ import org.broadinstitute.sting.utils.sam.ArtificialSAMUtils;
 import static org.testng.Assert.assertEquals;
 import static org.testng.Assert.assertTrue;
 import org.testng.annotations.BeforeClass;
+import org.testng.annotations.DataProvider;
 import org.testng.annotations.Test;
 
 /**
@@ -36,7 +36,6 @@ public class GenomeLocParserUnitTest extends BaseTest {
 
     @Test
     public void testGetContigIndexValid() {
-        SAMFileHeader header = ArtificialSAMUtils.createArtificialSamHeader(1, 1, 10);
         assertEquals(genomeLocParser.getContigIndex("chr1"), 0); // should be in the reference
     }
 
@@ -67,7 +66,6 @@ public class GenomeLocParserUnitTest extends BaseTest {
 
     @Test
     public void testGetContigInfoKnownContig() {
-        SAMFileHeader header = ArtificialSAMUtils.createArtificialSamHeader(1, 1, 10);
         assertEquals(0, "chr1".compareTo(genomeLocParser.getContigInfo("chr1").getSequenceName())); // should be in the reference
     }
 
@@ -191,4 +189,104 @@ public class GenomeLocParserUnitTest extends BaseTest {
         assertTrue(!genomeLocParser.isValidGenomeLoc("chr1",1,-2)); // bad stop
         assertTrue(!genomeLocParser.isValidGenomeLoc("chr1",10,11)); // bad start, past end
     }
+
+    private static class FlankingGenomeLocTestData extends TestDataProvider {
+        final GenomeLocParser parser;
+        final int basePairs;
+        final GenomeLoc original, flankStart, flankStop;
+
+        private FlankingGenomeLocTestData(String name, GenomeLocParser parser, int basePairs, String original, String flankStart, String flankStop) {
+            super(FlankingGenomeLocTestData.class, name);
+            this.parser = parser;
+            this.basePairs = basePairs;
+            this.original = parse(parser, original);
+            this.flankStart = flankStart == null ? null : parse(parser, flankStart);
+            this.flankStop = flankStop == null ? null : parse(parser, flankStop);
+        }
+
+        private static GenomeLoc parse(GenomeLocParser parser, String str) {
+            return "unmapped".equals(str) ? GenomeLoc.UNMAPPED : parser.parseGenomeLoc(str);
+        }
+    }
+
+    @DataProvider(name = "flankingGenomeLocs")
+    public Object[][] getFlankingGenomeLocs() {
+        int contigLength = 10000;
+        SAMFileHeader header = ArtificialSAMUtils.createArtificialSamHeader(1, 1, contigLength);
+        GenomeLocParser parser = new GenomeLocParser(header.getSequenceDictionary());
+
+        new FlankingGenomeLocTestData("atStartBase1", parser, 1,
+                "chr1:1", null, "chr1:2");
+
+        new FlankingGenomeLocTestData("atStartBase50", parser, 50,
+                "chr1:1", null, "chr1:2-51");
+
+        new FlankingGenomeLocTestData("atStartRange50", parser, 50,
+                "chr1:1-10", null, "chr1:11-60");
+
+        new FlankingGenomeLocTestData("atEndBase1", parser, 1,
+                "chr1:" + contigLength, "chr1:" + (contigLength - 1), null);
+
+        new FlankingGenomeLocTestData("atEndBase50", parser, 50,
+                "chr1:" + contigLength, String.format("chr1:%d-%d", contigLength - 50, contigLength - 1), null);
+
+        new FlankingGenomeLocTestData("atEndRange50", parser, 50,
+                String.format("chr1:%d-%d", contigLength - 10, contigLength),
+                String.format("chr1:%d-%d", contigLength - 60, contigLength - 11),
+                null);
+
+        new FlankingGenomeLocTestData("nearStartBase1", parser, 1,
+                "chr1:2", "chr1:1", "chr1:3");
+
+        new FlankingGenomeLocTestData("nearStartRange50", parser, 50,
+                "chr1:21-30", "chr1:1-20", "chr1:31-80");
+
+        new FlankingGenomeLocTestData("nearEndBase1", parser, 1,
+                "chr1:" + (contigLength - 1), "chr1:" + (contigLength - 2), "chr1:" + contigLength);
+
+        new FlankingGenomeLocTestData("nearEndRange50", parser, 50,
+                String.format("chr1:%d-%d", contigLength - 30, contigLength - 21),
+                String.format("chr1:%d-%d", contigLength - 80, contigLength - 31),
+                String.format("chr1:%d-%d", contigLength - 20, contigLength));
+
+        new FlankingGenomeLocTestData("beyondStartBase1", parser, 1,
+                "chr1:3", "chr1:2", "chr1:4");
+
+        new FlankingGenomeLocTestData("beyondStartRange50", parser, 50,
+                "chr1:101-200", "chr1:51-100", "chr1:201-250");
+
+        new FlankingGenomeLocTestData("beyondEndBase1", parser, 1,
+                "chr1:" + (contigLength - 3),
+                "chr1:" + (contigLength - 4),
+                "chr1:" + (contigLength - 2));
+
+        new FlankingGenomeLocTestData("beyondEndRange50", parser, 50,
+                String.format("chr1:%d-%d", contigLength - 200, contigLength - 101),
+                String.format("chr1:%d-%d", contigLength - 250, contigLength - 201),
+                String.format("chr1:%d-%d", contigLength - 100, contigLength - 51));
+
+        new FlankingGenomeLocTestData("unmapped", parser, 50,
+                "unmapped", null, null);
+
+        new FlankingGenomeLocTestData("fullContig", parser, 50,
+                "chr1", null, null);
+
+        return FlankingGenomeLocTestData.getTests(FlankingGenomeLocTestData.class);
+    }
+
+    @Test(dataProvider = "flankingGenomeLocs")
+    public void testCreateGenomeLocAtStart(FlankingGenomeLocTestData data) {
+        GenomeLoc actual = data.parser.createGenomeLocAtStart(data.original, data.basePairs);
+        String description = String.format("%n      name: %s%n  original: %s%n    actual: %s%n  expected: %s%n",
+                data.toString(), data.original, actual, data.flankStart);
+        assertEquals(actual, data.flankStart, description);
+    }
+
+    @Test(dataProvider = "flankingGenomeLocs")
+    public void testCreateGenomeLocAtStop(FlankingGenomeLocTestData data) {
+        GenomeLoc actual = data.parser.createGenomeLocAtStop(data.original, data.basePairs);
+        String description = String.format("%n      name: %s%n  original: %s%n    actual: %s%n  expected: %s%n",
+                data.toString(), data.original, actual, data.flankStop);
+        assertEquals(actual, data.flankStop, description);
+    }
 }
diff --git a/public/java/test/org/broadinstitute/sting/utils/interval/IntervalUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/interval/IntervalUtilsUnitTest.java
index 9c3b905c2..03d33d2c5 100644
--- a/public/java/test/org/broadinstitute/sting/utils/interval/IntervalUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/interval/IntervalUtilsUnitTest.java
@@ -1,8 +1,8 @@
 package org.broadinstitute.sting.utils.interval;
 
 import net.sf.picard.reference.ReferenceSequenceFile;
-import net.sf.picard.util.IntervalUtil;
 import net.sf.samtools.SAMFileHeader;
+import org.apache.commons.io.FileUtils;
 import org.broadinstitute.sting.BaseTest;
 import org.broadinstitute.sting.gatk.datasources.reference.ReferenceDataSource;
 import org.broadinstitute.sting.utils.GenomeLocSortedSet;
@@ -762,4 +762,225 @@ public class IntervalUtilsUnitTest extends BaseTest {
         List<GenomeLoc> merged = IntervalUtils.mergeIntervalLocations(locs, IntervalMergingRule.ALL);
         Assert.assertEquals(merged.size(), 1);
     }
+
+    /*
+    Split into tests that can be written to files and tested by writeFlankingIntervals,
+    and lists that cannot but are still handled by getFlankingIntervals.
+    */
+    private static abstract class FlankingIntervalsTestData extends TestDataProvider {
+        final public File referenceFile;
+        final public GenomeLocParser parser;
+        final int basePairs;
+        final List<GenomeLoc> original;
+        final List<GenomeLoc> expected;
+
+        protected FlankingIntervalsTestData(Class<?> clazz, String name, File referenceFile, GenomeLocParser parser,
+                                          int basePairs, List<String> original, List<String> expected) {
+            super(clazz, name);
+            this.referenceFile = referenceFile;
+            this.parser = parser;
+            this.basePairs = basePairs;
+            this.original = parse(parser, original);
+            this.expected = parse(parser, expected);
+        }
+
+        private static List<GenomeLoc> parse(GenomeLocParser parser, List<String> locs) {
+            List<GenomeLoc> parsed = new ArrayList<GenomeLoc>();
+            for (String loc: locs)
+                parsed.add("unmapped".equals(loc) ? GenomeLoc.UNMAPPED : parser.parseGenomeLoc(loc));
+            return parsed;
+        }
+    }
+
+    private static class FlankingIntervalsFile extends FlankingIntervalsTestData {
+        public FlankingIntervalsFile(String name, File referenceFile, GenomeLocParser parser,
+                                     int basePairs, List<String> original, List<String> expected) {
+            super(FlankingIntervalsFile.class, name, referenceFile, parser, basePairs, original, expected);
+        }
+    }
+
+    private static class FlankingIntervalsList extends FlankingIntervalsTestData {
+        public FlankingIntervalsList(String name, File referenceFile, GenomeLocParser parser,
+                                     int basePairs, List<String> original, List<String> expected) {
+            super(FlankingIntervalsList.class, name, referenceFile, parser, basePairs, original, expected);
+        }
+    }
+
+    /* Intervals where the original and the flanks can be written to files. */
+    @DataProvider(name = "flankingIntervalsFiles")
+    public Object[][] getFlankingIntervalsFiles() {
+        File hg19ReferenceFile = new File(BaseTest.hg19Reference);
+        int hg19Length1 = hg19GenomeLocParser.getContigInfo("1").getSequenceLength();
+
+        new FlankingIntervalsFile("atStartBase1", hg19ReferenceFile, hg19GenomeLocParser, 1,
+                Arrays.asList("1:1"),
+                Arrays.asList("1:2"));
+
+        new FlankingIntervalsFile("atStartBase50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:1"),
+                Arrays.asList("1:2-51"));
+
+        new FlankingIntervalsFile("atStartRange50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:1-10"),
+                Arrays.asList("1:11-60"));
+
+        new FlankingIntervalsFile("atEndBase1", hg19ReferenceFile, hg19GenomeLocParser, 1,
+                Arrays.asList("1:" + hg19Length1),
+                Arrays.asList("1:" + (hg19Length1 - 1)));
+
+        new FlankingIntervalsFile("atEndBase50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:" + hg19Length1),
+                Arrays.asList(String.format("1:%d-%d", hg19Length1 - 50, hg19Length1 - 1)));
+
+        new FlankingIntervalsFile("atEndRange50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList(String.format("1:%d-%d", hg19Length1 - 10, hg19Length1)),
+                Arrays.asList(String.format("1:%d-%d", hg19Length1 - 60, hg19Length1 - 11)));
+
+        new FlankingIntervalsFile("nearStartBase1", hg19ReferenceFile, hg19GenomeLocParser, 1,
+                Arrays.asList("1:2"),
+                Arrays.asList("1:1", "1:3"));
+
+        new FlankingIntervalsFile("nearStartRange50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:21-30"),
+                Arrays.asList("1:1-20", "1:31-80"));
+
+        new FlankingIntervalsFile("nearEndBase1", hg19ReferenceFile, hg19GenomeLocParser, 1,
+                Arrays.asList("1:" + (hg19Length1 - 1)),
+                Arrays.asList("1:" + (hg19Length1 - 2), "1:" + hg19Length1));
+
+        new FlankingIntervalsFile("nearEndRange50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList(String.format("1:%d-%d", hg19Length1 - 30, hg19Length1 - 21)),
+                Arrays.asList(
+                        String.format("1:%d-%d", hg19Length1 - 80, hg19Length1 - 31),
+                        String.format("1:%d-%d", hg19Length1 - 20, hg19Length1)));
+
+        new FlankingIntervalsFile("beyondStartBase1", hg19ReferenceFile, hg19GenomeLocParser, 1,
+                Arrays.asList("1:3"),
+                Arrays.asList("1:2", "1:4"));
+
+        new FlankingIntervalsFile("beyondStartRange50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:101-200"),
+                Arrays.asList("1:51-100", "1:201-250"));
+
+        new FlankingIntervalsFile("beyondEndBase1", hg19ReferenceFile, hg19GenomeLocParser, 1,
+                Arrays.asList("1:" + (hg19Length1 - 3)),
+                Arrays.asList("1:" + (hg19Length1 - 4), "1:" + (hg19Length1 - 2)));
+
+        new FlankingIntervalsFile("beyondEndRange50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList(String.format("1:%d-%d", hg19Length1 - 200, hg19Length1 - 101)),
+                Arrays.asList(
+                        String.format("1:%d-%d", hg19Length1 - 250, hg19Length1 - 201),
+                        String.format("1:%d-%d", hg19Length1 - 100, hg19Length1 - 51)));
+
+        new FlankingIntervalsFile("betweenFar50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:101-200", "1:401-500"),
+                Arrays.asList("1:51-100", "1:201-250", "1:351-400", "1:501-550"));
+
+        new FlankingIntervalsFile("betweenSpan50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:101-200", "1:301-400"),
+                Arrays.asList("1:51-100", "1:201-300", "1:401-450"));
+
+        new FlankingIntervalsFile("betweenOverlap50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:101-200", "1:271-400"),
+                Arrays.asList("1:51-100", "1:201-270", "1:401-450"));
+
+        new FlankingIntervalsFile("betweenShort50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:101-200", "1:221-400"),
+                Arrays.asList("1:51-100", "1:201-220", "1:401-450"));
+
+        new FlankingIntervalsFile("betweenNone50", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:101-200", "1:121-400"),
+                Arrays.asList("1:51-100", "1:401-450"));
+
+        new FlankingIntervalsFile("twoContigs", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:101-200", "2:301-400"),
+                Arrays.asList("1:51-100", "1:201-250", "2:251-300", "2:401-450"));
+
+        // Explicit testing a problematic agilent target pair
+        new FlankingIntervalsFile("badAgilent", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("2:74756257-74756411", "2:74756487-74756628"),
+                // wrong!    ("2:74756206-74756256", "2:74756412-74756462", "2:74756436-74756486", "2:74756629-74756679")
+                Arrays.asList("2:74756207-74756256", "2:74756412-74756486", "2:74756629-74756678"));
+
+        return TestDataProvider.getTests(FlankingIntervalsFile.class);
+    }
+
+    /* Intervals where either the original and/or the flanks cannot be written to a file. */
+    @DataProvider(name = "flankingIntervalsLists")
+    public Object[][] getFlankingIntervalsLists() {
+        File hg19ReferenceFile = new File(BaseTest.hg19Reference);
+        List<String> empty = Collections.emptyList();
+
+        new FlankingIntervalsList("empty", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                empty,
+                empty);
+
+        new FlankingIntervalsList("unmapped", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("unmapped"),
+                empty);
+
+        new FlankingIntervalsList("fullContig", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1"),
+                empty);
+
+        new FlankingIntervalsList("fullContigs", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1", "2", "3"),
+                empty);
+
+        new FlankingIntervalsList("betweenWithUnmapped", hg19ReferenceFile, hg19GenomeLocParser, 50,
+                Arrays.asList("1:101-200", "1:301-400", "unmapped"),
+                Arrays.asList("1:51-100", "1:201-300", "1:401-450"));
+
+        return TestDataProvider.getTests(FlankingIntervalsList.class);
+    }
+
+    @Test(dataProvider = "flankingIntervalsFiles")
+    public void testWriteFlankingIntervals(FlankingIntervalsTestData data) throws Exception {
+        File originalFile = createTempFile("original.", ".intervals");
+        File flankingFile = createTempFile("flanking.", ".intervals");
+        try {
+            List<String> lines = new ArrayList<String>();
+            for (GenomeLoc loc: data.original)
+                lines.add(loc.toString());
+            FileUtils.writeLines(originalFile, lines);
+
+            IntervalUtils.writeFlankingIntervals(data.referenceFile, originalFile, flankingFile, data.basePairs);
+
+            List<GenomeLoc> actual = IntervalUtils.intervalFileToList(data.parser, flankingFile.getAbsolutePath());
+
+            String description = String.format("%n      name: %s%n  original: %s%n    actual: %s%n  expected: %s%n",
+                    data.toString(), data.original, actual, data.expected);
+            Assert.assertEquals(actual, data.expected, description);
+        } finally {
+            FileUtils.deleteQuietly(originalFile);
+            FileUtils.deleteQuietly(flankingFile);
+        }
+    }
+
+    @Test(dataProvider = "flankingIntervalsLists", expectedExceptions = UserException.class)
+    public void testWritingBadFlankingIntervals(FlankingIntervalsTestData data) throws Exception {
+        File originalFile = createTempFile("original.", ".intervals");
+        File flankingFile = createTempFile("flanking.", ".intervals");
+        try {
+            List<String> lines = new ArrayList<String>();
+            for (GenomeLoc loc: data.original)
+                lines.add(loc.toString());
+            FileUtils.writeLines(originalFile, lines);
+
+            // Should throw a user exception on bad input if either the original
+            // intervals are empty or if the flanking intervals are empty
+            IntervalUtils.writeFlankingIntervals(data.referenceFile, originalFile, flankingFile, data.basePairs);
+        } finally {
+            FileUtils.deleteQuietly(originalFile);
+            FileUtils.deleteQuietly(flankingFile);
+        }
+    }
+
+    @Test(dataProvider = "flankingIntervalsLists")
+    public void testGetFlankingIntervals(FlankingIntervalsTestData data) {
+        List<GenomeLoc> actual = IntervalUtils.getFlankingIntervals(data.parser, data.original, data.basePairs);
+        String description = String.format("%n      name: %s%n  original: %s%n    actual: %s%n  expected: %s%n",
+                data.toString(), data.original, actual, data.expected);
+        Assert.assertEquals(actual, data.expected, description);
+    }
 }
diff --git a/public/scala/src/org/broadinstitute/sting/queue/extensions/gatk/WriteFlankingIntervalsFunction.scala b/public/scala/src/org/broadinstitute/sting/queue/extensions/gatk/WriteFlankingIntervalsFunction.scala
new file mode 100644
index 000000000..d90db0de4
--- /dev/null
+++ b/public/scala/src/org/broadinstitute/sting/queue/extensions/gatk/WriteFlankingIntervalsFunction.scala
@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.queue.extensions.gatk
+
+import org.broadinstitute.sting.queue.function.InProcessFunction
+import org.broadinstitute.sting.commandline.{Output, Argument, Input}
+import java.io.File
+import org.broadinstitute.sting.utils.interval.IntervalUtils
+
+class WriteFlankingIntervalsFunction extends InProcessFunction {
+  @Input(doc="The reference sequence")
+  var reference : File = _
+
+  @Input(doc="The interval list to flank")
+  var inputIntervals : File = _
+
+  @Output(doc="The output intervals file to write to")
+  var outputIntervals: File = _
+
+  @Argument(doc="Number of base pair to flank the input intervals")
+  var flankSize : Int = _
+
+  def run() {
+    IntervalUtils.writeFlankingIntervals(reference, inputIntervals, outputIntervals, flankSize)
+  }
+}
diff --git a/public/scala/src/org/broadinstitute/sting/queue/library/ipf/intervals/ExpandIntervals.scala b/public/scala/src/org/broadinstitute/sting/queue/library/ipf/intervals/ExpandIntervals.scala
deleted file mode 100755
index 77eb3ccbc..000000000
--- a/public/scala/src/org/broadinstitute/sting/queue/library/ipf/intervals/ExpandIntervals.scala
+++ /dev/null
@@ -1,135 +0,0 @@
-package org.broadinstitute.sting.queue.library.ipf.intervals
-
-import org.broadinstitute.sting.queue.function.InProcessFunction
-import org.broadinstitute.sting.commandline._
-import java.io.{PrintStream, File}
-import collection.JavaConversions._
-import org.broadinstitute.sting.utils.text.XReadLines
-import net.sf.picard.reference.FastaSequenceFile
-import org.broadinstitute.sting.utils.{GenomeLoc, GenomeLocParser}
-import collection.immutable.TreeSet
-
-// todo -- this is unsafe. Need to use a reference dictionary to ensure no off-contig targets are created
-class ExpandIntervals(in : File, start: Int, size: Int, out: File, ref: File, ipType: String, opType: String) extends InProcessFunction {
-  @Input(doc="The interval list to expand") val inList : File = in
-  @Input(doc="The reference sequence") val refDict : File = ref
-  @Argument(doc="Number of basepair to start the expanded interval") val startInt : Int = start
-  @Argument(doc="Number of baispair to stop the expanded interval") val sizeInt : Int = size
-  @Output(doc="The output intervals file to write to") val outList : File = out
-  @Argument(doc="The output format for the intervals") val outTypeStr = opType
-  @Argument(doc="The input format for the intervals") val inTypeStr = ipType
-
-  var output : PrintStream = _
-  var parser : GenomeLocParser = _
-  var xrl : XReadLines = _
-  val outType = IntervalFormatType.convert(outTypeStr)
-  val inType = IntervalFormatType.convert(inTypeStr)
-
-  var offsetIn : Int = 0
-  var offsetOut : Int = 0
-
-  var first : Boolean = true
-  var lastTwo : (GenomeLoc,GenomeLoc) = _
-
-  var intervalCache : TreeSet[GenomeLoc] = _
-  val LINES_TO_CACHE : Int = 1000
-
-  def run = {
-    output = new PrintStream(outList)
-    intervalCache = new TreeSet[GenomeLoc]()(new Ordering[GenomeLoc]{
-      def compare(o1: GenomeLoc, o2: GenomeLoc) : Int = { o1.compareTo(o2) }
-    })
-    parser = new GenomeLocParser(new FastaSequenceFile(ref,true))
-    xrl = new XReadLines(inList)
-    offsetIn = if (isBed(inType)) 1 else 0
-    offsetOut = if( isBed(outType)) 1 else 0
-    var line : String = xrl.next
-    while ( line.startsWith("@") ) {
-      line = xrl.next
-    }
-    var prevLoc: GenomeLoc = null
-    var curLoc: GenomeLoc = null
-    var nextLoc : GenomeLoc = parseGenomeInterval(line)
-    var linesProcessed : Int = 1
-    while ( prevLoc != null || curLoc != null || nextLoc != null ) {
-      prevLoc = curLoc
-      curLoc = nextLoc
-      nextLoc = if ( xrl.hasNext ) parseGenomeInterval(xrl.next) else null
-      if ( curLoc != null ) {
-        val left: GenomeLoc =  refine(expandLeft(curLoc),prevLoc)
-        val right: GenomeLoc =  refine(expandRight(curLoc),nextLoc)
-        if ( left != null ) {
-          intervalCache += left
-        }
-        if ( right != null ) {
-          intervalCache += right
-        }
-      }
-      linesProcessed += 1
-      if ( linesProcessed % LINES_TO_CACHE == 0 ) {
-        val toPrint = intervalCache.filter( u => (u.isBefore(prevLoc) && u.distance(prevLoc) > startInt+sizeInt))
-        intervalCache = intervalCache -- toPrint
-        toPrint.foreach(u => output.print("%s%n".format(repr(u))))
-      }
-      //System.out.printf("%s".format(if ( curLoc == null ) "null" else repr(curLoc)))
-    }
-
-    intervalCache.foreach(u => output.print("%s%n".format(repr(u))))
-
-    output.close()
-  }
-
-  def expandLeft(g: GenomeLoc) : GenomeLoc = {
-    parser.createGenomeLoc(g.getContig,g.getStart-startInt-sizeInt,g.getStart-startInt)
-  }
-
-  def expandRight(g: GenomeLoc) : GenomeLoc = {
-    parser.createGenomeLoc(g.getContig,g.getStop+startInt,g.getStop+startInt+sizeInt)
-  }
-
-  def refine(newG: GenomeLoc, borderG: GenomeLoc) : GenomeLoc = {
-    if ( borderG == null || ! newG.overlapsP(borderG) ) {
-      return newG
-    } else {
-      if ( newG.getStart < borderG.getStart ) {
-        if ( borderG.getStart - startInt > newG.getStart ) {
-          return parser.createGenomeLoc(newG.getContig,newG.getStart,borderG.getStart-startInt)
-        }
-      } else {
-        if ( borderG.getStop + startInt < newG.getStop ){
-          return parser.createGenomeLoc(newG.getContig,borderG.getStop+startInt,newG.getStop)
-        }
-      }
-    }
-
-    null
-  }
-
-  def repr(loc : GenomeLoc) : String = {
-    if ( loc == null ) return "null"
-    if ( outType == IntervalFormatType.INTERVALS ) {
-      return "%s:%d-%d".format(loc.getContig,loc.getStart,loc.getStop)
-    } else {
-      return "%s\t%d\t%d".format(loc.getContig,loc.getStart-offsetOut,loc.getStop+offsetOut)
-    }
-  }
-
-  def isBed(t: IntervalFormatType.IntervalFormatType) : Boolean = {
-    t == IntervalFormatType.BED
-   }
-
-  def parseGenomeInterval( s : String ) : GenomeLoc = {
-    val sp = s.split("\\s+")
-    // todo -- maybe specify whether the bed format [0,6) --> (1,2,3,4,5) is what's wanted  
-    if ( s.contains(":") ) parser.parseGenomeLoc(s) else parser.createGenomeLoc(sp(0),sp(1).toInt+offsetIn,sp(2).toInt-offsetIn)
-  }
-
-  object IntervalFormatType extends Enumeration("INTERVALS","BED","TDF") {
-    type IntervalFormatType = Value
-    val INTERVALS,BED,TDF = Value
-
-    def convert(s : String) : IntervalFormatType = {
-      if ( s.equals("INTERVALS") ) INTERVALS else { if (s.equals("BED") ) BED else TDF}
-    }
-  }
-}
\ No newline at end of file
diff --git a/public/scala/src/org/broadinstitute/sting/queue/library/ipf/intervals/IntersectIntervals.scala b/public/scala/src/org/broadinstitute/sting/queue/library/ipf/intervals/IntersectIntervals.scala
deleted file mode 100755
index e929477a1..000000000
--- a/public/scala/src/org/broadinstitute/sting/queue/library/ipf/intervals/IntersectIntervals.scala
+++ /dev/null
@@ -1,70 +0,0 @@
-package org.broadinstitute.sting.queue.library.ipf.intervals
-
-import org.broadinstitute.sting.queue.function.InProcessFunction
-import collection.JavaConversions._
-import org.broadinstitute.sting.commandline._
-import java.io.{PrintStream, File}
-import net.sf.samtools.{SAMSequenceRecord, SAMFileHeader, SAMSequenceDictionary}
-import org.broadinstitute.sting.utils.text.XReadLines
-import org.broadinstitute.sting.utils.{GenomeLoc, GenomeLocParser}
-
-class IntersectIntervals(iVals: List[File], outFile: File, bed: Boolean) extends InProcessFunction {
-  @Input(doc="List of interval files to find the intersection of") val intervals : List[File] = iVals
-  @Output(doc="Output interval file to which to write") val output : File = outFile
-  @Argument(doc="Assume the input interval lists are sorted in the proper order") var assumeSorted = false
-  @Argument(doc="Is the tdf in bed file (0-based clopen: 0  5 for {1,2,3,4}?") var isBed = bed
-
-
-  var outStream : PrintStream = _
-  var contigs : List[String] = Nil
-  var dict : SAMSequenceDictionary = _
-  var parser : GenomeLocParser = _
-
-  def run = {
-    outStream = new PrintStream(output)
-    dict = new SAMSequenceDictionary
-    // note: memory hog
-    val sources : List[(List[(String,Int,Int)],Int)] = intervals.map(g => asScalaIterator(new XReadLines(g)).map(u => parse(u)).toList).zipWithIndex
-    sources.map(u => u._1).flatten.map(u => u._1).distinct.foreach(u => dict.addSequence(new SAMSequenceRecord(u,Integer.MAX_VALUE)))
-    parser = new GenomeLocParser(dict)
-    sources.map( (u: (List[(String,Int,Int)],Int)) => u._1.map(g => (newGenomeLoc(g),u._2))).flatten.sortWith( (a,b) => (a._1 compareTo b._1) < 0 ).foldLeft[List[List[(GenomeLoc,Int)]]](Nil)( (a,b) => overlapFold(a,b)).map(u => mapIntersect(u)).filter(h => h != null && h.size > 0).foreach(h => writeOut(h))
-    outStream.close()
-  }
-
-  def writeOut(g : GenomeLoc) : Unit = {
-    outStream.print("%s%n".format(g.toString))
-  }
-
-  def parse(s : String) : (String,Int,Int) = {
-    if ( s.contains(":") ) {
-      val split1 = s.split(":")
-      val split2 = split1(1).split("-")
-      return (split1(0),split2(0).toInt,split2(1).toInt)
-    } else {
-      val split = s.split("\\s+")
-      return (split(0),split(1).toInt + (if(isBed) 1 else 0) ,split(2).toInt - (if(isBed) 1 else 0) )
-    }
-  }
-
-  def newGenomeLoc(coords : (String,Int,Int) ) : GenomeLoc = {
-    parser.createGenomeLoc(coords._1,coords._2,coords._3)
-  }
-
-  def overlapFold( a: List[List[(GenomeLoc,Int)]], b: (GenomeLoc,Int) ) : List[List[(GenomeLoc,Int)]] = {
-    if ( a.last.forall(u => u._1.overlapsP(b._1)) ) {
-      a.init :+ (a.last :+ b)
-    } else {
-      a :+ ( a.last.dropWhile(u => ! u._1.overlapsP(b._1)) :+ b)
-    }
-  }
-
-  def mapIntersect( u: List[(GenomeLoc,Int)]) : GenomeLoc = {
-    if ( u.map(h => h._2).distinct.sum != range(1,intervals.size).sum ) { // if all sources not accounted for
-      null
-    }
-    u.map(h => h._1).reduceLeft[GenomeLoc]( (a,b) => a.intersect(b) )
-  }
-
-  def range(a: Int, b: Int) : Range = new Range(a,b+1,1)
-
-}
\ No newline at end of file

From 68b2a0968c7f512c92390104861e9730b13cb165 Mon Sep 17 00:00:00 2001
From: David Roazen <droazen@broadinstitute.org>
Date: Thu, 17 Nov 2011 13:16:22 -0500
Subject: [PATCH 047/113] Updating the HybridSelectionPipeline for SnpEff 2.0.4
 RC3

This will have to be done again when the 2.0.4 release becomes official,
but it's necessary to do now in order to re-enable the pipeline tests.
---
 ivy.xml                                       |   2 +-
 .../{snpeff-2.0.2.jar => snpeff-2.0.4rc3.jar} | Bin 4113631 -> 4155641 bytes
 .../{snpeff-2.0.2.xml => snpeff-2.0.4rc3.xml} |   2 +-
 3 files changed, 2 insertions(+), 2 deletions(-)
 rename settings/repository/net.sf.snpeff/{snpeff-2.0.2.jar => snpeff-2.0.4rc3.jar} (88%)
 mode change 100755 => 100644
 rename settings/repository/net.sf.snpeff/{snpeff-2.0.2.xml => snpeff-2.0.4rc3.xml} (77%)

diff --git a/ivy.xml b/ivy.xml
index 96c1de844..ee24bc367 100644
--- a/ivy.xml
+++ b/ivy.xml
@@ -76,7 +76,7 @@
     <dependency org="org.apache.poi" name="poi-ooxml" rev="3.8-beta3" />
 
     <!-- snpEff annotator for pipelines -->
-    <dependency org="net.sf.snpeff" name="snpeff" rev="2.0.2" />
+    <dependency org="net.sf.snpeff" name="snpeff" rev="2.0.4rc3" />
 
     <!-- Exclude dependencies on sun libraries where the downloads aren't available but included in the jvm. -->
     <exclude org="javax.servlet" />
diff --git a/settings/repository/net.sf.snpeff/snpeff-2.0.2.jar b/settings/repository/net.sf.snpeff/snpeff-2.0.4rc3.jar
old mode 100755
new mode 100644
similarity index 88%
rename from settings/repository/net.sf.snpeff/snpeff-2.0.2.jar
rename to settings/repository/net.sf.snpeff/snpeff-2.0.4rc3.jar
index bfd06f97f8c93dd980044ccea2021e1fe97e1040..ee5d02367293107c0e4383274daec7fc91d4d53f
GIT binary patch
delta 319310
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
LXs%3&!2kUhB#ySi

delta 279027
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

diff --git a/settings/repository/net.sf.snpeff/snpeff-2.0.2.xml b/settings/repository/net.sf.snpeff/snpeff-2.0.4rc3.xml
similarity index 77%
rename from settings/repository/net.sf.snpeff/snpeff-2.0.2.xml
rename to settings/repository/net.sf.snpeff/snpeff-2.0.4rc3.xml
index f0568def4..5417641d3 100644
--- a/settings/repository/net.sf.snpeff/snpeff-2.0.2.xml
+++ b/settings/repository/net.sf.snpeff/snpeff-2.0.4rc3.xml
@@ -1,3 +1,3 @@
 <ivy-module version="1.0">
-    <info organisation="net.sf.snpeff" module="snpeff" revision="2.0.2" status="release" />
+    <info organisation="net.sf.snpeff" module="snpeff" revision="2.0.4rc3" status="release" />
 </ivy-module>

From 473b860312fb3df70d7e9baa9d421450640edcd6 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Thu, 17 Nov 2011 15:31:45 -0500
Subject: [PATCH 048/113] Major determinism fix for UG and RankSumTest

-- Now these routines all iterate in sample name order (genotypes.iterateInSampleNameOrder) so that the results of UG and the annotator do not depend on the particular order of samples we see for the exact model and the RankSumTest
---
 .../sting/gatk/walkers/annotator/RankSumTest.java         | 4 ++--
 .../gatk/walkers/genotyper/ExactAFCalculationModel.java   | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
index ebf33496f..c5a2df1fd 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/RankSumTest.java
@@ -43,7 +43,7 @@ public abstract class RankSumTest extends InfoFieldAnnotation implements Standar
 
         if (vc.isSNP() && vc.isBiallelic()) {
             // todo - no current support for multiallelic snps
-            for ( final Genotype genotype : genotypes ) {
+            for ( final Genotype genotype : genotypes.iterateInSampleNameOrder() ) {
                 final AlignmentContext context = stratifiedContexts.get(genotype.getSampleName());
                 if ( context == null ) {
                     continue;
@@ -53,7 +53,7 @@ public abstract class RankSumTest extends InfoFieldAnnotation implements Standar
         }
         else if (vc.isIndel() || vc.isMixed()) {
 
-            for ( final Genotype genotype : genotypes ) {
+            for ( final Genotype genotype : genotypes.iterateInSampleNameOrder() ) {
                 final AlignmentContext context = stratifiedContexts.get(genotype.getSampleName());
                 if ( context == null ) {
                     continue;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index 980088305..a7240ae88 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -98,7 +98,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
         ArrayList<double[]> genotypeLikelihoods = new ArrayList<double[]>();
 
         genotypeLikelihoods.add(new double[]{0.0,0.0,0.0}); // dummy
-        for ( Genotype sample : GLs ) {
+        for ( Genotype sample : GLs.iterateInSampleNameOrder() ) {
             if ( sample.hasLikelihoods() ) {
                 double[] gls = sample.getLikelihoods().getAsVector();
 
@@ -290,12 +290,12 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
 
         // todo = can't deal with optimal dynamic programming solution with multiallelic records
         if (SIMPLE_GREEDY_GENOTYPER || !vc.isBiallelic()) {
-            sampleIndices.addAll(GLs.getSampleNames());
+            sampleIndices.addAll(GLs.getSampleNamesOrderedByName());
             sampleIdx = GLs.size();
         }
         else {
 
-            for ( final Genotype genotype : GLs ) {
+            for ( final Genotype genotype : GLs.iterateInSampleNameOrder() ) {
                 if ( !genotype.hasLikelihoods() )
                     continue;
 
@@ -419,7 +419,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
 
         }
 
-        for ( final Genotype genotype : GLs ) {
+        for ( final Genotype genotype : GLs.iterateInSampleNameOrder() ) {
             if ( !genotype.hasLikelihoods() )
                 continue;
             Genotype g = GLs.get(genotype.getSampleName());

From 23359d1c6c797f2374484cfdb3d23722bb1331f2 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Thu, 17 Nov 2011 15:32:52 -0500
Subject: [PATCH 049/113] Bugfix for pruneVariantContext, which was dropping
 the ref base for padding

---
 .../sting/utils/variantcontext/VariantContextUtils.java         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index b77f606f5..5d2c86f84 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -302,7 +302,7 @@ public class VariantContextUtils {
         }
 
         return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(),
-                vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.getFilters(), attributes);
+                vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.getFilters(), attributes, vc.getReferenceBaseForIndel());
     }
 
     public enum GenotypeMergeType {

From 02f22cc9f8b451d71c8f04c9fffc7e56a50880a1 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Thu, 17 Nov 2011 15:33:09 -0500
Subject: [PATCH 050/113] No more VC integration tests.  All tests are now unit
 tests

---
 .../VariantContextIntegrationTest.java        | 65 -------------------
 1 file changed, 65 deletions(-)
 delete mode 100755 public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextIntegrationTest.java

diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextIntegrationTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextIntegrationTest.java
deleted file mode 100755
index 67fe7d012..000000000
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextIntegrationTest.java
+++ /dev/null
@@ -1,65 +0,0 @@
-
-
-package org.broadinstitute.sting.utils.variantcontext;
-
-import org.broadinstitute.sting.WalkerTest;
-import org.testng.annotations.DataProvider;
-import org.testng.annotations.Test;
-
-import java.util.HashMap;
-import java.util.Map;
-import java.util.Arrays;
-
-public class VariantContextIntegrationTest extends WalkerTest {
-    private static String cmdRoot = "-T TestVariantContext" +
-            " -R " + b36KGReference;
-
-    private static String root = cmdRoot +
-            " -L 1:1-1,000,000 -V " + b36dbSNP129;
-
-    private static final class VCITTest extends TestDataProvider {
-        String args, md5;
-
-        private VCITTest(final String args, final String md5) {
-            super(VCITTest.class);
-            this.args = args;
-            this.md5 = md5;
-        }
-    }
-
-    @DataProvider(name = "VCITTestData")
-    public Object[][] createVCITTestData() {
-        new VCITTest("--printPerLocus", "e9d0f1fe80659bb55b40aa6c3a2e921e");
-        new VCITTest("--printPerLocus --onlyContextsOfType SNP", "0e620db3e45771df42c54a9c0ae4a29f");
-        new VCITTest("--printPerLocus --onlyContextsOfType INDEL", "b725c204fefe3814644d50e7c20f9dfe");
-        new VCITTest("--printPerLocus --onlyContextsOfType MIXED", "3ccc33f496a1718df55722d11cc14334");
-        new VCITTest("--printPerLocus --onlyContextsOfType NO_VARIATION", "39335acdb34c8a2af433dc50d619bcbc");
-        new VCITTest("--printPerLocus --takeFirstOnly", "3a45561da042b2b44b6a679744f16103");
-        new VCITTest("--printPerLocus --onlyContextsOfType INDEL --onlyContextsStartinAtCurrentPosition", "4746f269ecc377103f83eb61cc162c39");
-        new VCITTest("--printPerLocus --onlyContextsStartinAtCurrentPosition", "2749e3fae458650a85a2317e346dc44c");
-        new VCITTest("--printPerLocus --takeFirstOnly --onlyContextsStartinAtCurrentPosition", "9bd48c2a40813023e29ffaa23d59d382");
-
-        return VCITTest.getTests(VCITTest.class);
-    }
-
-    @Test(dataProvider = "VCITTestData")
-    public void testConversionSelection(VCITTest test) {
-	String extraArgs = test.args;
-	String md5 = test.md5;
-
-	WalkerTestSpec spec = new WalkerTestSpec( root + " " + extraArgs + " -o %s",
-						  1, // just one output file
-						  Arrays.asList(md5));
-	executeTest("testSelectors", spec);
-    }
-
-    @Test
-    public void testToVCF() {
-        // this really just tests that we are seeing the same number of objects over all of chr1
-
-        WalkerTestSpec spec = new WalkerTestSpec( cmdRoot + " -NO_HEADER -V:VCF3 " + validationDataLocation + "yri.trio.gatk_glftrio.intersection.annotated.filtered.chr1.500.vcf -L 1:1-1000000 -o %s --outputVCF %s",
-                2, // just one output file
-                Arrays.asList("e3c35d0c4b5d4935c84a270f9df0951f", "ff91731213fd0bbdc200ab6fd1c93e63"));
-         executeTest("testToVCF", spec);
-    }
-}

From fa454c88bbc4b366c493ff18dc9f18b295fc2025 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Thu, 17 Nov 2011 20:37:22 -0500
Subject: [PATCH 051/113] UnitTests for VariantContext for chrCount,
 getSampleNames, Order function

-- Major change to how chromosomeCounts is computed.  Now NO_CALL alleles are always excluded.  So ChromosomeCounts(A/.) is 1, the previous result would have been 2.
-- Naming changes for getSamplesNameInOrder()
---
 .../gatk/walkers/annotator/SampleList.java    |   2 +-
 .../variantcontext/GenotypesContext.java      |  11 +-
 .../utils/variantcontext/VariantContext.java  |  27 ++--
 .../VariantContextBenchmark.java              |   4 +-
 .../VariantContextUnitTest.java               | 118 +++++++++++++++++-
 5 files changed, 135 insertions(+), 27 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SampleList.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SampleList.java
index ee08cfa3b..84a4a3120 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SampleList.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SampleList.java
@@ -51,7 +51,7 @@ public class SampleList extends InfoFieldAnnotation {
             return null;
 
         StringBuffer samples = new StringBuffer();
-        for ( Genotype genotype : vc.getGenotypesSortedByName() ) {
+        for ( Genotype genotype : vc.getGenotypesOrderedByName() ) {
             if ( genotype.isCalled() && !genotype.isHomRef() ){
                 if ( samples.length() > 0 )
                     samples.append(",");
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 3b2de4769..77a02874d 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -31,9 +31,9 @@ import java.util.*;
  */
 public class GenotypesContext implements List<Genotype> {
     public final static GenotypesContext NO_GENOTYPES =
-            new GenotypesContext(new ArrayList<Genotype>(0), new HashMap<String, Integer>(0), new HashSet<String>(0), true);
+            new GenotypesContext(new ArrayList<Genotype>(0), new HashMap<String, Integer>(0), Collections.<String>emptyList(), true);
 
-    Set<String> sampleNamesInOrder = null;
+    List<String> sampleNamesInOrder = null;
     Map<String, Integer> sampleNameToOffset = null;
     boolean cacheIsInvalid = true;
     List<Genotype> genotypes;
@@ -62,7 +62,7 @@ public class GenotypesContext implements List<Genotype> {
 
     private GenotypesContext(final ArrayList<Genotype> genotypes,
                              final Map<String, Integer> sampleNameToOffset,
-                             final Set<String> sampleNamesInOrder,
+                             final List<String> sampleNamesInOrder,
                              final boolean immutable) {
         this.genotypes = genotypes;
         this.immutable = immutable;
@@ -152,7 +152,7 @@ public class GenotypesContext implements List<Genotype> {
 
     private void buildCache() {
         cacheIsInvalid = false;
-        sampleNamesInOrder = new TreeSet<String>();
+        sampleNamesInOrder = new ArrayList<String>(genotypes.size());
         sampleNameToOffset = new HashMap<String, Integer>(genotypes.size());
 
         for ( int i = 0; i < genotypes.size(); i++ ) {
@@ -160,6 +160,7 @@ public class GenotypesContext implements List<Genotype> {
             sampleNamesInOrder.add(g.getSampleName());
             sampleNameToOffset.put(g.getSampleName(), i);
         }
+        Collections.sort(sampleNamesInOrder);
     }
 
 
@@ -354,7 +355,7 @@ public class GenotypesContext implements List<Genotype> {
         return sampleNameToOffset.keySet();
     }
 
-    public Set<String> getSampleNamesOrderedByName() {
+    public List<String> getSampleNamesOrderedByName() {
         buildCache();
         return sampleNamesInOrder;
     }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 75e3aac58..7798e259c 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -985,11 +985,16 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         return genotypes;
     }
 
-    public Iterable<Genotype> getGenotypesSortedByName() {
+    public Iterable<Genotype> getGenotypesOrderedByName() {
         loadGenotypes();
         return genotypes.iterateInSampleNameOrder();
     }
 
+    public Iterable<Genotype> getGenotypesOrderedBy(Iterable<String> sampleOrdering) {
+        loadGenotypes();
+        return genotypes.iterateInSampleNameOrder(sampleOrdering);
+    }
+
     /**
      * Returns a map from sampleName -> Genotype for the genotype associated with sampleName.  Returns a map
      * for consistency with the multi-get function.
@@ -1026,7 +1031,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         return getGenotypes().getSampleNames();
     }
 
-    public Set<String> getSampleNamesOrderedByName() {
+    public List<String> getSampleNamesOrderedByName() {
         return getGenotypes().getSampleNamesOrderedByName();
     }
 
@@ -1049,7 +1054,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
 
 
     /**
-     * Returns the number of chromosomes carrying any allele in the genotypes (i.e., excluding NO_CALLS
+     * Returns the number of chromosomes carrying any allele in the genotypes (i.e., excluding NO_CALLS)
      *
      * @return chromosome count
      */
@@ -1057,7 +1062,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         int n = 0;
 
         for ( final Genotype g : getGenotypes() ) {
-            n += g.isNoCall() ? 0 : g.getPloidy();
+            for ( final Allele a : g.getAlleles() )
+                n += a.isNoCall() ? 0 : 1;
         }
 
         return n;
@@ -1086,7 +1092,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return true if it's monomorphic
      */
     public boolean isMonomorphic() {
-        return ! isVariant() || (hasGenotypes() && getHomRefCount() + getNoCallCount() == getNSamples());
+        return ! isVariant() || (hasGenotypes() && getChromosomeCount(getReference()) == getChromosomeCount());
     }
 
     /**
@@ -1104,16 +1110,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             genotypeCounts = new int[Genotype.Type.values().length];
 
             for ( final Genotype g : getGenotypes() ) {
-                if ( g.isNoCall() )
-                    genotypeCounts[Genotype.Type.NO_CALL.ordinal()]++;
-                else if ( g.isHomRef() )
-                    genotypeCounts[Genotype.Type.HOM_REF.ordinal()]++;
-                else if ( g.isHet() )
-                    genotypeCounts[Genotype.Type.HET.ordinal()]++;
-                else if ( g.isHomVar() )
-                    genotypeCounts[Genotype.Type.HOM_VAR.ordinal()]++;
-                else
-                    genotypeCounts[Genotype.Type.MIXED.ordinal()]++;
+                genotypeCounts[g.getType().ordinal()]++;
             }
         }
     }
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
index 273b8fdf7..fae7cb05a 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -209,7 +209,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
                     public void run(final VariantContext vc) {
                         ; // TODO - TEST IS BROKEN
 //                        int n = 0;
-//                        for ( final Genotype g: vc.getGenotypesSortedByName() ) n++;
+//                        for ( final Genotype g: vc.getGenotypesOrderedByName() ) n++;
                     }
                 };
 
@@ -335,7 +335,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
 //                return new FunctionToBenchmark<org.broadinstitute.sting.utils.variantcontext.v13.VariantContext>() {
 //                    public void run(final org.broadinstitute.sting.utils.variantcontext.v13.VariantContext vc) {
 //                        ; // TODO - TEST IS BROKEN
-//                        //vc.getGenotypesSortedByName();
+//                        //vc.getGenotypesOrderedByName();
 //                    }
 //                };
 //
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index f2eb2dd57..5bc72e132 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -263,7 +263,7 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertFalse(vc.isMonomorphic());
         Assert.assertTrue(vc.isPolymorphic());
         Assert.assertEquals(vc.getGenotype("foo"), g);
-        Assert.assertEquals(vc.getChromosomeCount(), 2); // we know that there are 2 chromosomes, even though one isn't called
+        Assert.assertEquals(vc.getChromosomeCount(), 1); // we only have 1 called chromosomes, we exclude the NO_CALL one isn't called
         Assert.assertEquals(vc.getChromosomeCount(Aref), 0);
         Assert.assertEquals(vc.getChromosomeCount(C), 1);
         Assert.assertFalse(vc.getGenotype("foo").isHet());
@@ -690,9 +690,6 @@ public class VariantContextUnitTest extends BaseTest {
         return SubContextTest.getTests(SubContextTest.class);
     }
 
-    private final static void SubContextTest() {
-    }
-
     @Test(dataProvider = "SubContextTest")
     public void runSubContextTest(SubContextTest cfg) {
         Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
@@ -734,4 +731,117 @@ public class VariantContextUnitTest extends BaseTest {
         // same sample names => success
         Assert.assertEquals(sub.getGenotypes().getSampleNames(), expectedGC.getSampleNames());
     }
+
+    // --------------------------------------------------------------------------------
+    //
+    // Test sample name functions
+    //
+    // --------------------------------------------------------------------------------
+    private class SampleNamesTest extends TestDataProvider {
+        List<String> sampleNames;
+        List<String> sampleNamesInOrder;
+
+        private SampleNamesTest(List<String> sampleNames, List<String> sampleNamesInOrder) {
+            super(SampleNamesTest.class);
+            this.sampleNamesInOrder = sampleNamesInOrder;
+            this.sampleNames = sampleNames;
+        }
+
+        public String toString() {
+            return String.format("%s samples=%s order=%s", super.toString(), sampleNames, sampleNamesInOrder);
+        }
+    }
+
+    @DataProvider(name = "SampleNamesTest")
+    public Object[][] MakeSampleNamesTest() {
+        new SampleNamesTest(Arrays.asList("1"), Arrays.asList("1"));
+        new SampleNamesTest(Arrays.asList("2", "1"), Arrays.asList("1", "2"));
+        new SampleNamesTest(Arrays.asList("1", "2"), Arrays.asList("1", "2"));
+        new SampleNamesTest(Arrays.asList("1", "2", "3"), Arrays.asList("1", "2", "3"));
+        new SampleNamesTest(Arrays.asList("2", "1", "3"), Arrays.asList("1", "2", "3"));
+        new SampleNamesTest(Arrays.asList("2", "3", "1"), Arrays.asList("1", "2", "3"));
+        new SampleNamesTest(Arrays.asList("3", "1", "2"), Arrays.asList("1", "2", "3"));
+        new SampleNamesTest(Arrays.asList("3", "2", "1"), Arrays.asList("1", "2", "3"));
+        new SampleNamesTest(Arrays.asList("NA2", "NA1"), Arrays.asList("NA1", "NA2"));
+        return SampleNamesTest.getTests(SampleNamesTest.class);
+    }
+
+    private final static void assertGenotypesAreInOrder(Iterable<Genotype> gIt, List<String> names) {
+        int i = 0;
+        for ( final Genotype g : gIt ) {
+            Assert.assertEquals(g.getSampleName(), names.get(i), "Unexpected genotype ordering");
+            i++;
+        }
+    }
+
+
+    @Test(dataProvider = "SampleNamesTest")
+    public void runSampleNamesTest(SampleNamesTest cfg) {
+        GenotypesContext gc = GenotypesContext.create(cfg.sampleNames.size());
+        for ( final String name : cfg.sampleNames ) {
+            gc.add(new Genotype(name, Arrays.asList(Aref, T)));
+        }
+
+        VariantContext vc = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc,
+                snpLocStart, snpLocStop, Arrays.asList(Aref, T), gc);
+
+        // same sample names => success
+        Assert.assertEquals(vc.getSampleNames(), new HashSet<String>(cfg.sampleNames), "vc.getSampleNames() = " + vc.getSampleNames());
+        Assert.assertEquals(vc.getSampleNamesOrderedByName(), cfg.sampleNamesInOrder, "vc.getSampleNamesOrderedByName() = " + vc.getSampleNamesOrderedByName());
+
+        assertGenotypesAreInOrder(vc.getGenotypesOrderedByName(), cfg.sampleNamesInOrder);
+        assertGenotypesAreInOrder(vc.getGenotypesOrderedBy(cfg.sampleNames), cfg.sampleNames);
+    }
+
+    @Test
+    public void testGenotypeCounting() {
+        Genotype noCall = new Genotype("nocall", Arrays.asList(Allele.NO_CALL));
+        Genotype mixed  = new Genotype("mixed", Arrays.asList(Aref, Allele.NO_CALL));
+        Genotype homRef = new Genotype("homRef", Arrays.asList(Aref, Aref));
+        Genotype het    = new Genotype("het", Arrays.asList(Aref, T));
+        Genotype homVar = new Genotype("homVar", Arrays.asList(T, T));
+
+        List<Genotype> allGenotypes = Arrays.asList(noCall, mixed, homRef, het, homVar);
+        final int nCycles = allGenotypes.size() * 10;
+
+        for ( int i = 0; i < nCycles; i++ ) {
+            int nNoCall = 0, nNoCallAlleles = 0, nA = 0, nT = 0, nMixed = 0, nHomRef = 0, nHet = 0, nHomVar = 0;
+            int nSamples = 0;
+            GenotypesContext gc = GenotypesContext.create();
+            for ( int j = 0; j < i; j++ ) {
+                nSamples++;
+                Genotype g = allGenotypes.get(j % allGenotypes.size());
+                gc.add(g);
+                switch ( g.getType() ) {
+                    case NO_CALL: nNoCall++; nNoCallAlleles++; break;
+                    case HOM_REF: nA += 2; nHomRef++; break;
+                    case HET: nA++; nT++; nHet++; break;
+                    case HOM_VAR: nT += 2; nHomVar++; break;
+                    case MIXED: nA++; nNoCallAlleles++; nMixed++; break;
+                    default: throw new RuntimeException("Unexpected genotype type " + g.getType());
+                }
+
+            }
+
+            VariantContext vc = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc,
+                    snpLocStart, snpLocStop, Arrays.asList(Aref, T), gc);
+
+            Assert.assertEquals(vc.getNSamples(), nSamples);
+            if ( nSamples > 0 ) {
+                Assert.assertEquals(vc.isPolymorphic(), nT > 0);
+                Assert.assertEquals(vc.isMonomorphic(), nT == 0);
+            }
+            Assert.assertEquals(vc.getChromosomeCount(), nA + nT);
+
+            Assert.assertEquals(vc.getChromosomeCount(Allele.NO_CALL), nNoCallAlleles);
+            Assert.assertEquals(vc.getChromosomeCount(Aref), nA);
+            Assert.assertEquals(vc.getChromosomeCount(T), nT);
+
+            Assert.assertEquals(vc.getNoCallCount(), nNoCall);
+            Assert.assertEquals(vc.getHomRefCount(), nHomRef);
+            Assert.assertEquals(vc.getHetCount(), nHet);
+            Assert.assertEquals(vc.getHomVarCount(), nHomVar);
+            Assert.assertEquals(vc.getMixedCount(), nMixed);
+        }
+    }
 }
\ No newline at end of file

From f48d4cfa79cdae7bc02abf913cbd1ff3b8716786 Mon Sep 17 00:00:00 2001
From: Roger Zurawicki <roger@broadinstitute.org>
Date: Fri, 18 Nov 2011 00:19:59 -0500
Subject: [PATCH 052/113] Bug fix: fully clipping GATKSAMRecords and flushing
 ops

Reads that are emptied after clipping become new GATKSAMRecords.
When applying ClippingOps, the ops are cleared after the clipping
---
 .../broadinstitute/sting/utils/clipreads/ReadClipper.java    | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/clipreads/ReadClipper.java b/public/java/src/org/broadinstitute/sting/utils/clipreads/ReadClipper.java
index 6e4ddddc4..e4806838d 100644
--- a/public/java/src/org/broadinstitute/sting/utils/clipreads/ReadClipper.java
+++ b/public/java/src/org/broadinstitute/sting/utils/clipreads/ReadClipper.java
@@ -121,7 +121,7 @@ public class ReadClipper {
 
     public GATKSAMRecord hardClipSoftClippedBases () {
         if (read.isEmpty())
-            return read;
+            return new GATKSAMRecord(read.getHeader());
 
         int readIndex = 0;
         int cutLeft = -1;            // first position to hard clip (inclusive)
@@ -171,6 +171,9 @@ public class ReadClipper {
                     clippedRead = op.apply(algorithm, clippedRead);
                 }
                 wasClipped = true;
+                ops.clear();
+                if ( clippedRead.isEmpty() )
+                    return new GATKSAMRecord( clippedRead.getHeader() );
                 return clippedRead;
             } catch (CloneNotSupportedException e) {
                 throw new RuntimeException(e); // this should never happen

From 7490dbb6eb5b47efb63f30f8b37c53904f63cfe9 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 18 Nov 2011 11:06:15 -0500
Subject: [PATCH 055/113] First version of VariantContextBuilder

---
 .../gatk/refdata/VariantContextAdaptors.java  |   2 +-
 .../annotator/VariantAnnotatorEngine.java     |   7 +-
 .../beagle/BeagleOutputToVCFWalker.java       |   2 +-
 .../beagle/ProduceBeagleInputWalker.java      |   2 +-
 .../filters/VariantFiltrationWalker.java      |  11 +-
 .../walkers/genotyper/UGCallVariants.java     |   7 +-
 .../genotyper/UnifiedGenotyperEngine.java     |   5 +-
 ...eSegregatingAlternateAllelesVCFWriter.java |   7 +-
 .../walkers/phasing/PhaseByTransmission.java  |   2 +-
 .../gatk/walkers/phasing/PhasingUtils.java    |   2 +-
 .../validation/GenotypeAndValidateWalker.java |   3 +-
 .../varianteval/VariantEvalWalker.java        |   5 +-
 .../varianteval/util/VariantEvalUtils.java    |   3 +-
 .../ApplyRecalibration.java                   |  15 +-
 .../walkers/variantutils/CombineVariants.java |   3 +-
 .../variantutils/LeftAlignVariants.java       |   7 +-
 .../variantutils/LiftoverVariants.java        |  12 +-
 .../walkers/variantutils/SelectVariants.java  |  31 +-
 .../VariantValidationAssessor.java            |  21 +-
 .../walkers/variantutils/VariantsToVCF.java   |  10 +-
 .../utils/codecs/vcf/AbstractVCFCodec.java    |  29 +-
 .../utils/codecs/vcf/StandardVCFWriter.java   |  14 +-
 .../utils/variantcontext/CommonInfo.java      |  29 +-
 .../sting/utils/variantcontext/Genotype.java  |   5 +-
 .../utils/variantcontext/VariantContext.java  | 307 +++---------------
 .../variantcontext/VariantContextBuilder.java | 245 ++++++++++++++
 .../variantcontext/VariantContextUtils.java   |  82 ++++-
 .../walkers/qc/TestVariantContextWalker.java  | 137 --------
 .../VariantContextBenchmark.java              |   2 +-
 .../VariantContextUnitTest.java               |  55 ++--
 .../VariantContextUtilsUnitTest.java          |   2 +-
 31 files changed, 511 insertions(+), 553 deletions(-)
 create mode 100644 public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index 081f86ab9..7953edd7f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -255,7 +255,7 @@ public class VariantContextAdaptors {
                 genotypes.add(call);
                 alleles.add(refAllele);
                 GenomeLoc loc = ref.getGenomeLocParser().createGenomeLoc(geli.getChr(),geli.getStart());
-                return new VariantContext(name, VCFConstants.EMPTY_ID_FIELD, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, geli.getLODBestToReference(), null, attributes);
+                return new VariantContextBuilder(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles).genotypes(genotypes).negLog10PError(geli.getLODBestToReference()).attributes(attributes).make();
             } else
                 return null; // can't handle anything else
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
index 9f0353eb9..b782de15f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
@@ -36,6 +36,7 @@ import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
 import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 
 import java.util.*;
 
@@ -179,10 +180,10 @@ public class VariantAnnotatorEngine {
         }
 
         // generate a new annotated VC
-        final VariantContext annotatedVC = VariantContext.modifyAttributes(vc, infoAnnotations);
+        VariantContextBuilder builder = new VariantContextBuilder(vc).attributes(infoAnnotations);
 
         // annotate genotypes, creating another new VC in the process
-        return VariantContext.modifyGenotypes(annotatedVC, annotateGenotypes(tracker, ref, stratifiedContexts, vc));
+        return builder.genotypes(annotateGenotypes(tracker, ref, stratifiedContexts, vc)).make();
     }
 
     private VariantContext annotateDBs(RefMetaDataTracker tracker, ReferenceContext ref, VariantContext vc, Map<String, Object> infoAnnotations) {
@@ -192,7 +193,7 @@ public class VariantAnnotatorEngine {
                 infoAnnotations.put(VCFConstants.DBSNP_KEY, rsID != null);
                 // annotate dbsnp id if available and not already there
                 if ( rsID != null && vc.emptyID() )
-                    vc = VariantContext.modifyID(vc, rsID);
+                    vc = new VariantContextBuilder(vc).id(rsID).make();
             } else {
                 boolean overlapsComp = false;
                 for ( VariantContext comp : tracker.getValues(dbSet.getKey(), ref.getLocus()) ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index 649b7621b..d4aa21097 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -358,7 +358,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         }
 
 
-        vcfWriter.add(VariantContext.modifyAttributes(filteredVC,attributes));
+        vcfWriter.add(new VariantContextBuilder(filteredVC).attributes(attributes).make());
 
 
         return 1;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
index 1d6eb4b64..aa71f4399 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/ProduceBeagleInputWalker.java
@@ -201,7 +201,7 @@ public class ProduceBeagleInputWalker extends RodWalker<Integer, Integer> {
             logger.debug(String.format("boot: %d, test: %d, total: %d", bootstrapSetSize, testSetSize, bootstrapSetSize+testSetSize+1));
             if ( (bootstrapSetSize+1.0)/(1.0+bootstrapSetSize+testSetSize) <= bootstrap ) {
                 if ( bootstrapVCFOutput != null ) {
-                    bootstrapVCFOutput.add(VariantContext.modifyFilters(validation, BOOTSTRAP_FILTER));
+                    bootstrapVCFOutput.add(new VariantContextBuilder(validation).filters(BOOTSTRAP_FILTER).make());
                 }
                 bootstrapSetSize++;
                 return true;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
index 409e180ae..049b92084 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
@@ -36,10 +36,7 @@ import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.util.*;
 
@@ -225,7 +222,7 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
                  (vc.getFilters() == null || !vc.getFilters().contains(MASK_NAME)) ) { // the filter hasn't already been applied
                 Set<String> filters = new LinkedHashSet<String>(vc.getFilters());
                 filters.add(MASK_NAME);
-                vc = VariantContext.modifyFilters(vc, filters);
+                vc = new VariantContextBuilder(vc).filters(filters).make();
             }
 
             FiltrationContext varContext = new FiltrationContext(ref, vc);
@@ -268,7 +265,7 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
              (vc.getFilters() == null || !vc.getFilters().contains(MASK_NAME)) ) { // the filter hasn't already been applied
             Set<String> filters = new LinkedHashSet<String>(vc.getFilters());
             filters.add(MASK_NAME);
-            vc = VariantContext.modifyFilters(vc, filters);
+            vc = new VariantContextBuilder(vc).filters(filters).make();
         }
 
         return vc;
@@ -325,7 +322,7 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
 
         VariantContext filteredVC;
         if ( genotypes == null )
-            filteredVC = VariantContext.modifyFilters(vc, filters);
+            filteredVC = new VariantContextBuilder(vc).filters(filters).make();
         else
             filteredVC = new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), filters, vc.getAttributes());
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
index 6dc31edb8..60513ca5f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
@@ -35,10 +35,7 @@ import org.broadinstitute.sting.gatk.walkers.RodWalker;
 import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.util.*;
 
@@ -111,7 +108,7 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
         try {
             Map<String, Object> attrs = new HashMap<String, Object>(value.getAttributes());
             VariantContextUtils.calculateChromosomeCounts(value, attrs, true);
-            writer.add(VariantContext.modifyAttributes(value, attrs));
+            writer.add(new VariantContextBuilder(value).attributes(attrs).make());
         } catch (IllegalArgumentException e) {
             throw new IllegalArgumentException(e.getMessage() + "; this is often caused by using the --assume_single_sample_reads argument with the wrong sample name");
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
index 5692c2525..0fe7e1fc2 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
@@ -229,8 +229,7 @@ public class UnifiedGenotyperEngine {
             VariantContext vcInput = UnifiedGenotyperEngine.getVCFromAllelesRod(tracker, ref, rawContext.getLocation(), false, logger, UAC.alleles);
             if ( vcInput == null )
                 return null;
-            vc = new VariantContext("UG_call", VCFConstants.EMPTY_ID_FIELD, vcInput.getChr(), vcInput.getStart(), vcInput.getEnd(), vcInput.getAlleles(), VariantContext.NO_NEG_LOG_10PERROR, null, null, ref.getBase());
-
+            vc = new VariantContextBuilder(vcInput).source("UG_call").noID().referenceBaseForIndel(ref.getBase()).make();
         } else {
             // deal with bad/non-standard reference bases
             if ( !Allele.acceptableAlleleBases(new byte[]{ref.getBase()}) )
@@ -238,7 +237,7 @@ public class UnifiedGenotyperEngine {
 
             Set<Allele> alleles = new HashSet<Allele>();
             alleles.add(Allele.create(ref.getBase(), true));
-            vc = new VariantContext("UG_call", VCFConstants.EMPTY_ID_FIELD, ref.getLocus().getContig(), ref.getLocus().getStart(), ref.getLocus().getStart(), alleles);
+            vc = new VariantContextBuilder("UG_call", ref.getLocus().getContig(), ref.getLocus().getStart(), ref.getLocus().getStart(), alleles).make();
         }
         
         if ( annotationEngine != null ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
index b935600b2..2f15c165f 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/MergeSegregatingAlternateAllelesVCFWriter.java
@@ -33,10 +33,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFWriter;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.fasta.CachingIndexedFastaSequenceFile;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.File;
 import java.io.FileNotFoundException;
@@ -186,7 +183,7 @@ class MergeSegregatingAlternateAllelesVCFWriter implements VCFWriter {
 
                         Map<String, Object> addedAttribs = vcMergeRule.addToMergedAttributes(vcfrWaitingToMerge.vc, vc);
                         addedAttribs.putAll(mergedVc.getAttributes());
-                        mergedVc = VariantContext.modifyAttributes(mergedVc, addedAttribs);
+                        mergedVc = new VariantContextBuilder(mergedVc).attributes(addedAttribs).make();
 
                         vcfrWaitingToMerge = new VCFRecord(mergedVc, true);
                         numMergedRecords++;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
index 0b28459d4..088ff4c71 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
@@ -309,7 +309,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
                 genotypesContext.add(phasedMother, phasedFather, phasedChild);
             }
 
-            VariantContext newvc = VariantContext.modifyGenotypes(vc, genotypesContext);
+            VariantContext newvc = new VariantContextBuilder(vc).genotypes(genotypesContext).make();
 
             vcfWriter.add(newvc);
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
index fddef5129..cac171948 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
@@ -135,7 +135,7 @@ class PhasingUtils {
 
         mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
         VariantContextUtils.calculateChromosomeCounts(mergedVc, mergedAttribs, true);
-        mergedVc = VariantContext.modifyAttributes(mergedVc, mergedAttribs);
+        mergedVc = new VariantContextBuilder(mergedVc).attributes(mergedAttribs).make();
 
         return mergedVc;
     }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/GenotypeAndValidateWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/GenotypeAndValidateWalker.java
index 8f9f3f1af..f370e2818 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/GenotypeAndValidateWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/GenotypeAndValidateWalker.java
@@ -40,6 +40,7 @@ import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLine;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFWriter;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
 import java.util.Map;
@@ -465,7 +466,7 @@ public class GenotypeAndValidateWalker extends RodWalker<GenotypeAndValidateWalk
 
         if (vcfWriter != null && writeVariant) {
             if (!vcComp.hasAttribute("callStatus")) {
-                vcfWriter.add(VariantContext.modifyAttribute(vcComp, "callStatus", call.isCalledAlt(callConf) ? "ALT" : "REF"));
+                vcfWriter.add(new VariantContextBuilder(vcComp).attribute("callStatus", call.isCalledAlt(callConf) ? "ALT" : "REF").make());
             }
             else
                 vcfWriter.add(vcComp);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
index 4556692bd..0cc271b59 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
@@ -32,6 +32,7 @@ import org.broadinstitute.sting.utils.exceptions.StingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
 import java.io.File;
@@ -330,9 +331,7 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
                     for ( VariantContext eval : evalSetBySample ) {
                         // deal with ancestral alleles if requested
                         if ( eval != null && aastr != null ) {
-                            HashMap<String, Object> newAts = new HashMap<String, Object>(eval.getAttributes());
-                            newAts.put("ANCESTRALALLELE", aastr);
-                            eval = VariantContext.modifyAttributes(eval, newAts);
+                            eval = new VariantContextBuilder(eval).attribute("ANCESTRALALLELE", aastr).make();
                         }
 
                         // for each comp track
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
index 24caed549..6da693c7a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
@@ -16,6 +16,7 @@ import org.broadinstitute.sting.utils.classloader.PluginManager;
 import org.broadinstitute.sting.utils.exceptions.StingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
 import java.lang.reflect.Field;
@@ -289,7 +290,7 @@ public class VariantEvalUtils {
         }
 
         VariantContextUtils.calculateChromosomeCounts(vcsub, newAts, true);
-        vcsub = VariantContext.modifyAttributes(vcsub, newAts);
+        vcsub = new VariantContextBuilder(vcsub).attributes(newAts).make();
 
         //VariantEvalWalker.logger.debug(String.format("VC %s subset to %s AC%n", vc.getSource(), vc.getAttributeAsString(VCFConstants.ALLELE_COUNT_KEY)));
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantrecalibration/ApplyRecalibration.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantrecalibration/ApplyRecalibration.java
index 1d5493daf..b1b8fa46d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantrecalibration/ApplyRecalibration.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantrecalibration/ApplyRecalibration.java
@@ -41,6 +41,7 @@ import org.broadinstitute.sting.utils.collections.NestedHashMap;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.text.XReadLines;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 
 import java.io.File;
 import java.io.FileNotFoundException;
@@ -203,8 +204,9 @@ public class ApplyRecalibration extends RodWalker<Integer, Integer> {
         for( VariantContext vc : tracker.getValues(input, context.getLocation()) ) {
             if( vc != null ) {
                 if( VariantRecalibrator.checkRecalibrationMode( vc, MODE ) && (vc.isNotFiltered() || ignoreInputFilterSet.containsAll(vc.getFilters())) ) {
+                    VariantContextBuilder builder = new VariantContextBuilder(vc);
                     String filterString = null;
-                    final Map<String, Object> attrs = new HashMap<String, Object>(vc.getAttributes());
+
                     final Double lod = (Double) lodMap.get( vc.getChr(), vc.getStart(), vc.getEnd() );
                     final String worstAnnotation = (String) annotationMap.get( vc.getChr(), vc.getStart(), vc.getEnd() );
                     if( lod == null ) {
@@ -212,8 +214,8 @@ public class ApplyRecalibration extends RodWalker<Integer, Integer> {
                     }
 
                     // Annotate the new record with its VQSLOD and the worst performing annotation
-                    attrs.put(VariantRecalibrator.VQS_LOD_KEY, String.format("%.4f", lod));
-                    attrs.put(VariantRecalibrator.CULPRIT_KEY, worstAnnotation);
+                    builder.attribute(VariantRecalibrator.VQS_LOD_KEY, String.format("%.4f", lod));
+                    builder.attribute(VariantRecalibrator.CULPRIT_KEY, worstAnnotation);
 
                     for( int i = tranches.size() - 1; i >= 0; i-- ) {
                         final Tranche tranche = tranches.get(i);
@@ -232,11 +234,10 @@ public class ApplyRecalibration extends RodWalker<Integer, Integer> {
                     }
 
                     if( !filterString.equals(VCFConstants.PASSES_FILTERS_v4) ) {
-                        final Set<String> filters = new HashSet<String>();
-                        filters.add(filterString);
-                        vc = VariantContext.modifyFilters(vc, filters);
+                        builder.filters(filterString);
                     }
-                    vcfWriter.add( VariantContext.modifyPErrorFiltersAndAttributes(vc, vc.getNegLog10PError(), vc.getFilters(), attrs) );
+
+                    vcfWriter.add( builder.make() );
                 } else { // valid VC but not compatible with this mode, so just emit the variant untouched
                     vcfWriter.add( vc );
                 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/CombineVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/CombineVariants.java
index 573e15971..d74f5a269 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/CombineVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/CombineVariants.java
@@ -38,6 +38,7 @@ import org.broadinstitute.sting.utils.Utils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
 import java.util.*;
@@ -252,7 +253,7 @@ public class CombineVariants extends RodWalker<Integer, Integer> {
             HashMap<String, Object> attributes = new HashMap<String, Object>(mergedVC.getAttributes());
             // re-compute chromosome counts
             VariantContextUtils.calculateChromosomeCounts(mergedVC, attributes, false);
-            VariantContext annotatedMergedVC = VariantContext.modifyAttributes(mergedVC, attributes);
+            VariantContext annotatedMergedVC = new VariantContextBuilder(mergedVC).attributes(attributes).make();
             if ( minimalVCF )
                 annotatedMergedVC = VariantContextUtils.pruneVariantContext(annotatedMergedVC, Arrays.asList(SET_KEY));
             vcfWriter.add(annotatedMergedVC);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
index 4b3271ba6..f357f8a40 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
@@ -38,10 +38,7 @@ import org.broadinstitute.sting.gatk.walkers.*;
 import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.sam.AlignmentUtils;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.util.*;
 
@@ -161,7 +158,7 @@ public class LeftAlignVariants extends RodWalker<Integer, Integer> {
         // update if necessary and write
         if ( !newCigar.equals(originalCigar) && newCigar.numCigarElements() > 1 ) {
             int difference = originalIndex - newCigar.getCigarElement(0).getLength();
-            VariantContext newVC = VariantContext.modifyLocation(vc, vc.getChr(), vc.getStart()-difference, vc.getEnd()-difference);
+            VariantContext newVC = new VariantContextBuilder(vc).start(vc.getStart()-difference).stop(vc.getEnd()-difference).make();
             //System.out.println("Moving record from " + vc.getChr()+":"+vc.getStart() + " to " + vc.getChr()+":"+(vc.getStart()-difference));
 
             int indelIndex = originalIndex-difference;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LiftoverVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LiftoverVariants.java
index a932d44ed..50fafa202 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LiftoverVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LiftoverVariants.java
@@ -39,6 +39,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
 import java.io.File;
@@ -117,16 +118,15 @@ public class LiftoverVariants extends RodWalker<Integer, Integer> {
                 vc = VariantContextUtils.reverseComplement(vc);
             }
 
-            vc = VariantContext.modifyLocation(vc, toInterval.getSequence(), toInterval.getStart(), toInterval.getStart() + length);
+            vc = new VariantContextBuilder(vc).loc(toInterval.getSequence(), toInterval.getStart(), toInterval.getStart() + length).make();
 
             if ( RECORD_ORIGINAL_LOCATION ) {
-                HashMap<String, Object> attrs = new HashMap<String, Object>(vc.getAttributes());
-                attrs.put("OriginalChr", fromInterval.getSequence());
-                attrs.put("OriginalStart", fromInterval.getStart());
-                vc = VariantContext.modifyAttributes(vc, attrs);
+                vc = new VariantContextBuilder(vc)
+                        .attribute("OriginalChr", fromInterval.getSequence())
+                        .attribute("OriginalStart", fromInterval.getStart()).make();
             }
 
-            VariantContext newVC = VariantContext.createVariantContextWithPaddedAlleles(vc, false);
+            VariantContext newVC = VariantContextUtils.createVariantContextWithPaddedAlleles(vc, false);
             if ( originalVC.isSNP() && originalVC.isBiallelic() && VariantContextUtils.getSNPSubstitutionType(originalVC) != VariantContextUtils.getSNPSubstitutionType(newVC) ) {
                 logger.warn(String.format("VCF at %s / %d => %s / %d is switching substitution type %s/%s to %s/%s",
                         originalVC.getChr(), originalVC.getStart(), newVC.getChr(), newVC.getStart(),
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index 7f6e605e7..be9a193d3 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -654,16 +654,12 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
         if ( samples == null || samples.isEmpty() )
             return vc;
 
-//        logger.info("Genotypes in full  vc: " + vc.getGenotypes());
-//        logger.info("My own sub           : " + vc.getGenotypes().subsetToSamples(samples));
-        VariantContext sub = vc.subContextFromSamples(samples, vc.getAlleles());
-//        logger.info("Genotypes in sub   vc: " + sub.getGenotypes());
+        final VariantContext sub = vc.subContextFromSamples(samples, vc.getAlleles());
+        VariantContextBuilder builder = new VariantContextBuilder(sub);
 
         // if we have fewer alternate alleles in the selected VC than in the original VC, we need to strip out the GL/PLs (because they are no longer accurate)
         if ( vc.getAlleles().size() != sub.getAlleles().size() )
-            sub = VariantContext.modifyGenotypes(sub, VariantContextUtils.stripPLs(vc.getGenotypes()));
-
-        HashMap<String, Object> attributes = new HashMap<String, Object>(sub.getAttributes());
+            builder.genotypes(VariantContextUtils.stripPLs(vc.getGenotypes()));
 
         int depth = 0;
         for (String sample : sub.getSampleNames()) {
@@ -680,22 +676,19 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
 
 
         if (KEEP_ORIGINAL_CHR_COUNTS) {
-            if ( attributes.containsKey(VCFConstants.ALLELE_COUNT_KEY) )
-                attributes.put("AC_Orig",attributes.get(VCFConstants.ALLELE_COUNT_KEY));
-            if ( attributes.containsKey(VCFConstants.ALLELE_FREQUENCY_KEY) )
-                attributes.put("AF_Orig",attributes.get(VCFConstants.ALLELE_FREQUENCY_KEY));
-            if ( attributes.containsKey(VCFConstants.ALLELE_NUMBER_KEY) )
-                attributes.put("AN_Orig",attributes.get(VCFConstants.ALLELE_NUMBER_KEY));
-
+            if ( sub.hasAttribute(VCFConstants.ALLELE_COUNT_KEY) )
+                builder.attribute("AC_Orig",sub.getAttribute(VCFConstants.ALLELE_COUNT_KEY));
+            if ( sub.hasAttribute(VCFConstants.ALLELE_FREQUENCY_KEY) )
+                builder.attribute("AF_Orig",sub.getAttribute(VCFConstants.ALLELE_FREQUENCY_KEY));
+            if ( sub.hasAttribute(VCFConstants.ALLELE_NUMBER_KEY) )
+                builder.attribute("AN_Orig",sub.getAttribute(VCFConstants.ALLELE_NUMBER_KEY));
         }
 
-        VariantContextUtils.calculateChromosomeCounts(sub,attributes,false);
+        Map<String, Object> attributes = new HashMap<String, Object>(builder.make().getAttributes());
+        VariantContextUtils.calculateChromosomeCounts(sub, attributes, false);
         attributes.put("DP", depth);
 
-        sub = VariantContext.modifyAttributes(sub, attributes);
-
-//        logger.info("Genotypes in final vc: " + sub.getGenotypes());
-        return sub;
+        return new VariantContextBuilder(builder.make()).attributes(attributes).make();
     }
 
     private void randomlyAddVariant(int rank, VariantContext vc, byte refBase) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantValidationAssessor.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantValidationAssessor.java
index 4e6cc722d..79bbea29d 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantValidationAssessor.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantValidationAssessor.java
@@ -36,6 +36,7 @@ import org.broadinstitute.sting.utils.SampleUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
 
 import java.util.*;
@@ -227,24 +228,24 @@ public class VariantValidationAssessor extends RodWalker<VariantContext,Integer>
             numHomVarViolations++;
             isViolation = true;
         }
-        vContext = VariantContext.modifyFilters(vContext, filters);
+
+        VariantContextBuilder builder = new VariantContextBuilder(vContext).filters(filters);
         numRecords++;
 
         // add the info fields
-        HashMap<String, Object> infoMap = new HashMap<String, Object>();
-        infoMap.put("NoCallPct", String.format("%.1f", 100.0*noCallProp));
-        infoMap.put("HomRefPct", String.format("%.1f", 100.0*homRefProp));
-        infoMap.put("HomVarPct", String.format("%.1f", 100.0*homVarProp));
-        infoMap.put("HetPct", String.format("%.1f", 100.0*hetProp));
-        infoMap.put("HW", String.format("%.2f", hwScore));
+        builder.attribute("NoCallPct", String.format("%.1f", 100.0*noCallProp));
+        builder.attribute("HomRefPct", String.format("%.1f", 100.0*homRefProp));
+        builder.attribute("HomVarPct", String.format("%.1f", 100.0*homVarProp));
+        builder.attribute("HetPct", String.format("%.1f", 100.0*hetProp));
+        builder.attribute("HW", String.format("%.2f", hwScore));
         Collection<Allele> altAlleles = vContext.getAlternateAlleles();
         int altAlleleCount = altAlleles.size() == 0 ? 0 : vContext.getChromosomeCount(altAlleles.iterator().next());
         if ( !isViolation && altAlleleCount > 0 )
             numTrueVariants++;
-        infoMap.put(VCFConstants.ALLELE_COUNT_KEY, String.format("%d", altAlleleCount));
-        infoMap.put(VCFConstants.ALLELE_NUMBER_KEY, String.format("%d", vContext.getChromosomeCount()));
+        builder.attribute(VCFConstants.ALLELE_COUNT_KEY, String.format("%d", altAlleleCount));
+        builder.attribute(VCFConstants.ALLELE_NUMBER_KEY, String.format("%d", vContext.getChromosomeCount()));
 
-        return VariantContext.modifyAttributes(vContext, infoMap);
+        return builder.make();
     }
 
     private double hardyWeinbergCalculation(VariantContext vc) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
index 78cfde1bd..f5928b723 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToVCF.java
@@ -121,22 +121,22 @@ public class VariantsToVCF extends RodWalker<Integer, Integer> {
         Collection<VariantContext> contexts = getVariantContexts(tracker, ref);
 
         for ( VariantContext vc : contexts ) {
+            VariantContextBuilder builder = new VariantContextBuilder(vc);
             if ( rsID != null && vc.emptyID() ) {
-                vc = VariantContext.modifyID(vc, rsID);
+                builder.id(rsID).make();
             }
 
             // set the appropriate sample name if necessary
             if ( sampleName != null && vc.hasGenotypes() && vc.hasGenotype(variants.getName()) ) {
                 Genotype g = Genotype.modifyName(vc.getGenotype(variants.getName()), sampleName);
-                GenotypesContext genotypes = GenotypesContext.create(g);
-                vc = VariantContext.modifyGenotypes(vc, genotypes);
+                builder.genotypes(g);
             }
 
             if ( fixReferenceBase ) {
-                vc = VariantContext.modifyReferencePadding(vc, ref.getBase());
+                builder.referenceBaseForIndel(ref.getBase());
             }
 
-            writeRecord(vc, tracker, ref.getLocus());
+            writeRecord(builder.make(), tracker, ref.getLocus());
         }
 
         return 1;
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index 725cc8109..ba138a9da 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -13,6 +13,7 @@ import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
 
 import java.io.*;
 import java.util.*;
@@ -252,29 +253,30 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
      * @return a variant context object
      */
     private VariantContext parseVCFLine(String[] parts) {
+        VariantContextBuilder builder = new VariantContextBuilder();
         // increment the line count
         lineNo++;
 
         // parse out the required fields
-        String contig = getCachedString(parts[0]);
+        builder.chr(getCachedString(parts[0]));
         int pos = Integer.valueOf(parts[1]);
-        String id = null;
+        builder.start(pos);
+
         if ( parts[2].length() == 0 )
             generateException("The VCF specification requires a valid ID field");
         else if ( parts[2].equals(VCFConstants.EMPTY_ID_FIELD) )
-            id = VCFConstants.EMPTY_ID_FIELD;
+            builder.noID();
         else
-            id = parts[2];
+            builder.id(parts[2]);
+
         String ref = getCachedString(parts[3].toUpperCase());
         String alts = getCachedString(parts[4].toUpperCase());
-        Double qual = parseQual(parts[5]);
-        String filter = getCachedString(parts[6]);
-        String info = new String(parts[7]);
+        builder.negLog10PError(parseQual(parts[5]));
+        builder.filters(parseFilters(getCachedString(parts[6])));
+        builder.attributes(parseInfo(parts[7]));
 
         // get our alleles, filters, and setup an attribute map
         List<Allele> alleles = parseAlleles(ref, alts, lineNo);
-        Set<String> filters = parseFilters(filter);
-        Map<String, Object> attributes = parseInfo(info);
 
         // find out our current location, and clip the alleles down to their minimum length
         int loc = pos;
@@ -286,16 +288,19 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
             loc = clipAlleles(pos, ref, alleles, newAlleles, lineNo);
             alleles = newAlleles;
         }
+        builder.stop(loc);
+        builder.alleles(alleles);
 
         // do we have genotyping data
         if (parts.length > NUM_STANDARD_FIELDS) {
-            attributes.put(VariantContext.UNPARSED_GENOTYPE_MAP_KEY, new String(parts[8]));
-            attributes.put(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY, this);
+            builder.attribute(VariantContext.UNPARSED_GENOTYPE_MAP_KEY, new String(parts[8]));
+            builder.attribute(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY, this);
         }
 
         VariantContext vc = null;
         try {
-            vc =  new VariantContext(name, id, contig, pos, loc, alleles, qual, filters, attributes, ref.getBytes()[0]);
+            builder.referenceBaseForIndel(ref.getBytes()[0]);
+            vc = builder.make();
         } catch (Exception e) {
             generateException(e.getMessage());
         }
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
index 63c61cfaa..37137f716 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
@@ -25,18 +25,10 @@
 package org.broadinstitute.sting.utils.codecs.vcf;
 
 import net.sf.samtools.SAMSequenceDictionary;
-import org.broad.tribble.Tribble;
 import org.broad.tribble.TribbleException;
-import org.broad.tribble.index.DynamicIndexCreator;
-import org.broad.tribble.index.Index;
-import org.broad.tribble.index.IndexFactory;
-import org.broad.tribble.util.LittleEndianOutputStream;
 import org.broad.tribble.util.ParsingUtils;
-import org.broad.tribble.util.PositionalStream;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.*;
 import java.lang.reflect.Array;
@@ -164,10 +156,10 @@ public class StandardVCFWriter extends IndexingVCFWriter {
             throw new IllegalStateException("The VCF Header must be written before records can be added: " + getStreamName());
 
         if ( doNotWriteGenotypes )
-            vc = VariantContext.modifyGenotypes(vc, null);
+            vc = new VariantContextBuilder(vc).noGenotypes().make();
 
         try {
-            vc = VariantContext.createVariantContextWithPaddedAlleles(vc, false);
+            vc = VariantContextUtils.createVariantContextWithPaddedAlleles(vc, false);
             super.add(vc);
 
             Map<Allele, String> alleleMap = new HashMap<Allele, String>(vc.getAlleles().size());
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
index 57edbbfcc..4ffc8e966 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
@@ -14,12 +14,12 @@ import java.util.*;
 final class CommonInfo {
     public static final double NO_NEG_LOG_10PERROR = -1.0;
 
-    private static Set<String> NO_FILTERS = Collections.unmodifiableSet(new HashSet<String>());
+    private static Set<String> NO_FILTERS = Collections.emptySet();
     private static Map<String, Object> NO_ATTRIBUTES = Collections.unmodifiableMap(new HashMap<String, Object>());
 
     private double negLog10PError = NO_NEG_LOG_10PERROR;
     private String name = null;
-    private Set<String> filters = NO_FILTERS;
+    private Set<String> filters = null;
     private Map<String, Object> attributes = NO_ATTRIBUTES;
 
     public CommonInfo(String name, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
@@ -56,12 +56,20 @@ final class CommonInfo {
     //
     // ---------------------------------------------------------------------------------------------------------
 
+    public Set<String> getFiltersMaybeNull() {
+        return filters;
+    }
+
     public Set<String> getFilters() {
-        return Collections.unmodifiableSet(filters);
+        return filters == null ? NO_FILTERS : Collections.unmodifiableSet(filters);
+    }
+
+    public boolean filtersWereApplied() {
+        return filters != null;
     }
 
     public boolean isFiltered() {
-        return filters.size() > 0;
+        return filters == null ? false : filters.size() > 0;
     }
 
     public boolean isNotFiltered() {
@@ -69,8 +77,8 @@ final class CommonInfo {
     }
 
     public void addFilter(String filter) {
-        if ( filters == NO_FILTERS ) // immutable -> mutable
-            filters = new HashSet<String>(filters);
+        if ( filters == null ) // immutable -> mutable
+            filters = new HashSet<String>();
 
         if ( filter == null ) throw new IllegalArgumentException("BUG: Attempting to add null filter " + this);
         if ( getFilters().contains(filter) ) throw new IllegalArgumentException("BUG: Attempting to add duplicate filter " + filter + " at " + this);
@@ -83,15 +91,6 @@ final class CommonInfo {
             addFilter(f);
     }
 
-    public void clearFilters() {
-        filters = new HashSet<String>();
-    }
-
-    public void setFilters(Collection<String> filters) {
-        clearFilters();
-        addFilters(filters);
-    }
-
     // ---------------------------------------------------------------------------------------------------------
     //
     // Working with log error rates
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
index 28f2d85fc..f1574cec2 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
@@ -23,7 +23,6 @@ public class Genotype {
     protected Type type = null;
 
     protected boolean isPhased = false;
-    protected boolean filtersWereAppliedToContext;
 
     public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, boolean isPhased) {
         this(sampleName, alleles, negLog10PError, filters, attributes, isPhased, null);
@@ -35,7 +34,6 @@ public class Genotype {
         commonInfo = new CommonInfo(sampleName, negLog10PError, filters, attributes);
         if ( log10Likelihoods != null )
             commonInfo.putAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, GenotypeLikelihoods.fromLog10Likelihoods(log10Likelihoods));
-        filtersWereAppliedToContext = filters != null;
         this.isPhased = isPhased;
         validate();
     }
@@ -333,9 +331,10 @@ public class Genotype {
     // ---------------------------------------------------------------------------------------------------------
     public String getSampleName()       { return commonInfo.getName(); }
     public Set<String> getFilters()     { return commonInfo.getFilters(); }
+    public Set<String> getFiltersMaybeNull()    { return commonInfo.getFiltersMaybeNull(); }
     public boolean isFiltered()         { return commonInfo.isFiltered(); }
     public boolean isNotFiltered()      { return commonInfo.isNotFiltered(); }
-    public boolean filtersWereApplied() { return filtersWereAppliedToContext; }
+    public boolean filtersWereApplied() { return commonInfo.filtersWereApplied(); }
     public boolean hasNegLog10PError()  { return commonInfo.hasNegLog10PError(); }
     public double getNegLog10PError()   { return commonInfo.getNegLog10PError(); }
     public double getPhredScaledQual()  { return commonInfo.getPhredScaledQual(); }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 7798e259c..455a9b997 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -1,5 +1,6 @@
 package org.broadinstitute.sting.utils.variantcontext;
 
+import org.apache.commons.lang.Validate;
 import org.broad.tribble.Feature;
 import org.broad.tribble.TribbleException;
 import org.broad.tribble.util.ParsingUtils;
@@ -200,15 +201,29 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     // set to the alt allele when biallelic, otherwise == null
     private Allele ALT = null;
 
-    // were filters applied?
-    final private boolean filtersWereAppliedToContext;
+    /* cached monomorphic value: null -> not yet computed, False, True */
+    private Boolean monomorphic = null;
 
     // ---------------------------------------------------------------------------------------------------------
     //
-    // constructors
+    // validation mode
     //
     // ---------------------------------------------------------------------------------------------------------
 
+    public enum Validation {
+        REF_PADDING,
+        ALLELES,
+        GENOTYPES
+    }
+
+    private final static EnumSet<Validation> ALL_VALIDATION = EnumSet.allOf(Validation.class);
+    private final static EnumSet<Validation> NO_VALIDATION = EnumSet.noneOf(Validation.class);
+
+    // ---------------------------------------------------------------------------------------------------------
+    //
+    // constructors: see VariantContextBuilder
+    //
+    // ---------------------------------------------------------------------------------------------------------
 
     /**
      * the complete constructor.  Makes a complete VariantContext from its arguments
@@ -224,14 +239,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
+     *
+     * @deprecated  replaced by {@link VariantContextBuilder}
      */
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
-        this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, true);
-    }
-
     @Deprecated
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
-        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel);
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+        this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, ALL_VALIDATION);
     }
 
 
@@ -247,66 +260,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param negLog10PError  qual
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
+     *
+     * @deprecated  replaced by {@link VariantContextBuilder}
      */
+    @Deprecated
     public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, true);
-    }
-
-    @Deprecated
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
-    }
-
-    /**
-     * Makes a VariantContext from its arguments without parsing the genotypes.
-     * Note that this constructor assumes that if there is genotype data, then it's been put into
-     * the attributes with the UNPARSED_GENOTYPE_MAP_KEY and that the codec has been added with the
-     * UNPARSED_GENOTYPE_PARSER_KEY.  It doesn't validate that this is the case because it's possible
-     * that there is no genotype data.
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles         alleles
-     * @param negLog10PError  qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     * @param referenceBaseForIndel   padded reference base
-     */
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
-        this(source, ID, contig, start, stop, alleles, NO_GENOTYPES, negLog10PError, filters, attributes, referenceBaseForIndel, true, true);
-    }
-
-    @Deprecated
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
-        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, negLog10PError, filters, attributes, referenceBaseForIndel);
-    }
-
-    /**
-     * Create a new VariantContext
-     *
-     * @param source         source
-     * @param contig         the contig
-     * @param start          the start base (one based)
-     * @param stop           the stop reference base (one based)
-     * @param alleles        alleles
-     * @param genotypes      genotypes set
-     * @param negLog10PError qual
-     * @param filters        filters: use null for unfiltered and empty set for passes filters
-     * @param attributes     attributes
-     */
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        this(source, ID, contig, start, stop, alleles,
-                GenotypesContext.copy(genotypes),
-                negLog10PError, filters, attributes, null, false, true);
-    }
-
-    @Deprecated
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles,
-                GenotypesContext.copy(genotypes),
-                negLog10PError, filters, attributes);
+        this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, ALL_VALIDATION);
     }
 
     /**
@@ -317,33 +276,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param start           the start base (one based)
      * @param stop            the stop reference base (one based)
      * @param alleles alleles
-     */
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles) {
-        this(source, ID, contig, start, stop, alleles, NO_GENOTYPES, CommonInfo.NO_NEG_LOG_10PERROR, null, null, null, false, true);
-    }
-
-    @Deprecated
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles) {
-        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles);
-    }
-
-    /**
-     * Create a new variant context with genotypes but without Perror, filters, and attributes
      *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles   alleles
-     * @param genotypes genotypes
+     * @deprecated  replaced by {@link VariantContextBuilder}
      */
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        this(source, ID, contig, start, stop, alleles, genotypes, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
-    }
-
     @Deprecated
-    public VariantContext(String source, String contig, long start, long stop, Collection<Allele> alleles, Collection<Genotype> genotypes) {
-        this(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleles, genotypes, CommonInfo.NO_NEG_LOG_10PERROR, null, null);
+    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles) {
+        this(source, ID, contig, start, stop, alleles, NO_GENOTYPES, CommonInfo.NO_NEG_LOG_10PERROR, null, null, null, false, ALL_VALIDATION);
     }
 
     /**
@@ -351,8 +289,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      *
      * @param other the VariantContext to copy
      */
-    public VariantContext(VariantContext other) {
-        this(other.getSource(), other.getID(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, true);
+    protected VariantContext(VariantContext other) {
+        this(other.getSource(), other.getID(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, NO_VALIDATION);
     }
 
     /**
@@ -369,14 +307,14 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
      * @param genotypesAreUnparsed    true if the genotypes have not yet been parsed
-     * @param performValidation       if true, call validate() as the final step in construction
+     * @param validationToPerform     set of validation steps to take
      */
-    private VariantContext(String source, String ID,
+    protected VariantContext(String source, String ID,
                            String contig, long start, long stop,
                            Collection<Allele> alleles, GenotypesContext genotypes,
                            double negLog10PError, Set<String> filters, Map<String, Object> attributes,
                            Byte referenceBaseForIndel, boolean genotypesAreUnparsed,
-                           boolean performValidation ) {
+                           EnumSet<Validation> validationToPerform ) {
         if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
         this.contig = contig;
         this.start = start;
@@ -398,7 +336,6 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         }
 
         this.commonInfo = new CommonInfo(source, negLog10PError, filters, attributes);
-        filtersWereAppliedToContext = filters != null;
         REFERENCE_BASE_FOR_INDEL = referenceBaseForIndel;
 
         // todo -- remove me when this check is no longer necessary
@@ -426,69 +363,11 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             }
         }
 
-        if ( performValidation ) {
-            validate();
+        if ( ! validationToPerform.isEmpty() ) {
+            validate(validationToPerform);
         }
     }
 
-    // ---------------------------------------------------------------------------------------------------------
-    //
-    // Partial-cloning routines (because Variant Context is immutable).
-    //
-    //    IMPORTANT: These routines assume that the VariantContext on which they're called is already valid.
-    //               Due to this assumption, they explicitly tell the constructor NOT to perform validation by
-    //               calling validate(), and instead perform validation only on the data that's changed.
-    //
-    //    Note that we don't call vc.getGenotypes() because that triggers the lazy loading.
-    //    Also note that we need to create a new attributes map because it's unmodifiable and the constructor may try to modify it.
-    //
-    // ---------------------------------------------------------------------------------------------------------
-
-    public static VariantContext modifyGenotypes(VariantContext vc, GenotypesContext genotypes) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), vc.getReferenceBaseForIndel(), false, false);
-        modifiedVC.validateGenotypes();
-        return modifiedVC;
-    }
-
-    public static VariantContext modifyLocation(VariantContext vc, String chr, int start, int end) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getID(), chr, start, end, vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), vc.getReferenceBaseForIndel(), true, false);
-
-        // Since start and end have changed, we need to call both validateAlleles() and validateReferencePadding(),
-        // since those validation routines rely on the values of start and end:
-        modifiedVC.validateAlleles();
-        modifiedVC.validateReferencePadding();
-
-        return modifiedVC;
-    }
-
-    public static VariantContext modifyFilters(VariantContext vc, Set<String> filters) {
-        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), filters, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
-    }
-
-    public static VariantContext modifyAttributes(VariantContext vc, Map<String, Object> attributes) {
-        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
-    }
-
-    public static VariantContext modifyAttribute(VariantContext vc, final String key, final Object value) {
-        Map<String, Object> attributes = new HashMap<String, Object>(vc.getAttributes());
-        attributes.put(key, value);
-        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, attributes, vc.getReferenceBaseForIndel(), true, false);
-    }
-
-    public static VariantContext modifyReferencePadding(VariantContext vc, Byte b) {
-        VariantContext modifiedVC = new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), b, true, false);
-        modifiedVC.validateReferencePadding();
-        return modifiedVC;
-    }
-
-    public static VariantContext modifyPErrorFiltersAndAttributes(VariantContext vc, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), vc.genotypes, negLog10PError, filters, attributes, vc.getReferenceBaseForIndel(), true, false);
-    }
-
-    public static VariantContext modifyID(final VariantContext vc, final String id) {
-        return new VariantContext(vc.getSource(), id, vc.getChr(), vc.getStart(), vc.getEnd() , vc.getAlleles(), vc.genotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, new HashMap<String, Object>(vc.getAttributes()), vc.getReferenceBaseForIndel(), true, false);
-    }
-
     // ---------------------------------------------------------------------------------------------------------
     //
     // Selectors
@@ -771,10 +650,11 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
     public String getSource()                   { return commonInfo.getName(); }
+    public Set<String> getFiltersMaybeNull()    { return commonInfo.getFiltersMaybeNull(); }
     public Set<String> getFilters()             { return commonInfo.getFilters(); }
     public boolean isFiltered()                 { return commonInfo.isFiltered(); }
     public boolean isNotFiltered()              { return commonInfo.isNotFiltered(); }
-    public boolean filtersWereApplied()         { return filtersWereAppliedToContext; }
+    public boolean filtersWereApplied()         { return commonInfo.filtersWereApplied(); }
     public boolean hasNegLog10PError()          { return commonInfo.hasNegLog10PError(); }
     public double getNegLog10PError()           { return commonInfo.getNegLog10PError(); }
     public double getPhredScaledQual()          { return commonInfo.getPhredScaledQual(); }
@@ -1092,7 +972,9 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return true if it's monomorphic
      */
     public boolean isMonomorphic() {
-        return ! isVariant() || (hasGenotypes() && getChromosomeCount(getReference()) == getChromosomeCount());
+        if ( monomorphic == null )
+            monomorphic = ! isVariant() || (hasGenotypes() && getChromosomeCount(getReference()) == getChromosomeCount());
+        return monomorphic;
     }
 
     /**
@@ -1301,23 +1183,14 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    /**
-     * To be called by any modifying routines
-     */
-    private boolean validate() {
-        return validate(true);
-    }
-
-    private boolean validate(boolean throwException) {
-        try {
-            validateReferencePadding();
-            validateAlleles();
-            validateGenotypes();
-        } catch ( IllegalArgumentException e ) {
-            if ( throwException )
-                throw e;
-            else
-                return false;
+    private boolean validate(final EnumSet<Validation> validationToPerform) {
+        for (final Validation val : validationToPerform ) {
+            switch (val) {
+                case ALLELES: validateAlleles(); break;
+                case REF_PADDING: validateReferencePadding(); break;
+                case GENOTYPES: validateGenotypes(); break;
+                default: throw new IllegalArgumentException("Unexpected validation mode " + val);
+            }
         }
 
         return true;
@@ -1512,8 +1385,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         return (int)stop;
     }
 
-    private boolean hasSymbolicAlleles() {
-        for (Allele a: getAlleles()) {
+    public boolean hasSymbolicAlleles() {
+        for (final Allele a: getAlleles()) {
             if (a.isSymbolic()) {
                 return true;
             }
@@ -1521,84 +1394,6 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         return false;
     }
 
-    public static VariantContext createVariantContextWithPaddedAlleles(VariantContext inputVC, boolean refBaseShouldBeAppliedToEndOfAlleles) {
-
-        // see if we need to pad common reference base from all alleles
-        boolean padVC;
-
-        // We need to pad a VC with a common base if the length of the reference allele is less than the length of the VariantContext.
-        // This happens because the position of e.g. an indel is always one before the actual event (as per VCF convention).
-        long locLength = (inputVC.getEnd() - inputVC.getStart()) + 1;
-        if (inputVC.hasSymbolicAlleles())
-            padVC = true;
-        else if (inputVC.getReference().length() == locLength)
-            padVC = false;
-        else if (inputVC.getReference().length() == locLength-1)
-            padVC = true;
-        else throw new IllegalArgumentException("Badly formed variant context at location " + String.valueOf(inputVC.getStart()) +
-                    " in contig " + inputVC.getChr() + ". Reference length must be at most one base shorter than location size");
-
-        // nothing to do if we don't need to pad bases
-        if (padVC) {
-
-            if ( !inputVC.hasReferenceBaseForIndel() )
-                throw new ReviewedStingException("Badly formed variant context at location " + inputVC.getChr() + ":" + inputVC.getStart() + "; no padded reference base is available.");
-
-            Byte refByte = inputVC.getReferenceBaseForIndel();
-
-            List<Allele> alleles = new ArrayList<Allele>();
-
-            for (Allele a : inputVC.getAlleles()) {
-                // get bases for current allele and create a new one with trimmed bases
-                if (a.isSymbolic()) {
-                    alleles.add(a);
-                } else {
-                    String newBases;
-                    if ( refBaseShouldBeAppliedToEndOfAlleles )
-                        newBases = a.getBaseString() + new String(new byte[]{refByte});
-                    else
-                        newBases = new String(new byte[]{refByte}) + a.getBaseString();
-                    alleles.add(Allele.create(newBases,a.isReference()));
-                }
-            }
-
-            // now we can recreate new genotypes with trimmed alleles
-            GenotypesContext genotypes = GenotypesContext.create(inputVC.getNSamples());
-            for (final Genotype g : inputVC.getGenotypes() ) {
-                List<Allele> inAlleles = g.getAlleles();
-                List<Allele> newGenotypeAlleles = new ArrayList<Allele>(g.getAlleles().size());
-                for (Allele a : inAlleles) {
-                    if (a.isCalled()) {
-                        if (a.isSymbolic()) {
-                            newGenotypeAlleles.add(a);
-                        } else {
-                            String newBases;
-                            if ( refBaseShouldBeAppliedToEndOfAlleles )
-                                newBases = a.getBaseString() + new String(new byte[]{refByte});
-                            else
-                                newBases = new String(new byte[]{refByte}) + a.getBaseString();
-                            newGenotypeAlleles.add(Allele.create(newBases,a.isReference()));
-                        }
-                    }
-                    else {
-                        // add no-call allele
-                        newGenotypeAlleles.add(Allele.NO_CALL);
-                    }
-                }
-                genotypes.add(new Genotype(g.getSampleName(), newGenotypeAlleles, g.getNegLog10PError(),
-                        g.getFilters(), g.getAttributes(), g.isPhased()));
-
-            }
-
-            // Do not change the filter state if filters were not applied to this context
-            Set<String> inputVCFilters = inputVC.filtersWereAppliedToContext ? inputVC.getFilters() : null;
-            return new VariantContext(inputVC.getSource(), inputVC.getID(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVCFilters, inputVC.getAttributes(),refByte);
-        }
-        else
-            return inputVC;
-
-    }
-
     public Allele getAltAlleleWithHighestAlleleCount() {
         // first idea: get two alleles with highest AC
         Allele best = null;
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
new file mode 100644
index 000000000..fb92f60a2
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
@@ -0,0 +1,245 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext;
+
+import com.google.java.contract.Requires;
+import org.broad.tribble.Feature;
+import org.broad.tribble.TribbleException;
+import org.broad.tribble.util.ParsingUtils;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFParser;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+
+import java.util.*;
+
+/**
+ * Builder class for VariantContext
+ *
+ * @author depristo
+ */
+public class VariantContextBuilder {
+    // required fields
+    private String source = null;
+    private String contig = null;
+    private long start = -1;
+    private long stop = -1;
+    private Collection<Allele> alleles = null;
+
+    // optional -> these are set to the appropriate default value
+    private String ID = VCFConstants.EMPTY_ID_FIELD;
+    private GenotypesContext genotypes = GenotypesContext.NO_GENOTYPES;
+    private double negLog10PError = VariantContext.NO_NEG_LOG_10PERROR;
+    private Set<String> filters = null;
+    private Map<String, Object> attributes = null;
+    private boolean attributesCanBeModified = false;
+    private Byte referenceBaseForIndel = null;
+    private boolean genotypesAreUnparsed = false;
+
+    /** enum of what must be validated */
+    final private EnumSet<VariantContext.Validation> toValidate = EnumSet.noneOf(VariantContext.Validation.class);
+
+    public VariantContextBuilder() {
+
+    }
+
+    public VariantContextBuilder(String source, String contig, long start, long stop, Collection<Allele> alleles) {
+        this.source = source;
+        this.contig = contig;
+        this.start = start;
+        this.stop = stop;
+        this.alleles = alleles;
+        toValidate.add(VariantContext.Validation.ALLELES);
+    }
+
+    /**
+     * Returns a new builder based on parent -- the new VC will have all fields initialized
+     * to their corresponding values in parent.  This is the best way to create a derived VariantContext
+     *
+     * @param parent
+     */
+    public VariantContextBuilder(VariantContext parent) {
+        this.alleles = parent.alleles;
+        this.attributes = parent.getAttributes();
+        this.attributesCanBeModified = false;
+        this.contig = parent.contig;
+        this.filters = parent.getFiltersMaybeNull();
+        this.genotypes = parent.genotypes;
+        this.genotypesAreUnparsed = parent.hasAttribute(VariantContext.UNPARSED_GENOTYPE_MAP_KEY);
+        this.ID = parent.getID();
+        this.negLog10PError = parent.getNegLog10PError();
+        this.referenceBaseForIndel = parent.getReferenceBaseForIndel();
+        this.source = parent.getSource();
+        this.start = parent.getStart();
+        this.stop = parent.getEnd();
+    }
+
+    @Requires({"alleles != null", "!alleles.isEmpty()"})
+    public VariantContextBuilder alleles(final Collection<Allele> alleles) {
+        this.alleles = alleles;
+        toValidate.add(VariantContext.Validation.ALLELES);
+        return this;
+    }
+
+    /**
+     * Attributes can be null -> meaning there are no attributes.  After
+     * calling this routine the builder assumes it can modify the attributes
+     * object here, if subsequent calls are made to set attribute values
+     * @param attributes
+     */
+    public VariantContextBuilder attributes(final Map<String, Object> attributes) {
+        this.attributes = attributes;
+        this.attributesCanBeModified = true;
+        return this;
+    }
+
+    public VariantContextBuilder attribute(final String key, final Object value) {
+        if ( ! attributesCanBeModified ) {
+            this.attributesCanBeModified = true;
+            this.attributes = new HashMap<String, Object>();
+        }
+        attributes.put(key, value);
+        return this;
+    }
+
+    /**
+     * filters can be null -> meaning there are no filters
+     * @param filters
+     */
+    public VariantContextBuilder filters(final Set<String> filters) {
+        this.filters = filters;
+        return this;
+    }
+
+    public VariantContextBuilder filters(final String ... filters) {
+        filters(new HashSet<String>(Arrays.asList(filters)));
+        return this;
+    }
+
+    public VariantContextBuilder passFilters() {
+        return filters(VariantContext.PASSES_FILTERS);
+    }
+
+    public VariantContextBuilder unfiltered() {
+        this.filters = null;
+        return this;
+    }
+
+    /**
+     * genotypes can be null -> meaning there are no genotypes
+     * @param genotypes
+     */
+    public VariantContextBuilder genotypes(final GenotypesContext genotypes) {
+        this.genotypes = genotypes;
+        if ( genotypes != null )
+            toValidate.add(VariantContext.Validation.GENOTYPES);
+        return this;
+    }
+
+    public VariantContextBuilder genotypes(final Collection<Genotype> genotypes) {
+        return genotypes(GenotypesContext.copy(genotypes));
+    }
+
+    public VariantContextBuilder genotypes(final Genotype ... genotypes) {
+        return genotypes(GenotypesContext.copy(Arrays.asList(genotypes)));
+    }
+
+    public VariantContextBuilder noGenotypes() {
+        this.genotypes = null;
+        return this;
+    }
+
+    public VariantContextBuilder genotypesAreUnparsed(final boolean genotypesAreUnparsed) {
+        this.genotypesAreUnparsed = genotypesAreUnparsed;
+        return this;
+    }
+
+    @Requires("ID != null")
+    public VariantContextBuilder id(final String ID) {
+        this.ID = ID;
+        return this;
+    }
+
+    public VariantContextBuilder noID() {
+        return id(VCFConstants.EMPTY_ID_FIELD);
+    }
+
+    @Requires("negLog10PError <= 0")
+    public VariantContextBuilder negLog10PError(final double negLog10PError) {
+        this.negLog10PError = negLog10PError;
+        return this;
+    }
+
+    /**
+     * Null means no refBase is available
+     * @param referenceBaseForIndel
+     */
+    public VariantContextBuilder referenceBaseForIndel(final Byte referenceBaseForIndel) {
+        this.referenceBaseForIndel = referenceBaseForIndel;
+        toValidate.add(VariantContext.Validation.REF_PADDING);
+        return this;
+    }
+
+    @Requires("source != null")
+    public VariantContextBuilder source(final String source) {
+        this.source = source;
+        return this;
+    }
+
+    @Requires({"contig != null", "start >= 0", "stop >= 0"})
+    public VariantContextBuilder loc(final String contig, final long start, final long stop) {
+        this.contig = contig;
+        this.start = start;
+        this.stop = stop;
+        toValidate.add(VariantContext.Validation.ALLELES);
+        toValidate.add(VariantContext.Validation.REF_PADDING);
+        return this;
+    }
+
+    @Requires({"contig != null", "start >= 0", "stop >= 0"})
+    public VariantContextBuilder chr(final String contig) {
+        this.contig = contig;
+        return this;
+    }
+
+    @Requires({"start >= 0"})
+    public VariantContextBuilder start(final long start) {
+        this.start = start;
+        toValidate.add(VariantContext.Validation.ALLELES);
+        toValidate.add(VariantContext.Validation.REF_PADDING);
+        return this;
+    }
+
+    @Requires({"stop >= 0"})
+    public VariantContextBuilder stop(final long stop) {
+        this.stop = stop;
+        return this;
+    }
+
+    public VariantContext make() {
+        return new VariantContext(source, ID, contig, start, stop, alleles,
+                genotypes, negLog10PError, filters, attributes,
+                referenceBaseForIndel, genotypesAreUnparsed, toValidate);
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 5d2c86f84..d9057ea8f 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -116,6 +116,82 @@ public class VariantContextUtils {
         return new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attrs, g.isPhased());
     }
 
+    public static VariantContext createVariantContextWithPaddedAlleles(VariantContext inputVC, boolean refBaseShouldBeAppliedToEndOfAlleles) {
+        // see if we need to pad common reference base from all alleles
+        boolean padVC;
+
+        // We need to pad a VC with a common base if the length of the reference allele is less than the length of the VariantContext.
+        // This happens because the position of e.g. an indel is always one before the actual event (as per VCF convention).
+        long locLength = (inputVC.getEnd() - inputVC.getStart()) + 1;
+        if (inputVC.hasSymbolicAlleles())
+            padVC = true;
+        else if (inputVC.getReference().length() == locLength)
+            padVC = false;
+        else if (inputVC.getReference().length() == locLength-1)
+            padVC = true;
+        else throw new IllegalArgumentException("Badly formed variant context at location " + String.valueOf(inputVC.getStart()) +
+                    " in contig " + inputVC.getChr() + ". Reference length must be at most one base shorter than location size");
+
+        // nothing to do if we don't need to pad bases
+        if (padVC) {
+            if ( !inputVC.hasReferenceBaseForIndel() )
+                throw new ReviewedStingException("Badly formed variant context at location " + inputVC.getChr() + ":" + inputVC.getStart() + "; no padded reference base is available.");
+
+            Byte refByte = inputVC.getReferenceBaseForIndel();
+
+            List<Allele> alleles = new ArrayList<Allele>();
+
+            for (Allele a : inputVC.getAlleles()) {
+                // get bases for current allele and create a new one with trimmed bases
+                if (a.isSymbolic()) {
+                    alleles.add(a);
+                } else {
+                    String newBases;
+                    if ( refBaseShouldBeAppliedToEndOfAlleles )
+                        newBases = a.getBaseString() + new String(new byte[]{refByte});
+                    else
+                        newBases = new String(new byte[]{refByte}) + a.getBaseString();
+                    alleles.add(Allele.create(newBases,a.isReference()));
+                }
+            }
+
+            // now we can recreate new genotypes with trimmed alleles
+            GenotypesContext genotypes = GenotypesContext.create(inputVC.getNSamples());
+            for (final Genotype g : inputVC.getGenotypes() ) {
+                List<Allele> inAlleles = g.getAlleles();
+                List<Allele> newGenotypeAlleles = new ArrayList<Allele>(g.getAlleles().size());
+                for (Allele a : inAlleles) {
+                    if (a.isCalled()) {
+                        if (a.isSymbolic()) {
+                            newGenotypeAlleles.add(a);
+                        } else {
+                            String newBases;
+                            if ( refBaseShouldBeAppliedToEndOfAlleles )
+                                newBases = a.getBaseString() + new String(new byte[]{refByte});
+                            else
+                                newBases = new String(new byte[]{refByte}) + a.getBaseString();
+                            newGenotypeAlleles.add(Allele.create(newBases,a.isReference()));
+                        }
+                    }
+                    else {
+                        // add no-call allele
+                        newGenotypeAlleles.add(Allele.NO_CALL);
+                    }
+                }
+                genotypes.add(new Genotype(g.getSampleName(), newGenotypeAlleles, g.getNegLog10PError(),
+                        g.getFilters(), g.getAttributes(), g.isPhased()));
+
+            }
+
+            // Do not change the filter state if filters were not applied to this context
+            Set<String> inputVCFilters = inputVC.getFiltersMaybeNull();
+            return new VariantContext(inputVC.getSource(), inputVC.getID(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVCFilters, inputVC.getAttributes(),refByte);
+        }
+        else
+            return inputVC;
+
+    }
+
     /**
      * A simple but common wrapper for matching VariantContext objects using JEXL expressions
      */
@@ -257,7 +333,7 @@ public class VariantContextUtils {
     @Requires("vc != null")
     @Ensures("result != null")
     public static VariantContext sitesOnlyVariantContext(VariantContext vc) {
-        return VariantContext.modifyGenotypes(vc, null);
+        return new VariantContextBuilder(vc).noGenotypes().make();
     }
 
     /**
@@ -378,7 +454,7 @@ public class VariantContextUtils {
         for (VariantContext vc : prepaddedVCs) {
             // also a reasonable place to remove filtered calls, if needed
             if ( ! filteredAreUncalled || vc.isNotFiltered() )
-                VCs.add(VariantContext.createVariantContextWithPaddedAlleles(vc, false));
+                VCs.add(createVariantContextWithPaddedAlleles(vc, false));
         }
         if ( VCs.size() == 0 ) // everything is filtered out and we're filteredAreUncalled
             return null;
@@ -896,7 +972,7 @@ public class VariantContextUtils {
             newGenotypes.add(Genotype.modifyAttributes(genotype, attrs));
         }
 
-        return VariantContext.modifyGenotypes(vc, newGenotypes);
+        return new VariantContextBuilder(vc).genotypes(newGenotypes).make();
     }
 
     public static BaseUtils.BaseSubstitutionType getSNPSubstitutionType(VariantContext context) {
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java
deleted file mode 100755
index 6bb764f44..000000000
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/qc/TestVariantContextWalker.java
+++ /dev/null
@@ -1,137 +0,0 @@
-/*
- * Copyright (c) 2010 The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
- * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.walkers.qc;
-
-import org.broadinstitute.sting.commandline.Argument;
-import org.broadinstitute.sting.commandline.ArgumentCollection;
-import org.broadinstitute.sting.commandline.Output;
-import org.broadinstitute.sting.gatk.arguments.DbsnpArgumentCollection;
-import org.broadinstitute.sting.gatk.arguments.StandardVariantContextInputArgumentCollection;
-import org.broadinstitute.sting.gatk.contexts.AlignmentContext;
-import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
-import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
-import org.broadinstitute.sting.gatk.refdata.VariantContextAdaptors;
-import org.broadinstitute.sting.gatk.walkers.Reference;
-import org.broadinstitute.sting.gatk.walkers.RodWalker;
-import org.broadinstitute.sting.gatk.walkers.Window;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFHeader;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFHeaderLine;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFWriter;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-
-import java.io.PrintStream;
-import java.util.*;
-
-/**
- * Test routine for new VariantContext object
- */
-@Reference(window=@Window(start=-20,stop=1))
-public class TestVariantContextWalker extends RodWalker<Integer, Integer> {
-    @Output
-    PrintStream out;
-
-    @ArgumentCollection
-    protected StandardVariantContextInputArgumentCollection variantCollection = new StandardVariantContextInputArgumentCollection();
-
-    @Argument(fullName="takeFirstOnly", doc="Only take the first second at a locus, as opposed to all", required=false)
-    boolean takeFirstOnly = false;
-
-    @Argument(fullName="onlyContextsOfType", doc="Only take variant contexts of this type", required=false)
-    VariantContext.Type onlyOfThisType = null;
-
-    @Argument(fullName="onlyContextsStartinAtCurrentPosition", doc="Only take variant contexts at actually start at the current position, excluding those at span to the current location but start earlier", required=false)
-    boolean onlyContextsStartinAtCurrentPosition = false;
-
-    @Argument(fullName="printPerLocus", doc="If true, we'll print the variant contexts, in addition to counts", required=false)
-    boolean printContexts = false;
-
-    @Argument(fullName="outputVCF", doc="If provided, we'll convert the first input context into a VCF", required=false)
-    VCFWriter writer = null;
-
-    private boolean wroteHeader = false;
-
-    public Integer map(RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        if ( ref == null )
-            return 0;
-        else {
-            EnumSet<VariantContext.Type> allowedTypes = onlyOfThisType == null ? null : EnumSet.of(onlyOfThisType);
-
-            int n = 0;
-            List<VariantContext> contexts;
-            if ( onlyContextsStartinAtCurrentPosition )
-                contexts = tracker.getValues(variantCollection.variants, context.getLocation());
-            else // ! onlyContextsStartinAtCurrentPosition
-                contexts = tracker.getValues(variantCollection.variants);
-
-            for ( VariantContext vc : contexts ) {
-                if ( allowedTypes == null || allowedTypes.contains(vc.getType()) ) {
-                    // we need to trigger decoding of the genotype string to pass integration tests
-                    vc.getGenotypes();
-
-                    if ( writer != null && n == 0 ) {
-                        if ( ! wroteHeader ) {
-                            writer.writeHeader(createVCFHeader(vc));
-                            wroteHeader = true;
-                        }
-
-                        writer.add(vc);
-                    }
-
-                    n++;
-                    if ( printContexts ) out.printf("       %s%n", vc);
-                    if ( takeFirstOnly ) break;
-                }
-            }
-
-            if ( n > 0 && printContexts ) {
-                out.printf("%s => had %d variant context objects%n", context.getLocation(), n);
-                out.printf("---------------------------------------------%n");
-            }
-            
-            return n;
-        }
-    }
-
-    private static VCFHeader createVCFHeader(VariantContext vc) {
-        return new VCFHeader(new HashSet<VCFHeaderLine>(), vc.getGenotypes().getSampleNamesOrderedByName());
-    }
-
-    public Integer reduceInit() {
-        return 0;
-    }
-
-    public Integer reduce(Integer point, Integer sum) {
-        return point + sum;
-    }
-
-    @Override
-    public void onTraversalDone(Integer result) {
-        // Double check traversal result to make count is the same.
-        // TODO: Is this check necessary?
-        out.println("[REDUCE RESULT] Traversal result is: " + result);
-    }
-}
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
index fae7cb05a..6bc71a76d 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -230,7 +230,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
                             for ( final Genotype g : vc.getGenotypes() ) {
                                 gc.add(new Genotype(g.getSampleName()+"_"+i, g));
                             }
-                            toMerge.add(VariantContext.modifyGenotypes(vc, gc));
+                            toMerge.add(new VariantContextBuilder(vc).genotypes(gc).make());
                         }
 
                         VariantContextUtils.simpleMerge(b37GenomeLocParser, toMerge, null,
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index 5bc72e132..38c4f84ab 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -255,7 +255,7 @@ public class VariantContextUnitTest extends BaseTest {
     public void testCreatingPartiallyCalledGenotype() {
         List<Allele> alleles = Arrays.asList(Aref, C);
         Genotype g = new Genotype("foo", Arrays.asList(C, Allele.NO_CALL), 10);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, alleles, Arrays.asList(g));
+        VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles).genotypes(g).make();
 
         Assert.assertTrue(vc.isSNP());
         Assert.assertEquals(vc.getNAlleles(), 2);
@@ -328,7 +328,8 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
         Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
 
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3));
+        VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles)
+                .genotypes(g1, g2, g3).make();
 
         Assert.assertTrue(vc.hasGenotypes());
         Assert.assertFalse(vc.isMonomorphic());
@@ -367,7 +368,8 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g5 = new Genotype("dd", Arrays.asList(del, del), 10);
         Genotype g6 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
 
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3, g4, g5, g6));
+        VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles)
+                .genotypes(g1, g2, g3, g4, g5, g6).make();
 
         Assert.assertTrue(vc.hasGenotypes());
         Assert.assertFalse(vc.isMonomorphic());
@@ -392,7 +394,8 @@ public class VariantContextUnitTest extends BaseTest {
             Genotype g1 = new Genotype("AA1", Arrays.asList(Aref, Aref), 10);
             Genotype g2 = new Genotype("AA2", Arrays.asList(Aref, Aref), 10);
             Genotype g3 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
-            VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1, g2, g3));
+            VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles)
+                    .genotypes(g1, g2, g3).make();
 
             Assert.assertTrue(vc.hasGenotypes());
             Assert.assertTrue(vc.isMonomorphic());
@@ -412,21 +415,20 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
         Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
 
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2));
+        VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles).genotypes(g1, g2).make();
 
         Assert.assertTrue(vc.isNotFiltered());
         Assert.assertFalse(vc.isFiltered());
         Assert.assertEquals(0, vc.getFilters().size());
 
-        Set<String> filters = new HashSet<String>(Arrays.asList("BAD_SNP_BAD!"));
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2), VariantContext.NO_NEG_LOG_10PERROR, filters, null);
+        vc = new VariantContextBuilder(vc).filters("BAD_SNP_BAD!").make();
 
         Assert.assertFalse(vc.isNotFiltered());
         Assert.assertTrue(vc.isFiltered());
         Assert.assertEquals(1, vc.getFilters().size());
 
-        filters = new HashSet<String>(Arrays.asList("BAD_SNP_BAD!", "REALLY_BAD_SNP", "CHRIST_THIS_IS_TERRIBLE"));
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, Arrays.asList(g1,g2), VariantContext.NO_NEG_LOG_10PERROR, filters, null);
+        Set<String> filters = new HashSet<String>(Arrays.asList("BAD_SNP_BAD!", "REALLY_BAD_SNP", "CHRIST_THIS_IS_TERRIBLE"));
+        vc = new VariantContextBuilder(vc).filters(filters).make();
 
         Assert.assertFalse(vc.isNotFiltered());
         Assert.assertTrue(vc.isFiltered());
@@ -441,7 +443,7 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
         Genotype g4 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
         Genotype g5 = new Genotype("--", Arrays.asList(del, del), 10);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop , alleles, Arrays.asList(g1,g2,g3,g4,g5));
+        VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, alleles).genotypes(g1,g2,g3,g4,g5).make();
 
         VariantContext vc12 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName(), g2.getSampleName())));
         VariantContext vc1 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName())));
@@ -495,7 +497,7 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
         Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
         GenotypesContext gc = GenotypesContext.create(g1, g2, g3);
-        VariantContext vc = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T), gc);
+        VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).genotypes(gc).make();
 
         Assert.assertEquals(vc.getGenotype("AA"), g1);
         Assert.assertEquals(vc.getGenotype("AT"), g2);
@@ -586,7 +588,7 @@ public class VariantContextUnitTest extends BaseTest {
         private SitesAndGenotypesVC(String name, VariantContext original) {
             super(SitesAndGenotypesVC.class, name);
             this.vc = original;
-            this.copy = new VariantContext(original);
+            this.copy = new VariantContextBuilder(original).make();
         }
 
         public String toString() {
@@ -600,8 +602,8 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
         Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
 
-        VariantContext sites = new VariantContext("sites", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T));
-        VariantContext genotypes = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T), Arrays.asList(g1, g2, g3));
+        VariantContext sites = new VariantContextBuilder("sites", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).make();
+        VariantContext genotypes = new VariantContextBuilder(sites).source("genotypes").genotypes(g1, g2, g3).make();
 
         new SitesAndGenotypesVC("sites", sites);
         new SitesAndGenotypesVC("genotypes", genotypes);
@@ -616,32 +618,32 @@ public class VariantContextUnitTest extends BaseTest {
     // --------------------------------------------------------------------------------
     @Test(dataProvider = "SitesAndGenotypesVC")
     public void runModifyVCTests(SitesAndGenotypesVC cfg) {
-        VariantContext modified = VariantContext.modifyLocation(cfg.vc, "chr2", 123, 123);
+        VariantContext modified = new VariantContextBuilder(cfg.vc).loc("chr2", 123, 123).make();
         Assert.assertEquals(modified.getChr(), "chr2");
         Assert.assertEquals(modified.getStart(), 123);
         Assert.assertEquals(modified.getEnd(), 123);
 
-        modified = VariantContext.modifyID(cfg.vc, "newID");
+        modified = new VariantContextBuilder(cfg.vc).id("newID").make();
         Assert.assertEquals(modified.getID(), "newID");
 
         Set<String> newFilters = Collections.singleton("newFilter");
-        modified = VariantContext.modifyFilters(cfg.vc, newFilters);
+        modified = new VariantContextBuilder(cfg.vc).filters(newFilters).make();
         Assert.assertEquals(modified.getFilters(), newFilters);
 
-        modified = VariantContext.modifyAttribute(cfg.vc, "AC", 1);
+        modified = new VariantContextBuilder(cfg.vc).attribute("AC", 1).make();
         Assert.assertEquals(modified.getAttribute("AC"), 1);
-        modified = VariantContext.modifyAttribute(modified, "AC", 2);
+        modified = new VariantContextBuilder(modified).attribute("AC", 2).make();
         Assert.assertEquals(modified.getAttribute("AC"), 2);
-        modified = VariantContext.modifyAttributes(modified, null);
+        modified = new VariantContextBuilder(modified).attributes(null).make();
         Assert.assertTrue(modified.getAttributes().isEmpty());
 
         Genotype g1 = new Genotype("AA2", Arrays.asList(Aref, Aref), 10);
         Genotype g2 = new Genotype("AT2", Arrays.asList(Aref, T), 10);
         Genotype g3 = new Genotype("TT2", Arrays.asList(T, T), 10);
         GenotypesContext gc = GenotypesContext.create(g1,g2,g3);
-        modified = VariantContext.modifyGenotypes(cfg.vc, gc);
+        modified = new VariantContextBuilder(cfg.vc).genotypes(gc).make();
         Assert.assertEquals(modified.getGenotypes(), gc);
-        modified = VariantContext.modifyGenotypes(cfg.vc, null);
+        modified = new VariantContextBuilder(cfg.vc).noGenotypes().make();
         Assert.assertTrue(modified.getGenotypes().isEmpty());
 
         // test that original hasn't changed
@@ -697,7 +699,7 @@ public class VariantContextUnitTest extends BaseTest {
         Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
 
         GenotypesContext gc = GenotypesContext.create(g1, g2, g3);
-        VariantContext vc = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T), gc);
+        VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).genotypes(gc).make();
         VariantContext sub = cfg.updateAlleles ? vc.subContextFromSamples(cfg.samples) : vc.subContextFromSamples(cfg.samples, vc.getAlleles());
 
         // unchanged attributes should be the same
@@ -782,8 +784,7 @@ public class VariantContextUnitTest extends BaseTest {
             gc.add(new Genotype(name, Arrays.asList(Aref, T)));
         }
 
-        VariantContext vc = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc,
-                snpLocStart, snpLocStop, Arrays.asList(Aref, T), gc);
+        VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).genotypes(gc).make();
 
         // same sample names => success
         Assert.assertEquals(vc.getSampleNames(), new HashSet<String>(cfg.sampleNames), "vc.getSampleNames() = " + vc.getSampleNames());
@@ -823,9 +824,7 @@ public class VariantContextUnitTest extends BaseTest {
 
             }
 
-            VariantContext vc = new VariantContext("genotypes", VCFConstants.EMPTY_ID_FIELD, snpLoc,
-                    snpLocStart, snpLocStop, Arrays.asList(Aref, T), gc);
-
+            VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).genotypes(gc).make();
             Assert.assertEquals(vc.getNSamples(), nSamples);
             if ( nSamples > 0 ) {
                 Assert.assertEquals(vc.isPolymorphic(), nT > 0);
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index 805781fe0..a48596ca1 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -250,7 +250,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
         final List<VariantContext> inputs = new ArrayList<VariantContext>();
 
         for ( final String id : cfg.inputs ) {
-            inputs.add(VariantContext.modifyID(snpVC1, id));
+            inputs.add(new VariantContextBuilder(snpVC1).id(id).make());
         }
 
         final VariantContext merged = VariantContextUtils.simpleMerge(genomeLocParser,

From 768b27322bda816e6c6c5a05b4a6dcbb74f1efcb Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Fri, 18 Nov 2011 12:29:15 -0500
Subject: [PATCH 056/113] I figured out why we were getting tons of hom var
 genotype calls with Mauricio's low quality (synthetic) reduced reads: the RR
 implementation in the UG was not capping the base quality by the mapping
 quality, so all the low quality reads were used to generate GLs.  Fixed.

---
 .../DiploidSNPGenotypeLikelihoods.java        | 37 +++++++++----------
 1 file changed, 18 insertions(+), 19 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/DiploidSNPGenotypeLikelihoods.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/DiploidSNPGenotypeLikelihoods.java
index 666fe88a3..295cf8688 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/DiploidSNPGenotypeLikelihoods.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/DiploidSNPGenotypeLikelihoods.java
@@ -28,7 +28,6 @@ package org.broadinstitute.sting.gatk.walkers.genotyper;
 import net.sf.samtools.SAMUtils;
 import org.broadinstitute.sting.utils.BaseUtils;
 import org.broadinstitute.sting.utils.fragments.FragmentCollection;
-import org.broadinstitute.sting.utils.fragments.FragmentUtils;
 import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.QualityUtils;
 import org.broadinstitute.sting.utils.exceptions.UserException;
@@ -275,19 +274,20 @@ public class DiploidSNPGenotypeLikelihoods implements Cloneable {
 
     public int add(PileupElement elt, boolean ignoreBadBases, boolean capBaseQualsAtMappingQual, int minBaseQual) {
         byte obsBase = elt.getBase();
+        byte qual = qualToUse(elt, ignoreBadBases, capBaseQualsAtMappingQual, minBaseQual);
 
         if ( elt.isReducedRead() ) {
             // reduced read representation
-            byte qual = elt.getQual();
-            if ( BaseUtils.isRegularBase( elt.getBase() )) {
+            if ( BaseUtils.isRegularBase( obsBase )) {
                 add(obsBase, qual, (byte)0, (byte)0, elt.getRepresentativeCount()); // fast calculation of n identical likelihoods
                 return elt.getRepresentativeCount(); // we added nObs bases here
-            } else // odd bases or deletions => don't use them
-                return 0;
-        } else {
-            byte qual = qualToUse(elt, ignoreBadBases, capBaseQualsAtMappingQual, minBaseQual);
-            return qual > 0 ? add(obsBase, qual, (byte)0, (byte)0, 1) : 0;
+            }
+
+            // odd bases or deletions => don't use them
+            return 0;
         }
+
+        return qual > 0 ? add(obsBase, qual, (byte)0, (byte)0, 1) : 0;
     }
 
     public int add(List<PileupElement> overlappingPair, boolean ignoreBadBases, boolean capBaseQualsAtMappingQual, int minBaseQual) {
@@ -511,20 +511,19 @@ public class DiploidSNPGenotypeLikelihoods implements Cloneable {
      * @return
      */
     private static byte qualToUse(PileupElement p, boolean ignoreBadBases, boolean capBaseQualsAtMappingQual, int minBaseQual) {
-        if ( ignoreBadBases && !BaseUtils.isRegularBase( p.getBase() ) ) {
+        if ( ignoreBadBases && !BaseUtils.isRegularBase( p.getBase() ) )
             return 0;
-        } else {
-            byte qual = p.getQual();
 
-            if ( qual > SAMUtils.MAX_PHRED_SCORE )
-                throw new UserException.MalformedBAM(p.getRead(), String.format("the maximum allowed quality score is %d, but a quality of %d was observed in read %s.  Perhaps your BAM incorrectly encodes the quality scores in Sanger format; see http://en.wikipedia.org/wiki/FASTQ_format for more details", SAMUtils.MAX_PHRED_SCORE, qual, p.getRead().getReadName()));
-            if ( capBaseQualsAtMappingQual )
-                qual = (byte)Math.min((int)p.getQual(), p.getMappingQual());
-            if ( (int)qual < minBaseQual )
-                qual = (byte)0;
+        byte qual = p.getQual();
 
-            return qual;
-        }
+        if ( qual > SAMUtils.MAX_PHRED_SCORE )
+            throw new UserException.MalformedBAM(p.getRead(), String.format("the maximum allowed quality score is %d, but a quality of %d was observed in read %s.  Perhaps your BAM incorrectly encodes the quality scores in Sanger format; see http://en.wikipedia.org/wiki/FASTQ_format for more details", SAMUtils.MAX_PHRED_SCORE, qual, p.getRead().getReadName()));
+        if ( capBaseQualsAtMappingQual )
+            qual = (byte)Math.min((int)p.getQual(), p.getMappingQual());
+        if ( (int)qual < minBaseQual )
+            qual = (byte)0;
+
+        return qual;
     }
 
     // -----------------------------------------------------------------------------------------------------------------

From c62082ba1b5d1c1b29842f671e5ef0ff6ba60d40 Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Fri, 18 Nov 2011 12:34:27 -0500
Subject: [PATCH 057/113] Making this class public again as per request from
 Cancer folks

---
 .../sting/gatk/walkers/genotyper/DiploidGenotype.java           | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/DiploidGenotype.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/DiploidGenotype.java
index b5987963f..106bb1982 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/DiploidGenotype.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/DiploidGenotype.java
@@ -34,7 +34,7 @@ import org.broadinstitute.sting.utils.BaseUtils;
  * Time: 6:46:09 PM
  * To change this template use File | Settings | File Templates.
  */
-enum DiploidGenotype {
+public enum DiploidGenotype {
     AA ('A', 'A'),
     AC ('A', 'C'),
     AG ('A', 'G'),

From f54afc19b48804d697971f284884835be1f290a9 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 18 Nov 2011 12:39:10 -0500
Subject: [PATCH 058/113] VariantContextBuilder

-- New approach to making VariantContexts modeled on StringBuilder
-- No more modify routines -- use VariantContextBuilder
-- Renamed isPolymorphic to isPolymorphicInSamples.   Same for mono
-- getChromosomeCount -> getCalledChrCount
-- Walkers changed to use new VariantContext.  Some deprecated new VariantContext calls remain
-- VCFCodec now uses optimized cached information to create GenotypesContext.
---
 .../gatk/walkers/annotator/SampleList.java    |   2 +-
 .../validation/ValidationAmplicons.java       |   4 +-
 .../varianteval/evaluators/CompOverlap.java   |   2 +-
 .../varianteval/evaluators/CountVariants.java |   2 +-
 .../evaluators/G1KPhaseITable.java            |   3 +-
 .../evaluators/IndelLengthHistogram.java      |   2 +-
 .../evaluators/IndelStatistics.java           |   4 +-
 .../evaluators/SimpleMetricsByAC.java         |   4 +-
 .../evaluators/ThetaVariantEvaluator.java     |   2 +-
 .../evaluators/TiTvVariantEvaluator.java      |   2 +-
 .../evaluators/ValidationReport.java          |   5 +-
 .../evaluators/VariantQualityScore.java       |   4 +-
 .../stratifications/AlleleCount.java          |   2 +-
 .../VariantDataManager.java                   |   4 +-
 .../walkers/variantutils/SelectVariants.java  |  10 +-
 .../VariantValidationAssessor.java            |  12 +-
 .../utils/codecs/vcf/AbstractVCFCodec.java    |   9 +-
 .../sting/utils/codecs/vcf/VCFCodec.java      |   4 +-
 .../sting/utils/codecs/vcf/VCFHeader.java     |  26 ++++
 .../variantcontext/GenotypesContext.java      |   8 +
 .../utils/variantcontext/VariantContext.java  | 137 +++++-------------
 .../variantcontext/VariantContextUtils.java   |  10 +-
 .../VariantContextUnitTest.java               |  83 ++++++-----
 23 files changed, 149 insertions(+), 192 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SampleList.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SampleList.java
index 84a4a3120..cbf536e4f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SampleList.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/SampleList.java
@@ -47,7 +47,7 @@ import java.util.Map;
 public class SampleList extends InfoFieldAnnotation {
 
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
-        if ( vc.isMonomorphic() || !vc.hasGenotypes() )
+        if ( vc.isMonomorphicInSamples() || !vc.hasGenotypes() )
             return null;
 
         StringBuffer samples = new StringBuffer();
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/ValidationAmplicons.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/ValidationAmplicons.java
index 088c4ddc4..b27bef265 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/ValidationAmplicons.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/validation/ValidationAmplicons.java
@@ -260,7 +260,7 @@ public class ValidationAmplicons extends RodWalker<Integer,Integer> {
                 }
             }
         } else /* (mask != null && validate == null ) */ {
-            if ( ! mask.isSNP() && ! mask.isFiltered() && ( ! filterMonomorphic || ! mask.isMonomorphic() )) {
+            if ( ! mask.isSNP() && ! mask.isFiltered() && ( ! filterMonomorphic || ! mask.isMonomorphicInSamples() )) {
                 logger.warn("Mask Variant Context on the following warning line is not a SNP. Currently we can only mask out SNPs. This probe will not be designed.");
                 logger.warn(String.format("%s:%d-%d\t%s\t%s",mask.getChr(),mask.getStart(),mask.getEnd(),mask.isSimpleInsertion() ? "INS" : "DEL", Utils.join(",",mask.getAlleles())));
                 sequenceInvalid = true;
@@ -281,7 +281,7 @@ public class ValidationAmplicons extends RodWalker<Integer,Integer> {
                 sequence.append('N');
                 indelCounter--;
                 rawSequence.append(Character.toUpperCase((char)ref.getBase()));
-            } else if ( ! mask.isFiltered() && ( ! filterMonomorphic || ! mask.isMonomorphic() )){
+            } else if ( ! mask.isFiltered() && ( ! filterMonomorphic || ! mask.isMonomorphicInSamples() )){
                 logger.debug("SNP in mask found at " + ref.getLocus().toString());
 
                 if ( lowerCaseSNPs ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompOverlap.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompOverlap.java
index 9facb11b5..b3695921a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompOverlap.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompOverlap.java
@@ -72,7 +72,7 @@ public class CompOverlap extends VariantEvaluator implements StandardEval {
     }
 
     public String update2(VariantContext eval, VariantContext comp, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        boolean evalIsGood = eval != null && eval.isPolymorphic();
+        boolean evalIsGood = eval != null && eval.isPolymorphicInSamples();
         boolean compIsGood = comp != null && comp.isNotFiltered();
 
         if (evalIsGood) nEvalVariants++;           // count the number of eval events
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
index a134ef5aa..d8413573a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
@@ -103,7 +103,7 @@ public class CountVariants extends VariantEvaluator implements StandardEval {
         // So in order to maintain consistency with the previous implementation (and the intention of the original author), I've
         // added in a proxy check for monomorphic status here.
         // Protect against case when vc only as no-calls too - can happen if we strafity by sample and sample as a single no-call.
-       if ( vc1.isMonomorphic() ) {
+       if ( vc1.isMonomorphicInSamples() ) {
             nRefLoci++;
         } else {
              switch (vc1.getType()) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
index 417e340b8..ff8f6307c 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
@@ -30,7 +30,6 @@ import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
 import org.broadinstitute.sting.gatk.walkers.varianteval.VariantEvalWalker;
 import org.broadinstitute.sting.gatk.walkers.varianteval.util.Analysis;
 import org.broadinstitute.sting.gatk.walkers.varianteval.util.DataPoint;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.variantcontext.Genotype;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
@@ -103,7 +102,7 @@ public class G1KPhaseITable extends VariantEvaluator {
     }
 
     public String update2(VariantContext eval, VariantContext comp, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        if ( eval == null || eval.isMonomorphic() ) return null;
+        if ( eval == null || eval.isMonomorphicInSamples() ) return null;
 
         switch (eval.getType()) {
             case SNP:
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/IndelLengthHistogram.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/IndelLengthHistogram.java
index ffe7c185f..ccec9af12 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/IndelLengthHistogram.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/IndelLengthHistogram.java
@@ -91,7 +91,7 @@ public class IndelLengthHistogram extends VariantEvaluator {
 
     public String update1(VariantContext vc1, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
 
-        if ( vc1.isIndel() && vc1.isPolymorphic() ) {
+        if ( vc1.isIndel() && vc1.isPolymorphicInSamples() ) {
 
             if ( ! vc1.isBiallelic() ) {
                 //veWalker.getLogger().warn("[IndelLengthHistogram] Non-biallelic indel at "+ref.getLocus()+" ignored.");
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/IndelStatistics.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/IndelStatistics.java
index f70e6c2de..87b453ae3 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/IndelStatistics.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/IndelStatistics.java
@@ -8,11 +8,9 @@ import org.broadinstitute.sting.gatk.walkers.varianteval.util.Analysis;
 import org.broadinstitute.sting.gatk.walkers.varianteval.util.DataPoint;
 import org.broadinstitute.sting.gatk.walkers.varianteval.util.TableType;
 import org.broadinstitute.sting.utils.IndelUtils;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.ArrayList;
-import java.util.HashMap;
 
 /*
  * Copyright (c) 2010 The Broad Institute
@@ -270,7 +268,7 @@ public class IndelStatistics extends VariantEvaluator {
 
     public String update1(VariantContext eval, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
 
-        if (eval != null && eval.isPolymorphic()) {
+        if (eval != null && eval.isPolymorphicInSamples()) {
             if ( indelStats == null ) {
                 indelStats = new IndelStats(eval);
             }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/SimpleMetricsByAC.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/SimpleMetricsByAC.java
index 2d0163206..27e8e7c86 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/SimpleMetricsByAC.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/SimpleMetricsByAC.java
@@ -118,7 +118,7 @@ public class SimpleMetricsByAC extends VariantEvaluator implements StandardEval
             int ac = -1;
             
             if ( eval.hasGenotypes() )
-                ac = eval.getChromosomeCount(eval.getAlternateAllele(0));
+                ac = eval.getCalledChrCount(eval.getAlternateAllele(0));
             else if ( eval.hasAttribute("AC") ) {
                 ac = eval.getAttributeAsInt("AC", -1);
             }
@@ -166,7 +166,7 @@ public class SimpleMetricsByAC extends VariantEvaluator implements StandardEval
                 }
             }
 
-            if ( eval.isSNP() && eval.isBiallelic() && eval.isPolymorphic() && metrics != null ) {
+            if ( eval.isSNP() && eval.isBiallelic() && eval.isPolymorphicInSamples() && metrics != null ) {
                 metrics.incrValue(eval);
             }
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ThetaVariantEvaluator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ThetaVariantEvaluator.java
index e1069d2d2..bb7843361 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ThetaVariantEvaluator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ThetaVariantEvaluator.java
@@ -37,7 +37,7 @@ public class ThetaVariantEvaluator extends VariantEvaluator {
     }
 
     public String update1(VariantContext vc, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        if (vc == null || !vc.isSNP() || !vc.hasGenotypes() || vc.isMonomorphic()) {
+        if (vc == null || !vc.isSNP() || !vc.hasGenotypes() || vc.isMonomorphicInSamples()) {
             return null; //no interesting sites
         }
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/TiTvVariantEvaluator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/TiTvVariantEvaluator.java
index 9b6e145e6..17d7171b8 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/TiTvVariantEvaluator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/TiTvVariantEvaluator.java
@@ -40,7 +40,7 @@ public class TiTvVariantEvaluator extends VariantEvaluator implements StandardEv
     }
 
     public void updateTiTv(VariantContext vc, boolean updateStandard) {
-        if (vc != null && vc.isSNP() && vc.isBiallelic() && vc.isPolymorphic()) {
+        if (vc != null && vc.isSNP() && vc.isBiallelic() && vc.isPolymorphicInSamples()) {
             if (VariantContextUtils.isTransition(vc)) {
                 if (updateStandard) nTiInComp++;
                 else nTi++;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ValidationReport.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ValidationReport.java
index 3b4967cad..1a0591e9d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ValidationReport.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ValidationReport.java
@@ -11,7 +11,6 @@ import org.broadinstitute.sting.utils.variantcontext.Allele;
 import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 
 import java.util.Collection;
-import java.util.Set;
 
 /**
  * The Broad Institute
@@ -118,8 +117,8 @@ public class ValidationReport extends VariantEvaluator implements StandardEval {
     public SiteStatus calcSiteStatus(VariantContext vc) {
         if ( vc == null ) return SiteStatus.NO_CALL;
         if ( vc.isFiltered() ) return SiteStatus.FILTERED;
-        if ( vc.isMonomorphic() ) return SiteStatus.MONO;
-        if ( vc.hasGenotypes() ) return SiteStatus.POLY;  // must be polymorphic if isMonomorphic was false and there are genotypes
+        if ( vc.isMonomorphicInSamples() ) return SiteStatus.MONO;
+        if ( vc.hasGenotypes() ) return SiteStatus.POLY;  // must be polymorphic if isMonomorphicInSamples was false and there are genotypes
 
         if ( vc.hasAttribute(VCFConstants.ALLELE_COUNT_KEY) ) {
             int ac = 0;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/VariantQualityScore.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/VariantQualityScore.java
index 263227938..ce9e45c9b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/VariantQualityScore.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/VariantQualityScore.java
@@ -232,14 +232,14 @@ public class VariantQualityScore extends VariantEvaluator {
     public String update1(VariantContext eval, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
         final String interesting = null;
 
-        if( eval != null && eval.isSNP() && eval.isBiallelic() && eval.isPolymorphic() ) { //BUGBUG: only counting biallelic sites (revisit what to do with triallelic sites)
+        if( eval != null && eval.isSNP() && eval.isBiallelic() && eval.isPolymorphicInSamples() ) { //BUGBUG: only counting biallelic sites (revisit what to do with triallelic sites)
             if( titvStats == null ) { titvStats = new TiTvStats(); }
             titvStats.incrValue(eval.getPhredScaledQual(), VariantContextUtils.isTransition(eval));
 
             if( alleleCountStats == null ) { alleleCountStats = new AlleleCountStats(); }
             int alternateAlleleCount = 0;
             for (final Allele a : eval.getAlternateAlleles()) {
-                alternateAlleleCount += eval.getChromosomeCount(a);
+                alternateAlleleCount += eval.getCalledChrCount(a);
             }
             alleleCountStats.incrValue(eval.getPhredScaledQual(), alternateAlleleCount);
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/AlleleCount.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/AlleleCount.java
index c7bea93b2..2f342e120 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/AlleleCount.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/AlleleCount.java
@@ -47,7 +47,7 @@ public class AlleleCount extends VariantStratifier {
                 AC = eval.getAttributeAsInt("AC", 0);
             } else if ( eval.isVariant() ) {
                 for (Allele allele : eval.getAlternateAlleles())
-                    AC = Math.max(AC, eval.getChromosomeCount(allele));
+                    AC = Math.max(AC, eval.getCalledChrCount(allele));
             } else
                 // by default, the site is considered monomorphic
                 AC = 0;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantrecalibration/VariantDataManager.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantrecalibration/VariantDataManager.java
index e04bfab76..a2782fe34 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantrecalibration/VariantDataManager.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantrecalibration/VariantDataManager.java
@@ -26,7 +26,6 @@
 package org.broadinstitute.sting.gatk.walkers.variantrecalibration;
 
 import org.apache.log4j.Logger;
-import org.broadinstitute.sting.commandline.RodBinding;
 import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
 import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
 import org.broadinstitute.sting.utils.GenomeLoc;
@@ -38,7 +37,6 @@ import org.broadinstitute.sting.utils.variantcontext.VariantContext;
 import java.io.PrintStream;
 import java.util.ArrayList;
 import java.util.Collections;
-import java.util.HashMap;
 import java.util.List;
 
 /**
@@ -284,7 +282,7 @@ public class VariantDataManager {
     private boolean isValidVariant( final VariantContext evalVC, final VariantContext trainVC, final boolean TRUST_ALL_POLYMORPHIC) {
         return trainVC != null && trainVC.isNotFiltered() && trainVC.isVariant() &&
                         ((evalVC.isSNP() && trainVC.isSNP()) || ((evalVC.isIndel()||evalVC.isMixed()) && (trainVC.isIndel()||trainVC.isMixed()))) &&
-                        (TRUST_ALL_POLYMORPHIC || !trainVC.hasGenotypes() || trainVC.isPolymorphic());
+                        (TRUST_ALL_POLYMORPHIC || !trainVC.hasGenotypes() || trainVC.isPolymorphicInSamples());
     }
 
     public void writeOutRecalibrationTable( final PrintStream RECAL_FILE ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index be9a193d3..9c24360c5 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -488,7 +488,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
                         if (outMVFile != null)
                             outMVFileStream.format("MV@%s:%d. REF=%s, ALT=%s, AC=%d, momID=%s, dadID=%s, childID=%s, momG=%s, momGL=%s, dadG=%s, dadGL=%s, " +
                                 "childG=%s childGL=%s\n",vc.getChr(), vc.getStart(),
-                                vc.getReference().getDisplayString(), vc.getAlternateAllele(0).getDisplayString(),  vc.getChromosomeCount(vc.getAlternateAllele(0)),
+                                vc.getReference().getDisplayString(), vc.getAlternateAllele(0).getDisplayString(),  vc.getCalledChrCount(vc.getAlternateAllele(0)),
                                 mv.getSampleMom(), mv.getSampleDad(), mv.getSampleChild(),
                                 vc.getGenotype(mv.getSampleMom()).toBriefString(), vc.getGenotype(mv.getSampleMom()).getLikelihoods().getAsString(),
                                 vc.getGenotype(mv.getSampleDad()).toBriefString(), vc.getGenotype(mv.getSampleMom()).getLikelihoods().getAsString(),
@@ -520,7 +520,7 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
                 continue;
 
             VariantContext sub = subsetRecord(vc, samples);
-            if ( (sub.isPolymorphic() || !EXCLUDE_NON_VARIANTS) && (!sub.isFiltered() || !EXCLUDE_FILTERED) ) {
+            if ( (sub.isPolymorphicInSamples() || !EXCLUDE_NON_VARIANTS) && (!sub.isFiltered() || !EXCLUDE_FILTERED) ) {
                 for ( VariantContextUtils.JexlVCMatchExp jexl : jexls ) {
                     if ( !VariantContextUtils.match(sub, jexl) ) {
                         return 0;
@@ -677,11 +677,11 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
 
         if (KEEP_ORIGINAL_CHR_COUNTS) {
             if ( sub.hasAttribute(VCFConstants.ALLELE_COUNT_KEY) )
-                builder.attribute("AC_Orig",sub.getAttribute(VCFConstants.ALLELE_COUNT_KEY));
+                builder.attribute("AC_Orig", sub.getAttribute(VCFConstants.ALLELE_COUNT_KEY));
             if ( sub.hasAttribute(VCFConstants.ALLELE_FREQUENCY_KEY) )
-                builder.attribute("AF_Orig",sub.getAttribute(VCFConstants.ALLELE_FREQUENCY_KEY));
+                builder.attribute("AF_Orig", sub.getAttribute(VCFConstants.ALLELE_FREQUENCY_KEY));
             if ( sub.hasAttribute(VCFConstants.ALLELE_NUMBER_KEY) )
-                builder.attribute("AN_Orig",sub.getAttribute(VCFConstants.ALLELE_NUMBER_KEY));
+                builder.attribute("AN_Orig", sub.getAttribute(VCFConstants.ALLELE_NUMBER_KEY));
         }
 
         Map<String, Object> attributes = new HashMap<String, Object>(builder.make().getAttributes());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantValidationAssessor.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantValidationAssessor.java
index 79bbea29d..31aa8963b 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantValidationAssessor.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantValidationAssessor.java
@@ -233,17 +233,17 @@ public class VariantValidationAssessor extends RodWalker<VariantContext,Integer>
         numRecords++;
 
         // add the info fields
-        builder.attribute("NoCallPct", String.format("%.1f", 100.0*noCallProp));
-        builder.attribute("HomRefPct", String.format("%.1f", 100.0*homRefProp));
-        builder.attribute("HomVarPct", String.format("%.1f", 100.0*homVarProp));
-        builder.attribute("HetPct", String.format("%.1f", 100.0*hetProp));
+        builder.attribute("NoCallPct", String.format("%.1f", 100.0 * noCallProp));
+        builder.attribute("HomRefPct", String.format("%.1f", 100.0 * homRefProp));
+        builder.attribute("HomVarPct", String.format("%.1f", 100.0 * homVarProp));
+        builder.attribute("HetPct", String.format("%.1f", 100.0 * hetProp));
         builder.attribute("HW", String.format("%.2f", hwScore));
         Collection<Allele> altAlleles = vContext.getAlternateAlleles();
-        int altAlleleCount = altAlleles.size() == 0 ? 0 : vContext.getChromosomeCount(altAlleles.iterator().next());
+        int altAlleleCount = altAlleles.size() == 0 ? 0 : vContext.getCalledChrCount(altAlleles.iterator().next());
         if ( !isViolation && altAlleleCount > 0 )
             numTrueVariants++;
         builder.attribute(VCFConstants.ALLELE_COUNT_KEY, String.format("%d", altAlleleCount));
-        builder.attribute(VCFConstants.ALLELE_NUMBER_KEY, String.format("%d", vContext.getChromosomeCount()));
+        builder.attribute(VCFConstants.ALLELE_NUMBER_KEY, String.format("%d", vContext.getCalledChrCount()));
 
         return builder.make();
     }
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index ba138a9da..e6e4aa8ce 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -98,7 +98,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
         headerStrings.add(line);
 
         Set<VCFHeaderLine> metaData = new TreeSet<VCFHeaderLine>();
-        Set<String> auxTags = new LinkedHashSet<String>();
+        Set<String> sampleNames = new LinkedHashSet<String>();
         // iterate over all the passed in strings
         for ( String str : headerStrings ) {
             if ( !str.startsWith(VCFHeader.METADATA_INDICATOR) ) {
@@ -126,9 +126,9 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
                 }
 
                 while ( arrayIndex < strings.length )
-                    auxTags.add(strings[arrayIndex++]);
+                    sampleNames.add(strings[arrayIndex++]);
 
-                if ( sawFormatTag && auxTags.size() == 0 )
+                if ( sawFormatTag && sampleNames.size() == 0 )
                     throw new UserException.MalformedVCFHeader("The FORMAT field was provided but there is no genotype/sample data");
 
             } else {
@@ -152,7 +152,8 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
             }
         }
 
-        header = new VCFHeader(metaData, auxTags);
+        header = new VCFHeader(metaData, sampleNames);
+        header.buildVCFReaderMaps(new ArrayList<String>(sampleNames));
         return header;
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
index 53b3d5fd4..42c224fe9 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
@@ -151,7 +151,7 @@ public class VCFCodec extends AbstractVCFCodec {
 
         int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
 
-        GenotypesContext genotypes = GenotypesContext.create(nParts);
+        ArrayList<Genotype> genotypes = new ArrayList<Genotype>(nParts);
 
         // get the format keys
         int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
@@ -215,7 +215,7 @@ public class VCFCodec extends AbstractVCFCodec {
             }
         }
 
-        return genotypes;
+        return GenotypesContext.create(genotypes, header.sampleNameToOffset, header.sampleNamesInOrder);
     }
 
     @Override
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFHeader.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFHeader.java
index 66e11bc1e..5c5df15ab 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFHeader.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFHeader.java
@@ -2,6 +2,7 @@ package org.broadinstitute.sting.utils.codecs.vcf;
 
 
 import org.broad.tribble.util.ParsingUtils;
+import org.broadinstitute.sting.utils.variantcontext.Genotype;
 
 import java.util.*;
 
@@ -38,6 +39,10 @@ public class VCFHeader {
     // were the input samples sorted originally (or are we sorting them)?
     private boolean samplesWereAlreadySorted = true;
 
+    // cache for efficient conversion of VCF -> VariantContext
+    protected ArrayList<String> sampleNamesInOrder = null;
+    protected HashMap<String, Integer> sampleNameToOffset = null;
+
 
     /**
      * create a VCF header, given a list of meta data and auxillary tags
@@ -69,6 +74,27 @@ public class VCFHeader {
         samplesWereAlreadySorted = ParsingUtils.isSorted(genotypeSampleNames);
     }
 
+    /**
+     * Tell this VCF header to use pre-calculated sample name ordering and the
+     * sample name -> offset map.  This assumes that all VariantContext created
+     * using this header (i.e., read by the VCFCodec) will have genotypes
+     * occurring in the same order
+     *
+     */
+
+    protected void buildVCFReaderMaps(List<String> genotypeSampleNamesInAppearenceOrder) {
+        sampleNamesInOrder = new ArrayList<String>(genotypeSampleNamesInAppearenceOrder.size());
+        sampleNameToOffset = new HashMap<String, Integer>(genotypeSampleNamesInAppearenceOrder.size());
+
+        int i = 0;
+        for ( final String name : genotypeSampleNamesInAppearenceOrder ) {
+            sampleNamesInOrder.add(name);
+            sampleNameToOffset.put(name, i++);
+        }
+        Collections.sort(sampleNamesInOrder);
+    }
+
+
     /**
      * Adds a header line to the header metadata.
      *
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 77a02874d..671066d24 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -85,6 +85,12 @@ public class GenotypesContext implements List<Genotype> {
         return new GenotypesContext(nGenotypes, false);
     }
 
+    public static final GenotypesContext create(final ArrayList<Genotype> genotypes,
+                                                final Map<String, Integer> sampleNameToOffset,
+                                                final List<String> sampleNamesInOrder) {
+        return new GenotypesContext(genotypes, sampleNameToOffset, sampleNamesInOrder, false);
+    }
+
     public static final GenotypesContext create(final ArrayList<Genotype> genotypes) {
         return genotypes == null ? NO_GENOTYPES : new GenotypesContext(genotypes, false);
     }
@@ -101,6 +107,8 @@ public class GenotypesContext implements List<Genotype> {
         return toCopy == null ? NO_GENOTYPES : create(new ArrayList<Genotype>(toCopy));
     }
 
+
+
 //    public static final GenotypeMap create(final Collection<Genotype> genotypes) {
 //        if ( genotypes == null )
 //            return null; // todo -- really should return an empty map
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 455a9b997..9875680b0 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -131,17 +131,17 @@ import java.util.*;
  *
  * <pre>
  * vc.hasGenotypes()
- * vc.isMonomorphic()
- * vc.isPolymorphic()
+ * vc.isMonomorphicInSamples()
+ * vc.isPolymorphicInSamples()
  * vc.getSamples().size()
  *
  * vc.getGenotypes()
  * vc.getGenotypes().get("g1")
  * vc.hasGenotype("g1")
  *
- * vc.getChromosomeCount()
- * vc.getChromosomeCount(Aref)
- * vc.getChromosomeCount(T)
+ * vc.getCalledChrCount()
+ * vc.getCalledChrCount(Aref)
+ * vc.getCalledChrCount(T)
  * </pre>
  *
  * === NO_CALL alleles ===
@@ -374,72 +374,17 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
 
-//    /**
-//     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotype
-//     * genotype and alleles in genotype.  This is the right way to test if a single genotype is actually
-//     * variant or not.
-//     *
-//     * @param genotype genotype
-//     * @return vc subcontext
-//     * @deprecated  replaced by {@link #subContextFromSample(String)}
-//     */
-//    public VariantContext subContextFromGenotypes(Genotype genotype) {
-//        return subContextFromGenotypes(Arrays.asList(genotype));
-//    }
-//
-//
-//    /**
-//     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
-//     * genotypes and alleles in these genotypes.  This is the right way to test if a single genotype is actually
-//     * variant or not.
-//     *
-//     * @param genotypes genotypes
-//     * @return vc subcontext
-//     * @deprecated  replaced by {@link #subContextFromSamples(java.util.Collection)}
-//     */
-//    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes) {
-//        return subContextFromGenotypes(genotypes, allelesOfGenotypes(genotypes)) ;
-//    }
-//
-//    /**
-//     * Returns a context identical to this (i.e., filter, qual are all the same) but containing only the Genotypes
-//     * genotypes.  Also, the resulting variant context will contain the alleles provided, not only those found in genotypes
-//     *
-//     * @param genotypes genotypes
-//     * @param alleles the set of allele segregating alleles at this site.  Must include those in genotypes, but may be more
-//     * @return vc subcontext
-//     * @deprecated  replaced by {@link #subContextFromSamples(java.util.Collection, java.util.Collection)}
-//     */
-//    @Deprecated
-//    public VariantContext subContextFromGenotypes(Collection<Genotype> genotypes, Collection<Allele> alleles) {
-//        return new VariantContext(getSource(), contig, start, stop, alleles,
-//                GenotypeCollection.create(genotypes),
-//                getNegLog10PError(),
-//                filtersWereApplied() ? getFilters() : null,
-//                getAttributes(),
-//                getReferenceBaseForIndel());
-//    }
-
     public VariantContext subContextFromSamples(Set<String> sampleNames, Collection<Allele> alleles) {
         loadGenotypes();
-        GenotypesContext newGenotypes = genotypes.subsetToSamples(sampleNames);
-        return new VariantContext(getSource(), getID(), contig, start, stop, alleles,
-                newGenotypes,
-                getNegLog10PError(),
-                filtersWereApplied() ? getFilters() : null,
-                getAttributes(),
-                getReferenceBaseForIndel());
+        VariantContextBuilder builder = new VariantContextBuilder(this);
+        return builder.genotypes(genotypes.subsetToSamples(sampleNames)).make();
     }
 
     public VariantContext subContextFromSamples(Set<String> sampleNames) {
         loadGenotypes();
+        VariantContextBuilder builder = new VariantContextBuilder(this);
         GenotypesContext newGenotypes = genotypes.subsetToSamples(sampleNames);
-        return new VariantContext(getSource(), getID(), contig, start, stop, allelesOfGenotypes(newGenotypes),
-                newGenotypes,
-                getNegLog10PError(),
-                filtersWereApplied() ? getFilters() : null,
-                getAttributes(),
-                getReferenceBaseForIndel());
+        return builder.genotypes(newGenotypes).alleles(allelesOfGenotypes(newGenotypes)).make();
     }
 
     public VariantContext subContextFromSample(String sampleName) {
@@ -451,12 +396,12 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param genotypes genotypes
      * @return allele set
      */
-    private Set<Allele> allelesOfGenotypes(Collection<Genotype> genotypes) {
-        Set<Allele> alleles = new HashSet<Allele>();
+    private final Set<Allele> allelesOfGenotypes(Collection<Genotype> genotypes) {
+        final Set<Allele> alleles = new HashSet<Allele>();
 
         boolean addedref = false;
-        for ( Genotype g : genotypes ) {
-            for ( Allele a : g.getAlleles() ) {
+        for ( final Genotype g : genotypes ) {
+            for ( final Allele a : g.getAlleles() ) {
                 addedref = addedref || a.isReference();
                 if ( a.isCalled() )
                     alleles.add(a);
@@ -938,7 +883,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      *
      * @return chromosome count
      */
-    public int getChromosomeCount() {
+    public int getCalledChrCount() {
         int n = 0;
 
         for ( final Genotype g : getGenotypes() ) {
@@ -955,7 +900,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param a allele
      * @return chromosome count
      */
-    public int getChromosomeCount(Allele a) {
+    public int getCalledChrCount(Allele a) {
         int n = 0;
 
         for ( final Genotype g : getGenotypes() ) {
@@ -971,9 +916,9 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      *
      * @return true if it's monomorphic
      */
-    public boolean isMonomorphic() {
+    public boolean isMonomorphicInSamples() {
         if ( monomorphic == null )
-            monomorphic = ! isVariant() || (hasGenotypes() && getChromosomeCount(getReference()) == getChromosomeCount());
+            monomorphic = ! isVariant() || (hasGenotypes() && getCalledChrCount(getReference()) == getCalledChrCount());
         return monomorphic;
     }
 
@@ -983,8 +928,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      *
      * @return true if it's polymorphic
      */
-    public boolean isPolymorphic() {
-        return ! isMonomorphic();
+    public boolean isPolymorphicInSamples() {
+        return ! isMonomorphicInSamples();
     }
 
     private void calculateGenotypeCounts() {
@@ -1119,19 +1064,28 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     }
 
     public void validateChromosomeCounts() {
-        Map<String, Object> observedAttrs = calculateChromosomeCounts();
-
         // AN
         if ( hasAttribute(VCFConstants.ALLELE_NUMBER_KEY) ) {
             int reportedAN = Integer.valueOf(getAttribute(VCFConstants.ALLELE_NUMBER_KEY).toString());
-            int observedAN = (Integer)observedAttrs.get(VCFConstants.ALLELE_NUMBER_KEY);
+            int observedAN = getCalledChrCount();
             if ( reportedAN != observedAN )
                 throw new TribbleException.InternalCodecException(String.format("the Allele Number (AN) tag is incorrect for the record at position %s:%d, %d vs. %d", getChr(), getStart(), reportedAN, observedAN));
         }
 
         // AC
         if ( hasAttribute(VCFConstants.ALLELE_COUNT_KEY) ) {
-            List<Integer> observedACs = (List<Integer>)observedAttrs.get(VCFConstants.ALLELE_COUNT_KEY);
+            ArrayList<Integer> observedACs = new ArrayList<Integer>();
+
+            // if there are alternate alleles, record the relevant tags
+            if ( getAlternateAlleles().size() > 0 ) {
+                for ( Allele allele : getAlternateAlleles() ) {
+                    observedACs.add(getCalledChrCount(allele));
+                }
+            }
+            else { // otherwise, set them to 0
+                observedACs.add(0);
+            }
+
             if ( getAttribute(VCFConstants.ALLELE_COUNT_KEY) instanceof List ) {
                 Collections.sort(observedACs);
                 List reportedACs = (List)getAttribute(VCFConstants.ALLELE_COUNT_KEY);
@@ -1152,31 +1106,6 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         }
     }
 
-    private Map<String, Object> calculateChromosomeCounts() {
-        Map<String, Object> attributes = new HashMap<String, Object>();
-
-        attributes.put(VCFConstants.ALLELE_NUMBER_KEY, getChromosomeCount());
-        ArrayList<Double> alleleFreqs = new ArrayList<Double>();
-        ArrayList<Integer> alleleCounts = new ArrayList<Integer>();
-
-        // if there are alternate alleles, record the relevant tags
-        if ( getAlternateAlleles().size() > 0 ) {
-            for ( Allele allele : getAlternateAlleles() ) {
-                alleleCounts.add(getChromosomeCount(allele));
-                alleleFreqs.add((double)getChromosomeCount(allele) / (double)getChromosomeCount());
-            }
-        }
-        // otherwise, set them to 0
-        else {
-            alleleCounts.add(0);
-            alleleFreqs.add(0.0);
-        }
-
-        attributes.put(VCFConstants.ALLELE_COUNT_KEY, alleleCounts);
-        attributes.put(VCFConstants.ALLELE_FREQUENCY_KEY, alleleFreqs);
-        return attributes;
-    }
-
     // ---------------------------------------------------------------------------------------------------------
     //
     // validation: the normal validation routines are called automatically upon creation of the VC
@@ -1399,7 +1328,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         Allele best = null;
         int maxAC1 = 0;
         for (Allele a:this.getAlternateAlleles()) {
-            int ac = this.getChromosomeCount(a);
+            int ac = this.getCalledChrCount(a);
             if (ac >=maxAC1) {
                 maxAC1 = ac;
                 best = a;
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index d9057ea8f..972f70689 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -63,7 +63,7 @@ public class VariantContextUtils {
      */
     public static void calculateChromosomeCounts(VariantContext vc, Map<String, Object> attributes, boolean removeStaleValues) {
         // if everyone is a no-call, remove the old attributes if requested
-        if ( vc.getChromosomeCount() == 0 && removeStaleValues ) {
+        if ( vc.getCalledChrCount() == 0 && removeStaleValues ) {
             if ( attributes.containsKey(VCFConstants.ALLELE_COUNT_KEY) )
                 attributes.remove(VCFConstants.ALLELE_COUNT_KEY);
             if ( attributes.containsKey(VCFConstants.ALLELE_FREQUENCY_KEY) )
@@ -74,15 +74,15 @@ public class VariantContextUtils {
         }
 
         if ( vc.hasGenotypes() ) {
-            attributes.put(VCFConstants.ALLELE_NUMBER_KEY, vc.getChromosomeCount());
+            attributes.put(VCFConstants.ALLELE_NUMBER_KEY, vc.getCalledChrCount());
 
             // if there are alternate alleles, record the relevant tags
             if ( vc.getAlternateAlleles().size() > 0 ) {
                 ArrayList<String> alleleFreqs = new ArrayList<String>();
                 ArrayList<Integer> alleleCounts = new ArrayList<Integer>();
-                double totalChromosomes = (double)vc.getChromosomeCount();
+                double totalChromosomes = (double)vc.getCalledChrCount();
                 for ( Allele allele : vc.getAlternateAlleles() ) {
-                    int altChromosomes = vc.getChromosomeCount(allele);
+                    int altChromosomes = vc.getCalledChrCount(allele);
                     alleleCounts.add(altChromosomes);
                     String freq = String.format(makePrecisionFormatStringFromDenominatorValue(totalChromosomes), ((double)altChromosomes / totalChromosomes));
                     alleleFreqs.add(freq);
@@ -320,7 +320,7 @@ public class VariantContextUtils {
     }
 
     public static double computeHardyWeinbergPvalue(VariantContext vc) {
-        if ( vc.getChromosomeCount() == 0 )
+        if ( vc.getCalledChrCount() == 0 )
             return 0.0;
         return HardyWeinbergCalculation.hwCalculate(vc.getHomRefCount(), vc.getHetCount(), vc.getHomVarCount());
     }
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index 38c4f84ab..200f3859b 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -12,7 +12,6 @@ import org.testng.annotations.DataProvider;
 import org.testng.annotations.Test;
 import org.testng.Assert;
 
-import java.lang.reflect.Array;
 import java.util.*;
 
 
@@ -260,12 +259,12 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertTrue(vc.isSNP());
         Assert.assertEquals(vc.getNAlleles(), 2);
         Assert.assertTrue(vc.hasGenotypes());
-        Assert.assertFalse(vc.isMonomorphic());
-        Assert.assertTrue(vc.isPolymorphic());
+        Assert.assertFalse(vc.isMonomorphicInSamples());
+        Assert.assertTrue(vc.isPolymorphicInSamples());
         Assert.assertEquals(vc.getGenotype("foo"), g);
-        Assert.assertEquals(vc.getChromosomeCount(), 1); // we only have 1 called chromosomes, we exclude the NO_CALL one isn't called
-        Assert.assertEquals(vc.getChromosomeCount(Aref), 0);
-        Assert.assertEquals(vc.getChromosomeCount(C), 1);
+        Assert.assertEquals(vc.getCalledChrCount(), 1); // we only have 1 called chromosomes, we exclude the NO_CALL one isn't called
+        Assert.assertEquals(vc.getCalledChrCount(Aref), 0);
+        Assert.assertEquals(vc.getCalledChrCount(C), 1);
         Assert.assertFalse(vc.getGenotype("foo").isHet());
         Assert.assertFalse(vc.getGenotype("foo").isHom());
         Assert.assertFalse(vc.getGenotype("foo").isNoCall());
@@ -332,8 +331,8 @@ public class VariantContextUnitTest extends BaseTest {
                 .genotypes(g1, g2, g3).make();
 
         Assert.assertTrue(vc.hasGenotypes());
-        Assert.assertFalse(vc.isMonomorphic());
-        Assert.assertTrue(vc.isPolymorphic());
+        Assert.assertFalse(vc.isMonomorphicInSamples());
+        Assert.assertTrue(vc.isPolymorphicInSamples());
         Assert.assertEquals(vc.getSampleNames().size(), 3);
 
         Assert.assertEquals(vc.getGenotypes().size(), 3);
@@ -352,9 +351,9 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertFalse(vc.hasGenotype("at"));
         Assert.assertFalse(vc.hasGenotype("tt"));
 
-        Assert.assertEquals(vc.getChromosomeCount(), 6);
-        Assert.assertEquals(vc.getChromosomeCount(Aref), 3);
-        Assert.assertEquals(vc.getChromosomeCount(T), 3);
+        Assert.assertEquals(vc.getCalledChrCount(), 6);
+        Assert.assertEquals(vc.getCalledChrCount(Aref), 3);
+        Assert.assertEquals(vc.getCalledChrCount(T), 3);
     }
 
     @Test
@@ -372,17 +371,17 @@ public class VariantContextUnitTest extends BaseTest {
                 .genotypes(g1, g2, g3, g4, g5, g6).make();
 
         Assert.assertTrue(vc.hasGenotypes());
-        Assert.assertFalse(vc.isMonomorphic());
-        Assert.assertTrue(vc.isPolymorphic());
+        Assert.assertFalse(vc.isMonomorphicInSamples());
+        Assert.assertTrue(vc.isPolymorphicInSamples());
         Assert.assertEquals(vc.getGenotypes().size(), 6);
 
         Assert.assertEquals(3, vc.getGenotypes(Arrays.asList("AA", "Td", "dd")).size());
 
-        Assert.assertEquals(10, vc.getChromosomeCount());
-        Assert.assertEquals(3, vc.getChromosomeCount(Aref));
-        Assert.assertEquals(4, vc.getChromosomeCount(T));
-        Assert.assertEquals(3, vc.getChromosomeCount(del));
-        Assert.assertEquals(2, vc.getChromosomeCount(Allele.NO_CALL));
+        Assert.assertEquals(10, vc.getCalledChrCount());
+        Assert.assertEquals(3, vc.getCalledChrCount(Aref));
+        Assert.assertEquals(4, vc.getCalledChrCount(T));
+        Assert.assertEquals(3, vc.getCalledChrCount(del));
+        Assert.assertEquals(2, vc.getCalledChrCount(Allele.NO_CALL));
     }
 
     @Test
@@ -398,14 +397,14 @@ public class VariantContextUnitTest extends BaseTest {
                     .genotypes(g1, g2, g3).make();
 
             Assert.assertTrue(vc.hasGenotypes());
-            Assert.assertTrue(vc.isMonomorphic());
-            Assert.assertFalse(vc.isPolymorphic());
+            Assert.assertTrue(vc.isMonomorphicInSamples());
+            Assert.assertFalse(vc.isPolymorphicInSamples());
             Assert.assertEquals(vc.getGenotypes().size(), 3);
 
-            Assert.assertEquals(4, vc.getChromosomeCount());
-            Assert.assertEquals(4, vc.getChromosomeCount(Aref));
-            Assert.assertEquals(0, vc.getChromosomeCount(T));
-            Assert.assertEquals(2, vc.getChromosomeCount(Allele.NO_CALL));
+            Assert.assertEquals(4, vc.getCalledChrCount());
+            Assert.assertEquals(4, vc.getCalledChrCount(Aref));
+            Assert.assertEquals(0, vc.getCalledChrCount(T));
+            Assert.assertEquals(2, vc.getCalledChrCount(Allele.NO_CALL));
         }
     }
 
@@ -452,12 +451,12 @@ public class VariantContextUnitTest extends BaseTest {
         VariantContext vc14 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName(), g4.getSampleName())));
         VariantContext vc5 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g5.getSampleName())));
 
-        Assert.assertTrue(vc12.isPolymorphic());
-        Assert.assertTrue(vc23.isPolymorphic());
-        Assert.assertTrue(vc1.isMonomorphic());
-        Assert.assertTrue(vc4.isMonomorphic());
-        Assert.assertTrue(vc14.isMonomorphic());
-        Assert.assertTrue(vc5.isPolymorphic());
+        Assert.assertTrue(vc12.isPolymorphicInSamples());
+        Assert.assertTrue(vc23.isPolymorphicInSamples());
+        Assert.assertTrue(vc1.isMonomorphicInSamples());
+        Assert.assertTrue(vc4.isMonomorphicInSamples());
+        Assert.assertTrue(vc14.isMonomorphicInSamples());
+        Assert.assertTrue(vc5.isPolymorphicInSamples());
 
         Assert.assertTrue(vc12.isSNP());
         Assert.assertTrue(vc12.isVariant());
@@ -484,12 +483,12 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertTrue(vc5.isVariant());
         Assert.assertTrue(vc5.isBiallelic());
 
-        Assert.assertEquals(3, vc12.getChromosomeCount(Aref));
-        Assert.assertEquals(1, vc23.getChromosomeCount(Aref));
-        Assert.assertEquals(2, vc1.getChromosomeCount(Aref));
-        Assert.assertEquals(0, vc4.getChromosomeCount(Aref));
-        Assert.assertEquals(2, vc14.getChromosomeCount(Aref));
-        Assert.assertEquals(0, vc5.getChromosomeCount(Aref));
+        Assert.assertEquals(3, vc12.getCalledChrCount(Aref));
+        Assert.assertEquals(1, vc23.getCalledChrCount(Aref));
+        Assert.assertEquals(2, vc1.getCalledChrCount(Aref));
+        Assert.assertEquals(0, vc4.getCalledChrCount(Aref));
+        Assert.assertEquals(2, vc14.getCalledChrCount(Aref));
+        Assert.assertEquals(0, vc5.getCalledChrCount(Aref));
     }
 
     public void testGetGenotypeMethods() {
@@ -827,14 +826,14 @@ public class VariantContextUnitTest extends BaseTest {
             VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).genotypes(gc).make();
             Assert.assertEquals(vc.getNSamples(), nSamples);
             if ( nSamples > 0 ) {
-                Assert.assertEquals(vc.isPolymorphic(), nT > 0);
-                Assert.assertEquals(vc.isMonomorphic(), nT == 0);
+                Assert.assertEquals(vc.isPolymorphicInSamples(), nT > 0);
+                Assert.assertEquals(vc.isMonomorphicInSamples(), nT == 0);
             }
-            Assert.assertEquals(vc.getChromosomeCount(), nA + nT);
+            Assert.assertEquals(vc.getCalledChrCount(), nA + nT);
 
-            Assert.assertEquals(vc.getChromosomeCount(Allele.NO_CALL), nNoCallAlleles);
-            Assert.assertEquals(vc.getChromosomeCount(Aref), nA);
-            Assert.assertEquals(vc.getChromosomeCount(T), nT);
+            Assert.assertEquals(vc.getCalledChrCount(Allele.NO_CALL), nNoCallAlleles);
+            Assert.assertEquals(vc.getCalledChrCount(Aref), nA);
+            Assert.assertEquals(vc.getCalledChrCount(T), nT);
 
             Assert.assertEquals(vc.getNoCallCount(), nNoCall);
             Assert.assertEquals(vc.getHomRefCount(), nHomRef);

From 660d6009a20c1ff8f187bd4e8ed4586082616ec6 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 18 Nov 2011 13:59:30 -0500
Subject: [PATCH 059/113] Documentation and contracts for GenotypesContext and
 VariantContextBuilder

---
 .../utils/codecs/vcf/AbstractVCFCodec.java    |   1 +
 .../variantcontext/GenotypesContext.java      | 218 +++++++++++++++---
 .../variantcontext/VariantContextBuilder.java | 150 +++++++++++-
 3 files changed, 332 insertions(+), 37 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index e6e4aa8ce..0f21e1505 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -296,6 +296,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
         if (parts.length > NUM_STANDARD_FIELDS) {
             builder.attribute(VariantContext.UNPARSED_GENOTYPE_MAP_KEY, new String(parts[8]));
             builder.attribute(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY, this);
+            builder.genotypesAreUnparsed();
         }
 
         VariantContext vc = null;
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 671066d24..c1fcd6226 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -24,19 +24,41 @@
 
 package org.broadinstitute.sting.utils.variantcontext;
 
+import com.google.java.contract.Ensures;
+import com.google.java.contract.Invariant;
+import com.google.java.contract.Requires;
+
 import java.util.*;
 
 /**
- *
+ * Represents an ordered collection of Genotype objects
  */
 public class GenotypesContext implements List<Genotype> {
+    /**
+     * static constant value for an empty GenotypesContext.  Useful since so many VariantContexts have no genotypes
+     */
     public final static GenotypesContext NO_GENOTYPES =
             new GenotypesContext(new ArrayList<Genotype>(0), new HashMap<String, Integer>(0), Collections.<String>emptyList(), true);
 
+    /**
+     *sampleNamesInOrder a list of sample names, one for each genotype in genotypes, sorted in alphabetical order
+     */
     List<String> sampleNamesInOrder = null;
+
+    /**
+     * a map optimized for efficient lookup.  Each genotype in genotypes must have its
+     * sample name in sampleNameToOffset, with a corresponding integer value that indicates the offset of that
+     * genotype in the vector of genotypes
+     */
     Map<String, Integer> sampleNameToOffset = null;
+
+    /** if true, then we need to reinitialize sampleNamesInOrder and sampleNameToOffset before we use them /*/
     boolean cacheIsInvalid = true;
+
+    /** An ArrayList of genotypes contained in this context */
     List<Genotype> genotypes;
+
+    /** Are we allowing users to modify the list? */
     boolean immutable = false;
 
     // ---------------------------------------------------------------------------
@@ -45,14 +67,25 @@ public class GenotypesContext implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
+    /**
+     * Create an empty GenotypeContext
+     */
     private GenotypesContext() {
         this(10, false);
     }
 
+    /**
+     * Create an empty GenotypeContext, with initial capacity for n elements
+     */
+    @Requires("n >= 0")
     private GenotypesContext(final int n, final boolean immutable) {
         this(new ArrayList<Genotype>(n), immutable);
     }
 
+    /**
+     * Create an GenotypeContext containing genotypes
+     */
+    @Requires("genotypes != null")
     private GenotypesContext(final ArrayList<Genotype> genotypes, final boolean immutable) {
         this.genotypes = genotypes;
         this.immutable = immutable;
@@ -60,6 +93,23 @@ public class GenotypesContext implements List<Genotype> {
         this.cacheIsInvalid = true;
     }
 
+    /**
+     * Create a fully resolved GenotypeContext containing genotypes, sample lookup table,
+     * and sorted sample names
+     *
+     * @param genotypes our genotypes in arbitrary
+     * @param sampleNameToOffset map optimized for efficient lookup.  Each genotype in genotypes must have its
+     * sample name in sampleNameToOffset, with a corresponding integer value that indicates the offset of that
+     * genotype in the vector of genotypes
+     * @param sampleNamesInOrder a list of sample names, one for each genotype in genotypes, sorted in alphabetical
+     * order.
+     * @param immutable
+     */
+    @Requires({"genotypes != null",
+            "sampleNameToOffset != null",
+            "sampleNamesInOrder != null",
+            "genotypes.size() == sampleNameToOffset.size()",
+            "genotypes.size() == sampleNamesInOrder.size()"})
     private GenotypesContext(final ArrayList<Genotype> genotypes,
                              final Map<String, Integer> sampleNameToOffset,
                              final List<String> sampleNamesInOrder,
@@ -77,54 +127,98 @@ public class GenotypesContext implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
+    /**
+     * Basic creation routine
+     * @return an empty, mutable GenotypeContext
+     */
+    @Ensures({"result != null"})
     public static final GenotypesContext create() {
         return new GenotypesContext();
     }
 
+    /**
+     * Basic creation routine
+     * @return an empty, mutable GenotypeContext with initial capacity for nGenotypes
+     */
+    @Requires("nGenotypes >= 0")
+    @Ensures({"result != null"})
     public static final GenotypesContext create(final int nGenotypes) {
         return new GenotypesContext(nGenotypes, false);
     }
 
+    /**
+     * Create a fully resolved GenotypeContext containing genotypes, sample lookup table,
+     * and sorted sample names
+     *
+     * @param genotypes our genotypes in arbitrary
+     * @param sampleNameToOffset map optimized for efficient lookup.  Each genotype in genotypes must have its
+     * sample name in sampleNameToOffset, with a corresponding integer value that indicates the offset of that
+     * genotype in the vector of genotypes
+     * @param sampleNamesInOrder a list of sample names, one for each genotype in genotypes, sorted in alphabetical
+     * order.
+     * @return an mutable GenotypeContext containing genotypes with already present lookup data
+     */
+    @Requires({"genotypes != null",
+            "sampleNameToOffset != null",
+            "sampleNamesInOrder != null",
+            "sameSamples(genotypes, sampleNamesInOrder)",
+            "sameSamples(genotypes, sampleNameToOffset.keySet())"})
+    @Ensures({"result != null"})
     public static final GenotypesContext create(final ArrayList<Genotype> genotypes,
                                                 final Map<String, Integer> sampleNameToOffset,
                                                 final List<String> sampleNamesInOrder) {
         return new GenotypesContext(genotypes, sampleNameToOffset, sampleNamesInOrder, false);
     }
 
+    /**
+     * Create a fully resolved GenotypeContext containing genotypes
+     *
+     * @param genotypes our genotypes in arbitrary
+     * @return an mutable GenotypeContext containing genotypes
+     */
+    @Requires({"genotypes != null"})
+    @Ensures({"result != null"})
     public static final GenotypesContext create(final ArrayList<Genotype> genotypes) {
         return genotypes == null ? NO_GENOTYPES : new GenotypesContext(genotypes, false);
     }
 
+    /**
+     * Create a fully resolved GenotypeContext containing genotypes
+     *
+     * @param genotypes our genotypes in arbitrary
+     * @return an mutable GenotypeContext containing genotypes
+     */
+    @Requires({"genotypes != null"})
+    @Ensures({"result != null"})
     public static final GenotypesContext create(final Genotype... genotypes) {
         return new GenotypesContext(new ArrayList<Genotype>(Arrays.asList(genotypes)), false);
     }
 
+    /**
+     * Create a freshly allocated GenotypeContext containing the genotypes in toCopy
+     *
+     * @param toCopy the GenotypesContext to copy
+     * @return an mutable GenotypeContext containing genotypes
+     */
+    @Requires({"toCopy != null"})
+    @Ensures({"result != null"})
     public static final GenotypesContext copy(final GenotypesContext toCopy) {
         return create(new ArrayList<Genotype>(toCopy.genotypes));
     }
 
+    /**
+     * Create a GenotypesContext containing the genotypes in iteration order contained
+     * in toCopy
+     *
+     * @param toCopy the collection of genotypes
+     * @return an mutable GenotypeContext containing genotypes
+     */
+    @Requires({"toCopy != null"})
+    @Ensures({"result != null"})
     public static final GenotypesContext copy(final Collection<Genotype> toCopy) {
         return toCopy == null ? NO_GENOTYPES : create(new ArrayList<Genotype>(toCopy));
     }
 
-
-
-//    public static final GenotypeMap create(final Collection<Genotype> genotypes) {
-//        if ( genotypes == null )
-//            return null; // todo -- really should return an empty map
-//        else {
-//            GenotypeMap genotypeMap = new GenotypeMap(genotypes.size(), false);
-//            for ( final Genotype g : genotypes ) {
-//                if ( genotypeMap.containsKey(g.getSampleName() ) )
-//                    throw new IllegalArgumentException("Duplicate genotype added to VariantContext: " + g);
-//                genotypeMap.put(g.getSampleName(), g);
-//            }
-//
-//            //return genotypeMap.immutable();  // todo enable when we have time to dive into mutability issue
-//            return genotypeMap;
-//        }
-//    }
-
     // ---------------------------------------------------------------------------
     //
     // Mutability methods
@@ -152,23 +246,31 @@ public class GenotypesContext implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
+    @Ensures({"cacheIsInvalid = true"})
     private void invalidateCaches() {
         cacheIsInvalid = true;
         sampleNamesInOrder = null;
         sampleNameToOffset = null;
     }
 
+    @Ensures({"cacheIsInvalid = false",
+            "sampleNamesInOrder != null",
+            "sampleNameToOffset != null",
+            "sameSamples(genotypes, sampleNamesInOrder)",
+            "sameSamples(genotypes, sampleNameToOffset.keySet())"})
     private void buildCache() {
-        cacheIsInvalid = false;
-        sampleNamesInOrder = new ArrayList<String>(genotypes.size());
-        sampleNameToOffset = new HashMap<String, Integer>(genotypes.size());
+        if ( cacheIsInvalid ) {
+            cacheIsInvalid = false;
+            sampleNamesInOrder = new ArrayList<String>(genotypes.size());
+            sampleNameToOffset = new HashMap<String, Integer>(genotypes.size());
 
-        for ( int i = 0; i < genotypes.size(); i++ ) {
-            final Genotype g = genotypes.get(i);
-            sampleNamesInOrder.add(g.getSampleName());
-            sampleNameToOffset.put(g.getSampleName(), i);
+            for ( int i = 0; i < genotypes.size(); i++ ) {
+                final Genotype g = genotypes.get(i);
+                sampleNamesInOrder.add(g.getSampleName());
+                sampleNameToOffset.put(g.getSampleName(), i);
+            }
+            Collections.sort(sampleNamesInOrder);
         }
-        Collections.sort(sampleNamesInOrder);
     }
 
 
@@ -195,12 +297,14 @@ public class GenotypesContext implements List<Genotype> {
     }
 
     @Override
+    @Requires("genotype != null")
     public boolean add(final Genotype genotype) {
         checkImmutability();
         invalidateCaches();
         return genotypes.add(genotype);
     }
 
+    @Requires("genotype != null")
     public boolean add(final Genotype ... genotype) {
         checkImmutability();
         invalidateCaches();
@@ -263,13 +367,15 @@ public class GenotypesContext implements List<Genotype> {
     @Override
     public ListIterator<Genotype> listIterator() {
         // todo -- must be immutable
-        return genotypes.listIterator();
+        throw new UnsupportedOperationException();
+//        return genotypes.listIterator();
     }
 
     @Override
     public ListIterator<Genotype> listIterator(final int i) {
         // todo -- must be immutable
-        return genotypes.listIterator(i);
+        throw new UnsupportedOperationException();
+//        return genotypes.listIterator(i);
     }
 
     @Override
@@ -322,6 +428,14 @@ public class GenotypesContext implements List<Genotype> {
         return genotypes.toArray(ts);
     }
 
+    /**
+     * Iterate over the Genotypes in this context in the order specified by sampleNamesInOrder
+     *
+     * @param sampleNamesInOrder a Iterable of String, containing exactly one entry for each Genotype sample name in
+     * this context
+     * @return a Iterable over the genotypes in this context.
+     */
+    @Requires("sampleNamesInOrder != null")
     public Iterable<Genotype> iterateInSampleNameOrder(final Iterable<String> sampleNamesInOrder) {
         return new Iterable<Genotype>() {
             @Override
@@ -331,6 +445,11 @@ public class GenotypesContext implements List<Genotype> {
         };
     }
 
+    /**
+     * Iterate over the Genotypes in this context in their sample name order (A, B, C)
+     * regardless of the underlying order in the vector of genotypes
+     * @return a Iterable over the genotypes in this context.
+     */
     public Iterable<Genotype> iterateInSampleNameOrder() {
         return iterateInSampleNameOrder(getSampleNamesOrderedByName());
     }
@@ -358,30 +477,57 @@ public class GenotypesContext implements List<Genotype> {
         }
     }
 
+    /**
+     * @return The set of sample names for all genotypes in this context, in arbitrary order
+     */
+    @Ensures("result != null")
     public Set<String> getSampleNames() {
         buildCache();
         return sampleNameToOffset.keySet();
     }
 
+    /**
+     * @return The set of sample names for all genotypes in this context, in their natural ordering (A, B, C)
+     */
+    @Ensures("result != null")
     public List<String> getSampleNamesOrderedByName() {
         buildCache();
         return sampleNamesInOrder;
     }
 
+    @Requires("sample != null")
     public boolean containsSample(final String sample) {
         buildCache();
         return sampleNameToOffset.containsKey(sample);
     }
 
+    @Requires("samples != null")
     public boolean containsSamples(final Collection<String> samples) {
         buildCache();
         return getSampleNames().containsAll(samples);
     }
 
+    /**
+     * Return a freshly allocated subcontext of this context containing only the samples
+     * listed in samples.  Note that samples can contain names not in this context, they
+     * will just be ignored.
+     *
+     * @param samples
+     * @return
+     */
+    @Requires("samples != null")
+    @Ensures("result != null")
     public GenotypesContext subsetToSamples( final Collection<String> samples ) {
         return subsetToSamples(new HashSet<String>(samples));
     }
 
+    /**
+     * {@link #subsetToSamples(java.util.Collection)}
+     * @param samples
+     * @return
+     */
+    @Requires("samples != null")
+    @Ensures("result != null")
     public GenotypesContext subsetToSamples( final Set<String> samples ) {
         if ( samples.size() == genotypes.size() )
             return this;
@@ -426,4 +572,18 @@ public class GenotypesContext implements List<Genotype> {
             }
         }
     }
+
+    private final static boolean sameSamples(List<Genotype> genotypes, Collection<String> sampleNamesInOrder) {
+        Set<String> names = new HashSet<String>(sampleNamesInOrder);
+        if ( names.size() != sampleNamesInOrder.size() )
+            return false;
+        if ( genotypes.size() != names.size() )
+            return false;
+
+        for ( final Genotype g : genotypes )
+            if ( ! names.contains(g.getSampleName()) )
+                return false;
+
+        return true;
+    }
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
index fb92f60a2..67077e8c3 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
@@ -37,6 +37,25 @@ import java.util.*;
 /**
  * Builder class for VariantContext
  *
+ * Some basic assumptions here:
+ *
+ * 1 -- data isn't protectively copied.  If you provide an attribute map to
+ * the build, and modify it later, the builder will see this and so will any
+ * resulting variant contexts.  It's best not to modify collections provided
+ * to a builder.
+ *
+ * 2 -- the system uses the standard builder model, allowing the simple construction idiom:
+ *
+ *   builder.source("a").genotypes(gc).id("x").make() => VariantContext
+ *
+ * 3 -- The best way to copy a VariantContext is:
+ *
+ *   new VariantContextBuilder(vc).make() => a copy of VC
+ *
+ * 4 -- validation of arguments is done at the during the final make() call, so a
+ * VariantContextBuilder can exist in an inconsistent state as long as those issues
+ * are resolved before the call to make() is issued.
+ *
  * @author depristo
  */
 public class VariantContextBuilder {
@@ -60,10 +79,19 @@ public class VariantContextBuilder {
     /** enum of what must be validated */
     final private EnumSet<VariantContext.Validation> toValidate = EnumSet.noneOf(VariantContext.Validation.class);
 
-    public VariantContextBuilder() {
-
-    }
+    /**
+     * Create an empty VariantContextBuilder where all values adopt their default values.  Note that
+     * source, chr, start, stop, and alleles must eventually be filled in, or the resulting VariantContext
+     * will throw an error.
+     */
+    public VariantContextBuilder() {}
 
+    /**
+     * Create an empty VariantContextBuilder where all values adopt their default values, but the bare min.
+     * of info (source, chr, start, stop, and alleles) have been provided to start.
+     */
+    @Requires({"source != null", "contig != null", "start >= 0", "stop >= 0",
+            "alleles != null && !alleles.isEmpty()"})
     public VariantContextBuilder(String source, String contig, long start, long stop, Collection<Allele> alleles) {
         this.source = source;
         this.contig = contig;
@@ -95,6 +123,12 @@ public class VariantContextBuilder {
         this.stop = parent.getEnd();
     }
 
+    /**
+     * Tells this builder to use this collection of alleles for the resulting VariantContext
+     *
+     * @param alleles
+     * @return this builder
+     */
     @Requires({"alleles != null", "!alleles.isEmpty()"})
     public VariantContextBuilder alleles(final Collection<Allele> alleles) {
         this.alleles = alleles;
@@ -103,6 +137,8 @@ public class VariantContextBuilder {
     }
 
     /**
+     * Tells this builder to use this map of attributes alleles for the resulting VariantContext
+     *
      * Attributes can be null -> meaning there are no attributes.  After
      * calling this routine the builder assumes it can modify the attributes
      * object here, if subsequent calls are made to set attribute values
@@ -114,6 +150,14 @@ public class VariantContextBuilder {
         return this;
     }
 
+    /**
+     * Puts the key -> value mapping into this builder's attributes
+     *
+     * @param key
+     * @param value
+     * @return
+     */
+    @Requires({"key != null"})
     public VariantContextBuilder attribute(final String key, final Object value) {
         if ( ! attributesCanBeModified ) {
             this.attributesCanBeModified = true;
@@ -124,6 +168,8 @@ public class VariantContextBuilder {
     }
 
     /**
+     * This builder's filters are set to this value
+     *
      * filters can be null -> meaning there are no filters
      * @param filters
      */
@@ -132,22 +178,41 @@ public class VariantContextBuilder {
         return this;
     }
 
+    /**
+     * {@link #filters}
+     *
+     * @param filters
+     * @return
+     */
     public VariantContextBuilder filters(final String ... filters) {
         filters(new HashSet<String>(Arrays.asList(filters)));
         return this;
     }
 
+    /**
+     * Tells this builder that the resulting VariantContext should have PASS filters
+     *
+     * @return
+     */
     public VariantContextBuilder passFilters() {
         return filters(VariantContext.PASSES_FILTERS);
     }
 
+    /**
+     * Tells this builder that the resulting VariantContext be unfiltered
+     *
+     * @return
+     */
     public VariantContextBuilder unfiltered() {
         this.filters = null;
         return this;
     }
 
     /**
-     * genotypes can be null -> meaning there are no genotypes
+     * Tells this builder that the resulting VariantContext should use this genotypes GenotypeContext
+     *
+     * Note that genotypes can be null -> meaning there are no genotypes
+     *
      * @param genotypes
      */
     public VariantContextBuilder genotypes(final GenotypesContext genotypes) {
@@ -157,41 +222,74 @@ public class VariantContextBuilder {
         return this;
     }
 
+    /**
+     * Tells this builder that the resulting VariantContext should use a GenotypeContext containing genotypes
+     *
+     * Note that genotypes can be null -> meaning there are no genotypes
+     *
+     * @param genotypes
+     */
     public VariantContextBuilder genotypes(final Collection<Genotype> genotypes) {
         return genotypes(GenotypesContext.copy(genotypes));
     }
 
+    /**
+     * Tells this builder that the resulting VariantContext should use a GenotypeContext containing genotypes
+     * @param genotypes
+     */
     public VariantContextBuilder genotypes(final Genotype ... genotypes) {
         return genotypes(GenotypesContext.copy(Arrays.asList(genotypes)));
     }
 
+    /**
+     * Tells this builder that the resulting VariantContext should not contain any GenotypeContext
+     */
     public VariantContextBuilder noGenotypes() {
         this.genotypes = null;
         return this;
     }
 
-    public VariantContextBuilder genotypesAreUnparsed(final boolean genotypesAreUnparsed) {
-        this.genotypesAreUnparsed = genotypesAreUnparsed;
+    /**
+     * ADVANCED! tells us that the genotypes data is stored as an unparsed attribute
+     * @return
+     */
+    public VariantContextBuilder genotypesAreUnparsed() {
+        this.genotypesAreUnparsed = true;
         return this;
     }
 
+    /**
+     * Tells us that the resulting VariantContext should have ID
+     * @param ID
+     * @return
+     */
     @Requires("ID != null")
     public VariantContextBuilder id(final String ID) {
         this.ID = ID;
         return this;
     }
 
+    /**
+     * Tells us that the resulting VariantContext should not have an ID
+     * @return
+     */
     public VariantContextBuilder noID() {
         return id(VCFConstants.EMPTY_ID_FIELD);
     }
 
-    @Requires("negLog10PError <= 0")
+    /**
+     * Tells us that the resulting VariantContext should have negLog10PError
+     * @param negLog10PError
+     * @return
+     */
+    @Requires("negLog10PError <= 0 || negLog10PError == VariantContext.NO_NEG_LOG_10PERROR")
     public VariantContextBuilder negLog10PError(final double negLog10PError) {
         this.negLog10PError = negLog10PError;
         return this;
     }
 
     /**
+     * Tells us that the resulting VariantContext should use this byte for the reference base
      * Null means no refBase is available
      * @param referenceBaseForIndel
      */
@@ -201,12 +299,24 @@ public class VariantContextBuilder {
         return this;
     }
 
+    /**
+     * Tells us that the resulting VariantContext should have source field set to source
+     * @param source
+     * @return
+     */
     @Requires("source != null")
     public VariantContextBuilder source(final String source) {
         this.source = source;
         return this;
     }
 
+    /**
+     * Tells us that the resulting VariantContext should have the specified location
+     * @param contig
+     * @param start
+     * @param stop
+     * @return
+     */
     @Requires({"contig != null", "start >= 0", "stop >= 0"})
     public VariantContextBuilder loc(final String contig, final long start, final long stop) {
         this.contig = contig;
@@ -217,12 +327,22 @@ public class VariantContextBuilder {
         return this;
     }
 
-    @Requires({"contig != null", "start >= 0", "stop >= 0"})
+    /**
+     * Tells us that the resulting VariantContext should have the specified contig chr
+     * @param contig
+     * @return
+     */
+    @Requires({"contig != null"})
     public VariantContextBuilder chr(final String contig) {
         this.contig = contig;
         return this;
     }
 
+    /**
+     * Tells us that the resulting VariantContext should have the specified contig start
+     * @param start
+     * @return
+     */
     @Requires({"start >= 0"})
     public VariantContextBuilder start(final long start) {
         this.start = start;
@@ -231,12 +351,26 @@ public class VariantContextBuilder {
         return this;
     }
 
+    /**
+     * Tells us that the resulting VariantContext should have the specified contig stop
+     * @param stop
+     * @return
+     */
     @Requires({"stop >= 0"})
     public VariantContextBuilder stop(final long stop) {
         this.stop = stop;
         return this;
     }
 
+    /**
+     * Takes all of the builder data provided up to this point, and instantiates
+     * a freshly allocated VariantContext with all of the builder data.  This
+     * VariantContext is validated as appropriate and if not failing QC (and
+     * throwing an exception) is returned.
+     *
+     * Note that this function can be called multiple times to create multiple
+     * VariantContexts from the same builder.
+     */
     public VariantContext make() {
         return new VariantContext(source, ID, contig, start, stop, alleles,
                 genotypes, negLog10PError, filters, attributes,

From a2e79fbe8a24d8d970b8fbf790d395c0b79b03cc Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 18 Nov 2011 14:18:53 -0500
Subject: [PATCH 060/113] Fixes to contracts

---
 .../sting/utils/variantcontext/GenotypesContext.java      | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index c1fcd6226..a639f512e 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -246,19 +246,19 @@ public class GenotypesContext implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
-    @Ensures({"cacheIsInvalid = true"})
-    private void invalidateCaches() {
+    @Ensures({"cacheIsInvalid == true"})
+    private synchronized void invalidateCaches() {
         cacheIsInvalid = true;
         sampleNamesInOrder = null;
         sampleNameToOffset = null;
     }
 
-    @Ensures({"cacheIsInvalid = false",
+    @Ensures({"cacheIsInvalid == false",
             "sampleNamesInOrder != null",
             "sampleNameToOffset != null",
             "sameSamples(genotypes, sampleNamesInOrder)",
             "sameSamples(genotypes, sampleNameToOffset.keySet())"})
-    private void buildCache() {
+    private synchronized void buildCache() {
         if ( cacheIsInvalid ) {
             cacheIsInvalid = false;
             sampleNamesInOrder = new ArrayList<String>(genotypes.size());

From 8bb4d4dca32e3b8521c2d7ba22db5a5e9966cccf Mon Sep 17 00:00:00 2001
From: Matt Hanna <hanna@broadinstitute.org>
Date: Tue, 13 Sep 2011 10:49:16 -0400
Subject: [PATCH 061/113] First pass of the asynchronous block loader.

Block loads are only triggered on queue empty at this point.  Disabled by
default (enable with nt:io=?).
---
 .../src/net/sf/samtools/BAMFileReader.java    | 762 ++++++++++++++++++
 .../src/net/sf/samtools/GATKBAMFileSpan.java  |  13 +
 .../java/src/net/sf/samtools/GATKChunk.java   |  16 +
 .../net/sf/samtools/util/BAMInputStream.java  |  72 ++
 .../util/BlockCompressedInputStream.java      | 483 +++++++++++
 .../sting/commandline/CommandLineProgram.java |  10 +-
 .../sting/gatk/CommandLineGATK.java           |   4 +-
 .../sting/gatk/GenomeAnalysisEngine.java      | 146 ++--
 .../arguments/GATKArgumentCollection.java     |  22 +-
 .../reads/BAMBlockStartIterator.java          | 128 ---
 .../datasources/reads/BAMIndexContent.java    | 195 -----
 .../gatk/datasources/reads/BAMOverlap.java    |  29 -
 .../gatk/datasources/reads/BAMSchedule.java   |  18 +-
 .../gatk/datasources/reads/BAMScheduler.java  | 136 +++-
 .../reads/BGZFBlockLoadingDispatcher.java     |  85 ++
 .../datasources/reads/BlockInputStream.java   | 436 ++++++++++
 .../gatk/datasources/reads/BlockLoader.java   | 188 +++++
 .../datasources/reads/FileHandleCache.java    | 231 ++++++
 .../gatk/datasources/reads/FilePointer.java   |  46 +-
 .../datasources/reads/IntervalSharder.java    | 445 +---------
 .../reads/LocusShardBalancer.java}            |  40 +-
 .../datasources/reads/LocusShardStrategy.java | 178 ----
 .../reads/LowMemoryIntervalSharder.java       |  68 --
 .../datasources/reads/MonolithicShard.java    |  34 -
 .../reads/MonolithicShardStrategy.java        |  77 --
 .../gatk/datasources/reads/ReadShard.java     |   9 +-
 .../datasources/reads/ReadShardBalancer.java  | 115 +++
 .../datasources/reads/ReadShardStrategy.java  | 183 -----
 .../gatk/datasources/reads/ReaderBin.java     |  33 -
 .../gatk/datasources/reads/SAMDataSource.java | 257 +++---
 .../datasources/reads/SAMReaderPosition.java  | 120 +++
 .../gatk/datasources/reads/ShardBalancer.java |  21 +
 .../gatk/datasources/reads/ShardStrategy.java |  31 -
 .../reads/ShardStrategyFactory.java           | 117 ---
 .../reads/utilities/FindLargeShards.java      |  10 +-
 .../reference/ReferenceDataSource.java        |  64 +-
 .../executive/HierarchicalMicroScheduler.java |   3 +-
 .../gatk/executive/LinearMicroScheduler.java  |   3 +-
 .../sting/gatk/executive/MicroScheduler.java  |  16 +-
 .../resourcemanagement/ThreadAllocation.java  |  93 +++
 .../providers/LocusViewTemplate.java          |   3 +-
 .../datasources/reads/MockLocusShard.java     |   3 +-
 .../reads/SAMBAMDataSourceUnitTest.java       | 223 -----
 .../reads/SAMDataSourceUnitTest.java          | 147 ++++
 .../traversals/TraverseReadsUnitTest.java     |  16 +-
 45 files changed, 3292 insertions(+), 2037 deletions(-)
 create mode 100644 public/java/src/net/sf/samtools/BAMFileReader.java
 create mode 100644 public/java/src/net/sf/samtools/util/BAMInputStream.java
 create mode 100755 public/java/src/net/sf/samtools/util/BlockCompressedInputStream.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMBlockStartIterator.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMIndexContent.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMOverlap.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BGZFBlockLoadingDispatcher.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BlockInputStream.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BlockLoader.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/FileHandleCache.java
 rename public/java/src/{net/sf/samtools/GATKBinList.java => org/broadinstitute/sting/gatk/datasources/reads/LocusShardBalancer.java} (52%)
 delete mode 100755 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LocusShardStrategy.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LowMemoryIntervalSharder.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/MonolithicShard.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/MonolithicShardStrategy.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShardBalancer.java
 delete mode 100755 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShardStrategy.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReaderBin.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/SAMReaderPosition.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardBalancer.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardStrategy.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardStrategyFactory.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/resourcemanagement/ThreadAllocation.java
 delete mode 100755 public/java/test/org/broadinstitute/sting/gatk/datasources/reads/SAMBAMDataSourceUnitTest.java
 create mode 100755 public/java/test/org/broadinstitute/sting/gatk/datasources/reads/SAMDataSourceUnitTest.java

diff --git a/public/java/src/net/sf/samtools/BAMFileReader.java b/public/java/src/net/sf/samtools/BAMFileReader.java
new file mode 100644
index 000000000..5005b6265
--- /dev/null
+++ b/public/java/src/net/sf/samtools/BAMFileReader.java
@@ -0,0 +1,762 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+package net.sf.samtools;
+
+
+import net.sf.samtools.util.*;
+import net.sf.samtools.SAMFileReader.ValidationStringency;
+
+import java.io.*;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.NoSuchElementException;
+
+/**
+ * Internal class for reading and querying BAM files.
+ */
+class BAMFileReader extends SAMFileReader.ReaderImplementation {
+    // True if reading from a File rather than an InputStream
+    private boolean mIsSeekable = false;
+
+    // For converting bytes into other primitive types
+    private BinaryCodec mStream = null;
+
+    // Underlying compressed data stream.
+    private final BAMInputStream mInputStream;
+    private SAMFileHeader mFileHeader = null;
+
+    // Populated if the file is seekable and an index exists
+    private File mIndexFile;
+    private BAMIndex mIndex = null;
+    private long mFirstRecordPointer = 0;
+    private CloseableIterator<SAMRecord> mCurrentIterator = null;
+
+    // If true, all SAMRecords are fully decoded as they are read.
+    private final boolean eagerDecode;
+
+    // For error-checking.
+    private ValidationStringency mValidationStringency;
+
+    // For creating BAMRecords
+    private SAMRecordFactory samRecordFactory;
+
+    /**
+     * Use the caching index reader implementation rather than the disk-hit-per-file model.
+     */
+    private boolean mEnableIndexCaching = false;
+
+    /**
+     * Use the traditional memory-mapped implementation for BAM file indexes rather than regular I/O.
+     */
+    private boolean mEnableIndexMemoryMapping = true;
+
+    /**
+     * Add information about the origin (reader and position) to SAM records.
+     */
+    private SAMFileReader mFileReader = null;
+
+    /**
+     * Prepare to read BAM from a stream (not seekable)
+     * @param stream source of bytes.
+     * @param eagerDecode if true, decode all BAM fields as reading rather than lazily.
+     * @param validationStringency Controls how to handle invalidate reads or header lines.
+     */
+    BAMFileReader(final InputStream stream,
+                  final File indexFile,
+                  final boolean eagerDecode,
+                  final ValidationStringency validationStringency,
+                  final SAMRecordFactory factory)
+        throws IOException {
+        mIndexFile = indexFile;
+        mIsSeekable = false;
+        mInputStream = stream instanceof BAMInputStream ? (BAMInputStream)stream : new BlockCompressedInputStream(stream);
+        mStream = new BinaryCodec(new DataInputStream((InputStream)mInputStream));
+        this.eagerDecode = eagerDecode;
+        this.mValidationStringency = validationStringency;
+        this.samRecordFactory = factory;
+        readHeader(null);
+    }
+
+    /**
+     * Prepare to read BAM from a file (seekable)
+     * @param file source of bytes.
+     * @param eagerDecode if true, decode all BAM fields as reading rather than lazily.
+     * @param validationStringency Controls how to handle invalidate reads or header lines.
+     */
+    BAMFileReader(final File file,
+                  final File indexFile,
+                  final boolean eagerDecode,
+                  final ValidationStringency validationStringency,
+                  final SAMRecordFactory factory)
+        throws IOException {
+        this(new BlockCompressedInputStream(file), indexFile!=null ? indexFile : findIndexFile(file), eagerDecode, file.getAbsolutePath(), validationStringency, factory);
+        if (mIndexFile != null && mIndexFile.lastModified() < file.lastModified()) {
+            System.err.println("WARNING: BAM index file " + mIndexFile.getAbsolutePath() +
+                    " is older than BAM " + file.getAbsolutePath());
+        }        
+    }
+
+    BAMFileReader(final SeekableStream strm,
+                  final File indexFile,
+                  final boolean eagerDecode,
+                  final ValidationStringency validationStringency,
+                  final SAMRecordFactory factory)
+        throws IOException {
+        this(strm instanceof BAMInputStream ? (BAMInputStream)strm : new BlockCompressedInputStream(strm),
+                indexFile,
+                eagerDecode,
+                strm.getSource(),
+                validationStringency,
+                factory);
+    }
+
+    private BAMFileReader(final BAMInputStream inputStream,
+                          final File indexFile,
+                          final boolean eagerDecode,
+                          final String source,
+                          final ValidationStringency validationStringency,
+                          final SAMRecordFactory factory)
+        throws IOException {
+        mIndexFile = indexFile;
+        mIsSeekable = true;
+        mInputStream = inputStream;
+        mStream = new BinaryCodec(new DataInputStream((InputStream)inputStream));
+        this.eagerDecode = eagerDecode;
+        this.mValidationStringency = validationStringency;
+        this.samRecordFactory = factory;
+        readHeader(source);
+        mFirstRecordPointer = inputStream.getFilePointer();
+    }
+
+    /**
+     * If true, writes the source of every read into the source SAMRecords.
+     * @param enabled true to write source information into each SAMRecord.
+     */
+    void enableFileSource(final SAMFileReader reader, final boolean enabled) {
+        this.mFileReader = enabled ? reader : null;
+    }
+
+    /**
+     * If true, uses the caching version of the index reader.
+     * @param enabled true to write source information into each SAMRecord.
+     */
+    public void enableIndexCaching(final boolean enabled) {
+        if(mIndex != null)
+            throw new SAMException("Unable to turn on index caching; index file has already been loaded.");
+        this.mEnableIndexCaching = enabled;
+    }
+
+    /**
+     * If false, disable the use of memory mapping for accessing index files (default behavior is to use memory mapping).
+     * This is slower but more scalable when accessing large numbers of BAM files sequentially.
+     * @param enabled True to use memory mapping, false to use regular I/O.
+     */
+    public void enableIndexMemoryMapping(final boolean enabled) {
+        if (mIndex != null) {
+            throw new SAMException("Unable to change index memory mapping; index file has already been loaded.");
+        }
+        this.mEnableIndexMemoryMapping = enabled;
+    }
+
+    @Override void enableCrcChecking(final boolean enabled) {
+        this.mInputStream.setCheckCrcs(enabled);
+    }
+
+    @Override void setSAMRecordFactory(final SAMRecordFactory factory) { this.samRecordFactory = factory; }
+
+    /**
+     * @return true if ths is a BAM file, and has an index
+     */
+    public boolean hasIndex() {
+        return (mIndexFile != null);
+    }
+
+    /**
+     * Retrieves the index for the given file type.  Ensure that the index is of the specified type.
+     * @return An index of the given type.
+     */
+    public BAMIndex getIndex() {
+        if(mIndexFile == null)
+            throw new SAMException("No index is available for this BAM file.");
+        if(mIndex == null)
+            mIndex = mEnableIndexCaching ? new CachingBAMFileIndex(mIndexFile, getFileHeader().getSequenceDictionary(), mEnableIndexMemoryMapping)
+                                         : new DiskBasedBAMFileIndex(mIndexFile, getFileHeader().getSequenceDictionary(), mEnableIndexMemoryMapping);
+        return mIndex;
+    }
+
+    void close() {
+        if (mStream != null) {
+            mStream.close();
+        }
+        if (mIndex != null) {
+            mIndex.close();
+        }
+        mStream = null;
+        mFileHeader = null;
+        mIndex = null;
+    }
+
+    SAMFileHeader getFileHeader() {
+        return mFileHeader;
+    }
+
+    /**
+     * Set error-checking level for subsequent SAMRecord reads.
+     */
+    void setValidationStringency(final SAMFileReader.ValidationStringency validationStringency) {
+        this.mValidationStringency = validationStringency;
+    }
+
+    SAMFileReader.ValidationStringency getValidationStringency() {
+        return this.mValidationStringency;
+    }
+
+    /**
+     * Prepare to iterate through the SAMRecords in file order.
+     * Only a single iterator on a BAM file can be extant at a time.  If getIterator() or a query method has been called once,
+     * that iterator must be closed before getIterator() can be called again.
+     * A somewhat peculiar aspect of this method is that if the file is not seekable, a second call to
+     * getIterator() begins its iteration where the last one left off.  That is the best that can be
+     * done in that situation.
+     */
+    CloseableIterator<SAMRecord> getIterator() {
+        if (mStream == null) {
+            throw new IllegalStateException("File reader is closed");
+        }
+        if (mCurrentIterator != null) {
+            throw new IllegalStateException("Iteration in progress");
+        }
+        if (mIsSeekable) {
+            try {
+                mInputStream.seek(mFirstRecordPointer);
+            } catch (IOException exc) {
+                throw new RuntimeException(exc.getMessage(), exc);
+            }
+        }
+        mCurrentIterator = new BAMFileIterator();
+        return mCurrentIterator;
+    }
+
+    @Override
+    CloseableIterator<SAMRecord> getIterator(final SAMFileSpan chunks) {
+        if (mStream == null) {
+            throw new IllegalStateException("File reader is closed");
+        }
+        if (mCurrentIterator != null) {
+            throw new IllegalStateException("Iteration in progress");
+        }
+        if (!(chunks instanceof BAMFileSpan)) {
+            throw new IllegalStateException("BAMFileReader cannot handle this type of file span.");
+        }
+
+        // Create an iterator over the given chunk boundaries.
+        mCurrentIterator = new BAMFileIndexIterator(((BAMFileSpan)chunks).toCoordinateArray());
+        return mCurrentIterator;
+    }
+
+    /**
+     * Gets an unbounded pointer to the first record in the BAM file.  Because the reader doesn't necessarily know
+     * when the file ends, the rightmost bound of the file pointer will not end exactly where the file ends.  However,
+     * the rightmost bound is guaranteed to be after the last read in the file.
+     * @return An unbounded pointer to the first record in the BAM file.
+     */
+    @Override
+    SAMFileSpan getFilePointerSpanningReads() {
+        return new BAMFileSpan(new Chunk(mFirstRecordPointer,Long.MAX_VALUE));
+    }
+
+    /**
+     * Prepare to iterate through the SAMRecords that match the given interval.
+     * Only a single iterator on a BAMFile can be extant at a time.  The previous one must be closed
+     * before calling any of the methods that return an iterator.
+     *
+     * Note that an unmapped SAMRecord may still have a reference name and an alignment start for sorting
+     * purposes (typically this is the coordinate of its mate), and will be found by this method if the coordinate
+     * matches the specified interval.
+     *
+     * Note that this method is not necessarily efficient in terms of disk I/O.  The index does not have perfect
+     * resolution, so some SAMRecords may be read and then discarded because they do not match the specified interval.
+     *
+     * @param sequence Reference sequence sought.
+     * @param start Desired SAMRecords must overlap or be contained in the interval specified by start and end.
+     * A value of zero implies the start of the reference sequence.
+     * @param end A value of zero implies the end of the reference sequence.
+     * @param contained If true, the alignments for the SAMRecords must be completely contained in the interval
+     * specified by start and end.  If false, the SAMRecords need only overlap the interval.
+     * @return Iterator for the matching SAMRecords
+     */
+    CloseableIterator<SAMRecord> query(final String sequence, final int start, final int end, final boolean contained) {
+        if (mStream == null) {
+            throw new IllegalStateException("File reader is closed");
+        }
+        if (mCurrentIterator != null) {
+            throw new IllegalStateException("Iteration in progress");
+        }
+        if (!mIsSeekable) {
+            throw new UnsupportedOperationException("Cannot query stream-based BAM file");
+        }
+        mCurrentIterator = createIndexIterator(sequence, start, end, contained? QueryType.CONTAINED: QueryType.OVERLAPPING);
+        return mCurrentIterator;
+    }
+
+    /**
+     * Prepare to iterate through the SAMRecords with the given alignment start.
+     * Only a single iterator on a BAMFile can be extant at a time.  The previous one must be closed
+     * before calling any of the methods that return an iterator.
+     *
+     * Note that an unmapped SAMRecord may still have a reference name and an alignment start for sorting
+     * purposes (typically this is the coordinate of its mate), and will be found by this method if the coordinate
+     * matches the specified interval.
+     *
+     * Note that this method is not necessarily efficient in terms of disk I/O.  The index does not have perfect
+     * resolution, so some SAMRecords may be read and then discarded because they do not match the specified interval.
+     *
+     * @param sequence Reference sequence sought.
+     * @param start Alignment start sought.
+     * @return Iterator for the matching SAMRecords.
+     */
+    CloseableIterator<SAMRecord> queryAlignmentStart(final String sequence, final int start) {
+        if (mStream == null) {
+            throw new IllegalStateException("File reader is closed");
+        }
+        if (mCurrentIterator != null) {
+            throw new IllegalStateException("Iteration in progress");
+        }
+        if (!mIsSeekable) {
+            throw new UnsupportedOperationException("Cannot query stream-based BAM file");
+        }
+        mCurrentIterator = createIndexIterator(sequence, start, -1, QueryType.STARTING_AT);
+        return mCurrentIterator;
+    }
+
+    public CloseableIterator<SAMRecord> queryUnmapped() {
+        if (mStream == null) {
+            throw new IllegalStateException("File reader is closed");
+        }
+        if (mCurrentIterator != null) {
+            throw new IllegalStateException("Iteration in progress");
+        }
+        if (!mIsSeekable) {
+            throw new UnsupportedOperationException("Cannot query stream-based BAM file");
+        }
+        try {
+            final long startOfLastLinearBin = getIndex().getStartOfLastLinearBin();
+            if (startOfLastLinearBin != -1) {
+                mInputStream.seek(startOfLastLinearBin);
+            } else {
+                // No mapped reads in file, just start at the first read in file.
+                mInputStream.seek(mFirstRecordPointer);
+            }
+            mCurrentIterator = new BAMFileIndexUnmappedIterator();
+            return mCurrentIterator;
+        } catch (IOException e) {
+            throw new RuntimeException("IOException seeking to unmapped reads", e);
+        }
+    }
+
+    /**
+     * Reads the header from the file or stream
+     * @param source Note that this is used only for reporting errors.
+     */
+    private void readHeader(final String source)
+        throws IOException {
+
+        final byte[] buffer = new byte[4];
+        mStream.readBytes(buffer);
+        if (!Arrays.equals(buffer, BAMFileConstants.BAM_MAGIC)) {
+            throw new IOException("Invalid BAM file header");
+        }
+
+        final int headerTextLength = mStream.readInt();
+        final String textHeader = mStream.readString(headerTextLength);
+        final SAMTextHeaderCodec headerCodec = new SAMTextHeaderCodec();
+        headerCodec.setValidationStringency(mValidationStringency);
+        mFileHeader = headerCodec.decode(new StringLineReader(textHeader),
+                source);
+
+        final int sequenceCount = mStream.readInt();
+        if (mFileHeader.getSequenceDictionary().size() > 0) {
+            // It is allowed to have binary sequences but no text sequences, so only validate if both are present
+            if (sequenceCount != mFileHeader.getSequenceDictionary().size()) {
+                throw new SAMFormatException("Number of sequences in text header (" +
+                        mFileHeader.getSequenceDictionary().size() +
+                        ") != number of sequences in binary header (" + sequenceCount + ") for file " + source);
+            }
+            for (int i = 0; i < sequenceCount; i++) {
+                final SAMSequenceRecord binarySequenceRecord = readSequenceRecord(source);
+                final SAMSequenceRecord sequenceRecord = mFileHeader.getSequence(i);
+                if (!sequenceRecord.getSequenceName().equals(binarySequenceRecord.getSequenceName())) {
+                    throw new SAMFormatException("For sequence " + i + ", text and binary have different names in file " +
+                            source);
+                }
+                if (sequenceRecord.getSequenceLength() != binarySequenceRecord.getSequenceLength()) {
+                    throw new SAMFormatException("For sequence " + i + ", text and binary have different lengths in file " +
+                            source);
+                }
+            }
+        } else {
+            // If only binary sequences are present, copy them into mFileHeader
+            final List<SAMSequenceRecord> sequences = new ArrayList<SAMSequenceRecord>(sequenceCount);
+            for (int i = 0; i < sequenceCount; i++) {
+                sequences.add(readSequenceRecord(source));
+            }
+            mFileHeader.setSequenceDictionary(new SAMSequenceDictionary(sequences));
+        }
+    }
+
+    /**
+     * Reads a single binary sequence record from the file or stream
+     * @param source Note that this is used only for reporting errors.
+     */
+    private SAMSequenceRecord readSequenceRecord(final String source) {
+        final int nameLength = mStream.readInt();
+        if (nameLength <= 1) {
+            throw new SAMFormatException("Invalid BAM file header: missing sequence name in file " + source);
+        }
+        final String sequenceName = mStream.readString(nameLength - 1);
+        // Skip the null terminator
+        mStream.readByte();
+        final int sequenceLength = mStream.readInt();
+        return new SAMSequenceRecord(SAMSequenceRecord.truncateSequenceName(sequenceName), sequenceLength);
+    }
+
+    /**
+     * Iterator for non-indexed sequential iteration through all SAMRecords in file.
+     * Starting point of iteration is wherever current file position is when the iterator is constructed.
+     */
+    private class BAMFileIterator implements CloseableIterator<SAMRecord> {
+        private SAMRecord mNextRecord = null;
+        private final BAMRecordCodec bamRecordCodec;
+        private long samRecordIndex = 0; // Records at what position (counted in records) we are at in the file
+
+        BAMFileIterator() {
+            this(true);
+        }
+
+        /**
+         * @param advance Trick to enable subclass to do more setup before advancing
+         */
+        BAMFileIterator(final boolean advance) {
+            this.bamRecordCodec = new BAMRecordCodec(getFileHeader(), samRecordFactory);
+            this.bamRecordCodec.setInputStream(BAMFileReader.this.mStream.getInputStream());
+
+            if (advance) {
+                advance();
+            }
+        }
+
+        public void close() {
+            if (mCurrentIterator != null && this != mCurrentIterator) {
+                throw new IllegalStateException("Attempt to close non-current iterator");
+            }
+            mCurrentIterator = null;
+        }
+
+        public boolean hasNext() {
+            return (mNextRecord != null);
+        }
+
+        public SAMRecord next() {
+            final SAMRecord result = mNextRecord;
+            advance();
+            return result;
+        }
+
+        public void remove() {
+            throw new UnsupportedOperationException("Not supported: remove");
+        }
+
+        void advance() {
+            try {
+                mNextRecord = getNextRecord();
+
+                if (mNextRecord != null) {
+                    ++this.samRecordIndex;
+                    // Because some decoding is done lazily, the record needs to remember the validation stringency.
+                    mNextRecord.setValidationStringency(mValidationStringency);
+
+                    if (mValidationStringency != ValidationStringency.SILENT) {
+                        final List<SAMValidationError> validationErrors = mNextRecord.isValid();
+                        SAMUtils.processValidationErrors(validationErrors,
+                                this.samRecordIndex, BAMFileReader.this.getValidationStringency());
+                    }
+                }
+                if (eagerDecode && mNextRecord != null) {
+                    mNextRecord.eagerDecode();
+                }
+            } catch (IOException exc) {
+                throw new RuntimeException(exc.getMessage(), exc);
+            }
+        }
+
+        /**
+         * Read the next record from the input stream.
+         */
+        SAMRecord getNextRecord() throws IOException {
+            final long startCoordinate = mInputStream.getFilePointer();
+            final SAMRecord next = bamRecordCodec.decode();
+            final long stopCoordinate = mInputStream.getFilePointer();
+
+            if(mFileReader != null && next != null)
+                next.setFileSource(new SAMFileSource(mFileReader,new BAMFileSpan(new Chunk(startCoordinate,stopCoordinate))));
+
+            return next;
+        }
+
+        /**
+         * @return The record that will be return by the next call to next()
+         */
+        protected SAMRecord peek() {
+            return mNextRecord;
+        }
+    }
+
+    /**
+     * Prepare to iterate through SAMRecords matching the target interval.
+     * @param sequence Desired reference sequence.
+     * @param start 1-based start of target interval, inclusive.
+     * @param end 1-based end of target interval, inclusive.
+     * @param queryType contained, overlapping, or starting-at query.
+     */
+    private CloseableIterator<SAMRecord> createIndexIterator(final String sequence,
+                                                             final int start,
+                                                             final int end,
+                                                             final QueryType queryType) {
+        long[] filePointers = null;
+
+        // Hit the index to determine the chunk boundaries for the required data.
+        final SAMFileHeader fileHeader = getFileHeader();
+        final int referenceIndex = fileHeader.getSequenceIndex(sequence);
+        if (referenceIndex != -1) {
+            final BAMIndex fileIndex = getIndex();
+            final BAMFileSpan fileSpan = fileIndex.getSpanOverlapping(referenceIndex, start, end);
+            filePointers = fileSpan != null ? fileSpan.toCoordinateArray() : null;
+        }
+
+        // Create an iterator over the above chunk boundaries.
+        final BAMFileIndexIterator iterator = new BAMFileIndexIterator(filePointers);
+
+        // Add some preprocessing filters for edge-case reads that don't fit into this
+        // query type.
+        return new BAMQueryFilteringIterator(iterator,sequence,start,end,queryType);
+    }
+
+    enum QueryType {CONTAINED, OVERLAPPING, STARTING_AT}
+
+    /**
+     * Look for BAM index file according to standard naming convention.
+     *
+     * @param dataFile BAM file name.
+     * @return Index file name, or null if not found.
+     */
+    private static File findIndexFile(final File dataFile) {
+        // If input is foo.bam, look for foo.bai
+        final String bamExtension = ".bam";
+        File indexFile;
+        final String fileName = dataFile.getName();
+        if (fileName.endsWith(bamExtension)) {
+            final String bai = fileName.substring(0, fileName.length() - bamExtension.length()) + BAMIndex.BAMIndexSuffix;
+            indexFile = new File(dataFile.getParent(), bai);
+            if (indexFile.exists()) {
+                return indexFile;
+            }
+        }
+
+        // If foo.bai doesn't exist look for foo.bam.bai
+        indexFile = new File(dataFile.getParent(), dataFile.getName() + ".bai");
+        if (indexFile.exists()) {
+            return indexFile;
+        } else {
+            return null;
+        }
+    }    
+
+    private class BAMFileIndexIterator extends BAMFileIterator {
+
+        private long[] mFilePointers = null;
+        private int mFilePointerIndex = 0;
+        private long mFilePointerLimit = -1;
+
+        /**
+         * Prepare to iterate through SAMRecords stored in the specified compressed blocks at the given offset.
+         * @param filePointers the block / offset combination, stored in chunk format.
+         */
+        BAMFileIndexIterator(final long[] filePointers) {
+            super(false);  // delay advance() until after construction
+            mFilePointers = filePointers;
+            advance();
+        }
+
+        SAMRecord getNextRecord()
+            throws IOException {
+            // Advance to next file block if necessary
+            while (mInputStream.getFilePointer() >= mFilePointerLimit) {
+                if (mFilePointers == null ||
+                        mFilePointerIndex >= mFilePointers.length) {
+                    return null;
+                }
+                final long startOffset = mFilePointers[mFilePointerIndex++];
+                final long endOffset = mFilePointers[mFilePointerIndex++];
+                mInputStream.seek(startOffset);
+                mFilePointerLimit = endOffset;
+            }
+            // Pull next record from stream
+            return super.getNextRecord();
+        }
+    }
+
+    /**
+     * A decorating iterator that filters out records that are outside the bounds of the
+     * given query parameters.
+     */
+    private class BAMQueryFilteringIterator implements CloseableIterator<SAMRecord> {
+        /**
+         * The wrapped iterator.
+         */
+        private final CloseableIterator<SAMRecord> wrappedIterator;
+
+        /**
+         * The next record to be returned.  Will be null if no such record exists.
+         */
+        private SAMRecord mNextRecord;
+
+        private final int mReferenceIndex;
+        private final int mRegionStart;
+        private final int mRegionEnd;
+        private final QueryType mQueryType;
+
+        public BAMQueryFilteringIterator(final CloseableIterator<SAMRecord> iterator,final String sequence, final int start, final int end, final QueryType queryType) {
+            this.wrappedIterator = iterator;
+            final SAMFileHeader fileHeader = getFileHeader();
+            mReferenceIndex = fileHeader.getSequenceIndex(sequence);
+            mRegionStart = start;
+            if (queryType == QueryType.STARTING_AT) {
+                mRegionEnd = mRegionStart;
+            } else {
+                mRegionEnd = (end <= 0) ? Integer.MAX_VALUE : end;
+            }
+            mQueryType = queryType;
+            mNextRecord = advance();
+        }
+
+        /**
+         * Returns true if a next element exists; false otherwise.
+         */
+        public boolean hasNext() {
+            return mNextRecord != null;
+        }
+
+        /**
+         * Gets the next record from the given iterator.
+         * @return The next SAM record in the iterator.
+         */
+        public SAMRecord next() {
+            if(!hasNext())
+                throw new NoSuchElementException("BAMQueryFilteringIterator: no next element available");
+            final SAMRecord currentRead = mNextRecord;
+            mNextRecord = advance();
+            return currentRead;
+        }
+
+        /**
+         * Closes down the existing iterator.
+         */
+        public void close() {
+            if (this != mCurrentIterator) {
+                throw new IllegalStateException("Attempt to close non-current iterator");
+            }
+            mCurrentIterator = null;
+        }
+
+        /**
+         * @throws UnsupportedOperationException always.
+         */
+        public void remove() {
+            throw new UnsupportedOperationException("Not supported: remove");
+        }
+
+        SAMRecord advance() {
+            while (true) {
+                // Pull next record from stream
+                if(!wrappedIterator.hasNext())
+                    return null;
+
+                final SAMRecord record = wrappedIterator.next();
+                // If beyond the end of this reference sequence, end iteration
+                final int referenceIndex = record.getReferenceIndex();
+                if (referenceIndex != mReferenceIndex) {
+                    if (referenceIndex < 0 ||
+                        referenceIndex > mReferenceIndex) {
+                        return null;
+                    }
+                    // If before this reference sequence, continue
+                    continue;
+                }
+                if (mRegionStart == 0 && mRegionEnd == Integer.MAX_VALUE) {
+                    // Quick exit to avoid expensive alignment end calculation
+                    return record;
+                }
+                final int alignmentStart = record.getAlignmentStart();
+                // If read is unmapped but has a coordinate, return it if the coordinate is within
+                // the query region, regardless of whether the mapped mate will be returned.
+                final int alignmentEnd;
+                if (mQueryType == QueryType.STARTING_AT) {
+                    alignmentEnd = -1;
+                } else {
+                    alignmentEnd = (record.getAlignmentEnd() != SAMRecord.NO_ALIGNMENT_START?
+                            record.getAlignmentEnd(): alignmentStart);
+                }
+
+                if (alignmentStart > mRegionEnd) {
+                    // If scanned beyond target region, end iteration
+                    return null;
+                }
+                // Filter for overlap with region
+                if (mQueryType == QueryType.CONTAINED) {
+                    if (alignmentStart >= mRegionStart && alignmentEnd <= mRegionEnd) {
+                        return record;
+                    }
+                } else if (mQueryType == QueryType.OVERLAPPING) {
+                    if (alignmentEnd >= mRegionStart && alignmentStart <= mRegionEnd) {
+                        return record;
+                    }
+                } else {
+                    if (alignmentStart == mRegionStart) {
+                        return record;
+                    }
+                }
+            }
+        }
+    }
+
+    private class BAMFileIndexUnmappedIterator extends BAMFileIterator  {
+        private BAMFileIndexUnmappedIterator() {
+            while (this.hasNext() && peek().getReferenceIndex() != SAMRecord.NO_ALIGNMENT_REFERENCE_INDEX) {
+                advance();
+            }
+        }
+    }
+
+}
diff --git a/public/java/src/net/sf/samtools/GATKBAMFileSpan.java b/public/java/src/net/sf/samtools/GATKBAMFileSpan.java
index 623f46291..4692c6671 100644
--- a/public/java/src/net/sf/samtools/GATKBAMFileSpan.java
+++ b/public/java/src/net/sf/samtools/GATKBAMFileSpan.java
@@ -25,6 +25,7 @@
 package net.sf.samtools;
 
 import net.sf.picard.util.PeekableIterator;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -47,6 +48,18 @@ public class GATKBAMFileSpan extends BAMFileSpan {
         super();
     }
 
+    /**
+     * Create a new GATKBAMFileSpan from an existing BAMFileSpan.
+     * @param sourceFileSpan
+     */
+    public GATKBAMFileSpan(SAMFileSpan sourceFileSpan) {
+        if(!(sourceFileSpan instanceof BAMFileSpan))
+            throw new SAMException("Unable to create GATKBAMFileSpan from a SAMFileSpan. Please submit a BAMFileSpan instead");
+        BAMFileSpan sourceBAMFileSpan = (BAMFileSpan)sourceFileSpan;
+        for(Chunk chunk: sourceBAMFileSpan.getChunks())
+            add(chunk instanceof GATKChunk ? chunk : new GATKChunk(chunk));
+    }
+
     /**
      * Convenience constructor to construct a BAM file span from
      * a single chunk.
diff --git a/public/java/src/net/sf/samtools/GATKChunk.java b/public/java/src/net/sf/samtools/GATKChunk.java
index f590809e2..5d349e72e 100644
--- a/public/java/src/net/sf/samtools/GATKChunk.java
+++ b/public/java/src/net/sf/samtools/GATKChunk.java
@@ -69,6 +69,22 @@ public class GATKChunk extends Chunk {
         super.setChunkEnd(value);
     }
 
+    public long getBlockStart() {
+        return getChunkStart() >>> 16;
+    }
+
+    public int getBlockOffsetStart() {
+        return (int)(getChunkStart() & 0xFFFF);
+    }
+
+    public long getBlockEnd() {
+        return getChunkEnd() >>> 16;
+    }
+
+    public int getBlockOffsetEnd() {
+        return ((int)getChunkEnd() & 0xFFFF);
+    }
+
     /**
      * Computes an approximation of the uncompressed size of the
      * chunk, in bytes.  Can be used to determine relative weights
diff --git a/public/java/src/net/sf/samtools/util/BAMInputStream.java b/public/java/src/net/sf/samtools/util/BAMInputStream.java
new file mode 100644
index 000000000..d825c23d5
--- /dev/null
+++ b/public/java/src/net/sf/samtools/util/BAMInputStream.java
@@ -0,0 +1,72 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package net.sf.samtools.util;
+
+import java.io.IOException;
+
+/**
+ * An input stream formulated for use reading BAM files.  Supports
+ */
+public interface BAMInputStream {
+    /**
+     * Seek to the given position in the file.  Note that pos is a special virtual file pointer,
+     * not an actual byte offset.
+     *
+     * @param pos virtual file pointer
+     */
+    public void seek(final long pos) throws IOException;
+
+    /**
+     * @return virtual file pointer that can be passed to seek() to return to the current position.  This is
+     * not an actual byte offset, so arithmetic on file pointers cannot be done to determine the distance between
+     * the two.
+     */
+    public long getFilePointer();
+
+    /**
+     * Determines whether or not the inflater will re-calculated the CRC on the decompressed data
+     * and check it against the value stored in the GZIP header.  CRC checking is an expensive
+     * operation and should be used accordingly.
+     */
+    public void setCheckCrcs(final boolean check);
+
+    public int read() throws java.io.IOException;
+
+    public int read(byte[] bytes) throws java.io.IOException;
+
+    public int read(byte[] bytes, int i, int i1) throws java.io.IOException;
+
+    public long skip(long l) throws java.io.IOException;
+
+    public int available() throws java.io.IOException;
+
+    public void close() throws java.io.IOException;
+
+    public void mark(int i);
+
+    public void reset() throws java.io.IOException;
+
+    public boolean markSupported();
+}
diff --git a/public/java/src/net/sf/samtools/util/BlockCompressedInputStream.java b/public/java/src/net/sf/samtools/util/BlockCompressedInputStream.java
new file mode 100755
index 000000000..fae2fc89b
--- /dev/null
+++ b/public/java/src/net/sf/samtools/util/BlockCompressedInputStream.java
@@ -0,0 +1,483 @@
+/*
+ * The MIT License
+ *
+ * Copyright (c) 2009 The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package net.sf.samtools.util;
+
+
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.RandomAccessFile;
+import java.net.URL;
+import java.nio.ByteBuffer;
+import java.nio.ByteOrder;
+import java.util.Arrays;
+
+import net.sf.samtools.FileTruncatedException;
+
+/*
+ * Utility class for reading BGZF block compressed files.  The caller can treat this file like any other InputStream.
+ * It probably is not necessary to wrap this stream in a buffering stream, because there is internal buffering.
+ * The advantage of BGZF over conventional GZip format is that BGZF allows for seeking without having to read the
+ * entire file up to the location being sought.  Note that seeking is only possible if the ctor(File) is used.
+ *
+ * c.f. http://samtools.sourceforge.net/SAM1.pdf for details of BGZF format
+ */
+public class BlockCompressedInputStream extends InputStream implements BAMInputStream {
+    private InputStream mStream = null;
+    private SeekableStream mFile = null;
+    private byte[] mFileBuffer = null;
+    private byte[] mCurrentBlock = null;
+    private int mCurrentOffset = 0;
+    private long mBlockAddress = 0;
+    private int mLastBlockLength = 0;
+    private final BlockGunzipper blockGunzipper = new BlockGunzipper();
+
+
+    /**
+     * Note that seek() is not supported if this ctor is used.
+     */
+    public BlockCompressedInputStream(final InputStream stream) {
+        mStream = IOUtil.toBufferedStream(stream);
+        mFile = null;
+    }
+
+    /**
+     * Use this ctor if you wish to call seek()
+     */
+    public BlockCompressedInputStream(final File file)
+        throws IOException {
+        mFile = new SeekableFileStream(file);
+        mStream = null;
+
+    }
+
+    public BlockCompressedInputStream(final URL url) {
+        mFile = new SeekableBufferedStream(new SeekableHTTPStream(url));
+        mStream = null;
+    }
+
+    /**
+     * For providing some arbitrary data source.  No additional buffering is
+     * provided, so if the underlying source is not buffered, wrap it in a
+     * SeekableBufferedStream before passing to this ctor.
+     */
+    public BlockCompressedInputStream(final SeekableStream strm) {
+        mFile = strm;
+        mStream = null;
+    }
+
+    /**
+     * Determines whether or not the inflater will re-calculated the CRC on the decompressed data
+     * and check it against the value stored in the GZIP header.  CRC checking is an expensive
+     * operation and should be used accordingly.
+     */
+    public void setCheckCrcs(final boolean check) {
+        this.blockGunzipper.setCheckCrcs(check);
+    }
+
+    /**
+     * @return the number of bytes that can be read (or skipped over) from this input stream without blocking by the
+     * next caller of a method for this input stream. The next caller might be the same thread or another thread.
+     * Note that although the next caller can read this many bytes without blocking, the available() method call itself
+     * may block in order to fill an internal buffer if it has been exhausted.
+     */
+    public int available()
+        throws IOException {
+        if (mCurrentBlock == null || mCurrentOffset == mCurrentBlock.length) {
+            readBlock();
+        }
+        if (mCurrentBlock == null) {
+            return 0;
+        }
+        return mCurrentBlock.length - mCurrentOffset;
+    }
+
+    /**
+     * Closes the underlying InputStream or RandomAccessFile
+     */
+    public void close()
+        throws IOException {
+        if (mFile != null) {
+            mFile.close();
+            mFile = null;
+        } else if (mStream != null) {
+            mStream.close();
+            mStream = null;
+        }
+        // Encourage garbage collection
+        mFileBuffer = null;
+        mCurrentBlock = null;
+    }
+
+    /**
+     * Reads the next byte of data from the input stream. The value byte is returned as an int in the range 0 to 255.
+     * If no byte is available because the end of the stream has been reached, the value -1 is returned.
+     * This method blocks until input data is available, the end of the stream is detected, or an exception is thrown.
+
+     * @return the next byte of data, or -1 if the end of the stream is reached.
+     */
+    public int read()
+        throws IOException {
+        return (available() > 0) ? mCurrentBlock[mCurrentOffset++] : -1;
+    }
+
+    /**
+     * Reads some number of bytes from the input stream and stores them into the buffer array b. The number of bytes
+     * actually read is returned as an integer. This method blocks until input data is available, end of file is detected,
+     * or an exception is thrown.
+     *
+     * read(buf) has the same effect as read(buf, 0, buf.length).
+     *
+     * @param buffer the buffer into which the data is read.
+     * @return the total number of bytes read into the buffer, or -1 is there is no more data because the end of
+     * the stream has been reached.
+     */
+    public int read(final byte[] buffer)
+        throws IOException {
+        return read(buffer, 0, buffer.length);
+    }
+
+    private volatile ByteArrayOutputStream buf = null;
+    private static final byte eol = '\n';
+    private static final byte eolCr = '\r';
+    
+    /**
+     * Reads a whole line. A line is considered to be terminated by either a line feed ('\n'), 
+     * carriage return ('\r') or carriage return followed by a line feed ("\r\n").
+     *
+     * @return  A String containing the contents of the line, excluding the line terminating
+     *          character, or null if the end of the stream has been reached
+     *
+     * @exception  IOException  If an I/O error occurs
+     * @
+     */
+    public String readLine() throws IOException {
+    	int available = available();
+        if (available == 0) {
+            return null;
+        }
+        if(null == buf){ // lazy initialisation 
+        	buf = new ByteArrayOutputStream(8192);
+        }
+        buf.reset();
+    	boolean done = false;
+    	boolean foundCr = false; // \r found flag
+        while (!done) {
+        	int linetmpPos = mCurrentOffset;
+        	int bCnt = 0;
+        	while((available-- > 0)){
+        		final byte c = mCurrentBlock[linetmpPos++];
+        		if(c == eol){ // found \n
+        			done = true;
+        			break;
+        		} else if(foundCr){  // previous char was \r
+        			--linetmpPos; // current char is not \n so put it back
+        			done = true;
+        			break;
+        		} else if(c == eolCr){ // found \r
+					foundCr = true;
+        			continue; // no ++bCnt
+        		}
+				++bCnt;
+        	}
+        	if(mCurrentOffset < linetmpPos){
+				buf.write(mCurrentBlock, mCurrentOffset, bCnt);
+	        	mCurrentOffset = linetmpPos;
+        	}
+        	available = available();    
+        	if(available == 0){
+        		// EOF
+        		done = true;
+        	}
+        }
+    	return buf.toString();
+    }
+
+    /**
+     * Reads up to len bytes of data from the input stream into an array of bytes. An attempt is made to read
+     * as many as len bytes, but a smaller number may be read. The number of bytes actually read is returned as an integer.
+     *
+     * This method blocks until input data is available, end of file is detected, or an exception is thrown.
+     *
+     * @param buffer buffer into which data is read.
+     * @param offset the start offset in array b  at which the data is written.
+     * @param length the maximum number of bytes to read.
+     * @return the total number of bytes read into the buffer, or -1 if there is no more data because the end of
+     * the stream has been reached.
+     */
+    public int read(final byte[] buffer, int offset, int length)
+        throws IOException {
+        final int originalLength = length;
+        while (length > 0) {
+            final int available = available();
+            if (available == 0) {
+                // Signal EOF to caller
+                if (originalLength == length) {
+                    return -1;
+                }
+                break;
+            }
+            final int copyLength = Math.min(length, available);
+            System.arraycopy(mCurrentBlock, mCurrentOffset, buffer, offset, copyLength);
+            mCurrentOffset += copyLength;
+            offset += copyLength;
+            length -= copyLength;
+        }
+        return originalLength - length;
+    }
+
+    /**
+     * Seek to the given position in the file.  Note that pos is a special virtual file pointer,
+     * not an actual byte offset.
+     *
+     * @param pos virtual file pointer
+     */
+    public void seek(final long pos)
+        throws IOException {
+        if (mFile == null) {
+            throw new IOException("Cannot seek on stream based file");
+        }
+        // Decode virtual file pointer
+        // Upper 48 bits is the byte offset into the compressed stream of a block.
+        // Lower 16 bits is the byte offset into the uncompressed stream inside the block.
+        final long compressedOffset = BlockCompressedFilePointerUtil.getBlockAddress(pos);
+        final int uncompressedOffset = BlockCompressedFilePointerUtil.getBlockOffset(pos);
+        final int available;
+        if (mBlockAddress == compressedOffset && mCurrentBlock != null) {
+            available = mCurrentBlock.length;
+        } else {
+            mFile.seek(compressedOffset);
+            mBlockAddress = compressedOffset;
+            mLastBlockLength = 0;
+            readBlock();
+            available = available();
+        }
+        if (uncompressedOffset > available ||
+                (uncompressedOffset == available && !eof())) {
+            throw new IOException("Invalid file pointer: " + pos);
+        }
+        mCurrentOffset = uncompressedOffset;
+    }
+
+    private boolean eof() throws IOException {
+        if (mFile.eof()) {
+            return true;
+        }
+        // If the last remaining block is the size of the EMPTY_GZIP_BLOCK, this is the same as being at EOF.
+        return (mFile.length() - (mBlockAddress + mLastBlockLength) == BlockCompressedStreamConstants.EMPTY_GZIP_BLOCK.length);
+    }
+
+    /**
+     * @return virtual file pointer that can be passed to seek() to return to the current position.  This is
+     * not an actual byte offset, so arithmetic on file pointers cannot be done to determine the distance between
+     * the two.
+     */
+    public long getFilePointer() {
+        if (mCurrentOffset == mCurrentBlock.length) {
+            // If current offset is at the end of the current block, file pointer should point
+            // to the beginning of the next block.
+            return BlockCompressedFilePointerUtil.makeFilePointer(mBlockAddress + mLastBlockLength, 0);
+        }
+        return BlockCompressedFilePointerUtil.makeFilePointer(mBlockAddress, mCurrentOffset);
+    }
+
+    public static long getFileBlock(final long bgzfOffset) {
+        return BlockCompressedFilePointerUtil.getBlockAddress(bgzfOffset);
+    }
+    
+    /**
+     * @param stream Must be at start of file.  Throws RuntimeException if !stream.markSupported().
+     * @return true if the given file looks like a valid BGZF file.
+     */
+    public static boolean isValidFile(final InputStream stream)
+        throws IOException {
+        if (!stream.markSupported()) {
+            throw new RuntimeException("Cannot test non-buffered stream");
+        }
+        stream.mark(BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH);
+        final byte[] buffer = new byte[BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH];
+        final int count = readBytes(stream, buffer, 0, BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH);
+        stream.reset();
+        return count == BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH && isValidBlockHeader(buffer);
+    }
+
+    private static boolean isValidBlockHeader(final byte[] buffer) {
+        return (buffer[0] == BlockCompressedStreamConstants.GZIP_ID1 &&
+                (buffer[1] & 0xFF) == BlockCompressedStreamConstants.GZIP_ID2 &&
+                (buffer[3] & BlockCompressedStreamConstants.GZIP_FLG) != 0 &&
+                buffer[10] == BlockCompressedStreamConstants.GZIP_XLEN &&
+                buffer[12] == BlockCompressedStreamConstants.BGZF_ID1 &&
+                buffer[13] == BlockCompressedStreamConstants.BGZF_ID2);
+    }
+
+    private void readBlock()
+        throws IOException {
+
+        if (mFileBuffer == null) {
+            mFileBuffer = new byte[BlockCompressedStreamConstants.MAX_COMPRESSED_BLOCK_SIZE];
+        }
+        int count = readBytes(mFileBuffer, 0, BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH);
+        if (count == 0) {
+            // Handle case where there is no empty gzip block at end.
+            mCurrentOffset = 0;
+            mBlockAddress += mLastBlockLength;
+            mCurrentBlock = new byte[0];
+            return;
+        }
+        if (count != BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH) {
+            throw new IOException("Premature end of file");
+        }
+        final int blockLength = unpackInt16(mFileBuffer, BlockCompressedStreamConstants.BLOCK_LENGTH_OFFSET) + 1;
+        if (blockLength < BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH || blockLength > mFileBuffer.length) {
+            throw new IOException("Unexpected compressed block length: " + blockLength);
+        }
+        final int remaining = blockLength - BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH;
+        count = readBytes(mFileBuffer, BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH, remaining);
+        if (count != remaining) {
+            throw new FileTruncatedException("Premature end of file");
+        }
+        inflateBlock(mFileBuffer, blockLength);
+        mCurrentOffset = 0;
+        mBlockAddress += mLastBlockLength;
+        mLastBlockLength = blockLength;
+    }
+
+    private void inflateBlock(final byte[] compressedBlock, final int compressedLength)
+        throws IOException {
+        final int uncompressedLength = unpackInt32(compressedBlock, compressedLength-4);
+        byte[] buffer = mCurrentBlock;
+        mCurrentBlock = null;
+        if (buffer == null || buffer.length != uncompressedLength) {
+            try {
+                buffer = new byte[uncompressedLength];
+            } catch (NegativeArraySizeException e) {
+                throw new RuntimeException("BGZF file has invalid uncompressedLength: " + uncompressedLength, e);
+            }
+        }
+        blockGunzipper.unzipBlock(buffer, compressedBlock, compressedLength);
+        mCurrentBlock = buffer;
+    }
+
+    private int readBytes(final byte[] buffer, final int offset, final int length)
+        throws IOException {
+        if (mFile != null) {
+            return readBytes(mFile, buffer, offset, length);
+        } else if (mStream != null) {
+            return readBytes(mStream, buffer, offset, length);
+        } else {
+            return 0;
+        }
+    }
+
+    private static int readBytes(final SeekableStream file, final byte[] buffer, final int offset, final int length)
+        throws IOException {
+        int bytesRead = 0;
+        while (bytesRead < length) {
+            final int count = file.read(buffer, offset + bytesRead, length - bytesRead);
+            if (count <= 0) {
+                break;
+            }
+            bytesRead += count;
+        }
+        return bytesRead;
+    }
+
+    private static int readBytes(final InputStream stream, final byte[] buffer, final int offset, final int length)
+        throws IOException {
+        int bytesRead = 0;
+        while (bytesRead < length) {
+            final int count = stream.read(buffer, offset + bytesRead, length - bytesRead);
+            if (count <= 0) {
+                break;
+            }
+            bytesRead += count;
+        }
+        return bytesRead;
+    }
+
+    private int unpackInt16(final byte[] buffer, final int offset) {
+        return ((buffer[offset] & 0xFF) |
+                ((buffer[offset+1] & 0xFF) << 8));
+    }
+
+    private int unpackInt32(final byte[] buffer, final int offset) {
+        return ((buffer[offset] & 0xFF) |
+                ((buffer[offset+1] & 0xFF) << 8) |
+                ((buffer[offset+2] & 0xFF) << 16) |
+                ((buffer[offset+3] & 0xFF) << 24));
+    }
+
+    public enum FileTermination {HAS_TERMINATOR_BLOCK, HAS_HEALTHY_LAST_BLOCK, DEFECTIVE}
+
+    public static FileTermination checkTermination(final File file)
+        throws IOException {
+        final long fileSize = file.length();
+        if (fileSize < BlockCompressedStreamConstants.EMPTY_GZIP_BLOCK.length) {
+            return FileTermination.DEFECTIVE;
+        }
+        final RandomAccessFile raFile = new RandomAccessFile(file, "r");
+        try {
+            raFile.seek(fileSize - BlockCompressedStreamConstants.EMPTY_GZIP_BLOCK.length);
+            byte[] buf = new byte[BlockCompressedStreamConstants.EMPTY_GZIP_BLOCK.length];
+            raFile.readFully(buf);
+            if (Arrays.equals(buf, BlockCompressedStreamConstants.EMPTY_GZIP_BLOCK)) {
+                return FileTermination.HAS_TERMINATOR_BLOCK;
+            }
+            final int bufsize = (int)Math.min(fileSize, BlockCompressedStreamConstants.MAX_COMPRESSED_BLOCK_SIZE);
+            buf = new byte[bufsize];
+            raFile.seek(fileSize - bufsize);
+            raFile.read(buf);
+            for (int i = buf.length - BlockCompressedStreamConstants.EMPTY_GZIP_BLOCK.length;
+                    i >= 0; --i) {
+                if (!preambleEqual(BlockCompressedStreamConstants.GZIP_BLOCK_PREAMBLE,
+                        buf, i, BlockCompressedStreamConstants.GZIP_BLOCK_PREAMBLE.length)) {
+                    continue;
+                }
+                final ByteBuffer byteBuffer = ByteBuffer.wrap(buf, i + BlockCompressedStreamConstants.GZIP_BLOCK_PREAMBLE.length, 4);
+                byteBuffer.order(ByteOrder.LITTLE_ENDIAN);
+                final int totalBlockSizeMinusOne =  byteBuffer.getShort() & 0xFFFF;
+                if (buf.length - i == totalBlockSizeMinusOne + 1) {
+                    return FileTermination.HAS_HEALTHY_LAST_BLOCK;
+                } else {
+                    return FileTermination.DEFECTIVE;
+                }
+            }
+            return FileTermination.DEFECTIVE;
+        } finally {
+            raFile.close();
+        }
+    }
+
+    private static boolean preambleEqual(final byte[] preamble, final byte[] buf, final int startOffset, final int length) {
+        for (int i = 0; i < length; ++i) {
+            if (preamble[i] != buf[i + startOffset]) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+
+
diff --git a/public/java/src/org/broadinstitute/sting/commandline/CommandLineProgram.java b/public/java/src/org/broadinstitute/sting/commandline/CommandLineProgram.java
index bed1e710e..b0b57f7fc 100644
--- a/public/java/src/org/broadinstitute/sting/commandline/CommandLineProgram.java
+++ b/public/java/src/org/broadinstitute/sting/commandline/CommandLineProgram.java
@@ -331,12 +331,12 @@ public abstract class CommandLineProgram {
      * used to indicate an error occured
      *
      * @param msg the message
-     * @param e   the error
+     * @param t   the error
      */
-    public static void exitSystemWithError(String msg, final Exception e) {
+    public static void exitSystemWithError(String msg, final Throwable t) {
         errorPrintf("------------------------------------------------------------------------------------------%n");
         errorPrintf("stack trace %n");
-        e.printStackTrace();
+        t.printStackTrace();
 
         errorPrintf("------------------------------------------------------------------------------------------%n");
         errorPrintf("A GATK RUNTIME ERROR has occurred (version %s):%n", CommandLineGATK.getVersionNumber());
@@ -394,8 +394,8 @@ public abstract class CommandLineProgram {
      *
      * @param e the exception occured
      */
-    public static void exitSystemWithError(Exception e) {
-        exitSystemWithError(e.getMessage(), e);
+    public static void exitSystemWithError(Throwable t) {
+        exitSystemWithError(t.getMessage(), t);
     }
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java b/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
index b8488dc9a..d3db35c07 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
@@ -99,8 +99,8 @@ public class CommandLineGATK extends CommandLineExecutable {
         } catch (net.sf.samtools.SAMException e) {
             // Let's try this out and see how it is received by our users
             exitSystemWithSamError(e);
-        } catch (Exception e) {
-            exitSystemWithError(e);
+        } catch (Throwable t) {
+            exitSystemWithError(t);
         }
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java b/public/java/src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java
index 2ceb4ab46..f2e0b5d0c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/GenomeAnalysisEngine.java
@@ -35,6 +35,7 @@ import org.broadinstitute.sting.gatk.arguments.ValidationExclusion;
 import org.broadinstitute.sting.gatk.datasources.reads.*;
 import org.broadinstitute.sting.gatk.datasources.reference.ReferenceDataSource;
 import org.broadinstitute.sting.gatk.datasources.rmd.ReferenceOrderedDataSource;
+import org.broadinstitute.sting.gatk.resourcemanagement.ThreadAllocation;
 import org.broadinstitute.sting.gatk.samples.SampleDB;
 import org.broadinstitute.sting.gatk.executive.MicroScheduler;
 import org.broadinstitute.sting.gatk.filters.FilterManager;
@@ -126,6 +127,11 @@ public class GenomeAnalysisEngine {
      */
     private Collection<ReadFilter> filters;
 
+    /**
+     * Controls the allocation of threads between CPU vs IO.
+     */
+    private ThreadAllocation threadAllocation;
+
     /**
      * A currently hacky unique name for this GATK instance
      */
@@ -199,6 +205,9 @@ public class GenomeAnalysisEngine {
         if (this.getArguments().nonDeterministicRandomSeed)
             resetRandomGenerator(System.currentTimeMillis());
 
+        // Determine how the threads should be divided between CPU vs. IO.
+        determineThreadAllocation();
+
         // Prepare the data for traversal.
         initializeDataSources();
 
@@ -218,7 +227,7 @@ public class GenomeAnalysisEngine {
         // create the output streams                     "
         initializeOutputStreams(microScheduler.getOutputTracker());
 
-        ShardStrategy shardStrategy = getShardStrategy(readsDataSource,microScheduler.getReference(),intervals);
+        Iterable<Shard> shardStrategy = getShardStrategy(readsDataSource,microScheduler.getReference(),intervals);
 
         // execute the microscheduler, storing the results
         return microScheduler.execute(this.walker, shardStrategy);
@@ -266,6 +275,16 @@ public class GenomeAnalysisEngine {
         return Collections.unmodifiableList(filters);
     }
 
+    /**
+     * Parse out the thread allocation from the given command-line argument.
+     */
+    private void determineThreadAllocation() {
+        Tags tags = parsingEngine.getTags(argCollection.numberOfThreads);
+        Integer numCPUThreads = tags.containsKey("cpu") ? Integer.parseInt(tags.getValue("cpu")) : null;
+        Integer numIOThreads = tags.containsKey("io") ? Integer.parseInt(tags.getValue("io")) : null;
+        this.threadAllocation = new ThreadAllocation(argCollection.numberOfThreads,numCPUThreads,numIOThreads);
+    }
+
     /**
      * Allow subclasses and others within this package direct access to the walker manager.
      * @return The walker manager used by this package.
@@ -286,7 +305,7 @@ public class GenomeAnalysisEngine {
             throw new UserException.CommandLineException("Read-based traversals require a reference file but none was given");
         }
 
-        return MicroScheduler.create(this,walker,this.getReadsDataSource(),this.getReferenceDataSource().getReference(),this.getRodDataSources(),this.getArguments().numberOfThreads);
+        return MicroScheduler.create(this,walker,this.getReadsDataSource(),this.getReferenceDataSource().getReference(),this.getRodDataSources(),threadAllocation);
     }
 
     protected DownsamplingMethod getDownsamplingMethod() {
@@ -397,103 +416,49 @@ public class GenomeAnalysisEngine {
      * @param intervals intervals
      * @return the sharding strategy
      */
-    protected ShardStrategy getShardStrategy(SAMDataSource readsDataSource, ReferenceSequenceFile drivingDataSource, GenomeLocSortedSet intervals) {
+    protected Iterable<Shard> getShardStrategy(SAMDataSource readsDataSource, ReferenceSequenceFile drivingDataSource, GenomeLocSortedSet intervals) {
         ValidationExclusion exclusions = (readsDataSource != null ? readsDataSource.getReadsInfo().getValidationExclusionList() : null);
         ReferenceDataSource referenceDataSource = this.getReferenceDataSource();
-        // Use monolithic sharding if no index is present.  Monolithic sharding is always required for the original
-        // sharding system; it's required with the new sharding system only for locus walkers.
-        if(readsDataSource != null && !readsDataSource.hasIndex() ) { 
-            if(!exclusions.contains(ValidationExclusion.TYPE.ALLOW_UNINDEXED_BAM))
+
+        // If reads are present, assume that accessing the reads is always the dominant factor and shard based on that supposition.
+        if(!readsDataSource.isEmpty()) {
+            if(!readsDataSource.hasIndex() && !exclusions.contains(ValidationExclusion.TYPE.ALLOW_UNINDEXED_BAM))
                 throw new UserException.CommandLineException("Cannot process the provided BAM file(s) because they were not indexed.  The GATK does offer limited processing of unindexed BAMs in --unsafe mode, but this GATK feature is currently unsupported.");
-            if(intervals != null && !argCollection.allowIntervalsWithUnindexedBAM)
+            if(!readsDataSource.hasIndex() && intervals != null && !argCollection.allowIntervalsWithUnindexedBAM)
                 throw new UserException.CommandLineException("Cannot perform interval processing when reads are present but no index is available.");
 
-            Shard.ShardType shardType;
             if(walker instanceof LocusWalker) {
                 if (readsDataSource.getSortOrder() != SAMFileHeader.SortOrder.coordinate)
                     throw new UserException.MissortedBAM(SAMFileHeader.SortOrder.coordinate, "Locus walkers can only traverse coordinate-sorted data.  Please resort your input BAM file(s) or set the Sort Order tag in the header appropriately.");
-                shardType = Shard.ShardType.LOCUS;
+                if(intervals == null)
+                    return readsDataSource.createShardIteratorOverMappedReads(referenceDataSource.getReference().getSequenceDictionary(),new LocusShardBalancer());
+                else
+                    return readsDataSource.createShardIteratorOverIntervals(intervals,new LocusShardBalancer());
+            }
+            else if(walker instanceof ReadWalker || walker instanceof ReadPairWalker || walker instanceof DuplicateWalker) {
+                // Apply special validation to read pair walkers.
+                if(walker instanceof ReadPairWalker) {
+                    if(readsDataSource.getSortOrder() != SAMFileHeader.SortOrder.queryname)
+                        throw new UserException.MissortedBAM(SAMFileHeader.SortOrder.queryname, "Read pair walkers are exceptions in that they cannot be run on coordinate-sorted BAMs but instead require query name-sorted files.  You will need to resort your input BAM file in query name order to use this walker.");
+                    if(intervals != null && !intervals.isEmpty())
+                        throw new UserException.CommandLineException("Pairs traversal cannot be used in conjunction with intervals.");
+                }
+
+                if(intervals == null)
+                    return readsDataSource.createShardIteratorOverAllReads(new ReadShardBalancer());
+                else
+                    return readsDataSource.createShardIteratorOverIntervals(intervals,new ReadShardBalancer());
             }
-            else if(walker instanceof ReadWalker || walker instanceof DuplicateWalker || walker instanceof ReadPairWalker)
-                shardType = Shard.ShardType.READ;
             else
-                throw new UserException.CommandLineException("The GATK cannot currently process unindexed BAM files");
-
-            List<GenomeLoc> region;
-            if(intervals != null)
-                region = intervals.toList();
-            else {
-                region = new ArrayList<GenomeLoc>();
-                for(SAMSequenceRecord sequenceRecord: drivingDataSource.getSequenceDictionary().getSequences())
-                    region.add(getGenomeLocParser().createGenomeLoc(sequenceRecord.getSequenceName(),1,sequenceRecord.getSequenceLength()));
-            }
-
-            return new MonolithicShardStrategy(getGenomeLocParser(), readsDataSource,shardType,region);
+                throw new ReviewedStingException("Unable to determine walker type for walker " + walker.getClass().getName());
+        }
+        else {
+            final int SHARD_SIZE = walker instanceof RodWalker ? 100000000 : 100000;
+            if(intervals == null)
+                return referenceDataSource.createShardsOverEntireReference(readsDataSource,genomeLocParser,SHARD_SIZE);
+            else
+                return referenceDataSource.createShardsOverIntervals(readsDataSource,intervals,SHARD_SIZE);
         }
-
-        ShardStrategy shardStrategy;
-        ShardStrategyFactory.SHATTER_STRATEGY shardType;
-
-        long SHARD_SIZE = 100000L;
-
-        if (walker instanceof LocusWalker) {
-            if (walker instanceof RodWalker) SHARD_SIZE *= 1000;
-
-            if (intervals != null && !intervals.isEmpty()) {
-                if (readsDataSource == null)
-                    throw new IllegalArgumentException("readsDataSource is null");
-                if(!readsDataSource.isEmpty() && readsDataSource.getSortOrder() != SAMFileHeader.SortOrder.coordinate)
-                    throw new UserException.MissortedBAM(SAMFileHeader.SortOrder.coordinate, "Locus walkers can only traverse coordinate-sorted data.  Please resort your input BAM file(s) or set the Sort Order tag in the header appropriately.");
-
-                shardStrategy = ShardStrategyFactory.shatter(readsDataSource,
-                        referenceDataSource.getReference(),
-                        ShardStrategyFactory.SHATTER_STRATEGY.LOCUS_EXPERIMENTAL,
-                        drivingDataSource.getSequenceDictionary(),
-                        SHARD_SIZE,
-                        getGenomeLocParser(),
-                        intervals);
-            } else
-                shardStrategy = ShardStrategyFactory.shatter(readsDataSource,
-                        referenceDataSource.getReference(),
-                        ShardStrategyFactory.SHATTER_STRATEGY.LOCUS_EXPERIMENTAL,
-                        drivingDataSource.getSequenceDictionary(),
-                        SHARD_SIZE,getGenomeLocParser());
-        } else if (walker instanceof ReadWalker ||
-                walker instanceof DuplicateWalker) {
-            shardType = ShardStrategyFactory.SHATTER_STRATEGY.READS_EXPERIMENTAL;
-
-            if (intervals != null && !intervals.isEmpty()) {
-                shardStrategy = ShardStrategyFactory.shatter(readsDataSource,
-                        referenceDataSource.getReference(),
-                        shardType,
-                        drivingDataSource.getSequenceDictionary(),
-                        SHARD_SIZE,
-                        getGenomeLocParser(),
-                        intervals);
-            } else {
-                shardStrategy = ShardStrategyFactory.shatter(readsDataSource,
-                        referenceDataSource.getReference(),
-                        shardType,
-                        drivingDataSource.getSequenceDictionary(),
-                        SHARD_SIZE,
-                        getGenomeLocParser());
-            }
-        } else if (walker instanceof ReadPairWalker) {
-            if(readsDataSource != null && readsDataSource.getSortOrder() != SAMFileHeader.SortOrder.queryname)
-                throw new UserException.MissortedBAM(SAMFileHeader.SortOrder.queryname, "Read pair walkers are exceptions in that they cannot be run on coordinate-sorted BAMs but instead require query name-sorted files.  You will need to resort your input BAM file in query name order to use this walker.");
-            if(intervals != null && !intervals.isEmpty())
-                throw new UserException.CommandLineException("Pairs traversal cannot be used in conjunction with intervals.");
-
-            shardStrategy = ShardStrategyFactory.shatter(readsDataSource,
-                    referenceDataSource.getReference(),
-                    ShardStrategyFactory.SHATTER_STRATEGY.READS_EXPERIMENTAL,
-                    drivingDataSource.getSequenceDictionary(),
-                    SHARD_SIZE,
-                    getGenomeLocParser());
-        } else
-            throw new ReviewedStingException("Unable to support walker of type" + walker.getClass().getName());
-
-        return shardStrategy;
     }
 
     protected boolean flashbackData() {
@@ -751,6 +716,8 @@ public class GenomeAnalysisEngine {
 
         return new SAMDataSource(
                 samReaderIDs,
+                threadAllocation,
+                argCollection.numberOfBAMFileHandles,
                 genomeLocParser,
                 argCollection.useOriginalBaseQualities,
                 argCollection.strictnessLevel,
@@ -763,8 +730,7 @@ public class GenomeAnalysisEngine {
                 getWalkerBAQApplicationTime() == BAQ.ApplicationTime.ON_INPUT ? argCollection.BAQMode : BAQ.CalculationMode.OFF,
                 getWalkerBAQQualityMode(),
                 refReader,
-                argCollection.defaultBaseQualities,
-                !argCollection.disableLowMemorySharding);
+                argCollection.defaultBaseQualities);
     }
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/gatk/arguments/GATKArgumentCollection.java b/public/java/src/org/broadinstitute/sting/gatk/arguments/GATKArgumentCollection.java
index 8078a1ea4..64b63dcd2 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/arguments/GATKArgumentCollection.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/arguments/GATKArgumentCollection.java
@@ -194,10 +194,14 @@ public class GATKArgumentCollection {
     @Argument(fullName = "unsafe", shortName = "U", doc = "If set, enables unsafe operations: nothing will be checked at runtime.  For expert users only who know what they are doing.  We do not support usage of this argument.", required = false)
     public ValidationExclusion.TYPE unsafe;
 
-    @Argument(fullName = "num_threads", shortName = "nt", doc = "How many threads should be allocated to running this analysis", required = false)
-    public int numberOfThreads = 1;
+    /** How many threads should be allocated to this analysis. */
+    @Argument(fullName = "num_threads", shortName = "nt", doc = "How many threads should be allocated to running this analysis.", required = false)
+    public Integer numberOfThreads = 1;
 
-    @Input(fullName = "read_group_black_list", shortName="rgbl", doc="Filters out read groups matching <TAG>:<STRING> or a .txt file containing the filter strings one per line", required = false)
+    @Argument(fullName = "num_bam_file_handles", shortName = "bfh", doc="The total number of BAM file handles to keep open simultaneously", required=false)
+    public Integer numberOfBAMFileHandles = null;
+
+    @Input(fullName = "read_group_black_list", shortName="rgbl", doc="Filters out read groups matching <TAG>:<STRING> or a .txt file containing the filter strings one per line.", required = false)
     public List<String> readGroupBlackList = null;
 
     // --------------------------------------------------------------------------------------------------------------
@@ -292,9 +296,6 @@ public class GATKArgumentCollection {
     @Hidden
     public boolean allowIntervalsWithUnindexedBAM = false;
 
-    @Argument(fullName="disable_experimental_low_memory_sharding",doc="Disable experimental low-memory sharding functionality",required=false)
-    public boolean disableLowMemorySharding = false;
-
     // --------------------------------------------------------------------------------------------------------------
     //
     // methods
@@ -365,7 +366,11 @@ public class GATKArgumentCollection {
                 (other.downsampleCoverage != null && !other.downsampleCoverage.equals(this.downsampleCoverage))) {
             return false;
         }
-        if (other.numberOfThreads != this.numberOfThreads) {
+        if (!other.numberOfThreads.equals(this.numberOfThreads)) {
+            return false;
+        }
+        if ((other.numberOfBAMFileHandles == null && this.numberOfBAMFileHandles != null) ||
+                (other.numberOfBAMFileHandles != null && !other.numberOfBAMFileHandles.equals(this.numberOfBAMFileHandles))) {
             return false;
         }
         if (other.intervalMerging != this.intervalMerging) {
@@ -389,9 +394,6 @@ public class GATKArgumentCollection {
         if (allowIntervalsWithUnindexedBAM != other.allowIntervalsWithUnindexedBAM)
             return false;
 
-        if (disableLowMemorySharding != other.disableLowMemorySharding)
-            return false;
-
         return true;
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMBlockStartIterator.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMBlockStartIterator.java
deleted file mode 100644
index de938e845..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMBlockStartIterator.java
+++ /dev/null
@@ -1,128 +0,0 @@
-/*
- * Copyright (c) 2011, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import org.broadinstitute.sting.utils.exceptions.StingException;
-
-import java.io.File;
-import java.io.FileInputStream;
-import java.io.IOException;
-import java.nio.ByteBuffer;
-import java.nio.ByteOrder;
-import java.nio.channels.FileChannel;
-import java.util.Iterator;
-
-/**
- * Created by IntelliJ IDEA.
- * User: mhanna
- * Date: Feb 7, 2011
- * Time: 2:46:34 PM
- * To change this template use File | Settings | File Templates.
- */
-public class BAMBlockStartIterator implements Iterator<Long> {
-    /**
-     * How large is a BGZF header?
-     */
-    private static int BGZF_HEADER_SIZE = 18;
-
-    /**
-     * Where within the header does the BLOCKSIZE actually live?
-     */
-    private static int BLOCK_SIZE_HEADER_POSITION = BGZF_HEADER_SIZE - 2;
-
-    private FileChannel bamInputChannel;
-    private ByteBuffer headerByteBuffer;
-
-    private long nextLocation = 0;
-
-    public BAMBlockStartIterator(File bamFile) {
-        try {
-            FileInputStream bamInputStream = new FileInputStream(bamFile);
-            bamInputChannel = bamInputStream.getChannel();
-
-            headerByteBuffer = ByteBuffer.allocate(BGZF_HEADER_SIZE);
-            headerByteBuffer.order(ByteOrder.LITTLE_ENDIAN);
-
-        }
-        catch(IOException ex) {
-            throw new StingException("Could not open file",ex);
-        }
-    }
-
-    public boolean hasNext() {
-        return nextLocation != -1;
-    }
-
-    public Long next() {
-        long currentLocation = nextLocation;
-        advance();
-        return currentLocation;
-    }
-
-    public void remove() {
-        throw new UnsupportedOperationException("Cannot remove from a BAMBlockStartIterator");
-    }
-
-    private void advance() {
-        int readStatus;
-
-        headerByteBuffer.clear();
-        try {
-            readStatus = bamInputChannel.read(headerByteBuffer);
-        }
-        catch(IOException ex) {
-            throw new StingException("Could not read header data",ex);
-        }
-
-        if(readStatus == -1) {
-            nextLocation = -1;
-            try {
-                bamInputChannel.close();
-            }
-            catch(IOException ex) {
-                throw new StingException("Could not close input file",ex);
-            }
-            return;
-        }
-
-        headerByteBuffer.position(BLOCK_SIZE_HEADER_POSITION);
-        int blockSize = headerByteBuffer.getShort();
-
-        try {
-            bamInputChannel.position(bamInputChannel.position()+blockSize-BGZF_HEADER_SIZE+1);
-            nextLocation = bamInputChannel.position();
-        }
-        catch(IOException ex) {
-            throw new StingException("Could not reposition input stream",ex);
-        }
-    }
-
-    public static void main(String argv[]) throws IOException {
-        BAMBlockStartIterator blockStartIterator = new BAMBlockStartIterator(new File("/Users/mhanna/testdata/reads/MV1994.bam"));
-        int i = 0;
-        while(blockStartIterator.hasNext())
-            System.out.printf("%d -> %d%n",i++,blockStartIterator.next());
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMIndexContent.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMIndexContent.java
deleted file mode 100644
index 4d91fb45f..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMIndexContent.java
+++ /dev/null
@@ -1,195 +0,0 @@
-/*
- * Copyright (c) 2011, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import net.sf.samtools.GATKBin;
-import net.sf.samtools.GATKChunk;
-import net.sf.samtools.LinearIndex;
-
-import java.util.*;
-
-/**
- * Represents the contents of a bam index file for one reference.
- * A BAM index (.bai) file contains information for all references in the bam file.
- * This class describes the data present in the index file for one of these references;
- * including the bins, chunks, and linear index.
- */
-class BAMIndexContent {
-    /**
-     * The reference sequence for the data currently loaded.
-     */
-    private final int mReferenceSequence;
-
-    /**
-     * A list of all bins in the above reference sequence.
-     */
-    private final BinList mBinList;
-
-    /**
-     * The linear index for the reference sequence above.
-     */
-    private final LinearIndex mLinearIndex;
-
-
-    /**
-     * @param referenceSequence Content corresponds to this reference.
-     * @param bins              Array of bins represented by this content, possibly sparse
-     * @param numberOfBins      Number of non-null bins
-     * @param linearIndex       Additional index used to optimize queries
-     */
-    BAMIndexContent(final int referenceSequence, final GATKBin[] bins, final int numberOfBins, final LinearIndex linearIndex) {
-        this.mReferenceSequence = referenceSequence;
-        this.mBinList = new BinList(bins, numberOfBins);
-        this.mLinearIndex = linearIndex;
-    }
-
-    /**
-     * Reference for this Content
-     */
-    public int getReferenceSequence() {
-        return mReferenceSequence;
-    }
-
-    /**
-     * Does this content have anything in this bin?
-     */
-    public boolean containsBin(final GATKBin bin) {
-        return mBinList.getBin(bin.getBinNumber()) != null;
-    }
-
-    /**
-     * @return iterable list of bins represented by this content
-     */
-    public BinList getBins() {
-        return mBinList;
-    }
-
-    /**
-     * @return the number of non-null bins represented by this content
-     */
-    int getNumberOfNonNullBins() {
-        return mBinList.getNumberOfNonNullBins();
-    }
-
-    /**
-     * @return all chunks associated with all bins in this content
-     */
-    public List<GATKChunk> getAllChunks() {
-        List<GATKChunk> allChunks = new ArrayList<GATKChunk>();
-        for (GATKBin b : mBinList)
-            if (b.getChunkList() != null) {
-                allChunks.addAll(Arrays.asList(b.getChunkList()));
-            }
-        return Collections.unmodifiableList(allChunks);
-    }
-
-    /**
-     * @return the linear index represented by this content
-     */
-    public LinearIndex getLinearIndex() {
-        return mLinearIndex;
-    }
-
-        /**
-     * This class is used to encapsulate the list of Bins store in the BAMIndexContent
-     * While it is currently represented as an array, we may decide to change it to an ArrayList or other structure
-     */
-    class BinList implements Iterable<GATKBin> {
-
-        private final GATKBin[] mBinArray;
-        public final int numberOfNonNullBins;
-        public final int maxBinNumber;  // invariant: maxBinNumber = mBinArray.length -1 since array is 0 based
-
-        /**
-         * @param binArray            a sparse array representation of the bins. The index into the array is the bin number.
-         * @param numberOfNonNullBins
-         */
-        BinList(GATKBin[] binArray, int numberOfNonNullBins) {
-            this.mBinArray = binArray;
-            this.numberOfNonNullBins = numberOfNonNullBins;
-            this.maxBinNumber = mBinArray.length - 1;
-        }
-
-        GATKBin getBin(int binNumber) {
-            if (binNumber > maxBinNumber) return null;
-            return mBinArray[binNumber];
-        }
-
-        int getNumberOfNonNullBins() {
-            return numberOfNonNullBins;
-        }
-
-        /**
-         * Gets an iterator over all non-null bins.
-         *
-         * @return An iterator over all bins.
-         */
-        public Iterator<GATKBin> iterator() {
-            return new BinIterator();
-        }
-
-        private class BinIterator implements Iterator<GATKBin> {
-            /**
-             * Stores the bin # of the Bin currently in use.
-             */
-            private int nextBin;
-
-            public BinIterator() {
-                nextBin = 0;
-            }
-
-            /**
-             * Are there more bins in this set, waiting to be returned?
-             *
-             * @return True if more bins are remaining.
-             */
-            public boolean hasNext() {
-                while (nextBin <= maxBinNumber) {
-                    if (getBin(nextBin) != null) return true;
-                    nextBin++;
-                }
-                return false;
-            }
-
-            /**
-             * Gets the next bin in the provided BinList.
-             *
-             * @return the next available bin in the BinList.
-             */
-            public GATKBin next() {
-                if (!hasNext())
-                    throw new NoSuchElementException("This BinIterator is currently empty");
-                GATKBin result = getBin(nextBin);
-                nextBin++;
-                return result;
-            }
-
-            public void remove() {
-                throw new UnsupportedOperationException("Unable to remove from a bin iterator");
-            }
-        }
-    }
-
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMOverlap.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMOverlap.java
deleted file mode 100644
index 15a372ca6..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMOverlap.java
+++ /dev/null
@@ -1,29 +0,0 @@
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import net.sf.samtools.Bin;
-
-import java.util.HashMap;
-import java.util.Map;
-
-/**
- * Models a bin at which all BAM files in the merged input stream overlap.
- */
-class BAMOverlap {
-    public final int start;
-    public final int stop;
-
-    private final Map<SAMReaderID,Bin> bins = new HashMap<SAMReaderID,Bin>();
-
-    public BAMOverlap(final int start, final int stop) {
-        this.start = start;
-        this.stop = stop;
-    }
-
-    public void addBin(final SAMReaderID id, final Bin bin) {
-        bins.put(id,bin);
-    }
-
-    public Bin getBin(final SAMReaderID id) {
-        return bins.get(id);
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMSchedule.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMSchedule.java
index 521bcd5a3..762722fcd 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMSchedule.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMSchedule.java
@@ -84,21 +84,21 @@ public class BAMSchedule implements CloseableIterator<BAMScheduleEntry> {
 
     /**
      * Create a new BAM schedule based on the given index.
-     * @param indexFiles Index files.
+     * @param dataSource The SAM data source to use.
      * @param intervals List of 
      */
-    public BAMSchedule(final Map<SAMReaderID,GATKBAMIndex> indexFiles, final List<GenomeLoc> intervals) {
+    public BAMSchedule(final SAMDataSource dataSource, final List<GenomeLoc> intervals) {
         if(intervals.isEmpty())
             throw new ReviewedStingException("Tried to write schedule for empty interval list.");
 
-        referenceSequence = intervals.get(0).getContigIndex();
+        referenceSequence = dataSource.getHeader().getSequence(intervals.get(0).getContig()).getSequenceIndex();
 
         createScheduleFile();
 
-        readerIDs.addAll(indexFiles.keySet());
+        readerIDs.addAll(dataSource.getReaderIDs());
 
         for(final SAMReaderID reader: readerIDs) {
-            final GATKBAMIndex index = indexFiles.get(reader);
+            final GATKBAMIndex index = dataSource.getIndex(reader);
             final GATKBAMIndexData indexData = index.readReferenceSequence(referenceSequence);
 
             int currentBinInLowestLevel = GATKBAMIndex.getFirstBinInLevel(GATKBAMIndex.getNumIndexLevels()-1);
@@ -237,7 +237,10 @@ public class BAMSchedule implements CloseableIterator<BAMScheduleEntry> {
         if(selectedIterators.isEmpty())
             return;
 
+        // Create the target schedule entry
         BAMScheduleEntry mergedScheduleEntry = new BAMScheduleEntry(currentStart,currentStop);
+
+        // For each schedule entry with data, load the data into the merged schedule.
         for (int reader = selectedIterators.nextSetBit(0); reader >= 0; reader = selectedIterators.nextSetBit(reader+1)) {
             PeekableIterator<BAMScheduleEntry> scheduleIterator = scheduleIterators.get(reader);
             BAMScheduleEntry individualScheduleEntry = scheduleIterator.peek();
@@ -248,6 +251,11 @@ public class BAMSchedule implements CloseableIterator<BAMScheduleEntry> {
                 scheduleIterator.next();
         }
 
+        // For each schedule entry without data, add a blank entry.
+        for (int reader = selectedIterators.nextClearBit(0); reader < readerIDs.size(); reader = selectedIterators.nextClearBit(reader+1)) {
+            mergedScheduleEntry.addFileSpan(readerIDs.get(reader),new GATKBAMFileSpan());
+        }
+
         nextScheduleEntry = mergedScheduleEntry;
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMScheduler.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMScheduler.java
index 47eb55b28..dca4cc771 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMScheduler.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BAMScheduler.java
@@ -27,7 +27,12 @@ package org.broadinstitute.sting.gatk.datasources.reads;
 import net.sf.picard.util.PeekableIterator;
 import net.sf.samtools.GATKBAMFileSpan;
 import net.sf.samtools.GATKChunk;
+import net.sf.samtools.SAMFileHeader;
+import net.sf.samtools.SAMFileSpan;
+import net.sf.samtools.SAMSequenceDictionary;
+import net.sf.samtools.SAMSequenceRecord;
 import org.broadinstitute.sting.utils.GenomeLoc;
+import org.broadinstitute.sting.utils.GenomeLocParser;
 import org.broadinstitute.sting.utils.GenomeLocSortedSet;
 
 import java.util.*;
@@ -42,21 +47,86 @@ public class BAMScheduler implements Iterator<FilePointer> {
 
     private FilePointer nextFilePointer = null;
 
-    private final GenomeLocSortedSet loci;
+    private GenomeLocSortedSet loci;
+    private PeekableIterator<GenomeLoc> locusIterator;
+    private GenomeLoc currentLocus;
 
-    private final PeekableIterator<GenomeLoc> locusIterator;
+    public static BAMScheduler createOverMappedReads(final SAMDataSource dataSource, final SAMSequenceDictionary referenceSequenceDictionary, final GenomeLocParser parser) {
+        BAMScheduler scheduler = new BAMScheduler(dataSource);
+        GenomeLocSortedSet intervals = new GenomeLocSortedSet(parser);
+        for(SAMSequenceRecord sequence: referenceSequenceDictionary.getSequences()) {
+            // Match only on sequence name; trust startup validation to make sure all the sequences match.
+            if(dataSource.getHeader().getSequenceDictionary().getSequence(sequence.getSequenceName()) != null)
+                intervals.add(parser.createOverEntireContig(sequence.getSequenceName()));
+        }
+        scheduler.populateFilteredIntervalList(intervals);
+        return scheduler;
+    }
 
-    private GenomeLoc currentLocus;    
+    public static BAMScheduler createOverAllReads(final SAMDataSource dataSource, final GenomeLocParser parser) {
+        BAMScheduler scheduler = new BAMScheduler(dataSource);
+        scheduler.populateUnfilteredIntervalList(parser);
+        return scheduler;
+    }
 
-    public BAMScheduler(final SAMDataSource dataSource, final GenomeLocSortedSet loci) {
+    public static BAMScheduler createOverIntervals(final SAMDataSource dataSource, final GenomeLocSortedSet loci) {
+        BAMScheduler scheduler = new BAMScheduler(dataSource);
+        scheduler.populateFilteredIntervalList(loci);
+        return scheduler;
+    }
+
+
+    private BAMScheduler(final SAMDataSource dataSource) {
         this.dataSource = dataSource;
-        for(SAMReaderID reader: dataSource.getReaderIDs())
-            indexFiles.put(reader,(GATKBAMIndex)dataSource.getIndex(reader));
+        for(SAMReaderID reader: dataSource.getReaderIDs()) {
+            GATKBAMIndex index = dataSource.getIndex(reader);
+            if(index != null)
+                indexFiles.put(reader,dataSource.getIndex(reader));
+        }
+    }
+
+    /**
+     * The consumer has asked for a bounded set of locations.  Prepare an iterator over those locations.
+     * @param loci The list of locations to search and iterate over.
+     */
+    private void populateFilteredIntervalList(final GenomeLocSortedSet loci) {
         this.loci = loci;
-        locusIterator = new PeekableIterator<GenomeLoc>(loci.iterator());
-        if(locusIterator.hasNext())
-            currentLocus = locusIterator.next();
-        advance();
+        if(!indexFiles.isEmpty()) {
+            // If index data is available, start up the iterator.
+            locusIterator = new PeekableIterator<GenomeLoc>(loci.iterator());
+            if(locusIterator.hasNext())
+                currentLocus = locusIterator.next();
+            advance();
+        }
+        else {
+            // Otherwise, seed the iterator with a single file pointer over the entire region.
+            nextFilePointer = generatePointerOverEntireFileset();
+            for(GenomeLoc locus: loci)
+                nextFilePointer.addLocation(locus);
+            locusIterator = new PeekableIterator<GenomeLoc>(Collections.<GenomeLoc>emptyList().iterator());
+        }
+    }
+
+    /**
+     * The consumer has provided null, meaning to iterate over all available data.  Create a file pointer stretching
+     * from just before the start of the region to the end of the region.
+     */
+    private void populateUnfilteredIntervalList(final GenomeLocParser parser) {
+        this.loci = new GenomeLocSortedSet(parser);
+        locusIterator = new PeekableIterator<GenomeLoc>(Collections.<GenomeLoc>emptyList().iterator());
+        nextFilePointer = generatePointerOverEntireFileset();
+    }
+
+    /**
+     * Generate a span that runs from the end of the BAM header to the end of the fle.
+     * @return A file pointer over the specified region.
+     */
+    private FilePointer generatePointerOverEntireFileset() {
+        FilePointer filePointer = new FilePointer();
+        Map<SAMReaderID,GATKBAMFileSpan> currentPosition = dataSource.getCurrentPosition();
+        for(SAMReaderID reader: dataSource.getReaderIDs())
+            filePointer.addFileSpans(reader,createSpanToEndOfFile(currentPosition.get(reader).getGATKChunks().get(0).getChunkStart()));
+        return filePointer;
     }
 
     public boolean hasNext() {
@@ -67,7 +137,9 @@ public class BAMScheduler implements Iterator<FilePointer> {
         if(!hasNext())
             throw new NoSuchElementException("No next element available in interval sharder");
         FilePointer currentFilePointer = nextFilePointer;
+        nextFilePointer = null;
         advance();
+
         return currentFilePointer;
     }
 
@@ -79,13 +151,12 @@ public class BAMScheduler implements Iterator<FilePointer> {
         if(loci.isEmpty())
             return;
 
-        nextFilePointer = null;
         while(nextFilePointer == null && currentLocus != null) {
             // special case handling of the unmapped shard.
             if(currentLocus == GenomeLoc.UNMAPPED) {
                 nextFilePointer = new FilePointer(GenomeLoc.UNMAPPED);
                 for(SAMReaderID id: dataSource.getReaderIDs())
-                    nextFilePointer.addFileSpans(id,new GATKBAMFileSpan(new GATKChunk(indexFiles.get(id).getStartOfLastLinearBin(),Long.MAX_VALUE)));
+                    nextFilePointer.addFileSpans(id,createSpanToEndOfFile(indexFiles.get(id).getStartOfLastLinearBin()));
                 currentLocus = null;
                 continue;
             }
@@ -96,7 +167,7 @@ public class BAMScheduler implements Iterator<FilePointer> {
             int coveredRegionStop = Integer.MAX_VALUE;
             GenomeLoc coveredRegion = null;
 
-            BAMScheduleEntry scheduleEntry = getNextOverlappingBAMScheduleEntry(indexFiles,currentLocus);
+            BAMScheduleEntry scheduleEntry = getNextOverlappingBAMScheduleEntry(currentLocus);
 
             // No overlapping data at all.
             if(scheduleEntry != null) {
@@ -108,7 +179,6 @@ public class BAMScheduler implements Iterator<FilePointer> {
             }
             else {
                 // Always create a file span, whether there was covered data or not.  If there was no covered data, then the binTree is empty.
-                //System.out.printf("Shard: index file = %s; reference sequence = %d; ",index.getIndexFile(),currentLocus.getContigIndex());
                 for(SAMReaderID reader: indexFiles.keySet())
                     nextFilePointer.addFileSpans(reader,new GATKBAMFileSpan());
             }
@@ -116,21 +186,13 @@ public class BAMScheduler implements Iterator<FilePointer> {
             // Early exit if no bins were found.
             if(coveredRegion == null) {
                 // for debugging only: maximum split is 16384.                
-                if(currentLocus.size() > 16384) {
-                    GenomeLoc[] splitContigs = currentLocus.split(currentLocus.getStart()+16384);
-                    nextFilePointer.addLocation(splitContigs[0]);
-                    currentLocus = splitContigs[1];
-                }
-                else {
-                    nextFilePointer.addLocation(currentLocus);
-                    currentLocus = locusIterator.hasNext() ? locusIterator.next() : null;
-                }
+                nextFilePointer.addLocation(currentLocus);
+                currentLocus = locusIterator.hasNext() ? locusIterator.next() : null;
                 continue;
             }
 
             // Early exit if only part of the first interval was found.
             if(currentLocus.startsBefore(coveredRegion)) {
-                // for debugging only: maximum split is 16384.
                 int splitPoint = Math.min(coveredRegion.getStart()-currentLocus.getStart(),16384)+currentLocus.getStart();
                 GenomeLoc[] splitContigs = currentLocus.split(splitPoint);
                 nextFilePointer.addLocation(splitContigs[0]);
@@ -175,25 +237,30 @@ public class BAMScheduler implements Iterator<FilePointer> {
 
     /**
      * Get the next overlapping tree of bins associated with the given BAM file.
-     * @param indices BAM indices.
      * @param currentLocus The actual locus for which to check overlap.
      * @return The next schedule entry overlapping with the given list of loci.
      */
-    private BAMScheduleEntry getNextOverlappingBAMScheduleEntry(final Map<SAMReaderID,GATKBAMIndex> indices, final GenomeLoc currentLocus) {
+    private BAMScheduleEntry getNextOverlappingBAMScheduleEntry(final GenomeLoc currentLocus) {
+        // Make sure that we consult the BAM header to ensure that we're using the correct contig index for this contig name.
+        // This will ensure that if the two sets of contigs don't quite match (b36 male vs female ref, hg19 Epstein-Barr), then
+        // we'll be using the correct contig index for the BAMs.
+        // TODO: Warning: assumes all BAMs use the same sequence dictionary!  Get around this with contig aliasing.
+        final int currentContigIndex = dataSource.getHeader().getSequence(currentLocus.getContig()).getSequenceIndex();
+
         // Stale reference sequence or first invocation.  (Re)create the binTreeIterator.
-        if(lastReferenceSequenceLoaded == null || lastReferenceSequenceLoaded != currentLocus.getContigIndex()) {
+        if(lastReferenceSequenceLoaded == null || lastReferenceSequenceLoaded != currentContigIndex) {
             if(bamScheduleIterator != null)
                 bamScheduleIterator.close();
-            lastReferenceSequenceLoaded = currentLocus.getContigIndex();
+            lastReferenceSequenceLoaded = currentContigIndex;
 
             // Naive algorithm: find all elements in current contig for proper schedule creation.
             List<GenomeLoc> lociInContig = new LinkedList<GenomeLoc>();
             for(GenomeLoc locus: loci) {
-                if(locus.getContigIndex() == lastReferenceSequenceLoaded)
+                if(dataSource.getHeader().getSequence(locus.getContig()).getSequenceIndex() == lastReferenceSequenceLoaded)
                     lociInContig.add(locus);
             }
 
-            bamScheduleIterator = new PeekableIterator<BAMScheduleEntry>(new BAMSchedule(indices,lociInContig));
+            bamScheduleIterator = new PeekableIterator<BAMScheduleEntry>(new BAMSchedule(dataSource,lociInContig));
         }
 
         if(!bamScheduleIterator.hasNext())
@@ -209,4 +276,13 @@ public class BAMScheduler implements Iterator<FilePointer> {
         return (bamScheduleEntry != null && bamScheduleEntry.overlaps(currentLocus)) ? bamScheduleEntry : null;
     }
 
+    /**
+     * Create a span from the given start point to the end of the file.
+     * @param startOfRegion Start of the region, in encoded coordinates (block start << 16 & block offset).
+     * @return A file span from the given point to the end of the file.
+     */
+    private GATKBAMFileSpan createSpanToEndOfFile(final long startOfRegion) {
+      return new GATKBAMFileSpan(new GATKChunk(startOfRegion,Long.MAX_VALUE));
+    }
+
 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BGZFBlockLoadingDispatcher.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BGZFBlockLoadingDispatcher.java
new file mode 100644
index 000000000..f468d2020
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BGZFBlockLoadingDispatcher.java
@@ -0,0 +1,85 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.datasources.reads;
+
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+
+import java.util.LinkedList;
+import java.util.Queue;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+/**
+ * Preloads BGZF blocks in preparation for unzipping and data processing.
+ * TODO: Right now, the block loader has all threads blocked waiting for a work request.  Ultimately this should
+ * TODO: be replaced with a central thread management strategy.
+ */
+public class BGZFBlockLoadingDispatcher {
+    /**
+     * The file handle cache, used when allocating blocks from the dispatcher.
+     */
+    private final FileHandleCache fileHandleCache;
+
+    private final ExecutorService threadPool;
+
+    private final Queue<SAMReaderPosition> inputQueue;
+
+    public BGZFBlockLoadingDispatcher(final int numThreads, final int numFileHandles) {
+        threadPool = Executors.newFixedThreadPool(numThreads);
+        fileHandleCache = new FileHandleCache(numFileHandles);
+        inputQueue = new LinkedList<SAMReaderPosition>();
+
+        threadPool.execute(new BlockLoader(this,fileHandleCache,true));
+    }
+
+    /**
+     * Initiates a request for a new block load.
+      * @param readerPosition Position at which to load.
+     */
+    void queueBlockLoad(final SAMReaderPosition readerPosition) {
+        synchronized(inputQueue) {
+            inputQueue.add(readerPosition);
+            inputQueue.notify();
+        }
+    }
+
+    /**
+     * Claims the next work request from the queue.
+     * @return The next work request, or null if none is available.
+     */
+    SAMReaderPosition claimNextWorkRequest() {
+        synchronized(inputQueue) {
+            while(inputQueue.isEmpty()) {
+                try {
+                    inputQueue.wait();
+                }
+                catch(InterruptedException ex) {
+                    throw new ReviewedStingException("Interrupt occurred waiting for next block reader work item");
+                }
+            }
+            return inputQueue.poll();
+        }
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BlockInputStream.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BlockInputStream.java
new file mode 100644
index 000000000..e377f865d
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BlockInputStream.java
@@ -0,0 +1,436 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.datasources.reads;
+
+import net.sf.samtools.GATKBAMFileSpan;
+import net.sf.samtools.GATKChunk;
+import net.sf.samtools.util.BAMInputStream;
+import net.sf.samtools.util.BlockCompressedFilePointerUtil;
+import net.sf.samtools.util.BlockCompressedInputStream;
+import net.sf.samtools.util.RuntimeEOFException;
+import net.sf.samtools.util.SeekableStream;
+import org.broad.tribble.util.BlockCompressedStreamConstants;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+
+import java.io.IOException;
+import java.nio.ByteBuffer;
+import java.nio.ByteOrder;
+import java.util.Arrays;
+import java.util.LinkedList;
+
+/**
+ * Presents decompressed blocks to the SAMFileReader.
+ */
+public class BlockInputStream extends SeekableStream implements BAMInputStream {
+    /**
+     * Mechanism for triggering block loads.
+     */
+    private final BGZFBlockLoadingDispatcher dispatcher;
+
+    /**
+     * The reader whose data is supplied by this input stream.
+     */
+    private final SAMReaderID reader;
+
+    /**
+     * Length of the input stream.
+     */
+    private final long length;
+
+    /**
+     * The latest error reported by an asynchronous block load.
+     */
+    private Throwable error;
+
+    /**
+     * Current position.
+     */
+    private SAMReaderPosition position;
+
+    /**
+     * A stream of compressed data blocks.
+     */
+    private final ByteBuffer buffer;
+
+    /**
+     * Offsets of the given blocks in the buffer.
+     */
+    private LinkedList<Integer> blockOffsets = new LinkedList<Integer>();
+
+    /**
+     * Source positions of the given blocks in the buffer.
+     */
+    private LinkedList<Long> blockPositions = new LinkedList<Long>();
+
+    /**
+     * Provides a lock to wait for more data to arrive.
+     */
+    private final Object lock = new Object();
+
+    /**
+     * An input stream to use when comparing data back to what it should look like.
+     */
+    private final BlockCompressedInputStream validatingInputStream;
+
+    /**
+     * Has the buffer been filled since last request?
+     */
+    private boolean bufferFilled = false;
+
+    /**
+     * Create a new block presenting input stream with a dedicated buffer.
+     * @param dispatcher the block loading messenger.
+     * @param reader the reader for which to load data.
+     * @param validate validates the contents read into the buffer against the contents of a Picard BlockCompressedInputStream.
+     */
+    BlockInputStream(final BGZFBlockLoadingDispatcher dispatcher, final SAMReaderID reader, final boolean validate) {
+        this.reader = reader;
+        this.length = reader.samFile.length();
+
+        buffer = ByteBuffer.wrap(new byte[64*1024]);
+        buffer.order(ByteOrder.LITTLE_ENDIAN);
+
+        // The state of the buffer assumes that the range of data written into the buffer appears in the range
+        // [position,limit), while extra capacity exists in the range [limit,capacity)
+        buffer.limit(0);
+
+        this.dispatcher = dispatcher;
+        // TODO: Kill the region when all we want to do is start at the beginning of the stream and run to the end of the stream.
+        this.position = new SAMReaderPosition(reader,this,new GATKBAMFileSpan(new GATKChunk(0,Long.MAX_VALUE)));
+
+        try {
+            if(validate) {
+                System.out.printf("BlockInputStream %s: BGZF block validation mode activated%n",this);
+                validatingInputStream = new BlockCompressedInputStream(reader.samFile);
+                // A bug in ValidatingInputStream means that calling getFilePointer() immediately after initialization will result in an NPE.
+                // Poke the stream to start reading data.
+                validatingInputStream.available();
+            }
+            else
+                validatingInputStream = null;
+        }
+        catch(IOException ex) {
+            throw new ReviewedStingException("Unable to validate against Picard input stream",ex);
+        }
+    }
+
+    public long length() {
+        return length;
+    }
+
+    public long getFilePointer() {
+        long filePointer;
+        synchronized(lock) {
+            if(buffer.remaining() > 0) {
+                // If there's data in the buffer, figure out from whence it came.
+                final long blockAddress = blockPositions.size() > 0 ? blockPositions.get(0) : 0;
+                final int blockOffset = buffer.position();
+                filePointer = blockAddress << 16 | blockOffset;
+            }
+            else {
+                // Otherwise, find the next position to load.
+                filePointer = position.getBlockAddress() << 16;
+            }
+        }
+
+        if(validatingInputStream != null && filePointer != validatingInputStream.getFilePointer())
+            throw new ReviewedStingException(String.format("Position of input stream is invalid; expected (block address, block offset) = (%d,%d), got (%d,%d)",
+                    BlockCompressedFilePointerUtil.getBlockAddress(filePointer),BlockCompressedFilePointerUtil.getBlockOffset(filePointer),
+                    BlockCompressedFilePointerUtil.getBlockAddress(validatingInputStream.getFilePointer()),BlockCompressedFilePointerUtil.getBlockOffset(validatingInputStream.getFilePointer())));
+
+        return filePointer;
+    }
+
+    public void seek(long target) {
+        // TODO: Validate the seek point.
+        //System.out.printf("Thread %s, BlockInputStream %s: seeking to block %d, offset %d%n",Thread.currentThread().getId(),this,BlockCompressedFilePointerUtil.getBlockAddress(target),BlockCompressedFilePointerUtil.getBlockOffset(target));
+        synchronized(lock) {
+            clearBuffers();
+            position.advancePosition(BlockCompressedFilePointerUtil.getBlockAddress(target));
+            waitForBufferFill();
+            buffer.position(BlockCompressedFilePointerUtil.getBlockOffset(target));
+
+            if(validatingInputStream != null) {
+                try {
+                    validatingInputStream.seek(target);
+                }
+                catch(IOException ex) {
+                    throw new ReviewedStingException("Unable to validate against Picard input stream",ex);
+                }
+            }
+        }
+    }
+
+    private void clearBuffers() {
+        this.position.reset();
+
+        // Buffer semantics say that outside of a lock, buffer should always be prepared for reading.
+        // Indicate no data to be read.
+        buffer.clear();
+        buffer.limit(0);
+
+        blockOffsets.clear();
+        blockPositions.clear();
+    }
+
+    public boolean eof() {
+        synchronized(lock) {
+            // TODO: Handle multiple empty BGZF blocks at end of the file.
+            return position != null && position.getBlockAddress() >= length;
+        }
+    }
+
+    public void setCheckCrcs(final boolean check) {
+        // TODO: Implement
+    }
+
+    /**
+     * Submits a new access plan for the given dataset.
+     * @param position The next seek point for BAM data in this reader.
+     */
+    public void submitAccessPlan(final SAMReaderPosition position) {
+        //System.out.printf("Thread %s: submitting access plan for block at position: %d%n",Thread.currentThread().getId(),position.getBlockAddress());
+        synchronized(lock) {
+            // Assume that the access plan is going to tell us to start where we are and move forward.
+            // If this isn't the case, we'll soon receive a seek request and the buffer will be forced to reset.
+            if(this.position != null && position.getBlockAddress() < this.position.getBlockAddress())
+                position.advancePosition(this.position.getBlockAddress());
+        }
+        this.position = position;
+    }
+
+    private void compactBuffer() {
+        // Compact buffer to maximize storage space.
+        int bytesToRemove = 0;
+
+        // Look ahead to see if we can compact away the first block in the series.
+        while(blockOffsets.size() > 1 && buffer.position() < blockOffsets.get(1)) {
+            bytesToRemove += blockOffsets.remove();
+            blockPositions.remove();
+        }
+
+        // If we end up with an empty block at the end of the series, compact this as well.
+        if(buffer.remaining() == 0 && !blockOffsets.isEmpty() && buffer.position() >= blockOffsets.peek()) {
+            bytesToRemove += buffer.position();
+            blockOffsets.remove();
+            blockPositions.remove();
+        }
+
+        int finalBufferStart = buffer.position() - bytesToRemove;
+        int finalBufferSize = buffer.remaining();
+
+        buffer.position(bytesToRemove);
+        buffer.compact();
+
+        buffer.position(finalBufferStart);
+        buffer.limit(finalBufferStart+finalBufferSize);
+    }
+
+    /**
+     * Push contents of incomingBuffer into the end of this buffer.
+     * MUST be called from a thread that is NOT the reader thread.
+     * @param incomingBuffer The data being pushed into this input stream.
+     * @param position target position for the data.
+     */
+    public void copyIntoBuffer(final ByteBuffer incomingBuffer, final SAMReaderPosition position, final long filePosition) {
+        synchronized(lock) {
+            try {
+                compactBuffer();
+                // Open up the buffer for more reading.
+                buffer.limit(buffer.capacity());
+
+                // Advance the position to take the most recent read into account.
+                long lastReadPosition = position.getBlockAddress();
+
+                byte[] validBytes = null;
+                if(validatingInputStream != null) {
+                    validBytes = new byte[incomingBuffer.remaining()];
+
+                    byte[] currentBytes = new byte[incomingBuffer.remaining()];
+                    int pos = incomingBuffer.position();
+                    int lim = incomingBuffer.limit();
+                    incomingBuffer.get(currentBytes);
+
+                    incomingBuffer.limit(lim);
+                    incomingBuffer.position(pos);
+
+                    long currentFilePointer = validatingInputStream.getFilePointer();
+                    validatingInputStream.seek(lastReadPosition << 16);
+                    validatingInputStream.read(validBytes);
+                    validatingInputStream.seek(currentFilePointer);
+
+                    if(!Arrays.equals(validBytes,currentBytes))
+                        throw new ReviewedStingException(String.format("Bytes being inserted into BlockInputStream %s are incorrect",this));
+                }
+
+                this.position = position;
+                position.advancePosition(filePosition);
+
+                if(buffer.remaining() < incomingBuffer.remaining()) {
+                    //System.out.printf("Thread %s: waiting for available space in buffer; buffer remaining = %d, incoming buffer remaining = %d%n",Thread.currentThread().getId(),buffer.remaining(),incomingBuffer.remaining());
+                    lock.wait();
+                    //System.out.printf("Thread %s: waited for available space in buffer; buffer remaining = %d, incoming buffer remaining = %d%n", Thread.currentThread().getId(), buffer.remaining(), incomingBuffer.remaining());
+                }
+
+                // Queue list of block offsets / block positions.
+                blockOffsets.add(buffer.position());
+                blockPositions.add(lastReadPosition);
+
+                buffer.put(incomingBuffer);
+
+                // Set up the buffer for reading.
+                buffer.flip();
+                bufferFilled = true;
+
+                lock.notify();
+            }
+            catch(Exception ex) {
+                reportException(ex);
+                lock.notify();
+            }
+        }
+    }
+
+    void reportException(Throwable t) {
+        synchronized(lock) {
+            this.error = t;
+            lock.notify();
+        }
+    }
+
+    private void checkForErrors() {
+        synchronized(lock) {
+            if(error != null) {
+                ReviewedStingException toThrow = new ReviewedStingException(String.format("Thread %s, BlockInputStream %s: Unable to retrieve BAM data from disk",Thread.currentThread().getId(),this),error);
+                toThrow.setStackTrace(error.getStackTrace());
+                throw toThrow;
+            }
+        }
+    }
+
+    /**
+     * Reads the next byte of data from the input stream.
+     * @return Next byte of data, from 0->255, as an int.
+     */
+    @Override
+    public int read() {
+        byte[] singleByte = new byte[1];
+        read(singleByte);
+        return singleByte[0];
+    }
+
+    /**
+     * Fills the given byte array to the extent possible.
+     * @param bytes byte array to be filled.
+     * @return The number of bytes actually read.
+     */
+    @Override
+    public int read(byte[] bytes) {
+        return read(bytes,0,bytes.length);
+    }
+
+    @Override
+    public int read(byte[] bytes, final int offset, final int length) {
+        int remaining = length;
+        synchronized(lock) {
+            while(remaining > 0) {
+                // Check for error conditions during last read.
+                checkForErrors();
+
+                // If completely out of space, queue up another buffer fill.
+                waitForBufferFill();
+
+                // Couldn't manage to load any data at all; abort and return what's available.
+                if(buffer.remaining() == 0)
+                    break;
+
+                int numBytesToCopy = Math.min(buffer.remaining(),remaining);
+                buffer.get(bytes,length-remaining+offset,numBytesToCopy);
+                remaining -= numBytesToCopy;
+
+                //if(remaining > 0)
+                //    System.out.printf("Thread %s: read the first %d bytes of a %d byte request%n",Thread.currentThread().getId(),length-remaining,length);
+                // TODO: Assert that we don't copy across a block boundary
+            }
+
+            // Notify any waiting threads that some of the contents of the buffer were removed.
+            if(length-remaining > 0)
+                lock.notify();
+        }
+
+        if(validatingInputStream != null) {
+            byte[] validBytes = new byte[length];
+            try {
+                validatingInputStream.read(validBytes,offset,length);
+                for(int i = offset; i < offset+length; i++) {
+                    if(bytes[i] != validBytes[i]) {
+                        System.out.printf("Thread %s: preparing to throw an exception because contents don't match%n",Thread.currentThread().getId());
+                        throw new ReviewedStingException(String.format("Thread %s: blockInputStream %s attempting to return wrong set of bytes; mismatch at offset %d",Thread.currentThread().getId(),this,i));
+                    }
+                }
+            }
+            catch(IOException ex) {
+                throw new ReviewedStingException("Unable to validate against Picard input stream",ex);
+            }
+        }
+
+        return length - remaining;
+    }
+
+    public void close() {
+        if(validatingInputStream != null) {
+            try {
+                validatingInputStream.close();
+            }
+            catch(IOException ex) {
+                throw new ReviewedStingException("Unable to validate against Picard input stream",ex);
+            }
+        }
+    }
+
+    public String getSource() {
+        return reader.getSamFilePath();
+    }
+
+    private void waitForBufferFill() {
+        synchronized(lock) {
+            bufferFilled = false;
+            if(buffer.remaining() == 0 && !eof()) {
+                //System.out.printf("Thread %s is waiting for a buffer fill from position %d to buffer %s%n",Thread.currentThread().getId(),position.getBlockAddress(),this);
+                dispatcher.queueBlockLoad(position);
+                try {
+                    lock.wait();
+                }
+                catch(InterruptedException ex) {
+                    // TODO: handle me.
+                    throw new ReviewedStingException("Interrupt occurred waiting for buffer to fill",ex);
+                }
+
+                if(bufferFilled && buffer.remaining() == 0)
+                    throw new RuntimeEOFException("No more data left in InputStream");
+            }
+        }
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BlockLoader.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BlockLoader.java
new file mode 100644
index 000000000..ab4299802
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/BlockLoader.java
@@ -0,0 +1,188 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.datasources.reads;
+
+import org.broad.tribble.util.BlockCompressedStreamConstants;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.nio.ByteBuffer;
+import java.nio.ByteOrder;
+import java.nio.channels.FileChannel;
+import java.util.zip.DataFormatException;
+import java.util.zip.Inflater;
+
+/**
+ * An engine for loading blocks.
+ */
+class BlockLoader implements Runnable {
+    /**
+     * Coordinates the input queue.
+     */
+    private BGZFBlockLoadingDispatcher dispatcher;
+
+    /**
+     * A cache from which to retrieve open file handles.
+     */
+    private final FileHandleCache fileHandleCache;
+
+    /**
+     * Whether asynchronous decompression should happen.
+     */
+    private final boolean decompress;
+
+    /**
+     * An direct input buffer for incoming data from disk.
+     */
+    private final ByteBuffer inputBuffer;
+
+    public BlockLoader(final BGZFBlockLoadingDispatcher dispatcher, final FileHandleCache fileHandleCache, final boolean decompress) {
+        this.dispatcher = dispatcher;
+        this.fileHandleCache = fileHandleCache;
+        this.decompress = decompress;
+
+        this.inputBuffer = ByteBuffer.allocateDirect(64*1024 + BlockCompressedStreamConstants.EMPTY_GZIP_BLOCK.length);
+        inputBuffer.order(ByteOrder.LITTLE_ENDIAN);
+    }
+
+    public void run() {
+        for(;;) {
+            SAMReaderPosition readerPosition = null;
+            try {
+                readerPosition = dispatcher.claimNextWorkRequest();
+                FileInputStream inputStream = fileHandleCache.claimFileInputStream(readerPosition.getReader());
+
+                long blockAddress = readerPosition.getBlockAddress();
+                //System.out.printf("Thread %s: BlockLoader: copying bytes from %s at position %d into %s%n",Thread.currentThread().getId(),inputStream,blockAddress,readerPosition.getInputStream());
+
+                ByteBuffer compressedBlock = readBGZFBlock(inputStream,readerPosition.getBlockAddress());
+                long nextBlockAddress = position(inputStream);
+                fileHandleCache.releaseFileInputStream(readerPosition.getReader(),inputStream);
+
+                ByteBuffer block = decompress ? decompressBGZFBlock(compressedBlock) : compressedBlock;
+                int bytesCopied = block.remaining();
+
+                BlockInputStream bamInputStream = readerPosition.getInputStream();
+                bamInputStream.copyIntoBuffer(block,readerPosition,nextBlockAddress);
+
+                //System.out.printf("Thread %s: BlockLoader: copied %d bytes from %s at position %d into %s%n",Thread.currentThread().getId(),bytesCopied,inputStream,blockAddress,readerPosition.getInputStream());
+            }
+            catch(Throwable error) {
+                if(readerPosition != null && readerPosition.getInputStream() != null)
+                    readerPosition.getInputStream().reportException(error);
+            }
+        }
+
+    }
+
+    private ByteBuffer readBGZFBlock(final FileInputStream inputStream, final long blockAddress) throws IOException {
+        FileChannel channel = inputStream.getChannel();
+
+        // Read the block header
+        channel.position(blockAddress);
+
+        int uncompressedDataSize = 0;
+        int bufferSize = 0;
+
+        do {
+            inputBuffer.clear();
+            inputBuffer.limit(BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH);
+            channel.read(inputBuffer);
+
+            // Read out the size of the full BGZF block into a two bit short container, then 'or' that
+            // value into an int buffer to transfer the bitwise contents into an int.
+            inputBuffer.flip();
+            if(inputBuffer.remaining() != BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH)
+                throw new ReviewedStingException("BUG: unable to read a the complete block header in one pass.");
+
+            // Verify that the file was read at a valid point.
+            if(unpackUByte8(inputBuffer,0) != BlockCompressedStreamConstants.GZIP_ID1 ||
+                    unpackUByte8(inputBuffer,1) != BlockCompressedStreamConstants.GZIP_ID2 ||
+                    unpackUByte8(inputBuffer,3) != BlockCompressedStreamConstants.GZIP_FLG ||
+                    unpackUInt16(inputBuffer,10) != BlockCompressedStreamConstants.GZIP_XLEN ||
+                    unpackUByte8(inputBuffer,12) != BlockCompressedStreamConstants.BGZF_ID1 ||
+                    unpackUByte8(inputBuffer,13) != BlockCompressedStreamConstants.BGZF_ID2) {
+                throw new ReviewedStingException("BUG: Started reading compressed block at incorrect position");
+            }
+
+            inputBuffer.position(BlockCompressedStreamConstants.BLOCK_LENGTH_OFFSET);
+            bufferSize = unpackUInt16(inputBuffer,BlockCompressedStreamConstants.BLOCK_LENGTH_OFFSET)+1;
+
+            // Adjust buffer limits and finish reading the block.  Also read the next header, just in case there's a 0-byte block.
+            inputBuffer.limit(bufferSize);
+            inputBuffer.position(BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH);
+            channel.read(inputBuffer);
+
+            // Check the uncompressed length.  If 0 and not at EOF, we'll want to check the next block.
+            uncompressedDataSize = inputBuffer.getInt(inputBuffer.limit()-4);
+            //System.out.printf("Uncompressed block size of the current block (at position %d) is %d%n",channel.position()-inputBuffer.limit(),uncompressedDataSize);
+        }
+        while(uncompressedDataSize == 0 && channel.position() < channel.size());
+
+        // Prepare the buffer for reading.
+        inputBuffer.flip();
+
+        return inputBuffer;
+    }
+
+    private ByteBuffer decompressBGZFBlock(final ByteBuffer bgzfBlock) throws DataFormatException {
+        final int compressedBufferSize = bgzfBlock.remaining();
+
+        // Determine the uncompressed buffer size (
+        bgzfBlock.position(bgzfBlock.limit()-4);
+        int uncompressedBufferSize = bgzfBlock.getInt();
+        byte[] uncompressedContent = new byte[uncompressedBufferSize];
+
+        // Bound the CDATA section of the buffer.
+        bgzfBlock.limit(compressedBufferSize-BlockCompressedStreamConstants.BLOCK_FOOTER_LENGTH);
+        bgzfBlock.position(BlockCompressedStreamConstants.BLOCK_HEADER_LENGTH);
+        byte[] compressedContent = new byte[bgzfBlock.remaining()];
+        ByteBuffer.wrap(compressedContent).put(bgzfBlock);
+
+        // Decompress the buffer.
+        final Inflater inflater = new Inflater(true);
+        inflater.setInput(compressedContent);
+        int bytesUncompressed = inflater.inflate(uncompressedContent);
+        if(bytesUncompressed != uncompressedBufferSize)
+            throw new ReviewedStingException("Error decompressing block");
+
+        return ByteBuffer.wrap(uncompressedContent);
+    }
+
+    private long position(final FileInputStream inputStream) throws IOException {
+        return inputStream.getChannel().position();
+    }
+
+    private int unpackUByte8(final ByteBuffer buffer,final int position) {
+        return buffer.get(position) & 0xFF;
+    }
+
+    private int unpackUInt16(final ByteBuffer buffer,final int position) {
+        // Read out the size of the full BGZF block into a two bit short container, then 'or' that
+        // value into an int buffer to transfer the bitwise contents into an int.
+        return buffer.getShort(position) & 0xFFFF;
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/FileHandleCache.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/FileHandleCache.java
new file mode 100644
index 000000000..29de6eb37
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/FileHandleCache.java
@@ -0,0 +1,231 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.datasources.reads;
+
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+import org.broadinstitute.sting.utils.exceptions.StingException;
+
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.Map;
+import java.util.Queue;
+
+/**
+ * Caches frequently used  file handles.  Right now, caches only a single file handle.
+ * TODO: Generalize to support arbitrary file handle caches.
+ */
+public class FileHandleCache {
+    /**
+     * The underlying data structure storing file handles.
+     */
+    private final FileHandleStorage fileHandleStorage;
+
+    /**
+     * How many file handles should be kept open at once.
+     */
+    private final int cacheSize;
+
+    /**
+     * A uniquifier: assign a unique ID to every instance of a file handle.
+     */
+    private final Map<SAMReaderID,Integer> keyCounter = new HashMap<SAMReaderID,Integer>();
+
+    /**
+     * A shared lock, private so that outside users cannot notify it.
+     */
+    private final Object lock = new Object();
+
+    /**
+     * Indicates how many file handles are outstanding at this point.
+     */
+    private int numOutstandingFileHandles = 0;
+
+    /**
+     * Create a new file handle cache of the given cache size.
+     * @param cacheSize how many readers to hold open at once.
+     */
+    public FileHandleCache(final int cacheSize) {
+        this.cacheSize = cacheSize;
+        fileHandleStorage = new FileHandleStorage();
+    }
+
+    /**
+     * Retrieves or opens a file handle for the given reader ID.
+     * @param key The ke
+     * @return A file input stream from the cache, if available, or otherwise newly opened.
+     */
+    public FileInputStream claimFileInputStream(final SAMReaderID key) {
+        synchronized(lock) {
+            FileInputStream inputStream = findExistingEntry(key);
+            if(inputStream == null) {
+                try {
+                    // If the cache is maxed out, wait for another file handle to emerge.
+                    if(numOutstandingFileHandles >= cacheSize)
+                        lock.wait();
+                }
+                catch(InterruptedException ex) {
+                    throw new ReviewedStingException("Interrupted while waiting for a file handle");
+                }
+                inputStream = openInputStream(key);
+            }
+            numOutstandingFileHandles++;
+
+            //System.out.printf("Handing input stream %s to thread %s%n",inputStream,Thread.currentThread().getId());
+            return inputStream;
+        }
+    }
+
+    /**
+     * Releases the current reader and returns it to the cache.
+     * @param key The reader.
+     * @param inputStream The stream being used.
+     */
+    public void releaseFileInputStream(final SAMReaderID key, final FileInputStream inputStream) {
+        synchronized(lock) {
+            numOutstandingFileHandles--;
+            UniqueKey newID = allocateKey(key);
+            fileHandleStorage.put(newID,inputStream);
+            // Let any listeners know that another file handle has become available.
+            lock.notify();
+        }
+    }
+
+    /**
+     * Finds an existing entry in the storage mechanism.
+     * @param key Reader.
+     * @return a cached stream, if available.  Otherwise,
+     */
+    private FileInputStream findExistingEntry(final SAMReaderID key) {
+        int existingHandles = getMostRecentUniquifier(key);
+
+        // See if any of the keys currently exist in the repository.
+        for(int i = 0; i <= existingHandles; i++) {
+            UniqueKey uniqueKey = new UniqueKey(key,i);
+            if(fileHandleStorage.containsKey(uniqueKey))
+                return fileHandleStorage.remove(uniqueKey);
+        }
+
+        return null;
+    }
+
+    /**
+     * Gets the most recent uniquifier used for the given reader.
+     * @param reader Reader for which to determine uniqueness.
+     * @return
+     */
+    private int getMostRecentUniquifier(final SAMReaderID reader) {
+        if(keyCounter.containsKey(reader))
+            return keyCounter.get(reader);
+        else return -1;
+    }
+
+    private UniqueKey allocateKey(final SAMReaderID reader) {
+        int uniquifier = getMostRecentUniquifier(reader)+1;
+        keyCounter.put(reader,uniquifier);
+        return new UniqueKey(reader,uniquifier);
+    }
+
+    private FileInputStream openInputStream(final SAMReaderID reader) {
+        try {
+            return new FileInputStream(reader.getSamFilePath());
+        }
+        catch(IOException ex) {
+            throw new StingException("Unable to open input file");
+        }
+    }
+
+    private void closeInputStream(final FileInputStream inputStream) {
+        try {
+            inputStream.close();
+        }
+        catch(IOException ex) {
+            throw new StingException("Unable to open input file");
+        }
+    }
+
+    /**
+     * Actually contains the file handles, purging them as they get too old.
+     */
+    private class FileHandleStorage extends LinkedHashMap<UniqueKey,FileInputStream> {
+        /**
+         * Remove the oldest entry
+         * @param entry Entry to consider removing.
+         * @return True if the cache size has been exceeded.  False otherwise.
+         */
+        @Override
+        protected boolean removeEldestEntry(Map.Entry<UniqueKey,FileInputStream> entry) {
+            synchronized (lock) {
+                if(size() > cacheSize) {
+                    keyCounter.put(entry.getKey().key,keyCounter.get(entry.getKey().key)-1);
+                    closeInputStream(entry.getValue());
+
+                    return true;
+                }
+            }
+            return false;
+        }
+    }
+
+    /**
+     * Uniquifies a key by adding a numerical uniquifier.
+     */
+    private class UniqueKey {
+        /**
+         * The file handle's key.
+         */
+        private final SAMReaderID key;
+
+        /**
+         * A uniquifier, so that multiple of the same reader can exist in the cache.
+         */
+        private final int uniqueID;
+
+        public UniqueKey(final SAMReaderID reader, final int uniqueID) {
+            this.key = reader;
+            this.uniqueID = uniqueID;
+        }
+
+        @Override
+        public boolean equals(Object other) {
+            if(!(other instanceof UniqueKey))
+                return false;
+            UniqueKey otherUniqueKey = (UniqueKey)other;
+            return key.equals(otherUniqueKey.key) && this.uniqueID == otherUniqueKey.uniqueID;
+        }
+
+        @Override
+        public int hashCode() {
+            return key.hashCode();
+        }
+    }
+
+
+
+}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/FilePointer.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/FilePointer.java
index e4141f61c..df7827250 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/FilePointer.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/FilePointer.java
@@ -29,6 +29,7 @@ import net.sf.samtools.GATKBAMFileSpan;
 import net.sf.samtools.SAMFileSpan;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.GenomeLocParser;
+import org.broadinstitute.sting.utils.Utils;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.interval.IntervalMergingRule;
 import org.broadinstitute.sting.utils.interval.IntervalUtils;
@@ -40,28 +41,25 @@ import java.util.*;
  */
 public class FilePointer {
     protected final SortedMap<SAMReaderID,SAMFileSpan> fileSpans = new TreeMap<SAMReaderID,SAMFileSpan>();
-    protected final BAMOverlap overlap;
-    protected final List<GenomeLoc> locations;
+    protected final List<GenomeLoc> locations = new ArrayList<GenomeLoc>();
 
     /**
      * Does this file pointer point into an unmapped region?
      */
     protected final boolean isRegionUnmapped;
 
-    public FilePointer() {
-        this((BAMOverlap)null);
-    }
-
-    public FilePointer(final GenomeLoc location) {
-        this.overlap = null;
-        this.locations = Collections.singletonList(location);
-        this.isRegionUnmapped = GenomeLoc.isUnmapped(location);
-    }
-
-    public FilePointer(final BAMOverlap overlap) {
-        this.overlap = overlap;
-        this.locations = new ArrayList<GenomeLoc>();
-        this.isRegionUnmapped = false;
+    public FilePointer(final GenomeLoc... locations) {
+        this.locations.addAll(Arrays.asList(locations));
+        boolean foundMapped = false, foundUnmapped = false;
+        for(GenomeLoc location: locations) {
+            if(GenomeLoc.isUnmapped(location))
+                foundUnmapped = true;
+            else
+                foundMapped = true;
+        }
+        if(foundMapped && foundUnmapped)
+            throw new ReviewedStingException("BUG: File pointers cannot be mixed mapped/unmapped.");
+        this.isRegionUnmapped = foundUnmapped;
     }
 
     /**
@@ -217,4 +215,20 @@ public class FilePointer {
             fileSpan = fileSpan.union((GATKBAMFileSpan)iterators[i].next().getValue());
         combined.addFileSpans(initialElement.getKey(),fileSpan);
     }
+
+    @Override
+    public String toString() {
+        StringBuilder builder = new StringBuilder();
+        builder.append("FilePointer:%n");
+        builder.append("\tlocations = {");
+        builder.append(Utils.join(";",locations));
+        builder.append("}%n\tregions = %n");
+        for(Map.Entry<SAMReaderID,SAMFileSpan> entry: fileSpans.entrySet()) {
+            builder.append(entry.getKey());
+            builder.append("= {");
+            builder.append(entry.getValue());
+            builder.append("}");
+        }
+        return builder.toString();
+    }
 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/IntervalSharder.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/IntervalSharder.java
index 4ddf28dce..f78693c27 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/IntervalSharder.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/IntervalSharder.java
@@ -25,419 +25,58 @@
 package org.broadinstitute.sting.gatk.datasources.reads;
 
 import net.sf.picard.util.PeekableIterator;
-import net.sf.samtools.AbstractBAMFileIndex;
-import net.sf.samtools.Bin;
-import net.sf.samtools.BrowseableBAMIndex;
-import net.sf.samtools.SAMSequenceRecord;
-import org.apache.log4j.Logger;
-import org.broadinstitute.sting.utils.GenomeLoc;
+import net.sf.samtools.SAMSequenceDictionary;
+import org.broadinstitute.sting.utils.GenomeLocParser;
 import org.broadinstitute.sting.utils.GenomeLocSortedSet;
-import org.broadinstitute.sting.utils.collections.Pair;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 
-import java.util.*;
+import java.util.Iterator;
 
 /**
- * Shard intervals based on position within the BAM file.
- *
- * @author mhanna
- * @version 0.1
+ * Handles the process of aggregating BAM intervals into individual shards.
+ * TODO: The task performed by IntervalSharder is now better performed by LocusShardBalancer.  Merge BAMScheduler and IntervalSharder.
  */
-public class IntervalSharder {
-    private static Logger logger = Logger.getLogger(IntervalSharder.class);
+public class IntervalSharder implements Iterator<FilePointer> {
+    /**
+     * The iterator actually laying out the data for BAM scheduling.
+     */
+    private final PeekableIterator<FilePointer> wrappedIterator;
 
-    public static Iterator<FilePointer> shardIntervals(final SAMDataSource dataSource, final GenomeLocSortedSet loci) {
-        return new IntervalSharder.FilePointerIterator(dataSource,loci);
+    /**
+     * The parser, for interval manipulation.
+     */
+    private final GenomeLocParser parser;
+
+    public static IntervalSharder shardOverAllReads(final SAMDataSource dataSource, final GenomeLocParser parser) {
+        return new IntervalSharder(BAMScheduler.createOverAllReads(dataSource,parser),parser);
+    }
+
+    public static IntervalSharder shardOverMappedReads(final SAMDataSource dataSource, final SAMSequenceDictionary sequenceDictionary, final GenomeLocParser parser) {
+        return new IntervalSharder(BAMScheduler.createOverMappedReads(dataSource,sequenceDictionary,parser),parser);
+    }
+
+    public static IntervalSharder shardOverIntervals(final SAMDataSource dataSource, final GenomeLocSortedSet loci) {
+        return new IntervalSharder(BAMScheduler.createOverIntervals(dataSource,loci),loci.getGenomeLocParser());
+    }
+
+    private IntervalSharder(final BAMScheduler scheduler, final GenomeLocParser parser) {
+        wrappedIterator = new PeekableIterator<FilePointer>(scheduler);
+        this.parser = parser;
+    }
+
+    public boolean hasNext() {
+        return wrappedIterator.hasNext();
     }
 
     /**
-     * A lazy-loading iterator over file pointers.
+     * Accumulate shards where there's no additional cost to processing the next shard in the sequence.
+     * @return The next file pointer to process.
      */
-    private static class FilePointerIterator implements Iterator<FilePointer> {
-        final SAMDataSource dataSource;
-        final GenomeLocSortedSet loci;
-        final PeekableIterator<GenomeLoc> locusIterator;
-        final Queue<FilePointer> cachedFilePointers = new LinkedList<FilePointer>();
-
-        public FilePointerIterator(final SAMDataSource dataSource, final GenomeLocSortedSet loci) {
-            this.dataSource = dataSource;
-            this.loci = loci;
-            locusIterator = new PeekableIterator<GenomeLoc>(loci.iterator());
-            advance();
-        }
-
-        public boolean hasNext() {
-            return !cachedFilePointers.isEmpty();
-        }
-
-        public FilePointer next() {
-            if(!hasNext())
-                throw new NoSuchElementException("FilePointerIterator iteration is complete");
-            FilePointer filePointer = cachedFilePointers.remove();
-            if(cachedFilePointers.isEmpty())
-                advance();
-            return filePointer;
-        }
-
-        public void remove() {
-            throw new UnsupportedOperationException("Cannot remove from a FilePointerIterator");
-        }
-
-        private void advance() {
-            GenomeLocSortedSet nextBatch = new GenomeLocSortedSet(loci.getGenomeLocParser());
-            String contig = null;
-
-            // If the next section of the BAM to be processed is unmapped, handle this region separately.
-            while(locusIterator.hasNext() && nextBatch.isEmpty()) {
-                contig = null;
-                while(locusIterator.hasNext() && (contig == null || (!GenomeLoc.isUnmapped(locusIterator.peek()) && locusIterator.peek().getContig().equals(contig)))) {
-                    GenomeLoc nextLocus = locusIterator.next();
-                    contig = nextLocus.getContig();
-                    nextBatch.add(nextLocus);
-                }
-            }
-
-            if(nextBatch.size() > 0) {
-                cachedFilePointers.addAll(shardIntervalsOnContig(dataSource,contig,nextBatch));
-            }
-        }
+    public FilePointer next() {
+        FilePointer current = wrappedIterator.next();
+        while(wrappedIterator.hasNext() && current.isRegionUnmapped == wrappedIterator.peek().isRegionUnmapped && current.minus(wrappedIterator.peek()) == 0)
+            current = current.combine(parser,wrappedIterator.next());
+        return current;
     }
 
-    /**
-     * Merge / split intervals based on an awareness of the structure of the BAM file.
-     * @param dataSource
-     * @param contig Contig against which to align the intervals.  If null, create a file pointer across unmapped reads.
-     * @param loci
-     * @return
-     */
-    private static List<FilePointer> shardIntervalsOnContig(final SAMDataSource dataSource, final String contig, final GenomeLocSortedSet loci) {
-        // If the contig is null, eliminate the chopping process and build out a file pointer consisting of the unmapped region of all BAMs.
-        if(contig == null) {
-            FilePointer filePointer = new FilePointer(GenomeLoc.UNMAPPED);
-            for(SAMReaderID id: dataSource.getReaderIDs())
-                filePointer.addFileSpans(id,null);
-            return Collections.singletonList(filePointer);
-        }
-
-        // Gather bins for the given loci, splitting loci as necessary so that each falls into exactly one lowest-level bin.
-        List<FilePointer> filePointers = new ArrayList<FilePointer>();
-        FilePointer lastFilePointer = null;
-        BAMOverlap lastBAMOverlap = null;
-
-        Map<SAMReaderID,BrowseableBAMIndex> readerToIndexMap = new HashMap<SAMReaderID,BrowseableBAMIndex>();
-        IntervalSharder.BinMergingIterator binMerger = new IntervalSharder.BinMergingIterator();
-        for(SAMReaderID id: dataSource.getReaderIDs()) {
-            final SAMSequenceRecord referenceSequence = dataSource.getHeader(id).getSequence(contig);
-            // If this contig can't be found in the reference, skip over it.
-            if(referenceSequence == null && contig != null)
-                continue;
-            final BrowseableBAMIndex index = (BrowseableBAMIndex)dataSource.getIndex(id);
-            binMerger.addReader(id,
-                                index,
-                                referenceSequence.getSequenceIndex(),
-                                index.getBinsOverlapping(referenceSequence.getSequenceIndex(),1,referenceSequence.getSequenceLength()).iterator());
-            // Cache the reader for later data lookup.
-            readerToIndexMap.put(id,index);
-        }
-
-        PeekableIterator<BAMOverlap> binIterator = new PeekableIterator<BAMOverlap>(binMerger);
-
-        for(GenomeLoc location: loci) {
-            if(!location.getContig().equals(contig))
-                throw new ReviewedStingException("Location outside bounds of contig");
-
-            if(!binIterator.hasNext())
-                break;
-
-            int locationStart = location.getStart();
-            final int locationStop = location.getStop();
-
-            // Advance to first bin.
-            while(binIterator.peek().stop < locationStart)
-                binIterator.next();
-
-            // Add all relevant bins to a list.  If the given bin extends beyond the end of the current interval, make
-            // sure the extending bin is not pruned from the list.
-            List<BAMOverlap> bamOverlaps = new ArrayList<BAMOverlap>();
-            while(binIterator.hasNext() && binIterator.peek().stop <= locationStop)
-                bamOverlaps.add(binIterator.next());
-            if(binIterator.hasNext() && binIterator.peek().start <= locationStop)
-                bamOverlaps.add(binIterator.peek());
-
-            // Bins found; try to match bins with locations.
-            Iterator<BAMOverlap> bamOverlapIterator = bamOverlaps.iterator();
-
-            while(locationStop >= locationStart) {
-                int binStart = lastFilePointer!=null ? lastFilePointer.overlap.start : 0;
-                int binStop =  lastFilePointer!=null ? lastFilePointer.overlap.stop : 0;
-
-                while(binStop < locationStart && bamOverlapIterator.hasNext()) {
-                    if(lastFilePointer != null && lastFilePointer.locations.size() > 0)
-                        filePointers.add(lastFilePointer);
-
-                    lastBAMOverlap = bamOverlapIterator.next();
-                    lastFilePointer = new FilePointer(lastBAMOverlap);
-                    binStart = lastFilePointer.overlap.start;
-                    binStop = lastFilePointer.overlap.stop;
-                }
-
-                if(locationStart < binStart) {
-                    // The region starts before the first bin in the sequence.  Add the region occurring before the sequence.
-                    if(lastFilePointer != null && lastFilePointer.locations.size() > 0) {
-                        filePointers.add(lastFilePointer);
-                        lastFilePointer = null;
-                        lastBAMOverlap = null;
-                    }
-
-                    final int regionStop = Math.min(locationStop,binStart-1);
-
-                    GenomeLoc subset = loci.getGenomeLocParser().createGenomeLoc(location.getContig(),locationStart,regionStop);
-                    lastFilePointer = new FilePointer(subset);
-
-                    locationStart = regionStop + 1;
-                }
-                else if(locationStart > binStop) {
-                    // The region starts after the last bin in the sequence.  Add the region occurring after the sequence.
-                    if(lastFilePointer != null && lastFilePointer.locations.size() > 0) {
-                        filePointers.add(lastFilePointer);
-                        lastFilePointer = null;
-                        lastBAMOverlap = null;
-                    }
-
-                    GenomeLoc subset = loci.getGenomeLocParser().createGenomeLoc(location.getContig(),locationStart,locationStop);
-                    filePointers.add(new FilePointer(subset));
-
-                    locationStart = locationStop + 1;
-                }
-                else {
-                    if(lastFilePointer == null)
-                        throw new ReviewedStingException("Illegal state: initializer failed to create cached file pointer.");
-
-                    // The start of the region overlaps the bin.  Add the overlapping subset.
-                    final int regionStop = Math.min(locationStop,binStop);
-                    lastFilePointer.addLocation(loci.getGenomeLocParser().createGenomeLoc(location.getContig(),locationStart,regionStop));
-                    locationStart = regionStop + 1;
-                }
-            }
-        }
-
-        if(lastFilePointer != null && lastFilePointer.locations.size() > 0)
-            filePointers.add(lastFilePointer);
-
-        // Lookup the locations for every file pointer in the index.
-        for(SAMReaderID id: readerToIndexMap.keySet()) {
-            BrowseableBAMIndex index = readerToIndexMap.get(id);
-            for(FilePointer filePointer: filePointers)
-                filePointer.addFileSpans(id,index.getSpanOverlapping(filePointer.overlap.getBin(id)));
-        }
-
-        return filePointers;
-    }
-
-    private static class BinMergingIterator implements Iterator<BAMOverlap> {
-        private PriorityQueue<BinQueueState> binQueue = new PriorityQueue<BinQueueState>();
-        private Queue<BAMOverlap> pendingOverlaps = new LinkedList<BAMOverlap>();
-
-        public void addReader(final SAMReaderID id, final BrowseableBAMIndex index, final int referenceSequence, Iterator<Bin> bins) {
-            binQueue.add(new BinQueueState(id,index,referenceSequence,new IntervalSharder.LowestLevelBinFilteringIterator(index,bins)));
-        }
-
-        public boolean hasNext() {
-            return pendingOverlaps.size() > 0 || !binQueue.isEmpty();
-        }
-
-        public BAMOverlap next() {
-            if(!hasNext())
-                throw new NoSuchElementException("No elements left in merging iterator");
-            if(pendingOverlaps.isEmpty())
-                advance();
-            return pendingOverlaps.remove();
-        }
-
-        public void advance() {
-            List<ReaderBin> bins = new ArrayList<ReaderBin>();
-            int boundsStart, boundsStop;
-
-            // Prime the pump
-            if(binQueue.isEmpty())
-                return;
-            bins.add(getNextBin());
-            boundsStart = bins.get(0).getStart();
-            boundsStop  = bins.get(0).getStop();
-
-            // Accumulate all the bins that overlap the current bin, in sorted order.
-            while(!binQueue.isEmpty() && peekNextBin().getStart() <= boundsStop) {
-                ReaderBin bin = getNextBin();
-                bins.add(bin);
-                boundsStart = Math.min(boundsStart,bin.getStart());
-                boundsStop = Math.max(boundsStop,bin.getStop());
-            }
-
-            List<Pair<Integer,Integer>> range = new ArrayList<Pair<Integer,Integer>>();
-            int start = bins.get(0).getStart();
-            int stop = bins.get(0).getStop();
-            while(start <= boundsStop) {
-                // Find the next stopping point.
-                for(ReaderBin bin: bins) {
-                    stop = Math.min(stop,bin.getStop());
-                    if(start < bin.getStart())
-                        stop = Math.min(stop,bin.getStart()-1);
-                }
-
-                range.add(new Pair<Integer,Integer>(start,stop));
-                // If the last entry added included the last element, stop.
-                if(stop >= boundsStop)
-                    break;
-
-                // Find the next start.
-                start = stop + 1;
-                for(ReaderBin bin: bins) {
-                    if(start >= bin.getStart() && start <= bin.getStop())
-                        break;
-                    else if(start < bin.getStart()) {
-                        start = bin.getStart();
-                        break;
-                    }
-                }
-            }
-
-            // Add the next series of BAM overlaps to the window.
-            for(Pair<Integer,Integer> window: range) {
-                BAMOverlap bamOverlap = new BAMOverlap(window.first,window.second);
-                for(ReaderBin bin: bins)
-                    bamOverlap.addBin(bin.id,bin.bin);
-                pendingOverlaps.add(bamOverlap);
-            }
-        }
-
-        public void remove() { throw new UnsupportedOperationException("Cannot remove from a merging iterator."); }
-
-        private ReaderBin peekNextBin() {
-            if(binQueue.isEmpty())
-                throw new NoSuchElementException("No more bins are available");
-            BinQueueState current = binQueue.peek();
-            return new ReaderBin(current.getReaderID(),current.getIndex(),current.getReferenceSequence(),current.peekNextBin());
-        }
-
-        private ReaderBin getNextBin() {
-            if(binQueue.isEmpty())
-                throw new NoSuchElementException("No more bins are available");
-            BinQueueState current = binQueue.remove();
-            ReaderBin readerBin = new ReaderBin(current.getReaderID(),current.getIndex(),current.getReferenceSequence(),current.nextBin());
-            if(current.hasNextBin())
-                binQueue.add(current);
-            return readerBin;
-        }
-
-    }
-
-    /**
-     * Filters out bins not at the lowest level in the tree.
-     */
-    private static class LowestLevelBinFilteringIterator implements Iterator<Bin> {
-        private BrowseableBAMIndex index;
-        private Iterator<Bin> wrappedIterator;
-
-        private Bin nextBin;
-
-        public LowestLevelBinFilteringIterator(final BrowseableBAMIndex index, Iterator<Bin> iterator) {
-            this.index = index;
-            this.wrappedIterator = iterator;
-            advance();
-        }
-
-        public boolean hasNext() {
-            return nextBin != null;
-        }
-
-        public Bin next() {
-            Bin bin = nextBin;
-            advance();
-            return bin;
-        }
-
-        public void remove() { throw new UnsupportedOperationException("Remove operation is not supported"); }
-
-        private void advance() {
-            nextBin = null;
-            while(wrappedIterator.hasNext() && nextBin == null) {
-                Bin bin = wrappedIterator.next();
-                if(index.getLevelForBin(bin) == AbstractBAMFileIndex.getNumIndexLevels()-1)
-                    nextBin = bin;
-            }
-        }
-    }
+    public void remove() { throw new UnsupportedOperationException("Unable to remove from an interval sharder."); }
 }
-
-class BinQueueState implements Comparable<org.broadinstitute.sting.gatk.datasources.reads.BinQueueState> {
-    private final SAMReaderID id;
-    private final BrowseableBAMIndex index;
-    private final int referenceSequence;
-    private final PeekableIterator<Bin> bins;
-
-    private int firstLocusInCurrentBin;
-    private int lastLocusInCurrentBin;
-
-    public BinQueueState(final SAMReaderID id, final BrowseableBAMIndex index, final int referenceSequence, final Iterator<Bin> bins) {
-        this.id = id;
-        this.index = index;
-        this.referenceSequence = referenceSequence;
-        this.bins = new PeekableIterator<Bin>(bins);
-        refreshLocusInBinCache();
-    }
-
-    public SAMReaderID getReaderID() {
-        return id;
-    }
-
-    public BrowseableBAMIndex getIndex() {
-        return index;
-    }
-
-    public int getReferenceSequence() {
-        return referenceSequence;
-    }
-
-    public boolean hasNextBin() {
-        return bins.hasNext();
-    }
-
-    public Bin peekNextBin() {
-        return bins.peek();
-    }
-
-    public Bin nextBin() {
-        Bin nextBin = bins.next();
-        refreshLocusInBinCache();
-        return nextBin;
-    }
-
-    public int compareTo(org.broadinstitute.sting.gatk.datasources.reads.BinQueueState other) {
-        if(!this.bins.hasNext() && !other.bins.hasNext()) return 0;
-        if(!this.bins.hasNext()) return -1;
-        if(!this.bins.hasNext()) return 1;
-
-        // Both BinQueueStates have next bins.  Before proceeding, make sure the bin cache is valid.
-        if(this.firstLocusInCurrentBin <= 0 || this.lastLocusInCurrentBin <= 0 ||
-           other.firstLocusInCurrentBin <= 0 || other.lastLocusInCurrentBin <= 0) {
-            throw new ReviewedStingException("Sharding mechanism error - bin->locus cache is invalid.");
-        }
-
-        // Straight integer subtraction works here because lhsStart, rhsStart always positive.
-        if(this.firstLocusInCurrentBin != other.firstLocusInCurrentBin)
-            return this.firstLocusInCurrentBin - other.firstLocusInCurrentBin;
-
-        // Straight integer subtraction works here because lhsStop, rhsStop always positive.
-        return this.lastLocusInCurrentBin - other.lastLocusInCurrentBin;
-    }
-
-    private void refreshLocusInBinCache() {
-        firstLocusInCurrentBin = -1;
-        lastLocusInCurrentBin = -1;
-        if(bins.hasNext()) {
-            Bin bin = bins.peek();
-            firstLocusInCurrentBin = index.getFirstLocusInBin(bin);
-            lastLocusInCurrentBin = index.getLastLocusInBin(bin);
-        }
-    }
-}
\ No newline at end of file
diff --git a/public/java/src/net/sf/samtools/GATKBinList.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LocusShardBalancer.java
similarity index 52%
rename from public/java/src/net/sf/samtools/GATKBinList.java
rename to public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LocusShardBalancer.java
index b53062aaf..585b63457 100644
--- a/public/java/src/net/sf/samtools/GATKBinList.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LocusShardBalancer.java
@@ -22,30 +22,34 @@
  * OTHER DEALINGS IN THE SOFTWARE.
  */
 
-package net.sf.samtools;
+package org.broadinstitute.sting.gatk.datasources.reads;
 
-import java.util.BitSet;
+import java.util.Iterator;
 
 /**
- * A temporary solution to work around Java access rights issues:
- * override chunk and make it public.
- * TODO: Eliminate once we determine the final fate of the BAM index reading code.
+ * Batch granular file pointers into potentially larger shards.
  */
-public class GATKBinList extends BinList {
+public class LocusShardBalancer extends ShardBalancer {
     /**
-     * Create a new BinList over sequenceCount sequences, consisting of the given bins.
-     * @param referenceSequence Reference sequence to which these bins are relevant.
-     * @param bins The given bins to include.
+     * Convert iterators of file pointers into balanced iterators of shards.
+     * @return An iterator over balanced shards.
      */
-    public GATKBinList(final int referenceSequence, final BitSet bins) {
-        super(referenceSequence,bins);
-    }
+    public Iterator<Shard> iterator() {
+        return new Iterator<Shard>() {
+            public boolean hasNext() {
+                return filePointers.hasNext();
+            }
 
-    /**
-     * Retrieves the bins stored in this list.
-     * @return A bitset where a bin is present in the list if the bit is true.
-     */
-    public BitSet getBins() {
-        return super.getBins();
+            public Shard next() {
+                FilePointer current = filePointers.next();
+                while(filePointers.hasNext() && current.minus(filePointers.peek()) == 0)
+                    current = current.combine(parser,filePointers.next());
+                return new LocusShard(parser,readsDataSource,current.getLocations(),current.fileSpans);
+            }
+
+            public void remove() {
+                throw new UnsupportedOperationException("Unable to remove from shard balancing iterator");
+            }
+        };
     }
 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LocusShardStrategy.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LocusShardStrategy.java
deleted file mode 100755
index a5ca07853..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LocusShardStrategy.java
+++ /dev/null
@@ -1,178 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import net.sf.picard.reference.IndexedFastaSequenceFile;
-import net.sf.samtools.SAMFileHeader;
-import net.sf.samtools.SAMFileSpan;
-import net.sf.samtools.SAMSequenceRecord;
-import org.broadinstitute.sting.utils.GenomeLoc;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-import org.broadinstitute.sting.utils.GenomeLocSortedSet;
-
-import java.util.ArrayList;
-import java.util.Iterator;
-import java.util.List;
-import java.util.Map;
-
-/**
- * A sharding strategy for loci based on reading of the index.
- */
-public class LocusShardStrategy implements ShardStrategy {
-    /**
-     * The data source to use when performing this sharding.
-     */
-    private final SAMDataSource reads;
-
-    /**
-     * the parser for creating shards
-     */
-    private GenomeLocParser genomeLocParser;
-
-    /**
-     * An iterator through the available file pointers.
-     */
-    private final Iterator<FilePointer> filePointerIterator;
-
-    /**
-     * construct the shard strategy from a seq dictionary, a shard size, and and genomeLocs
-     * @param reads Data source from which to load index data.
-     * @param locations List of locations for which to load data.
-     */
-    public LocusShardStrategy(SAMDataSource reads, IndexedFastaSequenceFile reference, GenomeLocParser genomeLocParser, GenomeLocSortedSet locations) {
-        this.reads = reads;
-        this.genomeLocParser = genomeLocParser;
-
-        if(!reads.isEmpty()) {
-            GenomeLocSortedSet intervals;
-            if(locations == null) {
-                // If no locations were passed in, shard the entire BAM file.
-                SAMFileHeader header = reads.getHeader();
-                intervals = new GenomeLocSortedSet(genomeLocParser);
-
-                for(SAMSequenceRecord readsSequenceRecord: header.getSequenceDictionary().getSequences()) {
-                    // Check this sequence against the reference sequence dictionary.
-                    // TODO: Do a better job of merging reads + reference.
-                    SAMSequenceRecord refSequenceRecord = reference.getSequenceDictionary().getSequence(readsSequenceRecord.getSequenceName());
-                    if(refSequenceRecord != null) {
-                        final int length = Math.min(readsSequenceRecord.getSequenceLength(),refSequenceRecord.getSequenceLength());
-                        intervals.add(genomeLocParser.createGenomeLoc(readsSequenceRecord.getSequenceName(),1,length));
-                    }
-                }
-            }
-            else
-                intervals = locations;
-
-            if(reads.isLowMemoryShardingEnabled()) {
-                /*
-                Iterator<FilePointer> filePointerIterator = new LowMemoryIntervalSharder(this.reads,intervals);
-                List<FilePointer> filePointers = new ArrayList<FilePointer>();
-                while(filePointerIterator.hasNext())
-                    filePointers.add(filePointerIterator.next());
-                this.filePointerIterator = filePointers.iterator();
-                */
-                this.filePointerIterator = new LowMemoryIntervalSharder(this.reads,intervals);
-            }
-            else
-                this.filePointerIterator = IntervalSharder.shardIntervals(this.reads,intervals);
-        }
-        else {
-            final int maxShardSize = 100000;
-            List<FilePointer> filePointers = new ArrayList<FilePointer>();
-            if(locations == null) {
-                for(SAMSequenceRecord refSequenceRecord: reference.getSequenceDictionary().getSequences()) {
-                    for(int shardStart = 1; shardStart <= refSequenceRecord.getSequenceLength(); shardStart += maxShardSize) {
-                        final int shardStop = Math.min(shardStart+maxShardSize-1, refSequenceRecord.getSequenceLength());
-                        filePointers.add(new FilePointer(genomeLocParser.createGenomeLoc(refSequenceRecord.getSequenceName(),shardStart,shardStop)));
-                    }
-                }
-            }
-            else {
-                for(GenomeLoc interval: locations) {
-                    while(interval.size() > maxShardSize) {
-                        filePointers.add(new FilePointer(locations.getGenomeLocParser().createGenomeLoc(interval.getContig(),interval.getStart(),interval.getStart()+maxShardSize-1)));
-                        interval = locations.getGenomeLocParser().createGenomeLoc(interval.getContig(),interval.getStart()+maxShardSize,interval.getStop());
-                    }
-                    filePointers.add(new FilePointer(interval));
-                }
-            }
-            filePointerIterator = filePointers.iterator();
-        }
-
-    }
-
-    /**
-     * returns true if there are additional shards
-     *
-     * @return false if we're done processing shards
-     */
-    public boolean hasNext() {
-        return filePointerIterator.hasNext();
-    }
-
-    public long shardNumber = 0;
-
-    /**
-     * gets the next Shard
-     *
-     * @return the next shard
-     */
-    public LocusShard next() {
-        FilePointer nextFilePointer = filePointerIterator.next();
-        Map<SAMReaderID,SAMFileSpan> fileSpansBounding = nextFilePointer.fileSpans != null ? nextFilePointer.fileSpans : null;
-
-        /*
-        System.out.printf("Shard %d: interval = {",++shardNumber);
-        for(GenomeLoc locus: nextFilePointer.locations)
-            System.out.printf("%s;",locus);
-        System.out.printf("}; ");
-
-        if(fileSpansBounding == null)
-            System.out.printf("no shard data%n");
-        else {
-            SortedMap<SAMReaderID,SAMFileSpan> sortedSpans = new TreeMap<SAMReaderID,SAMFileSpan>(fileSpansBounding);
-            for(Map.Entry<SAMReaderID,SAMFileSpan> entry: sortedSpans.entrySet()) {
-                System.out.printf("Shard %d:%s = {%s}%n",shardNumber,entry.getKey().samFile,entry.getValue());
-            }
-        }
-        */
-
-        return new LocusShard(genomeLocParser, reads,nextFilePointer.locations,fileSpansBounding);
-    }
-
-    /** we don't support the remove command */
-    public void remove() {
-        throw new UnsupportedOperationException("ShardStrategies don't support remove()");
-    }
-
-    /**
-     * makes the IntervalShard iterable, i.e. usable in a for loop.
-     *
-     * @return
-     */
-    public Iterator<Shard> iterator() {
-        return this;
-    }
-}
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LowMemoryIntervalSharder.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LowMemoryIntervalSharder.java
deleted file mode 100644
index bf5f33dc3..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/LowMemoryIntervalSharder.java
+++ /dev/null
@@ -1,68 +0,0 @@
-/*
- * Copyright (c) 2011, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import net.sf.picard.util.PeekableIterator;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-import org.broadinstitute.sting.utils.GenomeLocSortedSet;
-
-import java.util.Iterator;
-
-/**
- * Handles the process of aggregating BAM intervals into individual shards.
- */
-public class LowMemoryIntervalSharder implements Iterator<FilePointer> {
-    /**
-     * The iterator actually laying out the data for BAM scheduling.
-     */
-    private final PeekableIterator<FilePointer> wrappedIterator;
-
-    /**
-     * The parser, for interval manipulation.
-     */
-    private final GenomeLocParser parser;
-
-    public LowMemoryIntervalSharder(final SAMDataSource dataSource, final GenomeLocSortedSet loci) {
-        wrappedIterator = new PeekableIterator<FilePointer>(new BAMScheduler(dataSource,loci));
-        parser = loci.getGenomeLocParser();
-    }
-
-    public boolean hasNext() {
-        return wrappedIterator.hasNext();
-    }
-
-    /**
-     * Accumulate shards where there's no additional cost to processing the next shard in the sequence.
-     * @return The next file pointer to process.
-     */
-    public FilePointer next() {
-        FilePointer current = wrappedIterator.next();
-        while(wrappedIterator.hasNext() && current.isRegionUnmapped == wrappedIterator.peek().isRegionUnmapped && current.minus(wrappedIterator.peek()) == 0)
-            current = current.combine(parser,wrappedIterator.next());
-        return current;
-    }
-
-    public void remove() { throw new UnsupportedOperationException("Unable to remove from an interval sharder."); }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/MonolithicShard.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/MonolithicShard.java
deleted file mode 100644
index 278eeb898..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/MonolithicShard.java
+++ /dev/null
@@ -1,34 +0,0 @@
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import org.broadinstitute.sting.utils.GenomeLoc;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-
-import java.util.List;
-
-/**
- * A single, monolithic shard bridging all available data.
- * @author mhanna
- * @version 0.1
- */
-public class MonolithicShard extends Shard {
-    /**
-     * Creates a new monolithic shard of the given type.
-     * @param shardType Type of the shard.  Must be either read or locus; cannot be intervalic.
-     * @param locs Intervals that this monolithic shard should process. 
-     */
-    public MonolithicShard(GenomeLocParser parser, SAMDataSource readsDataSource, ShardType shardType, List<GenomeLoc> locs) {
-        super(parser, shardType, locs, readsDataSource, null, false);
-        if(shardType != ShardType.LOCUS && shardType != ShardType.READ)
-            throw new ReviewedStingException("Invalid shard type for monolithic shard: " + shardType);
-    }
-
-    /**
-     * String representation of this shard.
-     * @return "entire genome".
-     */
-    @Override
-    public String toString() {
-        return "entire genome";    
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/MonolithicShardStrategy.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/MonolithicShardStrategy.java
deleted file mode 100644
index 28b737f28..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/MonolithicShardStrategy.java
+++ /dev/null
@@ -1,77 +0,0 @@
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import org.broadinstitute.sting.utils.GenomeLoc;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-
-import java.util.Iterator;
-import java.util.List;
-import java.util.NoSuchElementException;
-
-/**
- * Create a giant shard representing all the data in the input BAM(s).
- *
- * @author mhanna
- * @version 0.1
- */
-public class MonolithicShardStrategy implements ShardStrategy {
-    /**
-     * The single shard associated with this sharding strategy.
-     */
-    private MonolithicShard shard;
-
-    /**
-     * Create a new shard strategy for shards of the given type.
-     * @param shardType The shard type.
-     */
-    public MonolithicShardStrategy(final GenomeLocParser parser, final SAMDataSource readsDataSource, final Shard.ShardType shardType, final List<GenomeLoc> region) {
-        shard = new MonolithicShard(parser,readsDataSource,shardType,region);
-    }
-
-    /**
-     * Convenience for using in a foreach loop.  Will NOT create a new, reset instance of the iterator;
-     * will only return another copy of the active iterator. 
-     * @return A copy of this.
-     */
-    public Iterator<Shard> iterator() {
-        return this;
-    }
-
-    /**
-     * Returns true if the monolithic shard has not yet been consumed, or false otherwise.
-     * @return True if shard has been consumed, false otherwise.
-     */
-    public boolean hasNext() {
-        return shard != null;
-    }
-
-    /**
-     * Returns the monolithic shard if it has not already been retrieved.
-     * @return The monolithic shard.
-     * @throws NoSuchElementException if no such data exists.
-     */
-    public Shard next() {
-        if(shard == null)
-            throw new NoSuchElementException("Monolithic shard has already been retrived.");
-
-        Shard working = shard;
-        shard = null;
-        return working;
-    }
-
-    /**
-     * Mandated by the interface, but is unsupported in this context.  Will throw an exception always.
-     */
-    public void remove() {
-        throw new UnsupportedOperationException("Cannot remove from a shard strategy");
-    }
-
-    /**
-     * Mandated by the interface, but is unsupported in this context.  Will throw an exception always.
-     * @param size adjust the next size to this
-     */
-    public void adjustNextShardSize( long size ) {
-        throw new UnsupportedOperationException("Cannot adjust the next size of a monolithic shard; there will be no next shard.");
-    }
-
-}
-
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShard.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShard.java
index 4d9c9092d..5f40c0ea5 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShard.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShard.java
@@ -35,10 +35,15 @@ import java.util.Map;
  * @version 0.1
  */
 public class ReadShard extends Shard {
+    /**
+     * What is the maximum number of reads which should go into a read shard.
+     */
+    public static final int MAX_READS = 10000;
+
     /**
      * The reads making up this shard.
      */
-    private final Collection<SAMRecord> reads = new ArrayList<SAMRecord>(ReadShardStrategy.MAX_READS);
+    private final Collection<SAMRecord> reads = new ArrayList<SAMRecord>(MAX_READS);
 
     public ReadShard(GenomeLocParser parser, SAMDataSource readsDataSource, Map<SAMReaderID,SAMFileSpan> fileSpans, List<GenomeLoc> loci, boolean isUnmapped) {
         super(parser, ShardType.READ, loci, readsDataSource, fileSpans, isUnmapped);
@@ -66,7 +71,7 @@ public class ReadShard extends Shard {
      * @return True if this shard's buffer is full (and the shard can buffer reads).
      */
     public boolean isBufferFull() {
-        return reads.size() > ReadShardStrategy.MAX_READS;
+        return reads.size() > ReadShard.MAX_READS;
     }
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShardBalancer.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShardBalancer.java
new file mode 100644
index 000000000..fa8a7d454
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShardBalancer.java
@@ -0,0 +1,115 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.datasources.reads;
+
+import net.sf.samtools.GATKBAMFileSpan;
+import net.sf.samtools.SAMFileSpan;
+
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.Map;
+import java.util.NoSuchElementException;
+
+/**
+ * Divide up large file pointers containing reads into more manageable subcomponents.
+ */
+public class ReadShardBalancer extends ShardBalancer {
+    /**
+     * Convert iterators of file pointers into balanced iterators of shards.
+     * @return An iterator over balanced shards.
+     */
+    public Iterator<Shard> iterator() {
+        return new Iterator<Shard>() {
+            /**
+             * The cached shard to be returned next.  Prefetched in the peekable iterator style.
+             */
+            private Shard nextShard = null;
+
+            /**
+             * The file pointer currently being processed.
+             */
+            private FilePointer currentFilePointer;
+
+            /**
+             * Ending position of the last shard in the file.
+             */
+            private Map<SAMReaderID,GATKBAMFileSpan> position = readsDataSource.getCurrentPosition();
+
+            {
+                if(filePointers.hasNext())
+                    currentFilePointer = filePointers.next();
+                advance();
+            }
+
+            public boolean hasNext() {
+                return nextShard != null;
+            }
+
+            public Shard next() {
+                if(!hasNext())
+                    throw new NoSuchElementException("No next read shard available");
+                Shard currentShard = nextShard;
+                advance();
+                return currentShard;
+            }
+
+            public void remove() {
+                throw new UnsupportedOperationException("Unable to remove from shard balancing iterator");
+            }
+
+            private void advance() {
+                Map<SAMReaderID,SAMFileSpan> shardPosition;
+                nextShard = null;
+
+                Map<SAMReaderID,SAMFileSpan> selectedReaders = new HashMap<SAMReaderID,SAMFileSpan>();
+                while(selectedReaders.size() == 0 && currentFilePointer != null) {
+                    shardPosition = currentFilePointer.fileSpans;
+
+                    for(SAMReaderID id: shardPosition.keySet()) {
+                        SAMFileSpan fileSpan = new GATKBAMFileSpan(shardPosition.get(id).removeContentsBefore(position.get(id)));
+                        if(!fileSpan.isEmpty())
+                            selectedReaders.put(id,fileSpan);
+                    }
+
+                    if(selectedReaders.size() > 0) {
+                        Shard shard = new ReadShard(parser,readsDataSource,selectedReaders,currentFilePointer.locations,currentFilePointer.isRegionUnmapped);
+                        readsDataSource.fillShard(shard);
+
+                        if(!shard.isBufferEmpty()) {
+                            nextShard = shard;
+                            break;
+                        }
+                    }
+
+                    selectedReaders.clear();
+                    currentFilePointer = filePointers.hasNext() ? filePointers.next() : null;
+                }
+
+                position = readsDataSource.getCurrentPosition();
+            }
+        };
+    }
+
+}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShardStrategy.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShardStrategy.java
deleted file mode 100755
index 5ea75dbb0..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReadShardStrategy.java
+++ /dev/null
@@ -1,183 +0,0 @@
-/*
- * Copyright (c) 2010, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import net.sf.samtools.SAMFileSpan;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-import org.broadinstitute.sting.utils.GenomeLocSortedSet;
-
-import java.util.*;
-
-/**
- * The sharding strategy for reads using a simple counting mechanism.  Each read shard
- * has a specific number of reads (default to 10K) which is configured in the constructor.
- * @author aaron
- * @version 1.0
- * @date Apr 14, 2009
- */
-public class ReadShardStrategy implements ShardStrategy {
-    /**
-     * What is the maximum number of reads which should go into a read shard.
-     */
-    protected static final int MAX_READS = 10000;
-
-    /**
-     * The data source used to shard.
-     */
-    private final SAMDataSource dataSource;
-
-    /**
-     * The intervals to be processed.
-     */
-    private final GenomeLocSortedSet locations;
-
-    /**
-     * The cached shard to be returned next.  Prefetched in the peekable iterator style.
-     */
-    private Shard nextShard = null;
-
-    /** our storage of the genomic locations they'd like to shard over */
-    private final List<FilePointer> filePointers = new ArrayList<FilePointer>();
-
-    /**
-     * Iterator over the list of file pointers.
-     */
-    private final Iterator<FilePointer> filePointerIterator;
-
-    /**
-     * The file pointer currently being processed.
-     */
-    private FilePointer currentFilePointer;
-
-    /**
-     * Ending position of the last shard in the file.
-     */
-    private Map<SAMReaderID,SAMFileSpan> position;
-
-    /**
-     * An indicator whether the strategy has sharded into the unmapped region.
-     */
-    private boolean isIntoUnmappedRegion = false;
-
-    private final GenomeLocParser parser;
-
-    /**
-     * Create a new read shard strategy, loading read shards from the given BAM file.
-     * @param dataSource Data source from which to load shards.
-     * @param locations intervals to use for sharding.
-     */
-    public ReadShardStrategy(GenomeLocParser parser, SAMDataSource dataSource, GenomeLocSortedSet locations) {
-        this.dataSource = dataSource;
-        this.parser = parser;
-        this.position = this.dataSource.getCurrentPosition();
-        this.locations = locations;
-
-        if(locations != null)
-            filePointerIterator = dataSource.isLowMemoryShardingEnabled() ? new LowMemoryIntervalSharder(this.dataSource,locations) : IntervalSharder.shardIntervals(this.dataSource,locations);
-        else
-            filePointerIterator = filePointers.iterator();
-
-        if(filePointerIterator.hasNext())
-            currentFilePointer = filePointerIterator.next();
-
-        advance();
-    }
-
-    /**
-     * do we have another read shard?
-     * @return True if any more data is available.  False otherwise.
-     */
-    public boolean hasNext() {
-        return nextShard != null;
-    }
-
-    /**
-     * Retrieves the next shard, if available.
-     * @return The next shard, if available.
-     * @throws java.util.NoSuchElementException if no such shard is available.
-     */
-    public Shard next() {
-        if(!hasNext())
-            throw new NoSuchElementException("No next read shard available");
-        Shard currentShard = nextShard;
-        advance();
-        return currentShard;
-    }
-
-    public void advance() {
-        Map<SAMReaderID,SAMFileSpan> shardPosition = new HashMap<SAMReaderID,SAMFileSpan>();
-        nextShard = null;
-
-        if(locations != null) {
-            Map<SAMReaderID,SAMFileSpan> selectedReaders = new HashMap<SAMReaderID,SAMFileSpan>();
-            while(selectedReaders.size() == 0 && currentFilePointer != null) {
-                shardPosition = currentFilePointer.fileSpans;
-
-                for(SAMReaderID id: shardPosition.keySet()) {
-                    SAMFileSpan fileSpan = shardPosition.get(id).removeContentsBefore(position.get(id));
-                    if(!fileSpan.isEmpty())
-                        selectedReaders.put(id,fileSpan);
-                }
-
-                if(selectedReaders.size() > 0) {
-                    Shard shard = new ReadShard(parser, dataSource,selectedReaders,currentFilePointer.locations,currentFilePointer.isRegionUnmapped);
-                    dataSource.fillShard(shard);
-
-                    if(!shard.isBufferEmpty()) {
-                        nextShard = shard;
-                        break;
-                    }
-                }
-
-                selectedReaders.clear();
-                currentFilePointer = filePointerIterator.hasNext() ? filePointerIterator.next() : null;
-            }
-        }
-        else {
-            // todo -- this nulling of intervals is a bit annoying since readwalkers without
-            // todo -- any -L values need to be special cased throughout the code.
-            Shard shard = new ReadShard(parser,dataSource,position,null,false);
-            dataSource.fillShard(shard);
-            nextShard = !shard.isBufferEmpty() ? shard : null;
-        }
-
-        this.position = dataSource.getCurrentPosition();
-    }
-
-    /**
-     * @throws UnsupportedOperationException always.
-     */
-    public void remove() {
-        throw new UnsupportedOperationException("Remove not supported");
-    }
-
-    /**
-     * Convenience method for using ShardStrategy in an foreach loop.
-     * @return A iterator over shards.
-     */
-    public Iterator<Shard> iterator() {
-        return this;
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReaderBin.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReaderBin.java
deleted file mode 100644
index c76c1d8ae..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ReaderBin.java
+++ /dev/null
@@ -1,33 +0,0 @@
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import net.sf.samtools.Bin;
-import net.sf.samtools.BrowseableBAMIndex;
-
-/**
- * Created by IntelliJ IDEA.
- * User: mhanna
- * Date: Feb 2, 2011
- * Time: 4:36:40 PM
- * To change this template use File | Settings | File Templates.
- */
-class ReaderBin {
-    public final SAMReaderID id;
-    public final BrowseableBAMIndex index;
-    public final int referenceSequence;
-    public final Bin bin;
-
-    public ReaderBin(final SAMReaderID id, final BrowseableBAMIndex index, final int referenceSequence, final Bin bin) {
-        this.id = id;
-        this.index = index;
-        this.referenceSequence = referenceSequence;
-        this.bin = bin;
-    }
-
-    public int getStart() {
-        return index.getFirstLocusInBin(bin);
-    }
-
-    public int getStop() {
-        return index.getLastLocusInBin(bin);
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/SAMDataSource.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/SAMDataSource.java
index 8452aadfd..0a1eb0563 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/SAMDataSource.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/SAMDataSource.java
@@ -37,8 +37,10 @@ import org.broadinstitute.sting.gatk.arguments.ValidationExclusion;
 import org.broadinstitute.sting.gatk.filters.CountingFilteringIterator;
 import org.broadinstitute.sting.gatk.filters.ReadFilter;
 import org.broadinstitute.sting.gatk.iterators.*;
+import org.broadinstitute.sting.gatk.resourcemanagement.ThreadAllocation;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.GenomeLocParser;
+import org.broadinstitute.sting.utils.GenomeLocSortedSet;
 import org.broadinstitute.sting.utils.baq.BAQ;
 import org.broadinstitute.sting.utils.baq.BAQSamIterator;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
@@ -71,7 +73,7 @@ public class SAMDataSource {
     /**
      * Tools for parsing GenomeLocs, for verifying BAM ordering against general ordering.
      */
-    private final GenomeLocParser genomeLocParser;
+    protected final GenomeLocParser genomeLocParser;
 
     /**
      * Identifiers for the readers driving this data source.
@@ -91,13 +93,18 @@ public class SAMDataSource {
     /**
      * How far along is each reader?
      */
-    private final Map<SAMReaderID, SAMFileSpan> readerPositions = new HashMap<SAMReaderID,SAMFileSpan>();
+    private final Map<SAMReaderID,GATKBAMFileSpan> readerPositions = new HashMap<SAMReaderID,GATKBAMFileSpan>();
 
     /**
      * The merged header.
      */
     private final SAMFileHeader mergedHeader;
 
+    /**
+     * The constituent headers of the unmerged files.
+     */
+    private final Map<SAMReaderID,SAMFileHeader> headers = new HashMap<SAMReaderID,SAMFileHeader>();
+
     /**
      * The sort order of the BAM files.  Files without a sort order tag are assumed to be
      * in coordinate order.
@@ -131,17 +138,24 @@ public class SAMDataSource {
     private final SAMResourcePool resourcePool;
 
     /**
-     * Whether to enable the new low-memory sharding mechanism.
+     * Asynchronously loads BGZF blocks.
      */
-    private boolean enableLowMemorySharding = false;
+    private final BGZFBlockLoadingDispatcher dispatcher;
+
+    /**
+     * How are threads allocated.
+     */
+    private final ThreadAllocation threadAllocation;
 
     /**
      * Create a new SAM data source given the supplied read metadata.
      * @param samFiles list of reads files.
      */
-    public SAMDataSource(Collection<SAMReaderID> samFiles,GenomeLocParser genomeLocParser) {
+    public SAMDataSource(Collection<SAMReaderID> samFiles, ThreadAllocation threadAllocation, Integer numFileHandles, GenomeLocParser genomeLocParser) {
         this(
                 samFiles,
+                threadAllocation,
+                numFileHandles,
                 genomeLocParser,
                 false,
                 SAMFileReader.ValidationStringency.STRICT,
@@ -150,8 +164,7 @@ public class SAMDataSource {
                 new ValidationExclusion(),
                 new ArrayList<ReadFilter>(),
                 false,
-                false,
-                true);
+                false);
     }
 
     /**
@@ -159,6 +172,8 @@ public class SAMDataSource {
      */
     public SAMDataSource(
             Collection<SAMReaderID> samFiles,
+            ThreadAllocation threadAllocation,
+            Integer numFileHandles,
             GenomeLocParser genomeLocParser,
             boolean useOriginalBaseQualities,
             SAMFileReader.ValidationStringency strictness,
@@ -167,9 +182,10 @@ public class SAMDataSource {
             ValidationExclusion exclusionList,
             Collection<ReadFilter> supplementalFilters,
             boolean includeReadsWithDeletionAtLoci,
-            boolean generateExtendedEvents,
-            boolean enableLowMemorySharding) {
+            boolean generateExtendedEvents) {
         this(   samFiles,
+                threadAllocation,
+                numFileHandles,
                 genomeLocParser,
                 useOriginalBaseQualities,
                 strictness,
@@ -182,8 +198,7 @@ public class SAMDataSource {
                 BAQ.CalculationMode.OFF,
                 BAQ.QualityMode.DONT_MODIFY,
                 null, // no BAQ
-                (byte) -1,
-                enableLowMemorySharding);
+                (byte) -1);
         }
 
     /**
@@ -205,6 +220,8 @@ public class SAMDataSource {
      */
     public SAMDataSource(
             Collection<SAMReaderID> samFiles,
+            ThreadAllocation threadAllocation,
+            Integer numFileHandles,
             GenomeLocParser genomeLocParser,
             boolean useOriginalBaseQualities,
             SAMFileReader.ValidationStringency strictness,
@@ -217,13 +234,19 @@ public class SAMDataSource {
             BAQ.CalculationMode cmode,
             BAQ.QualityMode qmode,
             IndexedFastaSequenceFile refReader,
-            byte defaultBaseQualities,
-            boolean enableLowMemorySharding) {
-        this.enableLowMemorySharding(enableLowMemorySharding);
+            byte defaultBaseQualities) {
         this.readMetrics = new ReadMetrics();
         this.genomeLocParser = genomeLocParser;
 
         readerIDs = samFiles;
+
+        this.threadAllocation = threadAllocation;
+        // TODO: Consider a borrowed-thread dispatcher implementation.
+        if(this.threadAllocation.getNumIOThreads() > 0)
+            dispatcher = new BGZFBlockLoadingDispatcher(this.threadAllocation.getNumIOThreads(), numFileHandles != null ? numFileHandles : 1);
+        else
+            dispatcher = null;
+
         validationStringency = strictness;
         for (SAMReaderID readerID : samFiles) {
             if (!readerID.samFile.canRead())
@@ -235,10 +258,13 @@ public class SAMDataSource {
         SAMReaders readers = resourcePool.getAvailableReaders();
 
         // Determine the sort order.
-        for(SAMFileReader reader: readers.values()) {
+        for(SAMReaderID readerID: readerIDs) {
             // Get the sort order, forcing it to coordinate if unsorted.
+            SAMFileReader reader = readers.getReader(readerID);
             SAMFileHeader header = reader.getFileHeader();
 
+            headers.put(readerID,header);
+
             if ( header.getReadGroups().isEmpty() ) {
                 throw new UserException.MalformedBAM(readers.getReaderID(reader).samFile,
                         "SAM file doesn't have any read groups defined in the header.  The GATK no longer supports SAM files without read groups");
@@ -275,7 +301,7 @@ public class SAMDataSource {
                 qmode,
                 refReader,
                 defaultBaseQualities);
-        
+
         // cache the read group id (original) -> read group id (merged)
         // and read group id (merged) -> read group id (original) mappings.
         for(SAMReaderID id: readerIDs) {
@@ -296,12 +322,10 @@ public class SAMDataSource {
             originalToMergedReadGroupMappings.put(id,mappingToMerged);
         }
 
-        if(enableLowMemorySharding) {
-            for(SAMReaderID id: readerIDs) {
-                File indexFile = findIndexFile(id.samFile);
-                if(indexFile != null)
-                    bamIndices.put(id,new GATKBAMIndex(indexFile));
-            }
+        for(SAMReaderID id: readerIDs) {
+            File indexFile = findIndexFile(id.samFile);
+            if(indexFile != null)
+                bamIndices.put(id,new GATKBAMIndex(indexFile));
         }
 
         resourcePool.releaseReaders(readers);
@@ -314,22 +338,6 @@ public class SAMDataSource {
      */
     public ReadProperties getReadsInfo() { return readProperties; }
 
-    /**
-     * Enable experimental low-memory sharding.
-     * @param enable True to enable sharding.  False otherwise.
-     */
-    public void enableLowMemorySharding(final boolean enable) {
-        enableLowMemorySharding = enable;
-    }
-
-    /**
-     * Returns whether low-memory sharding is enabled.
-     * @return True if enabled, false otherwise.
-     */
-    public boolean isLowMemoryShardingEnabled() {
-        return enableLowMemorySharding;
-    }
-
     /**
      * Checks to see whether any reads files are supplying data.
      * @return True if no reads files are supplying data to the traversal; false otherwise.
@@ -368,7 +376,7 @@ public class SAMDataSource {
      * Retrieves the current position within the BAM file.
      * @return A mapping of reader to current position.
      */
-    public Map<SAMReaderID,SAMFileSpan> getCurrentPosition() {
+    public Map<SAMReaderID,GATKBAMFileSpan> getCurrentPosition() {
         return readerPositions;
     }
 
@@ -381,7 +389,7 @@ public class SAMDataSource {
     }
 
     public SAMFileHeader getHeader(SAMReaderID id) {
-        return resourcePool.getReadersWithoutLocking().getReader(id).getFileHeader();
+        return headers.get(id);
     }
 
     /**
@@ -404,45 +412,21 @@ public class SAMDataSource {
         return mergedToOriginalReadGroupMappings.get(mergedReadGroupId);
     }
 
-    /**
-     * No read group collisions at this time because only one SAM file is currently supported.
-     * @return False always.
-     */
-    public boolean hasReadGroupCollisions() {
-        return hasReadGroupCollisions;
-    }
-
     /**
      * True if all readers have an index.
      * @return True if all readers have an index.
      */
     public boolean hasIndex() {
-        if(enableLowMemorySharding)
-            return readerIDs.size() == bamIndices.size();
-        else {
-            for(SAMFileReader reader: resourcePool.getReadersWithoutLocking()) {
-                if(!reader.hasIndex())
-                    return false;
-            }
-            return true;
-        }
+        return readerIDs.size() == bamIndices.size();
     }
 
     /**
      * Gets the index for a particular reader.  Always preloaded.
-     * TODO: Should return object of type GATKBAMIndex, but cannot because there
-     * TODO: is no parent class of both BAMIndex and GATKBAMIndex.  Change when new
-     * TODO: sharding system goes live.      
      * @param id Id of the reader.
      * @return The index.  Will preload the index if necessary.
      */
-    public Object getIndex(final SAMReaderID id) {
-        if(enableLowMemorySharding)
-            return bamIndices.get(id);
-        else {
-            SAMReaders readers = resourcePool.getReadersWithoutLocking();
-            return readers.getReader(id).getBrowseableIndex();
-        }
+    public GATKBAMIndex getIndex(final SAMReaderID id) {
+        return bamIndices.get(id);
     }
 
     /**
@@ -454,7 +438,7 @@ public class SAMDataSource {
     }
 
     /**
-     * Gets the cumulative read metrics for shards already processed. 
+     * Gets the cumulative read metrics for shards already processed.
      * @return Cumulative read metrics.
      */
     public ReadMetrics getCumulativeReadMetrics() {
@@ -507,10 +491,6 @@ public class SAMDataSource {
     }
 
     public StingSAMIterator seek(Shard shard) {
-        // todo: refresh monolithic sharding implementation
-        if(shard instanceof MonolithicShard)
-            return seekMonolithic(shard);
-
         if(shard.buffersReads()) {
             return shard.iterator();
         }
@@ -540,7 +520,7 @@ public class SAMDataSource {
      */
     private void initializeReaderPositions(SAMReaders readers) {
         for(SAMReaderID id: getReaderIDs())
-            readerPositions.put(id,readers.getReader(id).getFilePointerSpanningReads());
+            readerPositions.put(id,new GATKBAMFileSpan(readers.getReader(id).getFilePointerSpanningReads()));
     }
 
     /**
@@ -548,7 +528,6 @@ public class SAMDataSource {
      * @param readers Readers from which to load data.
      * @param shard The shard specifying the data limits.
      * @param enableVerification True to verify.  For compatibility with old sharding strategy.
-     *        TODO: Collapse this flag when the two sharding systems are merged.
      * @return An iterator over the selected data.
      */
     private StingSAMIterator getIterator(SAMReaders readers, Shard shard, boolean enableVerification) {
@@ -559,14 +538,20 @@ public class SAMDataSource {
 
         for(SAMReaderID id: getReaderIDs()) {
             CloseableIterator<SAMRecord> iterator = null;
-            if(!shard.isUnmapped() && shard.getFileSpans().get(id) == null)
-                continue;
-            iterator = shard.getFileSpans().get(id) != null ?
-                    readers.getReader(id).iterator(shard.getFileSpans().get(id)) :
-                    readers.getReader(id).queryUnmapped();
+
+            // TODO: null used to be the signal for unmapped, but we've replaced that with a simple index query for the last bin.
+            // TODO: Kill this check once we've proven that the design elements are gone.
+            if(shard.getFileSpans().get(id) == null)
+                throw new ReviewedStingException("SAMDataSource: received null location for reader " + id + ", but null locations are no longer supported.");
+
+            if(threadAllocation.getNumIOThreads() > 0) {
+                BlockInputStream inputStream = readers.getInputStream(id);
+                inputStream.submitAccessPlan(new SAMReaderPosition(id,inputStream,(GATKBAMFileSpan)shard.getFileSpans().get(id)));
+            }
+            iterator = readers.getReader(id).iterator(shard.getFileSpans().get(id));
             if(readProperties.getReadBufferSize() != null)
                 iterator = new BufferingReadIterator(iterator,readProperties.getReadBufferSize());
-            if(shard.getGenomeLocs() != null)
+            if(shard.getGenomeLocs().size() > 0)
                 iterator = new IntervalOverlapFilteringIterator(iterator,shard.getGenomeLocs());
             mergingIterator.addIterator(readers.getReader(id),iterator);
         }
@@ -584,33 +569,6 @@ public class SAMDataSource {
                 readProperties.defaultBaseQualities());
     }
 
-    /**
-     * A stopgap measure to handle monolithic sharding
-     * @param shard the (monolithic) shard.
-     * @return An iterator over the monolithic shard.
-     */
-    private StingSAMIterator seekMonolithic(Shard shard) {
-        SAMReaders readers = resourcePool.getAvailableReaders();
-
-        // Set up merging and filtering to dynamically merge together multiple BAMs and filter out records not in the shard set.
-        SamFileHeaderMerger headerMerger = new SamFileHeaderMerger(SAMFileHeader.SortOrder.coordinate,readers.headers(),true);
-        MergingSamRecordIterator mergingIterator = new MergingSamRecordIterator(headerMerger,readers.values(),true);
-        for(SAMReaderID id: getReaderIDs())
-            mergingIterator.addIterator(readers.getReader(id),readers.getReader(id).iterator());
-
-        return applyDecoratingIterators(shard.getReadMetrics(),
-                shard instanceof ReadShard,
-                readProperties.useOriginalBaseQualities(),
-                new ReleasingIterator(readers,StingSAMIteratorAdapter.adapt(mergingIterator)),
-                readProperties.getDownsamplingMethod().toFraction,
-                readProperties.getValidationExclusionList().contains(ValidationExclusion.TYPE.NO_READ_ORDER_VERIFICATION),
-                readProperties.getSupplementalFilters(),
-                readProperties.getBAQCalculationMode(),
-                readProperties.getBAQQualityMode(),
-                readProperties.getRefReader(),
-                readProperties.defaultBaseQualities());
-    }
-
     /**
      * Adds this read to the given shard.
      * @param shard The shard to which to add the read.
@@ -618,7 +576,7 @@ public class SAMDataSource {
      * @param read The read to add to the shard.
      */
     private void addReadToBufferingShard(Shard shard,SAMReaderID id,SAMRecord read) {
-        SAMFileSpan endChunk = read.getFileSource().getFilePointer().getContentsFollowing();
+        GATKBAMFileSpan endChunk = new GATKBAMFileSpan(read.getFileSource().getFilePointer().getContentsFollowing());
         shard.addRead(read);
         readerPositions.put(id,endChunk);
     }
@@ -689,19 +647,6 @@ public class SAMDataSource {
             this.maxEntries = maxEntries;
         }
 
-        /**
-         * Dangerous internal method; retrieves any set of readers, whether in iteration or not.
-         * Used to handle non-exclusive, stateless operations, such as index queries.
-         * @return Any collection of SAMReaders, whether in iteration or not.
-         */
-        protected SAMReaders getReadersWithoutLocking() {
-            synchronized(this) {
-                if(allResources.size() == 0)
-                    createNewResource();
-            }
-            return allResources.get(0);
-        }
-
         /**
          * Choose a set of readers from the pool to use for this query.  When complete,
          * @return
@@ -753,6 +698,11 @@ public class SAMDataSource {
          */
         private final Map<SAMReaderID,SAMFileReader> readers = new LinkedHashMap<SAMReaderID,SAMFileReader>();
 
+        /**
+         * The inptu streams backing
+         */
+        private final Map<SAMReaderID,BlockInputStream> inputStreams = new LinkedHashMap<SAMReaderID,BlockInputStream>();
+
         /**
          * Derive a new set of readers from the Reads metadata.
          * @param readerIDs reads to load.
@@ -760,12 +710,20 @@ public class SAMDataSource {
          */
         public SAMReaders(Collection<SAMReaderID> readerIDs, SAMFileReader.ValidationStringency validationStringency) {
             for(SAMReaderID readerID: readerIDs) {
-                SAMFileReader reader = new SAMFileReader(readerID.samFile);
+                File indexFile = findIndexFile(readerID.samFile);
+
+                SAMFileReader reader = null;
+
+                if(threadAllocation.getNumIOThreads() > 0) {
+                    BlockInputStream blockInputStream = new BlockInputStream(dispatcher,readerID,false);
+                    reader = new SAMFileReader(blockInputStream,indexFile,false);
+                    inputStreams.put(readerID,blockInputStream);
+                }
+                else
+                    reader = new SAMFileReader(readerID.samFile,indexFile,false);
                 reader.setSAMRecordFactory(factory);
+
                 reader.enableFileSource(true);
-                reader.enableIndexMemoryMapping(false);
-                if(!enableLowMemorySharding)
-                    reader.enableIndexCaching(true);
                 reader.setValidationStringency(validationStringency);
 
                 final SAMFileHeader header = reader.getFileHeader();
@@ -786,6 +744,15 @@ public class SAMDataSource {
             return readers.get(id);
         }
 
+        /**
+         * Retrieve the input stream backing a reader.
+         * @param id The ID of the reader to retrieve.
+         * @return the reader associated with the given id.
+         */
+        public BlockInputStream getInputStream(final SAMReaderID id) {
+            return inputStreams.get(id);
+        }
+
         /**
          * Searches for the reader id of this reader.
          * @param reader Reader for which to search.
@@ -883,7 +850,7 @@ public class SAMDataSource {
      * Filters out reads that do not overlap the current GenomeLoc.
      * Note the custom implementation: BAM index querying returns all reads that could
      * possibly overlap the given region (and quite a few extras).  In order not to drag
-     * down performance, this implementation is highly customized to its task. 
+     * down performance, this implementation is highly customized to its task.
      */
     private class IntervalOverlapFilteringIterator implements CloseableIterator<SAMRecord> {
         /**
@@ -903,7 +870,7 @@ public class SAMDataSource {
 
         /**
          * Custom representation of interval bounds.
-         * Makes it simpler to track current position. 
+         * Makes it simpler to track current position.
          */
         private int[] intervalContigIndices;
         private int[] intervalStarts;
@@ -941,7 +908,7 @@ public class SAMDataSource {
                     i++;
                 }
             }
-            
+
             advance();
         }
 
@@ -1070,6 +1037,40 @@ public class SAMDataSource {
 
         return indexFile;
     }
+
+    /**
+     * Creates a BAM schedule over all reads in the BAM file, both mapped and unmapped.  The outgoing stream
+     * will be as granular as possible given our current knowledge of the best ways to split up BAM files.
+     * @return An iterator that spans all reads in all BAM files.
+     */
+    public Iterable<Shard> createShardIteratorOverAllReads(final ShardBalancer shardBalancer) {
+        shardBalancer.initialize(this,IntervalSharder.shardOverAllReads(this,genomeLocParser),genomeLocParser);
+        return shardBalancer;
+    }
+
+    /**
+     * Creates a BAM schedule over all mapped reads in the BAM file, when a 'mapped' read is defined as any
+     * read that has been assigned
+     * @return
+     */
+    public Iterable<Shard> createShardIteratorOverMappedReads(final SAMSequenceDictionary sequenceDictionary, final ShardBalancer shardBalancer) {
+        shardBalancer.initialize(this,IntervalSharder.shardOverMappedReads(this,sequenceDictionary,genomeLocParser),genomeLocParser);
+        return shardBalancer;
+    }
+
+    /**
+     * Create a schedule for processing the initialized BAM file using the given interval list.
+     * The returned schedule should be as granular as possible.
+     * @param intervals The list of intervals for which to create the schedule.
+     * @return A granular iterator over file pointers.
+     */
+    public Iterable<Shard> createShardIteratorOverIntervals(final GenomeLocSortedSet intervals,final ShardBalancer shardBalancer) {
+        if(intervals == null)
+            throw new ReviewedStingException("Unable to create schedule from intervals; no intervals were provided.");
+        shardBalancer.initialize(this,IntervalSharder.shardOverIntervals(SAMDataSource.this,intervals),genomeLocParser);
+        return shardBalancer;
+    }
 }
 
 
+
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/SAMReaderPosition.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/SAMReaderPosition.java
new file mode 100644
index 000000000..f9f6539a7
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/SAMReaderPosition.java
@@ -0,0 +1,120 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.datasources.reads;
+
+import net.sf.picard.util.PeekableIterator;
+import net.sf.samtools.GATKBAMFileSpan;
+import net.sf.samtools.GATKChunk;
+import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
+
+import java.util.List;
+
+/**
+* Created by IntelliJ IDEA.
+* User: mhanna
+* Date: 10/14/11
+* Time: 10:47 PM
+* To change this template use File | Settings | File Templates.
+*/
+class SAMReaderPosition {
+    private final SAMReaderID reader;
+    private final BlockInputStream inputStream;
+
+    private final List<GATKChunk> positions;
+    private PeekableIterator<GATKChunk> positionIterator;
+
+    /**
+     * Stores the next block address to read, or -1 if no such block is available.
+     */
+    private long nextBlockAddress;
+
+
+    SAMReaderPosition(final SAMReaderID reader, final BlockInputStream inputStream, GATKBAMFileSpan fileSpan) {
+        this.reader = reader;
+        this.inputStream = inputStream;
+
+        this.positions = fileSpan.getGATKChunks();
+        initialize();
+    }
+
+    public SAMReaderID getReader() {
+        return reader;
+    }
+
+    public BlockInputStream getInputStream() {
+        return inputStream;
+    }
+
+    /**
+     * Retrieves the next block address to be read.
+     * @return Next block address to be read.
+     */
+    public long getBlockAddress() {
+        return nextBlockAddress;
+    }
+
+    public void reset() {
+        initialize();
+    }
+
+    /**
+     * Resets the SAM reader position to its original state.
+     */
+    private void initialize() {
+        this.positionIterator = new PeekableIterator<GATKChunk>(positions.iterator());
+        if(positionIterator.hasNext())
+            nextBlockAddress = positionIterator.peek().getBlockStart();
+        else
+            nextBlockAddress = -1;
+    }
+
+    /**
+     * Advances the current position to the next block to read, given the current position in the file.
+     * @param filePosition The current position within the file.
+     */
+    void advancePosition(final long filePosition) {
+        nextBlockAddress = filePosition;
+
+        // Check the current file position against the iterator; if the iterator is before the current file position,
+        // draw the iterator forward.  Remember when performing the check that coordinates are half-open!
+        try {
+            while(positionIterator.hasNext() && isFilePositionPastEndOfChunk(filePosition,positionIterator.peek())) {
+                positionIterator.next();
+                // Check to see if the iterator has more data available.
+                if(positionIterator.hasNext() && filePosition < positionIterator.peek().getBlockStart()) {
+                    nextBlockAddress = positionIterator.peek().getBlockStart();
+                    break;
+                }
+            }
+        }
+        catch(Exception ex) {
+            throw new ReviewedStingException("");
+        }
+    }
+
+    private boolean isFilePositionPastEndOfChunk(final long filePosition, final GATKChunk chunk) {
+        return (filePosition > chunk.getBlockEnd() || (filePosition == chunk.getBlockEnd() && chunk.getBlockOffsetEnd() == 0));
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardBalancer.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardBalancer.java
new file mode 100644
index 000000000..962208086
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardBalancer.java
@@ -0,0 +1,21 @@
+package org.broadinstitute.sting.gatk.datasources.reads;
+
+import net.sf.picard.util.PeekableIterator;
+import org.broadinstitute.sting.utils.GenomeLocParser;
+
+import java.util.Iterator;
+
+/**
+ * Balances maximally granular file pointers into shards of reasonable size.
+ */
+public abstract class ShardBalancer implements Iterable<Shard> {
+    protected SAMDataSource readsDataSource;
+    protected PeekableIterator<FilePointer> filePointers;
+    protected GenomeLocParser parser;
+
+    public void initialize(final SAMDataSource readsDataSource, final Iterator<FilePointer> filePointers, final GenomeLocParser parser) {
+        this.readsDataSource = readsDataSource;
+        this.filePointers = new PeekableIterator<FilePointer>(filePointers);
+        this.parser = parser;
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardStrategy.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardStrategy.java
deleted file mode 100644
index 989cf9fce..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardStrategy.java
+++ /dev/null
@@ -1,31 +0,0 @@
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import java.util.Iterator;
-/**
- *
- * User: aaron
- * Date: Apr 10, 2009
- * Time: 4:55:37 PM
- *
- * The Broad Institute
- * SOFTWARE COPYRIGHT NOTICE AGREEMENT 
- * This software and its documentation are copyright 2009 by the
- * Broad Institute/Massachusetts Institute of Technology. All rights are reserved.
- *
- * This software is supplied without any warranty or guaranteed support whatsoever. Neither
- * the Broad Institute nor MIT can be responsible for its use, misuse, or functionality.
- *
- */
-
-/**
- * @author aaron
- * @version 1.0
- * @date Apr 10, 2009
- * <p/>
- * Interface ShardStrategy
- * <p/>
- * The base interface for the sharding strategy; before we had a base abstract
- * class, but not this will be an interface to accomidate read based sharding
- */
-public interface ShardStrategy extends Iterator<Shard>, Iterable<Shard> {
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardStrategyFactory.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardStrategyFactory.java
deleted file mode 100644
index 780b41ef7..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/ShardStrategyFactory.java
+++ /dev/null
@@ -1,117 +0,0 @@
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import net.sf.picard.reference.IndexedFastaSequenceFile;
-import net.sf.samtools.SAMSequenceDictionary;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-import org.broadinstitute.sting.utils.GenomeLocSortedSet;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-
-/**
- *
- * User: aaron
- * Date: Apr 6, 2009
- * Time: 7:09:22 PM
- *
- * The Broad Institute
- * SOFTWARE COPYRIGHT NOTICE AGREEMENT 
- * This software and its documentation are copyright 2009 by the
- * Broad Institute/Massachusetts Institute of Technology. All rights are reserved.
- *
- * This software is supplied without any warranty or guaranteed support whatsoever. Neither
- * the Broad Institute nor MIT can be responsible for its use, misuse, or functionality.
- *
- */
-
-
-/**
- * @author aaron
- * @version 1.0
- * @date Apr 6, 2009
- * <p/>
- * Class ShardStrategyFactory
- * <p/>
- * The Shard Strategy Factory,  use this class to create and transfer shard strategies
- * between different approaches.
- */
-public class ShardStrategyFactory {
-    public enum SHATTER_STRATEGY {
-        MONOLITHIC,   // Put all of the available data into one shard.
-        LOCUS_EXPERIMENTAL,
-        READS_EXPERIMENTAL
-    }
-
-    /**
-     * get a new shatter strategy
-     *
-     * @param readsDataSource     File pointer to BAM.
-     * @param referenceDataSource File pointer to reference.
-     * @param strat        what's our strategy - SHATTER_STRATEGY type
-     * @param dic          the seq dictionary
-     * @param startingSize the starting size
-     * @return a shard strategy capable of dividing input data into shards.
-     */
-    static public ShardStrategy shatter(SAMDataSource readsDataSource, IndexedFastaSequenceFile referenceDataSource, SHATTER_STRATEGY strat, SAMSequenceDictionary dic, long startingSize, GenomeLocParser genomeLocParser) {
-        return ShardStrategyFactory.shatter(readsDataSource, referenceDataSource, strat, dic, startingSize, genomeLocParser, -1L);
-    }
-
-    /**
-     * get a new shatter strategy
-     *
-     * @param readsDataSource     File pointer to BAM.
-     * @param referenceDataSource File pointer to reference.
-     * @param strat               what's our strategy - SHATTER_STRATEGY type
-     * @param dic                 the seq dictionary
-     * @param startingSize        the starting size
-     * @return a shard strategy capable of dividing input data into shards.
-     */
-    static public ShardStrategy shatter(SAMDataSource readsDataSource, IndexedFastaSequenceFile referenceDataSource, SHATTER_STRATEGY strat, SAMSequenceDictionary dic, long startingSize, GenomeLocParser genomeLocParser, long limitByCount) {
-        switch (strat) {
-            case LOCUS_EXPERIMENTAL:
-                return new LocusShardStrategy(readsDataSource,referenceDataSource,genomeLocParser,null);
-            case READS_EXPERIMENTAL:
-                return new ReadShardStrategy(genomeLocParser,readsDataSource,null);
-            default:
-                throw new ReviewedStingException("Strategy: " + strat + " isn't implemented for this type of shatter request");
-        }
-
-    }
-
-
-    /**
-     * get a new shatter strategy
-     *
-     * @param readsDataSource     File pointer to BAM.
-     * @param referenceDataSource File pointer to reference.
-     * @param strat        what's our strategy - SHATTER_STRATEGY type
-     * @param dic          the seq dictionary
-     * @param startingSize the starting size
-     * @return a shard strategy capable of dividing input data into shards.
-     */
-    static public ShardStrategy shatter(SAMDataSource readsDataSource, IndexedFastaSequenceFile referenceDataSource, SHATTER_STRATEGY strat, SAMSequenceDictionary dic, long startingSize, GenomeLocParser genomeLocParser, GenomeLocSortedSet lst) {
-        return ShardStrategyFactory.shatter(readsDataSource, referenceDataSource, strat, dic, startingSize, genomeLocParser, lst, -1l);
-
-    }
-
-    /**
-     * get a new shatter strategy
-     *
-     * @param readsDataSource The reads used to shatter this file.
-     * @param referenceDataSource The reference used to shatter this file.
-     * @param strat        what's our strategy - SHATTER_STRATEGY type
-     * @param dic          the seq dictionary
-     * @param startingSize the starting size
-     * @return A strategy for shattering this data.
-     */
-    static public ShardStrategy shatter(SAMDataSource readsDataSource, IndexedFastaSequenceFile referenceDataSource, SHATTER_STRATEGY strat, SAMSequenceDictionary dic, long startingSize, GenomeLocParser genomeLocParser, GenomeLocSortedSet lst, long limitDataCount) {
-        switch (strat) {
-            case LOCUS_EXPERIMENTAL:
-                return new LocusShardStrategy(readsDataSource,referenceDataSource,genomeLocParser,lst);
-            case READS_EXPERIMENTAL:
-                return new ReadShardStrategy(genomeLocParser, readsDataSource,lst);
-            default:
-                throw new ReviewedStingException("Strategy: " + strat + " isn't implemented");
-        }
-
-    }
-
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/utilities/FindLargeShards.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/utilities/FindLargeShards.java
index 673df6dfa..577db0965 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/utilities/FindLargeShards.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reads/utilities/FindLargeShards.java
@@ -30,10 +30,12 @@ import org.apache.log4j.Logger;
 import org.broadinstitute.sting.commandline.CommandLineProgram;
 import org.broadinstitute.sting.commandline.Input;
 import org.broadinstitute.sting.commandline.Output;
+import org.broadinstitute.sting.gatk.datasources.reads.BAMScheduler;
 import org.broadinstitute.sting.gatk.datasources.reads.FilePointer;
-import org.broadinstitute.sting.gatk.datasources.reads.LowMemoryIntervalSharder;
+import org.broadinstitute.sting.gatk.datasources.reads.IntervalSharder;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMReaderID;
+import org.broadinstitute.sting.gatk.resourcemanagement.ThreadAllocation;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.GenomeLocParser;
 import org.broadinstitute.sting.utils.GenomeLocSortedSet;
@@ -92,7 +94,7 @@ public class FindLargeShards extends CommandLineProgram {
 
         // initialize reads
         List<SAMReaderID> bamReaders = ListFileUtils.unpackBAMFileList(samFiles,parser);
-        SAMDataSource dataSource = new SAMDataSource(bamReaders,genomeLocParser);
+        SAMDataSource dataSource = new SAMDataSource(bamReaders,new ThreadAllocation(),null,genomeLocParser);
 
         // intervals
         GenomeLocSortedSet intervalSortedSet = null;
@@ -106,7 +108,7 @@ public class FindLargeShards extends CommandLineProgram {
 
         logger.info(String.format("PROGRESS: Calculating mean and variance: Contig\tRegion.Start\tRegion.Stop\tSize"));        
 
-        LowMemoryIntervalSharder sharder = new LowMemoryIntervalSharder(dataSource,intervalSortedSet);
+        IntervalSharder sharder = IntervalSharder.shardOverIntervals(dataSource,intervalSortedSet);
         while(sharder.hasNext()) {
             FilePointer filePointer = sharder.next();
 
@@ -135,7 +137,7 @@ public class FindLargeShards extends CommandLineProgram {
         logger.warn(String.format("PROGRESS: Searching for large shards: Contig\tRegion.Start\tRegion.Stop\tSize"));
         out.printf("Contig\tRegion.Start\tRegion.Stop\tSize%n");
 
-        sharder = new LowMemoryIntervalSharder(dataSource,intervalSortedSet);
+        sharder =  IntervalSharder.shardOverIntervals(dataSource,intervalSortedSet);
         while(sharder.hasNext()) {
             FilePointer filePointer = sharder.next();
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/datasources/reference/ReferenceDataSource.java b/public/java/src/org/broadinstitute/sting/gatk/datasources/reference/ReferenceDataSource.java
index c8c79bb14..2c33a19b8 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/datasources/reference/ReferenceDataSource.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/datasources/reference/ReferenceDataSource.java
@@ -29,6 +29,14 @@ import net.sf.picard.reference.FastaSequenceIndex;
 import net.sf.picard.reference.FastaSequenceIndexBuilder;
 import net.sf.picard.reference.IndexedFastaSequenceFile;
 import net.sf.picard.sam.CreateSequenceDictionary;
+import net.sf.samtools.SAMSequenceRecord;
+import org.broadinstitute.sting.gatk.datasources.reads.FilePointer;
+import org.broadinstitute.sting.gatk.datasources.reads.LocusShard;
+import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
+import org.broadinstitute.sting.gatk.datasources.reads.Shard;
+import org.broadinstitute.sting.utils.GenomeLoc;
+import org.broadinstitute.sting.utils.GenomeLocParser;
+import org.broadinstitute.sting.utils.GenomeLocSortedSet;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.broadinstitute.sting.utils.fasta.CachingIndexedFastaSequenceFile;
@@ -36,13 +44,17 @@ import org.broadinstitute.sting.utils.file.FSLockWithShared;
 import org.broadinstitute.sting.utils.file.FileSystemInabilityToLockException;
 
 import java.io.File;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Iterator;
+import java.util.List;
 
 /**
  * Loads reference data from fasta file
  * Looks for fai and dict files, and tries to create them if they don't exist
  */
 public class ReferenceDataSource {
-    private IndexedFastaSequenceFile index;
+    private IndexedFastaSequenceFile reference;
 
     /** our log, which we want to capture anything from this class */
     protected static org.apache.log4j.Logger logger = org.apache.log4j.Logger.getLogger(ReferenceDataSource.class);
@@ -173,7 +185,7 @@ public class ReferenceDataSource {
                 logger.info("Treating existing index file as complete.");
             }
 
-            index = new CachingIndexedFastaSequenceFile(fastaFile);
+            reference = new CachingIndexedFastaSequenceFile(fastaFile);
 
         } catch (IllegalArgumentException e) {
             throw new UserException.CouldNotReadInputFile(fastaFile, "Could not read reference sequence.  The FASTA must have either a .fasta or .fa extension", e);
@@ -192,6 +204,52 @@ public class ReferenceDataSource {
      * @return IndexedFastaSequenceFile that was created from file
      */
     public IndexedFastaSequenceFile getReference() {
-        return this.index;
+        return this.reference;
+    }
+
+    /**
+     * Creates an iterator for processing the entire reference.
+     * @param readsDataSource the reads datasource to embed in the locus shard.
+     * @param parser used to generate/regenerate intervals.  TODO: decouple the creation of the shards themselves from the creation of the driving iterator so that datasources need not be passed to datasources.
+     * @param maxShardSize The maximum shard size which can be used to create this list.
+     * @return Creates a schedule for performing a traversal over the entire reference.
+     */
+    public Iterable<Shard> createShardsOverEntireReference(final SAMDataSource readsDataSource, final GenomeLocParser parser, final int maxShardSize) {
+        List<Shard> shards = new ArrayList<Shard>();
+        for(SAMSequenceRecord refSequenceRecord: reference.getSequenceDictionary().getSequences()) {
+            for(int shardStart = 1; shardStart <= refSequenceRecord.getSequenceLength(); shardStart += maxShardSize) {
+                final int shardStop = Math.min(shardStart+maxShardSize-1, refSequenceRecord.getSequenceLength());
+                shards.add(new LocusShard(parser,
+                                          readsDataSource,
+                                          Collections.singletonList(parser.createGenomeLoc(refSequenceRecord.getSequenceName(),shardStart,shardStop)),
+                                          null));
+            }
+        }
+        return shards;
+    }
+
+    /**
+     * Creates an iterator for processing the entire reference.
+     * @param readsDataSource the reads datasource to embed in the locus shard.  TODO: decouple the creation of the shards themselves from the creation of the driving iterator so that datasources need not be passed to datasources.
+     * @param intervals the list of intervals to use when processing the reference.
+     * @param maxShardSize The maximum shard size which can be used to create this list.
+     * @return Creates a schedule for performing a traversal over the entire reference.
+     */
+    public Iterable<Shard> createShardsOverIntervals(final SAMDataSource readsDataSource, final GenomeLocSortedSet intervals, final int maxShardSize) {
+        List<Shard> shards = new ArrayList<Shard>();
+        for(GenomeLoc interval: intervals) {
+            while(interval.size() > maxShardSize) {
+                shards.add(new LocusShard(intervals.getGenomeLocParser(),
+                        readsDataSource,
+                        Collections.singletonList(intervals.getGenomeLocParser().createGenomeLoc(interval.getContig(),interval.getStart(),interval.getStart()+maxShardSize-1)),
+                        null));
+                interval = intervals.getGenomeLocParser().createGenomeLoc(interval.getContig(),interval.getStart()+maxShardSize,interval.getStop());
+            }
+            shards.add(new LocusShard(intervals.getGenomeLocParser(),
+                    readsDataSource,
+                    Collections.singletonList(interval),
+                    null));
+        }
+        return shards;
     }
 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/executive/HierarchicalMicroScheduler.java b/public/java/src/org/broadinstitute/sting/gatk/executive/HierarchicalMicroScheduler.java
index 162baed00..b0043e68c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/executive/HierarchicalMicroScheduler.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/executive/HierarchicalMicroScheduler.java
@@ -5,7 +5,6 @@ import org.broad.tribble.TribbleException;
 import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
 import org.broadinstitute.sting.gatk.datasources.reads.Shard;
-import org.broadinstitute.sting.gatk.datasources.reads.ShardStrategy;
 import org.broadinstitute.sting.gatk.datasources.rmd.ReferenceOrderedDataSource;
 import org.broadinstitute.sting.gatk.io.OutputTracker;
 import org.broadinstitute.sting.gatk.io.ThreadLocalOutputTracker;
@@ -88,7 +87,7 @@ public class HierarchicalMicroScheduler extends MicroScheduler implements Hierar
         this.threadPool = Executors.newFixedThreadPool(nThreadsToUse);
     }
 
-    public Object execute( Walker walker, ShardStrategy shardStrategy ) {
+    public Object execute( Walker walker, Iterable<Shard> shardStrategy ) {
         // Fast fail for walkers not supporting TreeReducible interface.
         if (!( walker instanceof TreeReducible ))
             throw new IllegalArgumentException("The GATK can currently run in parallel only with TreeReducible walkers");
diff --git a/public/java/src/org/broadinstitute/sting/gatk/executive/LinearMicroScheduler.java b/public/java/src/org/broadinstitute/sting/gatk/executive/LinearMicroScheduler.java
index deafcd0cc..ff5e1064b 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/executive/LinearMicroScheduler.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/executive/LinearMicroScheduler.java
@@ -7,7 +7,6 @@ import org.broadinstitute.sting.gatk.datasources.providers.ReadShardDataProvider
 import org.broadinstitute.sting.gatk.datasources.providers.ShardDataProvider;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
 import org.broadinstitute.sting.gatk.datasources.reads.Shard;
-import org.broadinstitute.sting.gatk.datasources.reads.ShardStrategy;
 import org.broadinstitute.sting.gatk.datasources.rmd.ReferenceOrderedDataSource;
 import org.broadinstitute.sting.gatk.io.DirectOutputTracker;
 import org.broadinstitute.sting.gatk.io.OutputTracker;
@@ -44,7 +43,7 @@ public class LinearMicroScheduler extends MicroScheduler {
      * @param walker    Computation to perform over dataset.
      * @param shardStrategy A strategy for sharding the data.
      */
-    public Object execute(Walker walker, ShardStrategy shardStrategy) {
+    public Object execute(Walker walker, Iterable<Shard> shardStrategy) {
         walker.initialize();
         Accumulator accumulator = Accumulator.create(engine,walker);
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/executive/MicroScheduler.java b/public/java/src/org/broadinstitute/sting/gatk/executive/MicroScheduler.java
index e731b9864..d013db7e8 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/executive/MicroScheduler.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/executive/MicroScheduler.java
@@ -30,11 +30,11 @@ import org.apache.log4j.Logger;
 import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
 import org.broadinstitute.sting.gatk.datasources.reads.Shard;
-import org.broadinstitute.sting.gatk.datasources.reads.ShardStrategy;
 import org.broadinstitute.sting.gatk.datasources.rmd.ReferenceOrderedDataSource;
 import org.broadinstitute.sting.gatk.io.OutputTracker;
 import org.broadinstitute.sting.gatk.iterators.NullSAMIterator;
 import org.broadinstitute.sting.gatk.iterators.StingSAMIterator;
+import org.broadinstitute.sting.gatk.resourcemanagement.ThreadAllocation;
 import org.broadinstitute.sting.gatk.traversals.*;
 import org.broadinstitute.sting.gatk.walkers.*;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
@@ -87,20 +87,20 @@ public abstract class MicroScheduler implements MicroSchedulerMBean {
      * @param reads         the informations associated with the reads
      * @param reference     the reference file
      * @param rods          the rods to include in the traversal
-     * @param nThreadsToUse Number of threads to utilize.
+     * @param threadAllocation Number of threads to utilize.
      *
      * @return The best-fit microscheduler.
      */
-    public static MicroScheduler create(GenomeAnalysisEngine engine, Walker walker, SAMDataSource reads, IndexedFastaSequenceFile reference, Collection<ReferenceOrderedDataSource> rods, int nThreadsToUse) {
-        if (walker instanceof TreeReducible && nThreadsToUse > 1) {
+    public static MicroScheduler create(GenomeAnalysisEngine engine, Walker walker, SAMDataSource reads, IndexedFastaSequenceFile reference, Collection<ReferenceOrderedDataSource> rods, ThreadAllocation threadAllocation) {
+        if (walker instanceof TreeReducible && threadAllocation.getNumCPUThreads() > 1) {
             if(walker.isReduceByInterval())
                 throw new UserException.BadArgumentValue("nt", String.format("The analysis %s aggregates results by interval.  Due to a current limitation of the GATK, analyses of this type do not currently support parallel execution.  Please run your analysis without the -nt option.", engine.getWalkerName(walker.getClass())));
             if(walker instanceof ReadWalker)
                 throw new UserException.BadArgumentValue("nt", String.format("The analysis %s is a read walker.  Due to a current limitation of the GATK, analyses of this type do not currently support parallel execution.  Please run your analysis without the -nt option.", engine.getWalkerName(walker.getClass())));
-            logger.info(String.format("Running the GATK in parallel mode with %d concurrent threads",nThreadsToUse));
-            return new HierarchicalMicroScheduler(engine, walker, reads, reference, rods, nThreadsToUse);
+            logger.info(String.format("Running the GATK in parallel mode with %d concurrent threads",threadAllocation.getNumCPUThreads()));
+            return new HierarchicalMicroScheduler(engine, walker, reads, reference, rods, threadAllocation.getNumCPUThreads());
         } else {
-            if(nThreadsToUse > 1)
+            if(threadAllocation.getNumCPUThreads() > 1)
                 throw new UserException.BadArgumentValue("nt", String.format("The analysis %s currently does not support parallel execution.  Please run your analysis without the -nt option.", engine.getWalkerName(walker.getClass())));
             return new LinearMicroScheduler(engine, walker, reads, reference, rods);
         }
@@ -156,7 +156,7 @@ public abstract class MicroScheduler implements MicroSchedulerMBean {
      *
      * @return the return type of the walker
      */
-    public abstract Object execute(Walker walker, ShardStrategy shardStrategy);
+    public abstract Object execute(Walker walker, Iterable<Shard> shardStrategy);
 
     /**
      * Retrieves the object responsible for tracking and managing output.
diff --git a/public/java/src/org/broadinstitute/sting/gatk/resourcemanagement/ThreadAllocation.java b/public/java/src/org/broadinstitute/sting/gatk/resourcemanagement/ThreadAllocation.java
new file mode 100644
index 000000000..0c81af07b
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/resourcemanagement/ThreadAllocation.java
@@ -0,0 +1,93 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.resourcemanagement;
+
+import org.broadinstitute.sting.utils.exceptions.UserException;
+
+/**
+ * Models how threads are distributed between various components of the GATK.
+ */
+public class ThreadAllocation {
+    /**
+     * The number of CPU threads to be used by the GATK.
+     */
+    private final int numCPUThreads;
+
+    /**
+     * Number of threads to devote exclusively to IO.  Default is 0.
+     */
+    private final int numIOThreads;
+
+    public int getNumCPUThreads() {
+        return numCPUThreads;
+    }
+
+    public int getNumIOThreads() {
+        return numIOThreads;
+    }
+
+    /**
+     * Construct the default thread allocation.
+     */
+    public ThreadAllocation() {
+        this(1,null,null);
+    }
+
+    /**
+     * Set up the thread allocation.  Default allocation is 1 CPU thread, 0 IO threads.
+     * (0 IO threads means that no threads are devoted exclusively to IO; they're inline on the CPU thread).
+     * @param totalThreads Complete number of threads to allocate.
+     * @param numCPUThreads Total number of threads allocated to the traversal.
+     * @param numIOThreads Total number of threads allocated exclusively to IO.
+     */
+    public ThreadAllocation(final int totalThreads, final Integer numCPUThreads, final Integer numIOThreads) {
+        // If no allocation information is present, allocate all threads to CPU
+        if(numCPUThreads == null && numIOThreads == null) {
+            this.numCPUThreads = totalThreads;
+            this.numIOThreads = 0;
+        }
+        // If only CPU threads are specified, allocate remainder to IO (minimum 0 dedicated IO threads).
+        else if(numIOThreads == null) {
+            if(numCPUThreads > totalThreads)
+                throw new UserException(String.format("Invalid thread allocation.  User requested %d threads in total, but the count of cpu threads (%d) is higher than the total threads",totalThreads,numCPUThreads));
+            this.numCPUThreads = numCPUThreads;
+            this.numIOThreads = totalThreads - numCPUThreads;
+        }
+        // If only IO threads are specified, allocate remainder to CPU (minimum 1 dedicated CPU thread).
+        else if(numCPUThreads == null) {
+            if(numIOThreads > totalThreads)
+                throw new UserException(String.format("Invalid thread allocation.  User requested %d threads in total, but the count of io threads (%d) is higher than the total threads",totalThreads,numIOThreads));
+            this.numCPUThreads = Math.max(1,totalThreads-numIOThreads);
+            this.numIOThreads = numIOThreads;
+        }
+        else {
+            if(numCPUThreads + numIOThreads != totalThreads)
+                throw new UserException(String.format("Invalid thread allocation.  User requested %d threads in total, but the count of cpu threads (%d) + the count of io threads (%d) does not match",totalThreads,numCPUThreads,numIOThreads));
+            this.numCPUThreads = numCPUThreads;
+            this.numIOThreads = numIOThreads;
+        }
+    }
+
+}
diff --git a/public/java/test/org/broadinstitute/sting/gatk/datasources/providers/LocusViewTemplate.java b/public/java/test/org/broadinstitute/sting/gatk/datasources/providers/LocusViewTemplate.java
index 8d7dd82ac..17a7d1974 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/datasources/providers/LocusViewTemplate.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/datasources/providers/LocusViewTemplate.java
@@ -11,6 +11,7 @@ import org.broadinstitute.sting.gatk.executive.WindowMaker;
 import org.broadinstitute.sting.gatk.datasources.reads.LocusShard;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
 import org.broadinstitute.sting.gatk.iterators.StingSAMIterator;
+import org.broadinstitute.sting.gatk.resourcemanagement.ThreadAllocation;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.GenomeLocParser;
 import org.broadinstitute.sting.utils.sam.GATKSAMRecord;
@@ -49,7 +50,7 @@ public abstract class LocusViewTemplate extends BaseTest {
         SAMRecordIterator iterator = new SAMRecordIterator();
 
         GenomeLoc shardBounds = genomeLocParser.createGenomeLoc("chr1", 1, 5);
-        Shard shard = new LocusShard(genomeLocParser, new SAMDataSource(Collections.<SAMReaderID>emptyList(),genomeLocParser),Collections.singletonList(shardBounds),Collections.<SAMReaderID,SAMFileSpan>emptyMap());
+        Shard shard = new LocusShard(genomeLocParser, new SAMDataSource(Collections.<SAMReaderID>emptyList(),new ThreadAllocation(),null,genomeLocParser),Collections.singletonList(shardBounds),Collections.<SAMReaderID,SAMFileSpan>emptyMap());
         WindowMaker windowMaker = new WindowMaker(shard,genomeLocParser,iterator,shard.getGenomeLocs());
         WindowMaker.WindowMakerIterator window = windowMaker.next();
         LocusShardDataProvider dataProvider = new LocusShardDataProvider(shard, null, genomeLocParser, window.getLocus(), window, null, null);
diff --git a/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/MockLocusShard.java b/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/MockLocusShard.java
index dc3a6cafe..62c93bddd 100644
--- a/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/MockLocusShard.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/MockLocusShard.java
@@ -26,6 +26,7 @@ package org.broadinstitute.sting.gatk.datasources.reads;
 
 import org.broadinstitute.sting.gatk.datasources.reads.LocusShard;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMReaderID;
+import org.broadinstitute.sting.gatk.resourcemanagement.ThreadAllocation;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
 import org.broadinstitute.sting.utils.GenomeLocParser;
@@ -42,7 +43,7 @@ import java.util.Collections;
 public class MockLocusShard extends LocusShard {
     public MockLocusShard(final GenomeLocParser genomeLocParser,final List<GenomeLoc> intervals) {
         super(  genomeLocParser,
-                new SAMDataSource(Collections.<SAMReaderID>emptyList(),genomeLocParser),
+                new SAMDataSource(Collections.<SAMReaderID>emptyList(),new ThreadAllocation(),null,genomeLocParser),
                 intervals,
                 null);
     }
diff --git a/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/SAMBAMDataSourceUnitTest.java b/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/SAMBAMDataSourceUnitTest.java
deleted file mode 100755
index e41a6b3b7..000000000
--- a/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/SAMBAMDataSourceUnitTest.java
+++ /dev/null
@@ -1,223 +0,0 @@
-package org.broadinstitute.sting.gatk.datasources.reads;
-
-import static org.testng.Assert.fail;
-import net.sf.picard.reference.IndexedFastaSequenceFile;
-import net.sf.samtools.SAMRecord;
-import org.broadinstitute.sting.BaseTest;
-import org.broadinstitute.sting.commandline.Tags;
-import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
-import org.broadinstitute.sting.gatk.datasources.reads.SAMReaderID;
-import org.broadinstitute.sting.gatk.datasources.reads.Shard;
-import org.broadinstitute.sting.gatk.datasources.reads.ShardStrategy;
-import org.broadinstitute.sting.gatk.datasources.reads.ShardStrategyFactory;
-import org.broadinstitute.sting.gatk.iterators.StingSAMIterator;
-import org.broadinstitute.sting.utils.GenomeLocParser;
-import org.broadinstitute.sting.utils.GenomeLoc;
-import org.broadinstitute.sting.utils.fasta.CachingIndexedFastaSequenceFile;
-import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.testng.annotations.AfterMethod;
-import org.testng.annotations.BeforeMethod;
-
-import org.testng.annotations.Test;
-
-import java.io.File;
-import java.io.FileNotFoundException;
-import java.util.ArrayList;
-import java.util.List;
-
-/**
- *
- * User: aaron
- * Date: Apr 8, 2009
- * Time: 8:14:23 PM
- *
- * The Broad Institute
- * SOFTWARE COPYRIGHT NOTICE AGREEMENT 
- * This software and its documentation are copyright 2009 by the
- * Broad Institute/Massachusetts Institute of Technology. All rights are reserved.
- *
- * This software is supplied without any warranty or guaranteed support whatsoever. Neither
- * the Broad Institute nor MIT can be responsible for its use, misuse, or functionality.
- *
- */
-
-
-/**
- * @author aaron
- * @version 1.0
- * @date Apr 8, 2009
- * <p/>
- * Class SAMBAMDataSourceUnitTest
- * <p/>
- * The test of the SAMBAM simple data source.
- */
-public class SAMBAMDataSourceUnitTest extends BaseTest {
-
-    private List<SAMReaderID> readers;
-    private IndexedFastaSequenceFile seq;
-    private GenomeLocParser genomeLocParser;
-
-    /**
-     * This function does the setup of our parser, before each method call.
-     * <p/>
-     * Called before every test case method.
-     */
-    @BeforeMethod
-    public void doForEachTest() throws FileNotFoundException {
-        readers = new ArrayList<SAMReaderID>();
-
-        // sequence
-        seq = new CachingIndexedFastaSequenceFile(new File(hg18Reference));
-        genomeLocParser = new GenomeLocParser(seq.getSequenceDictionary());
-    }
-
-    /**
-     * Tears down the test fixture after each call.
-     * <p/>
-     * Called after every test case method.
-     */
-    @AfterMethod
-    public void undoForEachTest() {
-        seq = null;
-        readers.clear();
-    }
-
-
-    /** Test out that we can shard the file and iterate over every read */
-    @Test
-    public void testLinearBreakIterateAll() {
-        logger.warn("Executing testLinearBreakIterateAll");
-
-        // setup the data
-        readers.add(new SAMReaderID(new File(validationDataLocation+"/NA12878.chrom6.SLX.SRP000032.2009_06.selected.bam"),new Tags()));
-
-        // the sharding strat.
-        SAMDataSource data = new SAMDataSource(readers,genomeLocParser);
-        ShardStrategy strat = ShardStrategyFactory.shatter(data,seq,ShardStrategyFactory.SHATTER_STRATEGY.LOCUS_EXPERIMENTAL, seq.getSequenceDictionary(), 100000,genomeLocParser);
-        int count = 0;
-
-        try {
-            for (Shard sh : strat) {
-                int readCount = 0;
-                count++;
-
-                GenomeLoc firstLocus = sh.getGenomeLocs().get(0), lastLocus = sh.getGenomeLocs().get(sh.getGenomeLocs().size()-1);
-                logger.debug("Start : " + firstLocus.getStart() + " stop : " + lastLocus.getStop() + " contig " + firstLocus.getContig());
-                logger.debug("count = " + count);
-                StingSAMIterator datum = data.seek(sh);
-
-                // for the first couple of shards make sure we can see the reads
-                if (count < 5) {
-                    for (SAMRecord r : datum) {
-                    }
-                    readCount++;
-                }
-                datum.close();
-
-                // if we're over 100 shards, break out
-                if (count > 100) {
-                    break;
-                }
-            }
-        }
-        catch (UserException.CouldNotReadInputFile e) {
-            e.printStackTrace();  //To change body of catch statement use File | Settings | File Templates.
-            fail("testLinearBreakIterateAll: We Should get a UserException.CouldNotReadInputFile exception");
-        }
-    }
-
-
-    /** Test out that we can shard the file and iterate over every read */
-    @Test
-    public void testMergingTwoBAMFiles() {
-        logger.warn("Executing testMergingTwoBAMFiles");
-
-        // setup the test files
-        readers.add(new SAMReaderID(new File(validationDataLocation + "/NA12878.chrom6.SLX.SRP000032.2009_06.selected.bam"),new Tags()));
-
-        // the sharding strat.
-        SAMDataSource data = new SAMDataSource(readers,genomeLocParser);
-        ShardStrategy strat = ShardStrategyFactory.shatter(data,seq,ShardStrategyFactory.SHATTER_STRATEGY.LOCUS_EXPERIMENTAL, seq.getSequenceDictionary(), 100000,genomeLocParser);
-
-        ArrayList<Integer> readcountPerShard = new ArrayList<Integer>();
-        ArrayList<Integer> readcountPerShard2 = new ArrayList<Integer>();
-
-        // count up the first hundred shards
-        int shardsToCount = 100;
-        int count = 0;
-
-        try {
-            for (Shard sh : strat) {
-                int readCount = 0;
-                count++;
-                if (count > shardsToCount) {
-                    break;
-                }
-
-                StingSAMIterator datum = data.seek(sh);
-
-                for (SAMRecord r : datum) {
-                    readCount++;
-
-                }
-                readcountPerShard.add(readCount);
-                logger.debug("read count = " + readCount);
-                datum.close();
-            }
-        }
-        catch (UserException.CouldNotReadInputFile e) {
-            e.printStackTrace();  //To change body of catch statement use File | Settings | File Templates.
-            fail("testLinearBreakIterateAll: We Should get a UserException.CouldNotReadInputFile exception");
-        }
-
-
-        // setup the data and the counter before our second run
-        readers.clear();
-        readers.add(new SAMReaderID(new File(validationDataLocation + "/NA12878.chrom6.SLX.SRP000032.2009_06.selected.bam"),new Tags()));
-        readers.add(new SAMReaderID(new File(validationDataLocation + "/NA12878.chrom6.SLX.SRP000032.2009_06.selected.bam"),new Tags()));
-
-        count = 0;
-        // the sharding strat.
-        data = new SAMDataSource(readers,genomeLocParser);
-        strat = ShardStrategyFactory.shatter(data,seq,ShardStrategyFactory.SHATTER_STRATEGY.LOCUS_EXPERIMENTAL, seq.getSequenceDictionary(), 100000, genomeLocParser);
-
-        logger.debug("Pile two:");
-        try {
-            for (Shard sh : strat) {
-                int readCount = 0;
-                count++;
-
-                // can we leave?
-                if (count > shardsToCount) {
-                    break;
-                }
-
-                StingSAMIterator datum = data.seek(sh);
-
-                for (SAMRecord r : datum) {
-                    readCount++;
-                }
-
-                readcountPerShard2.add(readCount);
-                logger.debug("read count = " + readCount);
-                datum.close();
-            }
-        }
-        catch (UserException.CouldNotReadInputFile e) {
-            e.printStackTrace();  //To change body of catch statement use File | Settings | File Templates.
-            fail("testLinearBreakIterateAll: We Should get a UserException.CouldNotReadInputFile exception");
-        }
-
-        /*int pos = 0;
-        for (; pos < 100; pos++) {
-            if (!readcountPerShard.get(pos).equals(readcountPerShard2.get(pos))) {
-                fail("Shard number " + pos + " in the two approaches had different read counts, " + readcountPerShard.get(pos) + " and " + readcountPerShard2.get(pos));
-            }
-        } */
-
-    }
-
-
-
-
-}
diff --git a/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/SAMDataSourceUnitTest.java b/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/SAMDataSourceUnitTest.java
new file mode 100755
index 000000000..ba2d68ec9
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/gatk/datasources/reads/SAMDataSourceUnitTest.java
@@ -0,0 +1,147 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.datasources.reads;
+
+import static org.testng.Assert.fail;
+import net.sf.picard.reference.IndexedFastaSequenceFile;
+import net.sf.samtools.SAMFileReader;
+import net.sf.samtools.SAMRecord;
+import org.broadinstitute.sting.BaseTest;
+import org.broadinstitute.sting.commandline.Tags;
+import org.broadinstitute.sting.gatk.arguments.ValidationExclusion;
+import org.broadinstitute.sting.gatk.filters.ReadFilter;
+import org.broadinstitute.sting.gatk.iterators.StingSAMIterator;
+import org.broadinstitute.sting.gatk.resourcemanagement.ThreadAllocation;
+import org.broadinstitute.sting.utils.GenomeLocParser;
+import org.broadinstitute.sting.utils.GenomeLoc;
+import org.broadinstitute.sting.utils.fasta.CachingIndexedFastaSequenceFile;
+import org.broadinstitute.sting.utils.exceptions.UserException;
+import org.testng.annotations.AfterMethod;
+import org.testng.annotations.BeforeMethod;
+
+import org.testng.annotations.Test;
+
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+
+/**
+ * @author aaron
+ * @version 1.0
+ * @date Apr 8, 2009
+ * <p/>
+ * Class SAMDataSourceUnitTest
+ * <p/>
+ * The test of the SAMBAM simple data source.
+ */
+public class SAMDataSourceUnitTest extends BaseTest {
+
+    private List<SAMReaderID> readers;
+    private IndexedFastaSequenceFile seq;
+    private GenomeLocParser genomeLocParser;
+
+    /**
+     * This function does the setup of our parser, before each method call.
+     * <p/>
+     * Called before every test case method.
+     */
+    @BeforeMethod
+    public void doForEachTest() throws FileNotFoundException {
+        readers = new ArrayList<SAMReaderID>();
+
+        // sequence
+        seq = new CachingIndexedFastaSequenceFile(new File(b36KGReference));
+        genomeLocParser = new GenomeLocParser(seq.getSequenceDictionary());
+    }
+
+    /**
+     * Tears down the test fixture after each call.
+     * <p/>
+     * Called after every test case method.
+     */
+    @AfterMethod
+    public void undoForEachTest() {
+        seq = null;
+        readers.clear();
+    }
+
+
+    /** Test out that we can shard the file and iterate over every read */
+    @Test
+    public void testLinearBreakIterateAll() {
+        logger.warn("Executing testLinearBreakIterateAll");
+
+        // setup the data
+        readers.add(new SAMReaderID(new File(validationDataLocation+"/NA12878.chrom6.SLX.SRP000032.2009_06.selected.bam"),new Tags()));
+
+        // the sharding strat.
+        SAMDataSource data = new SAMDataSource(readers,
+                new ThreadAllocation(),
+                null,
+                genomeLocParser,
+                false,
+                SAMFileReader.ValidationStringency.SILENT,
+                null,
+                null,
+                new ValidationExclusion(),
+                new ArrayList<ReadFilter>(),
+                false,
+                false);
+
+        Iterable<Shard> strat = data.createShardIteratorOverMappedReads(seq.getSequenceDictionary(),new LocusShardBalancer());
+        int count = 0;
+
+        try {
+            for (Shard sh : strat) {
+                int readCount = 0;
+                count++;
+
+                GenomeLoc firstLocus = sh.getGenomeLocs().get(0), lastLocus = sh.getGenomeLocs().get(sh.getGenomeLocs().size()-1);
+                logger.debug("Start : " + firstLocus.getStart() + " stop : " + lastLocus.getStop() + " contig " + firstLocus.getContig());
+                logger.debug("count = " + count);
+                StingSAMIterator datum = data.seek(sh);
+
+                // for the first couple of shards make sure we can see the reads
+                if (count < 5) {
+                    for (SAMRecord r : datum) {
+                    }
+                    readCount++;
+                }
+                datum.close();
+
+                // if we're over 100 shards, break out
+                if (count > 100) {
+                    break;
+                }
+            }
+        }
+        catch (UserException.CouldNotReadInputFile e) {
+            e.printStackTrace();  //To change body of catch statement use File | Settings | File Templates.
+            fail("testLinearBreakIterateAll: We Should get a UserException.CouldNotReadInputFile exception");
+        }
+    }
+}
diff --git a/public/java/test/org/broadinstitute/sting/gatk/traversals/TraverseReadsUnitTest.java b/public/java/test/org/broadinstitute/sting/gatk/traversals/TraverseReadsUnitTest.java
index 7f4d96add..9226f97e2 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/traversals/TraverseReadsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/traversals/TraverseReadsUnitTest.java
@@ -5,14 +5,13 @@ import net.sf.picard.reference.IndexedFastaSequenceFile;
 import org.broadinstitute.sting.BaseTest;
 import org.broadinstitute.sting.commandline.Tags;
 import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
-import org.broadinstitute.sting.gatk.ReadMetrics;
 import org.broadinstitute.sting.gatk.datasources.providers.ShardDataProvider;
 import org.broadinstitute.sting.gatk.datasources.providers.ReadShardDataProvider;
+import org.broadinstitute.sting.gatk.datasources.reads.ReadShardBalancer;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMDataSource;
 import org.broadinstitute.sting.gatk.datasources.reads.Shard;
-import org.broadinstitute.sting.gatk.datasources.reads.ShardStrategy;
-import org.broadinstitute.sting.gatk.datasources.reads.ShardStrategyFactory;
 import org.broadinstitute.sting.gatk.datasources.reads.SAMReaderID;
+import org.broadinstitute.sting.gatk.resourcemanagement.ThreadAllocation;
 import org.broadinstitute.sting.gatk.walkers.qc.CountReadsWalker;
 import org.broadinstitute.sting.gatk.walkers.Walker;
 import org.broadinstitute.sting.utils.GenomeLocParser;
@@ -66,7 +65,6 @@ public class TraverseReadsUnitTest extends BaseTest {
     private List<SAMReaderID> bamList;
     private Walker countReadWalker;
     private File output;
-    private long readSize = 100000;
     private TraverseReads traversalEngine = null;
 
     private IndexedFastaSequenceFile ref = null;
@@ -117,18 +115,14 @@ public class TraverseReadsUnitTest extends BaseTest {
     /** Test out that we can shard the file and iterate over every read */
     @Test
     public void testUnmappedReadCount() {
-        SAMDataSource dataSource = new SAMDataSource(bamList,genomeLocParser);
-        ShardStrategy shardStrategy = ShardStrategyFactory.shatter(dataSource,ref, ShardStrategyFactory.SHATTER_STRATEGY.READS_EXPERIMENTAL,
-                ref.getSequenceDictionary(),
-                readSize,
-                genomeLocParser);
+        SAMDataSource dataSource = new SAMDataSource(bamList,new ThreadAllocation(),null,genomeLocParser);
+        Iterable<Shard> shardStrategy = dataSource.createShardIteratorOverAllReads(new ReadShardBalancer());
 
         countReadWalker.initialize();
         Object accumulator = countReadWalker.reduceInit();
 
-        while (shardStrategy.hasNext()) {
+        for(Shard shard: shardStrategy) {
             traversalEngine.startTimersIfNecessary();
-            Shard shard = shardStrategy.next();
 
             if (shard == null) {
                 fail("Shard == null");

From 333e5de812884e9a2109cf69e438025474f305ce Mon Sep 17 00:00:00 2001
From: Mauricio Carneiro <carneiro@broadinstitute.org>
Date: Fri, 18 Nov 2011 16:49:59 -0500
Subject: [PATCH 065/113] returning read instead of GATKSAMRecord

Do not create new GATKSAMRecord when read has been fully clipped, because it is essentially the same as returning the currently fully clipped read.
---
 .../org/broadinstitute/sting/utils/clipreads/ReadClipper.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/clipreads/ReadClipper.java b/public/java/src/org/broadinstitute/sting/utils/clipreads/ReadClipper.java
index e4806838d..8c1061494 100644
--- a/public/java/src/org/broadinstitute/sting/utils/clipreads/ReadClipper.java
+++ b/public/java/src/org/broadinstitute/sting/utils/clipreads/ReadClipper.java
@@ -121,7 +121,7 @@ public class ReadClipper {
 
     public GATKSAMRecord hardClipSoftClippedBases () {
         if (read.isEmpty())
-            return new GATKSAMRecord(read.getHeader());
+            return read;
 
         int readIndex = 0;
         int cutLeft = -1;            // first position to hard clip (inclusive)

From b5de1820145f3b2ca4156454dfff79164e4dde72 Mon Sep 17 00:00:00 2001
From: Mauricio Carneiro <carneiro@broadinstitute.org>
Date: Fri, 18 Nov 2011 18:34:05 -0500
Subject: [PATCH 066/113] isEmpty now checks if mReadBases is null

Since newly created reads have mReadBases == null. This is an effort to centralize the place to check for empty GATKSAMRecords.
---
 .../src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java b/public/java/src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java
index 6d7c8dad9..d3a52167a 100755
--- a/public/java/src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java
+++ b/public/java/src/org/broadinstitute/sting/utils/sam/GATKSAMRecord.java
@@ -261,7 +261,7 @@ public class GATKSAMRecord extends BAMRecord {
      * @return true if the read has no bases
      */
     public boolean isEmpty() {
-        return this.getReadLength() == 0;
+        return super.getReadBases() == null || super.getReadLength() == 0;
     }
 
     /**

From c7f2d5c7c7d7a1c8ac46afebe321968d3bf78fd4 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 18 Nov 2011 14:49:06 -0500
Subject: [PATCH 067/113] Final minor fix to contract

---
 .../sting/utils/variantcontext/GenotypesContext.java       | 1 -
 .../sting/utils/variantcontext/VariantContextBuilder.java  | 7 ++++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index a639f512e..47e6b2fbe 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -213,7 +213,6 @@ public class GenotypesContext implements List<Genotype> {
      * @param toCopy the collection of genotypes
      * @return an mutable GenotypeContext containing genotypes
      */
-    @Requires({"toCopy != null"})
     @Ensures({"result != null"})
     public static final GenotypesContext copy(final Collection<Genotype> toCopy) {
         return toCopy == null ? NO_GENOTYPES : create(new ArrayList<Genotype>(toCopy));
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
index 67077e8c3..a2065d458 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
@@ -24,7 +24,7 @@
 
 package org.broadinstitute.sting.utils.variantcontext;
 
-import com.google.java.contract.Requires;
+import com.google.java.contract.*;
 import org.broad.tribble.Feature;
 import org.broad.tribble.TribbleException;
 import org.broad.tribble.util.ParsingUtils;
@@ -158,10 +158,11 @@ public class VariantContextBuilder {
      * @return
      */
     @Requires({"key != null"})
+    @Ensures({"this.attributes.size() == old(this.attributes.size()) || this.attributes.size() == old(this.attributes.size()+1)"})
     public VariantContextBuilder attribute(final String key, final Object value) {
         if ( ! attributesCanBeModified ) {
             this.attributesCanBeModified = true;
-            this.attributes = new HashMap<String, Object>();
+            this.attributes = new HashMap<String, Object>(attributes);
         }
         attributes.put(key, value);
         return this;
@@ -282,7 +283,7 @@ public class VariantContextBuilder {
      * @param negLog10PError
      * @return
      */
-    @Requires("negLog10PError <= 0 || negLog10PError == VariantContext.NO_NEG_LOG_10PERROR")
+    @Requires("negLog10PError >= 0 || negLog10PError == VariantContext.NO_NEG_LOG_10PERROR")
     public VariantContextBuilder negLog10PError(final double negLog10PError) {
         this.negLog10PError = negLog10PError;
         return this;

From 6cf315e17beaa971e4bc606935f922456c4c8fce Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 18 Nov 2011 21:07:30 -0500
Subject: [PATCH 068/113] Change interface to getNegLog10PError to
 getLog10PError

---
 .../gatk/refdata/VariantContextAdaptors.java  | 14 +++---
 .../gatk/walkers/annotator/AlleleBalance.java |  4 +-
 .../gatk/walkers/annotator/HardyWeinberg.java |  4 +-
 .../gatk/walkers/annotator/QualByDepth.java   |  2 +-
 .../annotator/VariantAnnotatorEngine.java     |  2 +-
 .../beagle/BeagleOutputToVCFWalker.java       | 18 +++-----
 .../walkers/diffengine/VCFDiffableReader.java |  4 +-
 .../filters/VariantFiltrationWalker.java      | 23 ++++------
 .../genotyper/ExactAFCalculationModel.java    |  2 +-
 .../walkers/genotyper/UGCallVariants.java     |  3 +-
 .../genotyper/UnifiedGenotyperEngine.java     | 34 ++++++++-------
 .../indels/SomaticIndelDetectorWalker.java    | 21 ++++-----
 .../walkers/phasing/PhaseByTransmission.java  | 12 +++---
 .../gatk/walkers/phasing/PhasingUtils.java    |  6 +--
 .../phasing/ReadBackedPhasingWalker.java      | 13 +++---
 .../MendelianViolationEvaluator.java          |  2 +-
 .../variantutils/LeftAlignVariants.java       |  2 +-
 .../walkers/variantutils/VariantsToTable.java |  2 +-
 .../utils/codecs/vcf/AbstractVCFCodec.java    |  8 ++--
 .../utils/codecs/vcf/StandardVCFWriter.java   |  6 +--
 .../sting/utils/codecs/vcf/VCF3Codec.java     |  2 +-
 .../sting/utils/codecs/vcf/VCFCodec.java      |  2 +-
 .../broadinstitute/sting/utils/gcf/GCF.java   | 21 ++++-----
 .../sting/utils/gcf/GCFGenotype.java          |  4 +-
 .../utils/variantcontext/CommonInfo.java      | 27 ++++++------
 .../sting/utils/variantcontext/Genotype.java  | 34 +++++++--------
 .../utils/variantcontext/VariantContext.java  | 43 +++++--------------
 .../variantcontext/VariantContextBuilder.java | 18 ++++----
 .../variantcontext/VariantContextUtils.java   | 36 +++++++++-------
 .../variantcontext/VariantJEXLContext.java    |  2 +-
 .../utils/genotype/vcf/VCFWriterUnitTest.java | 10 ++---
 .../variantcontext/GenotypeUnitTest.java      |  4 +-
 .../VariantContextBenchmark.java              |  2 +-
 .../VariantContextUnitTest.java               | 30 ++++++-------
 .../VariantContextUtilsUnitTest.java          |  2 +-
 35 files changed, 193 insertions(+), 226 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
index 7953edd7f..09ae02bd9 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/refdata/VariantContextAdaptors.java
@@ -9,7 +9,6 @@ import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
 import org.broadinstitute.sting.utils.GenomeLoc;
 import org.broadinstitute.sting.utils.classloader.PluginManager;
 import org.broadinstitute.sting.utils.codecs.hapmap.RawHapMapFeature;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.util.*;
@@ -193,9 +192,12 @@ public class VariantContextAdaptors {
                     return null; // we weren't given enough reference context to create the VariantContext
                 Byte refBaseForIndel = new Byte(ref.getBases()[index]);
 
-                GenotypesContext genotypes = null;
-                VariantContext vc = new VariantContext(name, dbsnp.getRsID(), dbsnp.getChr(), dbsnp.getStart() - (sawNullAllele ? 1 : 0), dbsnp.getEnd() - (refAllele.isNull() ? 1 : 0), alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, attributes, refBaseForIndel);
-                return vc;
+                final VariantContextBuilder builder = new VariantContextBuilder();
+                builder.source(name).id(dbsnp.getRsID());
+                builder.loc(dbsnp.getChr(), dbsnp.getStart() - (sawNullAllele ? 1 : 0), dbsnp.getEnd() - (refAllele.isNull() ? 1 : 0));
+                builder.alleles(alleles);
+                builder.referenceBaseForIndel(refBaseForIndel);
+                return builder.make();
             } else
                 return null; // can't handle anything else
         }
@@ -255,7 +257,7 @@ public class VariantContextAdaptors {
                 genotypes.add(call);
                 alleles.add(refAllele);
                 GenomeLoc loc = ref.getGenomeLocParser().createGenomeLoc(geli.getChr(),geli.getStart());
-                return new VariantContextBuilder(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles).genotypes(genotypes).negLog10PError(geli.getLODBestToReference()).attributes(attributes).make();
+                return new VariantContextBuilder(name, loc.getContig(), loc.getStart(), loc.getStop(), alleles).genotypes(genotypes).log10PError(-1 * geli.getLODBestToReference()).attributes(attributes).make();
             } else
                 return null; // can't handle anything else
         }
@@ -349,7 +351,7 @@ public class VariantContextAdaptors {
             long end = hapmap.getEnd();
             if ( deletionLength > 0 )
                 end += deletionLength;
-            VariantContext vc = new VariantContext(name, hapmap.getName(), hapmap.getChr(), hapmap.getStart(), end, alleles, genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, null, refBaseForIndel);
+            VariantContext vc = new VariantContextBuilder(name, hapmap.getChr(), hapmap.getStart(), end, alleles).id(hapmap.getName()).genotypes(genotypes).referenceBaseForIndel(refBaseForIndel).make();
             return vc;
        }
     }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
index 4a13fccc6..833107bd3 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/AlleleBalance.java
@@ -85,8 +85,8 @@ public class AlleleBalance extends InfoFieldAnnotation {
                     continue;
 
                 // weight the allele balance by genotype quality so that e.g. mis-called homs don't affect the ratio too much
-                ratio += genotype.getNegLog10PError() * ((double)refCount / (double)(refCount + altCount));
-                totalWeights += genotype.getNegLog10PError();
+                ratio += genotype.getLog10PError() * ((double)refCount / (double)(refCount + altCount));
+                totalWeights += genotype.getLog10PError();
             } else if ( vc.isIndel() && context.hasExtendedEventPileup() ) {
                 final ReadBackedExtendedEventPileup indelPileup = context.getExtendedEventPileup();
                 if ( indelPileup == null ) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
index 33f2f1dd3..795cdbeb5 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/HardyWeinberg.java
@@ -27,7 +27,7 @@ public class HardyWeinberg extends InfoFieldAnnotation implements WorkInProgress
 
     private static final int MIN_SAMPLES = 10;
     private static final int MIN_GENOTYPE_QUALITY = 10;
-    private static final int MIN_NEG_LOG10_PERROR = MIN_GENOTYPE_QUALITY / 10;
+    private static final int MIN_LOG10_PERROR = MIN_GENOTYPE_QUALITY / 10;
 
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
 
@@ -46,7 +46,7 @@ public class HardyWeinberg extends InfoFieldAnnotation implements WorkInProgress
             // Right now we just ignore genotypes that are not confident, but this throws off
             //  our HW ratios.  More analysis is needed to determine the right thing to do when
             //  the genotyper cannot decide whether a given sample is het or hom var.
-            if ( g.getNegLog10PError() < MIN_NEG_LOG10_PERROR )
+            if ( g.getLog10PError() > MIN_LOG10_PERROR )
                 continue;
 
             if ( g.isHomRef() )
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
index 0653b6015..d555463bc 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/QualByDepth.java
@@ -51,7 +51,7 @@ public class QualByDepth extends InfoFieldAnnotation implements StandardAnnotati
         if ( depth == 0 )
             return null;
 
-        double QD = 10.0 * vc.getNegLog10PError() / (double)depth;
+        double QD = -10.0 * vc.getLog10PError() / (double)depth;
 
         Map<String, Object> map = new HashMap<String, Object>();
         map.put(getKeyNames().get(0), String.format("%.2f", QD));
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
index b782de15f..d4442dc5d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorEngine.java
@@ -244,7 +244,7 @@ public class VariantAnnotatorEngine {
                 if ( result != null )
                     genotypeAnnotations.putAll(result);
             }
-            genotypes.add(new Genotype(genotype.getSampleName(), genotype.getAlleles(), genotype.getNegLog10PError(), genotype.getFilters(), genotypeAnnotations, genotype.isPhased()));
+            genotypes.add(new Genotype(genotype.getSampleName(), genotype.getAlleles(), genotype.getLog10PError(), genotype.getFilters(), genotypeAnnotations, genotype.isPhased()));
         }
 
         return genotypes;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index d4aa21097..b95b35b4a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -331,18 +331,16 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
             genotypes.add(imputedGenotype);
         }
 
-        VariantContext filteredVC;
-        if ( beagleVarCounts > 0 || DONT_FILTER_MONOMORPHIC_SITES )
-            filteredVC = new VariantContext("outputvcf", vc_input.getID(), vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), vc_input.getAlleles(), genotypes, vc_input.getNegLog10PError(), vc_input.filtersWereApplied() ? vc_input.getFilters() : null, vc_input.getAttributes());
-        else {
+        final VariantContextBuilder builder = new VariantContextBuilder(vc_input).source("outputvcf").genotypes(genotypes);
+        if ( ! ( beagleVarCounts > 0 || DONT_FILTER_MONOMORPHIC_SITES ) ) {
             Set<String> removedFilters = vc_input.filtersWereApplied() ? new HashSet<String>(vc_input.getFilters()) : new HashSet<String>(1);
             removedFilters.add(String.format("BGL_RM_WAS_%s",vc_input.getAlternateAllele(0)));
-            filteredVC = new VariantContext("outputvcf", vc_input.getID(), vc_input.getChr(), vc_input.getStart(), vc_input.getEnd(), new HashSet<Allele>(Arrays.asList(vc_input.getReference())), genotypes, vc_input.getNegLog10PError(), removedFilters, vc_input.getAttributes());
+            builder.alleles(new HashSet<Allele>(Arrays.asList(vc_input.getReference()))).filters(removedFilters);
         }
 
-        HashMap<String, Object> attributes = new HashMap<String, Object>(filteredVC.getAttributes());
+        HashMap<String, Object> attributes = new HashMap<String, Object>(vc_input.getAttributes());
         // re-compute chromosome counts
-        VariantContextUtils.calculateChromosomeCounts(filteredVC, attributes, false);
+        VariantContextUtils.calculateChromosomeCounts(vc_input, attributes, false);
 
         // Get Hapmap AC and AF
         if (vc_comp != null) {
@@ -356,13 +354,11 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         if( !beagleR2Feature.getR2value().equals(Double.NaN) ) {
             attributes.put("R2", beagleR2Feature.getR2value().toString() );
         }
+        builder.attributes(attributes);
 
-
-        vcfWriter.add(new VariantContextBuilder(filteredVC).attributes(attributes).make());
-
+        vcfWriter.add(builder.make());
 
         return 1;
-
     }
 
     public Integer reduceInit() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
index 6b5ffd3ed..efa57c0aa 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/diffengine/VCFDiffableReader.java
@@ -99,7 +99,7 @@ public class VCFDiffableReader implements DiffableReader {
                 vcRoot.add("ID", vc.getID());
                 vcRoot.add("REF", vc.getReference());
                 vcRoot.add("ALT", vc.getAlternateAlleles());
-                vcRoot.add("QUAL", vc.hasNegLog10PError() ? vc.getNegLog10PError() * 10 : VCFConstants.MISSING_VALUE_v4);
+                vcRoot.add("QUAL", vc.hasLog10PError() ? vc.getLog10PError() * -10 : VCFConstants.MISSING_VALUE_v4);
                 vcRoot.add("FILTER", vc.getFilters());
 
                 // add info fields
@@ -111,7 +111,7 @@ public class VCFDiffableReader implements DiffableReader {
                 for (Genotype g : vc.getGenotypes() ) {
                     DiffNode gRoot = DiffNode.empty(g.getSampleName(), vcRoot);
                     gRoot.add("GT", g.getGenotypeString());
-                    gRoot.add("GQ", g.hasNegLog10PError() ? g.getNegLog10PError() * 10 : VCFConstants.MISSING_VALUE_v4 );
+                    gRoot.add("GQ", g.hasLog10PError() ? g.getLog10PError() * -10 : VCFConstants.MISSING_VALUE_v4 );
 
                     for (Map.Entry<String, Object> attribute : g.getAttributes().entrySet()) {
                         if ( ! attribute.getKey().startsWith("_") )
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
index 049b92084..8278dbab7 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationWalker.java
@@ -277,14 +277,12 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
         if ( context == null )
             return;
 
-        VariantContext vc = context.getVariantContext();
+        final VariantContext vc = context.getVariantContext();
+        final VariantContextBuilder builder = new VariantContextBuilder(vc);
 
         // make new Genotypes based on filters
-        GenotypesContext genotypes;
-        if ( genotypeFilterExps.size() == 0 ) {
-            genotypes = null;
-        } else {
-            genotypes = GenotypesContext.create(vc.getGenotypes().size());
+        if ( genotypeFilterExps.size() > 0 ) {
+            GenotypesContext genotypes = GenotypesContext.create(vc.getGenotypes().size());
 
             // for each genotype, check filters then create a new object
             for ( final Genotype g : vc.getGenotypes() ) {
@@ -295,11 +293,13 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
                         if ( VariantContextUtils.match(vc, g, exp) )
                             filters.add(exp.name);
                     }
-                    genotypes.add(new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), filters, g.getAttributes(), g.isPhased()));
+                    genotypes.add(new Genotype(g.getSampleName(), g.getAlleles(), g.getLog10PError(), filters, g.getAttributes(), g.isPhased()));
                 } else {
                     genotypes.add(g);
                 }
             }
+
+            builder.genotypes(genotypes);
         }
 
         // make a new variant context based on filters
@@ -319,14 +319,9 @@ public class VariantFiltrationWalker extends RodWalker<Integer, Integer> {
                     filters.add(exp.name);                         
             }
         }
+        builder.filters(filters);
 
-        VariantContext filteredVC;
-        if ( genotypes == null )
-            filteredVC = new VariantContextBuilder(vc).filters(filters).make();
-        else
-            filteredVC = new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), vc.getAlleles(), genotypes, vc.getNegLog10PError(), filters, vc.getAttributes());
-
-        writer.add(filteredVC);
+        writer.add(builder.make());
     }
 
     public Integer reduce(Integer value, Integer sum) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index a7240ae88..e071de15b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -431,7 +431,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
 
             ArrayList<Allele> myAlleles = new ArrayList<Allele>();
 
-            double qual = Genotype.NO_NEG_LOG_10PERROR;
+            double qual = Genotype.NO_LOG10_PERROR;
             myAlleles.add(Allele.NO_CALL);
             myAlleles.add(Allele.NO_CALL);
             //System.out.println(myAlleles.toString());
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
index 60513ca5f..83da319ea 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
@@ -137,7 +137,8 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
             VariantContext vc = VCs.get(0);
             throw new UserException("There is no ALT allele in any of the VCF records passed in at " + vc.getChr() + ":" + vc.getStart());
         }
-        return new VariantContext("VCwithGLs", VCFConstants.EMPTY_ID_FIELD, variantVC.getChr(), variantVC.getStart(), variantVC.getEnd(), variantVC.getAlleles(), genotypes, VariantContext.NO_NEG_LOG_10PERROR, null, null);
+
+        return new VariantContextBuilder(variantVC).source("VCwithGLs").genotypes(genotypes).make();
     }
 
     private static GenotypesContext getGenotypesWithGLs(GenotypesContext genotypes) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
index 0fe7e1fc2..c38bb5b42 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperEngine.java
@@ -280,22 +280,13 @@ public class UnifiedGenotyperEngine {
             attributes.put(VCFConstants.DEPTH_KEY, GL.getDepth());
             attributes.put(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, likelihoods);
 
-            genotypes.add(new Genotype(GL.getSample(), noCall, Genotype.NO_NEG_LOG_10PERROR, null, attributes, false));
+            genotypes.add(new Genotype(GL.getSample(), noCall, Genotype.NO_LOG10_PERROR, null, attributes, false));
         }
 
         GenomeLoc loc = refContext.getLocus();
         int endLoc = calculateEndPos(alleles, refAllele, loc);
 
-        return new VariantContext("UG_call",
-                VCFConstants.EMPTY_ID_FIELD, loc.getContig(),
-                loc.getStart(),
-                endLoc,
-                alleles,
-                genotypes,
-                VariantContext.NO_NEG_LOG_10PERROR,
-                null,
-                null,
-                refContext.getBase());
+        return new VariantContextBuilder("UG_call", loc.getContig(), loc.getStart(), endLoc, alleles).genotypes(genotypes).referenceBaseForIndel(refContext.getBase()).make();
     }
 
     // private method called by both UnifiedGenotyper and UGCallVariants entry points into the engine
@@ -419,8 +410,14 @@ public class UnifiedGenotyperEngine {
             myAlleles = new HashSet<Allele>(1);
             myAlleles.add(vc.getReference());
         }
-        VariantContext vcCall = new VariantContext("UG_call", VCFConstants.EMPTY_ID_FIELD, loc.getContig(), loc.getStart(), endLoc,
-                myAlleles, genotypes, phredScaledConfidence/10.0, passesCallThreshold(phredScaledConfidence) ? null : filter, attributes, refContext.getBase());
+
+        VariantContextBuilder builder = new VariantContextBuilder("UG_call", loc.getContig(), loc.getStart(), endLoc, myAlleles);
+        builder.genotypes(genotypes);
+        builder.log10PError(phredScaledConfidence/-10.0);
+        if ( ! passesCallThreshold(phredScaledConfidence) ) builder.filters(filter);
+        builder.attributes(attributes);
+        builder.referenceBaseForIndel(refContext.getBase());
+        VariantContext vcCall = builder.make();
 
         if ( annotationEngine != null ) {
             // Note: we want to use the *unfiltered* and *unBAQed* context for the annotations
@@ -503,10 +500,15 @@ public class UnifiedGenotyperEngine {
             myAlleles = new HashSet<Allele>(1);
             myAlleles.add(vc.getReference());
         }
-        VariantContext vcCall = new VariantContext("UG_call", VCFConstants.EMPTY_ID_FIELD, loc.getContig(), loc.getStart(), endLoc,
-                myAlleles, genotypes, phredScaledConfidence/10.0, passesCallThreshold(phredScaledConfidence) ? null : filter, attributes, vc.getReferenceBaseForIndel());
 
-        return new VariantCallContext(vcCall, confidentlyCalled(phredScaledConfidence, PofF));
+        VariantContextBuilder builder = new VariantContextBuilder("UG_call", loc.getContig(), loc.getStart(), endLoc, myAlleles);
+        builder.genotypes(genotypes);
+        builder.log10PError(phredScaledConfidence/-10.0);
+        if ( ! passesCallThreshold(phredScaledConfidence) ) builder.filters(filter);
+        builder.attributes(attributes);
+        builder.referenceBaseForIndel(vc.getReferenceBaseForIndel());
+
+        return new VariantCallContext(builder.make(), confidentlyCalled(phredScaledConfidence, PofF));
     }
 
     private int calculateEndPos(Collection<Allele> alleles, Allele refAllele, GenomeLoc loc) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
index e3dc59b19..aa9ae1517 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/SomaticIndelDetectorWalker.java
@@ -58,10 +58,7 @@ import org.broadinstitute.sting.utils.interval.IntervalUtils;
 import org.broadinstitute.sting.utils.interval.OverlappingIntervalIterator;
 import org.broadinstitute.sting.utils.sam.AlignmentUtils;
 import org.broadinstitute.sting.utils.sam.GATKSAMRecord;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.*;
 import java.util.*;
@@ -1064,9 +1061,9 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
             Map<String,Object> attrs = call.makeStatsAttributes(null);
 
             if ( call.isCall() ) // we made a call - put actual het genotype here:
-                genotypes.add(new Genotype(sample,alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrs,false));
+                genotypes.add(new Genotype(sample,alleles,Genotype.NO_LOG10_PERROR,null,attrs,false));
             else // no call: genotype is ref/ref (but alleles still contain the alt if we observed anything at all) 
-                genotypes.add(new Genotype(sample, homref_alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrs,false));
+                genotypes.add(new Genotype(sample, homref_alleles,Genotype.NO_LOG10_PERROR,null,attrs,false));
 
         }
         Set<String> filters = null;
@@ -1074,8 +1071,8 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
             filters = new HashSet<String>();
             filters.add("NoCall");
         }
-        VariantContext vc = new VariantContext("IGv2_Indel_call", VCFConstants.EMPTY_ID_FIELD, refName, start, stop, alleles, genotypes,
-            -1.0 /* log error */,  filters, null, refBases[(int)start-1]);
+        VariantContext vc = new VariantContextBuilder("IGv2_Indel_call", refName, start, stop, alleles)
+                .genotypes(genotypes).filters(filters).referenceBaseForIndel(refBases[(int)start-1]).make();
         vcf.add(vc);
     }
 
@@ -1150,11 +1147,11 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
         GenotypesContext genotypes = GenotypesContext.create();
 
         for ( String sample : normalSamples ) {
-            genotypes.add(new Genotype(sample, homRefN ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsNormal,false));
+            genotypes.add(new Genotype(sample, homRefN ? homRefAlleles : alleles,Genotype.NO_LOG10_PERROR,null,attrsNormal,false));
         }
 
         for ( String sample : tumorSamples ) {
-            genotypes.add(new Genotype(sample, homRefT ? homRefAlleles : alleles,Genotype.NO_NEG_LOG_10PERROR,null,attrsTumor,false) );
+            genotypes.add(new Genotype(sample, homRefT ? homRefAlleles : alleles,Genotype.NO_LOG10_PERROR,null,attrsTumor,false) );
         }
 
         Set<String> filters = null;
@@ -1171,8 +1168,8 @@ public class SomaticIndelDetectorWalker extends ReadWalker<Integer,Integer> {
             filters.add("TCov");
         }
 
-        VariantContext vc = new VariantContext("IGv2_Indel_call", VCFConstants.EMPTY_ID_FIELD, refName, start, stop, alleles, genotypes,
-            -1.0 /* log error */, filters, attrs, refBases[(int)start-1]);
+        VariantContext vc = new VariantContextBuilder("IGv2_Indel_call", refName, start, stop, alleles)
+                .genotypes(genotypes).filters(filters).attributes(attrs).referenceBaseForIndel(refBases[(int)start-1]).make();
         vcf.add(vc);
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
index 088ff4c71..2d71ea8a8 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
@@ -132,17 +132,17 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
         List<Allele> homRefAlleles = new ArrayList<Allele>();
         homRefAlleles.add(refAllele);
         homRefAlleles.add(refAllele);
-        Genotype homRef = new Genotype(g.getSampleName(), homRefAlleles, g.getNegLog10PError(), null, g.getAttributes(), false);
+        Genotype homRef = new Genotype(g.getSampleName(), homRefAlleles, g.getLog10PError(), null, g.getAttributes(), false);
 
         List<Allele> hetAlleles = new ArrayList<Allele>();
         hetAlleles.add(refAllele);
         hetAlleles.add(altAllele);
-        Genotype het = new Genotype(g.getSampleName(), hetAlleles, g.getNegLog10PError(), null, g.getAttributes(), false);
+        Genotype het = new Genotype(g.getSampleName(), hetAlleles, g.getLog10PError(), null, g.getAttributes(), false);
 
         List<Allele> homVarAlleles = new ArrayList<Allele>();
         homVarAlleles.add(altAllele);
         homVarAlleles.add(altAllele);
-        Genotype homVar = new Genotype(g.getSampleName(), homVarAlleles, g.getNegLog10PError(), null, g.getAttributes(), false);
+        Genotype homVar = new Genotype(g.getSampleName(), homVarAlleles, g.getLog10PError(), null, g.getAttributes(), false);
 
         ArrayList<Genotype> genotypes = new ArrayList<Genotype>();
         genotypes.add(homRef);
@@ -187,7 +187,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
                 possiblePhasedChildAlleles.add(momAllele);
                 possiblePhasedChildAlleles.add(dadAllele);
 
-                Genotype possiblePhasedChildGenotype = new Genotype(child.getSampleName(), possiblePhasedChildAlleles, child.getNegLog10PError(), child.getFilters(), child.getAttributes(), true);
+                Genotype possiblePhasedChildGenotype = new Genotype(child.getSampleName(), possiblePhasedChildAlleles, child.getLog10PError(), child.getFilters(), child.getAttributes(), true);
 
                 possiblePhasedChildGenotypes.add(possiblePhasedChildGenotype);
             }
@@ -204,7 +204,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
                 phasedMomAlleles.add(momTransmittedAllele);
                 phasedMomAlleles.add(momUntransmittedAllele);
 
-                Genotype phasedMomGenotype = new Genotype(mom.getSampleName(), phasedMomAlleles, mom.getNegLog10PError(), mom.getFilters(), mom.getAttributes(), true);
+                Genotype phasedMomGenotype = new Genotype(mom.getSampleName(), phasedMomAlleles, mom.getLog10PError(), mom.getFilters(), mom.getAttributes(), true);
 
                 Allele dadTransmittedAllele = phasedChildGenotype.getAllele(1);
                 Allele dadUntransmittedAllele = dad.getAllele(0) != dadTransmittedAllele ? dad.getAllele(0) : dad.getAllele(1);
@@ -213,7 +213,7 @@ public class PhaseByTransmission extends RodWalker<Integer, Integer> {
                 phasedDadAlleles.add(dadTransmittedAllele);
                 phasedDadAlleles.add(dadUntransmittedAllele);
 
-                Genotype phasedDadGenotype = new Genotype(dad.getSampleName(), phasedDadAlleles, dad.getNegLog10PError(), dad.getFilters(), dad.getAttributes(), true);
+                Genotype phasedDadGenotype = new Genotype(dad.getSampleName(), phasedDadAlleles, dad.getLog10PError(), dad.getFilters(), dad.getAttributes(), true);
 
                 finalGenotypes.add(phasedMomGenotype);
                 finalGenotypes.add(phasedDadGenotype);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
index cac171948..9aa23fdfb 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
@@ -108,7 +108,7 @@ class PhasingUtils {
                 mergedAllelesForSample.add(mergedAllele);
             }
 
-            double mergedGQ = Math.max(gt1.getNegLog10PError(), gt2.getNegLog10PError());
+            double mergedGQ = Math.max(gt1.getLog10PError(), gt2.getLog10PError());
             Set<String> mergedGtFilters = new HashSet<String>(); // Since gt1 and gt2 were unfiltered, the Genotype remains unfiltered
 
             Map<String, Object> mergedGtAttribs = new HashMap<String, Object>();
@@ -121,7 +121,7 @@ class PhasingUtils {
         }
 
         String mergedName = mergeVariantContextNames(vc1.getSource(), vc2.getSource());
-        double mergedNegLog10PError = Math.max(vc1.getNegLog10PError(), vc2.getNegLog10PError());
+        double mergedLog10PError = Math.min(vc1.getLog10PError(), vc2.getLog10PError());
         Set<String> mergedFilters = new HashSet<String>(); // Since vc1 and vc2 were unfiltered, the merged record remains unfiltered
         Map<String, Object> mergedAttribs = mergeVariantContextAttributes(vc1, vc2);
 
@@ -131,7 +131,7 @@ class PhasingUtils {
         if ( vc2.hasID() ) mergedIDs.add(vc2.getID());
         String mergedID = mergedIDs.isEmpty() ? VCFConstants.EMPTY_ID_FIELD : Utils.join(VCFConstants.ID_FIELD_SEPARATOR, mergedIDs);
 
-        VariantContext mergedVc = new VariantContext(mergedName, mergedID, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles(), mergedGenotypes, mergedNegLog10PError, mergedFilters, mergedAttribs);
+        VariantContext mergedVc = new VariantContextBuilder(mergedName, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles()).id(mergedID).genotypes(mergedGenotypes).log10PError(mergedLog10PError).filters(mergedFilters).attributes(mergedAttribs).make();
 
         mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
         VariantContextUtils.calculateChromosomeCounts(mergedVc, mergedAttribs, true);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index 155b37af2..dc0acfb6a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -361,7 +361,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
             if (isUnfilteredCalledDiploidGenotype(gt)) {
                 if (gt.isHom()) { // Note that this Genotype may be replaced later to contain the PQ of a downstream het site that was phased relative to a het site lying upstream of this hom site:
                     // true <-> can trivially phase a hom site relative to ANY previous site:
-                    Genotype phasedGt = new Genotype(gt.getSampleName(), gt.getAlleles(), gt.getNegLog10PError(), gt.getFilters(), gt.getAttributes(), true);
+                    Genotype phasedGt = new Genotype(gt.getSampleName(), gt.getAlleles(), gt.getLog10PError(), gt.getFilters(), gt.getAttributes(), true);
                     uvc.setGenotype(samp, phasedGt);
                 }
                 else if (gt.isHet()) { // Attempt to phase this het genotype relative to the previous het genotype
@@ -397,7 +397,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
                             ensurePhasing(allelePair, prevAllelePair, pr.haplotype);
                             Map<String, Object> gtAttribs = new HashMap<String, Object>(gt.getAttributes());
                             gtAttribs.put(PQ_KEY, pr.phaseQuality);
-                            Genotype phasedGt = new Genotype(gt.getSampleName(), allelePair.getAllelesAsList(), gt.getNegLog10PError(), gt.getFilters(), gtAttribs, genotypesArePhased);
+                            Genotype phasedGt = new Genotype(gt.getSampleName(), allelePair.getAllelesAsList(), gt.getLog10PError(), gt.getFilters(), gtAttribs, genotypesArePhased);
                             uvc.setGenotype(samp, phasedGt);
                         }
 
@@ -417,7 +417,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
                             if (genotypesArePhased) {
                                 Map<String, Object> handledGtAttribs = new HashMap<String, Object>(handledGt.getAttributes());
                                 handledGtAttribs.put(PQ_KEY, pr.phaseQuality);
-                                Genotype phasedHomGt = new Genotype(handledGt.getSampleName(), handledGt.getAlleles(), handledGt.getNegLog10PError(), handledGt.getFilters(), handledGtAttribs, genotypesArePhased);
+                                Genotype phasedHomGt = new Genotype(handledGt.getSampleName(), handledGt.getAlleles(), handledGt.getLog10PError(), handledGt.getFilters(), handledGtAttribs, genotypesArePhased);
                                 interiorUvc.setGenotype(samp, phasedHomGt);
                             }
                         }
@@ -1123,7 +1123,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         private int stop;
         private Collection<Allele> alleles;
         private GenotypesContext genotypes;
-        private double negLog10PError;
+        private double log10PError;
         private Set<String> filters;
         private Map<String, Object> attributes;
         private String id;
@@ -1136,13 +1136,14 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
             this.stop = vc.getEnd();
             this.alleles = vc.getAlleles();
             this.genotypes = GenotypesContext.copy(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
-            this.negLog10PError = vc.getNegLog10PError();
+            this.log10PError = vc.getLog10PError();
             this.filters = vc.filtersWereApplied() ? vc.getFilters() : null;
             this.attributes = new HashMap<String, Object>(vc.getAttributes());
         }
 
         public VariantContext toVariantContext() {
-            return new VariantContext(name, id, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes);
+            return new VariantContextBuilder(name, contig, start, stop, alleles).id(id)
+                    .genotypes(genotypes).log10PError(log10PError).filters(filters).attributes(attributes).make();
         }
 
         public GenomeLoc getLocation() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/MendelianViolationEvaluator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/MendelianViolationEvaluator.java
index a0cc393d9..0cadf6c0d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/MendelianViolationEvaluator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/MendelianViolationEvaluator.java
@@ -147,7 +147,7 @@ public class MendelianViolationEvaluator extends VariantEvaluator {
     }
 
     private boolean includeGenotype(Genotype g) {
-        return g.getNegLog10PError() > getQThreshold() && g.isCalled();
+        return g.getLog10PError() > getQThreshold() && g.isCalled();
     }
 
     public static boolean isViolation(VariantContext vc, Genotype momG, Genotype dadG, Genotype childG) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
index f357f8a40..edbfb557a 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/LeftAlignVariants.java
@@ -220,6 +220,6 @@ public class LeftAlignVariants extends RodWalker<Integer, Integer> {
             newGenotypes.add(Genotype.modifyAlleles(genotype, newAlleles));
         }
 
-        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes(), refBaseForIndel);
+        return new VariantContextBuilder(vc).alleles(alleleMap.values()).genotypes(newGenotypes).referenceBaseForIndel(refBaseForIndel).make();
     }
 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToTable.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToTable.java
index 2d5f0c14f..f1f61d071 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToTable.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/VariantsToTable.java
@@ -326,7 +326,7 @@ public class VariantsToTable extends RodWalker<Integer, Integer> {
         getters.put("NCALLED", new Getter() { public String get(VariantContext vc) { return Integer.toString(vc.getNSamples() - vc.getNoCallCount()); } });
         getters.put("GQ", new Getter() { public String get(VariantContext vc) {
             if ( vc.getNSamples() > 1 ) throw new UserException("Cannot get GQ values for multi-sample VCF");
-            return String.format("%.2f", 10 * vc.getGenotype(0).getNegLog10PError());
+            return String.format("%.2f", -10 * vc.getGenotype(0).getLog10PError());
         }});
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index 0f21e1505..abd81fe61 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -272,7 +272,7 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
 
         String ref = getCachedString(parts[3].toUpperCase());
         String alts = getCachedString(parts[4].toUpperCase());
-        builder.negLog10PError(parseQual(parts[5]));
+        builder.log10PError(parseQual(parts[5]));
         builder.filters(parseFilters(getCachedString(parts[6])));
         builder.attributes(parseInfo(parts[7]));
 
@@ -448,16 +448,16 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
     protected static Double parseQual(String qualString) {
         // if we're the VCF 4 missing char, return immediately
         if ( qualString.equals(VCFConstants.MISSING_VALUE_v4))
-            return VariantContext.NO_NEG_LOG_10PERROR;
+            return VariantContext.NO_LOG10_PERROR;
 
         Double val = Double.valueOf(qualString);
 
         // check to see if they encoded the missing qual score in VCF 3 style, with either the -1 or -1.0.  check for val < 0 to save some CPU cycles
         if ((val < 0) && (Math.abs(val - VCFConstants.MISSING_QUALITY_v3_DOUBLE) < VCFConstants.VCF_ENCODING_EPSILON))
-            return VariantContext.NO_NEG_LOG_10PERROR;
+            return VariantContext.NO_LOG10_PERROR;
 
         // scale and return the value
-        return val / 10.0;
+        return val / -10.0;
     }
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
index 37137f716..1aafafc27 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
@@ -204,7 +204,7 @@ public class StandardVCFWriter extends IndexingVCFWriter {
             mWriter.write(VCFConstants.FIELD_SEPARATOR);
 
             // QUAL
-            if ( !vc.hasNegLog10PError() )
+            if ( !vc.hasLog10PError() )
                 mWriter.write(VCFConstants.MISSING_VALUE_v4);
             else
                 mWriter.write(getQualValue(vc.getPhredScaledQual()));
@@ -353,7 +353,7 @@ public class StandardVCFWriter extends IndexingVCFWriter {
 
                 // some exceptions
                 if ( key.equals(VCFConstants.GENOTYPE_QUALITY_KEY) ) {
-                    if ( Math.abs(g.getNegLog10PError() - Genotype.NO_NEG_LOG_10PERROR) < 1e-6)
+                    if ( Math.abs(g.getLog10PError() + Genotype.NO_LOG10_PERROR) < 1e-6)
                         val = VCFConstants.MISSING_VALUE_v4;
                     else {
                         val = getQualValue(Math.min(g.getPhredScaledQual(), VCFConstants.MAX_GENOTYPE_QUAL));
@@ -447,7 +447,7 @@ public class StandardVCFWriter extends IndexingVCFWriter {
             keys.addAll(g.getAttributes().keySet());
             if ( g.isAvailable() )
                 sawGoodGT = true;
-            if ( g.hasNegLog10PError() )
+            if ( g.hasLog10PError() )
                 sawGoodQual = true;
             if (g.isFiltered() && g.isCalled())
                 sawGenotypeFilter = true;
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
index 971400ca0..7d71a9c5a 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
@@ -139,7 +139,7 @@ public class VCF3Codec extends AbstractVCFCodec {
         for (int genotypeOffset = 1; genotypeOffset < nParts; genotypeOffset++) {
             int GTValueSplitSize = ParsingUtils.split(genotypeParts[genotypeOffset], GTValueArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
 
-            double GTQual = VariantContext.NO_NEG_LOG_10PERROR;
+            double GTQual = VariantContext.NO_LOG10_PERROR;
             Set<String> genotypeFilters = null;
             Map<String, Object> gtAttributes = null;
             String sampleName = sampleNameIterator.next();
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
index 42c224fe9..b7b7eb5f7 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
@@ -166,7 +166,7 @@ public class VCFCodec extends AbstractVCFCodec {
         for (int genotypeOffset = 1; genotypeOffset < nParts; genotypeOffset++) {
             int GTValueSplitSize = ParsingUtils.split(genotypeParts[genotypeOffset], GTValueArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
 
-            double GTQual = VariantContext.NO_NEG_LOG_10PERROR;
+            double GTQual = VariantContext.NO_LOG10_PERROR;
             Set<String> genotypeFilters = null;
             Map<String, Object> gtAttributes = null;
             String sampleName = sampleNameIterator.next();
diff --git a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
index b8672a7bd..e754c215d 100644
--- a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
+++ b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
@@ -27,10 +27,7 @@ package org.broadinstitute.sting.utils.gcf;
 import org.broadinstitute.sting.utils.codecs.vcf.StandardVCFWriter;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.*;
 import java.util.*;
@@ -72,7 +69,7 @@ public class GCF {
             alleleOffsets[i+1] = GCFHeaderBuilder.encodeAllele(vc.getAlternateAllele(i));
         }
 
-        qual = (float)vc.getNegLog10PError(); //qualToByte(vc.getPhredScaledQual());
+        qual = (float)vc.getLog10PError(); //qualToByte(vc.getPhredScaledQual());
         info = infoFieldString(vc, GCFHeaderBuilder);
         filterOffset = GCFHeaderBuilder.encodeString(StandardVCFWriter.getFilterString(vc));
 
@@ -142,14 +139,14 @@ public class GCF {
     public VariantContext decode(final String source, final GCFHeader header) {
         final String contig = header.getString(chromOffset);
         alleleMap = header.getAlleles(alleleOffsets);
-        double negLog10PError = qual; // QualityUtils.qualToErrorProb(qual);
-        Set<String> filters = header.getFilters(filterOffset);
-        Map<String, Object> attributes = new HashMap<String, Object>();
-        attributes.put("INFO", info);
-        Byte refPadByte = refPad == 0 ? null : refPad;
-        GenotypesContext genotypes = decodeGenotypes(header);
 
-        return new VariantContext(source, VCFConstants.EMPTY_ID_FIELD, contig, start, stop, alleleMap, genotypes, negLog10PError, filters, attributes, refPadByte);
+        VariantContextBuilder builder = new VariantContextBuilder(source, contig, start, stop, alleleMap);
+        builder.genotypes(decodeGenotypes(header));
+        builder.log10PError(qual);
+        builder.filters(header.getFilters(filterOffset));
+        builder.attribute("INFO", info);
+        builder.referenceBaseForIndel(refPad == 0 ? null : refPad);
+        return builder.make();
     }
 
     private GenotypesContext decodeGenotypes(final GCFHeader header) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/gcf/GCFGenotype.java b/public/java/src/org/broadinstitute/sting/utils/gcf/GCFGenotype.java
index dd1fb091c..f8fdd9291 100644
--- a/public/java/src/org/broadinstitute/sting/utils/gcf/GCFGenotype.java
+++ b/public/java/src/org/broadinstitute/sting/utils/gcf/GCFGenotype.java
@@ -84,14 +84,14 @@ public class GCFGenotype {
 
     public Genotype decode(final String sampleName, final GCFHeader header, GCF GCF, List<Allele> alleleIndex) {
         final List<Allele> alleles = decodeAlleles(gt, alleleIndex);
-        final double negLog10PError = gq / 10.0;
+        final double log10PError = gq / -10.0;
         final Set<String> filters = Collections.emptySet();
         final Map<String, Object> attributes = new HashMap<String, Object>();
         attributes.put("DP", dp);
         attributes.put("AD", ad);
         attributes.put("PL", pl);
 
-        return new Genotype(sampleName, alleles, negLog10PError, filters, attributes, false);
+        return new Genotype(sampleName, alleles, log10PError, filters, attributes, false);
     }
 
     private static int encodeAlleles(List<Allele> gtList, List<Allele> allAlleles) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
index 4ffc8e966..d3cc7d6a5 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
@@ -12,19 +12,19 @@ import java.util.*;
  * @author depristo
  */
 final class CommonInfo {
-    public static final double NO_NEG_LOG_10PERROR = -1.0;
+    public static final double NO_LOG10_PERROR = 1.0;
 
     private static Set<String> NO_FILTERS = Collections.emptySet();
     private static Map<String, Object> NO_ATTRIBUTES = Collections.unmodifiableMap(new HashMap<String, Object>());
 
-    private double negLog10PError = NO_NEG_LOG_10PERROR;
+    private double log10PError = NO_LOG10_PERROR;
     private String name = null;
     private Set<String> filters = null;
     private Map<String, Object> attributes = NO_ATTRIBUTES;
 
-    public CommonInfo(String name, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
+    public CommonInfo(String name, double log10PError, Set<String> filters, Map<String, Object> attributes) {
         this.name = name;
-        setNegLog10PError(negLog10PError);
+        setLog10PError(log10PError);
         if ( filters != null && ! filters.isEmpty() )
             this.filters = filters;
         if ( attributes != null && ! attributes.isEmpty() ) {
@@ -97,22 +97,21 @@ final class CommonInfo {
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    public boolean hasNegLog10PError() {
-        return getNegLog10PError() != NO_NEG_LOG_10PERROR;
+    public boolean hasLog10PError() {
+        return getLog10PError() != NO_LOG10_PERROR;
     }
 
     /**
      * @return the -1 * log10-based error estimate
      */
-    public double getNegLog10PError() { return negLog10PError; }
-    public double getPhredScaledQual() { return getNegLog10PError() * 10; }
+    public double getLog10PError() { return log10PError; }
+    public double getPhredScaledQual() { return getLog10PError() * -10; }
 
-    public void setNegLog10PError(double negLog10PError) {
-        if ( negLog10PError < 0 && negLog10PError != NO_NEG_LOG_10PERROR ) throw new IllegalArgumentException("BUG: negLog10PError cannot be < than 0 : " + negLog10PError);
-        if ( Double.isInfinite(negLog10PError) ) throw new IllegalArgumentException("BUG: negLog10PError should not be Infinity");
-        if ( Double.isNaN(negLog10PError) ) throw new IllegalArgumentException("BUG: negLog10PError should not be NaN");
-
-        this.negLog10PError = negLog10PError;
+    public void setLog10PError(double log10PError) {
+        if ( this.log10PError > 0 && this.log10PError != NO_LOG10_PERROR) throw new IllegalArgumentException("BUG: log10PError cannot be > 0 : " + this.log10PError);
+        if ( Double.isInfinite(this.log10PError) ) throw new IllegalArgumentException("BUG: log10PError should not be Infinity");
+        if ( Double.isNaN(this.log10PError) ) throw new IllegalArgumentException("BUG: log10PError should not be NaN");
+        this.log10PError = log10PError;
     }
 
     // ---------------------------------------------------------------------------------------------------------
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
index f1574cec2..b100d6da5 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
@@ -18,20 +18,20 @@ public class Genotype {
     public final static String UNPHASED_ALLELE_SEPARATOR = "/";
 
     protected CommonInfo commonInfo;
-    public final static double NO_NEG_LOG_10PERROR = CommonInfo.NO_NEG_LOG_10PERROR;
+    public final static double NO_LOG10_PERROR = CommonInfo.NO_LOG10_PERROR;
     protected List<Allele> alleles = null; // new ArrayList<Allele>();
     protected Type type = null;
 
     protected boolean isPhased = false;
 
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, boolean isPhased) {
-        this(sampleName, alleles, negLog10PError, filters, attributes, isPhased, null);
+    public Genotype(String sampleName, List<Allele> alleles, double log10PError, Set<String> filters, Map<String, Object> attributes, boolean isPhased) {
+        this(sampleName, alleles, log10PError, filters, attributes, isPhased, null);
     }
 
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, Set<String> filters, Map<String, Object> attributes, boolean isPhased, double[] log10Likelihoods) {
+    public Genotype(String sampleName, List<Allele> alleles, double log10PError, Set<String> filters, Map<String, Object> attributes, boolean isPhased, double[] log10Likelihoods) {
         if ( alleles != null )
             this.alleles = Collections.unmodifiableList(alleles);
-        commonInfo = new CommonInfo(sampleName, negLog10PError, filters, attributes);
+        commonInfo = new CommonInfo(sampleName, log10PError, filters, attributes);
         if ( log10Likelihoods != null )
             commonInfo.putAttribute(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY, GenotypeLikelihoods.fromLog10Likelihoods(log10Likelihoods));
         this.isPhased = isPhased;
@@ -42,23 +42,23 @@ public class Genotype {
      * Creates a new Genotype for sampleName with genotype according to alleles.
      * @param sampleName
      * @param alleles
-     * @param negLog10PError the confidence in these alleles
+     * @param log10PError the confidence in these alleles
      * @param log10Likelihoods a log10 likelihoods for each of the genotype combinations possible for alleles, in the standard VCF ordering, or null if not known
      */
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError, double[] log10Likelihoods) {
-        this(sampleName, alleles, negLog10PError, null, null, false, log10Likelihoods);
+    public Genotype(String sampleName, List<Allele> alleles, double log10PError, double[] log10Likelihoods) {
+        this(sampleName, alleles, log10PError, null, null, false, log10Likelihoods);
     }
 
-    public Genotype(String sampleName, List<Allele> alleles, double negLog10PError) {
-        this(sampleName, alleles, negLog10PError, null, null, false);
+    public Genotype(String sampleName, List<Allele> alleles, double log10PError) {
+        this(sampleName, alleles, log10PError, null, null, false);
     }
 
     public Genotype(String sampleName, List<Allele> alleles) {
-        this(sampleName, alleles, NO_NEG_LOG_10PERROR, null, null, false);
+        this(sampleName, alleles, NO_LOG10_PERROR, null, null, false);
     }
 
     public Genotype(String sampleName, Genotype parent) {
-        this(sampleName, parent.getAlleles(), parent.getNegLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
+        this(sampleName, parent.getAlleles(), parent.getLog10PError(), parent.getFilters(), parent.getAttributes(), parent.isPhased());
     }
 
 
@@ -70,15 +70,15 @@ public class Genotype {
     // ---------------------------------------------------------------------------------------------------------
 
     public static Genotype modifyName(Genotype g, String name) {
-        return new Genotype(name, g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, g.getAttributes(), g.isPhased());
+        return new Genotype(name, g.getAlleles(), g.getLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, g.getAttributes(), g.isPhased());
     }
 
     public static Genotype modifyAttributes(Genotype g, Map<String, Object> attributes) {
-        return new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attributes, g.isPhased());
+        return new Genotype(g.getSampleName(), g.getAlleles(), g.getLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attributes, g.isPhased());
     }
 
     public static Genotype modifyAlleles(Genotype g, List<Allele> alleles) {
-        return new Genotype(g.getSampleName(), alleles, g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, g.getAttributes(), g.isPhased());
+        return new Genotype(g.getSampleName(), alleles, g.getLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, g.getAttributes(), g.isPhased());
     }
 
     /**
@@ -335,8 +335,8 @@ public class Genotype {
     public boolean isFiltered()         { return commonInfo.isFiltered(); }
     public boolean isNotFiltered()      { return commonInfo.isNotFiltered(); }
     public boolean filtersWereApplied() { return commonInfo.filtersWereApplied(); }
-    public boolean hasNegLog10PError()  { return commonInfo.hasNegLog10PError(); }
-    public double getNegLog10PError()   { return commonInfo.getNegLog10PError(); }
+    public boolean hasLog10PError()     { return commonInfo.hasLog10PError(); }
+    public double getLog10PError()      { return commonInfo.getLog10PError(); }
     public double getPhredScaledQual()  { return commonInfo.getPhredScaledQual(); }
 
     public Map<String, Object> getAttributes()  { return commonInfo.getAttributes(); }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 9875680b0..ad9ecace8 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -164,7 +164,7 @@ import java.util.*;
  */
 public class VariantContext implements Feature { // to enable tribble intergration
     protected CommonInfo commonInfo = null;
-    public final static double NO_NEG_LOG_10PERROR = CommonInfo.NO_NEG_LOG_10PERROR;
+    public final static double NO_LOG10_PERROR = CommonInfo.NO_LOG10_PERROR;
     public final static String UNPARSED_GENOTYPE_MAP_KEY = "_UNPARSED_GENOTYPE_MAP_";
     public final static String UNPARSED_GENOTYPE_PARSER_KEY = "_UNPARSED_GENOTYPE_PARSER_";
 
@@ -235,7 +235,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param stop            the stop reference base (one based)
      * @param alleles         alleles
      * @param genotypes       genotypes map
-     * @param negLog10PError  qual
+     * @param log10PError     qual
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
@@ -243,29 +243,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @deprecated  replaced by {@link VariantContextBuilder}
      */
     @Deprecated
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
-        this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, referenceBaseForIndel, false, ALL_VALIDATION);
-    }
-
-
-    /**
-     * the complete constructor.  Makes a complete VariantContext from its arguments
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles         alleles
-     * @param genotypes       genotypes map
-     * @param negLog10PError  qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     *
-     * @deprecated  replaced by {@link VariantContextBuilder}
-     */
-    @Deprecated
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double negLog10PError, Set<String> filters, Map<String, Object> attributes) {
-        this(source, ID, contig, start, stop, alleles, genotypes, negLog10PError, filters, attributes, null, false, ALL_VALIDATION);
+    protected VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double log10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
+        this(source, ID, contig, start, stop, alleles, genotypes, log10PError, filters, attributes, referenceBaseForIndel, false, ALL_VALIDATION);
     }
 
     /**
@@ -281,7 +260,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      */
     @Deprecated
     public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles) {
-        this(source, ID, contig, start, stop, alleles, NO_GENOTYPES, CommonInfo.NO_NEG_LOG_10PERROR, null, null, null, false, ALL_VALIDATION);
+        this(source, ID, contig, start, stop, alleles, NO_GENOTYPES, CommonInfo.NO_LOG10_PERROR, null, null, null, false, ALL_VALIDATION);
     }
 
     /**
@@ -290,7 +269,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param other the VariantContext to copy
      */
     protected VariantContext(VariantContext other) {
-        this(other.getSource(), other.getID(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getNegLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, NO_VALIDATION);
+        this(other.getSource(), other.getID(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, NO_VALIDATION);
     }
 
     /**
@@ -302,7 +281,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param stop            the stop reference base (one based)
      * @param alleles         alleles
      * @param genotypes       genotypes map
-     * @param negLog10PError  qual
+     * @param log10PError  qual
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
@@ -312,7 +291,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     protected VariantContext(String source, String ID,
                            String contig, long start, long stop,
                            Collection<Allele> alleles, GenotypesContext genotypes,
-                           double negLog10PError, Set<String> filters, Map<String, Object> attributes,
+                           double log10PError, Set<String> filters, Map<String, Object> attributes,
                            Byte referenceBaseForIndel, boolean genotypesAreUnparsed,
                            EnumSet<Validation> validationToPerform ) {
         if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
@@ -335,7 +314,7 @@ public class VariantContext implements Feature { // to enable tribble intergrati
             }
         }
 
-        this.commonInfo = new CommonInfo(source, negLog10PError, filters, attributes);
+        this.commonInfo = new CommonInfo(source, log10PError, filters, attributes);
         REFERENCE_BASE_FOR_INDEL = referenceBaseForIndel;
 
         // todo -- remove me when this check is no longer necessary
@@ -600,8 +579,8 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     public boolean isFiltered()                 { return commonInfo.isFiltered(); }
     public boolean isNotFiltered()              { return commonInfo.isNotFiltered(); }
     public boolean filtersWereApplied()         { return commonInfo.filtersWereApplied(); }
-    public boolean hasNegLog10PError()          { return commonInfo.hasNegLog10PError(); }
-    public double getNegLog10PError()           { return commonInfo.getNegLog10PError(); }
+    public boolean hasLog10PError()             { return commonInfo.hasLog10PError(); }
+    public double getLog10PError()              { return commonInfo.getLog10PError(); }
     public double getPhredScaledQual()          { return commonInfo.getPhredScaledQual(); }
 
     public Map<String, Object>  getAttributes() { return commonInfo.getAttributes(); }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
index a2065d458..cb2ef4678 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
@@ -29,8 +29,6 @@ import org.broad.tribble.Feature;
 import org.broad.tribble.TribbleException;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFParser;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 
 import java.util.*;
 
@@ -69,7 +67,7 @@ public class VariantContextBuilder {
     // optional -> these are set to the appropriate default value
     private String ID = VCFConstants.EMPTY_ID_FIELD;
     private GenotypesContext genotypes = GenotypesContext.NO_GENOTYPES;
-    private double negLog10PError = VariantContext.NO_NEG_LOG_10PERROR;
+    private double log10PError = VariantContext.NO_LOG10_PERROR;
     private Set<String> filters = null;
     private Map<String, Object> attributes = null;
     private boolean attributesCanBeModified = false;
@@ -116,7 +114,7 @@ public class VariantContextBuilder {
         this.genotypes = parent.genotypes;
         this.genotypesAreUnparsed = parent.hasAttribute(VariantContext.UNPARSED_GENOTYPE_MAP_KEY);
         this.ID = parent.getID();
-        this.negLog10PError = parent.getNegLog10PError();
+        this.log10PError = parent.getLog10PError();
         this.referenceBaseForIndel = parent.getReferenceBaseForIndel();
         this.source = parent.getSource();
         this.start = parent.getStart();
@@ -279,13 +277,13 @@ public class VariantContextBuilder {
     }
 
     /**
-     * Tells us that the resulting VariantContext should have negLog10PError
-     * @param negLog10PError
+     * Tells us that the resulting VariantContext should have log10PError
+     * @param log10PError
      * @return
      */
-    @Requires("negLog10PError >= 0 || negLog10PError == VariantContext.NO_NEG_LOG_10PERROR")
-    public VariantContextBuilder negLog10PError(final double negLog10PError) {
-        this.negLog10PError = negLog10PError;
+    @Requires("log10PError <= 0 || log10PError == VariantContext.NO_LOG10_PERROR")
+    public VariantContextBuilder log10PError(final double log10PError) {
+        this.log10PError = log10PError;
         return this;
     }
 
@@ -374,7 +372,7 @@ public class VariantContextBuilder {
      */
     public VariantContext make() {
         return new VariantContext(source, ID, contig, start, stop, alleles,
-                genotypes, negLog10PError, filters, attributes,
+                genotypes, log10PError, filters, attributes,
                 referenceBaseForIndel, genotypesAreUnparsed, toValidate);
     }
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 972f70689..12b2ce406 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -113,7 +113,7 @@ public class VariantContextUtils {
         Map<String, Object> attrs = new HashMap<String, Object>(g.getAttributes());
         attrs.remove(VCFConstants.PHRED_GENOTYPE_LIKELIHOODS_KEY);
         attrs.remove(VCFConstants.GENOTYPE_LIKELIHOODS_KEY);
-        return new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attrs, g.isPhased());
+        return new Genotype(g.getSampleName(), g.getAlleles(), g.getLog10PError(), g.filtersWereApplied() ? g.getFilters() : null, attrs, g.isPhased());
     }
 
     public static VariantContext createVariantContextWithPaddedAlleles(VariantContext inputVC, boolean refBaseShouldBeAppliedToEndOfAlleles) {
@@ -178,14 +178,12 @@ public class VariantContextUtils {
                         newGenotypeAlleles.add(Allele.NO_CALL);
                     }
                 }
-                genotypes.add(new Genotype(g.getSampleName(), newGenotypeAlleles, g.getNegLog10PError(),
+                genotypes.add(new Genotype(g.getSampleName(), newGenotypeAlleles, g.getLog10PError(),
                         g.getFilters(), g.getAttributes(), g.isPhased()));
 
             }
 
-            // Do not change the filter state if filters were not applied to this context
-            Set<String> inputVCFilters = inputVC.getFiltersMaybeNull();
-            return new VariantContext(inputVC.getSource(), inputVC.getID(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVCFilters, inputVC.getAttributes(),refByte);
+            return new VariantContextBuilder(inputVC).alleles(alleles).genotypes(genotypes).make();
         }
         else
             return inputVC;
@@ -373,12 +371,12 @@ public class VariantContextUtils {
         final GenotypesContext genotypes = GenotypesContext.create(vc.getNSamples());
         for ( final Genotype g : vc.getGenotypes() ) {
             Map<String, Object> genotypeAttributes = subsetAttributes(g.commonInfo, keysToPreserve);
-            genotypes.add(new Genotype(g.getSampleName(), g.getAlleles(), g.getNegLog10PError(), g.getFilters(),
+            genotypes.add(new Genotype(g.getSampleName(), g.getAlleles(), g.getLog10PError(), g.getFilters(),
                     genotypeAttributes, g.isPhased()));
         }
 
         return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(),
-                vc.getAlleles(), genotypes, vc.getNegLog10PError(), vc.getFilters(), attributes, vc.getReferenceBaseForIndel());
+                vc.getAlleles(), genotypes, vc.getLog10PError(), vc.getFilters(), attributes, vc.getReferenceBaseForIndel());
     }
 
     public enum GenotypeMergeType {
@@ -475,7 +473,7 @@ public class VariantContextUtils {
         int depth = 0;
         int maxAC = -1;
         final Map<String, Object> attributesWithMaxAC = new TreeMap<String, Object>();
-        double negLog10PError = -1;
+        double log10PError = 1;
         VariantContext vcWithMaxAC = null;
         Set<String> addedSamples = new HashSet<String>(first.getNSamples());
         GenotypesContext genotypes = GenotypesContext.create();
@@ -504,7 +502,7 @@ public class VariantContextUtils {
 
             mergeGenotypes(genotypes, addedSamples, vc, alleleMapping, genotypeMergeOptions == GenotypeMergeType.UNIQUIFY);
 
-            negLog10PError = Math.max(negLog10PError, vc.isVariant() ? vc.getNegLog10PError() : -1);
+            log10PError = Math.min(log10PError, vc.isVariant() ? vc.getLog10PError() : 1);
 
             filters.addAll(vc.getFilters());
 
@@ -610,10 +608,15 @@ public class VariantContextUtils {
 
         final String ID = rsIDs.isEmpty() ? VCFConstants.EMPTY_ID_FIELD : Utils.join(",", rsIDs);
 
-        VariantContext merged = new VariantContext(name, ID, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, negLog10PError, filters, (mergeInfoWithMaxAC ? attributesWithMaxAC : attributes) );
-        // Trim the padded bases of all alleles if necessary
-        merged = createVariantContextWithTrimmedAlleles(merged);
+        final VariantContextBuilder builder = new VariantContextBuilder().source(name).id(ID);
+        builder.loc(loc.getContig(), loc.getStart(), loc.getStop());
+        builder.alleles(alleles);
+        builder.genotypes(genotypes);
+        builder.log10PError(log10PError);
+        builder.filters(filters).attributes(mergeInfoWithMaxAC ? attributesWithMaxAC : attributes);
 
+        // Trim the padded bases of all alleles if necessary
+        VariantContext merged = createVariantContextWithTrimmedAlleles(builder.make());
         if ( printMessages && remapped ) System.out.printf("Remapped => %s%n", merged);
         return merged;
     }
@@ -648,6 +651,7 @@ public class VariantContextUtils {
 
         return true;
     }
+
     public static VariantContext createVariantContextWithTrimmedAlleles(VariantContext inputVC) {
         // see if we need to trim common reference base from all alleles
         boolean trimVC;
@@ -713,8 +717,9 @@ public class VariantContextUtils {
                 genotypes.add(Genotype.modifyAlleles(genotype, trimmedAlleles));
 
             }
-            return new VariantContext(inputVC.getSource(), inputVC.getID(), inputVC.getChr(), inputVC.getStart(), inputVC.getEnd(), alleles, genotypes, inputVC.getNegLog10PError(), inputVC.filtersWereApplied() ? inputVC.getFilters() : null, attributes, new Byte(inputVC.getReference().getBases()[0]));
 
+            final VariantContextBuilder builder = new VariantContextBuilder(inputVC);
+            return builder.alleles(alleles).genotypes(genotypes).attributes(attributes).referenceBaseForIndel(new Byte(inputVC.getReference().getBases()[0])).make();
         }
 
         return inputVC;
@@ -910,7 +915,7 @@ public class VariantContextUtils {
 
                 if ( uniqifySamples || alleleMapping.needsRemapping() ) {
                     final List<Allele> alleles = alleleMapping.needsRemapping() ? alleleMapping.remap(g.getAlleles()) : g.getAlleles();
-                    newG = new Genotype(name, alleles, g.getNegLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased());
+                    newG = new Genotype(name, alleles, g.getLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased());
                 }
 
                 mergedGenotypes.add(newG);
@@ -954,8 +959,7 @@ public class VariantContextUtils {
             newGenotypes.add(Genotype.modifyAlleles(genotype, newAlleles));
         }
 
-        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(), alleleMap.values(), newGenotypes, vc.getNegLog10PError(), vc.filtersWereApplied() ? vc.getFilters() : null, vc.getAttributes());
-
+        return new VariantContextBuilder(vc).alleles(alleleMap.values()).genotypes(newGenotypes).make();
     }
 
     public static VariantContext purgeUnallowedGenotypeAttributes(VariantContext vc, Set<String> allowedAttributes) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContext.java
index a59ed7abe..ccce21f52 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContext.java
@@ -64,7 +64,7 @@ class VariantJEXLContext implements JexlContext {
         x.put("CHROM",   new AttributeGetter() { public Object get(VariantContext vc) { return vc.getChr(); }});
         x.put("POS",     new AttributeGetter() { public Object get(VariantContext vc) { return vc.getStart(); }});
         x.put("TYPE",    new AttributeGetter() { public Object get(VariantContext vc) { return vc.getType().toString(); }});
-        x.put("QUAL",    new AttributeGetter() { public Object get(VariantContext vc) { return 10 * vc.getNegLog10PError(); }});
+        x.put("QUAL",    new AttributeGetter() { public Object get(VariantContext vc) { return -10 * vc.getLog10PError(); }});
         x.put("ALLELES", new AttributeGetter() { public Object get(VariantContext vc) { return vc.getAlleles(); }});
         x.put("N_ALLELES", new AttributeGetter() { public Object get(VariantContext vc) { return vc.getNAlleles(); }});
         x.put("FILTER",    new AttributeGetter() { public Object get(VariantContext vc) { return vc.isFiltered() ? "1" : "0"; }});
diff --git a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
index 4b21e09e3..96a33b738 100644
--- a/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/genotype/vcf/VCFWriterUnitTest.java
@@ -2,10 +2,7 @@ package org.broadinstitute.sting.utils.genotype.vcf;
 
 import org.broad.tribble.Tribble;
 import org.broad.tribble.readers.AsciiLineReader;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 import org.broadinstitute.sting.utils.codecs.vcf.*;
 import org.broadinstitute.sting.utils.exceptions.UserException;
 import org.testng.Assert;
@@ -136,9 +133,8 @@ public class VCFWriterUnitTest extends BaseTest {
             genotypes.add(gt);
             
         }
-        return new VariantContext("RANDOM", VCFConstants.EMPTY_ID_FIELD, loc.getContig(), loc.getStart(), loc.getStop(), alleles, genotypes, 0, filters, attributes, (byte)'A');
-
-
+        return new VariantContextBuilder("RANDOM", loc.getContig(), loc.getStart(), loc.getStop(), alleles)
+                .genotypes(genotypes).attributes(attributes).referenceBaseForIndel((byte)'A').make();
     }
 
 
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypeUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypeUnitTest.java
index c4f1efd04..e0a037105 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypeUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypeUnitTest.java
@@ -71,8 +71,8 @@ public class GenotypeUnitTest extends BaseTest {
 //    public boolean sameGenotype(Genotype other)
 //    public boolean sameGenotype(Genotype other, boolean ignorePhase)
 //    public String getSampleName()
-//    public boolean hasNegLog10PError()
-//    public double getNegLog10PError()
+//    public boolean hasLog10PError()
+//    public double getLog10PError()
 //    public double getPhredScaledQual()
 //    public boolean hasAttribute(String key)
 //    public Object getAttribute(String key)
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
index 6bc71a76d..a71949369 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextBenchmark.java
@@ -356,7 +356,7 @@ public class VariantContextBenchmark extends SimpleBenchmark {
 //                            for ( final org.broadinstitute.sting.utils.variantcontext.v13.Genotype g : vc.getGenotypes().values() ) {
 //                                String name = g.getSampleName()+"_"+i;
 //                                gc.put(name, new org.broadinstitute.sting.utils.variantcontext.v13.Genotype(name,
-//                                        g.getAlleles(), g.getNegLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased(), g.getLikelihoods().getAsVector()));
+//                                        g.getAlleles(), g.getLog10PError(), g.getFilters(), g.getAttributes(), g.isPhased(), g.getLikelihoods().getAsVector()));
 //                                toMerge.add(org.broadinstitute.sting.utils.variantcontext.v13.VariantContext.modifyGenotypes(vc, gc));
 //                            }
 //                        }
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index 200f3859b..cdbadbbb6 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -91,45 +91,45 @@ public class VariantContextUnitTest extends BaseTest {
 
         // test INDELs
         alleles = Arrays.asList(Aref, ATC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(Tref, TA, TC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A, AC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A, Allele.create("ATCTC"));
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         // test MIXED
         alleles = Arrays.asList(TAref, T, TC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(TAref, T, AC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(ACref, ATC, AT);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(Aref, T, symbolic);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         // test SYMBOLIC
         alleles = Arrays.asList(Tref, symbolic);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
         Assert.assertEquals(vc.getType(), VariantContext.Type.SYMBOLIC);
     }
 
@@ -200,7 +200,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingDeletionVariantContext() {
         List<Allele> alleles = Arrays.asList(ATCref, del);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, delLoc, delLocStart, delLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, delLoc, delLocStart, delLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getChr(), delLoc);
         Assert.assertEquals(vc.getStart(), delLocStart);
@@ -227,7 +227,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingInsertionVariantContext() {
         List<Allele> alleles = Arrays.asList(delRef, ATC);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getChr(), insLoc);
         Assert.assertEquals(vc.getStart(), insLocStart);
@@ -550,7 +550,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test(dataProvider = "getAlleles")
     public void testMergeAlleles(GetAllelesTest cfg) {
         final List<Allele> altAlleles = cfg.alleles.subList(1, cfg.alleles.size());
-        final VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, cfg.alleles, null, CommonInfo.NO_NEG_LOG_10PERROR, null, null, (byte)'A');
+        final VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, cfg.alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
 
         Assert.assertEquals(vc.getAlleles(), cfg.alleles, "VC alleles not the same as input alleles");
         Assert.assertEquals(vc.getNAlleles(), cfg.alleles.size(), "VC getNAlleles not the same as input alleles size");
@@ -653,7 +653,7 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertEquals(cfg.vc.getAttributes(), cfg.copy.getAttributes());
         Assert.assertEquals(cfg.vc.getID(), cfg.copy.getID());
         Assert.assertEquals(cfg.vc.getGenotypes(), cfg.copy.getGenotypes());
-        Assert.assertEquals(cfg.vc.getNegLog10PError(), cfg.copy.getNegLog10PError());
+        Assert.assertEquals(cfg.vc.getLog10PError(), cfg.copy.getLog10PError());
         Assert.assertEquals(cfg.vc.getFilters(), cfg.copy.getFilters());
     }
 
@@ -705,7 +705,7 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertEquals(sub.getChr(), vc.getChr());
         Assert.assertEquals(sub.getStart(), vc.getStart());
         Assert.assertEquals(sub.getEnd(), vc.getEnd());
-        Assert.assertEquals(sub.getNegLog10PError(), vc.getNegLog10PError());
+        Assert.assertEquals(sub.getLog10PError(), vc.getLog10PError());
         Assert.assertEquals(sub.getFilters(), vc.getFilters());
         Assert.assertEquals(sub.getID(), vc.getID());
         Assert.assertEquals(sub.getReferenceBaseForIndel(), vc.getReferenceBaseForIndel());
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index a48596ca1..7857c66fc 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -525,7 +525,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
             Genotype expectedValue = expected.get(value.getSampleName());
 
             Assert.assertEquals(value.alleles, expectedValue.alleles, "Alleles in Genotype aren't equal");
-            Assert.assertEquals(value.getNegLog10PError(), expectedValue.getNegLog10PError(), "GQ values aren't equal");
+            Assert.assertEquals(value.getLog10PError(), expectedValue.getLog10PError(), "GQ values aren't equal");
             Assert.assertEquals(value.hasLikelihoods(), expectedValue.hasLikelihoods(), "Either both have likelihoods or both not");
             if ( value.hasLikelihoods() )
                 Assert.assertEquals(value.getLikelihoods().getAsVector(), expectedValue.getLikelihoods().getAsVector(), "Genotype likelihoods aren't equal");

From f685fff79b3e07b430cbfa411775b8a7c422b8f9 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Fri, 18 Nov 2011 21:32:43 -0500
Subject: [PATCH 069/113] Killing the final versions of old new VariantContext
 interface

---
 .../beagle/BeagleOutputToVCFWalker.java       |  4 +-
 .../utils/variantcontext/VariantContext.java  | 38 ----------
 .../variantcontext/VariantContextUtils.java   |  3 +-
 .../refdata/RefMetaDataTrackerUnitTest.java   |  6 +-
 .../VariantContextUnitTest.java               | 69 ++++++++++---------
 .../VariantContextUtilsUnitTest.java          |  3 +-
 .../VariantJEXLContextUnitTest.java           |  2 +-
 7 files changed, 46 insertions(+), 79 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index b95b35b4a..64c4948ff 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -122,7 +122,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
     protected static String line = null;
 
     private final double MIN_PROB_ERROR = 0.000001;
-    private final double MAX_GENOTYPE_QUALITY = 6.0;
+    private final double MAX_GENOTYPE_QUALITY = -6.0;
 
     public void initialize() {
 
@@ -292,7 +292,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
             if (probWrongGenotype < MIN_PROB_ERROR)
                 genotypeQuality = MAX_GENOTYPE_QUALITY;
             else
-                genotypeQuality = -log10(probWrongGenotype);
+                genotypeQuality = log10(probWrongGenotype);
 
             HashMap<String,Object> originalAttributes = new HashMap<String,Object>(g.getAttributes());
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index ad9ecace8..5ad734b79 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -225,44 +225,6 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    /**
-     * the complete constructor.  Makes a complete VariantContext from its arguments
-     * This is the only constructor that is able to create indels! DO NOT USE THE OTHER ONES.
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles         alleles
-     * @param genotypes       genotypes map
-     * @param log10PError     qual
-     * @param filters         filters: use null for unfiltered and empty set for passes filters
-     * @param attributes      attributes
-     * @param referenceBaseForIndel   padded reference base
-     *
-     * @deprecated  replaced by {@link VariantContextBuilder}
-     */
-    @Deprecated
-    protected VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles, GenotypesContext genotypes, double log10PError, Set<String> filters, Map<String, Object> attributes, Byte referenceBaseForIndel) {
-        this(source, ID, contig, start, stop, alleles, genotypes, log10PError, filters, attributes, referenceBaseForIndel, false, ALL_VALIDATION);
-    }
-
-    /**
-     * Create a new variant context without genotypes and no Perror, no filters, and no attributes
-     *
-     * @param source          source
-     * @param contig          the contig
-     * @param start           the start base (one based)
-     * @param stop            the stop reference base (one based)
-     * @param alleles alleles
-     *
-     * @deprecated  replaced by {@link VariantContextBuilder}
-     */
-    @Deprecated
-    public VariantContext(String source, String ID, String contig, long start, long stop, Collection<Allele> alleles) {
-        this(source, ID, contig, start, stop, alleles, NO_GENOTYPES, CommonInfo.NO_LOG10_PERROR, null, null, null, false, ALL_VALIDATION);
-    }
-
     /**
      * Copy constructor
      *
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 12b2ce406..b6e0d2e4d 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -375,8 +375,7 @@ public class VariantContextUtils {
                     genotypeAttributes, g.isPhased()));
         }
 
-        return new VariantContext(vc.getSource(), vc.getID(), vc.getChr(), vc.getStart(), vc.getEnd(),
-                vc.getAlleles(), genotypes, vc.getLog10PError(), vc.getFilters(), attributes, vc.getReferenceBaseForIndel());
+        return new VariantContextBuilder(vc).genotypes(genotypes).attributes(attributes).make();
     }
 
     public enum GenotypeMergeType {
diff --git a/public/java/test/org/broadinstitute/sting/gatk/refdata/RefMetaDataTrackerUnitTest.java b/public/java/test/org/broadinstitute/sting/gatk/refdata/RefMetaDataTrackerUnitTest.java
index 43e93de1a..9de4d5c04 100644
--- a/public/java/test/org/broadinstitute/sting/gatk/refdata/RefMetaDataTrackerUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/refdata/RefMetaDataTrackerUnitTest.java
@@ -66,9 +66,9 @@ public class RefMetaDataTrackerUnitTest {
         C = Allele.create("C");
         G = Allele.create("G");
         T = Allele.create("T");
-        AC_SNP = new VariantContext("x", VCFConstants.EMPTY_ID_FIELD, "chr1", START_POS, START_POS, Arrays.asList(A, C));
-        AG_SNP = new VariantContext("x", VCFConstants.EMPTY_ID_FIELD, "chr1", START_POS, START_POS, Arrays.asList(A, G));
-        AT_SNP = new VariantContext("x", VCFConstants.EMPTY_ID_FIELD, "chr1", START_POS, START_POS, Arrays.asList(A, T));
+        AC_SNP = new VariantContextBuilder("x", "chr1", START_POS, START_POS, Arrays.asList(A, C).make());
+        AG_SNP = new VariantContextBuilder("x", "chr1", START_POS, START_POS, Arrays.asList(A, G).make());
+        AT_SNP = new VariantContextBuilder("x", "chr1", START_POS, START_POS, Arrays.asList(A, T).make());
         span10_10 = makeSpan(10, 10);
         span1_20 = makeSpan(1, 20);
         span10_20 = makeSpan(10, 20);
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index cdbadbbb6..4c0d22f70 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -12,6 +12,7 @@ import org.testng.annotations.DataProvider;
 import org.testng.annotations.Test;
 import org.testng.Assert;
 
+import java.lang.reflect.Array;
 import java.util.*;
 
 
@@ -39,6 +40,8 @@ public class VariantContextUnitTest extends BaseTest {
     int mixedLocStart = 20;
     int mixedLocStop = 23;
 
+    VariantContextBuilder basicBuilder, snpBuilder, insBuilder;
+
     @BeforeSuite
     public void before() {
         del = Allele.create("-");
@@ -52,6 +55,10 @@ public class VariantContextUnitTest extends BaseTest {
 
         ATC = Allele.create("ATC");
         ATCref = Allele.create("ATC", true);
+
+        basicBuilder = new VariantContextBuilder("test", snpLoc,snpLocStart, snpLocStop, Arrays.asList(Aref, T)).referenceBaseForIndel((byte)'A');
+        snpBuilder = new VariantContextBuilder("test", snpLoc,snpLocStart, snpLocStop, Arrays.asList(Aref, T)).referenceBaseForIndel((byte)'A');
+        insBuilder = new VariantContextBuilder("test", insLoc, insLocStart, insLocStop, Arrays.asList(delRef, ATC)).referenceBaseForIndel((byte)'A');
     }
 
     @Test
@@ -68,68 +75,68 @@ public class VariantContextUnitTest extends BaseTest {
 
         // test REF
         List<Allele> alleles = Arrays.asList(Tref);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
+        VariantContext vc = snpBuilder.alleles(alleles).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.NO_VARIATION);
 
         // test SNPs
         alleles = Arrays.asList(Tref, A);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
+        vc = snpBuilder.alleles(alleles).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.SNP);
 
         alleles = Arrays.asList(Tref, A, C);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
+        vc = snpBuilder.alleles(alleles).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.SNP);
 
         // test MNPs
         alleles = Arrays.asList(ACref, TA);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles);
+        vc = snpBuilder.alleles(alleles).stop(snpLocStop+1).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.MNP);
 
         alleles = Arrays.asList(ATCref, CAT, Allele.create("GGG"));
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles);
+        vc = basicBuilder.alleles(alleles).stop(snpLocStop+2).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.MNP);
 
         // test INDELs
         alleles = Arrays.asList(Aref, ATC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).stop(snpLocStop+2).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(Tref, TA, TC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A, AC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).stop(snpLocStop+2).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         alleles = Arrays.asList(ATCref, A, Allele.create("ATCTC"));
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+2, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).stop(snpLocStop+2).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.INDEL);
 
         // test MIXED
         alleles = Arrays.asList(TAref, T, TC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).stop(snpLocStop+1).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(TAref, T, AC);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).stop(snpLocStop+1).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(ACref, ATC, AT);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop+1, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).stop(snpLocStop+1).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         alleles = Arrays.asList(Aref, T, symbolic);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.MIXED);
 
         // test SYMBOLIC
         alleles = Arrays.asList(Tref, symbolic);
-        vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        vc = basicBuilder.alleles(alleles).stop(snpLocStop+2).make();
         Assert.assertEquals(vc.getType(), VariantContext.Type.SYMBOLIC);
     }
 
@@ -137,8 +144,8 @@ public class VariantContextUnitTest extends BaseTest {
     public void testMultipleSNPAlleleOrdering() {
         final List<Allele> allelesNaturalOrder = Arrays.asList(Aref, C, T);
         final List<Allele> allelesUnnaturalOrder = Arrays.asList(Aref, T, C);
-        VariantContext naturalVC = new VariantContext("natural", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, allelesNaturalOrder);
-        VariantContext unnaturalVC = new VariantContext("unnatural", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, allelesUnnaturalOrder);
+        VariantContext naturalVC = snpBuilder.alleles(allelesNaturalOrder).make();
+        VariantContext unnaturalVC = snpBuilder.alleles(allelesUnnaturalOrder).make();
         Assert.assertEquals(new ArrayList<Allele>(naturalVC.getAlleles()), allelesNaturalOrder);
         Assert.assertEquals(new ArrayList<Allele>(unnaturalVC.getAlleles()), allelesUnnaturalOrder);
     }
@@ -147,7 +154,7 @@ public class VariantContextUnitTest extends BaseTest {
     public void testCreatingSNPVariantContext() {
 
         List<Allele> alleles = Arrays.asList(Aref, T);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
+        VariantContext vc = snpBuilder.alleles(alleles).make();
 
         Assert.assertEquals(vc.getChr(), snpLoc);
         Assert.assertEquals(vc.getStart(), snpLocStart);
@@ -174,7 +181,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingRefVariantContext() {
         List<Allele> alleles = Arrays.asList(Aref);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc,snpLocStart, snpLocStop, alleles);
+        VariantContext vc = snpBuilder.alleles(alleles).make();
 
         Assert.assertEquals(vc.getChr(), snpLoc);
         Assert.assertEquals(vc.getStart(), snpLocStart);
@@ -200,7 +207,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingDeletionVariantContext() {
         List<Allele> alleles = Arrays.asList(ATCref, del);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, delLoc, delLocStart, delLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        VariantContext vc = new VariantContextBuilder("test", delLoc, delLocStart, delLocStop, alleles).referenceBaseForIndel((byte)'A').make();
 
         Assert.assertEquals(vc.getChr(), delLoc);
         Assert.assertEquals(vc.getStart(), delLocStart);
@@ -227,7 +234,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingInsertionVariantContext() {
         List<Allele> alleles = Arrays.asList(delRef, ATC);
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        VariantContext vc = insBuilder.alleles(alleles).make();
 
         Assert.assertEquals(vc.getChr(), insLoc);
         Assert.assertEquals(vc.getStart(), insLocStart);
@@ -275,48 +282,48 @@ public class VariantContextUnitTest extends BaseTest {
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgs1() {
-        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(delRef, ATCref));
+        new VariantContextBuilder("test", insLoc, insLocStart, insLocStop, Arrays.asList(delRef, ATCref)).make();
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgs2() {
-        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(delRef, del));
+        new VariantContextBuilder("test", insLoc, insLocStart, insLocStop, Arrays.asList(delRef, del)).make();
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgs3() {
-        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(del));
+        new VariantContextBuilder("test", insLoc, insLocStart, insLocStop, Arrays.asList(del)).make();
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgs4() {
-        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Collections.<Allele>emptyList());
+        new VariantContextBuilder("test", insLoc, insLocStart, insLocStop, Collections.<Allele>emptyList()).make();
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgsDuplicateAlleles1() {
-        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(Aref, T, T));
+        new VariantContextBuilder("test", insLoc, insLocStart, insLocStop, Arrays.asList(Aref, T, T)).make();
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadConstructorArgsDuplicateAlleles2() {
-        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, insLoc, insLocStart, insLocStop, Arrays.asList(Aref, A));
+        new VariantContextBuilder("test", insLoc, insLocStart, insLocStop, Arrays.asList(Aref, A)).make();
     }
 
     @Test (expectedExceptions = IllegalStateException.class)
     public void testBadLoc1() {
         List<Allele> alleles = Arrays.asList(Aref, T, del);
-        new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, delLoc, delLocStart, delLocStop, alleles);
+        new VariantContextBuilder("test", delLoc, delLocStart, delLocStop, alleles).make();
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadID1() {
-        new VariantContext("test", null, delLoc, delLocStart, delLocStop, Arrays.asList(Aref, T));
+        new VariantContextBuilder("test", delLoc, delLocStart, delLocStop, Arrays.asList(Aref, T)).id(null).make();
     }
 
     @Test (expectedExceptions = IllegalArgumentException.class)
     public void testBadID2() {
-        new VariantContext("test", "", delLoc, delLocStart, delLocStop, Arrays.asList(Aref, T));
+        new VariantContextBuilder("test", delLoc, delLocStart, delLocStop, Arrays.asList(Aref, T)).id("");
     }
 
     @Test
@@ -550,7 +557,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test(dataProvider = "getAlleles")
     public void testMergeAlleles(GetAllelesTest cfg) {
         final List<Allele> altAlleles = cfg.alleles.subList(1, cfg.alleles.size());
-        final VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc, snpLocStart, snpLocStop, cfg.alleles, null, CommonInfo.NO_LOG10_PERROR, null, null, (byte)'A');
+        final VariantContext vc = snpBuilder.alleles(cfg.alleles).make();
 
         Assert.assertEquals(vc.getAlleles(), cfg.alleles, "VC alleles not the same as input alleles");
         Assert.assertEquals(vc.getNAlleles(), cfg.alleles.size(), "VC getNAlleles not the same as input alleles size");
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index 7857c66fc..53a0c8a2a 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -99,8 +99,7 @@ public class VariantContextUtilsUnitTest extends BaseTest {
     private VariantContext makeVC(String source, List<Allele> alleles, Collection<Genotype> genotypes, Set<String> filters) {
         int start = 10;
         int stop = start; // alleles.contains(ATC) ? start + 3 : start;
-        return new VariantContext(source, VCFConstants.EMPTY_ID_FIELD, "1", start, stop, alleles,
-                GenotypesContext.copy(genotypes), 1.0, filters, null, Cref.getBases()[0]);
+        return new VariantContextBuilder(source, "1", start, stop, alleles).genotypes(genotypes).filters(filters).referenceBaseForIndel(Cref.getBases()[0]).make();
     }
 
     // --------------------------------------------------------------------------------
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContextUnitTest.java
index 85a2532ef..6f5756bdc 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantJEXLContextUnitTest.java
@@ -144,7 +144,7 @@ public class VariantJEXLContextUnitTest extends BaseTest {
     private JEXLMap getVarContext() {
         List<Allele> alleles = Arrays.asList(Aref, T);
 
-        VariantContext vc = new VariantContext("test", VCFConstants.EMPTY_ID_FIELD, snpLoc.getContig(), snpLoc.getStart(), snpLoc.getStop(), alleles);
+        VariantContext vc = new VariantContextBuilder("test", snpLoc.getContig(), snpLoc.getStart(), snpLoc.getStop(), alleles).make();
         return new JEXLMap(Arrays.asList(exp),vc);
     }
 

From b7b57ef39a313ca2c743a96f92d5951b8e2b390a Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sat, 19 Nov 2011 15:57:33 -0500
Subject: [PATCH 070/113] Updating MD5 to reflect canonical ordering of
 calculation

-- We should no longer have md5s changing because of hashmaps changing their sort order on us
-- Added GenotypeLikelihoodsUnitTests
-- Refactored ExactAFCaclculation to put the PL -> QUAL calculation in the GenotypeLikelihoods class to avoid the code copy.
---
 .../genotyper/ExactAFCalculationModel.java    | 31 ++---------
 .../variantcontext/GenotypeLikelihoods.java   | 30 ++++++-----
 ...tTest.java => GenotypePriorsUnitTest.java} |  2 +-
 .../UnifiedGenotyperIntegrationTest.java      | 51 ++++++++++---------
 .../GenotypeLikelihoodsUnitTest.java          | 16 +++++-
 5 files changed, 63 insertions(+), 67 deletions(-)
 rename public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/{GenotypeLikelihoodsUnitTest.java => GenotypePriorsUnitTest.java} (98%)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index e071de15b..354702dad 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -29,10 +29,7 @@ import org.apache.log4j.Logger;
 import org.broadinstitute.sting.utils.MathUtils;
 import org.broadinstitute.sting.utils.Utils;
 import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.PrintStream;
 import java.util.*;
@@ -354,11 +351,10 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
             // and will add no-call genotype to GL's in a second pass
             ArrayList<Allele> myAlleles = new ArrayList<Allele>();
 
-            double qual = Double.NEGATIVE_INFINITY;
             double[] likelihoods = g.getLikelihoods().getAsVector();
 
             if (SIMPLE_GREEDY_GENOTYPER || !vc.isBiallelic()) {
-                bestGTguess = Utils.findIndexOfMaxEntry(g.getLikelihoods().getAsVector());
+                bestGTguess = Utils.findIndexOfMaxEntry(likelihoods);
             }
             else {
                 int newIdx = tracebackArray[k][startIdx];;
@@ -366,20 +362,6 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
                 startIdx = newIdx;
             }
 
-            /*           System.out.format("Sample: %s GL:",sample);
-                    for (int i=0; i < likelihoods.length; i++)
-                        System.out.format("%1.4f, ",likelihoods[i]);
-            */
-
-            for (int i=0; i < likelihoods.length; i++) {
-                if (i==bestGTguess)
-                    continue;
-                if (likelihoods[i] >= qual)
-                    qual = likelihoods[i];
-            }
-            // qual contains now max(likelihoods[k]) for all k != bestGTguess
-            qual = likelihoods[bestGTguess] - qual;
-
             // likelihoods are stored row-wise in lower triangular matrix. IE
             // for 2 alleles they have ordering AA,AB,BB
             // for 3 alleles they are ordered AA,AB,BB,AC,BC,CC
@@ -407,16 +389,9 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
                     break;
             }
 
-            if (qual < 0) {
-                // QUAL can be negative if the chosen genotype is not the most likely one individually.
-                // In this case, we compute the actual genotype probability and QUAL is the likelihood of it not being the chosen on
-                double[] normalized = MathUtils.normalizeFromLog10(likelihoods);
-                double chosenGenotype = normalized[bestGTguess];
-                qual = -1.0 * Math.log10(1.0 - chosenGenotype);
-            }
+            final double qual = GenotypeLikelihoods.getQualFromLikelihoods(bestGTguess, likelihoods);
             //System.out.println(myAlleles.toString());
             calls.add(new Genotype(sample, myAlleles, qual, null, g.getAttributes(), false));
-
         }
 
         for ( final Genotype genotype : GLs.iterateInSampleNameOrder() ) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeLikelihoods.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeLikelihoods.java
index bbe5308a9..a5e4e5774 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeLikelihoods.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypeLikelihoods.java
@@ -117,28 +117,34 @@ public class GenotypeLikelihoods {
     //Return the neg log10 Genotype Quality (GQ) for the given genotype
     //Returns Double.NEGATIVE_INFINITY in case of missing genotype
     public double getLog10GQ(Genotype.Type genotype){
-        EnumMap<Genotype.Type,Double> likelihoods = getAsMap(false);
+        return getQualFromLikelihoods(genotype.ordinal() - 1 /* NO_CALL IS FIRST */, getAsVector());
+    }
+
+    public static double getQualFromLikelihoods(int iOfChoosenGenotype, double[] likelihoods){
         if(likelihoods == null)
             return Double.NEGATIVE_INFINITY;
 
         double qual = Double.NEGATIVE_INFINITY;
-        for(Map.Entry<Genotype.Type,Double> likelihood : likelihoods.entrySet()){
-            if(likelihood.getKey() == genotype)
+        for (int i=0; i < likelihoods.length; i++) {
+            if (i==iOfChoosenGenotype)
                 continue;
-            if(likelihood.getValue() > qual)
-                qual = likelihood.getValue();
+            if (likelihoods[i] >= qual)
+                qual = likelihoods[i];
         }
 
-        //Quality of the most likely genotype = likelihood(most likely) - likelihood (2nd best)
-        qual = likelihoods.get(genotype) - qual;
+        // qual contains now max(likelihoods[k]) for all k != bestGTguess
+        qual = likelihoods[iOfChoosenGenotype] - qual;
 
-        //Quality of other genotypes 1-P(G)
         if (qual < 0) {
-            double[] normalized = MathUtils.normalizeFromLog10(getAsVector());
-            double chosenGenotype = normalized[genotype.ordinal()-1];
-            qual = Math.log10(1.0 - chosenGenotype);
+            // QUAL can be negative if the chosen genotype is not the most likely one individually.
+            // In this case, we compute the actual genotype probability and QUAL is the likelihood of it not being the chosen one
+            double[] normalized = MathUtils.normalizeFromLog10(likelihoods);
+            double chosenGenotype = normalized[iOfChoosenGenotype];
+            return Math.log10(1.0 - chosenGenotype);
+        } else {
+            // invert the size, as this is the probability of making an error
+            return -1 * qual;
         }
-        return -1 * qual;
     }
 
     private final static double[] parsePLsIntoLikelihoods(String likelihoodsAsString_PLs) {
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypeLikelihoodsUnitTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypePriorsUnitTest.java
similarity index 98%
rename from public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypeLikelihoodsUnitTest.java
rename to public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypePriorsUnitTest.java
index 425b969e2..a87f121f6 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypeLikelihoodsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/GenotypePriorsUnitTest.java
@@ -7,7 +7,7 @@ import org.testng.annotations.Test;
 
 import static java.lang.Math.log10;
 
-public class GenotypeLikelihoodsUnitTest extends BaseTest {
+public class GenotypePriorsUnitTest extends BaseTest {
     private final static double DELTA = 1e-8;
 
     @Test
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
index 6d4a971a5..fc234ec24 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
@@ -29,7 +29,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testMultiSamplePilot1() {
         WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -o %s -L 1:10,022,000-10,025,000", 1,
-                Arrays.asList("c93def488de12fb3b8199e001b7a24a8"));
+                Arrays.asList("f5c8bd653aed02059b9f377833eae5bb"));
         executeTest("test MultiSample Pilot1", spec);
     }
 
@@ -37,7 +37,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testWithAllelesPassedIn1() {
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "allelesForUG.vcf -I " + validationDataLocation + "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,025,000", 1,
-                Arrays.asList("cef4bd72cbbe72f28e9c72e2818b4708"));
+                Arrays.asList("ea5b5dcea3a6eef7ec60070b551c994e"));
         executeTest("test MultiSample Pilot2 with alleles passed in", spec1);
     }
 
@@ -45,7 +45,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testWithAllelesPassedIn2() {
         WalkerTest.WalkerTestSpec spec2 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " --output_mode EMIT_ALL_SITES --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "allelesForUG.vcf -I " + validationDataLocation + "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,025,000", 1,
-                Arrays.asList("9834f0cef1cd6ba4943a5aaee1ee8be8"));
+                Arrays.asList("030ce4feb4bbcf700caba82a45cc45f2"));
         executeTest("test MultiSample Pilot2 with alleles passed in and emitting all sites", spec2);
     }
 
@@ -53,7 +53,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testSingleSamplePilot2() {
         WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -o %s -L 1:10,000,000-10,100,000", 1,
-                Arrays.asList("6762b72ae60155ad71738d7c76b80e4b"));
+                Arrays.asList("3ccce5d909f8f128e496f6841836e5f7"));
         executeTest("test SingleSample Pilot2", spec);
     }
 
@@ -63,7 +63,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     //
     // --------------------------------------------------------------------------------------------------------------
 
-    private final static String COMPRESSED_OUTPUT_MD5 = "bc71dba7bbdb23e7d5cc60461fdd897b";
+    private final static String COMPRESSED_OUTPUT_MD5 = "890143b366050e78d6c6ba6b2c6b6864";
 
     @Test
     public void testCompressedOutput() {
@@ -84,7 +84,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
 
         // Note that we need to turn off any randomization for this to work, so no downsampling and no annotations
 
-        String md5 = "b9504e446b9313559c3ed97add7e8dc1";
+        String md5 = "95614280c565ad90f8c000376fef822c";
 
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -dt NONE -G none -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -o %s -L 1:10,000,000-10,075,000", 1,
@@ -115,8 +115,8 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     @Test
     public void testCallingParameters() {
         HashMap<String, String> e = new HashMap<String, String>();
-        e.put( "--min_base_quality_score 26", "bb3f294eab3e2cf52c70e63b23aac5ee" );
-        e.put( "--computeSLOD", "eb34979efaadba1e34bd82bcacf5c722" );
+        e.put( "--min_base_quality_score 26", "7acb1a5aee5fdadb0cc0ea07a212efc6" );
+        e.put( "--computeSLOD", "e9d23a08472e4e27b4f25e844f5bad57" );
 
         for ( Map.Entry<String, String> entry : e.entrySet() ) {
             WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
@@ -129,9 +129,9 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     @Test
     public void testOutputParameter() {
         HashMap<String, String> e = new HashMap<String, String>();
-        e.put( "-sites_only", "d40114aa201aa33ff5f174f15b6b73af" );
-        e.put( "--output_mode EMIT_ALL_CONFIDENT_SITES", "3c681b053fd2280f3c42041d24243752" );
-        e.put( "--output_mode EMIT_ALL_SITES", "eafa6d71c5ecd64dfee5d7a3f60e392e" );
+        e.put( "-sites_only", "44f3b5b40e6ad44486cddfdb7e0bfcd8" );
+        e.put( "--output_mode EMIT_ALL_CONFIDENT_SITES", "94e53320f14c5ff29d62f68d36b46fcd" );
+        e.put( "--output_mode EMIT_ALL_SITES", "73ad1cc41786b12c5f0e6f3e9ec2b728" );
 
         for ( Map.Entry<String, String> entry : e.entrySet() ) {
             WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
@@ -145,12 +145,15 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testConfidence() {
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -o %s -L 1:10,000,000-10,010,000 -stand_call_conf 10 ", 1,
-                Arrays.asList("c71ca370947739cb7d87b59452be7a07"));
+                Arrays.asList("902327e8a45fe585c8dfd1a7c4fcf60f"));
         executeTest("test confidence 1", spec1);
+    }
 
+    @Test
+    public void testConfidence2() {
         WalkerTest.WalkerTestSpec spec2 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -o %s -L 1:10,000,000-10,010,000 -stand_emit_conf 10 ", 1,
-                Arrays.asList("1c0a599d475cc7d5e745df6e9b6c0d29"));
+                Arrays.asList("2343ac8113791f4e79643b333b34afc8"));
         executeTest("test confidence 2", spec2);
     }
 
@@ -162,8 +165,8 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     @Test
     public void testHeterozyosity() {
         HashMap<Double, String> e = new HashMap<Double, String>();
-        e.put( 0.01, "f84da90c310367bd51f2ab6e346fa3d8" );
-        e.put( 1.0 / 1850, "5791e7fef40d4412b6d8f84e0a809c6c" );
+        e.put( 0.01, "46243ecc2b9dc716f48ea280c9bb7e72" );
+        e.put( 1.0 / 1850, "6b2a59dbc76984db6d4d6d6b5ee5d62c" );
 
         for ( Map.Entry<Double, String> entry : e.entrySet() ) {
             WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
@@ -187,7 +190,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                         " -o %s" +
                         " -L 1:10,000,000-10,100,000",
                 1,
-                Arrays.asList("9cc9538ac83770e12bd0830d285bfbd0"));
+                Arrays.asList("f0fbe472f155baf594b1eeb58166edef"));
 
         executeTest(String.format("test multiple technologies"), spec);
     }
@@ -206,7 +209,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                         " -L 1:10,000,000-10,100,000" +
                         " -baq CALCULATE_AS_NECESSARY",
                 1,
-                Arrays.asList("eaf8043edb46dfbe9f97ae03baa797ed"));
+                Arrays.asList("8c87c749a7bb5a76ed8504d4ec254272"));
 
         executeTest(String.format("test calling with BAQ"), spec);
     }
@@ -225,7 +228,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                         " -o %s" +
                         " -L 1:10,000,000-10,500,000",
                 1,
-                Arrays.asList("eeba568272f9b42d5450da75c7cc6d2d"));
+                Arrays.asList("a64d2e65b5927260e4ce0d948760cc5c"));
 
         executeTest(String.format("test indel caller in SLX"), spec);
     }
@@ -240,7 +243,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                         " -minIndelCnt 1" +
                         " -L 1:10,000,000-10,100,000",
                 1,
-                Arrays.asList("5fe98ee853586dc9db58f0bc97daea63"));
+                Arrays.asList("2ad52c2e75b3ffbfd8f03237c444e8e6"));
 
         executeTest(String.format("test indel caller in SLX with low min allele count"), spec);
     }
@@ -253,7 +256,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                          " -o %s" +
                          " -L 1:10,000,000-10,500,000",
                  1,
-                 Arrays.asList("19ff9bd3139480bdf79dcbf117cf2b24"));
+                 Arrays.asList("69107157632714150fc068d412e31939"));
 
          executeTest(String.format("test indel calling, multiple technologies"), spec);
      }
@@ -263,7 +266,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec1 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndels + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "indelAllelesForUG.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,100,000", 1,
-                Arrays.asList("81a1035e59cd883e413e62d34265c1a2"));
+                Arrays.asList("4ffda07590e06d58ed867ae326d74b2d"));
         executeTest("test MultiSample Pilot2 indels with alleles passed in", spec1);
     }
 
@@ -273,7 +276,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
                 baseCommandIndels + " --output_mode EMIT_ALL_SITES --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles "
                         + validationDataLocation + "indelAllelesForUG.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,100,000", 1,
-                Arrays.asList("102b7d915f21dff0a9b6ea64c4c7d409"));
+                Arrays.asList("6e182a58472ea17c8b0eb01f80562fbd"));
         executeTest("test MultiSample Pilot2 indels with alleles passed in and emitting all sites", spec2);
     }
 
@@ -283,7 +286,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec3 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndels + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "ALL.wgs.union_v2.20101123.indels.sites.vcf -I " + validationDataLocation +
                         "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,080,000", 1,
-                Arrays.asList("5900344f97bbac35d147a0a7c2bf1d0c"));
+                Arrays.asList("f93f8a35b47bcf96594ada55e2312c73"));
         executeTest("test MultiSample Pilot2 indels with complicated records", spec3);
     }
 
@@ -292,7 +295,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec4 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndelsb37 + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "ALL.wgs.union_v2_chr20_100_110K.20101123.indels.sites.vcf -I " + validationDataLocation +
                         "phase1_GBR_realigned.chr20.100K-110K.bam -o %s -L 20:100,000-110,000", 1,
-                Arrays.asList("45e7bf21cd6358921626404e7ae76c69"));
+                Arrays.asList("1e02f57fafaa41db71c531eb25e148e1"));
         executeTest("test MultiSample 1000G Phase1 indels with complicated records emitting all sites", spec4);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypeLikelihoodsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypeLikelihoodsUnitTest.java
index 70a18856f..a66c78f3c 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypeLikelihoodsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypeLikelihoodsUnitTest.java
@@ -105,8 +105,8 @@ public class GenotypeLikelihoodsUnitTest {
         double[] test = MathUtils.normalizeFromLog10(gl.getAsVector());
 
         //GQ for the other genotypes
-        Assert.assertEquals(gl.getLog10GQ(Genotype.Type.HOM_REF), -1 * Math.log10(1.0 - test[Genotype.Type.HOM_REF.ordinal()-1]));
-        Assert.assertEquals(gl.getLog10GQ(Genotype.Type.HOM_VAR), -1 * Math.log10(1.0 - test[Genotype.Type.HOM_VAR.ordinal()-1]));
+        Assert.assertEquals(gl.getLog10GQ(Genotype.Type.HOM_REF), Math.log10(1.0 - test[Genotype.Type.HOM_REF.ordinal()-1]));
+        Assert.assertEquals(gl.getLog10GQ(Genotype.Type.HOM_VAR), Math.log10(1.0 - test[Genotype.Type.HOM_VAR.ordinal()-1]));
 
        //Test missing likelihoods
         gl = new GenotypeLikelihoods(".");
@@ -116,6 +116,18 @@ public class GenotypeLikelihoodsUnitTest {
 
     }
 
+    @Test
+    public void testgetQualFromLikelihoods(){
+        double[] likelihoods = new double[]{-1, 0, -2};
+        // qual values we expect for each possible "best" genotype
+        double[] expectedQuals = new double[]{-0.04100161, -1, -0.003930294};
+
+        for ( int i = 0; i < likelihoods.length; i++ ) {
+            Assert.assertEquals(GenotypeLikelihoods.getQualFromLikelihoods(i, likelihoods), expectedQuals[i], 1e-6,
+                    "GQ value for genotype " + i + " was not calculated correctly");
+        }
+    }
+
     private void assertDoubleArraysAreEqual(double[] v1, double[] v2) {
         Assert.assertEquals(v1.length, v2.length);
         for ( int i = 0; i < v1.length; i++ ) {

From 8f7eebbaaf5fab7f2e5b9e3798d56870f684e4f3 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sat, 19 Nov 2011 15:58:59 -0500
Subject: [PATCH 071/113] Bugfix for pError not being checked correctly in
 CommonInfo

-- UnitTests to ensure correct behavior
-- UnitTests to ensure correct behavior for pass filters vs. failed filters vs. unfiltered
---
 .../utils/variantcontext/CommonInfo.java      |  9 +-
 .../VariantContextUnitTest.java               | 75 ++++++++-------
 .../VariantContextUtilsUnitTest.java          | 92 +++++++++----------
 3 files changed, 95 insertions(+), 81 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
index 98032f94d..c0c9f36ce 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/CommonInfo.java
@@ -107,9 +107,12 @@ final class CommonInfo {
     public double getPhredScaledQual() { return getLog10PError() * -10; }
 
     public void setLog10PError(double log10PError) {
-        if ( this.log10PError > 0 && this.log10PError != NO_LOG10_PERROR) throw new IllegalArgumentException("BUG: log10PError cannot be > 0 : " + this.log10PError);
-        if ( Double.isInfinite(this.log10PError) ) throw new IllegalArgumentException("BUG: log10PError should not be Infinity");
-        if ( Double.isNaN(this.log10PError) ) throw new IllegalArgumentException("BUG: log10PError should not be NaN");
+        if ( log10PError > 0 && log10PError != NO_LOG10_PERROR)
+            throw new IllegalArgumentException("BUG: log10PError cannot be > 0 : " + this.log10PError);
+        if ( Double.isInfinite(this.log10PError) )
+            throw new IllegalArgumentException("BUG: log10PError should not be Infinity");
+        if ( Double.isNaN(this.log10PError) )
+            throw new IllegalArgumentException("BUG: log10PError should not be NaN");
         this.log10PError = log10PError;
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index 5f2dacdfb..fdcf01141 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -264,7 +264,7 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testCreatingPartiallyCalledGenotype() {
         List<Allele> alleles = Arrays.asList(Aref, C);
-        Genotype g = new Genotype("foo", Arrays.asList(C, Allele.NO_CALL), 10);
+        Genotype g = new Genotype("foo", Arrays.asList(C, Allele.NO_CALL));
         VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles).genotypes(g).make();
 
         Assert.assertTrue(vc.isSNP());
@@ -330,13 +330,18 @@ public class VariantContextUnitTest extends BaseTest {
         new VariantContextBuilder("test", delLoc, delLocStart, delLocStop, Arrays.asList(Aref, T)).id("").make();
     }
 
+    @Test (expectedExceptions = Throwable.class)
+    public void testBadPError() {
+        new VariantContextBuilder("test", insLoc, insLocStart, insLocStop, Arrays.asList(delRef, ATCref)).log10PError(0.5).make();
+    }
+
     @Test
     public void testAccessingSimpleSNPGenotypes() {
         List<Allele> alleles = Arrays.asList(Aref, T);
 
-        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
-        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
-        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref));
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T));
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T));
 
         VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles)
                 .genotypes(g1, g2, g3).make();
@@ -371,12 +376,12 @@ public class VariantContextUnitTest extends BaseTest {
     public void testAccessingCompleteGenotypes() {
         List<Allele> alleles = Arrays.asList(Aref, T, del);
 
-        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
-        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
-        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
-        Genotype g4 = new Genotype("Td", Arrays.asList(T, del), 10);
-        Genotype g5 = new Genotype("dd", Arrays.asList(del, del), 10);
-        Genotype g6 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref));
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T));
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T));
+        Genotype g4 = new Genotype("Td", Arrays.asList(T, del));
+        Genotype g5 = new Genotype("dd", Arrays.asList(del, del));
+        Genotype g6 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL));
 
         VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles)
                 .genotypes(g1, g2, g3, g4, g5, g6).make();
@@ -401,9 +406,9 @@ public class VariantContextUnitTest extends BaseTest {
         List<Allele> alleles2 = Arrays.asList(Aref);
         List<Allele> alleles3 = Arrays.asList(Aref, T, del);
         for ( List<Allele> alleles : Arrays.asList(alleles1, alleles2, alleles3)) {
-            Genotype g1 = new Genotype("AA1", Arrays.asList(Aref, Aref), 10);
-            Genotype g2 = new Genotype("AA2", Arrays.asList(Aref, Aref), 10);
-            Genotype g3 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
+            Genotype g1 = new Genotype("AA1", Arrays.asList(Aref, Aref));
+            Genotype g2 = new Genotype("AA2", Arrays.asList(Aref, Aref));
+            Genotype g3 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL));
             VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles)
                     .genotypes(g1, g2, g3).make();
 
@@ -422,20 +427,24 @@ public class VariantContextUnitTest extends BaseTest {
     @Test
     public void testFilters() {
         List<Allele> alleles = Arrays.asList(Aref, T, del);
-        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
-        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref));
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T));
 
         VariantContext vc = new VariantContextBuilder("test", snpLoc, snpLocStart, snpLocStop, alleles).genotypes(g1, g2).make();
 
         Assert.assertTrue(vc.isNotFiltered());
         Assert.assertFalse(vc.isFiltered());
         Assert.assertEquals(0, vc.getFilters().size());
+        Assert.assertFalse(vc.filtersWereApplied());
+        Assert.assertNull(vc.getFiltersMaybeNull());
 
         vc = new VariantContextBuilder(vc).filters("BAD_SNP_BAD!").make();
 
         Assert.assertFalse(vc.isNotFiltered());
         Assert.assertTrue(vc.isFiltered());
         Assert.assertEquals(1, vc.getFilters().size());
+        Assert.assertTrue(vc.filtersWereApplied());
+        Assert.assertNotNull(vc.getFiltersMaybeNull());
 
         Set<String> filters = new HashSet<String>(Arrays.asList("BAD_SNP_BAD!", "REALLY_BAD_SNP", "CHRIST_THIS_IS_TERRIBLE"));
         vc = new VariantContextBuilder(vc).filters(filters).make();
@@ -443,16 +452,18 @@ public class VariantContextUnitTest extends BaseTest {
         Assert.assertFalse(vc.isNotFiltered());
         Assert.assertTrue(vc.isFiltered());
         Assert.assertEquals(3, vc.getFilters().size());
+        Assert.assertTrue(vc.filtersWereApplied());
+        Assert.assertNotNull(vc.getFiltersMaybeNull());
     }
 
     @Test
     public void testVCFfromGenotypes() {
         List<Allele> alleles = Arrays.asList(Aref, T, del);
-        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
-        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
-        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
-        Genotype g4 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL), 10);
-        Genotype g5 = new Genotype("--", Arrays.asList(del, del), 10);
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref));
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T));
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T));
+        Genotype g4 = new Genotype("..", Arrays.asList(Allele.NO_CALL, Allele.NO_CALL));
+        Genotype g5 = new Genotype("--", Arrays.asList(del, del));
         VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, alleles).genotypes(g1,g2,g3,g4,g5).make();
 
         VariantContext vc12 = vc.subContextFromSamples(new HashSet<String>(Arrays.asList(g1.getSampleName(), g2.getSampleName())));
@@ -503,9 +514,9 @@ public class VariantContextUnitTest extends BaseTest {
     }
 
     public void testGetGenotypeMethods() {
-        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
-        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
-        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref));
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T));
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T));
         GenotypesContext gc = GenotypesContext.create(g1, g2, g3);
         VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).genotypes(gc).make();
 
@@ -608,9 +619,9 @@ public class VariantContextUnitTest extends BaseTest {
 
     @DataProvider(name = "SitesAndGenotypesVC")
     public Object[][] MakeSitesAndGenotypesVCs() {
-        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
-        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
-        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref));
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T));
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T));
 
         VariantContext sites = new VariantContextBuilder("sites", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).make();
         VariantContext genotypes = new VariantContextBuilder(sites).source("genotypes").genotypes(g1, g2, g3).make();
@@ -647,9 +658,9 @@ public class VariantContextUnitTest extends BaseTest {
         modified = new VariantContextBuilder(modified).attributes(null).make();
         Assert.assertTrue(modified.getAttributes().isEmpty());
 
-        Genotype g1 = new Genotype("AA2", Arrays.asList(Aref, Aref), 10);
-        Genotype g2 = new Genotype("AT2", Arrays.asList(Aref, T), 10);
-        Genotype g3 = new Genotype("TT2", Arrays.asList(T, T), 10);
+        Genotype g1 = new Genotype("AA2", Arrays.asList(Aref, Aref));
+        Genotype g2 = new Genotype("AT2", Arrays.asList(Aref, T));
+        Genotype g3 = new Genotype("TT2", Arrays.asList(T, T));
         GenotypesContext gc = GenotypesContext.create(g1,g2,g3);
         modified = new VariantContextBuilder(cfg.vc).genotypes(gc).make();
         Assert.assertEquals(modified.getGenotypes(), gc);
@@ -704,9 +715,9 @@ public class VariantContextUnitTest extends BaseTest {
 
     @Test(dataProvider = "SubContextTest")
     public void runSubContextTest(SubContextTest cfg) {
-        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref), 10);
-        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T), 10);
-        Genotype g3 = new Genotype("TT", Arrays.asList(T, T), 10);
+        Genotype g1 = new Genotype("AA", Arrays.asList(Aref, Aref));
+        Genotype g2 = new Genotype("AT", Arrays.asList(Aref, T));
+        Genotype g3 = new Genotype("TT", Arrays.asList(T, T));
 
         GenotypesContext gc = GenotypesContext.create(g1, g2, g3);
         VariantContext vc = new VariantContextBuilder("genotypes", snpLoc, snpLocStart, snpLocStop, Arrays.asList(Aref, T)).genotypes(gc).make();
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
index 53a0c8a2a..ccf560f83 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUtilsUnitTest.java
@@ -409,44 +409,44 @@ public class VariantContextUtilsUnitTest extends BaseTest {
     @DataProvider(name = "mergeGenotypes")
     public Object[][] mergeGenotypesData() {
         new MergeGenotypesTest("TakeGenotypeByPriority-1,2", "1,2",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2)),
-                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2)),
+                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1)));
 
         new MergeGenotypesTest("TakeGenotypeByPriority-1,2-nocall", "1,2",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Allele.NO_CALL, Allele.NO_CALL, 1)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2)),
-                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Allele.NO_CALL, Allele.NO_CALL, 1)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Allele.NO_CALL, Allele.NO_CALL, -1)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2)),
+                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Allele.NO_CALL, Allele.NO_CALL, -1)));
 
         new MergeGenotypesTest("TakeGenotypeByPriority-2,1", "2,1",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2)),
-                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2)),
+                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2)));
 
         new MergeGenotypesTest("NonOverlappingGenotypes", "1,2",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s2", Aref, T, 2)),
-                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1), makeG("s2", Aref, T, 2)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s2", Aref, T, -2)),
+                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1), makeG("s2", Aref, T, -2)));
 
         new MergeGenotypesTest("PreserveNoCall", "1,2",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Allele.NO_CALL, Allele.NO_CALL, 1)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s2", Aref, T, 2)),
-                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Allele.NO_CALL, Allele.NO_CALL, 1), makeG("s2", Aref, T, 2)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Allele.NO_CALL, Allele.NO_CALL, -1)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s2", Aref, T, -2)),
+                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Allele.NO_CALL, Allele.NO_CALL, -1), makeG("s2", Aref, T, -2)));
 
         new MergeGenotypesTest("PerserveAlleles", "1,2",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1)),
-                makeVC("2", Arrays.asList(Aref, C), makeG("s2", Aref, C, 2)),
-                makeVC("3", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, 1), makeG("s2", Aref, C, 2)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1)),
+                makeVC("2", Arrays.asList(Aref, C), makeG("s2", Aref, C, -2)),
+                makeVC("3", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, -1), makeG("s2", Aref, C, -2)));
 
         new MergeGenotypesTest("TakeGenotypePartialOverlap-1,2", "1,2",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2), makeG("s3", Aref, T, 3)),
-                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1), makeG("s3", Aref, T, 3)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2), makeG("s3", Aref, T, -3)),
+                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1), makeG("s3", Aref, T, -3)));
 
         new MergeGenotypesTest("TakeGenotypePartialOverlap-2,1", "2,1",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2), makeG("s3", Aref, T, 3)),
-                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2), makeG("s3", Aref, T, 3)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2), makeG("s3", Aref, T, -3)),
+                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2), makeG("s3", Aref, T, -3)));
 
         //
         // merging genothpes with PLs
@@ -454,41 +454,41 @@ public class VariantContextUtilsUnitTest extends BaseTest {
 
         // first, do no harm
         new MergeGenotypesTest("OrderedPLs", "1",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1, 1, 2, 3)),
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1, 1, 2, 3)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1, 1, 2, 3)),
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1, 1, 2, 3)));
 
         // first, do no harm
         new MergeGenotypesTest("OrderedPLs-3Alleles", "1",
-                makeVC("1", Arrays.asList(Aref, C, T), makeG("s1", Aref, T, 1, 1, 2, 3, 4, 5, 6)),
-                makeVC("1", Arrays.asList(Aref, C, T), makeG("s1", Aref, T, 1, 1, 2, 3, 4, 5, 6)));
+                makeVC("1", Arrays.asList(Aref, C, T), makeG("s1", Aref, T, -1, 1, 2, 3, 4, 5, 6)),
+                makeVC("1", Arrays.asList(Aref, C, T), makeG("s1", Aref, T, -1, 1, 2, 3, 4, 5, 6)));
 
         // first, do no harm
         new MergeGenotypesTest("OrderedPLs-3Alleles-2", "1",
-                makeVC("1", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, 1, 1, 2, 3, 4, 5, 6)),
-                makeVC("1", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, 1, 1, 2, 3, 4, 5, 6)));
+                makeVC("1", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, -1, 1, 2, 3, 4, 5, 6)),
+                makeVC("1", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, -1, 1, 2, 3, 4, 5, 6)));
 
         // first, do no harm
         new MergeGenotypesTest("OrderedPLs-3Alleles-2", "1",
-                makeVC("1", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, 1, 1, 2, 3, 4, 5, 6)),
-                makeVC("1", Arrays.asList(Aref, T, C), makeG("s2", Aref, C, 1, 1, 2, 3, 4, 5, 6)),
-                makeVC("1", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, 1, 1, 2, 3, 4, 5, 6), makeG("s2", Aref, C, 1, 1, 2, 3, 4, 5, 6)));
+                makeVC("1", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, -1, 1, 2, 3, 4, 5, 6)),
+                makeVC("1", Arrays.asList(Aref, T, C), makeG("s2", Aref, C, -1, 1, 2, 3, 4, 5, 6)),
+                makeVC("1", Arrays.asList(Aref, T, C), makeG("s1", Aref, T, -1, 1, 2, 3, 4, 5, 6), makeG("s2", Aref, C, -1, 1, 2, 3, 4, 5, 6)));
 
         new MergeGenotypesTest("TakeGenotypePartialOverlapWithPLs-2,1", "2,1",
-                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1,5,0,3)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2,4,0,2), makeG("s3", Aref, T, 3,3,0,2)),
-                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2,4,0,2), makeG("s3", Aref, T, 3,3,0,2)));
+                makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1,5,0,3)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2,4,0,2), makeG("s3", Aref, T, -3,3,0,2)),
+                makeVC("3", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2,4,0,2), makeG("s3", Aref, T, -3,3,0,2)));
 
         new MergeGenotypesTest("TakeGenotypePartialOverlapWithPLs-1,2", "1,2",
-                makeVC("1", Arrays.asList(Aref,ATC), makeG("s1", Aref, ATC, 1,5,0,3)),
-                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2,4,0,2), makeG("s3", Aref, T, 3,3,0,2)),
+                makeVC("1", Arrays.asList(Aref,ATC), makeG("s1", Aref, ATC, -1,5,0,3)),
+                makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2,4,0,2), makeG("s3", Aref, T, -3,3,0,2)),
                 // no likelihoods on result since type changes to mixed multiallelic
-                makeVC("3", Arrays.asList(Aref, ATC, T), makeG("s1", Aref, ATC, 1), makeG("s3", Aref, T, 3)));
+                makeVC("3", Arrays.asList(Aref, ATC, T), makeG("s1", Aref, ATC, -1), makeG("s3", Aref, T, -3)));
 
         new MergeGenotypesTest("MultipleSamplePLsDifferentOrder", "1,2",
-                makeVC("1", Arrays.asList(Aref, C, T), makeG("s1", Aref, C, 1, 1, 2, 3, 4, 5, 6)),
-                makeVC("2", Arrays.asList(Aref, T, C), makeG("s2", Aref, T, 2, 6, 5, 4, 3, 2, 1)),
+                makeVC("1", Arrays.asList(Aref, C, T), makeG("s1", Aref, C, -1, 1, 2, 3, 4, 5, 6)),
+                makeVC("2", Arrays.asList(Aref, T, C), makeG("s2", Aref, T, -2, 6, 5, 4, 3, 2, 1)),
                 // no likelihoods on result since type changes to mixed multiallelic
-                makeVC("3", Arrays.asList(Aref, C, T), makeG("s1", Aref, C, 1), makeG("s2", Aref, T, 2)));
+                makeVC("3", Arrays.asList(Aref, C, T), makeG("s1", Aref, C, -1), makeG("s2", Aref, T, -2)));
 
         return MergeGenotypesTest.getTests(MergeGenotypesTest.class);
     }
@@ -533,8 +533,8 @@ public class VariantContextUtilsUnitTest extends BaseTest {
 
     @Test
     public void testMergeGenotypesUniquify() {
-        final VariantContext vc1 = makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1));
-        final VariantContext vc2 = makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2));
+        final VariantContext vc1 = makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1));
+        final VariantContext vc2 = makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2));
 
         final VariantContext merged = VariantContextUtils.simpleMerge(genomeLocParser,
                 Arrays.asList(vc1, vc2), null, VariantContextUtils.FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED,
@@ -546,8 +546,8 @@ public class VariantContextUtilsUnitTest extends BaseTest {
 
     @Test(expectedExceptions = UserException.class)
     public void testMergeGenotypesRequireUnique() {
-        final VariantContext vc1 = makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, 1));
-        final VariantContext vc2 = makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, 2));
+        final VariantContext vc1 = makeVC("1", Arrays.asList(Aref, T), makeG("s1", Aref, T, -1));
+        final VariantContext vc2 = makeVC("2", Arrays.asList(Aref, T), makeG("s1", Aref, T, -2));
 
         final VariantContext merged = VariantContextUtils.simpleMerge(genomeLocParser,
                 Arrays.asList(vc1, vc2), null, VariantContextUtils.FilteredRecordMergeType.KEEP_IF_ANY_UNFILTERED,

From 707bd30b3f867f3c109a8cd33da3ace668cadb44 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sat, 19 Nov 2011 16:10:09 -0500
Subject: [PATCH 072/113] Should have been @BeforeMethod

---
 .../sting/utils/variantcontext/VariantContextUnitTest.java     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index fdcf01141..a7eac7ab9 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -9,6 +9,7 @@ import org.broadinstitute.sting.BaseTest;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
 import org.testng.annotations.BeforeSuite;
 import org.testng.annotations.BeforeTest;
+import org.testng.annotations.BeforeMethod;
 import org.testng.annotations.DataProvider;
 import org.testng.annotations.Test;
 import org.testng.Assert;
@@ -58,7 +59,7 @@ public class VariantContextUnitTest extends BaseTest {
         ATCref = Allele.create("ATC", true);
     }
 
-    @BeforeTest
+    @BeforeMethod
     public void beforeTest() {
         basicBuilder = new VariantContextBuilder("test", snpLoc,snpLocStart, snpLocStop, Arrays.asList(Aref, T)).referenceBaseForIndel((byte)'A');
         snpBuilder = new VariantContextBuilder("test", snpLoc,snpLocStart, snpLocStop, Arrays.asList(Aref, T)).referenceBaseForIndel((byte)'A');

From 7d09c0064b29ae0b502fbc4b76f505e0f5a3c4a3 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sat, 19 Nov 2011 18:40:15 -0500
Subject: [PATCH 073/113] Bug fixes and code cleanup throughout

-- chromosomeCounts now takes builder as well, cleaning up a lot of code throughout the codebase.
---
 .../walkers/annotator/ChromosomeCounts.java   |  6 +-
 .../beagle/BeagleOutputToVCFWalker.java       | 14 ++--
 .../walkers/genotyper/UGCallVariants.java     |  6 +-
 .../gatk/walkers/phasing/PhasingUtils.java    | 10 +--
 .../varianteval/util/VariantEvalUtils.java    | 17 ++---
 .../walkers/variantutils/CombineVariants.java | 13 ++--
 .../walkers/variantutils/SelectVariants.java  |  7 +-
 .../variantcontext/VariantContextBuilder.java | 26 ++++++-
 .../variantcontext/VariantContextUtils.java   | 74 +++++++++++++++++--
 .../VariantAnnotatorIntegrationTest.java      | 10 ++-
 10 files changed, 125 insertions(+), 58 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/ChromosomeCounts.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/ChromosomeCounts.java
index 5ed2a6761..0acd3e841 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/ChromosomeCounts.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/annotator/ChromosomeCounts.java
@@ -59,10 +59,8 @@ public class ChromosomeCounts extends InfoFieldAnnotation implements StandardAnn
     public Map<String, Object> annotate(RefMetaDataTracker tracker, AnnotatorCompatibleWalker walker, ReferenceContext ref, Map<String, AlignmentContext> stratifiedContexts, VariantContext vc) {
         if ( ! vc.hasGenotypes() )
             return null;
-        
-        Map<String, Object> map = new HashMap<String, Object>();
-        VariantContextUtils.calculateChromosomeCounts(vc, map, true);
-        return map;
+
+        return VariantContextUtils.calculateChromosomeCounts(vc, new HashMap<String, Object>(), true);
     }
 
     public List<String> getKeyNames() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index 64c4948ff..8c6038e7e 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -338,23 +338,21 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
             builder.alleles(new HashSet<Allele>(Arrays.asList(vc_input.getReference()))).filters(removedFilters);
         }
 
-        HashMap<String, Object> attributes = new HashMap<String, Object>(vc_input.getAttributes());
         // re-compute chromosome counts
-        VariantContextUtils.calculateChromosomeCounts(vc_input, attributes, false);
+        VariantContextUtils.calculateChromosomeCounts(builder, false);
 
         // Get Hapmap AC and AF
         if (vc_comp != null) {
-            attributes.put("ACH", alleleCountH.toString() );
-            attributes.put("ANH", chrCountH.toString() );
-            attributes.put("AFH", String.format("%4.2f", (double)alleleCountH/chrCountH) );
+            builder.attribute("ACH", alleleCountH.toString() );
+            builder.attribute("ANH", chrCountH.toString() );
+            builder.attribute("AFH", String.format("%4.2f", (double)alleleCountH/chrCountH) );
 
         }
 
-        attributes.put("NumGenotypesChanged", numGenotypesChangedByBeagle );
+        builder.attribute("NumGenotypesChanged", numGenotypesChangedByBeagle );
         if( !beagleR2Feature.getR2value().equals(Double.NaN) ) {
-            attributes.put("R2", beagleR2Feature.getR2value().toString() );
+            builder.attribute("R2", beagleR2Feature.getR2value().toString() );
         }
-        builder.attributes(attributes);
 
         vcfWriter.add(builder.make());
 
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
index 83da319ea..97f7b21eb 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/UGCallVariants.java
@@ -106,9 +106,9 @@ public class UGCallVariants extends RodWalker<VariantCallContext, Integer> {
             return sum;
 
         try {
-            Map<String, Object> attrs = new HashMap<String, Object>(value.getAttributes());
-            VariantContextUtils.calculateChromosomeCounts(value, attrs, true);
-            writer.add(new VariantContextBuilder(value).attributes(attrs).make());
+            VariantContextBuilder builder = new VariantContextBuilder(value);
+            VariantContextUtils.calculateChromosomeCounts(builder, true);
+            writer.add(builder.make());
         } catch (IllegalArgumentException e) {
             throw new IllegalArgumentException(e.getMessage() + "; this is often caused by using the --assume_single_sample_reads argument with the wrong sample name");
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
index 9aa23fdfb..75d0773f1 100644
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhasingUtils.java
@@ -131,13 +131,9 @@ class PhasingUtils {
         if ( vc2.hasID() ) mergedIDs.add(vc2.getID());
         String mergedID = mergedIDs.isEmpty() ? VCFConstants.EMPTY_ID_FIELD : Utils.join(VCFConstants.ID_FIELD_SEPARATOR, mergedIDs);
 
-        VariantContext mergedVc = new VariantContextBuilder(mergedName, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles()).id(mergedID).genotypes(mergedGenotypes).log10PError(mergedLog10PError).filters(mergedFilters).attributes(mergedAttribs).make();
-
-        mergedAttribs = new HashMap<String, Object>(mergedVc.getAttributes());
-        VariantContextUtils.calculateChromosomeCounts(mergedVc, mergedAttribs, true);
-        mergedVc = new VariantContextBuilder(mergedVc).attributes(mergedAttribs).make();
-
-        return mergedVc;
+        VariantContextBuilder mergedBuilder = new VariantContextBuilder(mergedName, vc1.getChr(), vc1.getStart(), vc2.getEnd(), mergeData.getAllMergedAlleles()).id(mergedID).genotypes(mergedGenotypes).log10PError(mergedLog10PError).filters(mergedFilters).attributes(mergedAttribs);
+        VariantContextUtils.calculateChromosomeCounts(mergedBuilder, true);
+        return mergedBuilder.make();
     }
 
     static String mergeVariantContextNames(String name1, String name2) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
index 6da693c7a..aa246b58d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
@@ -279,22 +279,17 @@ public class VariantEvalUtils {
      */
     public VariantContext getSubsetOfVariantContext(VariantContext vc, Set<String> sampleNames) {
         VariantContext vcsub = vc.subContextFromSamples(sampleNames, vc.getAlleles());
+        VariantContextBuilder builder = new VariantContextBuilder(vcsub);
 
-        HashMap<String, Object> newAts = new HashMap<String, Object>(vcsub.getAttributes());
-
-        int originalAlleleCount = vc.getHetCount() + 2 * vc.getHomVarCount();
-        int newAlleleCount = vcsub.getHetCount() + 2 * vcsub.getHomVarCount();
+        final int originalAlleleCount = vc.getHetCount() + 2 * vc.getHomVarCount();
+        final int newAlleleCount = vcsub.getHetCount() + 2 * vcsub.getHomVarCount();
 
         if (originalAlleleCount == newAlleleCount && newAlleleCount == 1) {
-            newAts.put("ISSINGLETON", true);
+            builder.attribute("ISSINGLETON", true);
         }
 
-        VariantContextUtils.calculateChromosomeCounts(vcsub, newAts, true);
-        vcsub = new VariantContextBuilder(vcsub).attributes(newAts).make();
-
-        //VariantEvalWalker.logger.debug(String.format("VC %s subset to %s AC%n", vc.getSource(), vc.getAttributeAsString(VCFConstants.ALLELE_COUNT_KEY)));
-
-        return vcsub;
+        VariantContextUtils.calculateChromosomeCounts(builder, true);
+        return builder.make();
     }
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/CombineVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/CombineVariants.java
index d74f5a269..096085330 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/CombineVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/CombineVariants.java
@@ -222,7 +222,7 @@ public class CombineVariants extends RodWalker<Integer, Integer> {
             for ( final VariantContext vc : vcs ) {
                 vcfWriter.add(vc);
             }
-            
+
             return vcs.isEmpty() ? 0 : 1;
         }
 
@@ -245,18 +245,17 @@ public class CombineVariants extends RodWalker<Integer, Integer> {
                         SET_KEY, filteredAreUncalled, MERGE_INFO_WITH_MAX_AC));
         }
 
-         for ( VariantContext mergedVC : mergedVCs ) {
+        for ( VariantContext mergedVC : mergedVCs ) {
             // only operate at the start of events
             if ( mergedVC == null )
                 continue;
 
-            HashMap<String, Object> attributes = new HashMap<String, Object>(mergedVC.getAttributes());
+            final VariantContextBuilder builder = new VariantContextBuilder(mergedVC);
             // re-compute chromosome counts
-            VariantContextUtils.calculateChromosomeCounts(mergedVC, attributes, false);
-            VariantContext annotatedMergedVC = new VariantContextBuilder(mergedVC).attributes(attributes).make();
+            VariantContextUtils.calculateChromosomeCounts(builder, false);
             if ( minimalVCF )
-                annotatedMergedVC = VariantContextUtils.pruneVariantContext(annotatedMergedVC, Arrays.asList(SET_KEY));
-            vcfWriter.add(annotatedMergedVC);
+                VariantContextUtils.pruneVariantContext(builder, Arrays.asList(SET_KEY));
+            vcfWriter.add(builder.make());
         }
 
         return vcs.isEmpty() ? 0 : 1;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
index babc88966..b0016ff4b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/variantutils/SelectVariants.java
@@ -684,11 +684,10 @@ public class SelectVariants extends RodWalker<Integer, Integer> {
                 builder.attribute("AN_Orig", sub.getAttribute(VCFConstants.ALLELE_NUMBER_KEY));
         }
 
-        Map<String, Object> attributes = new HashMap<String, Object>(builder.make().getAttributes());
-        VariantContextUtils.calculateChromosomeCounts(sub, attributes, false);
-        attributes.put("DP", depth);
+        VariantContextUtils.calculateChromosomeCounts(builder, false);
+        builder.attribute("DP", depth);
 
-        return new VariantContextBuilder(builder.make()).attributes(attributes).make();
+        return builder.make();
     }
 
     private void randomlyAddVariant(int rank, VariantContext vc) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
index cb2ef4678..379a01bb4 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
@@ -158,12 +158,34 @@ public class VariantContextBuilder {
     @Requires({"key != null"})
     @Ensures({"this.attributes.size() == old(this.attributes.size()) || this.attributes.size() == old(this.attributes.size()+1)"})
     public VariantContextBuilder attribute(final String key, final Object value) {
+        makeAttributesModifiable();
+        attributes.put(key, value);
+        return this;
+    }
+
+    /**
+     * Removes key if present in the attributes
+     *
+     * @param key
+     * @return
+     */
+    @Requires({"key != null"})
+    @Ensures({"this.attributes.size() == old(this.attributes.size()) || this.attributes.size() == old(this.attributes.size()-1)"})
+    public VariantContextBuilder rmAttribute(final String key) {
+        makeAttributesModifiable();
+        attributes.remove(key);
+        return this;
+    }
+
+    /**
+     * Makes the attributes field modifiable.  In many cases attributes is just a pointer to an immutable
+     * collection, so methods that want to add / remove records require the attributes to be copied first
+     */
+    private void makeAttributesModifiable() {
         if ( ! attributesCanBeModified ) {
             this.attributesCanBeModified = true;
             this.attributes = new HashMap<String, Object>(attributes);
         }
-        attributes.put(key, value);
-        return this;
     }
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index b6e0d2e4d..07c0f7c32 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -55,13 +55,15 @@ public class VariantContextUtils {
     }
 
     /**
-     * Update the attributes of the attributes map given the VariantContext to reflect the proper chromosome-based VCF tags
+     * Update the attributes of the attributes map given the VariantContext to reflect the
+     * proper chromosome-based VCF tags
      *
      * @param vc          the VariantContext
      * @param attributes  the attributes map to populate; must not be null; may contain old values
      * @param removeStaleValues should we remove stale values from the mapping?
+     * @return the attributes map provided as input, returned for programming convenience
      */
-    public static void calculateChromosomeCounts(VariantContext vc, Map<String, Object> attributes, boolean removeStaleValues) {
+    public static Map<String, Object> calculateChromosomeCounts(VariantContext vc, Map<String, Object> attributes, boolean removeStaleValues) {
         // if everyone is a no-call, remove the old attributes if requested
         if ( vc.getCalledChrCount() == 0 && removeStaleValues ) {
             if ( attributes.containsKey(VCFConstants.ALLELE_COUNT_KEY) )
@@ -70,7 +72,7 @@ public class VariantContextUtils {
                 attributes.remove(VCFConstants.ALLELE_FREQUENCY_KEY);
             if ( attributes.containsKey(VCFConstants.ALLELE_NUMBER_KEY) )
                 attributes.remove(VCFConstants.ALLELE_NUMBER_KEY);
-            return;
+            return attributes;
         }
 
         if ( vc.hasGenotypes() ) {
@@ -96,6 +98,54 @@ public class VariantContextUtils {
                 attributes.put(VCFConstants.ALLELE_FREQUENCY_KEY, 0.0);
             }
         }
+
+        return attributes;
+    }
+
+    /**
+     * Update the attributes of the attributes map in the VariantContextBuilder to reflect the proper
+     * chromosome-based VCF tags based on the current VC produced by builder.make()
+     *
+     * @param builder     the VariantContextBuilder we are updating
+     * @param removeStaleValues should we remove stale values from the mapping?
+     */
+    public static void calculateChromosomeCounts(VariantContextBuilder builder, boolean removeStaleValues) {
+        final VariantContext vc = builder.make();
+
+        // if everyone is a no-call, remove the old attributes if requested
+        if ( vc.getCalledChrCount() == 0 && removeStaleValues ) {
+            if ( vc.hasAttribute(VCFConstants.ALLELE_COUNT_KEY) )
+                builder.rmAttribute(VCFConstants.ALLELE_COUNT_KEY);
+            if ( vc.hasAttribute(VCFConstants.ALLELE_FREQUENCY_KEY) )
+                builder.rmAttribute(VCFConstants.ALLELE_FREQUENCY_KEY);
+            if ( vc.hasAttribute(VCFConstants.ALLELE_NUMBER_KEY) )
+                builder.rmAttribute(VCFConstants.ALLELE_NUMBER_KEY);
+            return;
+        }
+
+        if ( vc.hasGenotypes() ) {
+            builder.attribute(VCFConstants.ALLELE_NUMBER_KEY, vc.getCalledChrCount());
+
+            // if there are alternate alleles, record the relevant tags
+            if ( vc.getAlternateAlleles().size() > 0 ) {
+                ArrayList<String> alleleFreqs = new ArrayList<String>();
+                ArrayList<Integer> alleleCounts = new ArrayList<Integer>();
+                double totalChromosomes = (double)vc.getCalledChrCount();
+                for ( Allele allele : vc.getAlternateAlleles() ) {
+                    int altChromosomes = vc.getCalledChrCount(allele);
+                    alleleCounts.add(altChromosomes);
+                    String freq = String.format(makePrecisionFormatStringFromDenominatorValue(totalChromosomes), ((double)altChromosomes / totalChromosomes));
+                    alleleFreqs.add(freq);
+                }
+
+                builder.attribute(VCFConstants.ALLELE_COUNT_KEY, alleleCounts.size() == 1 ? alleleCounts.get(0) : alleleCounts);
+                builder.attribute(VCFConstants.ALLELE_FREQUENCY_KEY, alleleFreqs.size() == 1 ? alleleFreqs.get(0) : alleleFreqs);
+            }
+            else {
+                builder.attribute(VCFConstants.ALLELE_COUNT_KEY, 0);
+                builder.attribute(VCFConstants.ALLELE_FREQUENCY_KEY, 0.0);
+            }
+        }
     }
 
     private static String makePrecisionFormatStringFromDenominatorValue(double maxValue) {
@@ -348,10 +398,6 @@ public class VariantContextUtils {
         return r;
     }
 
-    public static VariantContext pruneVariantContext(VariantContext vc) {
-        return pruneVariantContext(vc, null);
-    }
-
     private final static Map<String, Object> subsetAttributes(final CommonInfo igc, final Collection<String> keysToPreserve) {
         Map<String, Object> attributes = new HashMap<String, Object>(keysToPreserve.size());
         for ( final String key : keysToPreserve  ) {
@@ -361,7 +407,19 @@ public class VariantContextUtils {
         return attributes;
     }
 
+    /**
+     * @deprecated use variant context builder version instead
+     * @param vc
+     * @param keysToPreserve
+     * @return
+     */
+    @Deprecated
     public static VariantContext pruneVariantContext(final VariantContext vc, Collection<String> keysToPreserve ) {
+        return pruneVariantContext(new VariantContextBuilder(vc), keysToPreserve).make();
+    }
+
+    public static VariantContextBuilder pruneVariantContext(final VariantContextBuilder builder, Collection<String> keysToPreserve ) {
+        final VariantContext vc = builder.make();
         if ( keysToPreserve == null ) keysToPreserve = Collections.emptyList();
 
         // VC info
@@ -375,7 +433,7 @@ public class VariantContextUtils {
                     genotypeAttributes, g.isPhased()));
         }
 
-        return new VariantContextBuilder(vc).genotypes(genotypes).attributes(attributes).make();
+        return builder.genotypes(genotypes).attributes(attributes);
     }
 
     public enum GenotypeMergeType {
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
index 3bfb81dd0..75c27e429 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
@@ -32,7 +32,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testHasAnnotsAsking1() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("9beb795536e95954f810835c6058f2ad"));
+                Arrays.asList("fbb656369eaa48153d127bd12db59d8f"));
         executeTest("test file has annotations, asking for annotations, #1", spec);
     }
 
@@ -54,9 +54,11 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
 
     @Test
     public void testNoAnnotsNotAsking2() {
+        // this genotype annotations in this file are actually out of order.  If you don't parse the genotypes
+        // they don't get reordered.  It's a good test of the genotype ordering system.
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --variant:VCF3 " + validationDataLocation + "vcfexample3empty.vcf -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -L 1:10,000,000-10,050,000", 1,
-                Arrays.asList("f2ddfa8105c290b1f34b7a261a02a1ac"));
+                Arrays.asList("0cc0ec59f0328792e6413b6ff3f71780"));
         executeTest("test file doesn't have annotations, not asking for annotations, #2", spec);
     }
 
@@ -64,7 +66,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testNoAnnotsAsking1() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard --variant:VCF3 " + validationDataLocation + "vcfexample2empty.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("49d989f467b8d6d8f98f7c1b67cd4a05"));
+                Arrays.asList("42dd979a0a931c18dc9be40308bac321"));
         executeTest("test file doesn't have annotations, asking for annotations, #1", spec);
     }
 
@@ -80,7 +82,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
     public void testExcludeAnnotations() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -G Standard -XA FisherStrand -XA ReadPosRankSumTest --variant:VCF3 " + validationDataLocation + "vcfexample2empty.vcf -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("33062eccd6eb73bc49440365430454c4"));
+                Arrays.asList("477eac07989593b58bb361f3429c085a"));
         executeTest("test exclude annotations", spec);
     }
 

From f392d330c3ba13a0ed8bb83f7b99f4d2a2cde522 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sat, 19 Nov 2011 22:09:56 -0500
Subject: [PATCH 074/113] Proper use of builder.  Previous conversion attempt
 was flawed

---
 .../walkers/phasing/ReadBackedPhasingWalker.java   | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
index dc0acfb6a..9470ce2f4 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/ReadBackedPhasingWalker.java
@@ -1122,7 +1122,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         private int start;
         private int stop;
         private Collection<Allele> alleles;
-        private GenotypesContext genotypes;
+        private Map<String,Genotype> genotypes;
         private double log10PError;
         private Set<String> filters;
         private Map<String, Object> attributes;
@@ -1135,15 +1135,21 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
             this.start = vc.getStart();
             this.stop = vc.getEnd();
             this.alleles = vc.getAlleles();
-            this.genotypes = GenotypesContext.copy(vc.getGenotypes()); // since vc.getGenotypes() is unmodifiable
+
+            this.genotypes = new HashMap<String, Genotype>();
+            for ( final Genotype g : vc.getGenotypes() ) {
+                this.genotypes.put(g.getSampleName(), g);
+            }
+
             this.log10PError = vc.getLog10PError();
             this.filters = vc.filtersWereApplied() ? vc.getFilters() : null;
             this.attributes = new HashMap<String, Object>(vc.getAttributes());
         }
 
         public VariantContext toVariantContext() {
+            GenotypesContext gc = GenotypesContext.copy(this.genotypes.values());
             return new VariantContextBuilder(name, contig, start, stop, alleles).id(id)
-                    .genotypes(genotypes).log10PError(log10PError).filters(filters).attributes(attributes).make();
+                    .genotypes(gc).log10PError(log10PError).filters(filters).attributes(attributes).make();
         }
 
         public GenomeLoc getLocation() {
@@ -1155,7 +1161,7 @@ public class ReadBackedPhasingWalker extends RodWalker<PhasingStatsAndOutput, Ph
         }
 
         public void setGenotype(String sample, Genotype newGt) {
-            genotypes.add(newGt);
+            this.genotypes.put(sample, newGt);
         }
 
         public void setPhasingInconsistent() {

From 9cb3fe3a591235bb713479647a56a9206939b232 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sun, 20 Nov 2011 08:23:09 -0500
Subject: [PATCH 075/113] Vastly better way of doing on-demand genotyping
 loading

-- With our GenotypesContext class we can naturally create a LazyGenotypesContext subclass that does the on-demand loading.
-- This new class was replaced all of the old, complex functionality
-- Better still, there were many cases were the genotypes were being loaded unnecessarily, resulting in efficiency.  This was detected because some of the integration tests changed as the genotypes were no longer being parsing unnecessarily
-- Misc. bug fixes throughout the system
-- Bug fixes for PhaseByTransmission with new GenotypesContext
---
 .../walkers/phasing/PhaseByTransmission.java  |  20 ++-
 .../utils/codecs/vcf/AbstractVCFCodec.java    |  15 +-
 .../utils/codecs/vcf/StandardVCFWriter.java   |   8 +-
 .../sting/utils/codecs/vcf/VCF3Codec.java     |   4 +-
 .../broadinstitute/sting/utils/gcf/GCF.java   |   2 -
 .../variantcontext/GenotypesContext.java      | 113 ++++++++++------
 .../variantcontext/LazyGenotypesContext.java  | 128 ++++++++++++++++++
 .../utils/variantcontext/VariantContext.java  |  54 +-------
 .../variantcontext/VariantContextBuilder.java |  20 +--
 .../VariantFiltrationIntegrationTest.java     |  50 +++++--
 10 files changed, 274 insertions(+), 140 deletions(-)
 create mode 100644 public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
index 8585104d5..fee87b21f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/phasing/PhaseByTransmission.java
@@ -746,11 +746,9 @@ public class PhaseByTransmission extends RodWalker<HashMap<Byte,Integer>, HashMa
 
         if (tracker != null) {
             VariantContext vc = tracker.getFirstValue(variantCollection.variants, context.getLocation());
+            VariantContextBuilder builder = new VariantContextBuilder(vc);
 
-            GenotypesContext genotypeMap = vc.getGenotypes();
-
-            int mvCount;
-
+            GenotypesContext genotypesContext = GenotypesContext.copy(vc.getGenotypes());
             for (Sample sample : trios) {
                 Genotype mother = vc.getGenotype(sample.getMaternalID());
                 Genotype father = vc.getGenotype(sample.getPaternalID());
@@ -761,18 +759,18 @@ public class PhaseByTransmission extends RodWalker<HashMap<Byte,Integer>, HashMa
                     continue;
 
                 ArrayList<Genotype> trioGenotypes = new ArrayList<Genotype>(3);
-                mvCount = phaseTrioGenotypes(vc.getReference(), vc.getAltAlleleWithHighestAlleleCount(), mother, father, child,trioGenotypes);
+                final int mvCount = phaseTrioGenotypes(vc.getReference(), vc.getAltAlleleWithHighestAlleleCount(), mother, father, child,trioGenotypes);
 
                 Genotype phasedMother = trioGenotypes.get(0);
                 Genotype phasedFather = trioGenotypes.get(1);
                 Genotype phasedChild = trioGenotypes.get(2);
 
                 //Fill the genotype map with the new genotypes and increment metrics counters
-                genotypeMap.add(phasedChild);
+                genotypesContext.replace(phasedChild);
                 if(mother != null){
-                    genotypeMap.add(phasedMother);
+                    genotypesContext.replace(phasedMother);
                     if(father != null){
-                        genotypeMap.add(phasedFather);
+                        genotypesContext.replace(phasedFather);
                         updateTrioMetricsCounters(phasedMother,phasedFather,phasedChild,mvCount,metricsCounters);
                         mvfLine = String.format("%s\t%d\t%s\t%s\t%s\t%s\t%s:%s:%s:%s\t%s:%s:%s:%s\t%s:%s:%s:%s",vc.getChr(),vc.getStart(),vc.getFilters(),vc.getAttribute(VCFConstants.ALLELE_COUNT_KEY),sample.toString(),phasedMother.getAttribute(TRANSMISSION_PROBABILITY_TAG_NAME),phasedMother.getGenotypeString(),phasedMother.getAttribute(VCFConstants.DEPTH_KEY),phasedMother.getAttribute("AD"),phasedMother.getLikelihoods().toString(),phasedFather.getGenotypeString(),phasedFather.getAttribute(VCFConstants.DEPTH_KEY),phasedFather.getAttribute("AD"),phasedFather.getLikelihoods().toString(),phasedChild.getGenotypeString(),phasedChild.getAttribute(VCFConstants.DEPTH_KEY),phasedChild.getAttribute("AD"),phasedChild.getLikelihoods().toString());
                         if(!(phasedMother.getType()==mother.getType() && phasedFather.getType()==father.getType() && phasedChild.getType()==child.getType()))
@@ -786,7 +784,7 @@ public class PhaseByTransmission extends RodWalker<HashMap<Byte,Integer>, HashMa
                     }
                 }
                 else{
-                    genotypeMap.add(phasedFather);
+                    genotypesContext.replace(phasedFather);
                     updatePairMetricsCounters(phasedFather,phasedChild,mvCount,metricsCounters);
                     if(!(phasedFather.getType()==father.getType() && phasedChild.getType()==child.getType()))
                         metricsCounters.put(NUM_GENOTYPES_MODIFIED,metricsCounters.get(NUM_GENOTYPES_MODIFIED)+1);
@@ -797,10 +795,10 @@ public class PhaseByTransmission extends RodWalker<HashMap<Byte,Integer>, HashMa
                 //TODO: ADAPT FOR PAIRS TOO!!
                 if(mvCount>0 && mvFile != null)
                     mvFile.println(mvfLine);
-
             }
 
-            vcfWriter.add(new VariantContextBuilder(vc).genotypes(genotypeMap).make());
+            builder.genotypes(genotypesContext);
+            vcfWriter.add(builder.make());
         }
         return metricsCounters;
     }
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index abd81fe61..ee3184dc2 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -10,10 +10,7 @@ import org.broad.tribble.util.BlockCompressedInputStream;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextBuilder;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.*;
 import java.util.*;
@@ -255,11 +252,14 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
      */
     private VariantContext parseVCFLine(String[] parts) {
         VariantContextBuilder builder = new VariantContextBuilder();
+        builder.source(getName());
+
         // increment the line count
         lineNo++;
 
         // parse out the required fields
-        builder.chr(getCachedString(parts[0]));
+        final String chr = getCachedString(parts[0]);
+        builder.chr(chr);
         int pos = Integer.valueOf(parts[1]);
         builder.start(pos);
 
@@ -294,9 +294,8 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
 
         // do we have genotyping data
         if (parts.length > NUM_STANDARD_FIELDS) {
-            builder.attribute(VariantContext.UNPARSED_GENOTYPE_MAP_KEY, new String(parts[8]));
-            builder.attribute(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY, this);
-            builder.genotypesAreUnparsed();
+            LazyGenotypesContext lazy = new LazyGenotypesContext(this, parts[8], chr, pos, alleles, header.getGenotypeSamples().size());
+            builder.genotypesNoValidation(lazy);
         }
 
         VariantContext vc = null;
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
index 92c8840fb..7a496cb7c 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
@@ -219,9 +219,6 @@ public class StandardVCFWriter extends IndexingVCFWriter {
             Map<String, String> infoFields = new TreeMap<String, String>();
             for ( Map.Entry<String, Object> field : vc.getAttributes().entrySet() ) {
                 String key = field.getKey();
-                if ( key.equals(VariantContext.UNPARSED_GENOTYPE_MAP_KEY) || key.equals(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY) )
-                    continue;
-
                 String outputValue = formatVCFField(field.getValue());
                 if ( outputValue != null )
                     infoFields.put(key, outputValue);
@@ -229,9 +226,10 @@ public class StandardVCFWriter extends IndexingVCFWriter {
             writeInfoString(infoFields);
 
             // FORMAT
-            if ( vc.hasAttribute(VariantContext.UNPARSED_GENOTYPE_MAP_KEY) ) {
+            final GenotypesContext gc = vc.getGenotypes();
+            if ( gc instanceof LazyGenotypesContext && ((LazyGenotypesContext)gc).getUnparsedGenotypeData() != null) {
                 mWriter.write(VCFConstants.FIELD_SEPARATOR);
-                mWriter.write(vc.getAttributeAsString(VariantContext.UNPARSED_GENOTYPE_MAP_KEY, ""));
+                mWriter.write(((LazyGenotypesContext)gc).getUnparsedGenotypeData());
             } else {
                 List<String> genotypeAttributeKeys = new ArrayList<String>();
                 if ( vc.hasGenotypes() ) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
index 7d71a9c5a..5e6e2e94a 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
@@ -124,7 +124,7 @@ public class VCF3Codec extends AbstractVCFCodec {
 
         int nParts = ParsingUtils.split(str, genotypeParts, VCFConstants.FIELD_SEPARATOR_CHAR);
 
-        GenotypesContext genotypes = GenotypesContext.create(nParts);
+        ArrayList<Genotype> genotypes = new ArrayList<Genotype>(nParts);
 
         // get the format keys
         int nGTKeys = ParsingUtils.split(genotypeParts[0], genotypeKeyArray, VCFConstants.GENOTYPE_FIELD_SEPARATOR_CHAR);
@@ -191,7 +191,7 @@ public class VCF3Codec extends AbstractVCFCodec {
             }
         }
 
-        return genotypes;
+        return GenotypesContext.create(genotypes, header.sampleNameToOffset, header.sampleNamesInOrder);
     }
 
     @Override
diff --git a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
index e754c215d..b4ad81c02 100644
--- a/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
+++ b/public/java/src/org/broadinstitute/sting/utils/gcf/GCF.java
@@ -191,8 +191,6 @@ public class GCF {
         boolean first = true;
         for ( Map.Entry<String, Object> field : vc.getAttributes().entrySet() ) {
             String key = field.getKey();
-            if ( key.equals(VariantContext.UNPARSED_GENOTYPE_MAP_KEY) || key.equals(VariantContext.UNPARSED_GENOTYPE_PARSER_KEY) )
-                continue;
             int stringIndex = GCFHeaderBuilder.encodeString(key);
             String outputValue = StandardVCFWriter.formatVCFField(field.getValue());
             if ( outputValue != null ) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 47e6b2fbe..846e6c89c 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -55,8 +55,14 @@ public class GenotypesContext implements List<Genotype> {
     /** if true, then we need to reinitialize sampleNamesInOrder and sampleNameToOffset before we use them /*/
     boolean cacheIsInvalid = true;
 
-    /** An ArrayList of genotypes contained in this context */
-    List<Genotype> genotypes;
+    /**
+     * An ArrayList of genotypes contained in this context
+     *
+     * WARNING: TO ENABLE THE LAZY VERSION OF THIS CLASS, NO METHODS SHOULD DIRECTLY
+     * ACCESS THIS VARIABLE.  USE getGenotypes() INSTEAD.
+     *
+     */
+    ArrayList<Genotype> notToBeDirectlyAccessedGenotypes;
 
     /** Are we allowing users to modify the list? */
     boolean immutable = false;
@@ -70,7 +76,7 @@ public class GenotypesContext implements List<Genotype> {
     /**
      * Create an empty GenotypeContext
      */
-    private GenotypesContext() {
+    protected GenotypesContext() {
         this(10, false);
     }
 
@@ -78,7 +84,7 @@ public class GenotypesContext implements List<Genotype> {
      * Create an empty GenotypeContext, with initial capacity for n elements
      */
     @Requires("n >= 0")
-    private GenotypesContext(final int n, final boolean immutable) {
+    protected GenotypesContext(final int n, final boolean immutable) {
         this(new ArrayList<Genotype>(n), immutable);
     }
 
@@ -86,8 +92,8 @@ public class GenotypesContext implements List<Genotype> {
      * Create an GenotypeContext containing genotypes
      */
     @Requires("genotypes != null")
-    private GenotypesContext(final ArrayList<Genotype> genotypes, final boolean immutable) {
-        this.genotypes = genotypes;
+    protected GenotypesContext(final ArrayList<Genotype> genotypes, final boolean immutable) {
+        this.notToBeDirectlyAccessedGenotypes = genotypes;
         this.immutable = immutable;
         this.sampleNameToOffset = null;
         this.cacheIsInvalid = true;
@@ -110,11 +116,11 @@ public class GenotypesContext implements List<Genotype> {
             "sampleNamesInOrder != null",
             "genotypes.size() == sampleNameToOffset.size()",
             "genotypes.size() == sampleNamesInOrder.size()"})
-    private GenotypesContext(final ArrayList<Genotype> genotypes,
+    protected GenotypesContext(final ArrayList<Genotype> genotypes,
                              final Map<String, Integer> sampleNameToOffset,
                              final List<String> sampleNamesInOrder,
                              final boolean immutable) {
-        this.genotypes = genotypes;
+        this.notToBeDirectlyAccessedGenotypes = genotypes;
         this.immutable = immutable;
         this.sampleNameToOffset = sampleNameToOffset;
         this.sampleNamesInOrder = sampleNamesInOrder;
@@ -203,7 +209,7 @@ public class GenotypesContext implements List<Genotype> {
     @Requires({"toCopy != null"})
     @Ensures({"result != null"})
     public static final GenotypesContext copy(final GenotypesContext toCopy) {
-        return create(new ArrayList<Genotype>(toCopy.genotypes));
+        return create(new ArrayList<Genotype>(toCopy.getGenotypes()));
     }
 
     /**
@@ -225,7 +231,6 @@ public class GenotypesContext implements List<Genotype> {
     // ---------------------------------------------------------------------------
 
     public final GenotypesContext immutable() {
-        this.genotypes = Collections.unmodifiableList(genotypes);
         immutable = true;
         return this;
     }
@@ -255,16 +260,16 @@ public class GenotypesContext implements List<Genotype> {
     @Ensures({"cacheIsInvalid == false",
             "sampleNamesInOrder != null",
             "sampleNameToOffset != null",
-            "sameSamples(genotypes, sampleNamesInOrder)",
-            "sameSamples(genotypes, sampleNameToOffset.keySet())"})
-    private synchronized void buildCache() {
+            "sameSamples(notToBeDirectlyAccessedGenotypes, sampleNamesInOrder)",
+            "sameSamples(notToBeDirectlyAccessedGenotypes, sampleNameToOffset.keySet())"})
+    protected synchronized void buildCache() {
         if ( cacheIsInvalid ) {
             cacheIsInvalid = false;
-            sampleNamesInOrder = new ArrayList<String>(genotypes.size());
-            sampleNameToOffset = new HashMap<String, Integer>(genotypes.size());
+            sampleNamesInOrder = new ArrayList<String>(size());
+            sampleNameToOffset = new HashMap<String, Integer>(size());
 
-            for ( int i = 0; i < genotypes.size(); i++ ) {
-                final Genotype g = genotypes.get(i);
+            for ( int i = 0; i < size(); i++ ) {
+                final Genotype g = getGenotypes().get(i);
                 sampleNamesInOrder.add(g.getSampleName());
                 sampleNameToOffset.put(g.getSampleName(), i);
             }
@@ -279,20 +284,24 @@ public class GenotypesContext implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
+    protected ArrayList<Genotype> getGenotypes() {
+        return notToBeDirectlyAccessedGenotypes;
+    }
+
     @Override
     public void clear() {
         checkImmutability();
-        genotypes.clear();
+        getGenotypes().clear();
     }
 
     @Override
     public int size() {
-        return genotypes.size();
+        return getGenotypes().size();
     }
 
     @Override
     public boolean isEmpty() {
-        return genotypes.isEmpty();
+        return getGenotypes().isEmpty();
     }
 
     @Override
@@ -300,14 +309,14 @@ public class GenotypesContext implements List<Genotype> {
     public boolean add(final Genotype genotype) {
         checkImmutability();
         invalidateCaches();
-        return genotypes.add(genotype);
+        return getGenotypes().add(genotype);
     }
 
     @Requires("genotype != null")
     public boolean add(final Genotype ... genotype) {
         checkImmutability();
         invalidateCaches();
-        return genotypes.addAll(Arrays.asList(genotype));
+        return getGenotypes().addAll(Arrays.asList(genotype));
     }
 
     @Override
@@ -319,7 +328,7 @@ public class GenotypesContext implements List<Genotype> {
     public boolean addAll(final Collection<? extends Genotype> genotypes) {
         checkImmutability();
         invalidateCaches();
-        return this.genotypes.addAll(genotypes);
+        return getGenotypes().addAll(genotypes);
     }
 
     @Override
@@ -329,38 +338,43 @@ public class GenotypesContext implements List<Genotype> {
 
     @Override
     public boolean contains(final Object o) {
-        return this.genotypes.contains(o);
+        return getGenotypes().contains(o);
     }
 
     @Override
     public boolean containsAll(final Collection<?> objects) {
-        return this.genotypes.containsAll(objects);
+        return getGenotypes().containsAll(objects);
     }
 
     @Override
     public Genotype get(final int i) {
-        return genotypes.get(i);
+        return getGenotypes().get(i);
     }
 
     public Genotype get(final String sampleName) {
         buildCache();
-        Integer offset = sampleNameToOffset.get(sampleName);
-        return offset == null ? null : genotypes.get(offset);
+        Integer offset = getSampleI(sampleName);
+        return offset == null ? null : getGenotypes().get(offset);
+    }
+
+    private Integer getSampleI(final String sampleName) {
+        buildCache();
+        return sampleNameToOffset.get(sampleName);
     }
 
     @Override
     public int indexOf(final Object o) {
-        return genotypes.indexOf(o);
+        return getGenotypes().indexOf(o);
     }
 
     @Override
     public Iterator<Genotype> iterator() {
-        return genotypes.iterator();
+        return getGenotypes().iterator();
     }
 
     @Override
     public int lastIndexOf(final Object o) {
-        return genotypes.lastIndexOf(o);
+        return getGenotypes().lastIndexOf(o);
     }
 
     @Override
@@ -381,50 +395,67 @@ public class GenotypesContext implements List<Genotype> {
     public Genotype remove(final int i) {
         checkImmutability();
         invalidateCaches();
-        return genotypes.remove(i);
+        return getGenotypes().remove(i);
     }
 
     @Override
     public boolean remove(final Object o) {
         checkImmutability();
         invalidateCaches();
-        return genotypes.remove(o);
+        return getGenotypes().remove(o);
     }
 
     @Override
     public boolean removeAll(final Collection<?> objects) {
         checkImmutability();
         invalidateCaches();
-        return genotypes.removeAll(objects);
+        return getGenotypes().removeAll(objects);
     }
 
     @Override
     public boolean retainAll(final Collection<?> objects) {
         checkImmutability();
         invalidateCaches();
-        return genotypes.retainAll(objects);
+        return getGenotypes().retainAll(objects);
     }
 
     @Override
     public Genotype set(final int i, final Genotype genotype) {
         checkImmutability();
         invalidateCaches();
-        return genotypes.set(i, genotype);
+        return getGenotypes().set(i, genotype);
+    }
+
+    /**
+     * Replaces the genotype in this context -- note for efficiency
+     * reasons we do not add the genotype if it's not present.  The
+     * return value will be null indicating this happened.
+     * @param genotype a non null genotype to bind in this context
+     * @return null if genotype was not added, otherwise returns the previous genotype
+     */
+    @Requires("genotype != null")
+    public Genotype replace(final Genotype genotype) {
+        checkImmutability();
+        Integer offset = getSampleI(genotype.getSampleName());
+        if ( offset == null )
+            return null;
+        else
+            return getGenotypes().set(offset, genotype);
     }
 
     @Override
     public List<Genotype> subList(final int i, final int i1) {
-        return genotypes.subList(i, i1);
+        return getGenotypes().subList(i, i1);
     }
 
     @Override
     public Object[] toArray() {
-        return genotypes.toArray();
+        return getGenotypes().toArray();
     }
 
     @Override
     public <T> T[] toArray(final T[] ts) {
-        return genotypes.toArray(ts);
+        return getGenotypes().toArray(ts);
     }
 
     /**
@@ -528,13 +559,13 @@ public class GenotypesContext implements List<Genotype> {
     @Requires("samples != null")
     @Ensures("result != null")
     public GenotypesContext subsetToSamples( final Set<String> samples ) {
-        if ( samples.size() == genotypes.size() )
+        if ( samples.size() == size() )
             return this;
         else if ( samples.isEmpty() )
             return NO_GENOTYPES;
         else {
             GenotypesContext subset = create(samples.size());
-            for ( final Genotype g : genotypes ) {
+            for ( final Genotype g : getGenotypes() ) {
                 if ( samples.contains(g.getSampleName()) ) {
                     subset.add(g);
                 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
new file mode 100644
index 000000000..ca2d7a812
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
@@ -0,0 +1,128 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.utils.variantcontext;
+
+import org.broadinstitute.sting.utils.codecs.vcf.VCFParser;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * [Short one sentence description of this walker]
+ * <p/>
+ * <p>
+ * [Functionality of this walker]
+ * </p>
+ * <p/>
+ * <h2>Input</h2>
+ * <p>
+ * [Input description]
+ * </p>
+ * <p/>
+ * <h2>Output</h2>
+ * <p>
+ * [Output description]
+ * </p>
+ * <p/>
+ * <h2>Examples</h2>
+ * <pre>
+ *    java
+ *      -jar GenomeAnalysisTK.jar
+ *      -T $WalkerName
+ *  </pre>
+ *
+ * @author Your Name
+ * @since Date created
+ */
+public class LazyGenotypesContext extends GenotypesContext {
+    final VCFParser parser;
+    String unparsedGenotypeData;
+    final List<Allele> alleles;
+    final String contig;
+    final int start;
+    final int nUnparsedGenotypes;
+
+    boolean loaded = false;
+
+    private final static ArrayList<Genotype> EMPTY = new ArrayList<Genotype>(0);
+
+    public LazyGenotypesContext(final VCFParser parser, final String unparsedGenotypeData,
+                                final String contig, final int start, final List<Allele> alleles,
+                                int nUnparsedGenotypes ) {
+        super(EMPTY, false);
+        this.unparsedGenotypeData = unparsedGenotypeData;
+        this.start = start;
+        this.parser = parser;
+        this.contig = contig;
+        this.alleles = alleles;
+        this.nUnparsedGenotypes = nUnparsedGenotypes;
+    }
+
+    @Override
+    protected ArrayList<Genotype> getGenotypes() {
+        if ( ! loaded ) {
+            //System.out.printf("Loading genotypes... %s:%d%n", contig, start);
+            GenotypesContext subcontext = parser.createGenotypeMap(unparsedGenotypeData, alleles, contig, start);
+            notToBeDirectlyAccessedGenotypes = subcontext.notToBeDirectlyAccessedGenotypes;
+            sampleNamesInOrder = subcontext.sampleNamesInOrder;
+            sampleNameToOffset = subcontext.sampleNameToOffset;
+            cacheIsInvalid = false;
+            loaded = true;
+            unparsedGenotypeData = null;
+
+            // warning -- this path allows us to create a VariantContext that doesn't run validateGenotypes()
+            // That said, it's not such an important routine -- it's just checking that the genotypes
+            // are well formed w.r.t. the alleles list, but this will be enforced within the VCFCodec
+        }
+
+        return notToBeDirectlyAccessedGenotypes;
+    }
+
+    protected synchronized void buildCache() {
+        if ( cacheIsInvalid ) {
+            getGenotypes(); // will load up all of the necessary data
+        }
+    }
+
+    @Override
+    public boolean isEmpty() {
+        // optimization -- we know the number of samples in the unparsed data, so use it here to
+        // avoid parsing just to know if the genotypes context is empty
+        return loaded ? super.isEmpty() : nUnparsedGenotypes == 0;
+    }
+
+    @Override
+    public int size() {
+        // optimization -- we know the number of samples in the unparsed data, so use it here to
+        // avoid parsing just to know the size of the context
+        return loaded ? super.size() : nUnparsedGenotypes;
+    }
+
+    public String getUnparsedGenotypeData() {
+        return unparsedGenotypeData;
+    }
+}
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 34131b9c4..8d74f5220 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -165,8 +165,6 @@ import java.util.*;
 public class VariantContext implements Feature { // to enable tribble intergration
     protected CommonInfo commonInfo = null;
     public final static double NO_LOG10_PERROR = CommonInfo.NO_LOG10_PERROR;
-    public final static String UNPARSED_GENOTYPE_MAP_KEY = "_UNPARSED_GENOTYPE_MAP_";
-    public final static String UNPARSED_GENOTYPE_PARSER_KEY = "_UNPARSED_GENOTYPE_PARSER_";
 
     @Deprecated // ID is no longer stored in the attributes map
     private final static String ID_KEY = "ID";
@@ -231,7 +229,11 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param other the VariantContext to copy
      */
     protected VariantContext(VariantContext other) {
-        this(other.getSource(), other.getID(), other.getChr(), other.getStart(), other.getEnd() , other.getAlleles(), other.getGenotypes(), other.getLog10PError(), other.filtersWereApplied() ? other.getFilters() : null, other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL, false, NO_VALIDATION);
+        this(other.getSource(), other.getID(), other.getChr(), other.getStart(), other.getEnd(),
+                other.getAlleles(), other.getGenotypes(), other.getLog10PError(),
+                other.getFiltersMaybeNull(),
+                other.getAttributes(), other.REFERENCE_BASE_FOR_INDEL,
+                NO_VALIDATION);
     }
 
     /**
@@ -247,14 +249,13 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @param filters         filters: use null for unfiltered and empty set for passes filters
      * @param attributes      attributes
      * @param referenceBaseForIndel   padded reference base
-     * @param genotypesAreUnparsed    true if the genotypes have not yet been parsed
      * @param validationToPerform     set of validation steps to take
      */
     protected VariantContext(String source, String ID,
                            String contig, long start, long stop,
                            Collection<Allele> alleles, GenotypesContext genotypes,
                            double log10PError, Set<String> filters, Map<String, Object> attributes,
-                           Byte referenceBaseForIndel, boolean genotypesAreUnparsed,
+                           Byte referenceBaseForIndel,
                            EnumSet<Validation> validationToPerform ) {
         if ( contig == null ) { throw new IllegalArgumentException("Contig cannot be null"); }
         this.contig = contig;
@@ -265,17 +266,6 @@ public class VariantContext implements Feature { // to enable tribble intergrati
         if ( ID == null || ID.equals("") ) throw new IllegalArgumentException("ID field cannot be the null or the empty string");
         this.ID = ID.equals(VCFConstants.EMPTY_ID_FIELD) ? VCFConstants.EMPTY_ID_FIELD : ID;
 
-        if ( !genotypesAreUnparsed && attributes != null ) {
-            if ( attributes.containsKey(UNPARSED_GENOTYPE_MAP_KEY) ) {
-                attributes = new HashMap<String, Object>(attributes);
-                attributes.remove(UNPARSED_GENOTYPE_MAP_KEY);
-            }
-            if ( attributes.containsKey(UNPARSED_GENOTYPE_PARSER_KEY) ) {
-                attributes = new HashMap<String, Object>(attributes);
-                attributes.remove(UNPARSED_GENOTYPE_PARSER_KEY);
-            }
-        }
-
         this.commonInfo = new CommonInfo(source, log10PError, filters, attributes);
         REFERENCE_BASE_FOR_INDEL = referenceBaseForIndel;
 
@@ -316,13 +306,11 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     // ---------------------------------------------------------------------------------------------------------
 
     public VariantContext subContextFromSamples(Set<String> sampleNames, Collection<Allele> alleles) {
-        loadGenotypes();
         VariantContextBuilder builder = new VariantContextBuilder(this);
         return builder.genotypes(genotypes.subsetToSamples(sampleNames)).alleles(alleles).make();
     }
 
     public VariantContext subContextFromSamples(Set<String> sampleNames) {
-        loadGenotypes();
         VariantContextBuilder builder = new VariantContextBuilder(this);
         GenotypesContext newGenotypes = genotypes.subsetToSamples(sampleNames);
         return builder.genotypes(newGenotypes).alleles(allelesOfGenotypes(newGenotypes)).make();
@@ -698,35 +686,10 @@ public class VariantContext implements Feature { // to enable tribble intergrati
     //
     // ---------------------------------------------------------------------------------------------------------
 
-    private void loadGenotypes() {
-        if ( !hasAttribute(UNPARSED_GENOTYPE_MAP_KEY) ) {
-            if ( genotypes == null )
-                genotypes = NO_GENOTYPES;
-            return;
-        }
-
-        Object parserObj = getAttribute(UNPARSED_GENOTYPE_PARSER_KEY);
-        if ( parserObj == null || !(parserObj instanceof VCFParser) )
-            throw new IllegalStateException("There is no VCF parser stored to unparse the genotype data");
-        VCFParser parser = (VCFParser)parserObj;
-
-        Object mapObj = getAttribute(UNPARSED_GENOTYPE_MAP_KEY);
-        if ( mapObj == null )
-            throw new IllegalStateException("There is no mapping string stored to unparse the genotype data");
-
-        genotypes = parser.createGenotypeMap(mapObj.toString(), new ArrayList<Allele>(alleles), getChr(), getStart());
-
-        commonInfo.removeAttribute(UNPARSED_GENOTYPE_MAP_KEY);
-        commonInfo.removeAttribute(UNPARSED_GENOTYPE_PARSER_KEY);
-
-        validateGenotypes();
-    }
-
     /**
      * @return the number of samples in the context
      */
     public int getNSamples() {
-        loadGenotypes();
         return genotypes.size();
     }
 
@@ -734,12 +697,10 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return true if the context has associated genotypes
      */
     public boolean hasGenotypes() {
-        loadGenotypes();
         return ! genotypes.isEmpty();
     }
 
     public boolean hasGenotypes(Collection<String> sampleNames) {
-        loadGenotypes();
         return genotypes.containsSamples(sampleNames);
     }
 
@@ -747,17 +708,14 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @return set of all Genotypes associated with this context
      */
     public GenotypesContext getGenotypes() {
-        loadGenotypes();
         return genotypes;
     }
 
     public Iterable<Genotype> getGenotypesOrderedByName() {
-        loadGenotypes();
         return genotypes.iterateInSampleNameOrder();
     }
 
     public Iterable<Genotype> getGenotypesOrderedBy(Iterable<String> sampleOrdering) {
-        loadGenotypes();
         return genotypes.iterateInSampleNameOrder(sampleOrdering);
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
index 379a01bb4..b79584df8 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextBuilder.java
@@ -72,7 +72,6 @@ public class VariantContextBuilder {
     private Map<String, Object> attributes = null;
     private boolean attributesCanBeModified = false;
     private Byte referenceBaseForIndel = null;
-    private boolean genotypesAreUnparsed = false;
 
     /** enum of what must be validated */
     final private EnumSet<VariantContext.Validation> toValidate = EnumSet.noneOf(VariantContext.Validation.class);
@@ -112,7 +111,6 @@ public class VariantContextBuilder {
         this.contig = parent.contig;
         this.filters = parent.getFiltersMaybeNull();
         this.genotypes = parent.genotypes;
-        this.genotypesAreUnparsed = parent.hasAttribute(VariantContext.UNPARSED_GENOTYPE_MAP_KEY);
         this.ID = parent.getID();
         this.log10PError = parent.getLog10PError();
         this.referenceBaseForIndel = parent.getReferenceBaseForIndel();
@@ -179,7 +177,7 @@ public class VariantContextBuilder {
 
     /**
      * Makes the attributes field modifiable.  In many cases attributes is just a pointer to an immutable
-     * collection, so methods that want to add / remove records require the attributes to be copied first
+     * collection, so methods that want to add / remove records require the attributes to be copied to a
      */
     private void makeAttributesModifiable() {
         if ( ! attributesCanBeModified ) {
@@ -243,6 +241,11 @@ public class VariantContextBuilder {
         return this;
     }
 
+    public VariantContextBuilder genotypesNoValidation(final GenotypesContext genotypes) {
+        this.genotypes = genotypes;
+        return this;
+    }
+
     /**
      * Tells this builder that the resulting VariantContext should use a GenotypeContext containing genotypes
      *
@@ -270,15 +273,6 @@ public class VariantContextBuilder {
         return this;
     }
 
-    /**
-     * ADVANCED! tells us that the genotypes data is stored as an unparsed attribute
-     * @return
-     */
-    public VariantContextBuilder genotypesAreUnparsed() {
-        this.genotypesAreUnparsed = true;
-        return this;
-    }
-
     /**
      * Tells us that the resulting VariantContext should have ID
      * @param ID
@@ -395,6 +389,6 @@ public class VariantContextBuilder {
     public VariantContext make() {
         return new VariantContext(source, ID, contig, start, stop, alleles,
                 genotypes, log10PError, filters, attributes,
-                referenceBaseForIndel, genotypesAreUnparsed, toValidate);
+                referenceBaseForIndel, toValidate);
     }
 }
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationIntegrationTest.java
index 1cb43ceb1..c2348b4a3 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationIntegrationTest.java
@@ -14,9 +14,12 @@ public class VariantFiltrationIntegrationTest extends WalkerTest {
 
     @Test
     public void testNoAction() {
+        // note that this input if slightly malformed, but with the new properly
+        // only when really needed genotype loading of VCF files we don't actually
+        // fix the file in the output
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("8a105fa5eebdfffe7326bc5b3d8ffd1c"));
+                Arrays.asList("b7b7c218e219cd923ce5b6eefc5b7171"));
         executeTest("test no action", spec);
     }
 
@@ -24,59 +27,86 @@ public class VariantFiltrationIntegrationTest extends WalkerTest {
     public void testClusteredSnps() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -window 10 --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("27b13f179bb4920615dff3a32730d845"));
+                Arrays.asList("6d45a19e4066e7de6ff6a61f43ffad2b"));
         executeTest("test clustered SNPs", spec);
     }
 
     @Test
-    public void testMasks() {
+    public void testMask1() {
+        // note that this input if slightly malformed, but with the new properly
+        // only when really needed genotype loading of VCF files we don't actually
+        // fix the file in the output
         WalkerTestSpec spec1 = new WalkerTestSpec(
                 baseTestString() + " -maskName foo --mask:VCF3 " + validationDataLocation + "vcfexample2.vcf --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("578f9e774784c25871678e6464fd212b"));
+                Arrays.asList("65b5006bf3ee9d9d08a36d6b854773f2"));
         executeTest("test mask all", spec1);
+    }
 
+    @Test
+    public void testMask2() {
+        // note that this input if slightly malformed, but with the new properly
+        // only when really needed genotype loading of VCF files we don't actually
+        // fix the file in the output
         WalkerTestSpec spec2 = new WalkerTestSpec(
                 baseTestString() + " -maskName foo --mask:VCF " + validationDataLocation + "vcfMask.vcf --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("bfa86a674aefca1b13d341cb14ab3c4f"));
+                Arrays.asList("a275d36baca81a1ce03dbb528e95a069"));
         executeTest("test mask some", spec2);
+    }
 
+    @Test
+    public void testMask3() {
+        // note that this input if slightly malformed, but with the new properly
+        // only when really needed genotype loading of VCF files we don't actually
+        // fix the file in the output
         WalkerTestSpec spec3 = new WalkerTestSpec(
                 baseTestString() + " -maskName foo -maskExtend 10 --mask:VCF " + validationDataLocation + "vcfMask.vcf --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("5939f80d14b32d88587373532d7b90e5"));
+                Arrays.asList("c9489e1c1342817c36ab4f0770609bdb"));
         executeTest("test mask extend", spec3);
     }
 
     @Test
     public void testFilter1() {
         WalkerTestSpec spec = new WalkerTestSpec(
+        // note that this input if slightly malformed, but with the new properly
+        // only when really needed genotype loading of VCF files we don't actually
+        // fix the file in the output
                 baseTestString() + " -filter 'DoC < 20 || FisherStrand > 20.0' -filterName foo --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("45219dbcfb6f81bba2ea0c35f5bfd368"));
+                Arrays.asList("327a611bf82c6c4ae77fbb6d06359f9d"));
         executeTest("test filter #1", spec);
     }
 
     @Test
     public void testFilter2() {
+        // note that this input if slightly malformed, but with the new properly
+        // only when really needed genotype loading of VCF files we don't actually
+        // fix the file in the output
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -filter 'AlleleBalance < 70.0 && FisherStrand == 1.4' -filterName bar --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("c95845e817da7352b9b72bc9794f18fb"));
+                Arrays.asList("7612b3460575402ad78fa4173178bdcc"));
         executeTest("test filter #2", spec);
     }
 
     @Test
     public void testFilterWithSeparateNames() {
+        // note that this input if slightly malformed, but with the new properly
+        // only when really needed genotype loading of VCF files we don't actually
+        // fix the file in the output
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --filterName ABF -filter 'AlleleBalance < 0.7' --filterName FSF -filter 'FisherStrand == 1.4' --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("b8cdd7f44ff1a395e0a9b06a87e1e530"));
+                Arrays.asList("dce33441f58b284ac9ab94f8e64b84e3"));
         executeTest("test filter with separate names #2", spec);
     }
 
     @Test
-    public void testGenotypeFilters() {
+    public void testGenotypeFilters1() {
         WalkerTestSpec spec1 = new WalkerTestSpec(
                 baseTestString() + " -G_filter 'GQ == 0.60' -G_filterName foo --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
                 Arrays.asList("96b61e4543a73fe725e433f007260039"));
         executeTest("test genotype filter #1", spec1);
+    }
 
+    @Test
+    public void testGenotypeFilters2() {
         WalkerTestSpec spec2 = new WalkerTestSpec(
                 baseTestString() + " -G_filter 'AF == 0.04 && isHomVar == 1' -G_filterName foo --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
                 Arrays.asList("6c8112ab17ce39c8022c891ae73bf38e"));

From f9e25081aba3fa9e5cc4bceb5d2cf184084a397a Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sun, 20 Nov 2011 08:35:52 -0500
Subject: [PATCH 076/113] Completed documented LazyGenotypesContext

---
 .../variantcontext/LazyGenotypesContext.java  | 88 +++++++++++++------
 1 file changed, 60 insertions(+), 28 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
index ca2d7a812..fccc8c667 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
@@ -24,6 +24,8 @@
 
 package org.broadinstitute.sting.utils.variantcontext;
 
+import com.google.java.contract.Ensures;
+import com.google.java.contract.Requires;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFParser;
 
 import java.util.ArrayList;
@@ -32,44 +34,55 @@ import java.util.List;
 import java.util.Map;
 
 /**
- * [Short one sentence description of this walker]
- * <p/>
- * <p>
- * [Functionality of this walker]
- * </p>
- * <p/>
- * <h2>Input</h2>
- * <p>
- * [Input description]
- * </p>
- * <p/>
- * <h2>Output</h2>
- * <p>
- * [Output description]
- * </p>
- * <p/>
- * <h2>Examples</h2>
- * <pre>
- *    java
- *      -jar GenomeAnalysisTK.jar
- *      -T $WalkerName
- *  </pre>
- *
- * @author Your Name
- * @since Date created
+ * Lazy-loading GenotypesContext.  A lazy-loading context has access to the
+ * VCFParser and a unparsed string of genotype data.  If the user attempts to manipulate
+ * the genotypes contained in this context, we decode the data and become a full blown
+ * GenotypesContext.  However, if the user never does this we are spared a lot of expense
+ * decoding the genotypes unnecessarily.
  */
 public class LazyGenotypesContext extends GenotypesContext {
+    /** parser the VCF parser we'll use to decode unparsedGenotypeData if necessary */
     final VCFParser parser;
+
+    /** a string containing the unparsed VCF genotypes */
     String unparsedGenotypeData;
+
+    /** alleles the current list of alleles at the site (known already in the parser) */
     final List<Allele> alleles;
+
+    /** contig the current contig (known already in the parser) */
     final String contig;
+
+    /** the current start position (known already in the parser) */
     final int start;
+
+    /**
+     * nUnparsedGenotypes the number of genotypes contained in the unparsedGenotypes data
+     * (known already in the parser).  Useful for isEmpty and size() optimizations
+     */
     final int nUnparsedGenotypes;
 
+    /**
+     * True if we've already decoded the values in unparsedGenotypeData
+     */
     boolean loaded = false;
 
     private final static ArrayList<Genotype> EMPTY = new ArrayList<Genotype>(0);
 
+    /**
+     * Creates a new lazy loading genotypes context
+     *
+     * @param parser the VCF parser we'll use to decode unparsedGenotypeData if necessary
+     * @param unparsedGenotypeData a string containing the unparsed VCF genotypes
+     * @param contig the current contig (known already in the parser)
+     * @param start the current start position (known already in the parser)
+     * @param alleles the current list of alleles at the site (known already in the parser)
+     * @param nUnparsedGenotypes the number of genotypes contained in the unparsedGenotypes data
+     *      (known already in the parser).  Useful for isEmpty and size() optimizations
+     */
+    @Requires({"parser != null", "unparsedGenotypeData != null",
+            "contig != null", "start >= 0", "alleles != null && alleles.size() > 0",
+            "nUnparsedGenotypes > 0"})
     public LazyGenotypesContext(final VCFParser parser, final String unparsedGenotypeData,
                                 final String contig, final int start, final List<Allele> alleles,
                                 int nUnparsedGenotypes ) {
@@ -82,7 +95,16 @@ public class LazyGenotypesContext extends GenotypesContext {
         this.nUnparsedGenotypes = nUnparsedGenotypes;
     }
 
+    /**
+     * Overrides the genotypes accessor.  If we haven't already, decode the genotypes data
+     * and store the decoded results in the appropriate variables.  Otherwise we just
+     * returned the decoded result directly.  Note some care needs to be taken here as
+     * the value in notToBeDirectlyAccessedGenotypes may diverge from what would be produced
+     * by decode, if after the first decode the genotypes themselves are replaced
+     * @return
+     */
     @Override
+    @Ensures("result != null")
     protected ArrayList<Genotype> getGenotypes() {
         if ( ! loaded ) {
             //System.out.printf("Loading genotypes... %s:%d%n", contig, start);
@@ -90,9 +112,9 @@ public class LazyGenotypesContext extends GenotypesContext {
             notToBeDirectlyAccessedGenotypes = subcontext.notToBeDirectlyAccessedGenotypes;
             sampleNamesInOrder = subcontext.sampleNamesInOrder;
             sampleNameToOffset = subcontext.sampleNameToOffset;
-            cacheIsInvalid = false;
+            cacheIsInvalid = false;      // these values build the cache
             loaded = true;
-            unparsedGenotypeData = null;
+            unparsedGenotypeData = null; // don't hold the unparsed data any longer
 
             // warning -- this path allows us to create a VariantContext that doesn't run validateGenotypes()
             // That said, it's not such an important routine -- it's just checking that the genotypes
@@ -102,9 +124,19 @@ public class LazyGenotypesContext extends GenotypesContext {
         return notToBeDirectlyAccessedGenotypes;
     }
 
+    /**
+     * Overrides the buildCache functionality.  If the data hasn't been loaded
+     * yet and we want to build the cache, just decode it and we're done.  If we've
+     * already decoded the data, though, go through the super class
+     */
+    @Override
     protected synchronized void buildCache() {
         if ( cacheIsInvalid ) {
-            getGenotypes(); // will load up all of the necessary data
+            if ( ! loaded ) {
+                getGenotypes(); // will load up all of the necessary data
+            } else {
+                super.buildCache();
+            }
         }
     }
 

From 9445326c6cbcc68fc46f8109d2e173824197706c Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sun, 20 Nov 2011 18:26:27 -0500
Subject: [PATCH 077/113] Genotype is Comparable via sampleName

---
 build.xml                                            |  4 ++--
 .../sting/utils/variantcontext/Genotype.java         | 12 +++++++++++-
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/build.xml b/build.xml
index 232b074f6..66d99ac67 100644
--- a/build.xml
+++ b/build.xml
@@ -927,8 +927,8 @@
                 <jvmarg value="-Dpipeline.run=${pipeline.run}" />
                 <jvmarg value="-Djava.io.tmpdir=${java.io.tmpdir}" />
                 <jvmarg line="${cofoja.jvm.args}"/>
-<!--                 <jvmarg value="-Xdebug"/> -->
-<!--                 <jvmarg value="-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005"/> -->
+                <jvmarg value="-Xdebug"/>
+                <jvmarg value="-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005"/>
 
                 <classfileset dir="${java.public.test.classes}" includes="**/@{testtype}.class"/>
                 <classfileset dir="${java.private.test.classes}" erroronmissingdir="false">
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
index b100d6da5..1691129c9 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/Genotype.java
@@ -12,7 +12,7 @@ import java.util.*;
  *
  * @author Mark DePristo
  */
-public class Genotype {
+public class Genotype implements Comparable<Genotype> {
 
     public final static String PHASED_ALLELE_SEPARATOR = "|";
     public final static String UNPHASED_ALLELE_SEPARATOR = "/";
@@ -351,4 +351,14 @@ public class Genotype {
     public int getAttributeAsInt(String key, int defaultValue)            { return commonInfo.getAttributeAsInt(key, defaultValue); }
     public double getAttributeAsDouble(String key, double  defaultValue)  { return commonInfo.getAttributeAsDouble(key, defaultValue); }
     public boolean getAttributeAsBoolean(String key, boolean  defaultValue)  { return commonInfo.getAttributeAsBoolean(key, defaultValue); }
+
+    /**
+     * comparable genotypes -> compareTo on the sample names
+     * @param genotype
+     * @return
+     */
+    @Override
+    public int compareTo(final Genotype genotype) {
+        return getSampleName().compareTo(genotype.getSampleName());
+    }
 }
\ No newline at end of file

From bc44f6fd9ef5327869c6c2add774cee475606cf0 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sun, 20 Nov 2011 18:26:56 -0500
Subject: [PATCH 078/113] Utility function Collection<Genotype> ->
 Collection<String>

---
 .../sting/utils/variantcontext/VariantContextUtils.java    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 07c0f7c32..21a371e2f 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -1065,4 +1065,11 @@ public class VariantContextUtils {
     public static final GenomeLoc getLocation(GenomeLocParser genomeLocParser,VariantContext vc) {
         return genomeLocParser.createGenomeLoc(vc.getChr(), vc.getStart(), vc.getEnd(), true);
     }
+
+    public static final Set<String> genotypeNames(final Collection<Genotype> genotypes) {
+        final Set<String> names = new HashSet<String>(genotypes.size());
+        for ( final Genotype g : genotypes )
+            names.add(g.getSampleName());
+        return names;
+    }
 }

From f0ac588d32b4381c55a169d7659e46a1a933b582 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Sun, 20 Nov 2011 18:28:01 -0500
Subject: [PATCH 079/113] Extensive unit test for GenotypeContextUnitTest

-- Currently only tests base class.  Adding subclass testing in a bit
---
 build.xml                                     |   4 +-
 .../GenotypesContextUnitTest.java             | 290 ++++++++++++++++++
 2 files changed, 292 insertions(+), 2 deletions(-)
 create mode 100644 public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java

diff --git a/build.xml b/build.xml
index 66d99ac67..232b074f6 100644
--- a/build.xml
+++ b/build.xml
@@ -927,8 +927,8 @@
                 <jvmarg value="-Dpipeline.run=${pipeline.run}" />
                 <jvmarg value="-Djava.io.tmpdir=${java.io.tmpdir}" />
                 <jvmarg line="${cofoja.jvm.args}"/>
-                <jvmarg value="-Xdebug"/>
-                <jvmarg value="-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005"/>
+<!--                 <jvmarg value="-Xdebug"/> -->
+<!--                 <jvmarg value="-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005"/> -->
 
                 <classfileset dir="${java.public.test.classes}" includes="**/@{testtype}.class"/>
                 <classfileset dir="${java.private.test.classes}" erroronmissingdir="false">
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
new file mode 100644
index 000000000..a65051fae
--- /dev/null
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
@@ -0,0 +1,290 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+// our package
+package org.broadinstitute.sting.utils.variantcontext;
+
+
+// the imports for unit testing.
+
+
+import org.broad.tribble.util.ParsingUtils;
+import org.broadinstitute.sting.BaseTest;
+import org.broadinstitute.sting.utils.Utils;
+import org.testng.Assert;
+import org.testng.annotations.BeforeMethod;
+import org.testng.annotations.BeforeSuite;
+import org.testng.annotations.DataProvider;
+import org.testng.annotations.Test;
+
+import java.util.*;
+
+
+public class GenotypesContextUnitTest extends BaseTest {
+    Allele Aref, C, T;
+    Genotype AA, AT, TT, AC, CT, CC, MISSING;
+    List<Genotype> allGenotypes;
+
+    @BeforeSuite
+    public void before() {
+        C = Allele.create("C");
+        Aref = Allele.create("A", true);
+        T = Allele.create("T");
+        AA = new Genotype("AA", Arrays.asList(Aref, Aref));
+        AT = new Genotype("AT", Arrays.asList(Aref, T));
+        TT = new Genotype("TT", Arrays.asList(T, T));
+        AC = new Genotype("AC", Arrays.asList(Aref, C));
+        CT = new Genotype("CT", Arrays.asList(C, T));
+        CC = new Genotype("CC", Arrays.asList(C, C));
+        MISSING = new Genotype("MISSING", Arrays.asList(C, C));
+
+        allGenotypes = Arrays.asList(AA, AT, TT, AC, CT, CC);
+    }
+
+    // --------------------------------------------------------------------------------
+    //
+    // Provider
+    //
+    // --------------------------------------------------------------------------------
+
+    private interface ContextMaker {
+        public GenotypesContext make(List<Genotype> initialSamples);
+    }
+
+    private ContextMaker baseMaker = new ContextMaker() {
+        @Override
+        public GenotypesContext make(final List<Genotype> initialSamples) {
+            return GenotypesContext.copy(initialSamples);
+        }
+    };
+
+    private Collection<ContextMaker> allMakers =
+            Arrays.asList(baseMaker);
+
+    private class GenotypesContextProvider extends TestDataProvider {
+        ContextMaker maker;
+        final List<Genotype> initialSamples;
+
+        private GenotypesContextProvider(ContextMaker maker, List<Genotype> initialSamples) {
+            super(GenotypesContextProvider.class);
+            this.maker = maker;
+            this.initialSamples = initialSamples;
+        }
+
+        public GenotypesContext makeContext() {
+            return maker.make(initialSamples);
+        }
+    }
+
+    @DataProvider(name = "GenotypesContextProvider")
+    public Object[][] MakeSampleNamesTest() {
+        for ( ContextMaker maker : allMakers ) {
+            for ( int i = 0; i < allGenotypes.size(); i++ ) {
+                List<Genotype> samples = allGenotypes.subList(0, i);
+                // sorted
+                new GenotypesContextProvider(maker, samples);
+                // unsorted
+                new GenotypesContextProvider(maker, Utils.reverse(samples));
+            }
+        }
+
+        return GenotypesContextProvider.getTests(GenotypesContextProvider.class);
+    }
+
+    private final static void testIterable(Iterable<Genotype> genotypeIterable, Set<String> expectedNames) {
+        int count = 0;
+        for ( final Genotype g : genotypeIterable ) {
+            Assert.assertTrue(expectedNames.contains(g.getSampleName()));
+            count++;
+        }
+        Assert.assertEquals(count, expectedNames.size(), "Iterable returned unexpected number of genotypes");
+    }
+
+    @Test(dataProvider = "GenotypesContextProvider")
+    public void testInitialSamplesAreAsExpected(GenotypesContextProvider cfg) {
+        testGenotypesContextContainsExpectedSamples(cfg.makeContext(), cfg.initialSamples);
+    }
+
+    private final void testGenotypesContextContainsExpectedSamples(GenotypesContext gc, List<Genotype> expectedSamples) {
+        Assert.assertEquals(gc.isEmpty(), expectedSamples.isEmpty());
+        Assert.assertEquals(gc.size(), expectedSamples.size());
+
+        // get(index) is doing the right thing
+        for ( int i = 0; i < expectedSamples.size(); i++ ) {
+            Assert.assertEquals(gc.get(i), expectedSamples.get(i));
+        }
+        Assert.assertFalse(gc.containsSample(MISSING.getSampleName()));
+
+        // we can fetch samples by name
+        final Set<String> genotypeNames = VariantContextUtils.genotypeNames(expectedSamples);
+        for ( final String name : genotypeNames ) {
+            Assert.assertTrue(gc.containsSample(name));
+        }
+        Assert.assertFalse(gc.containsSample(MISSING.getSampleName()));
+
+        // all of the iterators are working
+        testIterable(gc.iterateInSampleNameOrder(), genotypeNames);
+        testIterable(gc, genotypeNames);
+        testIterable(gc.iterateInSampleNameOrder(genotypeNames), genotypeNames);
+        if ( ! genotypeNames.isEmpty() ) {
+            Set<String> first = Collections.singleton(genotypeNames.iterator().next());
+            testIterable(gc.iterateInSampleNameOrder(first), first);
+        }
+
+        // misc. utils are working as expected
+        Assert.assertEquals(gc.getSampleNames(), genotypeNames);
+        Assert.assertTrue(ParsingUtils.isSorted(gc.getSampleNamesOrderedByName()));
+        Assert.assertTrue(ParsingUtils.isSorted(gc.iterateInSampleNameOrder()));
+        Assert.assertTrue(gc.containsSamples(genotypeNames));
+
+        final Set<String> withMissing = new HashSet<String>(Arrays.asList(MISSING.getSampleName()));
+        withMissing.addAll(genotypeNames);
+        Assert.assertFalse(gc.containsSamples(withMissing));
+    }
+
+    @Test(dataProvider = "GenotypesContextProvider")
+    public void testImmutable(GenotypesContextProvider cfg) {
+        GenotypesContext gc = cfg.makeContext();
+        Assert.assertEquals(gc.isMutable(), true);
+        gc.immutable();
+        Assert.assertEquals(gc.isMutable(), false);
+    }
+
+    @Test(dataProvider = "GenotypesContextProvider", expectedExceptions = Throwable.class )
+    public void testImmutableCall1(GenotypesContextProvider cfg) {
+        GenotypesContext gc = cfg.makeContext();
+        gc.immutable();
+        gc.add(MISSING);
+    }
+
+    @Test(dataProvider = "GenotypesContextProvider")
+    public void testClear(GenotypesContextProvider cfg) {
+        GenotypesContext gc = cfg.makeContext();
+        gc.clear();
+        testGenotypesContextContainsExpectedSamples(gc, Collections.<Genotype>emptyList());
+    }
+
+    private static final List<Genotype> with(List<Genotype> genotypes, Genotype ... add) {
+        List<Genotype> l = new ArrayList<Genotype>(genotypes);
+        l.addAll(Arrays.asList(add));
+        return l;
+    }
+
+    private static final List<Genotype> without(List<Genotype> genotypes, Genotype ... remove) {
+        List<Genotype> l = new ArrayList<Genotype>(genotypes);
+        l.removeAll(Arrays.asList(remove));
+        return l;
+    }
+
+    @Test(dataProvider = "GenotypesContextProvider")
+    public void testAdds(GenotypesContextProvider cfg) {
+        Genotype add1 = new Genotype("add1", Arrays.asList(Aref, Aref));
+        Genotype add2 = new Genotype("add2", Arrays.asList(Aref, Aref));
+
+        GenotypesContext gc = cfg.makeContext();
+        gc.add(add1);
+        testGenotypesContextContainsExpectedSamples(gc, with(cfg.initialSamples, add1));
+
+        gc = cfg.makeContext();
+        gc.add(add1);
+        gc.add(add2);
+        testGenotypesContextContainsExpectedSamples(gc, with(cfg.initialSamples, add1, add2));
+
+        gc = cfg.makeContext();
+        gc.add(add1, add2);
+        testGenotypesContextContainsExpectedSamples(gc, with(cfg.initialSamples, add1, add2));
+
+        gc = cfg.makeContext();
+        gc.addAll(Arrays.asList(add1, add2));
+        testGenotypesContextContainsExpectedSamples(gc, with(cfg.initialSamples, add1, add2));
+    }
+
+    @Test(dataProvider = "GenotypesContextProvider")
+    public void testRemoves(GenotypesContextProvider cfg) {
+        Genotype rm1 = AA;
+        Genotype rm2 = AC;
+
+        GenotypesContext gc = cfg.makeContext();
+        if (gc.size() > 1) {
+            Genotype rm = gc.get(0);
+            gc.remove(rm);
+            testGenotypesContextContainsExpectedSamples(gc, without(cfg.initialSamples, rm));
+        }
+
+        gc = cfg.makeContext();
+        gc.remove(rm1);
+        testGenotypesContextContainsExpectedSamples(gc, without(cfg.initialSamples, rm1));
+
+        gc = cfg.makeContext();
+        gc.remove(rm1);
+        gc.remove(rm2);
+        testGenotypesContextContainsExpectedSamples(gc, without(cfg.initialSamples, rm1, rm2));
+
+        gc = cfg.makeContext();
+        gc.removeAll(Arrays.asList(rm1, rm2));
+        testGenotypesContextContainsExpectedSamples(gc, without(cfg.initialSamples, rm1, rm2));
+
+        gc = cfg.makeContext();
+        HashSet<Genotype> expected = new HashSet<Genotype>();
+        if ( gc.contains(rm1) ) expected.add(rm1);
+        if ( gc.contains(rm2) ) expected.add(rm2);
+        gc.retainAll(Arrays.asList(rm1, rm2));
+
+        // ensure that the two lists are the same
+        Assert.assertEquals(new HashSet<Genotype>(gc.getGenotypes()), expected);
+        // because the list order can change, we use the gc's list itself
+        testGenotypesContextContainsExpectedSamples(gc, gc.getGenotypes());
+    }
+
+    @Test(dataProvider = "GenotypesContextProvider")
+    public void testSet(GenotypesContextProvider cfg) {
+        Genotype set = new Genotype("replace", Arrays.asList(Aref, Aref));
+        int n = cfg.makeContext().size();
+        for ( int i = 0; i < n; i++ ) {
+            GenotypesContext gc = cfg.makeContext();
+            Genotype setted = gc.set(i, set);
+            Assert.assertNotNull(setted);
+            ArrayList<Genotype> l = new ArrayList<Genotype>(cfg.initialSamples);
+            l.set(i, set);
+            testGenotypesContextContainsExpectedSamples(gc, l);
+        }
+    }
+
+    @Test(dataProvider = "GenotypesContextProvider")
+    public void testReplace(GenotypesContextProvider cfg) {
+        int n = cfg.makeContext().size();
+        for ( int i = 0; i < n; i++ ) {
+            GenotypesContext gc = cfg.makeContext();
+            Genotype toReplace = gc.get(i);
+            Genotype replacement = new Genotype(toReplace.getSampleName(), Arrays.asList(Aref, Aref));
+            gc.replace(replacement);
+            ArrayList<Genotype> l = new ArrayList<Genotype>(cfg.initialSamples);
+            l.set(i, replacement);
+            Assert.assertEquals(replacement, gc.get(i));
+            testGenotypesContextContainsExpectedSamples(gc, l);
+        }
+    }
+
+    // subset to samples tested in VariantContextUnitTest
+}
\ No newline at end of file

From 2e9ecf639ef8846faa40e1200c032bf80c38406e Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 21 Nov 2011 09:30:40 -0500
Subject: [PATCH 080/113] Generalized interface to LazyGenotypesContext

-- Now you provide a LazyParsing object
-- LazyGenotypesContext now knows nothing about the VCF parser itself.  The parser holds all of the necessary data to parse the VCF genotypes when necessarily, and the LGC only has a pointer to this object
-- Using new interface added LazyGenotypesContext to unit tests with a simple lazy version
-- Deleted VCFParser interface, as it was no longer necessary
---
 .../utils/codecs/vcf/AbstractVCFCodec.java    | 32 ++++++-
 .../utils/codecs/vcf/StandardVCFWriter.java   |  2 +-
 .../sting/utils/codecs/vcf/VCF3Codec.java     | 10 +-
 .../sting/utils/codecs/vcf/VCFCodec.java      | 10 +-
 .../sting/utils/codecs/vcf/VCFParser.java     | 24 -----
 .../variantcontext/GenotypesContext.java      |  5 +-
 .../variantcontext/LazyGenotypesContext.java  | 93 +++++++++++--------
 .../utils/variantcontext/VariantContext.java  |  2 -
 .../GenotypesContextUnitTest.java             | 31 +++++--
 9 files changed, 117 insertions(+), 92 deletions(-)
 delete mode 100755 public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java

diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index ee3184dc2..216ee3fb6 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -17,7 +17,7 @@ import java.util.*;
 import java.util.zip.GZIPInputStream;
 
 
-public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec, VCFParser {
+public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec {
 
     protected final static Logger log = Logger.getLogger(VCFCodec.class);
     protected final static int NUM_STANDARD_FIELDS = 8;  // INFO is the 8th column
@@ -59,6 +59,29 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
 
     protected Map<String, String> stringCache = new HashMap<String, String>();
 
+    /**
+     * Creates a LazyParser for a LazyGenotypesContext to use to decode
+     * our genotypes only when necessary.  We do this instead of eagarly
+     * decoding the genotypes just to turn around and reencode in the frequent
+     * case where we don't actually want to manipulate the genotypes
+     */
+    class LazyVCFGenotypesParser implements LazyGenotypesContext.LazyParser {
+        final List<Allele> alleles;
+        final String contig;
+        final int start;
+
+        LazyVCFGenotypesParser(final List<Allele> alleles, final String contig, final int start) {
+            this.alleles = alleles;
+            this.contig = contig;
+            this.start = start;
+        }
+
+        @Override
+        public LazyGenotypesContext.LazyData parse(final Object data) {
+            //System.out.printf("Loading genotypes... %s:%d%n", contig, start);
+            return createGenotypeMap((String) data, alleles, contig, start);
+        }
+    }
 
     /**
      * @param reader the line reader to take header lines from
@@ -68,13 +91,14 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
 
     /**
      * create a genotype map
+     *
      * @param str the string
      * @param alleles the list of alleles
      * @param chr chrom
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public abstract GenotypesContext createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
+    public abstract LazyGenotypesContext.LazyData createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
 
 
     /**
@@ -294,7 +318,9 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec,
 
         // do we have genotyping data
         if (parts.length > NUM_STANDARD_FIELDS) {
-            LazyGenotypesContext lazy = new LazyGenotypesContext(this, parts[8], chr, pos, alleles, header.getGenotypeSamples().size());
+            final LazyGenotypesContext.LazyParser lazyParser = new LazyVCFGenotypesParser(alleles, chr, pos);
+            final int nGenotypes = header.getGenotypeSamples().size();
+            LazyGenotypesContext lazy = new LazyGenotypesContext(lazyParser, parts[8], nGenotypes);
             builder.genotypesNoValidation(lazy);
         }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
index 7a496cb7c..ac1da7110 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/StandardVCFWriter.java
@@ -229,7 +229,7 @@ public class StandardVCFWriter extends IndexingVCFWriter {
             final GenotypesContext gc = vc.getGenotypes();
             if ( gc instanceof LazyGenotypesContext && ((LazyGenotypesContext)gc).getUnparsedGenotypeData() != null) {
                 mWriter.write(VCFConstants.FIELD_SEPARATOR);
-                mWriter.write(((LazyGenotypesContext)gc).getUnparsedGenotypeData());
+                mWriter.write(((LazyGenotypesContext)gc).getUnparsedGenotypeData().toString());
             } else {
                 List<String> genotypeAttributeKeys = new ArrayList<String>();
                 if ( vc.hasGenotypes() ) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
index 5e6e2e94a..6f8e64e55 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCF3Codec.java
@@ -3,10 +3,7 @@ package org.broadinstitute.sting.utils.codecs.vcf;
 import org.broad.tribble.TribbleException;
 import org.broad.tribble.readers.LineReader;
 import org.broad.tribble.util.ParsingUtils;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.File;
 import java.io.IOException;
@@ -112,13 +109,14 @@ public class VCF3Codec extends AbstractVCFCodec {
 
     /**
      * create a genotype map
+     *
      * @param str the string
      * @param alleles the list of alleles
      * @param chr chrom
      * @param pos position
      * @return a mapping of sample name to genotype object
      */
-    public GenotypesContext createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+    public LazyGenotypesContext.LazyData createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
         if (genotypeParts == null)
             genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
 
@@ -191,7 +189,7 @@ public class VCF3Codec extends AbstractVCFCodec {
             }
         }
 
-        return GenotypesContext.create(genotypes, header.sampleNameToOffset, header.sampleNamesInOrder);
+        return new LazyGenotypesContext.LazyData(genotypes, header.sampleNamesInOrder, header.sampleNameToOffset);
     }
 
     @Override
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
index b7b7eb5f7..407c4bc41 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFCodec.java
@@ -3,10 +3,7 @@ package org.broadinstitute.sting.utils.codecs.vcf;
 import org.broad.tribble.TribbleException;
 import org.broad.tribble.readers.LineReader;
 import org.broad.tribble.util.ParsingUtils;
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.*;
 
 import java.io.File;
 import java.io.IOException;
@@ -141,11 +138,12 @@ public class VCFCodec extends AbstractVCFCodec {
 
     /**
      * create a genotype map
+     *
      * @param str the string
      * @param alleles the list of alleles
      * @return a mapping of sample name to genotype object
      */
-    public GenotypesContext createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
+    public LazyGenotypesContext.LazyData createGenotypeMap(String str, List<Allele> alleles, String chr, int pos) {
         if (genotypeParts == null)
             genotypeParts = new String[header.getColumnCount() - NUM_STANDARD_FIELDS];
 
@@ -215,7 +213,7 @@ public class VCFCodec extends AbstractVCFCodec {
             }
         }
 
-        return GenotypesContext.create(genotypes, header.sampleNameToOffset, header.sampleNamesInOrder);
+        return new LazyGenotypesContext.LazyData(genotypes, header.sampleNamesInOrder, header.sampleNameToOffset);
     }
 
     @Override
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
deleted file mode 100755
index 8903a176a..000000000
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/VCFParser.java
+++ /dev/null
@@ -1,24 +0,0 @@
-package org.broadinstitute.sting.utils.codecs.vcf;
-
-import org.broadinstitute.sting.utils.variantcontext.Allele;
-import org.broadinstitute.sting.utils.variantcontext.GenotypesContext;
-
-import java.util.List;
-
-
-/**
- * All VCF codecs need to implement this interface so that we can perform lazy loading.
- */
-public interface VCFParser {
-
-    /**
-     * create a genotype map
-     * @param str the string
-     * @param alleles the list of alleles
-     * @param chr chrom
-     * @param pos position
-     * @return a mapping of sample name to genotype object
-     */
-    public GenotypesContext createGenotypeMap(String str, List<Allele> alleles, String chr, int pos);
-
-}
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 846e6c89c..ab5ab9465 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -251,7 +251,7 @@ public class GenotypesContext implements List<Genotype> {
     // ---------------------------------------------------------------------------
 
     @Ensures({"cacheIsInvalid == true"})
-    private synchronized void invalidateCaches() {
+    protected void invalidateCaches() {
         cacheIsInvalid = true;
         sampleNamesInOrder = null;
         sampleNameToOffset = null;
@@ -262,7 +262,7 @@ public class GenotypesContext implements List<Genotype> {
             "sampleNameToOffset != null",
             "sameSamples(notToBeDirectlyAccessedGenotypes, sampleNamesInOrder)",
             "sameSamples(notToBeDirectlyAccessedGenotypes, sampleNameToOffset.keySet())"})
-    protected synchronized void buildCache() {
+    protected void buildCache() {
         if ( cacheIsInvalid ) {
             cacheIsInvalid = false;
             sampleNamesInOrder = new ArrayList<String>(size());
@@ -291,6 +291,7 @@ public class GenotypesContext implements List<Genotype> {
     @Override
     public void clear() {
         checkImmutability();
+        invalidateCaches();
         getGenotypes().clear();
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
index fccc8c667..7facfacf6 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
@@ -26,10 +26,8 @@ package org.broadinstitute.sting.utils.variantcontext;
 
 import com.google.java.contract.Ensures;
 import com.google.java.contract.Requires;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFParser;
 
 import java.util.ArrayList;
-import java.util.Collections;
 import java.util.List;
 import java.util.Map;
 
@@ -41,20 +39,10 @@ import java.util.Map;
  * decoding the genotypes unnecessarily.
  */
 public class LazyGenotypesContext extends GenotypesContext {
-    /** parser the VCF parser we'll use to decode unparsedGenotypeData if necessary */
-    final VCFParser parser;
+    /** The LazyParser we'll use to decode unparsedGenotypeData if necessary */
+    final LazyParser parser;
 
-    /** a string containing the unparsed VCF genotypes */
-    String unparsedGenotypeData;
-
-    /** alleles the current list of alleles at the site (known already in the parser) */
-    final List<Allele> alleles;
-
-    /** contig the current contig (known already in the parser) */
-    final String contig;
-
-    /** the current start position (known already in the parser) */
-    final int start;
+    Object unparsedGenotypeData;
 
     /**
      * nUnparsedGenotypes the number of genotypes contained in the unparsedGenotypes data
@@ -70,28 +58,48 @@ public class LazyGenotypesContext extends GenotypesContext {
     private final static ArrayList<Genotype> EMPTY = new ArrayList<Genotype>(0);
 
     /**
-     * Creates a new lazy loading genotypes context
-     *
-     * @param parser the VCF parser we'll use to decode unparsedGenotypeData if necessary
-     * @param unparsedGenotypeData a string containing the unparsed VCF genotypes
-     * @param contig the current contig (known already in the parser)
-     * @param start the current start position (known already in the parser)
-     * @param alleles the current list of alleles at the site (known already in the parser)
-     * @param nUnparsedGenotypes the number of genotypes contained in the unparsedGenotypes data
-     *      (known already in the parser).  Useful for isEmpty and size() optimizations
+     * Simple lazy parser interface.  Provide an object implementing this
+     * interface to LazyGenotypesContext, and it's parse method will be called
+     * when the use of the lazy context requires the underlying genotypes data
+     * be parsed into Genotype objects.  The data argument is the data provided
+     * to the LazyGenotypesContext holding encoded genotypes data
      */
-    @Requires({"parser != null", "unparsedGenotypeData != null",
-            "contig != null", "start >= 0", "alleles != null && alleles.size() > 0",
-            "nUnparsedGenotypes > 0"})
-    public LazyGenotypesContext(final VCFParser parser, final String unparsedGenotypeData,
-                                final String contig, final int start, final List<Allele> alleles,
-                                int nUnparsedGenotypes ) {
+    public interface LazyParser {
+        public LazyData parse(Object data);
+    }
+
+    /**
+     * Returns the data used in the full GenotypesContext constructor
+     *
+     * {@link GenotypesContext#GenotypesContext(java.util.ArrayList, java.util.Map, java.util.List, boolean)}
+     */
+    public static class LazyData {
+        final ArrayList<Genotype> genotypes;
+        final Map<String, Integer> sampleNameToOffset;
+        final List<String> sampleNamesInOrder;
+
+        public LazyData(final ArrayList<Genotype> genotypes,
+                        final List<String> sampleNamesInOrder,
+                        final Map<String, Integer> sampleNameToOffset) {
+            this.genotypes = genotypes;
+            this.sampleNamesInOrder = sampleNamesInOrder;
+            this.sampleNameToOffset = sampleNameToOffset;
+        }
+    }
+
+    /**
+     * Creates a new lazy loading genotypes context using the LazyParser to create
+     * genotypes data on demand.
+     *
+     * @param parser the parser to be used to load on-demand genotypes data
+     * @param unparsedGenotypeData the encoded genotypes data that we will decode if necessary
+     * @param nUnparsedGenotypes the number of genotypes that will be produced if / when we actually decode the genotypes data
+     */
+    @Requires({"parser != null", "unparsedGenotypeData != null", "nUnparsedGenotypes >= 0"})
+    public LazyGenotypesContext(final LazyParser parser, final Object unparsedGenotypeData, final int nUnparsedGenotypes) {
         super(EMPTY, false);
-        this.unparsedGenotypeData = unparsedGenotypeData;
-        this.start = start;
         this.parser = parser;
-        this.contig = contig;
-        this.alleles = alleles;
+        this.unparsedGenotypeData = unparsedGenotypeData;
         this.nUnparsedGenotypes = nUnparsedGenotypes;
     }
 
@@ -108,10 +116,10 @@ public class LazyGenotypesContext extends GenotypesContext {
     protected ArrayList<Genotype> getGenotypes() {
         if ( ! loaded ) {
             //System.out.printf("Loading genotypes... %s:%d%n", contig, start);
-            GenotypesContext subcontext = parser.createGenotypeMap(unparsedGenotypeData, alleles, contig, start);
-            notToBeDirectlyAccessedGenotypes = subcontext.notToBeDirectlyAccessedGenotypes;
-            sampleNamesInOrder = subcontext.sampleNamesInOrder;
-            sampleNameToOffset = subcontext.sampleNameToOffset;
+            LazyData parsed = parser.parse(unparsedGenotypeData);
+            notToBeDirectlyAccessedGenotypes = parsed.genotypes;
+            sampleNamesInOrder = parsed.sampleNamesInOrder;
+            sampleNameToOffset = parsed.sampleNameToOffset;
             cacheIsInvalid = false;      // these values build the cache
             loaded = true;
             unparsedGenotypeData = null; // don't hold the unparsed data any longer
@@ -140,6 +148,13 @@ public class LazyGenotypesContext extends GenotypesContext {
         }
     }
 
+    @Override
+    protected void invalidateCaches() {
+        // if the cache is invalidated, and we haven't loaded our data yet, do so
+        if ( ! loaded ) getGenotypes();
+        super.invalidateCaches();
+    }
+
     @Override
     public boolean isEmpty() {
         // optimization -- we know the number of samples in the unparsed data, so use it here to
@@ -154,7 +169,7 @@ public class LazyGenotypesContext extends GenotypesContext {
         return loaded ? super.size() : nUnparsedGenotypes;
     }
 
-    public String getUnparsedGenotypeData() {
+    public Object getUnparsedGenotypeData() {
         return unparsedGenotypeData;
     }
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 8d74f5220..331ca97d3 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -1,11 +1,9 @@
 package org.broadinstitute.sting.utils.variantcontext;
 
-import org.apache.commons.lang.Validate;
 import org.broad.tribble.Feature;
 import org.broad.tribble.TribbleException;
 import org.broad.tribble.util.ParsingUtils;
 import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
-import org.broadinstitute.sting.utils.codecs.vcf.VCFParser;
 import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
 
 import java.util.*;
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
index a65051fae..c12fbac9c 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
@@ -79,8 +79,21 @@ public class GenotypesContextUnitTest extends BaseTest {
         }
     };
 
-    private Collection<ContextMaker> allMakers =
-            Arrays.asList(baseMaker);
+    private final class lazyMaker implements LazyGenotypesContext.LazyParser, ContextMaker {
+        @Override
+        public LazyGenotypesContext.LazyData parse(final Object data) {
+            GenotypesContext gc = GenotypesContext.copy((List<Genotype>)data);
+            gc.buildCache();
+            return new LazyGenotypesContext.LazyData(gc.notToBeDirectlyAccessedGenotypes, gc.sampleNamesInOrder, gc.sampleNameToOffset);
+        }
+
+        @Override
+        public GenotypesContext make(final List<Genotype> initialSamples) {
+            return new LazyGenotypesContext(this, initialSamples, initialSamples.size());
+        }
+    }
+
+    private Collection<ContextMaker> allMakers = Arrays.asList(baseMaker, new lazyMaker());
 
     private class GenotypesContextProvider extends TestDataProvider {
         ContextMaker maker;
@@ -163,7 +176,7 @@ public class GenotypesContextUnitTest extends BaseTest {
         Assert.assertFalse(gc.containsSamples(withMissing));
     }
 
-    @Test(dataProvider = "GenotypesContextProvider")
+    @Test(enabled = true, dataProvider = "GenotypesContextProvider")
     public void testImmutable(GenotypesContextProvider cfg) {
         GenotypesContext gc = cfg.makeContext();
         Assert.assertEquals(gc.isMutable(), true);
@@ -171,14 +184,14 @@ public class GenotypesContextUnitTest extends BaseTest {
         Assert.assertEquals(gc.isMutable(), false);
     }
 
-    @Test(dataProvider = "GenotypesContextProvider", expectedExceptions = Throwable.class )
+    @Test(enabled = true, dataProvider = "GenotypesContextProvider", expectedExceptions = Throwable.class )
     public void testImmutableCall1(GenotypesContextProvider cfg) {
         GenotypesContext gc = cfg.makeContext();
         gc.immutable();
         gc.add(MISSING);
     }
 
-    @Test(dataProvider = "GenotypesContextProvider")
+    @Test(enabled = true, dataProvider = "GenotypesContextProvider")
     public void testClear(GenotypesContextProvider cfg) {
         GenotypesContext gc = cfg.makeContext();
         gc.clear();
@@ -197,7 +210,7 @@ public class GenotypesContextUnitTest extends BaseTest {
         return l;
     }
 
-    @Test(dataProvider = "GenotypesContextProvider")
+    @Test(enabled = true, dataProvider = "GenotypesContextProvider")
     public void testAdds(GenotypesContextProvider cfg) {
         Genotype add1 = new Genotype("add1", Arrays.asList(Aref, Aref));
         Genotype add2 = new Genotype("add2", Arrays.asList(Aref, Aref));
@@ -220,7 +233,7 @@ public class GenotypesContextUnitTest extends BaseTest {
         testGenotypesContextContainsExpectedSamples(gc, with(cfg.initialSamples, add1, add2));
     }
 
-    @Test(dataProvider = "GenotypesContextProvider")
+    @Test(enabled = true, dataProvider = "GenotypesContextProvider")
     public void testRemoves(GenotypesContextProvider cfg) {
         Genotype rm1 = AA;
         Genotype rm2 = AC;
@@ -257,7 +270,7 @@ public class GenotypesContextUnitTest extends BaseTest {
         testGenotypesContextContainsExpectedSamples(gc, gc.getGenotypes());
     }
 
-    @Test(dataProvider = "GenotypesContextProvider")
+    @Test(enabled = true, dataProvider = "GenotypesContextProvider")
     public void testSet(GenotypesContextProvider cfg) {
         Genotype set = new Genotype("replace", Arrays.asList(Aref, Aref));
         int n = cfg.makeContext().size();
@@ -271,7 +284,7 @@ public class GenotypesContextUnitTest extends BaseTest {
         }
     }
 
-    @Test(dataProvider = "GenotypesContextProvider")
+    @Test(enabled = true, dataProvider = "GenotypesContextProvider")
     public void testReplace(GenotypesContextProvider cfg) {
         int n = cfg.makeContext().size();
         for ( int i = 0; i < n; i++ ) {

From e467b8e1aeae88f9967001b8a8212c43db0ebf4c Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 21 Nov 2011 09:34:57 -0500
Subject: [PATCH 081/113] More contracts on LazyGenotypesContext

---
 .../sting/utils/variantcontext/GenotypesContext.java         | 2 +-
 .../sting/utils/variantcontext/LazyGenotypesContext.java     | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index ab5ab9465..25b277298 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -604,7 +604,7 @@ public class GenotypesContext implements List<Genotype> {
         }
     }
 
-    private final static boolean sameSamples(List<Genotype> genotypes, Collection<String> sampleNamesInOrder) {
+    protected final static boolean sameSamples(List<Genotype> genotypes, Collection<String> sampleNamesInOrder) {
         Set<String> names = new HashSet<String>(sampleNamesInOrder);
         if ( names.size() != sampleNamesInOrder.size() )
             return false;
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
index 7facfacf6..b3a24aef5 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
@@ -65,6 +65,8 @@ public class LazyGenotypesContext extends GenotypesContext {
      * to the LazyGenotypesContext holding encoded genotypes data
      */
     public interface LazyParser {
+        @Requires("data != null")
+        @Ensures("result != null")
         public LazyData parse(Object data);
     }
 
@@ -78,6 +80,9 @@ public class LazyGenotypesContext extends GenotypesContext {
         final Map<String, Integer> sampleNameToOffset;
         final List<String> sampleNamesInOrder;
 
+        @Requires({"genotypes != null", "sampleNamesInOrder != null", "sampleNameToOffset != null",
+            "sameSamples(genotypes, sampleNamesInOrder)",
+            "sameSamples(genotypes, sampleNameToOffset.keySet())"})
         public LazyData(final ArrayList<Genotype> genotypes,
                         final List<String> sampleNamesInOrder,
                         final Map<String, Integer> sampleNameToOffset) {

From 1296dd41bea46ddd64b20104ab02cc62eac46255 Mon Sep 17 00:00:00 2001
From: David Roazen <droazen@broadinstitute.org>
Date: Mon, 21 Nov 2011 11:52:39 -0500
Subject: [PATCH 082/113] Removing the legacy -L "interval1;interval2" syntax

This syntax predates the ability to have multiple -L arguments, is
inconsistent with the syntax of all other GATK arguments, requires
quoting to avoid interpretation by the shell, and was causing
problems in Queue.

A UserException is now thrown if someone tries to use this syntax.
---
 .../sting/commandline/IntervalBinding.java    |  2 +-
 .../sting/utils/interval/IntervalUtils.java   | 42 ++++++++++---------
 .../CallableLociWalkerIntegrationTest.java    |  2 +-
 ...astaAlternateReferenceIntegrationTest.java |  8 ++--
 .../utils/interval/IntervalUtilsUnitTest.java | 13 ++++++
 5 files changed, 41 insertions(+), 26 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/commandline/IntervalBinding.java b/public/java/src/org/broadinstitute/sting/commandline/IntervalBinding.java
index f920d90ef..82c7b20b6 100644
--- a/public/java/src/org/broadinstitute/sting/commandline/IntervalBinding.java
+++ b/public/java/src/org/broadinstitute/sting/commandline/IntervalBinding.java
@@ -45,7 +45,7 @@ import java.util.*;
  *
  * The IntervalBinding<T> is a formal GATK argument that bridges between a walker and
  * the engine to construct intervals for traversal at runtime.  The IntervalBinding can
- * either be a RodBinding<T>, a string of one or more intervals, or a file with interval strings.
+ * either be a RodBinding<T>, a string of one interval, or a file with interval strings.
  * The GATK Engine takes care of initializing the binding when appropriate and determining intervals from it.
  *
  * Note that this class is immutable.
diff --git a/public/java/src/org/broadinstitute/sting/utils/interval/IntervalUtils.java b/public/java/src/org/broadinstitute/sting/utils/interval/IntervalUtils.java
index 159b145a0..f8655f74a 100644
--- a/public/java/src/org/broadinstitute/sting/utils/interval/IntervalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/interval/IntervalUtils.java
@@ -56,28 +56,30 @@ public class IntervalUtils {
     public static List<GenomeLoc> parseIntervalArguments(GenomeLocParser parser, String arg) {
         List<GenomeLoc> rawIntervals = new ArrayList<GenomeLoc>();    // running list of raw GenomeLocs
 
-        // separate argument on semicolon first
-        for (String fileOrInterval : arg.split(";")) {
-            // if any argument is 'unmapped', "parse" it to a null entry.  A null in this case means 'all the intervals with no alignment data'.
-            if (isUnmapped(fileOrInterval))
-                rawIntervals.add(GenomeLoc.UNMAPPED);
-            // if it's a file, add items to raw interval list
-            else if (isIntervalFile(fileOrInterval)) {
-                try {
-                    rawIntervals.addAll(intervalFileToList(parser, fileOrInterval));
-                }
-                catch ( UserException.MalformedGenomeLoc e ) {
-                    throw e;
-                }
-                catch ( Exception e ) {
-                    throw new UserException.MalformedFile(fileOrInterval, "Interval file could not be parsed in any supported format.", e);
-                }
-            }
+        if ( arg.indexOf(';') != -1 ) {
+            throw new UserException.BadArgumentValue("-L " + arg, "The legacy -L \"interval1;interval2\" syntax " +
+                                                     "is no longer supported. Please use one -L argument for each " +
+                                                     "interval or an interval file instead.");
+        }
 
-                // otherwise treat as an interval -> parse and add to raw interval list
-            else {
-                rawIntervals.add(parser.parseGenomeLoc(fileOrInterval));
+        // if any argument is 'unmapped', "parse" it to a null entry.  A null in this case means 'all the intervals with no alignment data'.
+        if (isUnmapped(arg))
+            rawIntervals.add(GenomeLoc.UNMAPPED);
+        // if it's a file, add items to raw interval list
+        else if (isIntervalFile(arg)) {
+            try {
+                rawIntervals.addAll(intervalFileToList(parser, arg));
             }
+            catch ( UserException.MalformedGenomeLoc e ) {
+                throw e;
+            }
+            catch ( Exception e ) {
+                throw new UserException.MalformedFile(arg, "Interval file could not be parsed in any supported format.", e);
+            }
+        }
+        // otherwise treat as an interval -> parse and add to raw interval list
+        else {
+            rawIntervals.add(parser.parseGenomeLoc(arg));
         }
 
         return rawIntervals;
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/coverage/CallableLociWalkerIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/coverage/CallableLociWalkerIntegrationTest.java
index 1f3f8ebe6..3783525d1 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/coverage/CallableLociWalkerIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/coverage/CallableLociWalkerIntegrationTest.java
@@ -52,7 +52,7 @@ public class CallableLociWalkerIntegrationTest extends WalkerTest {
     
     @Test
     public void testCallableLociWalker2() {
-        String gatk_args = commonArgs + " -format BED -L 1:10,000,000-10,000,100;1:10,000,110-10,000,120 -summary %s";
+        String gatk_args = commonArgs + " -format BED -L 1:10,000,000-10,000,100 -L 1:10,000,110-10,000,120 -summary %s";
         WalkerTestSpec spec = new WalkerTestSpec(gatk_args, 2,
                 Arrays.asList("c671f65712d9575b8b3e1f1dbedc146e", "d287510eac04acf5a56f5cde2cba0e4a"));
         executeTest("formatBed by interval", spec);
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/fasta/FastaAlternateReferenceIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/fasta/FastaAlternateReferenceIntegrationTest.java
index 9af39e92c..1c5db4262 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/fasta/FastaAlternateReferenceIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/fasta/FastaAlternateReferenceIntegrationTest.java
@@ -12,25 +12,25 @@ public class FastaAlternateReferenceIntegrationTest extends WalkerTest {
         String md5_1 = "328d2d52cedfdc52da7d1abff487633d";
 
         WalkerTestSpec spec1a = new WalkerTestSpec(
-                "-T FastaAlternateReferenceMaker -R " + b36KGReference + " -L 1:10,000,100-10,000,500;1:10,100,000-10,101,000;1:10,900,000-10,900,001 -o %s",
+                "-T FastaAlternateReferenceMaker -R " + b36KGReference + " -L 1:10,000,100-10,000,500 -L 1:10,100,000-10,101,000 -L 1:10,900,000-10,900,001 -o %s",
                  1,
                  Arrays.asList(md5_1));
         executeTest("testFastaReference", spec1a);
 
         WalkerTestSpec spec1b = new WalkerTestSpec(
-                "-T FastaReferenceMaker -R " + b36KGReference + " -L 1:10,000,100-10,000,500;1:10,100,000-10,101,000;1:10,900,000-10,900,001 -o %s",
+                "-T FastaReferenceMaker -R " + b36KGReference + " -L 1:10,000,100-10,000,500 -L 1:10,100,000-10,101,000 -L 1:10,900,000-10,900,001 -o %s",
                  1,
                  Arrays.asList(md5_1));
         executeTest("testFastaReference", spec1b);
 
         WalkerTestSpec spec2 = new WalkerTestSpec(
-                "-T FastaAlternateReferenceMaker -R " + b36KGReference + " -V " + validationDataLocation + "NA12878.chr1_10mb_11mb.slx.indels.vcf4 --snpmask:vcf " + b36dbSNP129 + " -L 1:10,075,000-10,075,380;1:10,093,447-10,093,847;1:10,271,252-10,271,452 -o %s",
+                "-T FastaAlternateReferenceMaker -R " + b36KGReference + " -V " + validationDataLocation + "NA12878.chr1_10mb_11mb.slx.indels.vcf4 --snpmask:vcf " + b36dbSNP129 + " -L 1:10,075,000-10,075,380 -L 1:10,093,447-10,093,847 -L 1:10,271,252-10,271,452 -o %s",
                  1,
                  Arrays.asList("0567b32ebdc26604ddf2a390de4579ac"));
         executeTest("testFastaAlternateReferenceIndels", spec2);
 
         WalkerTestSpec spec3 = new WalkerTestSpec(
-                "-T FastaAlternateReferenceMaker -R " + b36KGReference + " -V " + GATKDataLocation + "dbsnp_129_b36.vcf -L 1:10,023,400-10,023,500;1:10,029,200-10,029,500 -o %s",
+                "-T FastaAlternateReferenceMaker -R " + b36KGReference + " -V " + GATKDataLocation + "dbsnp_129_b36.vcf -L 1:10,023,400-10,023,500 -L 1:10,029,200-10,029,500 -o %s",
                  1,
                  Arrays.asList("8b6cd2e20c381f9819aab2d270f5e641"));
         executeTest("testFastaAlternateReferenceSnps", spec3);
diff --git a/public/java/test/org/broadinstitute/sting/utils/interval/IntervalUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/interval/IntervalUtilsUnitTest.java
index 03d33d2c5..a9035ffd9 100644
--- a/public/java/test/org/broadinstitute/sting/utils/interval/IntervalUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/interval/IntervalUtilsUnitTest.java
@@ -3,7 +3,10 @@ package org.broadinstitute.sting.utils.interval;
 import net.sf.picard.reference.ReferenceSequenceFile;
 import net.sf.samtools.SAMFileHeader;
 import org.apache.commons.io.FileUtils;
+import org.broad.tribble.Feature;
 import org.broadinstitute.sting.BaseTest;
+import org.broadinstitute.sting.commandline.IntervalBinding;
+import org.broadinstitute.sting.gatk.GenomeAnalysisEngine;
 import org.broadinstitute.sting.gatk.datasources.reference.ReferenceDataSource;
 import org.broadinstitute.sting.utils.GenomeLocSortedSet;
 import org.testng.Assert;
@@ -983,4 +986,14 @@ public class IntervalUtilsUnitTest extends BaseTest {
                 data.toString(), data.original, actual, data.expected);
         Assert.assertEquals(actual, data.expected, description);
     }
+
+    @Test(expectedExceptions=UserException.BadArgumentValue.class)
+    public void testExceptionUponLegacyIntervalSyntax() throws Exception {
+        GenomeAnalysisEngine toolkit = new GenomeAnalysisEngine();
+        toolkit.setGenomeLocParser(new GenomeLocParser(new CachingIndexedFastaSequenceFile(new File(BaseTest.hg19Reference))));
+
+        // Attempting to use the legacy -L "interval1;interval2" syntax should produce an exception:
+        IntervalBinding<Feature> binding = new IntervalBinding<Feature>("1;2");
+        List<GenomeLoc> intervals = binding.getIntervals(toolkit);
+    }
 }

From 2c501364b80697c5859c20fd8dc30b3421272bf8 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 21 Nov 2011 14:34:31 -0500
Subject: [PATCH 083/113] GenotypesContext no longer have immutability in
 constructor

-- additional bug fixes throughout VariantContext and GenotypesContext objects
---
 .../variantcontext/GenotypesContext.java      | 57 +++++++++++++------
 .../variantcontext/LazyGenotypesContext.java  |  4 +-
 .../VariantAnnotatorIntegrationTest.java      |  2 +-
 .../GenotypesContextUnitTest.java             | 12 +++-
 .../VariantContextUnitTest.java               |  3 +-
 5 files changed, 55 insertions(+), 23 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 25b277298..8d28ba18c 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -38,7 +38,7 @@ public class GenotypesContext implements List<Genotype> {
      * static constant value for an empty GenotypesContext.  Useful since so many VariantContexts have no genotypes
      */
     public final static GenotypesContext NO_GENOTYPES =
-            new GenotypesContext(new ArrayList<Genotype>(0), new HashMap<String, Integer>(0), Collections.<String>emptyList(), true);
+            new GenotypesContext(new ArrayList<Genotype>(0), new HashMap<String, Integer>(0), Collections.<String>emptyList()).immutable();
 
     /**
      *sampleNamesInOrder a list of sample names, one for each genotype in genotypes, sorted in alphabetical order
@@ -77,24 +77,23 @@ public class GenotypesContext implements List<Genotype> {
      * Create an empty GenotypeContext
      */
     protected GenotypesContext() {
-        this(10, false);
+        this(10);
     }
 
     /**
      * Create an empty GenotypeContext, with initial capacity for n elements
      */
     @Requires("n >= 0")
-    protected GenotypesContext(final int n, final boolean immutable) {
-        this(new ArrayList<Genotype>(n), immutable);
+    protected GenotypesContext(final int n) {
+        this(new ArrayList<Genotype>(n));
     }
 
     /**
      * Create an GenotypeContext containing genotypes
      */
-    @Requires("genotypes != null")
-    protected GenotypesContext(final ArrayList<Genotype> genotypes, final boolean immutable) {
+    @Requires({"genotypes != null", "noDups(genotypes)"})
+    protected GenotypesContext(final ArrayList<Genotype> genotypes) {
         this.notToBeDirectlyAccessedGenotypes = genotypes;
-        this.immutable = immutable;
         this.sampleNameToOffset = null;
         this.cacheIsInvalid = true;
     }
@@ -109,19 +108,16 @@ public class GenotypesContext implements List<Genotype> {
      * genotype in the vector of genotypes
      * @param sampleNamesInOrder a list of sample names, one for each genotype in genotypes, sorted in alphabetical
      * order.
-     * @param immutable
      */
-    @Requires({"genotypes != null",
+    @Requires({"genotypes != null", "noDups(genotypes)",
             "sampleNameToOffset != null",
             "sampleNamesInOrder != null",
             "genotypes.size() == sampleNameToOffset.size()",
             "genotypes.size() == sampleNamesInOrder.size()"})
     protected GenotypesContext(final ArrayList<Genotype> genotypes,
                              final Map<String, Integer> sampleNameToOffset,
-                             final List<String> sampleNamesInOrder,
-                             final boolean immutable) {
+                             final List<String> sampleNamesInOrder) {
         this.notToBeDirectlyAccessedGenotypes = genotypes;
-        this.immutable = immutable;
         this.sampleNameToOffset = sampleNameToOffset;
         this.sampleNamesInOrder = sampleNamesInOrder;
         this.cacheIsInvalid = false;
@@ -149,7 +145,7 @@ public class GenotypesContext implements List<Genotype> {
     @Requires("nGenotypes >= 0")
     @Ensures({"result != null"})
     public static final GenotypesContext create(final int nGenotypes) {
-        return new GenotypesContext(nGenotypes, false);
+        return new GenotypesContext(nGenotypes);
     }
 
     /**
@@ -173,7 +169,7 @@ public class GenotypesContext implements List<Genotype> {
     public static final GenotypesContext create(final ArrayList<Genotype> genotypes,
                                                 final Map<String, Integer> sampleNameToOffset,
                                                 final List<String> sampleNamesInOrder) {
-        return new GenotypesContext(genotypes, sampleNameToOffset, sampleNamesInOrder, false);
+        return new GenotypesContext(genotypes, sampleNameToOffset, sampleNamesInOrder);
     }
 
     /**
@@ -185,7 +181,7 @@ public class GenotypesContext implements List<Genotype> {
     @Requires({"genotypes != null"})
     @Ensures({"result != null"})
     public static final GenotypesContext create(final ArrayList<Genotype> genotypes) {
-        return genotypes == null ? NO_GENOTYPES : new GenotypesContext(genotypes, false);
+        return genotypes == null ? NO_GENOTYPES : new GenotypesContext(genotypes);
     }
 
     /**
@@ -197,7 +193,7 @@ public class GenotypesContext implements List<Genotype> {
     @Requires({"genotypes != null"})
     @Ensures({"result != null"})
     public static final GenotypesContext create(final Genotype... genotypes) {
-        return new GenotypesContext(new ArrayList<Genotype>(Arrays.asList(genotypes)), false);
+        return create(new ArrayList<Genotype>(Arrays.asList(genotypes)));
     }
 
     /**
@@ -306,14 +302,16 @@ public class GenotypesContext implements List<Genotype> {
     }
 
     @Override
-    @Requires("genotype != null")
+    @Requires({"genotype != null", "get(genotype.getSampleName()) == null"})
+    @Ensures("noDups(getGenotypes())")
     public boolean add(final Genotype genotype) {
         checkImmutability();
         invalidateCaches();
         return getGenotypes().add(genotype);
     }
 
-    @Requires("genotype != null")
+    @Requires({"genotype != null", "! containsAny(Arrays.asList(genotype))"})
+    @Ensures("noDups(getGenotypes())")
     public boolean add(final Genotype ... genotype) {
         checkImmutability();
         invalidateCaches();
@@ -321,11 +319,15 @@ public class GenotypesContext implements List<Genotype> {
     }
 
     @Override
+    @Requires("! contains(genotype)")
+    @Ensures("noDups(getGenotypes())")
     public void add(final int i, final Genotype genotype) {
         throw new UnsupportedOperationException();
     }
 
     @Override
+    @Requires("! containsAny(genotypes)")
+    @Ensures("noDups(getGenotypes())")
     public boolean addAll(final Collection<? extends Genotype> genotypes) {
         checkImmutability();
         invalidateCaches();
@@ -347,6 +349,13 @@ public class GenotypesContext implements List<Genotype> {
         return getGenotypes().containsAll(objects);
     }
 
+    private boolean containsAny(final Collection<? extends Genotype> genotypes) {
+        for ( final Genotype g : genotypes ) {
+            if ( contains(g) ) return true;
+        }
+        return false;
+    }
+
     @Override
     public Genotype get(final int i) {
         return getGenotypes().get(i);
@@ -421,6 +430,7 @@ public class GenotypesContext implements List<Genotype> {
     }
 
     @Override
+    @Ensures("noDups(getGenotypes())")
     public Genotype set(final int i, final Genotype genotype) {
         checkImmutability();
         invalidateCaches();
@@ -604,6 +614,17 @@ public class GenotypesContext implements List<Genotype> {
         }
     }
 
+    protected final static boolean noDups(Collection<Genotype> genotypes) {
+        Set<String> names = new HashSet<String>(genotypes.size());
+        for ( final Genotype g : genotypes ) {
+            if ( names.contains(g.getSampleName()) )
+                return false;
+            names.add(g.getSampleName());
+        }
+
+        return true;
+     }
+
     protected final static boolean sameSamples(List<Genotype> genotypes, Collection<String> sampleNamesInOrder) {
         Set<String> names = new HashSet<String>(sampleNamesInOrder);
         if ( names.size() != sampleNamesInOrder.size() )
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
index b3a24aef5..5fbaadfab 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
@@ -73,7 +73,7 @@ public class LazyGenotypesContext extends GenotypesContext {
     /**
      * Returns the data used in the full GenotypesContext constructor
      *
-     * {@link GenotypesContext#GenotypesContext(java.util.ArrayList, java.util.Map, java.util.List, boolean)}
+     * {@link GenotypesContext#GenotypesContext(java.util.ArrayList, java.util.Map, java.util.List)}
      */
     public static class LazyData {
         final ArrayList<Genotype> genotypes;
@@ -102,7 +102,7 @@ public class LazyGenotypesContext extends GenotypesContext {
      */
     @Requires({"parser != null", "unparsedGenotypeData != null", "nUnparsedGenotypes >= 0"})
     public LazyGenotypesContext(final LazyParser parser, final Object unparsedGenotypeData, final int nUnparsedGenotypes) {
-        super(EMPTY, false);
+        super(EMPTY);
         this.parser = parser;
         this.unparsedGenotypeData = unparsedGenotypeData;
         this.nUnparsedGenotypes = nUnparsedGenotypes;
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
index 75c27e429..1824789a9 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/annotator/VariantAnnotatorIntegrationTest.java
@@ -58,7 +58,7 @@ public class VariantAnnotatorIntegrationTest extends WalkerTest {
         // they don't get reordered.  It's a good test of the genotype ordering system.
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --variant:VCF3 " + validationDataLocation + "vcfexample3empty.vcf -I " + validationDataLocation + "NA12878.1kg.p2.chr1_10mb_11_mb.SLX.bam -L 1:10,000,000-10,050,000", 1,
-                Arrays.asList("0cc0ec59f0328792e6413b6ff3f71780"));
+                Arrays.asList("f2ddfa8105c290b1f34b7a261a02a1ac"));
         executeTest("test file doesn't have annotations, not asking for annotations, #2", spec);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
index c12fbac9c..afb9336a0 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
@@ -77,6 +77,11 @@ public class GenotypesContextUnitTest extends BaseTest {
         public GenotypesContext make(final List<Genotype> initialSamples) {
             return GenotypesContext.copy(initialSamples);
         }
+
+        @Override
+        public String toString() {
+            return "GenotypesContext";
+        }
     };
 
     private final class lazyMaker implements LazyGenotypesContext.LazyParser, ContextMaker {
@@ -91,6 +96,11 @@ public class GenotypesContextUnitTest extends BaseTest {
         public GenotypesContext make(final List<Genotype> initialSamples) {
             return new LazyGenotypesContext(this, initialSamples, initialSamples.size());
         }
+
+        @Override
+        public String toString() {
+            return "LazyGenotypesContext";
+        }
     }
 
     private Collection<ContextMaker> allMakers = Arrays.asList(baseMaker, new lazyMaker());
@@ -100,7 +110,7 @@ public class GenotypesContextUnitTest extends BaseTest {
         final List<Genotype> initialSamples;
 
         private GenotypesContextProvider(ContextMaker maker, List<Genotype> initialSamples) {
-            super(GenotypesContextProvider.class);
+            super(GenotypesContextProvider.class, String.format("%s with %d samples", maker.toString(), initialSamples.size()));
             this.maker = maker;
             this.initialSamples = initialSamples;
         }
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
index a7eac7ab9..fca7440e4 100755
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/VariantContextUnitTest.java
@@ -834,7 +834,8 @@ public class VariantContextUnitTest extends BaseTest {
             for ( int j = 0; j < i; j++ ) {
                 nSamples++;
                 Genotype g = allGenotypes.get(j % allGenotypes.size());
-                gc.add(g);
+                final String name = String.format("%s_%d%d", g.getSampleName(), i, j);
+                gc.add(new Genotype(name, g.getAlleles()));
                 switch ( g.getType() ) {
                     case NO_CALL: nNoCall++; nNoCallAlleles++; break;
                     case HOM_REF: nA += 2; nHomRef++; break;

From 1561af22af6a54cab3625242f0b5289735b6a925 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 21 Nov 2011 14:35:15 -0500
Subject: [PATCH 084/113] Exact model code cleanup

-- Fixed up code when fixing a bug detected by aggressive contracts in GenotypesContext.
---
 .../genotyper/ExactAFCalculationModel.java    | 104 ++++++++----------
 1 file changed, 45 insertions(+), 59 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index 354702dad..6aa2be419 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -42,6 +42,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
     private final static double MAX_LOG10_ERROR_TO_STOP_EARLY = 6; // we want the calculation to be accurate to 1 / 10^6
     private final boolean SIMPLE_GREEDY_GENOTYPER = false;
     private final static double SUM_GL_THRESH_NOCALL = -0.001; // if sum(gl) is bigger than this threshold, we treat GL's as non-informative and will force a no-call.
+    private final List<Allele> NO_CALL_ALLELES = Arrays.asList(Allele.NO_CALL, Allele.NO_CALL);
 
     protected ExactAFCalculationModel(UnifiedArgumentCollection UAC, int N, Logger logger, PrintStream verboseWriter) {
         super(UAC, N, logger, verboseWriter);
@@ -265,8 +266,8 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
      * @return calls
      */
     public GenotypesContext assignGenotypes(VariantContext vc,
-                                       double[] log10AlleleFrequencyPosteriors,
-                                       int AFofMaxLikelihood) {
+                                            double[] log10AlleleFrequencyPosteriors,
+                                            int AFofMaxLikelihood) {
         if ( !vc.isVariant() )
             throw new UserException("The VCF record passed in does not contain an ALT allele at " + vc.getChr() + ":" + vc.getStart());
 
@@ -338,8 +339,7 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
             }
         }
 
-        GenotypesContext calls = GenotypesContext.create();
-
+        final GenotypesContext calls = GenotypesContext.create();
         int startIdx = AFofMaxLikelihood;
         for (int k = sampleIdx; k > 0; k--) {
             int bestGTguess;
@@ -353,65 +353,51 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
 
             double[] likelihoods = g.getLikelihoods().getAsVector();
 
-            if (SIMPLE_GREEDY_GENOTYPER || !vc.isBiallelic()) {
-                bestGTguess = Utils.findIndexOfMaxEntry(likelihoods);
-            }
-            else {
-                int newIdx = tracebackArray[k][startIdx];;
-                bestGTguess = startIdx - newIdx;
-                startIdx = newIdx;
-            }
-
-            // likelihoods are stored row-wise in lower triangular matrix. IE
-            // for 2 alleles they have ordering AA,AB,BB
-            // for 3 alleles they are ordered AA,AB,BB,AC,BC,CC
-            // Get now alleles corresponding to best index
-            int kk=0;
-            boolean done = false;
-            for (int j=0; j < vc.getNAlleles(); j++) {
-                for (int i=0; i <= j; i++){
-                    if (kk++ == bestGTguess) {
-                        if (i==0)
-                            myAlleles.add(vc.getReference());
-                        else
-                            myAlleles.add(vc.getAlternateAllele(i-1));
-
-                        if (j==0)
-                            myAlleles.add(vc.getReference());
-                        else
-                            myAlleles.add(vc.getAlternateAllele(j-1));
-                        done = true;
-                        break;
-                    }
-
+            if (MathUtils.sum(likelihoods) <= SUM_GL_THRESH_NOCALL) {
+                if (SIMPLE_GREEDY_GENOTYPER || !vc.isBiallelic()) {
+                    bestGTguess = Utils.findIndexOfMaxEntry(likelihoods);
                 }
-                if (done)
-                    break;
+                else {
+                    int newIdx = tracebackArray[k][startIdx];;
+                    bestGTguess = startIdx - newIdx;
+                    startIdx = newIdx;
+                }
+
+                // likelihoods are stored row-wise in lower triangular matrix. IE
+                // for 2 alleles they have ordering AA,AB,BB
+                // for 3 alleles they are ordered AA,AB,BB,AC,BC,CC
+                // Get now alleles corresponding to best index
+                int kk=0;
+                boolean done = false;
+                for (int j=0; j < vc.getNAlleles(); j++) {
+                    for (int i=0; i <= j; i++){
+                        if (kk++ == bestGTguess) {
+                            if (i==0)
+                                myAlleles.add(vc.getReference());
+                            else
+                                myAlleles.add(vc.getAlternateAllele(i-1));
+
+                            if (j==0)
+                                myAlleles.add(vc.getReference());
+                            else
+                                myAlleles.add(vc.getAlternateAllele(j-1));
+                            done = true;
+                            break;
+                        }
+
+                    }
+                    if (done)
+                        break;
+                }
+
+                final double qual = GenotypeLikelihoods.getQualFromLikelihoods(bestGTguess, likelihoods);
+                calls.add(new Genotype(sample, myAlleles, qual, null, g.getAttributes(), false));
+            } else {
+                final double qual = Genotype.NO_LOG10_PERROR;
+                calls.add(new Genotype(sample, NO_CALL_ALLELES, qual, null, g.getAttributes(), false));
             }
-
-            final double qual = GenotypeLikelihoods.getQualFromLikelihoods(bestGTguess, likelihoods);
-            //System.out.println(myAlleles.toString());
-            calls.add(new Genotype(sample, myAlleles, qual, null, g.getAttributes(), false));
         }
 
-        for ( final Genotype genotype : GLs.iterateInSampleNameOrder() ) {
-            if ( !genotype.hasLikelihoods() )
-                continue;
-            Genotype g = GLs.get(genotype.getSampleName());
-
-            double[] likelihoods = genotype.getLikelihoods().getAsVector();
-
-            if (MathUtils.sum(likelihoods) <= SUM_GL_THRESH_NOCALL)
-                continue; // regular likelihoods
-
-            ArrayList<Allele> myAlleles = new ArrayList<Allele>();
-
-            double qual = Genotype.NO_LOG10_PERROR;
-            myAlleles.add(Allele.NO_CALL);
-            myAlleles.add(Allele.NO_CALL);
-            //System.out.println(myAlleles.toString());
-            calls.add(new Genotype(genotype.getSampleName(), myAlleles, qual, null, g.getAttributes(), false));
-        }
         return calls;
     }
 

From 022832bd74f32b8edb0663fc64034fa45265f0f1 Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Mon, 21 Nov 2011 14:49:47 -0500
Subject: [PATCH 085/113] Very bad use of the == operator with Strings was
 ensuring that validating GenomeLocs was very inefficient.  This fix resulted
 in a significant speedup for a simple RodWalker.

---
 .../src/org/broadinstitute/sting/utils/GenomeLocParser.java   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/GenomeLocParser.java b/public/java/src/org/broadinstitute/sting/utils/GenomeLocParser.java
index 8cba183da..4f1df9e7b 100644
--- a/public/java/src/org/broadinstitute/sting/utils/GenomeLocParser.java
+++ b/public/java/src/org/broadinstitute/sting/utils/GenomeLocParser.java
@@ -87,12 +87,12 @@ public class GenomeLocParser {
 
         @Requires("contig != null")
         public synchronized boolean hasContig(final String contig) {
-            return lastContig == contig || dict.getSequence(contig) != null;
+            return contig.equals(lastContig) || dict.getSequence(contig) != null;
         }
 
         @Requires("index >= 0")
         public synchronized boolean hasContig(final int index) {
-            return lastIndex == index|| dict.getSequence(index) != null;
+            return lastIndex == index || dict.getSequence(index) != null;
         }
 
         @Requires("contig != null")

From ab2efe3bd38b6d057db1b2588f2f9e3118ac517b Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 21 Nov 2011 16:14:40 -0500
Subject: [PATCH 086/113] Reverting bad exact model changes

---
 .../genotyper/ExactAFCalculationModel.java    | 97 +++++++++++--------
 1 file changed, 54 insertions(+), 43 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index 6aa2be419..91f6acd3d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -339,7 +339,8 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
             }
         }
 
-        final GenotypesContext calls = GenotypesContext.create();
+        GenotypesContext calls = GenotypesContext.create();
+
         int startIdx = AFofMaxLikelihood;
         for (int k = sampleIdx; k > 0; k--) {
             int bestGTguess;
@@ -353,49 +354,59 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
 
             double[] likelihoods = g.getLikelihoods().getAsVector();
 
-            if (MathUtils.sum(likelihoods) <= SUM_GL_THRESH_NOCALL) {
-                if (SIMPLE_GREEDY_GENOTYPER || !vc.isBiallelic()) {
-                    bestGTguess = Utils.findIndexOfMaxEntry(likelihoods);
-                }
-                else {
-                    int newIdx = tracebackArray[k][startIdx];;
-                    bestGTguess = startIdx - newIdx;
-                    startIdx = newIdx;
-                }
-
-                // likelihoods are stored row-wise in lower triangular matrix. IE
-                // for 2 alleles they have ordering AA,AB,BB
-                // for 3 alleles they are ordered AA,AB,BB,AC,BC,CC
-                // Get now alleles corresponding to best index
-                int kk=0;
-                boolean done = false;
-                for (int j=0; j < vc.getNAlleles(); j++) {
-                    for (int i=0; i <= j; i++){
-                        if (kk++ == bestGTguess) {
-                            if (i==0)
-                                myAlleles.add(vc.getReference());
-                            else
-                                myAlleles.add(vc.getAlternateAllele(i-1));
-
-                            if (j==0)
-                                myAlleles.add(vc.getReference());
-                            else
-                                myAlleles.add(vc.getAlternateAllele(j-1));
-                            done = true;
-                            break;
-                        }
-
-                    }
-                    if (done)
-                        break;
-                }
-
-                final double qual = GenotypeLikelihoods.getQualFromLikelihoods(bestGTguess, likelihoods);
-                calls.add(new Genotype(sample, myAlleles, qual, null, g.getAttributes(), false));
-            } else {
-                final double qual = Genotype.NO_LOG10_PERROR;
-                calls.add(new Genotype(sample, NO_CALL_ALLELES, qual, null, g.getAttributes(), false));
+            if (SIMPLE_GREEDY_GENOTYPER || !vc.isBiallelic()) {
+                bestGTguess = Utils.findIndexOfMaxEntry(likelihoods);
             }
+            else {
+                int newIdx = tracebackArray[k][startIdx];;
+                bestGTguess = startIdx - newIdx;
+                startIdx = newIdx;
+            }
+
+            // likelihoods are stored row-wise in lower triangular matrix. IE
+            // for 2 alleles they have ordering AA,AB,BB
+            // for 3 alleles they are ordered AA,AB,BB,AC,BC,CC
+            // Get now alleles corresponding to best index
+            int kk=0;
+            boolean done = false;
+            for (int j=0; j < vc.getNAlleles(); j++) {
+                for (int i=0; i <= j; i++){
+                    if (kk++ == bestGTguess) {
+                        if (i==0)
+                            myAlleles.add(vc.getReference());
+                        else
+                            myAlleles.add(vc.getAlternateAllele(i-1));
+
+                        if (j==0)
+                            myAlleles.add(vc.getReference());
+                        else
+                            myAlleles.add(vc.getAlternateAllele(j-1));
+                        done = true;
+                        break;
+                    }
+
+                }
+                if (done)
+                    break;
+            }
+
+            final double qual = GenotypeLikelihoods.getQualFromLikelihoods(bestGTguess, likelihoods);
+            //System.out.println(myAlleles.toString());
+            calls.add(new Genotype(sample, myAlleles, qual, null, g.getAttributes(), false));
+        }
+
+        for ( final Genotype genotype : GLs.iterateInSampleNameOrder() ) {
+            if ( !genotype.hasLikelihoods() )
+                continue;
+            Genotype g = GLs.get(genotype.getSampleName());
+
+            double[] likelihoods = genotype.getLikelihoods().getAsVector();
+
+            if (MathUtils.sum(likelihoods) <= SUM_GL_THRESH_NOCALL)
+                continue; // regular likelihoods
+
+            final double qual = Genotype.NO_LOG10_PERROR;
+            calls.add(new Genotype(g.getSampleName(), NO_CALL_ALLELES, qual, null, g.getAttributes(), false));
         }
 
         return calls;

From 9ea7b70a02640c9f6f19d85b2c50123fd707835a Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 21 Nov 2011 16:21:23 -0500
Subject: [PATCH 087/113] Added decode method to LazyGenotypesContext

-- AbstractVCFCodec calls this if the samples are not sorted.  Previously called getGenotypes() which didn't actually trigger the decode
---
 .../gatk/walkers/beagle/BeagleOutputToVCFWalker.java   | 10 +++++-----
 .../sting/utils/codecs/vcf/AbstractVCFCodec.java       |  8 +++++---
 .../utils/variantcontext/LazyGenotypesContext.java     |  7 +++++++
 3 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
index 8c6038e7e..f827856be 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/beagle/BeagleOutputToVCFWalker.java
@@ -178,8 +178,8 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
         // ignore places where we don't have a variant
         if ( beagleR2Feature == null || beagleProbsFeature == null ||  beaglePhasedFeature == null)
         {
-           vcfWriter.add(vc_input);
-           return 1;
+            vcfWriter.add(vc_input);
+            return 1;
         }
 
 
@@ -249,9 +249,9 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
             Allele bglAlleleA, bglAlleleB;
 
             if (alleleA.matches(refString))
-               bglAlleleA = Allele.create(alleleA,true);
+                bglAlleleA = Allele.create(alleleA,true);
             else
-               bglAlleleA = Allele.create(alleleA,false);
+                bglAlleleA = Allele.create(alleleA,false);
 
             if (alleleB.matches(refString))
                 bglAlleleB = Allele.create(alleleB,true);
@@ -280,7 +280,7 @@ public class BeagleOutputToVCFWalker  extends RodWalker<Integer, Integer> {
             // deal with numerical errors coming from limited formatting value on Beagle output files
             if (probWrongGenotype > 1 - MIN_PROB_ERROR)
                 probWrongGenotype = 1 - MIN_PROB_ERROR;
-            
+
             if (1-probWrongGenotype < noCallThreshold) {
                 // quality is bad: don't call genotype
                 alleles.clear();
diff --git a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
index 216ee3fb6..7cceaa008 100755
--- a/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
+++ b/public/java/src/org/broadinstitute/sting/utils/codecs/vcf/AbstractVCFCodec.java
@@ -321,6 +321,11 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec {
             final LazyGenotypesContext.LazyParser lazyParser = new LazyVCFGenotypesParser(alleles, chr, pos);
             final int nGenotypes = header.getGenotypeSamples().size();
             LazyGenotypesContext lazy = new LazyGenotypesContext(lazyParser, parts[8], nGenotypes);
+
+            // did we resort the sample names?  If so, we need to load the genotype data
+            if ( !header.samplesWereAlreadySorted() )
+                lazy.decode();
+
             builder.genotypesNoValidation(lazy);
         }
 
@@ -332,9 +337,6 @@ public abstract class AbstractVCFCodec implements FeatureCodec, NameAwareCodec {
             generateException(e.getMessage());
         }
 
-        // did we resort the sample names?  If so, we need to load the genotype data
-        if ( !header.samplesWereAlreadySorted() )
-            vc.getGenotypes();
 
         return vc;
     }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
index 5fbaadfab..574bdc3d0 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
@@ -177,4 +177,11 @@ public class LazyGenotypesContext extends GenotypesContext {
     public Object getUnparsedGenotypeData() {
         return unparsedGenotypeData;
     }
+
+    /**
+     * Force us to decode the genotypes
+     */
+    public void decode() {
+        buildCache();
+    }
 }

From 5ad3dfcd6207cba89c6824099042e0f4665ab811 Mon Sep 17 00:00:00 2001
From: Mauricio Carneiro <carneiro@broadinstitute.org>
Date: Mon, 21 Nov 2011 14:50:51 -0500
Subject: [PATCH 088/113] BugFix: byte overflow in SyntheticRead compressed
 base counts

* fixed and added unit test
---
 public/java/src/org/broadinstitute/sting/utils/MathUtils.java | 4 ++++
 .../org/broadinstitute/sting/utils/ReadUtilsUnitTest.java     | 4 ++--
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/MathUtils.java b/public/java/src/org/broadinstitute/sting/utils/MathUtils.java
index 17f458f31..f92d4be78 100644
--- a/public/java/src/org/broadinstitute/sting/utils/MathUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/MathUtils.java
@@ -188,6 +188,10 @@ public class MathUtils {
         return ! Double.isInfinite(val) && ! Double.isNaN(val);
     }
 
+    public static double bound(double value, double minBoundary, double maxBoundary) {
+        return Math.max(Math.min(value,  maxBoundary), minBoundary);
+    }
+
     public static boolean isBounded(double val, double lower, double upper) {
         return val >= lower && val <= upper;
     }
diff --git a/public/java/test/org/broadinstitute/sting/utils/ReadUtilsUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/ReadUtilsUnitTest.java
index 53368c339..630beaece 100755
--- a/public/java/test/org/broadinstitute/sting/utils/ReadUtilsUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/ReadUtilsUnitTest.java
@@ -16,8 +16,8 @@ public class ReadUtilsUnitTest extends BaseTest {
     GATKSAMRecord read, reducedRead;
     final static String BASES = "ACTG";
     final static String QUALS = "!+5?";
-    final private static byte[] REDUCED_READ_COUNTS =     new byte[]{10, 20, 30, 40};
-    final private static byte[] REDUCED_READ_COUNTS_TAG = new byte[]{10, 10, 20, 30};  // just the offsets
+    final private static byte[] REDUCED_READ_COUNTS =     new byte[]{10, 20, 30, 40, 1};
+    final private static byte[] REDUCED_READ_COUNTS_TAG = new byte[]{10, 10, 20, 30, -9};  // just the offsets
 
     @BeforeTest
     public void init() {

From 5443d3634a11f7cc36e8e4d7dfa31e0b271c1fb7 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Mon, 21 Nov 2011 19:15:56 -0500
Subject: [PATCH 091/113] Again, fixing the add call when we really mean
 replace

-- Updating MD5s for UG to reflect that what was previously called ./.:.:10:0,0,0 is now just ./.  Eric will fix long-standing bug in QD observed from this change
-- VFW MD5s restored to their old correct values.  There was a bug in my implementation to caused the genotypes to not be parsed from the lazy output even through the header was incorrect.
---
 .../genotyper/ExactAFCalculationModel.java    |  6 +--
 .../VariantFiltrationIntegrationTest.java     | 37 ++++---------------
 .../UnifiedGenotyperIntegrationTest.java      |  2 +-
 3 files changed, 12 insertions(+), 33 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
index 91f6acd3d..5d0b6f0a7 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/genotyper/ExactAFCalculationModel.java
@@ -398,15 +398,15 @@ public class ExactAFCalculationModel extends AlleleFrequencyCalculationModel {
         for ( final Genotype genotype : GLs.iterateInSampleNameOrder() ) {
             if ( !genotype.hasLikelihoods() )
                 continue;
-            Genotype g = GLs.get(genotype.getSampleName());
 
-            double[] likelihoods = genotype.getLikelihoods().getAsVector();
+            final Genotype g = GLs.get(genotype.getSampleName());
+            final double[] likelihoods = genotype.getLikelihoods().getAsVector();
 
             if (MathUtils.sum(likelihoods) <= SUM_GL_THRESH_NOCALL)
                 continue; // regular likelihoods
 
             final double qual = Genotype.NO_LOG10_PERROR;
-            calls.add(new Genotype(g.getSampleName(), NO_CALL_ALLELES, qual, null, g.getAttributes(), false));
+            calls.replace(new Genotype(g.getSampleName(), NO_CALL_ALLELES, qual, null, g.getAttributes(), false));
         }
 
         return calls;
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationIntegrationTest.java
index c2348b4a3..2c04cebd4 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/filters/VariantFiltrationIntegrationTest.java
@@ -14,12 +14,9 @@ public class VariantFiltrationIntegrationTest extends WalkerTest {
 
     @Test
     public void testNoAction() {
-        // note that this input if slightly malformed, but with the new properly
-        // only when really needed genotype loading of VCF files we don't actually
-        // fix the file in the output
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("b7b7c218e219cd923ce5b6eefc5b7171"));
+                Arrays.asList("8a105fa5eebdfffe7326bc5b3d8ffd1c"));
         executeTest("test no action", spec);
     }
 
@@ -27,73 +24,55 @@ public class VariantFiltrationIntegrationTest extends WalkerTest {
     public void testClusteredSnps() {
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -window 10 --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("6d45a19e4066e7de6ff6a61f43ffad2b"));
+                Arrays.asList("27b13f179bb4920615dff3a32730d845"));
         executeTest("test clustered SNPs", spec);
     }
 
     @Test
     public void testMask1() {
-        // note that this input if slightly malformed, but with the new properly
-        // only when really needed genotype loading of VCF files we don't actually
-        // fix the file in the output
         WalkerTestSpec spec1 = new WalkerTestSpec(
                 baseTestString() + " -maskName foo --mask:VCF3 " + validationDataLocation + "vcfexample2.vcf --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("65b5006bf3ee9d9d08a36d6b854773f2"));
+                Arrays.asList("578f9e774784c25871678e6464fd212b"));
         executeTest("test mask all", spec1);
     }
 
     @Test
     public void testMask2() {
-        // note that this input if slightly malformed, but with the new properly
-        // only when really needed genotype loading of VCF files we don't actually
-        // fix the file in the output
         WalkerTestSpec spec2 = new WalkerTestSpec(
                 baseTestString() + " -maskName foo --mask:VCF " + validationDataLocation + "vcfMask.vcf --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("a275d36baca81a1ce03dbb528e95a069"));
+                Arrays.asList("bfa86a674aefca1b13d341cb14ab3c4f"));
         executeTest("test mask some", spec2);
     }
 
     @Test
     public void testMask3() {
-        // note that this input if slightly malformed, but with the new properly
-        // only when really needed genotype loading of VCF files we don't actually
-        // fix the file in the output
         WalkerTestSpec spec3 = new WalkerTestSpec(
                 baseTestString() + " -maskName foo -maskExtend 10 --mask:VCF " + validationDataLocation + "vcfMask.vcf --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("c9489e1c1342817c36ab4f0770609bdb"));
+                Arrays.asList("5939f80d14b32d88587373532d7b90e5"));
         executeTest("test mask extend", spec3);
     }
 
     @Test
     public void testFilter1() {
         WalkerTestSpec spec = new WalkerTestSpec(
-        // note that this input if slightly malformed, but with the new properly
-        // only when really needed genotype loading of VCF files we don't actually
-        // fix the file in the output
                 baseTestString() + " -filter 'DoC < 20 || FisherStrand > 20.0' -filterName foo --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("327a611bf82c6c4ae77fbb6d06359f9d"));
+                Arrays.asList("45219dbcfb6f81bba2ea0c35f5bfd368"));
         executeTest("test filter #1", spec);
     }
 
     @Test
     public void testFilter2() {
-        // note that this input if slightly malformed, but with the new properly
-        // only when really needed genotype loading of VCF files we don't actually
-        // fix the file in the output
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " -filter 'AlleleBalance < 70.0 && FisherStrand == 1.4' -filterName bar --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("7612b3460575402ad78fa4173178bdcc"));
+                Arrays.asList("c95845e817da7352b9b72bc9794f18fb"));
         executeTest("test filter #2", spec);
     }
 
     @Test
     public void testFilterWithSeparateNames() {
-        // note that this input if slightly malformed, but with the new properly
-        // only when really needed genotype loading of VCF files we don't actually
-        // fix the file in the output
         WalkerTestSpec spec = new WalkerTestSpec(
                 baseTestString() + " --filterName ABF -filter 'AlleleBalance < 0.7' --filterName FSF -filter 'FisherStrand == 1.4' --variant:VCF3 " + validationDataLocation + "vcfexample2.vcf -L 1:10,020,000-10,021,000", 1,
-                Arrays.asList("dce33441f58b284ac9ab94f8e64b84e3"));
+                Arrays.asList("b8cdd7f44ff1a395e0a9b06a87e1e530"));
         executeTest("test filter with separate names #2", spec);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
index fc234ec24..95b5855c1 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
@@ -295,7 +295,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
         WalkerTest.WalkerTestSpec spec4 = new WalkerTest.WalkerTestSpec(
                 baseCommandIndelsb37 + " --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "ALL.wgs.union_v2_chr20_100_110K.20101123.indels.sites.vcf -I " + validationDataLocation +
                         "phase1_GBR_realigned.chr20.100K-110K.bam -o %s -L 20:100,000-110,000", 1,
-                Arrays.asList("1e02f57fafaa41db71c531eb25e148e1"));
+                Arrays.asList("9be28cb208d8b0314d2bc2696e2fd8d4"));
         executeTest("test MultiSample 1000G Phase1 indels with complicated records emitting all sites", spec4);
     }
 

From 29ca24694a9f819e5c709c82149a5b431a22a787 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 22 Nov 2011 08:22:32 -0500
Subject: [PATCH 093/113] UG now encoding NO_CALLs as ./. not ./.:.:4:0,0,0

A few updated UGs integration tests
---
 .../walkers/genotyper/UnifiedGenotyperIntegrationTest.java    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
index 95b5855c1..34e1ad30e 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/genotyper/UnifiedGenotyperIntegrationTest.java
@@ -29,7 +29,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testMultiSamplePilot1() {
         WalkerTest.WalkerTestSpec spec = new WalkerTest.WalkerTestSpec(
                 baseCommand + " -I " + validationDataLocation + "low_coverage_CEU.chr1.10k-11k.bam -o %s -L 1:10,022,000-10,025,000", 1,
-                Arrays.asList("f5c8bd653aed02059b9f377833eae5bb"));
+                Arrays.asList("286f0de92e4ce57986ba861390c6019d"));
         executeTest("test MultiSample Pilot1", spec);
     }
 
@@ -45,7 +45,7 @@ public class UnifiedGenotyperIntegrationTest extends WalkerTest {
     public void testWithAllelesPassedIn2() {
         WalkerTest.WalkerTestSpec spec2 = new WalkerTest.WalkerTestSpec(
                 baseCommand + " --output_mode EMIT_ALL_SITES --genotyping_mode GENOTYPE_GIVEN_ALLELES -alleles " + validationDataLocation + "allelesForUG.vcf -I " + validationDataLocation + "pilot2_daughters.chr20.10k-11k.bam -o %s -L 20:10,000,000-10,025,000", 1,
-                Arrays.asList("030ce4feb4bbcf700caba82a45cc45f2"));
+                Arrays.asList("d0593483e85a7d815f4c5ee6db284d2a"));
         executeTest("test MultiSample Pilot2 with alleles passed in and emitting all sites", spec2);
     }
 

From e484625594321a4607449f9e51e88047e4b46076 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 22 Nov 2011 08:40:48 -0500
Subject: [PATCH 094/113] GenotypesContext now updates cached data for add,
 set, replace operations when possible

-- Involved separately managing the sample -> offset and sample sorted list operations.  This should improve performance throughout the system
---
 .../variantcontext/GenotypesContext.java      | 178 +++++++++++++-----
 .../variantcontext/LazyGenotypesContext.java  |  58 +++---
 .../variantcontext/VariantContextUtils.java   |   8 +-
 .../GenotypesContextUnitTest.java             |   7 +-
 4 files changed, 173 insertions(+), 78 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 8d28ba18c..248fdad9d 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -52,9 +52,6 @@ public class GenotypesContext implements List<Genotype> {
      */
     Map<String, Integer> sampleNameToOffset = null;
 
-    /** if true, then we need to reinitialize sampleNamesInOrder and sampleNameToOffset before we use them /*/
-    boolean cacheIsInvalid = true;
-
     /**
      * An ArrayList of genotypes contained in this context
      *
@@ -95,7 +92,6 @@ public class GenotypesContext implements List<Genotype> {
     protected GenotypesContext(final ArrayList<Genotype> genotypes) {
         this.notToBeDirectlyAccessedGenotypes = genotypes;
         this.sampleNameToOffset = null;
-        this.cacheIsInvalid = true;
     }
 
     /**
@@ -120,7 +116,6 @@ public class GenotypesContext implements List<Genotype> {
         this.notToBeDirectlyAccessedGenotypes = genotypes;
         this.sampleNameToOffset = sampleNameToOffset;
         this.sampleNamesInOrder = sampleNamesInOrder;
-        this.cacheIsInvalid = false;
     }
 
     // ---------------------------------------------------------------------------
@@ -246,33 +241,46 @@ public class GenotypesContext implements List<Genotype> {
     //
     // ---------------------------------------------------------------------------
 
-    @Ensures({"cacheIsInvalid == true"})
-    protected void invalidateCaches() {
-        cacheIsInvalid = true;
-        sampleNamesInOrder = null;
+    @Ensures({"sampleNameToOffset == null"})
+    protected void invalidateSampleNameMap() {
         sampleNameToOffset = null;
     }
 
-    @Ensures({"cacheIsInvalid == false",
-            "sampleNamesInOrder != null",
-            "sampleNameToOffset != null",
-            "sameSamples(notToBeDirectlyAccessedGenotypes, sampleNamesInOrder)",
-            "sameSamples(notToBeDirectlyAccessedGenotypes, sampleNameToOffset.keySet())"})
-    protected void buildCache() {
-        if ( cacheIsInvalid ) {
-            cacheIsInvalid = false;
+    @Ensures({"sampleNamesInOrder == null"})
+    protected void invalidateSampleOrdering() {
+        sampleNamesInOrder = null;
+    }
+
+    @Ensures({"sampleNamesInOrder != null",
+            "sameSamples(notToBeDirectlyAccessedGenotypes, sampleNamesInOrder)"})
+    protected void ensureSampleOrdering() {
+        if ( sampleNamesInOrder == null ) {
             sampleNamesInOrder = new ArrayList<String>(size());
-            sampleNameToOffset = new HashMap<String, Integer>(size());
 
             for ( int i = 0; i < size(); i++ ) {
-                final Genotype g = getGenotypes().get(i);
-                sampleNamesInOrder.add(g.getSampleName());
-                sampleNameToOffset.put(g.getSampleName(), i);
+                sampleNamesInOrder.add(getGenotypes().get(i).getSampleName());
             }
             Collections.sort(sampleNamesInOrder);
         }
     }
 
+    @Ensures({"sampleNameToOffset != null",
+            "sameSamples(notToBeDirectlyAccessedGenotypes, sampleNameToOffset.keySet())"})
+    protected void ensureSampleNameMap() {
+        if ( sampleNameToOffset == null ) {
+            sampleNameToOffset = new HashMap<String, Integer>(size());
+
+            for ( int i = 0; i < size(); i++ ) {
+                sampleNameToOffset.put(getGenotypes().get(i).getSampleName(), i);
+            }
+        }
+    }
+
+    // for testing purposes
+    protected void ensureAll() {
+        ensureSampleNameMap();
+        ensureSampleOrdering();
+    }
 
     // ---------------------------------------------------------------------------
     //
@@ -287,7 +295,8 @@ public class GenotypesContext implements List<Genotype> {
     @Override
     public void clear() {
         checkImmutability();
-        invalidateCaches();
+        invalidateSampleNameMap();
+        invalidateSampleOrdering();
         getGenotypes().clear();
     }
 
@@ -301,21 +310,43 @@ public class GenotypesContext implements List<Genotype> {
         return getGenotypes().isEmpty();
     }
 
+    /**
+     * Adds a single genotype to this context.
+     *
+     * There are many constraints on this input, and important
+     * impacts on the performance of other functions provided by this
+     * context.
+     *
+     * First, the sample name of genotype must be unique within this
+     * context.  However, this is not enforced in the code itself, through
+     * you will invalid the contract on this context if you add duplicate
+     * samples and are running with CoFoJa enabled.
+     *
+     * Second, adding genotype also updates the sample name -> index map,
+     * so add() followed by containsSample and related function is an efficient
+     * series of operations.
+     *
+     * Third, adding the genotype invalidates the sorted list of sample names, to
+     * add() followed by any of the SampleNamesInOrder operations is inefficient, as
+     * each SampleNamesInOrder must rebuild the sorted list of sample names at
+     * an O(n log n) cost.
+     *
+     * @param genotype
+     * @return
+     */
     @Override
     @Requires({"genotype != null", "get(genotype.getSampleName()) == null"})
     @Ensures("noDups(getGenotypes())")
     public boolean add(final Genotype genotype) {
         checkImmutability();
-        invalidateCaches();
-        return getGenotypes().add(genotype);
-    }
+        invalidateSampleOrdering();
 
-    @Requires({"genotype != null", "! containsAny(Arrays.asList(genotype))"})
-    @Ensures("noDups(getGenotypes())")
-    public boolean add(final Genotype ... genotype) {
-        checkImmutability();
-        invalidateCaches();
-        return getGenotypes().addAll(Arrays.asList(genotype));
+        if ( sampleNameToOffset != null ) {
+            // update the name map by adding entries
+            sampleNameToOffset.put(genotype.getSampleName(), size());
+        }
+
+        return getGenotypes().add(genotype);
     }
 
     @Override
@@ -325,12 +356,30 @@ public class GenotypesContext implements List<Genotype> {
         throw new UnsupportedOperationException();
     }
 
+    /**
+     * Adds all of the genotypes to this context
+     *
+     * See {@link #add(Genotype)} for important information about this functions
+     * constraints and performance costs
+     *
+     * @param genotypes
+     * @return
+     */
     @Override
     @Requires("! containsAny(genotypes)")
     @Ensures("noDups(getGenotypes())")
     public boolean addAll(final Collection<? extends Genotype> genotypes) {
         checkImmutability();
-        invalidateCaches();
+        invalidateSampleOrdering();
+
+        if ( sampleNameToOffset != null ) {
+            // update the name map by adding entries
+            int pos = size();
+            for ( final Genotype g : genotypes ) {
+                sampleNameToOffset.put(g.getSampleName(), pos++);
+            }
+        }
+
         return getGenotypes().addAll(genotypes);
     }
 
@@ -362,13 +411,12 @@ public class GenotypesContext implements List<Genotype> {
     }
 
     public Genotype get(final String sampleName) {
-        buildCache();
         Integer offset = getSampleI(sampleName);
         return offset == null ? null : getGenotypes().get(offset);
     }
 
     private Integer getSampleI(final String sampleName) {
-        buildCache();
+        ensureSampleNameMap();
         return sampleNameToOffset.get(sampleName);
     }
 
@@ -401,31 +449,58 @@ public class GenotypesContext implements List<Genotype> {
 //        return genotypes.listIterator(i);
     }
 
+    /**
+     * Note that remove requires us to invalidate our sample -> index
+     * cache.  The loop:
+     *
+     * GenotypesContext gc = ...
+     * for ( sample in samples )
+     *   if ( gc.containsSample(sample) )
+     *     gc.remove(sample)
+     *
+     * is extremely inefficient, as each call to remove invalidates the cache
+     * and containsSample requires us to rebuild it, an O(n) operation.
+     *
+     * If you must remove many samples from the GC, use either removeAll or retainAll
+     * to avoid this O(n * m) operation.
+     *
+     * @param i
+     * @return
+     */
     @Override
     public Genotype remove(final int i) {
         checkImmutability();
-        invalidateCaches();
+        invalidateSampleNameMap();
+        invalidateSampleOrdering();
         return getGenotypes().remove(i);
     }
 
+    /**
+     * See for important warning {@link this.remove(Integer)}
+     * @param o
+     * @return
+     */
     @Override
     public boolean remove(final Object o) {
         checkImmutability();
-        invalidateCaches();
+        invalidateSampleNameMap();
+        invalidateSampleOrdering();
         return getGenotypes().remove(o);
     }
 
     @Override
     public boolean removeAll(final Collection<?> objects) {
         checkImmutability();
-        invalidateCaches();
+        invalidateSampleNameMap();
+        invalidateSampleOrdering();
         return getGenotypes().removeAll(objects);
     }
 
     @Override
     public boolean retainAll(final Collection<?> objects) {
         checkImmutability();
-        invalidateCaches();
+        invalidateSampleNameMap();
+        invalidateSampleOrdering();
         return getGenotypes().retainAll(objects);
     }
 
@@ -433,14 +508,28 @@ public class GenotypesContext implements List<Genotype> {
     @Ensures("noDups(getGenotypes())")
     public Genotype set(final int i, final Genotype genotype) {
         checkImmutability();
-        invalidateCaches();
-        return getGenotypes().set(i, genotype);
+        final Genotype prev = getGenotypes().set(i, genotype);
+
+        invalidateSampleOrdering();
+        if ( sampleNameToOffset != null ) {
+            // update the name map by removing the old entry and replacing it with the new one
+            sampleNameToOffset.remove(prev.getSampleName());
+            sampleNameToOffset.put(genotype.getSampleName(), i);
+        }
+
+        return prev;
     }
 
     /**
      * Replaces the genotype in this context -- note for efficiency
      * reasons we do not add the genotype if it's not present.  The
      * return value will be null indicating this happened.
+     *
+     * Note this operation is preserves the map cache Sample -> Offset but
+     * invalidates the sorted list of samples.  Using replace within a loop
+     * containing any of the SampleNameInOrder operation requires an O(n log n)
+     * resorting after each replace operation.
+     *
      * @param genotype a non null genotype to bind in this context
      * @return null if genotype was not added, otherwise returns the previous genotype
      */
@@ -451,7 +540,7 @@ public class GenotypesContext implements List<Genotype> {
         if ( offset == null )
             return null;
         else
-            return getGenotypes().set(offset, genotype);
+            return set(offset, genotype);
     }
 
     @Override
@@ -523,7 +612,7 @@ public class GenotypesContext implements List<Genotype> {
      */
     @Ensures("result != null")
     public Set<String> getSampleNames() {
-        buildCache();
+        ensureSampleNameMap();
         return sampleNameToOffset.keySet();
     }
 
@@ -532,19 +621,18 @@ public class GenotypesContext implements List<Genotype> {
      */
     @Ensures("result != null")
     public List<String> getSampleNamesOrderedByName() {
-        buildCache();
+        ensureSampleOrdering();
         return sampleNamesInOrder;
     }
 
     @Requires("sample != null")
     public boolean containsSample(final String sample) {
-        buildCache();
+        ensureSampleNameMap();
         return sampleNameToOffset.containsKey(sample);
     }
 
     @Requires("samples != null")
     public boolean containsSamples(final Collection<String> samples) {
-        buildCache();
         return getSampleNames().containsAll(samples);
     }
 
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
index 574bdc3d0..ce0422352 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/LazyGenotypesContext.java
@@ -81,8 +81,8 @@ public class LazyGenotypesContext extends GenotypesContext {
         final List<String> sampleNamesInOrder;
 
         @Requires({"genotypes != null", "sampleNamesInOrder != null", "sampleNameToOffset != null",
-            "sameSamples(genotypes, sampleNamesInOrder)",
-            "sameSamples(genotypes, sampleNameToOffset.keySet())"})
+                "sameSamples(genotypes, sampleNamesInOrder)",
+                "sameSamples(genotypes, sampleNameToOffset.keySet())"})
         public LazyData(final ArrayList<Genotype> genotypes,
                         final List<String> sampleNamesInOrder,
                         final Map<String, Integer> sampleNameToOffset) {
@@ -119,13 +119,20 @@ public class LazyGenotypesContext extends GenotypesContext {
     @Override
     @Ensures("result != null")
     protected ArrayList<Genotype> getGenotypes() {
+        decode();
+        return notToBeDirectlyAccessedGenotypes;
+    }
+
+    /**
+     * Force us to decode the genotypes, if not already done
+     */
+    public void decode() {
         if ( ! loaded ) {
             //System.out.printf("Loading genotypes... %s:%d%n", contig, start);
             LazyData parsed = parser.parse(unparsedGenotypeData);
             notToBeDirectlyAccessedGenotypes = parsed.genotypes;
             sampleNamesInOrder = parsed.sampleNamesInOrder;
             sampleNameToOffset = parsed.sampleNameToOffset;
-            cacheIsInvalid = false;      // these values build the cache
             loaded = true;
             unparsedGenotypeData = null; // don't hold the unparsed data any longer
 
@@ -133,31 +140,43 @@ public class LazyGenotypesContext extends GenotypesContext {
             // That said, it's not such an important routine -- it's just checking that the genotypes
             // are well formed w.r.t. the alleles list, but this will be enforced within the VCFCodec
         }
-
-        return notToBeDirectlyAccessedGenotypes;
     }
 
     /**
-     * Overrides the buildCache functionality.  If the data hasn't been loaded
+     * Overrides the ensure* functionality.  If the data hasn't been loaded
      * yet and we want to build the cache, just decode it and we're done.  If we've
      * already decoded the data, though, go through the super class
      */
     @Override
-    protected synchronized void buildCache() {
-        if ( cacheIsInvalid ) {
-            if ( ! loaded ) {
-                getGenotypes(); // will load up all of the necessary data
-            } else {
-                super.buildCache();
-            }
+    protected synchronized void ensureSampleNameMap() {
+        if ( ! loaded ) {
+            decode(); // will load up all of the necessary data
+        } else {
+            super.ensureSampleNameMap();
         }
     }
 
     @Override
-    protected void invalidateCaches() {
+    protected synchronized void ensureSampleOrdering() {
+        if ( ! loaded ) {
+            decode(); // will load up all of the necessary data
+        } else {
+            super.ensureSampleOrdering();
+        }
+    }
+
+    @Override
+    protected void invalidateSampleNameMap() {
         // if the cache is invalidated, and we haven't loaded our data yet, do so
-        if ( ! loaded ) getGenotypes();
-        super.invalidateCaches();
+        if ( ! loaded ) decode();
+        super.invalidateSampleNameMap();
+    }
+
+    @Override
+    protected void invalidateSampleOrdering() {
+        // if the cache is invalidated, and we haven't loaded our data yet, do so
+        if ( ! loaded ) decode();
+        super.invalidateSampleOrdering();
     }
 
     @Override
@@ -177,11 +196,4 @@ public class LazyGenotypesContext extends GenotypesContext {
     public Object getUnparsedGenotypeData() {
         return unparsedGenotypeData;
     }
-
-    /**
-     * Force us to decode the genotypes
-     */
-    public void decode() {
-        buildCache();
-    }
 }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 21a371e2f..05e768ea7 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -532,7 +532,6 @@ public class VariantContextUtils {
         final Map<String, Object> attributesWithMaxAC = new TreeMap<String, Object>();
         double log10PError = 1;
         VariantContext vcWithMaxAC = null;
-        Set<String> addedSamples = new HashSet<String>(first.getNSamples());
         GenotypesContext genotypes = GenotypesContext.create();
 
         // counting the number of filtered and variant VCs
@@ -557,7 +556,7 @@ public class VariantContextUtils {
 
             alleles.addAll(alleleMapping.values());
 
-            mergeGenotypes(genotypes, addedSamples, vc, alleleMapping, genotypeMergeOptions == GenotypeMergeType.UNIQUIFY);
+            mergeGenotypes(genotypes, vc, alleleMapping, genotypeMergeOptions == GenotypeMergeType.UNIQUIFY);
 
             log10PError = Math.min(log10PError, vc.isVariant() ? vc.getLog10PError() : 1);
 
@@ -963,10 +962,10 @@ public class VariantContextUtils {
         }
     }
 
-    private static void mergeGenotypes(GenotypesContext mergedGenotypes, Set<String> addedSamples, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
+    private static void mergeGenotypes(GenotypesContext mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
         for ( Genotype g : oneVC.getGenotypes() ) {
             String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
-            if ( ! addedSamples.contains(name) ) {
+            if ( mergedGenotypes.containsSample(name) ) {
                 // only add if the name is new
                 Genotype newG = g;
 
@@ -976,7 +975,6 @@ public class VariantContextUtils {
                 }
 
                 mergedGenotypes.add(newG);
-                addedSamples.add(name);
             }
         }
     }
diff --git a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
index afb9336a0..ee0a5dfe0 100644
--- a/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/utils/variantcontext/GenotypesContextUnitTest.java
@@ -88,7 +88,8 @@ public class GenotypesContextUnitTest extends BaseTest {
         @Override
         public LazyGenotypesContext.LazyData parse(final Object data) {
             GenotypesContext gc = GenotypesContext.copy((List<Genotype>)data);
-            gc.buildCache();
+            gc.ensureSampleNameMap();
+            gc.ensureSampleOrdering();
             return new LazyGenotypesContext.LazyData(gc.notToBeDirectlyAccessedGenotypes, gc.sampleNamesInOrder, gc.sampleNameToOffset);
         }
 
@@ -234,10 +235,6 @@ public class GenotypesContextUnitTest extends BaseTest {
         gc.add(add2);
         testGenotypesContextContainsExpectedSamples(gc, with(cfg.initialSamples, add1, add2));
 
-        gc = cfg.makeContext();
-        gc.add(add1, add2);
-        testGenotypesContextContainsExpectedSamples(gc, with(cfg.initialSamples, add1, add2));
-
         gc = cfg.makeContext();
         gc.addAll(Arrays.asList(add1, add2));
         testGenotypesContextContainsExpectedSamples(gc, with(cfg.initialSamples, add1, add2));

From 708731037390f175e53951ddb97cf2897e89fa25 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 22 Nov 2011 10:16:36 -0500
Subject: [PATCH 095/113] Embarassing bug fixed

---
 .../sting/utils/variantcontext/VariantContextUtils.java         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 05e768ea7..0d3f7fae7 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -965,7 +965,7 @@ public class VariantContextUtils {
     private static void mergeGenotypes(GenotypesContext mergedGenotypes, VariantContext oneVC, AlleleMapper alleleMapping, boolean uniqifySamples) {
         for ( Genotype g : oneVC.getGenotypes() ) {
             String name = mergedSampleName(oneVC.getSource(), g.getSampleName(), uniqifySamples);
-            if ( mergedGenotypes.containsSample(name) ) {
+            if ( ! mergedGenotypes.containsSample(name) ) {
                 // only add if the name is new
                 Genotype newG = g;
 

From 5821c11fad7b198a929c80fe4d60cb437a0eceb4 Mon Sep 17 00:00:00 2001
From: Eric Banks <ebanks@broadinstitute.org>
Date: Tue, 22 Nov 2011 10:50:22 -0500
Subject: [PATCH 097/113] For BAM and Reviewed errors we now check the error
 message to see if it's actually a 'too many open files' problem and, if so,
 we generate a User Error instead.

---
 .../sting/commandline/CommandLineProgram.java          |  2 +-
 .../org/broadinstitute/sting/gatk/CommandLineGATK.java | 10 ++++++++--
 .../sting/utils/exceptions/UserException.java          |  6 ++++++
 3 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/commandline/CommandLineProgram.java b/public/java/src/org/broadinstitute/sting/commandline/CommandLineProgram.java
index b0b57f7fc..9e1be5bca 100644
--- a/public/java/src/org/broadinstitute/sting/commandline/CommandLineProgram.java
+++ b/public/java/src/org/broadinstitute/sting/commandline/CommandLineProgram.java
@@ -392,7 +392,7 @@ public abstract class CommandLineProgram {
     /**
      * used to indicate an error occured
      *
-     * @param e the exception occured
+     * @param t the exception that occurred
      */
     public static void exitSystemWithError(Throwable t) {
         exitSystemWithError(t.getMessage(), t);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java b/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
index d3db35c07..b8b961119 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
@@ -30,7 +30,6 @@ import org.broadinstitute.sting.commandline.Argument;
 import org.broadinstitute.sting.commandline.ArgumentCollection;
 import org.broadinstitute.sting.commandline.CommandLineProgram;
 import org.broadinstitute.sting.gatk.arguments.GATKArgumentCollection;
-import org.broadinstitute.sting.gatk.filters.ReadFilter;
 import org.broadinstitute.sting.gatk.refdata.tracks.FeatureManager;
 import org.broadinstitute.sting.gatk.walkers.Attribution;
 import org.broadinstitute.sting.gatk.walkers.Walker;
@@ -97,13 +96,20 @@ public class CommandLineGATK extends CommandLineExecutable {
             //   lazy loaded, so they aren't caught elsewhere and made into User Exceptions
             exitSystemWithUserError(e);
         } catch (net.sf.samtools.SAMException e) {
-            // Let's try this out and see how it is received by our users
+            checkForTooManyOpenFilesProblem(e.getMessage());
             exitSystemWithSamError(e);
         } catch (Throwable t) {
+            checkForTooManyOpenFilesProblem(t.getMessage());
             exitSystemWithError(t);
         }
     }
 
+    private static void checkForTooManyOpenFilesProblem(String message) {
+        // Special case the "Too many open files" error because it's a common User Error for which we know what to do
+        if ( message.indexOf("Too many open files") != -1 )
+            exitSystemWithUserError(new UserException.TooManyOpenFiles());
+    }
+
     /**
      * Creates the a short blurb about the GATK, copyright info, and where to get documentation.
      *
diff --git a/public/java/src/org/broadinstitute/sting/utils/exceptions/UserException.java b/public/java/src/org/broadinstitute/sting/utils/exceptions/UserException.java
index a208d2dc0..c599d4759 100755
--- a/public/java/src/org/broadinstitute/sting/utils/exceptions/UserException.java
+++ b/public/java/src/org/broadinstitute/sting/utils/exceptions/UserException.java
@@ -100,6 +100,12 @@ public class UserException extends ReviewedStingException {
         }
     }
 
+    public static class TooManyOpenFiles extends UserException {
+        public TooManyOpenFiles() {
+            super(String.format("There was a failure because there are too many files open concurrently; your system's open file handle limit is too small.  See the unix ulimit command to adjust this limit"));
+        }
+    }
+
     public static class ErrorWritingBamFile extends UserException {
         public ErrorWritingBamFile(String message) {
             super(String.format("An error occurred when trying to write the BAM file.  Usually this happens when there is not enough space in the directory to which the data is being written (generally the temp directory) or when your system's open file handle limit is too small.  To tell Java to use a bigger/better file system use -Djava.io.tmpdir=X on the command line.  The exact error was %s", message));

From 32a77a8a5604eeda7a23a9350040a615b6755d72 Mon Sep 17 00:00:00 2001
From: Guillermo del Angel <delangel@broadinstitute.org>
Date: Tue, 22 Nov 2011 13:57:24 -0500
Subject: [PATCH 098/113] Prevent out of bound error in case read span >
 reference context + indel length. Can happen in RNAseq reads with long N
 CIGAR operators in the middle.

---
 .../indels/PairHMMIndelErrorModel.java        | 69 ++++++++++---------
 1 file changed, 38 insertions(+), 31 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
index 319f41d53..abd933ada 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
@@ -555,41 +555,48 @@ public class PairHMMIndelErrorModel {
                         // cut haplotype bases
                         long indStart = start - haplotype.getStartPosition();
                         long indStop =  stop - haplotype.getStartPosition();
-
-                        final byte[] haplotypeBases = Arrays.copyOfRange(haplotype.getBasesAsBytes(),
-                                (int)indStart, (int)indStop);
-
                         double readLikelihood;
-                        if (matchMetricArray == null) {
-                            final int X_METRIC_LENGTH = readBases.length+1;
-                            final int Y_METRIC_LENGTH = haplotypeBases.length+1;
 
-                            matchMetricArray = new double[X_METRIC_LENGTH][Y_METRIC_LENGTH];
-                            XMetricArray = new double[X_METRIC_LENGTH][Y_METRIC_LENGTH];
-                            YMetricArray = new double[X_METRIC_LENGTH][Y_METRIC_LENGTH];
-                        }
-                        final double[] currentContextGOP = Arrays.copyOfRange(gapOpenProbabilityMap.get(a), (int)indStart, (int)indStop);
-                        final double[] currentContextGCP = Arrays.copyOfRange(gapContProbabilityMap.get(a), (int)indStart, (int)indStop);
-                        if (previousHaplotypeSeen == null)
-                            startIdx = 0;
-                        else {
-                            final int s1 = computeFirstDifferingPosition(haplotypeBases, previousHaplotypeSeen);
-                            final int s2 = computeFirstDifferingPosition(currentContextGOP, previousGOP);
-                            final int s3 = computeFirstDifferingPosition(currentContextGCP, previousGCP);
-                            startIdx = Math.min(Math.min(s1, s2), s3);
-                        }
-                        previousHaplotypeSeen = haplotypeBases.clone();
-                        previousGOP = currentContextGOP.clone();
-                        previousGCP = currentContextGCP.clone();
+                        if (indStart < 0 || indStop >= haplotype.getBasesAsBytes().length) {
+                            // read spanned more than allowed reference context: we currently can't deal with this
+                            readLikelihood =0;
+                        } else
+                        {
+                            final byte[] haplotypeBases = Arrays.copyOfRange(haplotype.getBasesAsBytes(),
+                                    (int)indStart, (int)indStop);
+
+                            if (matchMetricArray == null) {
+                                final int X_METRIC_LENGTH = readBases.length+1;
+                                final int Y_METRIC_LENGTH = haplotypeBases.length+1;
+
+                                matchMetricArray = new double[X_METRIC_LENGTH][Y_METRIC_LENGTH];
+                                XMetricArray = new double[X_METRIC_LENGTH][Y_METRIC_LENGTH];
+                                YMetricArray = new double[X_METRIC_LENGTH][Y_METRIC_LENGTH];
+                            }
+                            final double[] currentContextGOP = Arrays.copyOfRange(gapOpenProbabilityMap.get(a), (int)indStart, (int)indStop);
+                            final double[] currentContextGCP = Arrays.copyOfRange(gapContProbabilityMap.get(a), (int)indStart, (int)indStop);
+                            if (previousHaplotypeSeen == null)
+                                startIdx = 0;
+                            else {
+                                final int s1 = computeFirstDifferingPosition(haplotypeBases, previousHaplotypeSeen);
+                                final int s2 = computeFirstDifferingPosition(currentContextGOP, previousGOP);
+                                final int s3 = computeFirstDifferingPosition(currentContextGCP, previousGCP);
+                                startIdx = Math.min(Math.min(s1, s2), s3);
+                            }
+                            previousHaplotypeSeen = haplotypeBases.clone();
+                            previousGOP = currentContextGOP.clone();
+                            previousGCP = currentContextGCP.clone();
 
 
-                        readLikelihood = computeReadLikelihoodGivenHaplotypeAffineGaps(haplotypeBases, readBases, readQuals,
-                                currentContextGOP, currentContextGCP, startIdx, matchMetricArray, XMetricArray, YMetricArray);
-                        if (DEBUG) {
-                            System.out.println("H:"+new String(haplotypeBases));
-                            System.out.println("R:"+new String(readBases));
-                            System.out.format("L:%4.2f\n",readLikelihood);
-                            System.out.format("StPos:%d\n", startIdx);
+                            readLikelihood = computeReadLikelihoodGivenHaplotypeAffineGaps(haplotypeBases, readBases, readQuals,
+                                    currentContextGOP, currentContextGCP, startIdx, matchMetricArray, XMetricArray, YMetricArray);
+
+                            if (DEBUG) {
+                                System.out.println("H:"+new String(haplotypeBases));
+                                System.out.println("R:"+new String(readBases));
+                                System.out.format("L:%4.2f\n",readLikelihood);
+                                System.out.format("StPos:%d\n", startIdx);
+                            }
                         }
                         readEl.put(a,readLikelihood);
                         readLikelihoods[readIdx][j++] = readLikelihood;

From a3aef8fa53c0c66b20023e4f448a6c3c18911eaa Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Tue, 22 Nov 2011 17:19:30 -0500
Subject: [PATCH 102/113] Final performance optimization for GenotypesContext

---
 .../varianteval/util/VariantEvalUtils.java    |  2 +-
 .../variantcontext/GenotypesContext.java      | 28 ++++++-------------
 .../utils/variantcontext/VariantContext.java  |  8 ++++--
 .../variantcontext/VariantContextUtils.java   |  1 +
 4 files changed, 16 insertions(+), 23 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
index aa246b58d..b319407d1 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
@@ -267,7 +267,7 @@ public class VariantEvalUtils {
      * @return a new VariantContext with just the requested sample
      */
     public VariantContext getSubsetOfVariantContext(VariantContext vc, String sampleName) {
-        return getSubsetOfVariantContext(vc, new HashSet<String>(Arrays.asList(sampleName)));
+        return getSubsetOfVariantContext(vc, Collections.singleton(sampleName));
     }
 
     /**
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
index 248fdad9d..845c65c9c 100644
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/GenotypesContext.java
@@ -646,28 +646,18 @@ public class GenotypesContext implements List<Genotype> {
      */
     @Requires("samples != null")
     @Ensures("result != null")
-    public GenotypesContext subsetToSamples( final Collection<String> samples ) {
-        return subsetToSamples(new HashSet<String>(samples));
-    }
-
-    /**
-     * {@link #subsetToSamples(java.util.Collection)}
-     * @param samples
-     * @return
-     */
-    @Requires("samples != null")
-    @Ensures("result != null")
     public GenotypesContext subsetToSamples( final Set<String> samples ) {
-        if ( samples.size() == size() )
+        final int nSamples = samples.size();
+        final int nGenotypes = size();
+
+        if ( nSamples == nGenotypes )
             return this;
-        else if ( samples.isEmpty() )
+        else if ( nSamples == 0 )
             return NO_GENOTYPES;
-        else {
-            GenotypesContext subset = create(samples.size());
-            for ( final Genotype g : getGenotypes() ) {
-                if ( samples.contains(g.getSampleName()) ) {
-                    subset.add(g);
-                }
+        else { // nGenotypes < nSamples
+            final GenotypesContext subset = create(samples.size());
+            for ( final String sample : samples ) {
+                subset.add(get(sample));
             }
             return subset;
         }
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
index 331ca97d3..247e412dd 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContext.java
@@ -726,19 +726,21 @@ public class VariantContext implements Feature { // to enable tribble intergrati
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
     public GenotypesContext getGenotypes(String sampleName) {
-        return getGenotypes(Arrays.asList(sampleName));
+        return getGenotypes(Collections.singleton(sampleName));
     }
 
     /**
      * Returns a map from sampleName -> Genotype for each sampleName in sampleNames.  Returns a map
      * for consistency with the multi-get function.
      *
+     * For testing convenience only
+     *
      * @param sampleNames a unique list of sample names
      * @return
      * @throws IllegalArgumentException if sampleName isn't bound to a genotype
      */
-    public GenotypesContext getGenotypes(Collection<String> sampleNames) {
-        return getGenotypes().subsetToSamples(sampleNames);
+    protected GenotypesContext getGenotypes(Collection<String> sampleNames) {
+        return getGenotypes().subsetToSamples(new HashSet<String>(sampleNames));
     }
 
     public GenotypesContext getGenotypes(Set<String> sampleNames) {
diff --git a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
index 0d3f7fae7..91a018c4e 100755
--- a/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
+++ b/public/java/src/org/broadinstitute/sting/utils/variantcontext/VariantContextUtils.java
@@ -86,6 +86,7 @@ public class VariantContextUtils {
                 for ( Allele allele : vc.getAlternateAlleles() ) {
                     int altChromosomes = vc.getCalledChrCount(allele);
                     alleleCounts.add(altChromosomes);
+                    // todo -- this is a performance problem
                     String freq = String.format(makePrecisionFormatStringFromDenominatorValue(totalChromosomes), ((double)altChromosomes / totalChromosomes));
                     alleleFreqs.add(freq);
                 }

From 75d93e6335baedf2b33de0ba37978830791f3d10 Mon Sep 17 00:00:00 2001
From: Guillermo del Angel <delangel@broadinstitute.org>
Date: Tue, 22 Nov 2011 22:46:12 -0500
Subject: [PATCH 103/113] Another corner condition fix: skip likelihood
 computation in case we cut so many bases there's no haplotype or read left

---
 .../sting/gatk/walkers/indels/PairHMMIndelErrorModel.java    | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
index abd933ada..6b6a7a82e 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
@@ -556,8 +556,11 @@ public class PairHMMIndelErrorModel {
                         long indStart = start - haplotype.getStartPosition();
                         long indStop =  stop - haplotype.getStartPosition();
                         double readLikelihood;
+                        if (DEBUG)
+                            System.out.format("indStart: %d indStop: %d WinStart:%d WinStop:%d start: %d stop: %d readLength: %d C:%s\n",
+                                    indStart, indStop, ref.getWindow().getStart(), ref.getWindow().getStop(), start, stop, read.getReadLength(), read.getCigar().toString());
 
-                        if (indStart < 0 || indStop >= haplotype.getBasesAsBytes().length) {
+                        if (indStart < 0 || indStop >= haplotype.getBasesAsBytes().length || indStart > indStop) {
                             // read spanned more than allowed reference context: we currently can't deal with this
                             readLikelihood =0;
                         } else

From 32adbd614f9dc39b09fb3aa3fd9a2e910e3b4e24 Mon Sep 17 00:00:00 2001
From: Guillermo del Angel <delangel@broadinstitute.org>
Date: Tue, 22 Nov 2011 22:48:46 -0500
Subject: [PATCH 104/113] Solve merge conflict

---
 .../sting/gatk/walkers/indels/PairHMMIndelErrorModel.java       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
index 95633c222..09968f47e 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/indels/PairHMMIndelErrorModel.java
@@ -561,7 +561,7 @@ public class PairHMMIndelErrorModel {
                             System.out.format("indStart: %d indStop: %d WinStart:%d WinStop:%d start: %d stop: %d readLength: %d C:%s\n",
                                     indStart, indStop, ref.getWindow().getStart(), ref.getWindow().getStop(), start, stop, read.getReadLength(), read.getCigar().toString());
 
-                        if (indStart < 0 || indStop >= haplotype.getBasesAsBytes().length || indStart > indStop) {
+                        if (indStart < 0 || indStop >= haplotype.getBases().length || indStart > indStop) {
                             // read spanned more than allowed reference context: we currently can't deal with this
                             readLikelihood =0;
                         } else

From 6c2555885c271bf8a1c4ff97da5db3c18fecb242 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 23 Nov 2011 08:34:05 -0500
Subject: [PATCH 105/113] Caching getSimpleName() in VariantEval is a big
 performance improvement

-- Removed the SimpleMetricsByAC table, as one should just use the AlleleCount Stratefication and the upcoming VariantSummary table
---
 .../varianteval/VariantEvalWalker.java        |  17 +-
 .../evaluators/SimpleMetricsByAC.java         | 194 ------------------
 .../stratifications/VariantStratifier.java    |  15 +-
 .../util/NewEvaluationContext.java            |   2 +-
 .../walkers/varianteval/util/StateKey.java    |  23 +--
 .../varianteval/util/VariantEvalUtils.java    |   6 +-
 6 files changed, 34 insertions(+), 223 deletions(-)
 delete mode 100755 public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/SimpleMetricsByAC.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
index 0cc271b59..558d9c6bf 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
@@ -265,9 +265,9 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
         stratificationObjects = variantEvalUtils.initializeStratificationObjects(this, NO_STANDARD_STRATIFICATIONS, STRATIFICATIONS_TO_USE);
         Set<Class<? extends VariantEvaluator>> evaluationObjects = variantEvalUtils.initializeEvaluationObjects(NO_STANDARD_MODULES, MODULES_TO_USE);
         for ( VariantStratifier vs : getStratificationObjects() ) {
-            if ( vs.getClass().getSimpleName().equals("Filter") )
+            if ( vs.getName().equals("Filter") )
                 byFilterIsEnabled = true;
-            else if ( vs.getClass().getSimpleName().equals("Sample") )
+            else if ( vs.getName().equals("Sample") )
                 perSampleIsEnabled = true;
         }
 
@@ -458,9 +458,7 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
                                 table.addColumn(subTableName, subTableName);
 
                                 for ( VariantStratifier vs : stratificationObjects ) {
-                                    String columnName = vs.getClass().getSimpleName();
-
-                                    table.addColumn(columnName, "unknown");
+                                    table.addColumn(vs.getName(), "unknown");
                                 }
 
                                 table.addColumn("row", "unknown");
@@ -484,9 +482,8 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
                                 String r = (String) t.getRowKeys()[row];
 
                                 for ( VariantStratifier vs : stratificationObjects ) {
-                                    String columnName = vs.getClass().getSimpleName();
-
-                                    table.set(stateKey.toString() + r, columnName, stateKey.get(vs.getClass().getSimpleName()));
+                                    final String columnName = vs.getName();
+                                    table.set(stateKey.toString() + r, columnName, stateKey.get(columnName));
                                 }
 
                                 for (int col = 0; col < t.getColumnKeys().length; col++) {
@@ -507,9 +504,9 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
                             GATKReportTable table = report.getTable(ve.getClass().getSimpleName());
 
                             for ( VariantStratifier vs : stratificationObjects ) {
-                                String columnName = vs.getClass().getSimpleName();
+                                String columnName = vs.getName();
 
-                                table.set(stateKey.toString(), columnName, stateKey.get(vs.getClass().getSimpleName()));
+                                table.set(stateKey.toString(), columnName, stateKey.get(vs.getName()));
                             }
 
                             table.set(stateKey.toString(), field.getName(), field.get(ve));
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/SimpleMetricsByAC.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/SimpleMetricsByAC.java
deleted file mode 100755
index 27e8e7c86..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/SimpleMetricsByAC.java
+++ /dev/null
@@ -1,194 +0,0 @@
-package org.broadinstitute.sting.gatk.walkers.varianteval.evaluators;
-
-import org.broadinstitute.sting.gatk.contexts.AlignmentContext;
-import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
-import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
-import org.broadinstitute.sting.gatk.walkers.varianteval.VariantEvalWalker;
-import org.broadinstitute.sting.gatk.walkers.varianteval.stratifications.Degeneracy;
-import org.broadinstitute.sting.gatk.walkers.varianteval.stratifications.Sample;
-import org.broadinstitute.sting.gatk.walkers.varianteval.util.Analysis;
-import org.broadinstitute.sting.gatk.walkers.varianteval.util.DataPoint;
-import org.broadinstitute.sting.gatk.walkers.varianteval.util.StateKey;
-import org.broadinstitute.sting.gatk.walkers.varianteval.util.TableType;
-import org.broadinstitute.sting.utils.exceptions.ReviewedStingException;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
-
-import java.util.ArrayList;
-
-/*
- * Copyright (c) 2010 The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-/**
- * @author depristo
- * @since Apr 11, 2010
- */
-
-@Analysis(name = "Quality Metrics by allele count", description = "Shows various stats binned by allele count")
-public class SimpleMetricsByAC extends VariantEvaluator implements StandardEval {
-    // a mapping from quality score histogram bin to Ti/Tv ratio
-    @DataPoint(description = "TiTv by allele count")
-    MetricsByAc metrics = null;
-
-    private final static Object[] METRIC_COLUMNS = {"AC", "nTi", "nTv", "n", "TiTv"};
-    private int numSamples;
-
-    class MetricsAtAC {
-        public int ac = -1, nTi = 0, nTv = 0;
-
-        public MetricsAtAC(int ac) { this.ac = ac; }
-
-        public void update(VariantContext eval) {
-            if ( VariantContextUtils.isTransition(eval) )
-                nTi++;
-            else
-                nTv++;
-        }
-
-        // corresponding to METRIC_COLUMNS
-        public String getColumn(int i) {
-            switch (i) {
-                case 0: return String.valueOf(ac);
-                case 1: return String.valueOf(nTi);
-                case 2: return String.valueOf(nTv);
-                case 3: return String.valueOf(nTi + nTv);
-                case 4: return String.valueOf(ratio(nTi, nTv));
-                default:
-                    throw new ReviewedStingException("Unexpected column " + i);
-            }
-        }
-    }
-
-    class MetricsByAc implements TableType {
-        ArrayList<MetricsAtAC> metrics = new ArrayList<MetricsAtAC>();
-        Object[] rows = null;
-
-        public MetricsByAc( int nchromosomes ) {
-            rows = new Object[nchromosomes+1];
-            metrics = new ArrayList<MetricsAtAC>(nchromosomes+1);
-            for ( int i = 0; i < nchromosomes + 1; i++ ) {
-                metrics.add(new MetricsAtAC(i));
-                rows[i] = "ac" + i;
-            }
-        }
-
-        public Object[] getRowKeys() {
-            return rows;
-        }
-
-        public Object[] getColumnKeys() {
-            return METRIC_COLUMNS;
-        }
-
-        public String getName() {
-            return "MetricsByAc";
-        }
-
-        public String getCell(int ac, int y) {
-            return metrics.get(ac).getColumn(y);
-        }
-
-        public String toString() {
-            return "";
-        }
-
-        public void incrValue( VariantContext eval ) {
-            int ac = -1;
-            
-            if ( eval.hasGenotypes() )
-                ac = eval.getCalledChrCount(eval.getAlternateAllele(0));
-            else if ( eval.hasAttribute("AC") ) {
-                ac = eval.getAttributeAsInt("AC", -1);
-            }
-
-            if ( ac != -1 ) {
-                metrics.get(ac).update(eval);
-            }
-        }
-    }
-
-    public void initialize(VariantEvalWalker walker) {
-        numSamples = walker.getNumSamples();
-        metrics = new MetricsByAc(2*numSamples);
-    }
-
-    public String getName() {
-        return "SimpleMetricsByAC";
-    }
-
-    public int getComparisonOrder() {
-        return 1;   // we only need to see each eval track
-    }
-
-    public boolean enabled() {
-        return true;
-    }
-
-    public String toString() {
-        return getName();
-    }
-
-    public String update1(VariantContext eval, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        if (numSamples == 0) {
-            return null;
-        }
-
-        final String interesting = null;
-
-        if (eval != null) {
-            if ( metrics == null ) {
-                int nSamples = numSamples;
-
-                if ( nSamples != -1 ) {
-                    metrics = new MetricsByAc(2 * nSamples);
-                }
-            }
-
-            if ( eval.isSNP() && eval.isBiallelic() && eval.isPolymorphicInSamples() && metrics != null ) {
-                metrics.incrValue(eval);
-            }
-        }
-
-        return interesting; // This module doesn't capture any interesting sites, so return null
-    }
-
-    @Override
-    public boolean stateIsApplicable(StateKey stateKey) {
-        String sampleClassName = Sample.class.getSimpleName();
-        String degeneracyClassName = Degeneracy.class.getSimpleName();
-
-        //return !(stateKey.containsKey(sampleClassName) && !stateKey.get(sampleClassName).equalsIgnoreCase("all"));
-
-        if (stateKey.containsKey(sampleClassName) && !stateKey.get(sampleClassName).equalsIgnoreCase("all")) {
-            return false;
-        }
-
-        if (stateKey.containsKey(degeneracyClassName) && !stateKey.get(degeneracyClassName).equalsIgnoreCase("all")) {
-            return false;
-        }
-
-        return true;
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/VariantStratifier.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/VariantStratifier.java
index 5cae2fb15..119a1b83f 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/VariantStratifier.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/stratifications/VariantStratifier.java
@@ -9,10 +9,15 @@ import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
 
-public abstract class VariantStratifier implements Comparable {
+public abstract class VariantStratifier implements Comparable<VariantStratifier> {
     private VariantEvalWalker variantEvalWalker;
+    final private String name;
     protected ArrayList<String> states = new ArrayList<String>();
 
+    protected VariantStratifier() {
+        name = this.getClass().getSimpleName();
+    }
+
     /**
      * @return a reference to the parent VariantEvalWalker running this stratification
      */
@@ -34,8 +39,12 @@ public abstract class VariantStratifier implements Comparable {
         return null;
     }
 
-    public int compareTo(Object o1) {
-        return this.getClass().getSimpleName().compareTo(o1.getClass().getSimpleName());
+    public int compareTo(VariantStratifier o1) {
+        return this.getName().compareTo(o1.getName());
+    }
+
+    public final String getName() {
+        return name;
     }
 
     public ArrayList<String> getAllStates() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/NewEvaluationContext.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/NewEvaluationContext.java
index 8112ae97f..c34e44516 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/NewEvaluationContext.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/NewEvaluationContext.java
@@ -21,7 +21,7 @@ public class NewEvaluationContext extends HashMap<VariantStratifier, String> {
         String value = "";
 
         for ( VariantStratifier key : this.keySet() ) {
-            value += "\t" + key.getClass().getSimpleName() + ":" + this.get(key) + "\n";
+            value += "\t" + key.getName() + ":" + this.get(key) + "\n";
         }
 
         return value;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/StateKey.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/StateKey.java
index 2cccb0d35..96bd9a9b7 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/StateKey.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/StateKey.java
@@ -1,24 +1,23 @@
 package org.broadinstitute.sting.gatk.walkers.varianteval.util;
 
+import java.util.Map;
 import java.util.TreeMap;
 
 public class StateKey extends TreeMap<String, String> {
-    public int hashCode() {
-        int hashCode = 1;
-
-        for (String key : this.keySet()) {
-            String value = this.get(key);
-
-            hashCode *= key.hashCode() + value.hashCode();
-        }
-
-        return hashCode;
-    }
+//    public int hashCode() {
+//        int hashCode = 1;
+//
+//        for (final Map.Entry<String,String> pair : this.entrySet()) {
+//            hashCode *= pair.getKey().hashCode() + pair.getValue().hashCode();
+//        }
+//
+//        return hashCode;
+//    }
 
     public String toString() {
         String value = "";
 
-        for ( String key : this.keySet() ) {
+        for ( final String key : this.keySet() ) {
             //value += "\tstate " + key + ":" + this.get(key) + "\n";
             value += String.format("%s:%s;", key, this.get(key));
         }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
index b319407d1..2c57d475c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
@@ -196,7 +196,7 @@ public class VariantEvalUtils {
             for (VariantStratifier vs : ec.keySet()) {
                 String state = ec.get(vs);
 
-                stateKey.put(vs.getClass().getSimpleName(), state);
+                stateKey.put(vs.getName(), state);
             }
 
             ec.addEvaluationClassList(variantEvalWalker, stateKey, evaluationObjects);
@@ -230,7 +230,7 @@ public class VariantEvalUtils {
             table.addColumn(tableName, tableName);
 
             for (VariantStratifier vs : stratificationObjects) {
-                String columnName = vs.getClass().getSimpleName();
+                String columnName = vs.getName();
 
                 table.addColumn(columnName, "unknown");
             }
@@ -410,7 +410,7 @@ public class VariantEvalUtils {
                     newStateKey.putAll(stateKey);
                 }
 
-                newStateKey.put(vs.getClass().getSimpleName(), state);
+                newStateKey.put(vs.getName(), state);
 
                 initializeStateKeys(stateMap, newStateStack, newStateKey, stateKeys);
             }

From c8bf7d209924934eb8056e35860836e493747092 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 23 Nov 2011 10:47:21 -0500
Subject: [PATCH 107/113] Check for null comment

---
 .../java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java b/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
index b8b961119..b4d337d8d 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/CommandLineGATK.java
@@ -106,7 +106,7 @@ public class CommandLineGATK extends CommandLineExecutable {
 
     private static void checkForTooManyOpenFilesProblem(String message) {
         // Special case the "Too many open files" error because it's a common User Error for which we know what to do
-        if ( message.indexOf("Too many open files") != -1 )
+        if ( message != null && message.indexOf("Too many open files") != -1 )
             exitSystemWithUserError(new UserException.TooManyOpenFiles());
     }
 

From 5a4856b82e3a348361c611135d408262d5df5b98 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 23 Nov 2011 11:31:04 -0500
Subject: [PATCH 108/113] GATKReports now support a format field per column

-- You can tell the table to format your object with "%.2f" for example.
---
 .../sting/gatk/report/GATKReportColumn.java   | 21 +++++++++++++------
 .../sting/gatk/report/GATKReportTable.java    | 18 ++++++++++------
 2 files changed, 27 insertions(+), 12 deletions(-)

diff --git a/public/java/src/org/broadinstitute/sting/gatk/report/GATKReportColumn.java b/public/java/src/org/broadinstitute/sting/gatk/report/GATKReportColumn.java
index 347e870c8..6452c7b2b 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/report/GATKReportColumn.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/report/GATKReportColumn.java
@@ -6,9 +6,10 @@ import java.util.TreeMap;
  * Holds values for a column in a GATK report table
  */
 public class GATKReportColumn extends TreeMap<Object, Object> {
-    private String columnName;
-    private Object defaultValue;
-    private boolean display;
+    final private String columnName;
+    final private Object defaultValue;
+    final private String format;
+    final private boolean display;
 
     /**
      * Construct the column object, specifying the column name, default value, and whether or not the column should be displayed
@@ -18,11 +19,17 @@ public class GATKReportColumn extends TreeMap<Object, Object> {
      * @param display  if true, the column will be displayed in the final output
      */
     public GATKReportColumn(String columnName, Object defaultValue, boolean display) {
+        this(columnName, defaultValue, display, null);
+    }
+
+    public GATKReportColumn(String columnName, Object defaultValue, boolean display, String format) {
         this.columnName = columnName;
         this.defaultValue = defaultValue;
         this.display = display;
+        this.format = format == null ? null : (format.equals("") ? null : format);
     }
 
+
     /**
      * Initialize an element in the column with a default value
      *
@@ -55,7 +62,7 @@ public class GATKReportColumn extends TreeMap<Object, Object> {
      * @return  the string value at the specified position in the column, or the default value if the element is not set
      */
     public String getStringValue(Object primaryKey) {
-        return toString(getWithoutSideEffects(primaryKey));
+        return formatValue(getWithoutSideEffects(primaryKey));
     }
 
     /**
@@ -77,7 +84,7 @@ public class GATKReportColumn extends TreeMap<Object, Object> {
 
         for (Object obj : this.values()) {
             if (obj != null) {
-                int width = toString(obj).length();
+                int width = formatValue(obj).length();
 
                 if (width > maxWidth) {
                     maxWidth = width;
@@ -93,10 +100,12 @@ public class GATKReportColumn extends TreeMap<Object, Object> {
      * @param obj The object to convert to a string
      * @return The string representation of the column
      */
-    private static String toString(Object obj) {
+    private String formatValue(Object obj) {
         String value;
         if (obj == null) {
             value = "null";
+        } else if ( format != null ) {
+            value = String.format(format, obj);
         } else if (obj instanceof Float) {
             value = String.format("%.8f", (Float) obj);
         } else if (obj instanceof Double) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/report/GATKReportTable.java b/public/java/src/org/broadinstitute/sting/gatk/report/GATKReportTable.java
index 2fd5ad7e3..95c2a14fc 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/report/GATKReportTable.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/report/GATKReportTable.java
@@ -250,13 +250,12 @@ public class GATKReportTable {
      * @param defaultValue  the default value for the column
      */
     public void addColumn(String columnName, Object defaultValue) {
-        if (!isValidName(columnName)) {
-            throw new ReviewedStingException("Attempted to set a GATKReportTable column name of '" + columnName + "'.  GATKReportTable column names must be purely alphanumeric - no spaces or special characters are allowed.");
-        }
-
-        addColumn(columnName, defaultValue, true);
+        addColumn(columnName, defaultValue, null);
     }
 
+    public void addColumn(String columnName, Object defaultValue, String format) {
+        addColumn(columnName, defaultValue, true, format);
+    }
     /**
      * Add a column to the report, specify the default column value, and specify whether the column should be displayed in the final output (useful when intermediate columns are necessary for later calculations, but are not required to be in the output file.
      *
@@ -265,7 +264,14 @@ public class GATKReportTable {
      * @param display  if true - the column will be displayed; if false - the column will be hidden
      */
     public void addColumn(String columnName, Object defaultValue, boolean display) {
-        columns.put(columnName, new GATKReportColumn(columnName, defaultValue, display));
+        addColumn(columnName, defaultValue, display, null);
+    }
+
+    public void addColumn(String columnName, Object defaultValue, boolean display, String format) {
+        if (!isValidName(columnName)) {
+            throw new ReviewedStingException("Attempted to set a GATKReportTable column name of '" + columnName + "'.  GATKReportTable column names must be purely alphanumeric - no spaces or special characters are allowed.");
+        }
+        columns.put(columnName, new GATKReportColumn(columnName, defaultValue, display, format));
     }
 
     /**

From e5b85f0a786ee7c09413ec4ca81523387d27ce81 Mon Sep 17 00:00:00 2001
From: David Roazen <droazen@broadinstitute.org>
Date: Wed, 23 Nov 2011 11:45:57 -0500
Subject: [PATCH 109/113] A toString() method for IntervalBindings

Necessary since we're currently writing things like this to our VCF headers:
intervals=[org.broadinstitute.sting.commandline.IntervalBinding@4ce66f56]
---
 .../org/broadinstitute/sting/commandline/IntervalBinding.java | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/public/java/src/org/broadinstitute/sting/commandline/IntervalBinding.java b/public/java/src/org/broadinstitute/sting/commandline/IntervalBinding.java
index 82c7b20b6..9e2c9a818 100644
--- a/public/java/src/org/broadinstitute/sting/commandline/IntervalBinding.java
+++ b/public/java/src/org/broadinstitute/sting/commandline/IntervalBinding.java
@@ -108,4 +108,8 @@ public final class IntervalBinding<T extends Feature> {
 
         return intervals;
     }
+
+    public String toString() {
+        return getSource();
+    }
 }

From 41076361449a9e155b916847fb28c26fc82add5c Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 23 Nov 2011 13:02:07 -0500
Subject: [PATCH 110/113] VariantEval updates

-- Performance optimizations
-- Tables now are cleanly formatted (floats are %.2f printed)
-- VariantSummary is a standard report now
-- Removed CompEvalGenotypes (it didn't do anything)
-- Deleted unused classes in GenotypeConcordance
-- Updates integration tests as appropriate
---
 .../varianteval/VariantEvalWalker.java        |  19 +-
 .../evaluators/CompEvalGenotypes.java         |  35 ---
 .../varianteval/evaluators/CompOverlap.java   |   4 +-
 .../varianteval/evaluators/CountVariants.java |  12 +-
 .../evaluators/G1KPhaseITable.java            | 159 -------------
 .../evaluators/GenotypeConcordance.java       | 109 ---------
 .../evaluators/TiTvVariantEvaluator.java      |   6 +-
 .../evaluators/ValidationReport.java          |   8 +-
 .../evaluators/VariantSummary.java            | 223 ++++++++++++++++++
 .../walkers/varianteval/util/DataPoint.java   |   1 +
 .../varianteval/util/VariantEvalUtils.java    |  19 +-
 .../VariantEvalIntegrationTest.java           |  44 ++--
 12 files changed, 281 insertions(+), 358 deletions(-)
 delete mode 100755 public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompEvalGenotypes.java
 delete mode 100644 public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
 create mode 100644 public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/VariantSummary.java

diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
index 558d9c6bf..10d4651b7 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalWalker.java
@@ -312,16 +312,17 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
             String aastr = (ancestralAlignments == null) ? null : new String(ancestralAlignments.getSubsequenceAt(ref.getLocus().getContig(), ref.getLocus().getStart(), ref.getLocus().getStop()).getBases());
 
             //      --------- track ---------           sample  - VariantContexts -
-            HashMap<RodBinding<VariantContext>, HashMap<String, Set<VariantContext>>> evalVCs = variantEvalUtils.bindVariantContexts(tracker, ref, evals, byFilterIsEnabled, true, perSampleIsEnabled, mergeEvals);
-            HashMap<RodBinding<VariantContext>, HashMap<String, Set<VariantContext>>> compVCs = variantEvalUtils.bindVariantContexts(tracker, ref, comps, byFilterIsEnabled, false, false, false);
+            HashMap<RodBinding<VariantContext>, HashMap<String, Collection<VariantContext>>> evalVCs = variantEvalUtils.bindVariantContexts(tracker, ref, evals, byFilterIsEnabled, true, perSampleIsEnabled, mergeEvals);
+            HashMap<RodBinding<VariantContext>, HashMap<String, Collection<VariantContext>>> compVCs = variantEvalUtils.bindVariantContexts(tracker, ref, comps, byFilterIsEnabled, false, false, false);
 
             // for each eval track
             for ( final RodBinding<VariantContext> evalRod : evals ) {
-                final HashMap<String, Set<VariantContext>> evalSet = evalVCs.containsKey(evalRod) ? evalVCs.get(evalRod) : new HashMap<String, Set<VariantContext>>(0);
+                final Map<String, Collection<VariantContext>> emptyEvalMap = Collections.emptyMap();
+                final Map<String, Collection<VariantContext>> evalSet = evalVCs.containsKey(evalRod) ? evalVCs.get(evalRod) : emptyEvalMap;
 
                 // for each sample stratifier
                 for ( final String sampleName : sampleNamesForStratification ) {
-                    Set<VariantContext> evalSetBySample = evalSet.get(sampleName);
+                    Collection<VariantContext> evalSetBySample = evalSet.get(sampleName);
                     if ( evalSetBySample == null ) {
                         evalSetBySample = new HashSet<VariantContext>(1);
                         evalSetBySample.add(null);
@@ -337,8 +338,8 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
                         // for each comp track
                         for ( final RodBinding<VariantContext> compRod : comps ) {
                             // no sample stratification for comps
-                            final HashMap<String, Set<VariantContext>> compSetHash = compVCs.get(compRod);
-                            final Set<VariantContext> compSet = (compSetHash == null || compSetHash.size() == 0) ? new HashSet<VariantContext>(0) : compVCs.get(compRod).values().iterator().next();
+                            final HashMap<String, Collection<VariantContext>> compSetHash = compVCs.get(compRod);
+                            final Collection<VariantContext> compSet = (compSetHash == null || compSetHash.size() == 0) ? Collections.<VariantContext>emptyList() : compVCs.get(compRod).values().iterator().next();
 
                             // find the comp
                             final VariantContext comp = findMatchingComp(eval, compSet);
@@ -382,7 +383,7 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
         return null;
     }
 
-    private VariantContext findMatchingComp(final VariantContext eval, final Set<VariantContext> comps) {
+    private VariantContext findMatchingComp(final VariantContext eval, final Collection<VariantContext> comps) {
         // if no comps, return null
         if ( comps == null || comps.isEmpty() )
             return null;
@@ -447,11 +448,11 @@ public class VariantEvalWalker extends RodWalker<Integer, Integer> implements Tr
                             TableType t = (TableType) field.get(ve);
 
                             String subTableName = ve.getClass().getSimpleName() + "." + field.getName();
-                            String subTableDesc = datamap.get(field).description();
+                            final DataPoint dataPointAnn = datamap.get(field);
 
                             GATKReportTable table;
                             if (!report.hasTable(subTableName)) {
-                                report.addTable(subTableName, subTableDesc);
+                                report.addTable(subTableName, dataPointAnn.description());
                                 table = report.getTable(subTableName);
 
                                 table.addPrimaryKey("entry", false);
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompEvalGenotypes.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompEvalGenotypes.java
deleted file mode 100755
index 925bff9c0..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompEvalGenotypes.java
+++ /dev/null
@@ -1,35 +0,0 @@
-package org.broadinstitute.sting.gatk.walkers.varianteval.evaluators;
-
-import org.broadinstitute.sting.utils.GenomeLoc;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-
-class NewCompEvalGenotypes {
-    private GenomeLoc loc;
-    private Genotype compGt;
-    private Genotype evalGt;
-
-    public NewCompEvalGenotypes(GenomeLoc loc, Genotype compGt, Genotype evalGt) {
-        this.loc = loc;
-        this.compGt = compGt;
-        this.evalGt = evalGt;
-    }
-
-    public GenomeLoc getLocus() {
-        return loc;
-    }
-
-    public Genotype getCompGenotpye() {
-        return compGt;
-    }
-    public Genotype getEvalGenotype() {
-        return evalGt;
-    }
-
-    public void setCompGenotype(Genotype compGt) {
-        this.compGt = compGt;
-    }
-
-    public void setEvalGenotype(Genotype evalGt) {
-        this.evalGt = evalGt;
-    }
-}
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompOverlap.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompOverlap.java
index b3695921a..89d137ea9 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompOverlap.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CompOverlap.java
@@ -28,13 +28,13 @@ public class CompOverlap extends VariantEvaluator implements StandardEval {
     @DataPoint(description = "number of eval sites at comp sites")
     long nVariantsAtComp = 0;
 
-    @DataPoint(description = "percentage of eval sites at comp sites")
+    @DataPoint(description = "percentage of eval sites at comp sites", format = "%.2f" )
     double compRate = 0.0;
 
     @DataPoint(description = "number of concordant sites")
     long nConcordant = 0;
 
-    @DataPoint(description = "the concordance rate")
+    @DataPoint(description = "the concordance rate", format = "%.2f")
     double concordantRate = 0.0;
 
     public int getComparisonOrder() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
index d8413573a..c740eb78c 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/CountVariants.java
@@ -62,17 +62,17 @@ public class CountVariants extends VariantEvaluator implements StandardEval {
     public long nHomDerived = 0;
 
     // calculations that get set in the finalizeEvaluation method
-    @DataPoint(description = "heterozygosity per locus rate")
+    @DataPoint(description = "heterozygosity per locus rate", format = "%.2e")
     public double heterozygosity = 0;
-    @DataPoint(description = "heterozygosity per base pair")
+    @DataPoint(description = "heterozygosity per base pair", format = "%.2f")
     public double heterozygosityPerBp = 0;
-    @DataPoint(description = "heterozygosity to homozygosity ratio")
+    @DataPoint(description = "heterozygosity to homozygosity ratio", format = "%.2f")
     public double hetHomRatio = 0;
-    @DataPoint(description = "indel rate (insertion count + deletion count)")
+    @DataPoint(description = "indel rate (insertion count + deletion count)", format = "%.2e")
     public double indelRate = 0;
-    @DataPoint(description = "indel rate per base pair")
+    @DataPoint(description = "indel rate per base pair", format = "%.2f")
     public double indelRatePerBp = 0;
-    @DataPoint(description = "deletion to insertion ratio")
+    @DataPoint(description = "deletion to insertion ratio", format = "%.2f")
     public double deletionInsertionRatio = 0;
     
     private double perLocusRate(long n) {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
deleted file mode 100644
index ff8f6307c..000000000
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/G1KPhaseITable.java
+++ /dev/null
@@ -1,159 +0,0 @@
-/*
- * Copyright (c) 2011, The Broad Institute
- *
- * Permission is hereby granted, free of charge, to any person
- * obtaining a copy of this software and associated documentation
- * files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following
- * conditions:
- *
- * The above copyright notice and this permission notice shall be
- * included in all copies or substantial portions of the Software.
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
- * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
- * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- * OTHER DEALINGS IN THE SOFTWARE.
- */
-
-package org.broadinstitute.sting.gatk.walkers.varianteval.evaluators;
-
-import org.broadinstitute.sting.gatk.contexts.AlignmentContext;
-import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
-import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
-import org.broadinstitute.sting.gatk.walkers.varianteval.VariantEvalWalker;
-import org.broadinstitute.sting.gatk.walkers.varianteval.util.Analysis;
-import org.broadinstitute.sting.gatk.walkers.varianteval.util.DataPoint;
-import org.broadinstitute.sting.utils.exceptions.UserException;
-import org.broadinstitute.sting.utils.variantcontext.Genotype;
-import org.broadinstitute.sting.utils.variantcontext.VariantContext;
-
-import java.util.EnumMap;
-import java.util.HashMap;
-import java.util.Map;
-
-@Analysis(description = "Build 1000 Genome Phase I paper summary of variants table")
-public class G1KPhaseITable extends VariantEvaluator {
-    // basic counts on various rates found
-    @DataPoint(description = "Number of samples")
-    public long nSamples = 0;
-
-    @DataPoint(description = "Number of processed loci")
-    public long nProcessedLoci = 0;
-
-    @DataPoint(description = "Number of SNPs")
-    public long nSNPs = 0;
-    @DataPoint(description = "SNP Novelty Rate")
-    public String SNPNoveltyRate = "NA";
-    @DataPoint(description = "Mean number of SNPs per individual")
-    public long nSNPsPerSample = 0;
-
-    @DataPoint(description = "Number of Indels")
-    public long nIndels = 0;
-    @DataPoint(description = "Indel Novelty Rate")
-    public String IndelNoveltyRate = "NA";
-    @DataPoint(description = "Mean number of Indels per individual")
-    public long nIndelsPerSample = 0;
-
-    @DataPoint(description = "Number of SVs")
-    public long nSVs = 0;
-    @DataPoint(description = "SV Novelty Rate")
-    public String SVNoveltyRate = "NA";
-    @DataPoint(description = "Mean number of SVs per individual")
-    public long nSVsPerSample = 0;
-
-    Map<VariantContext.Type, Integer> allVariantCounts, knownVariantCounts;
-    Map<String, Map<VariantContext.Type, Integer>> countsPerSample;
-
-    private final Map<VariantContext.Type, Integer> makeCounts() {
-        Map<VariantContext.Type, Integer> counts = new EnumMap<VariantContext.Type, Integer>(VariantContext.Type.class);
-        counts.put(VariantContext.Type.SNP, 0);
-        counts.put(VariantContext.Type.INDEL, 0);
-        counts.put(VariantContext.Type.SYMBOLIC, 0);
-        return counts;
-    }
-
-    public void initialize(VariantEvalWalker walker) {
-        countsPerSample = new HashMap<String, Map<VariantContext.Type, Integer>>();
-        nSamples = walker.getSampleNamesForEvaluation().size();
-
-        for ( String sample : walker.getSampleNamesForEvaluation() ) {
-            countsPerSample.put(sample, makeCounts());
-        }
-
-        allVariantCounts = makeCounts();
-        knownVariantCounts = makeCounts();
-    }
-
-    @Override public boolean enabled() { return true; }
-
-    public int getComparisonOrder() {
-        return 2;   // we only need to see each eval track
-    }
-
-    public void update0(RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        nProcessedLoci += context.getSkippedBases() + (ref == null ? 0 : 1);
-    }
-
-    public String update2(VariantContext eval, VariantContext comp, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
-        if ( eval == null || eval.isMonomorphicInSamples() ) return null;
-
-        switch (eval.getType()) {
-            case SNP:
-            case INDEL:
-            case SYMBOLIC:
-                allVariantCounts.put(eval.getType(), allVariantCounts.get(eval.getType()) + 1);
-                if ( comp != null )
-                    knownVariantCounts.put(eval.getType(), knownVariantCounts.get(eval.getType()) + 1);
-                break;
-            default:
-                throw new UserException.BadInput("Unexpected variant context type: " + eval);
-        }
-
-        // count variants per sample
-        for (final Genotype g : eval.getGenotypes()) {
-            if ( ! g.isNoCall() && ! g.isHomRef() ) {
-                int count = countsPerSample.get(g.getSampleName()).get(eval.getType());
-                countsPerSample.get(g.getSampleName()).put(eval.getType(), count + 1);
-            }
-        }
-
-        return null; // we don't capture any interesting sites
-    }
-
-    private final int perSampleMean(VariantContext.Type type) {
-        long sum = 0;
-        for ( Map<VariantContext.Type, Integer> count : countsPerSample.values() ) {
-            sum += count.get(type);
-        }
-        return (int)(Math.round(sum / (1.0 * countsPerSample.size())));
-    }
-
-    private final String noveltyRate(VariantContext.Type type) {
-        int all = allVariantCounts.get(type);
-        int known = knownVariantCounts.get(type);
-        int novel = all - known;
-        double rate = (novel / (1.0 * all));
-        return all == 0 ? "NA" : String.format("%.2f", rate);
-    }
-
-    public void finalizeEvaluation() {
-        nSNPs = allVariantCounts.get(VariantContext.Type.SNP);
-        nIndels = allVariantCounts.get(VariantContext.Type.INDEL);
-        nSVs = allVariantCounts.get(VariantContext.Type.SYMBOLIC);
-
-        nSNPsPerSample = perSampleMean(VariantContext.Type.SNP);
-        nIndelsPerSample = perSampleMean(VariantContext.Type.INDEL);
-        nSVsPerSample = perSampleMean(VariantContext.Type.SYMBOLIC);
-
-        SNPNoveltyRate = noveltyRate(VariantContext.Type.SNP);
-        IndelNoveltyRate = noveltyRate(VariantContext.Type.INDEL);
-        SVNoveltyRate = noveltyRate(VariantContext.Type.SYMBOLIC);
-    }
-}
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypeConcordance.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypeConcordance.java
index 70b37f500..4f5aeed61 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypeConcordance.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/GenotypeConcordance.java
@@ -445,39 +445,6 @@ class SampleStats implements TableType {
     }
 }
 
-/**
- * Sample stats, but for AC
- */
-class ACStats extends SampleStats {
-    private String[] rowKeys;
-
-    public ACStats(VariantContext evalvc, VariantContext compvc, int nGenotypeTypes) {
-        super(nGenotypeTypes);
-        rowKeys = new String[1+2*evalvc.getGenotypes().size()+1+2*compvc.getGenotypes().size()];
-        for ( int i = 0; i <= 2*evalvc.getGenotypes().size(); i++ ) { // todo -- assuming ploidy 2 here...
-            concordanceStats.put(String.format("evalAC%d",i),new long[nGenotypeTypes][nGenotypeTypes]);
-            rowKeys[i] = String.format("evalAC%d",i);
-
-        }
-
-        for ( int i = 0; i <= 2*compvc.getGenotypes().size(); i++ ) {
-            concordanceStats.put(String.format("compAC%d",i), new long[nGenotypeTypes][nGenotypeTypes]);
-            rowKeys[1+2*evalvc.getGenotypes().size()+i] = String.format("compAC%d",i);
-        }
-    }
-
-    public String getName() {
-        return "Allele Count Statistics";
-    }
-
-    public Object[] getRowKeys() {
-        if ( rowKeys == null ) {
-            throw new StingException("RowKeys is null!");
-        }
-        return rowKeys;
-    }
-}
-
 /**
  * a table of sample names to genotype concordance summary statistics
  */
@@ -637,79 +604,3 @@ class SampleSummaryStats implements TableType {
     }
 }
 
-/**
- * SampleSummaryStats .. but for allele counts
- */
-class ACSummaryStats extends SampleSummaryStats {
-    private String[] rowKeys;
-
-    public ACSummaryStats (final VariantContext evalvc, final VariantContext compvc) {
-        concordanceSummary.put(ALL_SAMPLES_KEY, new double[COLUMN_KEYS.length]);
-        rowKeys = new String[3+2*evalvc.getGenotypes().size() + 2*compvc.getGenotypes().size()];
-        rowKeys[0] = ALL_SAMPLES_KEY;
-        for( int i = 0; i <= 2*evalvc.getGenotypes().size() ; i ++ ) {
-            concordanceSummary.put(String.format("evalAC%d",i), new double[COLUMN_KEYS.length]);
-            rowKeys[i+1] = String.format("evalAC%d",i);
-        }
-        for( int i = 0; i <= 2*compvc.getGenotypes().size() ; i ++ ) {
-            concordanceSummary.put(String.format("compAC%d",i), new double[COLUMN_KEYS.length]);
-            rowKeys[2+2*evalvc.getGenotypes().size()+i] = String.format("compAC%d",i);
-        }
-
-    }
-
-    public String getName() {
-        return "Allele Count Summary Statistics";
-    }
-
-    public Object[] getRowKeys() {
-        if ( rowKeys == null) {
-            throw new StingException("rowKeys is null!!");
-        }
-        return rowKeys;
-    }
-}
-
-class CompACNames implements Comparator{
-
-    final Logger myLogger;
-    private boolean info = true;
-
-    public CompACNames(Logger l) {
-        myLogger = l;
-    }
-
-    public boolean equals(Object o) {
-        return ( o.getClass() == CompACNames.class );
-    }
-
-    public int compare(Object o1, Object o2) {
-        if ( info ) {
-            myLogger.info("Sorting AC names");
-            info = false;
-        }
-        //System.out.printf("Objects %s %s get ranks %d %d%n",o1.toString(),o2.toString(),getRank(o1),getRank(o2));
-        return getRank(o1) - getRank(o2);
-    }
-
-    public int getRank(Object o) {
-        if ( o.getClass() != String.class ) {
-            return Integer.MIN_VALUE/4;
-        } else {
-            String s = (String) o;
-            if ( s.startsWith("eval") ) {
-                return Integer.MIN_VALUE/4 + 1 + parseAC(s);
-            } else if ( s.startsWith("comp") ) {
-                return 1+ parseAC(s);
-            } else {
-                return Integer.MIN_VALUE/4;
-            }
-        }
-    }
-
-    public int parseAC(String s) {
-        String[] g = s.split("AC");
-        return Integer.parseInt(g[1]);
-    }
-}
-
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/TiTvVariantEvaluator.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/TiTvVariantEvaluator.java
index 17d7171b8..9de850d82 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/TiTvVariantEvaluator.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/TiTvVariantEvaluator.java
@@ -16,19 +16,19 @@ public class TiTvVariantEvaluator extends VariantEvaluator implements StandardEv
     long nTi = 0;
     @DataPoint(description = "number of transversion loci")
     long nTv = 0;
-    @DataPoint(description = "the transition to transversion ratio")
+    @DataPoint(description = "the transition to transversion ratio", format = "%.2f")
     double tiTvRatio = 0.0;    
     @DataPoint(description = "number of comp transition sites")
     long nTiInComp = 0;
     @DataPoint(description = "number of comp transversion sites")
     long nTvInComp = 0;
-    @DataPoint(description = "the transition to transversion ratio for comp sites")
+    @DataPoint(description = "the transition to transversion ratio for comp sites", format = "%.2f")
     double TiTvRatioStandard = 0.0;
     @DataPoint(description = "number of derived transition loci")
     long nTiDerived = 0;
     @DataPoint(description = "number of derived transversion loci")
     long nTvDerived = 0;
-    @DataPoint(description = "the derived transition to transversion ratio")
+    @DataPoint(description = "the derived transition to transversion ratio", format = "%.2f")
     double tiTvDerivedRatio = 0.0;
 
     public boolean enabled() {
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ValidationReport.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ValidationReport.java
index 1a0591e9d..86d3467fb 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ValidationReport.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/ValidationReport.java
@@ -30,10 +30,10 @@ public class ValidationReport extends VariantEvaluator implements StandardEval {
     @DataPoint(description = "FN") int FN = 0;
     @DataPoint(description = "TN") int TN = 0;
 
-    @DataPoint(description = "Sensitivity") double sensitivity = 0;
-    @DataPoint(description = "Specificity") double specificity = 0;
-    @DataPoint(description = "PPV") double PPV = 0;
-    @DataPoint(description = "FDR") double FDR = 0;
+    @DataPoint(description = "Sensitivity", format = "%.2f") double sensitivity = 0;
+    @DataPoint(description = "Specificity", format = "%.2f") double specificity = 0;
+    @DataPoint(description = "PPV", format = "%.2f") double PPV = 0;
+    @DataPoint(description = "FDR", format = "%.2f") double FDR = 0;
 
     @DataPoint(description = "CompMonoEvalNoCall") int CompMonoEvalNoCall = 0;
     @DataPoint(description = "CompMonoEvalFiltered") int CompMonoEvalFiltered = 0;
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/VariantSummary.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/VariantSummary.java
new file mode 100644
index 000000000..ba7164400
--- /dev/null
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/evaluators/VariantSummary.java
@@ -0,0 +1,223 @@
+/*
+ * Copyright (c) 2011, The Broad Institute
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.broadinstitute.sting.gatk.walkers.varianteval.evaluators;
+
+import org.broadinstitute.sting.gatk.contexts.AlignmentContext;
+import org.broadinstitute.sting.gatk.contexts.ReferenceContext;
+import org.broadinstitute.sting.gatk.refdata.RefMetaDataTracker;
+import org.broadinstitute.sting.gatk.walkers.varianteval.VariantEvalWalker;
+import org.broadinstitute.sting.gatk.walkers.varianteval.util.Analysis;
+import org.broadinstitute.sting.gatk.walkers.varianteval.util.DataPoint;
+import org.broadinstitute.sting.utils.codecs.vcf.VCFConstants;
+import org.broadinstitute.sting.utils.exceptions.UserException;
+import org.broadinstitute.sting.utils.variantcontext.Genotype;
+import org.broadinstitute.sting.utils.variantcontext.VariantContext;
+import org.broadinstitute.sting.utils.variantcontext.VariantContextUtils;
+
+import java.util.Collection;
+import java.util.EnumMap;
+import java.util.HashMap;
+import java.util.Map;
+
+@Analysis(description = "1000 Genomes Phase I summary of variants table")
+public class VariantSummary extends VariantEvaluator implements StandardEval {
+    // basic counts on various rates found
+    @DataPoint(description = "Number of samples")
+    public long nSamples = 0;
+
+    @DataPoint(description = "Number of processed loci")
+    public long nProcessedLoci = 0;
+
+    @DataPoint(description = "Number of SNPs")
+    public long nSNPs = 0;
+    @DataPoint(description = "Overall TiTv ratio", format = "%.2f")
+    public double TiTvRatio = 0;
+    @DataPoint(description = "SNP Novelty Rate")
+    public String SNPNoveltyRate = "NA";
+    @DataPoint(description = "Mean number of SNPs per individual")
+    public long nSNPsPerSample = 0;
+    @DataPoint(description = "Mean TiTv ratio per individual", format = "%.2f")
+    public double TiTvRatioPerSample = 0;
+    @DataPoint(description = "Mean depth of coverage per sample at SNPs", format = "%.1f")
+    public double SNPDPPerSample = 0;
+
+    @DataPoint(description = "Number of Indels")
+    public long nIndels = 0;
+    @DataPoint(description = "Indel Novelty Rate")
+    public String IndelNoveltyRate = "NA";
+    @DataPoint(description = "Mean number of Indels per individual")
+    public long nIndelsPerSample = 0;
+    @DataPoint(description = "Mean depth of coverage per sample at Indels", format = "%.1f")
+    public double IndelDPPerSample = 0;
+
+    @DataPoint(description = "Number of SVs")
+    public long nSVs = 0;
+    @DataPoint(description = "SV Novelty Rate")
+    public String SVNoveltyRate = "NA";
+    @DataPoint(description = "Mean number of SVs per individual")
+    public long nSVsPerSample = 0;
+
+    TypeSampleMap allVariantCounts, knownVariantCounts;
+    TypeSampleMap countsPerSample;
+    TypeSampleMap transitionsPerSample, transversionsPerSample;
+    TypeSampleMap depthPerSample;
+
+    private final static String ALL = "ALL";
+
+    private class TypeSampleMap extends EnumMap<VariantContext.Type, Map<String, Integer>> {
+        public TypeSampleMap(final Collection<String> samples) {
+            super(VariantContext.Type.class);
+            for ( VariantContext.Type type : VariantContext.Type.values() ) {
+                Map<String, Integer> bySample = new HashMap<String, Integer>(samples.size());
+                for ( final String sample : samples ) {
+                    bySample.put(sample, 0);
+                }
+                bySample.put(ALL, 0);
+                this.put(type, bySample);
+            }
+        }
+
+        public final void inc(final VariantContext.Type type, final String sample) {
+            final int count = this.get(type).get(sample);
+            get(type).put(sample, count + 1);
+        }
+
+        public final int all(VariantContext.Type type) {
+            return get(type).get(ALL);
+        }
+
+        public final int meanValue(VariantContext.Type type) {
+            long sum = 0;
+            int n = 0;
+            for ( final Map.Entry<String, Integer> pair : get(type).entrySet() ) {
+                if ( pair.getKey() != ALL)  {
+                    n++;
+                    sum += pair.getValue();
+                }
+            }
+            return (int)(Math.round(sum / (1.0 * n)));
+        }
+
+        public final double ratioValue(VariantContext.Type type, TypeSampleMap denoms, boolean allP) {
+            double sum = 0;
+            int n = 0;
+            for ( final String sample : get(type).keySet() ) {
+                if ( (allP && sample == ALL) || (!allP && sample != ALL) ) {
+                    final long num = get(type).get(sample);
+                    final long denom = denoms.get(type).get(sample);
+                    sum += ratio(num, denom);
+                    n++;
+                }
+            }
+            return Math.round(sum / (1.0 * n));
+        }
+    }
+
+
+    public void initialize(VariantEvalWalker walker) {
+        nSamples = walker.getSampleNamesForEvaluation().size();
+        countsPerSample = new TypeSampleMap(walker.getSampleNamesForEvaluation());
+        transitionsPerSample = new TypeSampleMap(walker.getSampleNamesForEvaluation());
+        transversionsPerSample = new TypeSampleMap(walker.getSampleNamesForEvaluation());
+        allVariantCounts = new TypeSampleMap(walker.getSampleNamesForEvaluation());
+        knownVariantCounts = new TypeSampleMap(walker.getSampleNamesForEvaluation());
+        depthPerSample = new TypeSampleMap(walker.getSampleNamesForEvaluation());
+    }
+
+    @Override public boolean enabled() { return true; }
+
+    public int getComparisonOrder() {
+        return 2;   // we only need to see each eval track
+    }
+
+    public void update0(RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
+        nProcessedLoci += context.getSkippedBases() + (ref == null ? 0 : 1);
+    }
+
+    public String update2(VariantContext eval, VariantContext comp, RefMetaDataTracker tracker, ReferenceContext ref, AlignmentContext context) {
+        if ( eval == null || eval.isMonomorphicInSamples() ) return null;
+
+        TypeSampleMap titvTable = null;
+
+        switch (eval.getType()) {
+            case SNP:
+                titvTable = VariantContextUtils.isTransition(eval) ? transitionsPerSample : transversionsPerSample;
+                titvTable.inc(eval.getType(), ALL);
+            case INDEL:
+            case SYMBOLIC:
+                allVariantCounts.inc(eval.getType(), ALL);
+                if ( comp != null )
+                    knownVariantCounts.inc(eval.getType(), ALL);
+                if ( eval.hasAttribute(VCFConstants.DEPTH_KEY) )
+                    depthPerSample.inc(eval.getType(), ALL);
+                break;
+            default:
+                throw new UserException.BadInput("Unexpected variant context type: " + eval);
+        }
+
+        // per sample metrics
+        for (final Genotype g : eval.getGenotypes()) {
+            if ( ! g.isNoCall() && ! g.isHomRef() ) {
+                countsPerSample.inc(eval.getType(), g.getSampleName());
+
+                // update transition / transversion ratio
+                if ( titvTable != null ) titvTable.inc(eval.getType(), g.getSampleName());
+
+                if ( g.hasAttribute(VCFConstants.DEPTH_KEY) )
+                    depthPerSample.inc(eval.getType(), g.getSampleName());
+            }
+        }
+
+        return null; // we don't capture any interesting sites
+    }
+
+    private final String noveltyRate(VariantContext.Type type) {
+        final int all = allVariantCounts.all(type);
+        final int known = knownVariantCounts.all(type);
+        final int novel = all - known;
+        final double rate = (novel / (1.0 * all));
+        return all == 0 ? "NA" : String.format("%.2f", rate);
+    }
+
+    public void finalizeEvaluation() {
+        nSNPs = allVariantCounts.all(VariantContext.Type.SNP);
+        nIndels = allVariantCounts.all(VariantContext.Type.INDEL);
+        nSVs = allVariantCounts.all(VariantContext.Type.SYMBOLIC);
+
+        TiTvRatio = transitionsPerSample.ratioValue(VariantContext.Type.SNP, transversionsPerSample, true);
+        TiTvRatioPerSample = transitionsPerSample.ratioValue(VariantContext.Type.SNP, transversionsPerSample, false);
+
+        nSNPsPerSample = countsPerSample.meanValue(VariantContext.Type.SNP);
+        nIndelsPerSample = countsPerSample.meanValue(VariantContext.Type.INDEL);
+        nSVsPerSample = countsPerSample.meanValue(VariantContext.Type.SYMBOLIC);
+
+        SNPNoveltyRate = noveltyRate(VariantContext.Type.SNP);
+        IndelNoveltyRate = noveltyRate(VariantContext.Type.INDEL);
+        SVNoveltyRate = noveltyRate(VariantContext.Type.SYMBOLIC);
+
+        SNPDPPerSample = depthPerSample.meanValue(VariantContext.Type.SNP);
+        IndelDPPerSample = depthPerSample.meanValue(VariantContext.Type.INDEL);
+    }
+}
\ No newline at end of file
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/DataPoint.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/DataPoint.java
index 396843252..90a6b97e0 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/DataPoint.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/DataPoint.java
@@ -6,4 +6,5 @@ import java.lang.annotation.RetentionPolicy;
 @Retention(RetentionPolicy.RUNTIME)
 public @interface DataPoint {
     String description() default ""; // the description, optional
+    String format() default "";
 }
diff --git a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
index 2c57d475c..cb44ca522 100755
--- a/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
+++ b/public/java/src/org/broadinstitute/sting/gatk/walkers/varianteval/util/VariantEvalUtils.java
@@ -246,7 +246,7 @@ public class VariantEvalUtils {
                     field.setAccessible(true);
 
                     if (!(field.get(vei) instanceof TableType)) {
-                        table.addColumn(field.getName(), 0.0);
+                        table.addColumn(field.getName(), 0.0, datamap.get(field).format());
                     }
                 }
             } catch (InstantiationException e) {
@@ -297,6 +297,7 @@ public class VariantEvalUtils {
      * Additional variant contexts per sample are automatically generated and added to the map unless the sample name
      * matches the ALL_SAMPLE_NAME constant.
      *
+     *
      * @param tracker        the metadata tracker
      * @param ref            the reference context
      * @param tracks         the list of tracks to process
@@ -308,7 +309,7 @@ public class VariantEvalUtils {
      *
      * @return the mapping of track to VC list that should be populated
      */
-    public HashMap<RodBinding<VariantContext>, HashMap<String, Set<VariantContext>>>
+    public HashMap<RodBinding<VariantContext>, HashMap<String, Collection<VariantContext>>>
         bindVariantContexts(RefMetaDataTracker tracker,
                             ReferenceContext ref,
                             List<RodBinding<VariantContext>> tracks,
@@ -319,11 +320,11 @@ public class VariantEvalUtils {
         if ( tracker == null )
             return null;
 
-        HashMap<RodBinding<VariantContext>, HashMap<String, Set<VariantContext>>> bindings = new HashMap<RodBinding<VariantContext>, HashMap<String, Set<VariantContext>>>();
+        HashMap<RodBinding<VariantContext>, HashMap<String, Collection<VariantContext>>> bindings = new HashMap<RodBinding<VariantContext>, HashMap<String, Collection<VariantContext>>>();
 
         RodBinding<VariantContext> firstTrack = tracks.isEmpty() ? null : tracks.get(0);
         for ( RodBinding<VariantContext> track : tracks ) {
-            HashMap<String, Set<VariantContext>> mapping = new HashMap<String, Set<VariantContext>>();
+            HashMap<String, Collection<VariantContext>> mapping = new HashMap<String, Collection<VariantContext>>();
 
             for ( VariantContext vc : tracker.getValues(track, ref.getLocus()) ) {
 
@@ -352,9 +353,9 @@ public class VariantEvalUtils {
 
             if ( mergeTracks && bindings.containsKey(firstTrack) ) {
                 // go through each binding of sample -> value and add all of the bindings from this entry
-                HashMap<String, Set<VariantContext>> firstMapping = bindings.get(firstTrack);
-                for ( Map.Entry<String, Set<VariantContext>> elt : mapping.entrySet() ) {
-                    Set<VariantContext> firstMappingSet = firstMapping.get(elt.getKey());
+                HashMap<String, Collection<VariantContext>> firstMapping = bindings.get(firstTrack);
+                for ( Map.Entry<String, Collection<VariantContext>> elt : mapping.entrySet() ) {
+                    Collection<VariantContext> firstMappingSet = firstMapping.get(elt.getKey());
                     if ( firstMappingSet != null ) {
                         firstMappingSet.addAll(elt.getValue());
                     } else {
@@ -369,9 +370,9 @@ public class VariantEvalUtils {
         return bindings;
     }
 
-    private void addMapping(HashMap<String, Set<VariantContext>> mappings, String sample, VariantContext vc) {
+    private void addMapping(HashMap<String, Collection<VariantContext>> mappings, String sample, VariantContext vc) {
         if ( !mappings.containsKey(sample) )
-            mappings.put(sample, new LinkedHashSet<VariantContext>());
+            mappings.put(sample, new ArrayList<VariantContext>(1));
         mappings.get(sample).add(vc);
     }
 
diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalIntegrationTest.java
index 102d4715e..403ecce78 100755
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/varianteval/VariantEvalIntegrationTest.java
@@ -30,7 +30,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                                         "-o %s"
                                 ),
                                 1,
-                                Arrays.asList("a36414421621b377d6146d58d2fcecd0")
+                                Arrays.asList("abe943d1aac120d7e75b9b9e5dac2399")
                               );
         executeTest("testFunctionClassWithSnpeff", spec);
     }
@@ -50,7 +50,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                                         "-o %s"
                                 ),
                                 1,
-                                Arrays.asList("6a71b17c19f5914c277a99f45f5d9c39")
+                                Arrays.asList("5fd9624c7a35ffb79d0feb1e233fc757")
                               );
         executeTest("testStratifySamplesAndExcludeMonomorphicSites", spec);
     }
@@ -70,7 +70,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                                         "-o %s"
                                 ),
                                 1,
-                                Arrays.asList("fb926edfd3d811e18b33798a43ef4379")
+                                Arrays.asList("4a8765cd02d36e63f6d0f0c10a6c674b")
                               );
         executeTest("testFundamentalsCountVariantsSNPsandIndels", spec);
     }
@@ -91,7 +91,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("26b7d57e3a204ac80a28cb29485b59b7")
+                Arrays.asList("4106ab8f742ad1c3138c29220151503c")
         );
         executeTest("testFundamentalsCountVariantsSNPsandIndelsWithNovelty", spec);
     }
@@ -113,7 +113,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("1df8184062f330bea9da8bacacc5a09d")
+                Arrays.asList("6cee3a8d68307a118944f2df5401ac89")
         );
         executeTest("testFundamentalsCountVariantsSNPsandIndelsWithNoveltyAndFilter", spec);
     }
@@ -134,7 +134,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("927f26414509db9e7c0a2c067d57c949")
+                Arrays.asList("af5dd27354d5dfd0d2fe03149af09b55")
         );
         executeTest("testFundamentalsCountVariantsSNPsandIndelsWithCpG", spec);
     }
@@ -155,7 +155,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("e6fddefd95122cabc5a0f0b95bce6d34")
+                Arrays.asList("062a231e203671e19aa9c6507710d762")
         );
         executeTest("testFundamentalsCountVariantsSNPsandIndelsWithFunctionalClass", spec);
     }
@@ -176,7 +176,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("df10486dae73a9cf8c647964f51ba3e0")
+                Arrays.asList("75abdd2b17c0a5e04814b6969a3d4d7e")
         );
         executeTest("testFundamentalsCountVariantsSNPsandIndelsWithDegeneracy", spec);
     }
@@ -197,7 +197,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("524adb0b7ff70e227b8803a88f36713e")
+                Arrays.asList("bdbb5f8230a4a193058750c5e506c733")
         );
         executeTest("testFundamentalsCountVariantsSNPsandIndelsWithSample", spec);
     }
@@ -220,7 +220,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("ef6449789dfc032602458b7c5538a1bc")
+                Arrays.asList("f076120da22930294840fcc396f5f141")
         );
         executeTest("testFundamentalsCountVariantsSNPsandIndelsWithJexlExpression", spec);
     }
@@ -245,7 +245,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("13b90e94fa82d72bb04a0a5addb27c3f")
+                Arrays.asList("69201f4a2a7a44b38805a4aeeb8830b6")
         );
         executeTest("testFundamentalsCountVariantsSNPsandIndelsWithMultipleJexlExpressions", spec);
     }
@@ -264,7 +264,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                         "-o %s"
                 ),
                 1,
-                Arrays.asList("8458b9d7803d75aae551fac7dbd152d6")
+                Arrays.asList("c3bd3cb6cfb21a8c2b4d5f69104bf6c2")
         );
         executeTest("testFundamentalsCountVariantsNoCompRod", spec);
     }
@@ -277,7 +277,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                 " --eval " + validationDataLocation + "yri.trio.gatk_glftrio.intersection.annotated.filtered.chr1.vcf" +
                 " --comp:comp_genotypes,VCF3 " + validationDataLocation + "yri.trio.gatk.ug.head.vcf";
         WalkerTestSpec spec = new WalkerTestSpec(withSelect(tests, "DP < 50", "DP50") + " " + extraArgs + " -ST CpG -o %s",
-                1, Arrays.asList("b954dee127ec4205ed7d33c91aa3e045"));
+                1, Arrays.asList("861f94e3237d62bd5bc00757319241f7"));
         executeTestParallel("testSelect1", spec);
     }
 
@@ -294,7 +294,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
     @Test
     public void testCompVsEvalAC() {
         String extraArgs = "-T VariantEval -R "+b36KGReference+" -o %s -ST CpG -EV GenotypeConcordance --eval:evalYRI,VCF3 " + validationDataLocation + "yri.trio.gatk.ug.very.few.lines.vcf --comp:compYRI,VCF3 " + validationDataLocation + "yri.trio.gatk.fake.genotypes.ac.test.vcf";
-        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("ae0027197547731a9a5c1eec5fbe0221"));
+        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("955c33365e017679047fabec0f14d5e0"));
         executeTestParallel("testCompVsEvalAC",spec);
     }
 
@@ -312,7 +312,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
     @Test
     public void testCompOverlap() {
         String extraArgs = "-T VariantEval -R " + b37KGReference + " -L " + validationDataLocation + "VariantEval/pacbio.hg19.intervals --comp:comphapmap " + comparisonDataLocation + "Validated/HapMap/3.3/genotypes_r27_nr.b37_fwd.vcf --eval " + validationDataLocation + "VariantEval/pacbio.ts.recalibrated.vcf -noEV -EV CompOverlap -sn NA12878 -noST -ST Novelty -o %s";
-        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("009ecc8376a20dce81ff5299ef6bfecb"));
+        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("fb7d989e44bd74c5376cb5732f9f3f64"));
         executeTestParallel("testCompOverlap",spec);
     }
 
@@ -324,7 +324,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                            " --dbsnp " + b37dbSNP132 +
                            " --eval:evalBI " + validationDataLocation + "VariantEval/ALL.20100201.chr20.bi.sites.vcf" +
                            " -noST -ST Novelty -o %s";
-        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("835b44fc3004cc975c968c9f92ed25d6"));
+        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("da5bcb305c5ef207ce175821efdbdefd"));
         executeTestParallel("testEvalTrackWithoutGenotypes",spec);
     }
 
@@ -336,7 +336,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                 " --eval:evalBI " + validationDataLocation + "VariantEval/ALL.20100201.chr20.bi.sites.vcf" +
                 " --eval:evalBC " + validationDataLocation + "VariantEval/ALL.20100201.chr20.bc.sites.vcf" +
                 " -noST -ST Novelty -o %s";
-        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("f0e003f1293343c3210ae95e8936b19a"));
+        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("fde839ece1442388f21a2f0b936756a8"));
         executeTestParallel("testMultipleEvalTracksWithoutGenotypes",spec);
     }
 
@@ -353,13 +353,13 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                            " -noST -noEV -ST Novelty -EV CompOverlap" +
                            " -o %s";
 
-        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("0b81d97f843ec4a1a4222d1f9949bfca"));
+        WalkerTestSpec spec = new WalkerTestSpec(extraArgs,1,Arrays.asList("1efae6b3b88c752b771e0c8fae24464e"));
         executeTestParallel("testMultipleCompTracks",spec);
     }
 
     @Test
-    public void testPerSampleAndSubsettedSampleHaveSameResults() {
-        String md5 = "7425ca5c439afd7bb33ed5cfea02c2b3";
+    public void testPerSampleAndSubsettedSampleHaveSameResults1() {
+        String md5 = "bc9bcabc3105e2515d9a2d41506d2de1";
 
         WalkerTestSpec spec = new WalkerTestSpec(
                 buildCommandLine(
@@ -414,7 +414,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                                         "-o %s"
                                 ),
                                 1,
-                                Arrays.asList("924b6123edb9da540d0abc66f6f33e16")
+                                Arrays.asList("e53546243250634fc03e83b4e61ec55f")
                               );
         executeTest("testAlleleCountStrat", spec);
     }
@@ -435,7 +435,7 @@ public class VariantEvalIntegrationTest extends WalkerTest {
                                         "-o %s"
                                 ),
                                 1,
-                                Arrays.asList("9794e2dba205c6929dc89899fdf0bf6b")
+                                Arrays.asList("c8086f0525bc13e666afeb670c2e13ae")
                               );
         executeTest("testIntervalStrat", spec);
     }

From fdd90825a193c2f928fad28a9eed16d28847ac5a Mon Sep 17 00:00:00 2001
From: David Roazen <droazen@broadinstitute.org>
Date: Wed, 23 Nov 2011 13:31:39 -0500
Subject: [PATCH 111/113] Queue now outputs a GATK-like header with version
 number, build timestamp, etc.

---
 .../sting/queue/QCommandLine.scala            | 40 ++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/public/scala/src/org/broadinstitute/sting/queue/QCommandLine.scala b/public/scala/src/org/broadinstitute/sting/queue/QCommandLine.scala
index 768eab7e4..913bd243c 100644
--- a/public/scala/src/org/broadinstitute/sting/queue/QCommandLine.scala
+++ b/public/scala/src/org/broadinstitute/sting/queue/QCommandLine.scala
@@ -26,7 +26,6 @@ package org.broadinstitute.sting.queue
 
 import function.QFunction
 import java.io.File
-import java.util.Arrays
 import org.broadinstitute.sting.commandline._
 import org.broadinstitute.sting.queue.util._
 import org.broadinstitute.sting.queue.engine.{QGraphSettings, QGraph}
@@ -34,6 +33,9 @@ import collection.JavaConversions._
 import org.broadinstitute.sting.utils.classloader.PluginManager
 import org.broadinstitute.sting.utils.exceptions.UserException
 import org.broadinstitute.sting.utils.io.IOUtils
+import org.broadinstitute.sting.utils.help.ApplicationDetails
+import java.util.{ResourceBundle, Arrays}
+import org.broadinstitute.sting.utils.text.TextFormattingUtils
 
 /**
  * Entry point of Queue.  Compiles and runs QScripts passed in to the command line.
@@ -175,6 +177,42 @@ class QCommandLine extends CommandLineProgram with Logging {
   override def getArgumentTypeDescriptors =
     Arrays.asList(new ScalaCompoundArgumentTypeDescriptor)
 
+  override def getApplicationDetails : ApplicationDetails = {
+    new ApplicationDetails(createQueueHeader(),
+                           List.empty[String],
+                           ApplicationDetails.createDefaultRunningInstructions(getClass.asInstanceOf[Class[CommandLineProgram]]),
+                           "")
+  }
+
+  private def createQueueHeader() : List[String] = {
+    List(String.format("Queue v%s, Compiled %s", getQueueVersion, getBuildTimestamp),
+         "Copyright (c) 2011 The Broad Institute",
+         "Please view our documentation at http://www.broadinstitute.org/gsa/wiki",
+         "For support, please view our support site at http://getsatisfaction.com/gsa")
+  }
+
+  private def getQueueVersion : String = {
+    var stingResources : ResourceBundle = TextFormattingUtils.loadResourceBundle("StingText")
+
+    if ( stingResources.containsKey("org.broadinstitute.sting.queue.QueueVersion.version") ) {
+      stingResources.getString("org.broadinstitute.sting.queue.QueueVersion.version")
+    }
+    else {
+      "<unknown>"
+    }
+  }
+
+  private def getBuildTimestamp : String = {
+    var stingResources : ResourceBundle = TextFormattingUtils.loadResourceBundle("StingText")
+
+    if ( stingResources.containsKey("build.timestamp") ) {
+      stingResources.getString("build.timestamp")
+    }
+    else {
+      "<unknown>"
+    }
+  }
+
   def shutdown() = {
     shuttingDown = true
     qGraph.shutdown()

From 12f09d88f91e6aded9e49f47b62f483925540483 Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 23 Nov 2011 16:08:18 -0500
Subject: [PATCH 112/113] Removing references to SimpleMetricsByAC

---
 .../sting/gatk/report/GATKReportUnitTest.java              | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/public/java/test/org/broadinstitute/sting/gatk/report/GATKReportUnitTest.java b/public/java/test/org/broadinstitute/sting/gatk/report/GATKReportUnitTest.java
index 02e1ba99a..f7be1d845 100644
--- a/public/java/test/org/broadinstitute/sting/gatk/report/GATKReportUnitTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/report/GATKReportUnitTest.java
@@ -44,12 +44,5 @@ public class GATKReportUnitTest extends BaseTest {
         Assert.assertEquals(validationReport.getVersion(), GATKReportVersion.V0_1);
         Object validationReportPK = countVariants.getPrimaryKey("none.eval.none.known");
         Assert.assertEquals(validationReport.get(validationReportPK, "sensitivity"), "NaN");
-
-        GATKReportTable simpleMetricsByAC = report.getTable("SimpleMetricsByAC.metrics");
-        Assert.assertEquals(simpleMetricsByAC.getVersion(), GATKReportVersion.V0_1);
-        Object simpleMetricsByACPK = simpleMetricsByAC.getPrimaryKey("none.eval.none.novel.ac2");
-        Assert.assertEquals(simpleMetricsByAC.get(simpleMetricsByACPK, "AC"), "2");
-
-        Assert.assertFalse(simpleMetricsByAC.containsPrimaryKey("none.eval.none.novel.ac2.bad"));
     }
 }

From e60272975ad88ef7138599ec88f61257c0b865ca Mon Sep 17 00:00:00 2001
From: Mark DePristo <depristo@broadinstitute.org>
Date: Wed, 23 Nov 2011 19:01:33 -0500
Subject: [PATCH 113/113] Fix for changed MD5 in streaming VCF test

---
 .../gatk/walkers/variantutils/VCFStreamingIntegrationTest.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/java/test/org/broadinstitute/sting/gatk/walkers/variantutils/VCFStreamingIntegrationTest.java b/public/java/test/org/broadinstitute/sting/gatk/walkers/variantutils/VCFStreamingIntegrationTest.java
index 00044f859..3a25bc5c1 100644
--- a/public/java/test/org/broadinstitute/sting/gatk/walkers/variantutils/VCFStreamingIntegrationTest.java
+++ b/public/java/test/org/broadinstitute/sting/gatk/walkers/variantutils/VCFStreamingIntegrationTest.java
@@ -98,7 +98,7 @@ public class VCFStreamingIntegrationTest extends WalkerTest {
             " -EV CompOverlap -noEV -noST" +
             " -o %s",
             1,
-            Arrays.asList("d46a735ffa898f4aa6b3758c5b03f06d")
+            Arrays.asList("1f7ed8c0f671dd227ab764624ef0d64c")
         );
         executeTest("testVCFStreamingChain", selectTestSpec);