matplotlib.axes.Axes.tricontour

Axes.tricontour(*args, **kwargs) [source]

Отображение контуров на неструктурированной треугольной сетке. 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 будет создан. См. 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… см. ниже для получения более подробной информации.

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

Дополнительные ключевые аргументы:

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

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

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

alpha: число Значение прозрачности

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, используется ширина по умолчанию в lines.linewidth в matplotlibrc.

Если число, все уровни будут нарисованы с этой шириной линии.

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

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

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

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

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

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

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

z1 < z <= z2

Есть одно исключение: если нижняя граница совпадает с минимальным значением массива z, то это минимальное значение будет включено в нижний интервал.

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

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

Tricontour Smooth User

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

Tricontour Smooth Delaunay