matplotlib.pyplot.tricontour

matplotlib.pyplot.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.

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

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

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

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

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

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 или один из его подклассов (см. Нормализация цветовых карт).
• Имя шкалы, например, "linear", "log", "symlog", "logit" и т.д. Список доступных шкал можно получить, вызвав 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, 'upper', 'lower', 'image'}, по умолчанию: 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), необязательно

Если 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{'neither', 'both', 'min', 'max'}, по умолчанию: 'neither'

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

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

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

Примечание

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

xunits, yunitsзарегистрированные единицы, необязательно

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

antialiasedбулево, необязательно

Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для линий контура оно берется из rcParams["lines.antialiased"] (по умолчанию: True).

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

Толщина линий контура.

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

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

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

linestyles{None, 'solid', 'dashed', 'dashdot', 'dotted'}, необязательно

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

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