matplotlib.pyplot.tricontourf

matplotlib.pyplot.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

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

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

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

Этот параметр игнорируется, если задано 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, необязательно

Локатор используется для определения уровней контура, если они не заданы явно через 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, штриховка не будет добавлена к контуру.

Примечания

Примечание

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

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

z1 < Z <= z2

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

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

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

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

Демонстрация триконтурного графика

Демонстрация триконтурного графика

Гладкий триконтурный график по Делоне

Гладкий триконтурный график по Делоне

Гладкий триконтурный график (пользовательский)

Гладкий триконтурный график (пользовательский)

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

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