summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Doc/library/statistics.rst4
1 files changed, 3 insertions, 1 deletions
diff --git a/Doc/library/statistics.rst b/Doc/library/statistics.rst
index 3a2a1f94db..bb77228cea 100644
--- a/Doc/library/statistics.rst
+++ b/Doc/library/statistics.rst
@@ -313,7 +313,9 @@ However, for reading convenience, most of the examples show sorted sequences.
measure of central location.
If there are multiple modes, returns the first one encountered in the *data*.
- If *data* is empty, :exc:`StatisticsError` is raised.
+ If the smallest or largest of multiple modes is desired instead, use
+ ``min(multimode(data))`` or ``max(multimode(data))``. If the input *data* is
+ empty, :exc:`StatisticsError` is raised.
``mode`` assumes discrete data, and returns a single value. This is the
standard treatment of the mode as commonly taught in schools: