matplotlib.axes.Axes.tricontourf

Axes.tricontourf(*args, **kwargs)[source]

Отображение областей контура на неструктурированной треугольной сетке.

Вызовы:

tricontourf(triangulation, Z, [levels], ...)
tricontourf(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)

Треугольная сетка может быть задана либо путем передачи объекта Triangulation в качестве первого параметра, либо путем передачи точек x, y и необязательно triangles и mask. См. Triangulation для объяснения этих параметров. Если ни triangulation, ни triangles не заданы, триангуляция рассчитывается на лету.

Возможна позиционная передача triangles, т.е. tricontourf(x, y, triangles, Z, ...). Однако это не рекомендуется. Для большей ясности передавайте triangles в качестве именованного аргумента.

Параметры:

triangulationTriangulation, необязательно

Уже созданная треугольная сетка.

x, y, triangles, mask

Параметры, определяющие треугольную сетку. См. Triangulation. Это взаимоисключающие параметры с параметром triangulation.

Zarray-like

Значения высот, по которым строится контур. Отображение цвета контролируется параметрами cmap, norm, vmin и vmax.

levelsint или array-like, необязательно

Определяет количество и позиции линий/областей контура.

Если int n, используется MaxNLocator, который пытается автоматически выбрать не более n+1 «приятных» уровней контура между vmin и vmax.

Если array-like, рисует линии контура на указанных уровнях. Значения должны быть в порядке возрастания.

Возвращаемое значение:

TriContourSet

Другие параметры:

colorsстрока цвета или последовательность цветов, необязательно

Цвета уровней, т.е. областей контура.

Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется.

В качестве сокращения могут использоваться одиночные строки цветов вместо списков из одного элемента, т.е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов задания цветов.

По умолчанию (значение None) используется цветовая карта, заданная параметром cmap.

alphafloat, по умолчанию: 1

Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный).

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

Этот параметр игнорируется, если задан параметр colors.

normстрока или Normalize, необязательно

Метод нормализации, используемый для масштабирования скалярных данных в диапазон [0, 1] перед отображением цветов с помощью cmap. По умолчанию используется линейное масштабирование, сопоставляющее минимальное значение с 0, а максимальное - с 1.

Если задано, это может быть одно из следующих:

Экземпляр Normalize или один из его подклассов (см. Нормализация цветовых карт).
Имя шкалы, например, «linear», «log», «symlog», «logit» и т.д. Список доступных шкал можно получить, вызвав matplotlib.scale.get_scale_names(). В этом случае динамически генерируется и создается соответствующий подкласс Normalize.

Этот параметр игнорируется, если задан параметр colors.

vmin, vmaxfloat, необязательно

При использовании скалярных данных и отсутствии явного параметра norm, vmin и vmax определяют диапазон данных, который охватывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Использование vmin/vmax при заданном экземпляре norm является ошибкой (но использование строки norm вместе с vmin/vmax допустимо).

Если vmin или vmax не заданы, по умолчанию масштабирование цвета основано на levels.

Этот параметр игнорируется, если задан параметр colors.

origin{None, 'верхний', 'нижний', 'изображение'}, по умолчанию: None

Определяет ориентацию и точное расположение Z, задавая положение Z[0, 0]. Это актуально только если X и Y не заданы.

None: Z[0, 0] находится в левом нижнем углу при X=0, Y=0.
'нижний': Z[0, 0] находится в левом нижнем углу при X=0.5, Y=0.5.
'верхний': Z[0, 0] находится в левом верхнем углу при X=N+0.5, Y=0.5.
'изображение': Использовать значение из rcParams["image.origin"] (по умолчанию: 'upper').

extent(x0, x1, y0, y1), необязательно

Если origin не None, то extent интерпретируется так же, как в imshow: он задаёт границы внешних пикселей. В этом случае положение Z[0, 0] - центр пикселя, а не угол. Если origin - None, то (x0, y0) - положение Z[0, 0], а (x1, y1) - положение Z[-1, -1].

Этот аргумент игнорируется, если X и Y заданы в вызове contour.

locatorподкласс ticker.Locator, необязательно

Locator используется для определения уровней контура, если они не заданы явно через levels. По умолчанию MaxNLocator.

extend{'neither', 'both', 'min', 'max'}, по умолчанию: 'neither'

Определяет окраску значений, которые находятся за пределами диапазона levels.

Если 'neither', значения за пределами диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрасить значения ниже, выше или ниже и выше диапазона levels.

Значения ниже min(levels) и выше max(levels) отображаются как под/над значения цветовой карты Colormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения под и над - это крайние значения цветовой карты. Вы можете явно задать эти значения, используя Colormap.set_under и Colormap.set_over.

Примечание

Существующий TriContourSet не получает уведомлений о изменениях свойств его цветовой карты. Поэтому необходимо явное обращение к ContourSet.changed() после изменения цветовой карты. Явное обращение можно пропустить, если цветовой панели присвоена TriContourSet, поскольку она внутренне вызывает ContourSet.changed().

xunits, yunitsзарегистрированные единицы, необязательно

Переопределяет единицы осей, указав экземпляр matplotlib.units.ConversionInterface.

antialiasedbool, необязательно

Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию - True. Для линий контура оно берется из rcParams["lines.antialiased"] (по умолчанию: True).

hatchesсписок[строка], необязательно

Список узоров штриховки для использования на заполненных областях. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

tricontourf заполняет интервалы, которые закрыты сверху; то есть для границ z1 и z2 заполненная область имеет вид:

z1 < Z <= z2

за исключением нижнего интервала, который закрыт с обеих сторон (т.е. включает минимальное значение).

Примеры использования `matplotlib.axes.Axes.tricontourf`

Контурная диаграмма неравномерно расположенных данных

Демонстрация триконтура

Триконтур Гладкий Пользовательский

Заполненная контурная диаграмма в 3D с треугольниками

tricontourf(x, y, z)

matplotlib.axes.Axes.tricontourf

Примечания

Примеры использования matplotlib.axes.Axes.tricontourf

Примеры использования `matplotlib.axes.Axes.tricontourf`