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
, когда обнаруживалось более одного значения.