Spec-Zone.ru › Matplotlib 3.3

matplotlib.axes.Axes.tricontourf

Axes.tricontourf(ax, *args, **kwargs)

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

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

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)

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

Параметры:
triangulationTriangulation, optional

Неупорядоченная треугольная сетка.

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

x, yarray-like, optional

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

trianglesint array-like of shape (ntri, 3), optional

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

maskbool array-like of shape (ntri), optional

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

Zarray-like(N, M)

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

levelsint or array-like, optional

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

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

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

Возвращает:
TriContourSet
Другие параметры:
colorscolor string or sequence of colors, optional

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

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

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

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

alphafloat, default: 1

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

cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis')

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

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

normNormalize, optional

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

origin{None, 'upper', 'lower', 'image'}, default: 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), optional

Если origin не равно None, то extent интерпретируется как в imshow: он задает внешние границы пикселей. В этом случае положение Z[0, 0] — центр пикселя, а не угол. Если origin равно None, то (x0, y0) — положение Z[0, 0], а (x1, y1) — положение Z[-1, -1].

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

locatorticker.Locator subclass, optional

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

extend{'neither', 'both', 'min', 'max'}, default: '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, yunitsregistered units, optional

Переопределение единиц осей путем указания экземпляра matplotlib.units.ConversionInterface.

antialiasedbool, default: True

Использовать ли сглаживание?

Примечания

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

z1 < Z <= z2

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

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

Contour plot of irregularly spaced data

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

Tricontour Demo

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

Tricontour Smooth Delaunay

Tricontour Гладкий Делоне

Tricontour Smooth User

Tricontour Гладкий Пользовательский

END_OF_DOCUMENT_MARKER
Triinterp Demo

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

Triangular 3D filled contour plot

Заполненная контурная диаграмма в 3D для треугольника

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/matplotlib.axes.Axes.tricontourf.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API