matplotlib.pyplot.tricontourf

matplotlib.pyplot.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, необязательный

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

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

Определяет tricontourf-окрашивание значений, выходящих за пределы диапазона levels.

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

Значения ниже min(levels) и выше max(levels) преобразуются в значения under/over цветовой карты Colormap. Обратите внимание: у большинства цветовых карт по умолчанию нет специальных цветов для этих значений, поэтому для значений over и under используются крайние цвета цветовой карты. При необходимости эти значения можно задать явно с помощью 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, штриховка для контура добавлена не будет.

Примечания

Примечание

Это обёртка pyplot для axes.Axes.tricontourf.

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

z1 < Z <= z2

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

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

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

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

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

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

Сглаженный tricontour Delaunay

Сглаженный tricontour Delaunay

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

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

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

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