code: public void populate(List<Partition<T>> partitions,
  			Iterator<T> itr) {
  		int idx = 0;
  		int size = partitions.size();
  		T element = null;
  		while(idx < size) {
  			Partition<T> partition = partitions.get(idx);
  			if(element == null) {
  				if(itr.hasNext()) {
  					element = itr.next();
  				} else {
  					// all done
  					break;
  				}
  			}
  			// will current result fit in the current partition?
  			while(partition.containsDate(map.elementToDate(element))) {
  				map.addElementToPartition(element, partition);
  				element = null;
  				if(itr.hasNext()) {
  					element = itr.next();
  				} else {
  					break;
  				}
  			}
  			idx++;
  		}
  		if(itr.hasNext()) {
  			// eew... Likely bad usage. is this an error?
  			LOGGER.warning("Not all elements fit in partitions!");
  		}
  	}
docs: Add elements from itr into the appropriate partitions. Assumes that
  all elements fit in one of the argument Partitions, that the partitions
  are in ascending order by time, and that elements returned from the
  Iterator are in ascending time order.
  
  @param partitions to populate with objects
  @param itr ascending Iterator of objects to place into the partitions