matplotlib.axes.Axes.tricontour

Axes.tricontour(*args, **kwargs)[source]

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

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

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)

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

Параметры

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

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

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

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

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

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

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

maskмассив (ntri,) bool, необязательно

Треугольники, которые будут замаскированы.

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

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

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

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

Если целое число 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, необязательно

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

extend{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего'

Определяет tricontour-окраску значений, которые находятся за пределами диапазона 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).

linewidthsчисло или массив-подобный объект, по умолчанию: rcParams["contour.linewidth"] (по умолчанию: None)

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

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

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

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

linestyles{None, 'сплошная', 'штриховая', 'штрихпунктирная', 'пунктирная'}, необязательно

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

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

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