matplotlib.pyplot.hist2d
-
matplotlib.pyplot.hist2d(x, y, bins=10, range=None, normed=False, weights=None, cmin=None, cmax=None, hold=None, data=None, **kwargs) -
Построение 2D гистограммы.
Параметры: x, y: массив, форма (n, )
Входные значения
bins: [None | int | [int, int] | массив | [массив, массив]]
Параметры разбиения:
- Если int, количество бинов для двух измерений (nx=ny=bins).
- Если [int, int], количество бинов в каждом измерении (nx, ny = bins).
- Если массив, границы бинов для двух измерений (x_edges=y_edges=bins).
- Если [массив, массив], границы бинов в каждом измерении (x_edges, y_edges = bins).
Значение по умолчанию равно 10.
range : массив формы (2, 2), необязательно, по умолчанию: None
Левая и правая границы бинов по каждому измерению (если не указаны явно в параметрах bins): [[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учтены в гистограмме.
normed : boolean, необязательно, по умолчанию: False
Нормализация гистограммы.
weights : массив, форма (n, ), необязательно, по умолчанию: None
Массив значений w_i, взвешивающих каждую выборку (x_i, y_i).
cmin : скаляр, необязательно, по умолчанию: None
Все бины с количеством элементов меньше cmin не будут отображаться, а эти значения в возвращаемой гистограмме будут установлены в nan после возврата
cmax : скаляр, необязательно, по умолчанию: None
Все бины с количеством элементов больше cmax не будут отображаться (устанавливаются в none перед передачей в imshow), а эти значения в возвращаемой гистограмме будут установлены в nan после возврата
Возвращает: Значение возврата —
(counts, xedges, yedges, Image).Другие параметры: cmap : {Цветовая карта, строка}, необязательно
Экземпляр
matplotlib.colors.Colormap. Если не задано, используются настройки rc.norm : Нормализация, необязательно
Экземпляр
matplotlib.colors.Normalizeиспользуется для масштабирования данных яркости до[0, 1]. Если не задано, используется значение по умолчаниюNormalize().vmin/vmax : {None, скаляр}, необязательно
Аргументы, передаваемые в экземпляр
Normalize.alpha :
0 <= scalar <= 1илиNone, необязательноЗначение смешивания альфа-канала.
См. также
-
hist - 1D гистограмма
Примечания
Отображение гистограммы с логарифмической цветовой шкалой достигается путем передачи экземпляра
colors.LogNormв качестве аргумента norm. Аналогично, нормализация по степенному закону (похожая по эффекту на коррекцию гамма-каналов) может быть реализована с помощьюcolors.PowerNorm.Примечание
Помимо описанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все аргументы с такими именами: ‘weights’, ‘x’, ‘y’.
© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/_as_gen/matplotlib.pyplot.hist2d.html