matplotlib.pyplot.tricontour

matplotlib.pyplot.tricontour(*args, **kwargs)[исходный код]

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

Форматы вызова:

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.

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

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

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

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

Возвращает:

TriContourSet

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

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

Цвета уровней, то есть линий уровня.

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

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

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

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

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

cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (значение по умолчанию: 'viridis')

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

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

normstr или 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 типа 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].

Этот аргумент игнорируется, если при вызове contour указаны X и Y.

locatorподкласс ticker.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).

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

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

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

Сглаженный tricontour Делоне

Сглаженный tricontour Делоне

Сглаженный tricontour для пользовательской сетки

Сглаженный tricontour для пользовательской сетки

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

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