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.

levelsцелое число или подобный массиву, необязательно

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

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

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

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

TriContourSet

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

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

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

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

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

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

alphaвещественное число, по умолчанию: 1

Значение прозрачности (alpha) для смешивания цветов, от 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 вместе с 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.

antialiasedлогическое значение, необязательно

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

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

Список штрихов для заполненных областей. Если None, штрихи не будут добавлены к контуру.

Примечания

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`