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