Spec-Zone.ru › Matplotlib 3.3

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)

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

Параметры:
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.pyplot.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

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

Spec-Zone.ru

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