matplotlib.axes.Axes.tricontour

Axes.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) сопоставляются со значениями under/over цветовой карты Colormap. Обратите внимание, что у большинства цветовых карт по умолчанию нет специальных цветов для этих значений, поэтому значения over и under соответствуют крайним цветам цветовой карты. При необходимости эти значения можно задать явно с помощью методов 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 также может быть итерируемым объектом из указанных выше строк, задающим набор используемых стилей линий. Если этот итерируемый объект короче количества уровней контура, он при необходимости повторяется.

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

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

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

Сглаживание tricontour по Делоне

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

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

Трёхмерный контурный график на треугольной сетке

tricontour(x, y, z)

matplotlib.axes.Axes.tricontour

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

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