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.

zпоследовательность

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

Примечание

Все значения в z должны быть конечными. Следовательно, значения nan и inf должны быть либо удалены, либо использовать set_mask.

levelsint или последовательность, необязательно

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

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

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

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

TriContourSet

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

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

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

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

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

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

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

Значение смешивания альфа-канала, от 0 (прозрачный) до 1 (непрозрачный).

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

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

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

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

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

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

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

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

vmin, vmaxчисло, необязательно

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который покрывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Недопустимо использовать vmin/vmax, когда задан экземпляр norm (но использование имени norm str вместе с 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{'ничего', 'обе', 'мин', 'макс'}, по умолчанию: 'ничего'

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

Если 'ничего', значения вне диапазона levels не окрашиваются. Если 'мин', 'макс' или 'обе', окрасьте значения ниже, выше или ниже и выше диапазона 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`