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.

Примечание

Все значения в 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 или один из его подклассов (см. Нормализация цветовой карты).
• Имя масштаба, например, "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, необязательно

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

extend{'neither', 'both', 'min', 'max'}, по умолчанию: 'neither'

Определяет tricontour-окраску значений, которые лежат вне диапазона 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, yunitsзарегистрированные единицы, необязательно

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

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

Включить сглаживание, переопределив значения по умолчанию. Для заполненных контуров значение по умолчанию 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 также может быть итерируемым объектом из вышеперечисленных строк, определяющим набор стилей линий. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости.

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

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

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

Tricontour Smooth Delaunay

Tricontour Smooth Delaunay

Tricontour Smooth User

Tricontour Smooth User

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

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