matplotlib.axes.Axes.tricontour

Axes.tricontour(ax, *args, **kwargs)

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

tricontour и tricontourf соответственно рисуют линии контура и заполненные контуры. За исключением отмеченных случаев, сигнатуры функций и возвращаемые значения одинаковы для обеих версий.

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

tricontour(triangulation, ...)

где triangulation — объект matplotlib.tri.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, N)

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

tricontour(..., Z, V)

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

tricontourf(..., Z, V)

заполнить (len(V)-1) регионов между значениями в V, которые должны быть в порядке возрастания.

tricontour(Z, **kwargs)

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

tricontour(...) возвращает объект TriContourSet.

Необязательные ключевые аргументы:

colors: [ None | строка | (mpl_colors) ] Если None, будет использоваться цветовая карта, указанная в cmap.

Если строка, например, 'r' или 'red', все уровни будут нарисованы этим цветом.

Если кортеж matplotlib аргументов цвета (строка, число, rgb и т.д.), разные уровни будут нарисованы разными цветами в указанном порядке.

alpha: float Значение альфа-смешивания

cmap: [ None | Colormap ] Объект cm Colormap или None. Если cmap равно None и colors равно None, используется по умолчанию цветовая карта.

norm: [ None | Normalize ] Объект matplotlib.colors.Normalize для масштабирования значений данных до цветов. Если norm равно None и colors равно None, используется по умолчанию линейное масштабирование.

levels [level0, level1, ..., leveln] Список чисел с плавающей точкой, указывающих кривые уровня, которые необходимо нарисовать в порядке возрастания; например, чтобы нарисовать только нулевой контур, передайте levels=[0]

origin: [ None | 'верх' | 'низ' | 'изображение' ] Если None, первое значение Z будет соответствовать левому нижнему углу, позиции (0,0). Если 'изображение', будет использоваться значение rc для image.origin.

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

extent: [ None | (x0,x1,y0,y1) ]

Если origin не равно None, то extent интерпретируется так же, как в matplotlib.pyplot.imshow(): он задает внешние границы пикселей. В этом случае положение Z[0,0] — центр пикселя, а не угол. Если origin равно None, то (x0, y0) — положение Z[0,0], а (x1, y1) — положение Z[-1,-1].

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

locator: [ None | подкласс ticker.Locator ] Если locator равно None, используется по умолчанию MaxNLocator. Locator используется для определения уровней контура, если они не заданы явно через аргумент V.

extend: [ 'ничего' | 'все' | 'мин' | 'макс' ] Если это не 'ничего', уровни контура автоматически добавляются к одному или обоим концам диапазона, чтобы все данные были включены. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть настроены с помощью методов matplotlib.colors.Colormap.set_under() и matplotlib.colors.Colormap.set_over().

xunits, yunits: [ None | зарегистрированные единицы ] Переопределяет единицы осей, указав экземпляр matplotlib.units.ConversionInterface.

Только ключевые аргументы tricontour:

linewidths: [ None | число | кортеж чисел ] Если linewidths равно None, используется значение по умолчанию rc: lines.linewidth. Если число, все уровни будут нарисованы с этой шириной линии.

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

linestyles: [ None | 'сплошная' | 'штриховая' | 'штрихпунктирная' | 'пунктирная' ] Если linestyles равно None, используется 'сплошная'.

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

Если контур использует монохромную цветовую карту и уровень контура меньше 0, то используется стиль линии, указанный в rcParams["contour.negative_linestyle"].

Только ключевые аргументы tricontourf:

antialiased: bool включить сглаживание

Примечание: tricontourf заполняет интервалы, закрытые сверху; другими словами, для границ z1 и z2 заполненный регион равен:

z1 < Z <= z2

за исключением самого нижнего интервала, который закрыт с обеих сторон (т.е. он включает самое низкое значение).

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

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

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

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

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