Deploying to gh-pages from @ 8af0ec0 🚀

Author: ken71301

.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 7c070df85c653b9c5deda6afc4036ae0
+config: 39e69bf6b640a58958a4e9434e1803ac
 tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/library/statistics.rst.txt

@@ -79,7 +79,7 @@ or sample.
 :func:`median`           Median (middle value) of data.
 :func:`median_low`       Low median of data.
 :func:`median_high`      High median of data.
-:func:`median_grouped`   Median, or 50th percentile, of grouped data.
+:func:`median_grouped`   Median (50th percentile) of grouped data.
 :func:`mode`             Single mode (most common value) of discrete or nominal data.
 :func:`multimode`        List of modes (most common values) of discrete or nominal data.
 :func:`quantiles`        Divide data into intervals with equal probability.
@@ -329,55 +329,56 @@ However, for reading convenience, most of the examples show sorted sequences.
    be an actual data point rather than interpolated.
 
 
-.. function:: median_grouped(data, interval=1)
+.. function:: median_grouped(data, interval=1.0)
 
-   Return the median of grouped continuous data, calculated as the 50th
-   percentile, using interpolation.  If *data* is empty, :exc:`StatisticsError`
-   is raised.  *data* can be a sequence or iterable.
+   Estimates the median for numeric data that has been `grouped or binned
+   <https://en.wikipedia.org/wiki/Data_binning>`_ around the midpoints
+   of consecutive, fixed-width intervals.
 
-   .. doctest::
+   The *data* can be any iterable of numeric data with each value being
+   exactly the midpoint of a bin.  At least one value must be present.
 
-      >>> median_grouped([52, 52, 53, 54])
-      52.5
+   The *interval* is the width of each bin.
 
-   In the following example, the data are rounded, so that each value represents
-   the midpoint of data classes, e.g. 1 is the midpoint of the class 0.5--1.5, 2
-   is the midpoint of 1.5--2.5, 3 is the midpoint of 2.5--3.5, etc.  With the data
-   given, the middle value falls somewhere in the class 3.5--4.5, and
-   interpolation is used to estimate it:
+   For example, demographic information may have been summarized into
+   consecutive ten-year age groups with each group being represented
+   by the 5-year midpoints of the intervals:
 
    .. doctest::
 
-      >>> median_grouped([1, 2, 2, 3, 4, 4, 4, 4, 4, 5])
-      3.7
-
-   Optional argument *interval* represents the class interval, and defaults
-   to 1.  Changing the class interval naturally will change the interpolation:
+      >>> from collections import Counter
+      >>> demographics = Counter({
+      ...    25: 172,   # 20 to 30 years old
+      ...    35: 484,   # 30 to 40 years old
+      ...    45: 387,   # 40 to 50 years old
+      ...    55:  22,   # 50 to 60 years old
+      ...    65:   6,   # 60 to 70 years old
+      ... })
+      ...
+
+   The 50th percentile (median) is the 536th person out of the 1071
+   member cohort.  That person is in the 30 to 40 year old age group.
+
+   The regular :func:`median` function would assume that everyone in the
+   tricenarian age group was exactly 35 years old.  A more tenable
+   assumption is that the 484 members of that age group are evenly
+   distributed between 30 and 40.  For that, we use
+   :func:`median_grouped`:
 
    .. doctest::
 
-      >>> median_grouped([1, 3, 3, 5, 7], interval=1)
-      3.25
-      >>> median_grouped([1, 3, 3, 5, 7], interval=2)
-      3.5
-
-   This function does not check whether the data points are at least
-   *interval* apart.
-
-   .. impl-detail::
-
-      Under some circumstances, :func:`median_grouped` may coerce data points to
-      floats.  This behaviour is likely to change in the future.
-
-   .. seealso::
+       >>> data = list(demographics.elements())
+       >>> median(data)
+       35
+       >>> round(median_grouped(data, interval=10), 1)
+       37.5
 
-      * "Statistics for the Behavioral Sciences", Frederick J Gravetter and
-        Larry B Wallnau (8th Edition).
+   The caller is responsible for making sure the data points are separated
+   by exact multiples of *interval*.  This is essential for getting a
+   correct result.  The function does not check this precondition.
 
