matplotlib.axes.Axes.tricontourf

Axes.tricontourf(*args, **kwargs)[исходный код]

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

Сигнатуры вызова:

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 или массивоподобный объект, необязательный

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

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

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

Возвращает:

TriContourSet

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

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

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

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

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

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

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

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

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

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

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

normstr или 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 типа str вместе с vmin/vmax).

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

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

origin{None, 'upper', 'lower', 'image'}, по умолчанию: None

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

None: z[0, 0] находится в точке X=0, Y=0 в нижнем левом углу.
'lower': z[0, 0] находится в точке X=0.5, Y=0.5 в нижнем левом углу.
'upper': z[0, 0] находится в точке X=N+0.5, Y=0.5 в верхнем левом углу.
'image': Используется значение из 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].

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

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

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

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

Определяет окрашивание tricontourf значений, выходящих за пределы диапазона 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).

hatcheslist[str], необязательный

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

Примечания

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

z1 < Z <= z2

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

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

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

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

Сглаживание tricontour методом Делоне

Сглаживание tricontour на пользовательской сетке

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

Трехмерный график залитых контуров на треугольной сетке

tricontourf(x, y, z)

matplotlib.axes.Axes.tricontourf

Примечания

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

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