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. Локатор используется для определения уровней контура, если они не заданы явно с помощью аргумента 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
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/_as_gen/matplotlib.axes.Axes.tricontour.html