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.

Примечание

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

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

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

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

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

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

TriContourSet

Дополнительные параметры:

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

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

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

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

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

alphafloat, по умолчанию: 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, 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 заданы в вызове контура.

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`

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

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

Tricontour Smooth Delaunay

Tricontour Smooth User

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

Заполненный контурный график 3D треугольной сетки

tricontourf(x, y, z)

matplotlib.axes.Axes.tricontourf

Примечания

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

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