Update from scikit-bio/scikit-bio@094b166

Author: qiyunzhu

docs/dev/generated/skbio.stats.isubsample.html

@@ -698,7 +698,7 @@
 <h1>skbio.stats.isubsample<a class="headerlink" href="#skbio-stats-isubsample" title="Link to this heading">#</a></h1>
 <dl class="py function">
 <dt class="sig sig-object py" id="skbio.stats.isubsample">
-<span class="sig-prename descclassname"><span class="pre">skbio.stats.</span></span><span class="sig-name descname"><span class="pre">isubsample</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">items</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">buf_size</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1000</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bin_f</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference external" href="https://github.com/scikit-bio/scikit-bio/blob/main/skbio/stats/_subsample.py#L19"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#skbio.stats.isubsample" title="Link to this definition">#</a></dt>
+<span class="sig-prename descclassname"><span class="pre">skbio.stats.</span></span><span class="sig-name descname"><span class="pre">isubsample</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">items</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">buf_size</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1000</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bin_f</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference external" href="https://github.com/scikit-bio/scikit-bio/blob/main/skbio/stats/_subsample.py#L21"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#skbio.stats.isubsample" title="Link to this definition">#</a></dt>
 <dd><p>Randomly subsample items from bins, without replacement.</p>
 <p>Randomly subsample items without replacement from an unknown number of
 input items, that may fall into an unknown number of bins. This method is

docs/dev/generated/skbio.stats.subsample_counts.html

@@ -698,19 +698,21 @@
 <h1>skbio.stats.subsample_counts<a class="headerlink" href="#skbio-stats-subsample-counts" title="Link to this heading">#</a></h1>
 <dl class="py function">
 <dt class="sig sig-object py" id="skbio.stats.subsample_counts">
-<span class="sig-prename descclassname"><span class="pre">skbio.stats.</span></span><span class="sig-name descname"><span class="pre">subsample_counts</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">counts</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">replace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference external" href="https://github.com/scikit-bio/scikit-bio/blob/main/skbio/stats/_subsample.py#L150"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#skbio.stats.subsample_counts" title="Link to this definition">#</a></dt>
+<span class="sig-prename descclassname"><span class="pre">skbio.stats.</span></span><span class="sig-name descname"><span class="pre">subsample_counts</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">counts</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">replace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">seed</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference external" href="https://github.com/scikit-bio/scikit-bio/blob/main/skbio/stats/_subsample.py#L152"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#skbio.stats.subsample_counts" title="Link to this definition">#</a></dt>
 <dd><p>Randomly subsample from a vector of counts, with or without replacement.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><dl class="simple">
-<dt><strong>counts</strong><span class="classifier">1-D array_like</span></dt><dd><p>Vector of counts (integers) to randomly subsample from.</p>
+<dt><strong>counts</strong><span class="classifier">1-D array_like</span></dt><dd><p>Vector of counts (integers or floats) to randomly subsample from.</p>
 </dd>
 <dt><strong>n</strong><span class="classifier">int</span></dt><dd><p>Number of items to subsample from <cite>counts</cite>. Must be less than or equal
 to the sum of <cite>counts</cite>.</p>
 </dd>
 <dt><strong>replace</strong><span class="classifier">bool, optional</span></dt><dd><p>If <code class="docutils literal notranslate"><span class="pre">True</span></code>, subsample with replacement. If <code class="docutils literal notranslate"><span class="pre">False</span></code> (the default),
 subsample without replacement.</p>
 </dd>
+<dt><strong>seed</strong><span class="classifier">int or np.random.Generator, optional</span></dt><dd><p>A user-provided random seed or random generator instance.</p>
+</dd>
 </dl>
 </dd>
 <dt class="field-even">Returns<span class="colon">:</span></dt>
@@ -723,8 +725,6 @@ <h1>skbio.stats.subsample_counts<a class="headerlink" href="#skbio-stats-subsamp
 </dd>
 <dt class="field-odd">Raises<span class="colon">:</span></dt>
 <dd class="field-odd"><dl class="simple">
-<dt>TypeError</dt><dd><p>If <cite>counts</cite> cannot be safely converted to an integer datatype.</p>
-</dd>
 <dt>ValueError</dt><dd><p>If <cite>n</cite> is less than zero or greater than the sum of <cite>counts</cite>
 when <cite>replace=False</cite>.</p>
 </dd>

docs/dev/searchindex.js

@@ -735,7 +735,7 @@ <h2>Composition statistics<a class="headerlink" href="#composition-statistics" t
 <h2>Data subsampling<a class="headerlink" href="#data-subsampling" title="Link to this heading">#</a></h2>
 <div class="pst-scrollable-table-container"><table class="autosummary longtable table autosummary">
 <tbody>
-<tr class="row-odd"><td><p><a class="reference internal" href="generated/skbio.stats.subsample_counts.html#skbio.stats.subsample_counts" title="skbio.stats.subsample_counts"><code class="xref py py-obj docutils literal notranslate"><span class="pre">subsample_counts</span></code></a>(counts, n[, replace])</p></td>
+<tr class="row-odd"><td><p><a class="reference internal" href="generated/skbio.stats.subsample_counts.html#skbio.stats.subsample_counts" title="skbio.stats.subsample_counts"><code class="xref py py-obj docutils literal notranslate"><span class="pre">subsample_counts</span></code></a>(counts, n[, replace, seed])</p></td>
 <td><p>Randomly subsample from a vector of counts, with or without replacement.</p></td>
 </tr>
 <tr class="row-even"><td><p><a class="reference internal" href="generated/skbio.stats.isubsample.html#skbio.stats.isubsample" title="skbio.stats.isubsample"><code class="xref py py-obj docutils literal notranslate"><span class="pre">isubsample</span></code></a>(items, maximum[, minimum, ...])</p></td>