Uneven subsample

This PR came about from needing a solution to the following problem:

- given demultiplexed sequences, where you do not know the number of sequences, samples or sequences per sample
- randomly keep up to `k` sequences (as opposed to exactly `k` sequences)

In other words, we want to randomly select up to `k` items from bin `n_i`, where `k` is the number of items, `n` is the number of bins, and `i` is the bin number. We need to allow for the case where bin `n_i` does not have `k` items, and still return it (which is the primary difference with `subsample`).

I don't know if `uneven_subsample` is the best name for this and would be curious to hear opinions. The method has been generalized from our need in qiita so it can be applied to arbitrary iterators.  

This method takes a similar approach to Fisher-Yates in that each item can only be "swapped" a single time, and it should be assured that each sequence within each bin has an equal probability of being retained regardless of the number of sequences or the number of bins.  
Done

On Tue, Nov 18, 2014 at 9:02 AM, Jai Ram Rideout <notifications@github.com>
wrote:

> In skbio/stats/_subsample.py:
>
> > @@ -19,6 +24,123 @@
> >      pass
> >
> >
> > +def subsample_items(items, maximum, minimum=1, buf_size=1000, bin_f=None):
> > +    """Get a random subset of items per bin
> > +
>
> Can you add a longer description of what this function does? For instance,
> does it subsample with or without replacement, how this function differs
> from subsample, when would you use one vs. the other, etc.
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/biocore/scikit-bio/pull/657/files#r20514856>.
>