matplotlib.pyplot.tricontourf

matplotlib.pyplot.tricontourf(*args, **kwargs)[source]

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

Треугольная сетка может быть задана двумя способами; либо

tricontourf(triangulation, ...)

где triangulation — объект Triangulation, или

tricontourf(x, y, ...)
tricontourf(x, y, triangles, ...)
tricontourf(x, y, triangles=triangles, ...)
tricontourf(x, y, mask=mask, ...)
tricontourf(x, y, triangles, mask=mask, ...)

в этом случае будет создан объект Triangulation. См. строку документации этого класса для объяснения этих случаев.

Остальные аргументы могут быть:

tricontourf(..., Z)

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

tricontourf(..., Z, levels)

контур до levels+1 автоматически выбранных уровней контура (levels интервалов).

tricontourf(..., Z, levels)

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

tricontourf(Z, **kwargs)

Используйте ключевые аргументы для управления цветами, шириной линий, началом координат, cmap и т. д. Подробнее см. ниже.

Параметры

triangulationTriangulation, необязательно

Неструктурированная треугольная сетка.

Если указано, то x, y, triangles и mask не принимаются.

x, yмассив-подобные объекты, необязательно

Координаты значений в Z.

trianglesмассив (ntri, 3) целых чисел, необязательно

Для каждого треугольника индексы трёх точек, образующих треугольник, упорядоченные против часовой стрелки. Если не указано, вычисляется триангуляция Делоне.

maskмассив (ntri,) булевых значений, необязательно

Какие треугольники замаскированы.

Zдвумерный массив-подобный объект

Значения высот, по которым строится контур.

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

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

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

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

Возвращает

TriContourSet

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

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

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

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

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

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

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

Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный).

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

Объект Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровней с цветами.

Если заданы и colors, и cmap, возникает ошибка.

normNormalize, необязательно

Если используется цветовая карта, экземпляр Normalize масштабирует значения уровней до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не задан, используется линейное масштабирование по умолчанию.

vmin, vmaxвещественное число, необязательно

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

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.

antialiasedbool, необязательно

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

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

Список шаблонов штриховки, которые следует использовать для заполненных областей. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в графических библиотеках PostScript, PDF, SVG и Agg.

Примечания

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

z1 < Z <= z2

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