matplotlib.axes.Axes.tricontour

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

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

Варианты вызова:

tricontour(triangulation, z, [levels], ...)
tricontour(x, y, z, [levels], *, [triangles=triangles], [mask=mask], ...)

Треугольная сетка может быть задана, либо передав объект Triangulation в качестве первого параметра, либо передав точки x, y и, необязательно, triangles и mask. См. Triangulation для объяснения этих параметров. Если ни triangulation, ни triangles не заданы, триангуляция вычисляется на лету.

Возможна передача triangles позиционно, т.е. tricontour(x, y, triangles, z, ...). Однако, это не рекомендуется. Для большей ясности, передавайте triangles через ключевой аргумент.

Параметры:

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

Уже созданная треугольная сетка.

x, y, triangles, mask

Параметры, определяющие треугольную сетку. См. Triangulation. Это взаимно исключающие параметры с указанием triangulation.

zпоследовательность

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

Примечание

Все значения в z должны быть конечными. Таким образом, значения nan и inf должны быть удалены или использовать set_mask.

levelsцелое число или последовательность, необязательно

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

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

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

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

TriContourSet

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

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

Цвета уровней, т.е. линий контура.

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

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

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

alphaчисло, по умолчанию: 1

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

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр цветовой карты или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

Этот параметр игнорируется, если задан параметр colors.

normстрока или Normalize, необязательно

Метод нормализации, используемый для масштабирования скалярных данных до диапазона [0, 1] перед сопоставлением с цветами с помощью cmap. По умолчанию используется линейное масштабирование, сопоставляющее наименьшее значение с 0, а наибольшее с 1.

Если задано, может быть одним из следующих:

• Экземпляр Normalize или один из его подклассов (см. Нормализация цветовых карт).
• Имя шкалы, например, «линейное», «логарифмическое», «симметричное логарифмическое», «логит» и т. д. Список доступных шкал можно получить, вызвав matplotlib.scale.get_scale_names(). В этом случае динамически генерируется и создается подходящий подкласс Normalize.

Этот параметр игнорируется, если задан параметр colors.

vmin, vmaxчисло, необязательно

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

Локатор используется для определения уровней контура, если они не заданы явно через 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

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

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

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

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

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

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

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

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

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

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

Трехмерная контурная диаграмма треугольника

Трехмерная контурная диаграмма треугольника

tricontour(x, y, z)

tricontour(x, y, z)