Сообщить об ошибке.

Функция mode() модуля statistics в Python, распространенный элемент

Наиболее распространенный элемент последовательности

Синтаксис:

import statistics

statistics.mode(data)

Параметры:

  • data - данные, последовательность или итерация.

Возвращаемое значение:

  • единственный наиболее распространенный элемент данных data.

Описание:

Функция mode() модуля statistics возвращает единственный наиболее распространенный элемент данных data из дискретных или номинальных данных.

Значение функции statistics.mode() (если оно существует) является наиболее типичным значением и служит мерой центрального расположения последовательности.

Если в последовательности существует несколько значений с одинаковой частотой распространения, то эта функция возвращает первый из них. Если предпочтительнее получить наибольшее или наименьшее из них, то для этого необходимо использовать выражение max(multimode(data)) или min(multimode(data)) соответственно. Дополнительно смотрите функцию statistics.multimode().

Аргумент data может быть последовательностью или итерацией. Если входные данные data пусты, то возникает ошибка StatisticsError.

Функция statistics.mode() принимает дискретные данные и возвращает одно значение. Это стандартная трактовка значения mode, как преподается в школах:

>>> statistics.mode([1, 1, 2, 3, 3, 3, 3, 4])
# 3

Функция statistics.mode() уникальна тем, что является единственной в этом пакете, которая также применяется к номинальным (нечисловым) данным:

>>> statistics.mode(["red", "blue", "blue", "red", "green", "red", "red"])
# 'red'

Изменено в Python 3.8: теперь обрабатывает мультимодальные наборы данных, возвращая первое обнаруженное значение. Раньше такое поведение вызывало ошибку StatisticsError, когда обнаруживалось более одного значения.