numpy.histogramdd

numpy.histogramdd(sample, bins=10, range=None, normed=None, weights=None, density=None) [source]

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

Параметры

sample(N, D) array, or (D, N) array_like

Данные для построения гистограммы.

Обратите внимание на необычное толкование образца при использовании array_like:

• Когда это массив, каждая строка — это координата в D-мерном пространстве — например, histogramdd(np.array([p1, p2, p3])).
• Когда это array_like, каждый элемент — это список значений для отдельной координаты — например, histogramdd((X, Y, Z)).

Следует отдавать предпочтение первому варианту.

binssequence or int, optional

Описание бинов:

• Последовательность массивов, описывающих монотонно возрастающие границы бинов вдоль каждой размерности.
• Число бинов для каждой размерности (nx, ny, … =bins).
• Число бинов для всех размерностей (nx=ny=…=bins).

rangesequence, optional

Последовательность длины D, каждый элемент — необязательная кортеж (нижний, верхний), задающий внешние границы бинов, которые должны использоваться, если границы не заданы явно в bins. Вход None в последовательности приводит к использованию минимальных и максимальных значений для соответствующей размерности. По умолчанию, None, эквивалентно передаче кортежа из D значений None.

densitybool, optional

Если False, по умолчанию, возвращает число образцов в каждом бине. Если True, возвращает плотность вероятности в бине, bin_count / sample_count / bin_volume.

normedbool, optional

Псевдоним для аргумента density, который ведет себя идентично. Чтобы избежать путаницы с нарушенным аргументом normed для histogram, следует отдавать предпочтение density.

weights(N,) array_like, optional

Массив значений w_i, взвешивающих каждый образец (x_i, y_i, z_i, …). Веса нормализуются до 1, если normed=True. Если normed=False, значения возвращаемой гистограммы равны сумме весов, относящихся к образцам, попадающим в каждый бино.

Возвращает

Hndarray

Многомерная гистограмма образцов x. См. normed и weights для различных возможных семантик.

edgeslist

Список из D массивов, описывающих границы бинов для каждой размерности.

См. также

histogram

Гистограмма 1-го порядка

histogram2d

Гистограмма 2-го порядка

Примеры

>>> r = np.random.randn(100,3)
>>> H, edges = np.histogramdd(r, bins = (5, 8, 4))
>>> H.shape, edges[0].size, edges[1].size, edges[2].size
((5, 8, 4), 6, 9, 5)