-      * The `SSMEDIAN
-        <https://help.gnome.org/users/gnumeric/stable/gnumeric.html#gnumeric-function-SSMEDIAN>`_
-        function in the Gnome Gnumeric spreadsheet, including `this discussion
-        <https://mail.gnome.org/archives/gnumeric-list/2011-April/msg00018.html>`_.
+   Inputs may be any numeric type that can be coerced to a float during
+   the interpolation step.
 
 
 .. function:: mode(data)

_sources/reference/datamodel.rst.txt

@@ -299,14 +299,17 @@ Sequences
 These represent finite ordered sets indexed by non-negative numbers. The
 built-in function :func:`len` returns the number of items of a sequence. When
 the length of a sequence is *n*, the index set contains the numbers 0, 1,
-..., *n*-1.  Item *i* of sequence *a* is selected by ``a[i]``.
+..., *n*-1.  Item *i* of sequence *a* is selected by ``a[i]``. Some sequences,
+including built-in sequences, interpret negative subscripts by adding the
+sequence length. For example, ``a[-2]`` equals ``a[n-2]``, the second to last
+item of sequence a with length ``n``.
 
 .. index:: single: slicing
 
 Sequences also support slicing: ``a[i:j]`` selects all items with index *k* such
 that *i* ``<=`` *k* ``<`` *j*.  When used as an expression, a slice is a
-sequence of the same type.  This implies that the index set is renumbered so
-that it starts at 0.
+sequence of the same type. The comment above about negative indexes also applies
+to negative slice positions.
 
 Some sequences also support "extended slicing" with a third "step" parameter:
 ``a[i:j:k]`` selects all items of *a* with index *x* where ``x = i + n*k``, *n*

about.html

@@ -309,7 +309,7 @@ <h3>瀏覽</h3>
 <br />
     <br />
 
-    最後更新於 Mar 25, 2024 (16:39 UTC)。
+    最後更新於 Mar 26, 2024 (13:11 UTC)。
     <a href="/bugs.html">Found a bug</a>?
     <br />
 

bugs.html

@@ -345,7 +345,7 @@ <h3>瀏覽</h3>
 <br />
     <br />
 
-    最後更新於 Mar 25, 2024 (16:39 UTC)。
+    最後更新於 Mar 26, 2024 (13:11 UTC)。
     <a href="/bugs.html">Found a bug</a>?
     <br />
 

c-api/abstract.html

@@ -319,7 +319,7 @@ <h3>瀏覽</h3>
 <br />
     <br />
 
-    最後更新於 Mar 25, 2024 (16:39 UTC)。
+    最後更新於 Mar 26, 2024 (13:11 UTC)。
     <a href="/bugs.html">Found a bug</a>?
     <br />
 

c-api/allocation.html

@@ -333,7 +333,7 @@ <h3>瀏覽</h3>
 <br />
     <br />
 
-    最後更新於 Mar 25, 2024 (16:39 UTC)。
+    最後更新於 Mar 26, 2024 (13:11 UTC)。
     <a href="/bugs.html">Found a bug</a>?
     <br />
 

c-api/apiabiversion.html

@@ -365,7 +365,7 @@ <h3>瀏覽</h3>
 <br />
     <br />
 
-    最後更新於 Mar 25, 2024 (16:39 UTC)。
+    最後更新於 Mar 26, 2024 (13:11 UTC)。
     <a href="/bugs.html">Found a bug</a>?
     <br />
 

c-api/arg.html

@@ -876,7 +876,7 @@ <h3>瀏覽</h3>
 <br />
     <br />
 
-    最後更新於 Mar 25, 2024 (16:39 UTC)。
+    最後更新於 Mar 26, 2024 (13:11 UTC)。
     <a href="/bugs.html">Found a bug</a>?
     <br />
 

c-api/bool.html

@@ -330,7 +330,7 @@ <h3>瀏覽</h3>
 <br />
     <br />
 
-    最後更新於 Mar 25, 2024 (16:39 UTC)。
+    最後更新於 Mar 26, 2024 (13:11 UTC)。
     <a href="/bugs.html">Found a bug</a>?
     <br />