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.

Zarray-like

Значения высоты, по которым выполняется построение контура. Отображение цветов контролируется параметрами cmap, norm, vmin и vmax.

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

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

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

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

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

TriContourSet

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

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

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

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

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

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

alphafloat, по умолчанию: 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, vmaxfloat, необязательно

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

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).

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

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

Примечания

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

z1 < Z <= z2

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