numpy.histogram

numpy.histogram(a, bins=10, range=None, normed=False, weights=None, density=None) [source]

Вычисление гистограммы набора данных.

Параметры:

a : array_like Входные данные. Гистограмма вычисляется для уплощенного массива. bins : int или последовательность скаляров, необязательно Если bins — целое число, оно определяет количество равномерных бинов в заданном диапазоне (10 по умолчанию). Если bins — последовательность, она определяет границы бинов, включая правую границу, что позволяет использовать неравномерную ширину бинов. range : (float, float), необязательно Диапазон значений бинов (нижняя и верхняя границы). Если не указан, диапазон — просто (a.min(), a.max()). Значения за пределами диапазона игнорируются. normed : bool, необязательно Этот параметр устарел в Numpy 1.6 из-за непонятного/ошибочного поведения. Он будет удален в Numpy 2.0. Используйте параметр density вместо него. Если False, результат будет содержать количество образцов в каждом бине. Если True, результат — значение функции плотности вероятности в бине, нормированное так, что интеграл по диапазону равен 1. Обратите внимание, что это поведение известно как ошибочное при неравномерной ширине бинов; используйте density вместо него. weights : array_like, необязательно Массив весов, имеющий такую же форму, как и a. Каждое значение в a вносит только свой связанный вес в счет бина (вместо 1). Если normed равно True, веса нормируются, так что интеграл плотности по диапазону остается равным 1. density : bool, необязательно Если False, результат будет содержать количество образцов в каждом бине. Если True, результат — значение функции плотности вероятности в бине, нормированное так, что интеграл по диапазону равен 1. Обратите внимание, что сумма значений гистограммы не будет равна 1, если не выбраны бины единичной ширины; это не функция вероятностной массы. Переопределяет параметр normed в случае его задания.

Возвращает:

hist : массив Значения гистограммы. См. normed и weights для описания возможных семантик. bin_edges : массив типа float Возвращает границы бинов (length(hist)+1).

См. также

histogramdd, bincount, searchsorted, digitize

Примечания

Все бины (кроме последнего), за исключением правого, являются полуоткрытыми. Другими словами, если bins:

[1, 2, 3, 4]

то первый бин — [1, 2) (включая 1, но исключая 2), а второй — [2, 3). Однако последний бин — [3, 4], который включает 4.

Примеры

>>> np.histogram([1, 2, 1], bins=[0, 1, 2, 3])
(array([0, 2, 1]), array([0, 1, 2, 3]))
>>> np.histogram(np.arange(4), bins=np.arange(5), density=True)
(array([ 0.25,  0.25,  0.25,  0.25]), array([0, 1, 2, 3, 4]))
>>> np.histogram([[1, 2, 1], [1, 0, 1]], bins=[0,1,2,3])
(array([1, 4, 1]), array([0, 1, 2, 3]))

>>> a = np.arange(5)
>>> hist, bin_edges = np.histogram(a, density=True)
>>> hist
array([ 0.5,  0. ,  0.5,  0. ,  0. ,  0.5,  0. ,  0.5,  0. ,  0.5])
>>> hist.sum()
2.4999999999999996
>>> np.sum(hist*np.diff(bin_edges))
1.0