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.

zarray-like

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

Примечание

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

levelsint или array-like, необязательно

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

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

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

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

TriContourSet

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

vmin, vmaxfloat, необязательно

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который покрывает цветовая карта. По умолчанию цветовая карта покрывает весь диапазон значений предоставленных данных. Использование vmin/vmax при задании экземпляра norm является ошибкой (но использование строки norm вместе с 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'

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

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

Примечания

Примечание

Это обертка pyplot для axes.Axes.tricontour.

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

График линий уровня неравномерно расположенных данных

График линий уровня неравномерно расположенных данных

Гладкое триконтурное изображение Делоне

Гладкое триконтурное изображение Делоне

Гладкое триконтурное изображение Пользовательского типа

Гладкое триконтурное изображение Пользовательского типа

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

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