Issue #27181 remove geometric_mean and defer for 3.7.

Doc/library/statistics.rst

@@ -39,7 +39,6 @@ or sample.
 
 =======================  =============================================
 :func:`mean`             Arithmetic mean ("average") of data.
-:func:`geometric_mean`   Geometric mean of data.
 :func:`harmonic_mean`    Harmonic mean of data.
 :func:`median`           Median (middle value) of data.
 :func:`median_low`       Low median of data.
@@ -113,34 +112,6 @@ However, for reading convenience, most of the examples show sorted sequences.
       ``mean(data)`` is equivalent to calculating the true population mean μ.
 
 
-.. function:: geometric_mean(data)
-
-   Return the geometric mean of *data*, a sequence or iterator of
-   real-valued numbers.
-
-   The geometric mean is the *n*-th root of the product of *n* data points.
-   It is a type of average, a measure of the central location of the data.
-
-   The geometric mean is appropriate when averaging quantities which
-   are multiplied together rather than added, for example growth rates.
-   Suppose an investment grows by 10% in the first year, falls by 5% in
-   the second, then grows by 12% in the third, what is the average rate
-   of growth over the three years?
-
-   .. doctest::
-
-      >>> geometric_mean([1.10, 0.95, 1.12])
-      1.0538483123382172
-
-   giving an average growth of 5.385%. Using the arithmetic mean will
-   give approximately 5.667%, which is too high.
-
-   :exc:`StatisticsError` is raised if *data* is empty, or any
-   element is less than zero.
-
-   .. versionadded:: 3.6
-
-
 .. function:: harmonic_mean(data)
 
    Return the harmonic mean of *data*, a sequence or iterator of

Misc/NEWS

@@ -50,6 +50,8 @@ Core and Builtins
 Library
 -------
 
+- Issue #27181 remove statistics.geometric_mean and defer until 3.7.
+
 - Issue #28229: lzma module now supports pathlib.
 
 - Issue #28321: Fixed writing non-BMP characters with binary format in plistlib.