Spec-Zone.ru › Matplotlib 3.3

matplotlib.axes.Axes.tricontour

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

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

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

tricontour(triangulation, ...)

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

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

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

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

tricontour(..., Z)

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

tricontour(..., Z, levels)

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

tricontour(..., Z, levels)

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

tricontour(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'

Определяет tricontour-окраску значений, которые находятся вне диапазона levels.

Если 'neither', значения вне диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрашиваются значения меньше, больше или меньше и больше диапазона levels.

Значения ниже min(levels) и выше max(levels) отображаются на значения 'under'/'over' цветовой карты Colormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения over и under — это крайние значения цветовой карты. Вы можете явно задать эти значения с помощью Colormap.set_under и Colormap.set_over.

Примечание

Существующий TriContourSet не уведомляется о изменениях свойств его цветовой карты. Поэтому после изменения цветовой карты необходимо выполнить явный вызов ContourSet.changed(). Явный вызов можно пропустить, если к TriContourSet прикреплена цветовая шкала, поскольку она автоматически вызывает ContourSet.changed().

xunits, yunitsregistered units, optional

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

linewidthsfloat or array-like, default: rcParams["contour.linewidth"] (default: None)

Ширина линий контура.

Если число, все уровни будут нарисованы с этой шириной.

Если последовательность, уровни в порядке возрастания будут нарисованы с ширинами линий в указанном порядке.

Если None, используется значение по умолчанию rcParams["lines.linewidth"] (по умолчанию 1.5).

linestyles{None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional

Если linestyles равно None, по умолчанию используется 'solid', если линии не монохромные. В этом случае отрицательные контуры получат стиль линии из rcParams["contour.negative_linestyle"] (по умолчанию 'dashed').

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

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

Contour plot of irregularly spaced data

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

Tricontour Demo

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

Tricontour Smooth Delaunay

Tricontour Smooth Delaunay

Tricontour Smooth User

Tricontour Smooth User

END_OF_DOCUMENT_MARKER
Trigradient Demo

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

Triangular 3D 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.tricontour.html

Spec-Zone.ru

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