matplotlib.axes.Axes.tricontourf
-
Axes.tricontourf(*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: число Значение смешивания альфа-канала
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 | 'upper' | 'lower' | 'image' ] Если None, первое значение Z будет соответствовать нижнему левому углу, координате (0,0). Если 'image', используется значение 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: [ 'neither' | 'both' | 'min' | 'max' ] Если это не 'neither', уровни контура автоматически добавляются к одному или обоим концам диапазона, чтобы охватить все данные. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть установлены с помощью методов
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 | 'solid' | 'dashed' | 'dashdot' | 'dotted' ] Если linestyles равно None, используется 'solid'.
linestyles также может быть итерируемым объектом указанных выше строк, определяющим набор стилей линий, которые будут использоваться. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости.
Если контур использует монохромную цветовую карту, а уровень контура меньше 0, то будет использоваться стиль линии, указанный в
rcParams["contour.negative_linestyle"].Ключевые аргументы только для tricontourf:
antialiased: bool включить сглаживаниеПримечание: tricontourf заполняет интервалы, закрытые сверху; то есть, для границ z1 и z2, заполненная область:
z1 < z <= z2
Существует одно исключение: если нижняя граница совпадает с минимальным значением массива z, то это минимальное значение будет включено в самый нижний интервал.
Примеры использования matplotlib.axes.Axes.tricontourf
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/_as_gen/matplotlib.axes.Axes.tricontourf.html