matplotlib.pyplot.hist2d

matplotlib.pyplot.hist2d(x, y, bins=10, range=None, density=False, weights=None, cmin=None, cmax=None, *, data=None, **kwargs)[source]

Построение двумерной гистограммы.

Параметры:	x, yмассив-подобный объект, форма (n, ) Вводные значения binsNone или int или [int, int] или массив-подобный объект или [массив, массив] Указание бинов: Если int, число бинов для двух измерений (nx=ny=bins). Если [int, int], число бинов в каждом измерении (nx, ny = bins). Если массив-подобный объект, границы бинов для двух измерений (x_edges=y_edges=bins). Если [array, array], границы бинов в каждом измерении (x_edges, y_edges = bins). Значение по умолчанию равно 10. rangeмассив-подобный объект формы (2, 2), необязательно Левая и правая границы бинов для каждого измерения (если не указаны явно в параметре bins): [[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учтены в гистограмме. densitybool, по умолчанию: False Нормализация гистограммы. Подробнее см. документацию параметра density для hist. weightsмассив-подобный объект, форма (n, ), необязательно Массив значений w_i, весящих каждую выборку (x_i, y_i). cmin, cmaxfloat, по умолчанию: None Все бины, содержащие количество меньше cmin или больше cmax, не будут отображаться (устанавливаются в NaN перед передачей в imshow), и эти значения количества в возвращаемой гистограмме также будут установлены в nan при возвращении.
Возвращает:	h2D массив Двумерная гистограмма выборок x и y. Значения в x гистограммируются по первому измерению, а значения в y гистограммируются по второму измерению. xedges1D массив Границы бинов по оси x. yedges1D массив Границы бинов по оси y. imageQuadMesh
Другие параметры:	cmapColormap или str, необязательно Объект colors.Colormap. Если не задано, используется значение по умолчанию из rc настроек. normNormalize, необязательно Объект colors.Normalize используется для масштабирования данных яркости до [0, 1]. Если не задано, используется по умолчанию colors.Normalize(). vmin/vmaxNone или скаляр, необязательно Аргументы, передаваемые объекту Normalize. alpha0 <= scalar <= 1 или None, необязательно Значение альфа-смешивания. **kwargs Дополнительные параметры передаются в метод pcolormesh и конструктор QuadMesh.

См. также

hist

Построение 1D гистограммы

Примечания

• В настоящее время hist2d рассчитывает собственные пределы осей, и любые ранее установленные пределы игнорируются.
• Для отображения гистограммы с логарифмической шкалой цвета необходимо передать объект colors.LogNorm в качестве аргумента norm. Аналогично, нормализацию по степенной функции (аналогично коррекции гамма-каналов) можно выполнить с помощью colors.PowerNorm.

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключения): x, y, weights.

Объекты, переданные как data, должны поддерживать доступ по индексу (data[s]) и проверку на принадлежность (s in data).

Примеры использования matplotlib.pyplot.hist2d