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_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. Локатор используется для определения уровней контура, если они не заданы явно через аргумент 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

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

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

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

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

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

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