matplotlib.axes.Axes.tricontour

Axes.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.

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

Возвращает:

TriContourSet

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

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

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

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

В качестве сокращения можно использовать одиночные строковые значения цвета вместо списков с одним элементом, т.е. '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 вместе с vmin/vmax допустимо).

Если vmin или vmax не заданы, по умолчанию масштабирование цветов основано на levels.

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

origin{None, 'верхний', 'нижний', 'изображение'}, по умолчанию: None

Определяет ориентацию и точное положение z, задавая положение z[0, 0]. Это актуально только, если X и Y не заданы.

• None: z[0, 0] находится в левом нижнем углу при X=0, Y=0.
• 'нижний': z[0, 0] находится в левом нижнем углу при X=0.5, Y=0.5.
• 'верхний': z[0, 0] находится в левом верхнем углу при X=N+0.5, Y=0.5.
• 'изображение': Используйте значение из 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{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего'

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

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

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

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

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

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

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

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

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

Tricontour Гладкий Делоне

Tricontour Гладкий Делоне

Tricontour Гладкий Пользователь

Tricontour Гладкий Пользователь

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

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

Треугольный 3D контурный график

Треугольный 3D контурный график

tricontour(x, y, z)

tricontour(x, y, z)