matplotlib.axes.Axes.tricontour

Axes.tricontour(*args, **kwargs)

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

Треугольную сетку можно указать двумя способами; либо

tricontour(triangulation, ...)

где triangulation — объект Triangulation, или

tricontour(x, y, ...)
tricontour(x, y, triangles, ...)
tricontour(x, y, triangles=triangles, ...)
tricontour(x, y, mask=mask, ...)
tricontour(x, y, triangles, mask=mask, ...)

в этом случае будет создан объект Triangulation. См. строку документации этого класса для объяснения этих случаев.

Остальные аргументы могут быть:

tricontour(..., Z)

где Z — массив значений для контура, по одному значению на точку в треугольной сетке. Уровни выбираются автоматически.

tricontour(..., Z, levels)

контур до levels+1 автоматически выбранных уровней контура (levels интервалов).

tricontour(..., Z, levels)

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

tricontour(Z, **kwargs)

Используйте ключевые аргументы для управления цветами, шириной линий, началом отсчёта, cmap… см. подробности ниже.

Параметры:	triangulationTriangulation, необязательно Неструктурированная треугольная сетка. Если указано, то x, y, triangles и mask не принимаются. x, yмассив, необязательно Координаты значений в Z. triangles(ntri, 3) массив целых чисел, необязательно Для каждого треугольника — индексы трёх точек, образующих треугольник, упорядоченные против часовой стрелки. Если не указано, рассчитывается триангуляция Делоне. mask(ntri,) массив булевых значений, необязательно Какие треугольники маскируются. Zдвумерный массив Значения высот, по которым рисуется контур. levelsцелое число или массив, необязательно Определяет количество и положение линий/областей контура. Если целое число n, используйте MaxNLocator, который пытается автоматически выбрать не более n+1 «приемлемых» уровней контура между vmin и vmax. Если массив, рисует линии контура по указанным уровням. Значения должны быть упорядочены по возрастанию.
Возвращаемое значение:	TriContourSet
Другие параметры:	colorsстрока цвета или последовательность цветов, необязательно Цвета уровней, т.е. линий контура. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче числа уровней, она повторяется. В качестве сокращения могут использоваться одноцветные строки вместо списков с одним элементом, т.е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов задания цветов. По умолчанию (значение None) используется цветовая карта, указанная в cmap. alphaчисло, по умолчанию: 1 Значение смешивания альфа-канала, от 0 (прозрачный) до 1 (непрозрачный). cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis') Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта отображает значения уровня в цвета. Если заданы colors и cmap, возникает ошибка. normNormalize, необязательно Если используется цветовая карта, экземпляр Normalize масштабирует значения уровня до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не указано, используется стандартное линейное масштабирование. vmin, vmaxчисло, необязательно Если не None, одно или оба этих значения будут переданы экземпляру Normalize, переопределяя стандартное масштабирование цвета на основе levels. 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, необязательно Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию MaxNLocator. extend{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего' Определяет tricontour-закраску значений, которые находятся за пределами диапазона 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 Smooth Delaunay

Tricontour Smooth User

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

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