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.

zподобный массиву

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

Примечание

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

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

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

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

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

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

TriContourSet

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

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

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

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

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

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

alphaчисло с плавающей точкой, по умолчанию: 1

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

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

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

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

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

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

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

• Экземпляр Normalize или один из его подклассов (см. Нормализация цветовой карты).
• Имя масштаба, например, «линейный», «логарифмический», «симлогарифмический», «логит» и т. д. Список доступных масштабов можно получить, вызвав matplotlib.scale.get_scale_names(). В этом случае генерируется и создается экземпляр подходящего подкласса Normalize.

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

vmin, vmaxчисло с плавающей точкой, необязательно

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

Tricontour Smooth Delaunay

Tricontour Smooth User

Tricontour Smooth User

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

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

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

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

tricontour(x, y, z)

tricontour(x, y, z)